fiscalisto 0.1.19 → 0.1.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * llamar.
5
5
  */
6
6
  import type { ErrorCode } from "./error-codes.js";
7
- export declare const VERSION = "0.1.19";
7
+ export declare const VERSION = "0.1.20";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.19";
6
+ export const VERSION = "0.1.20";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -119,6 +119,8 @@ export declare const ErrorCode: {
119
119
  readonly PayrollReplacementInvalid: "payroll_replacement_invalid";
120
120
  /** No se pudo dibujar el PDF de ese CFDI (su XML trae algo que el generador no lee). Descargue el XML: es el documento válido ante el SAT. */
121
121
  readonly PdfUnavailable: "pdf_unavailable";
122
+ /** El ticket de compra no se puede guardar, corregir o pedir así (un archivo que no es foto ni PDF, un RFC o uso que no corresponde, una tienda que no factura con Fiscalisto, faltan datos fiscales del emisor…). El mensaje dice por qué. */
123
+ readonly PurchaseReceiptInvalid: "purchase_receipt_invalid";
122
124
  /** La cotización no tiene los datos fiscales del cliente: agrégueselos con POST /v1/quotes/{id} (customer) o mándela con auto_invoice para que los dé al aceptarla. */
123
125
  readonly QuoteCustomerMissing: "quote_customer_missing";
124
126
  /** La cotización no se pudo guardar o ya no cambia (aceptada, rechazada o facturada), o no se puede mandar así. El mensaje dice por qué. */
@@ -120,6 +120,8 @@ export const ErrorCode = {
120
120
  PayrollReplacementInvalid: "payroll_replacement_invalid",
121
121
  /** No se pudo dibujar el PDF de ese CFDI (su XML trae algo que el generador no lee). Descargue el XML: es el documento válido ante el SAT. */
122
122
  PdfUnavailable: "pdf_unavailable",
123
+ /** El ticket de compra no se puede guardar, corregir o pedir así (un archivo que no es foto ni PDF, un RFC o uso que no corresponde, una tienda que no factura con Fiscalisto, faltan datos fiscales del emisor…). El mensaje dice por qué. */
124
+ PurchaseReceiptInvalid: "purchase_receipt_invalid",
123
125
  /** La cotización no tiene los datos fiscales del cliente: agrégueselos con POST /v1/quotes/{id} (customer) o mándela con auto_invoice para que los dé al aceptarla. */
124
126
  QuoteCustomerMissing: "quote_customer_missing",
125
127
  /** La cotización no se pudo guardar o ya no cambia (aceptada, rechazada o facturada), o no se puede mandar así. El mensaje dice por qué. */
@@ -2515,7 +2515,7 @@ export interface Diot {
2515
2515
  /** Lo que conviene revisar antes de presentarla. */
2516
2516
  warnings: string[];
2517
2517
  }
2518
- /** Una tienda de Shopify o Mercado Libre cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
2518
+ /** Una tienda de Shopify, WooCommerce, Tiendanube, Mercado Libre o Amazon cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
2519
2519
  export interface StoreConnection {
2520
2520
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
2521
2521
  id: string;
@@ -2525,13 +2525,15 @@ export interface StoreConnection {
2525
2525
  object: "store_connection";
2526
2526
  /** El emisor dueño de la tienda. */
2527
2527
  issuer: string;
2528
- /** shopify o mercadolibre. */
2529
- platform: "shopify" | "mercadolibre";
2530
- /** El dominio de la tienda de Shopify, o el id del vendedor en Mercado Libre (al autorizar). */
2528
+ /** shopify, woocommerce, tiendanube, mercadolibre o amazon. */
2529
+ platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
2530
+ /** El dominio de la tienda (Shopify, WooCommerce), o el id de la tienda en Tiendanube o del vendedor en Mercado Libre y Amazon (al autorizar). */
2531
2531
  shop: string | null;
2532
- /** pending (Mercado Libre espera que el vendedor autorice en authorize_url), active o disconnected. */
2532
+ /** El nombre de la tienda según su plataforma, o null. */
2533
+ name: string | null;
2534
+ /** pending (Mercado Libre, Tiendanube o Amazon esperan que se autorice en authorize_url), active o disconnected. */
2533
2535
  status: "pending" | "active" | "disconnected";
2534
- /** Si está pending: la página de Mercado Libre donde el vendedor autoriza (vale un día; cada consulta da una nueva). Si no, null. */
2536
+ /** Si está pending: la página de la plataforma donde el vendedor autoriza (vale un día; cada consulta da una nueva). Si no, null. */
2535
2537
  authorize_url: string | null;
2536
2538
  /** Cómo se vuelve ticket cada pedido. */
2537
2539
  settings: {
@@ -2549,8 +2551,10 @@ export interface StoreConnection {
2549
2551
  payment_form: string | null;
2550
2552
  /** c_FormaPago por pasarela o tipo de pago. */
2551
2553
  payment_forms: Record<string, string>;
2552
- /** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en Shopify. */
2554
+ /** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en las demás plataformas. */
2553
2555
  auto_invoice: boolean | null;
2556
+ /** WooCommerce y Tiendanube: si el comprador recibe su enlace para facturar (nota del pedido o correo); null en las demás plataformas. */
2557
+ notify_buyer: boolean | null;
2554
2558
  };
2555
2559
  /** Cuántos pedidos se han vuelto tickets. */
2556
2560
  orders_count: number;
@@ -2750,6 +2754,80 @@ export interface BankImport {
2750
2754
  /** Los depósitos agregados. */
2751
2755
  data: BankTransaction[];
2752
2756
  }
2757
+ /** Un ticket de compra del emisor sin factura: lo que se leyó de su foto y si ya se pidió, llegó o no es deducible. */
2758
+ export interface PurchaseReceipt {
2759
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
2760
+ id: string;
2761
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
2762
+ livemode: boolean;
2763
+ /** Qué tipo de objeto es («invoice», «customer»…). */
2764
+ object: "purchase_receipt";
2765
+ /** El emisor (el que compró). */
2766
+ issuer: string;
2767
+ /** pending (por pedir), requested (pedida a la tienda), invoiced (ya tiene factura) o non_deductible (no hubo factura). */
2768
+ status: "pending" | "requested" | "invoiced" | "non_deductible";
2769
+ /** La tienda: name, tax_id (su RFC), email, portal_url (su portal o la liga del QR) y on_fiscalisto (factura con Fiscalisto: method fiscalisto la timbra al momento). */
2770
+ store: {
2771
+ /** Nombre. */
2772
+ name: string | null;
2773
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
2774
+ tax_id: string | null;
2775
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
2776
+ email: string | null;
2777
+ /** Su portal de facturación o la liga del QR, o null. */
2778
+ portal_url: string | null;
2779
+ /** true si factura con Fiscalisto: method fiscalisto timbra la factura al momento. */
2780
+ on_fiscalisto: boolean;
2781
+ };
2782
+ /** El día de la compra (AAAA-MM-DD), o null. */
2783
+ date: string | null;
2784
+ /** El total pagado, en pesos, o null. */
2785
+ total: number | null;
2786
+ /** efectivo, tarjeta u otro, o null. */
2787
+ payment_method: "efectivo" | "tarjeta" | "otro" | null;
2788
+ /** El folio o número de ticket, o null. */
2789
+ folio: string | null;
2790
+ /** Otros datos que pide el portal de la tienda para facturar (Web ID, sucursal, caja…). */
2791
+ fields: {
2792
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
2793
+ label: string;
2794
+ /** Lo que dice el ticket en ese dato. */
2795
+ value: string;
2796
+ }[];
2797
+ /** El uso de la factura que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
2798
+ use: string | null;
2799
+ /** Una nota, o null. */
2800
+ note: string | null;
2801
+ /** ai (lo leyó la IA), manual (se mandaron los datos) o null. */
2802
+ read_by: "ai" | "manual" | null;
2803
+ /** Por qué no se leyó o qué revisar (foto borrosa, no parece un ticket…), o null. */
2804
+ read_note: string | null;
2805
+ /** El tipo del archivo guardado (image/jpeg, application/pdf…). */
2806
+ file_type: string | null;
2807
+ /** true si se pagó en efectivo más de $2,000: aunque tenga factura, no es deducible (LISR art. 27 fr. III). */
2808
+ cash_over_limit: boolean;
2809
+ /** Por pedir: los días que le quedan al mes de la compra, en hora de México (muchas tiendas solo facturan dentro del mes); si no, null. */
2810
+ days_left_in_month: number | null;
2811
+ /** Cuándo y cómo se pidió (method: fiscalisto, email, portal o manual; to: la tienda o su correo), o null. */
2812
+ requested: {
2813
+ /** egreso (la factura completa y después una nota de crédito por el anticipo, opción A) o remanente (la factura solo por lo que falta, opción B). */
2814
+ method: string | null;
2815
+ /** A quién (correos separados por comas). */
2816
+ to: string | null;
2817
+ /** Cuándo se pidió. */
2818
+ at: string | null;
2819
+ } | null;
2820
+ /** El folio fiscal de la factura que lo cubre, o null. */
2821
+ invoice_uuid: string | null;
2822
+ /** La factura recibida (sat_…) que lo cubre, si ya llegó con las descargas del SAT, o null. */
2823
+ invoice: string | null;
2824
+ /** Cuándo quedó facturado, o null. */
2825
+ invoiced_at: string | null;
2826
+ /** Cuándo se marcó no deducible, o null. */
2827
+ non_deductible_at: string | null;
2828
+ /** Cuándo se guardó. */
2829
+ created_at: string | null;
2830
+ }
2753
2831
  /** Una liga para que el dueño de un emisor suba su CSD y firme con su e.firma. */
2754
2832
  export interface IssuerOnboardingLink {
2755
2833
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -2922,6 +3000,16 @@ export interface BankTransactionList {
2922
3000
  /** La ruta de esta lista. */
2923
3001
  url: string;
2924
3002
  }
3003
+ export interface PurchaseReceiptList {
3004
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3005
+ object: "list";
3006
+ /** Los objetos de esta página. */
3007
+ data: PurchaseReceipt[];
3008
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3009
+ has_more: boolean;
3010
+ /** La ruta de esta lista. */
3011
+ url: string;
3012
+ }
2925
3013
  export interface AdvanceList {
2926
3014
  /** Qué tipo de objeto es («invoice», «customer»…). */
2927
3015
  object: "list";
@@ -4431,6 +4519,99 @@ export interface ClassifyBankTransactionParams {
4431
4519
  /** Una nota para su equipo (de dónde vino, por qué). */
4432
4520
  note?: string;
4433
4521
  }
4522
+ export interface CreatePurchaseReceiptParams {
4523
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4524
+ issuer?: string;
4525
+ /** La foto (JPG, PNG o WebP) o el PDF, en base64; hasta 8 MB. */
4526
+ file: string;
4527
+ /** image/jpeg, image/png, image/webp o application/pdf. */
4528
+ file_type: "image/jpeg" | "image/png" | "image/webp" | "application/pdf";
4529
+ /** Lo que dice el código QR del ticket, si ya lo leyó (suele ser la liga del portal). */
4530
+ qr_text?: string;
4531
+ /** false para no leerlo con IA y mandar los datos usted. Por omisión se lee y se llena lo que no mandó. */
4532
+ read?: boolean;
4533
+ /** El nombre de la tienda. */
4534
+ store_name?: string | null;
4535
+ /** El RFC de la tienda (el que factura). */
4536
+ store_tax_id?: string | null;
4537
+ /** El día de la compra (AAAA-MM-DD). */
4538
+ date?: string | null;
4539
+ /** El total pagado, en pesos. */
4540
+ total?: number | null;
4541
+ /** efectivo, tarjeta u otro. */
4542
+ payment_method?: "efectivo" | "tarjeta" | "otro" | null;
4543
+ /** El folio o número de ticket. */
4544
+ folio?: string | null;
4545
+ /** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
4546
+ fields?: {
4547
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
4548
+ label: string;
4549
+ /** Lo que dice el ticket en ese dato. */
4550
+ value: string;
4551
+ }[];
4552
+ /** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
4553
+ portal_url?: string | null;
4554
+ /** El correo de facturación de la tienda. */
4555
+ store_email?: string | null;
4556
+ /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
4557
+ use?: string | null;
4558
+ /** Una nota para su equipo. */
4559
+ note?: string | null;
4560
+ }
4561
+ /** Los parámetros de GET /v1/purchase_receipts. */
4562
+ export interface ListPurchaseReceiptsParams {
4563
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
4564
+ limit?: number;
4565
+ /** El id del último de la página anterior, para la siguiente. */
4566
+ starting_after?: string;
4567
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
4568
+ issuer?: string;
4569
+ /** pending, requested, invoiced o non_deductible. */
4570
+ status?: "pending" | "requested" | "invoiced" | "non_deductible";
4571
+ }
4572
+ export interface UpdatePurchaseReceiptParams {
4573
+ /** El nombre de la tienda. */
4574
+ store_name?: string | null;
4575
+ /** El RFC de la tienda (el que factura). */
4576
+ store_tax_id?: string | null;
4577
+ /** El día de la compra (AAAA-MM-DD). */
4578
+ date?: string | null;
4579
+ /** El total pagado, en pesos. */
4580
+ total?: number | null;
4581
+ /** efectivo, tarjeta u otro. */
4582
+ payment_method?: "efectivo" | "tarjeta" | "otro" | null;
4583
+ /** El folio o número de ticket. */
4584
+ folio?: string | null;
4585
+ /** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
4586
+ fields?: {
4587
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
4588
+ label: string;
4589
+ /** Lo que dice el ticket en ese dato. */
4590
+ value: string;
4591
+ }[];
4592
+ /** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
4593
+ portal_url?: string | null;
4594
+ /** El correo de facturación de la tienda. */
4595
+ store_email?: string | null;
4596
+ /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
4597
+ use?: string | null;
4598
+ /** Una nota para su equipo. */
4599
+ note?: string | null;
4600
+ }
4601
+ export interface RequestPurchaseReceiptInvoiceParams {
4602
+ /** fiscalisto (la tienda factura con Fiscalisto: se timbra al momento), email (le mandamos a la tienda sus datos y la foto), portal o manual (usted la pidió; solo se marca pedida). */
4603
+ method: "fiscalisto" | "email" | "portal" | "manual";
4604
+ /** email: el correo de la tienda. Por omisión, store_email. */
4605
+ to?: string;
4606
+ /** email: unas líneas para la tienda. */
4607
+ message?: string;
4608
+ /** email y fiscalisto: el correo al que la tienda manda la factura. Por omisión, el correo de respuesta del emisor. */
4609
+ reply_to?: string;
4610
+ }
4611
+ export interface MarkPurchaseReceiptInvoicedParams {
4612
+ /** La factura recibida que lo cubre: su id (sat_…) o su folio fiscal (UUID). Sin ella, solo se marca facturado. */
4613
+ invoice?: string;
4614
+ }
4434
4615
  export interface CreatePaymentParams {
4435
4616
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4436
4617
  issuer?: string;
@@ -5674,8 +5855,8 @@ export interface GetDiotFileParams {
5674
5855
  export interface CreateStoreConnectionParams {
5675
5856
  /** El emisor (iss_…) dueño de la tienda. Por omisión, su único emisor. */
5676
5857
  issuer?: string;
5677
- /** shopify o mercadolibre. */
5678
- platform: "shopify" | "mercadolibre";
5858
+ /** shopify, woocommerce, mercadolibre, tiendanube o amazon. */
5859
+ platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
5679
5860
  /** Shopify: el dominio de la tienda (mi-tienda.myshopify.com). */
5680
5861
  shop?: string;
5681
5862
  /** Shopify: el Client ID de la app de la tienda (Dev Dashboard). */
@@ -5684,7 +5865,13 @@ export interface CreateStoreConnectionParams {
5684
5865
  client_secret?: string;
5685
5866
  /** Shopify, solo apps personalizadas antiguas: su token de la Admin API (shpat_…); client_secret es entonces su API secret key. */
5686
5867
  access_token?: string;
5687
- /** Mercado Libre: a dónde volver después de autorizar (se agregan store_connection y status). */
5868
+ /** WooCommerce: la dirección de la tienda (https://mitienda.com). */
5869
+ site?: string;
5870
+ /** WooCommerce: la Clave de cliente (ck_…) de una llave de la API REST con permisos de Lectura/Escritura. */
5871
+ consumer_key?: string;
5872
+ /** WooCommerce: la Clave secreta de cliente (cs_…) de esa llave. Se guarda cifrada y nunca se muestra. */
5873
+ consumer_secret?: string;
5874
+ /** Mercado Libre, Tiendanube y Amazon: a dónde volver después de autorizar (se agregan store_connection y status). */
5688
5875
  return_url?: string;
5689
5876
  /** Cómo se vuelve ticket cada pedido. */
5690
5877
  settings?: {
@@ -5704,6 +5891,8 @@ export interface CreateStoreConnectionParams {
5704
5891
  payment_forms?: Record<string, string>;
5705
5892
  /** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
5706
5893
  auto_invoice?: boolean;
5894
+ /** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
5895
+ notify_buyer?: boolean;
5707
5896
  };
5708
5897
  }
5709
5898
  /** Los parámetros de GET /v1/store_connections. */
@@ -5734,6 +5923,8 @@ export interface UpdateStoreConnectionParams {
5734
5923
  payment_forms?: Record<string, string>;
5735
5924
  /** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
5736
5925
  auto_invoice?: boolean;
5926
+ /** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
5927
+ notify_buyer?: boolean;
5737
5928
  };
5738
5929
  }
5739
5930
  export interface ImportStoreOrdersParams {
@@ -6642,6 +6833,101 @@ export declare class BankTransactionsResource {
6642
6833
  */
6643
6834
  reopen(id: string, options?: RequestOptions): Promise<BankTransaction>;
6644
6835
  }
6836
+ /** Tickets de compra: fiscalisto.purchaseReceipts. */
6837
+ export declare class PurchaseReceiptsResource {
6838
+ #private;
6839
+ constructor(client: Client);
6840
+ /**
6841
+ * Guardar un ticket de compra
6842
+ *
6843
+ * La foto o el PDF de un ticket que el emisor pagó sin factura, en base64. La IA lee la tienda, su RFC, la fecha, el total, la forma de pago, el folio, los datos que pide su portal y la liga de facturación; lo que usted mande gana a lo que se lea. El mismo archivo dos veces devuelve el ticket que ya estaba, sin leerlo otra vez. Si llega una factura de esa tienda por el mismo total con las descargas del SAT, el ticket queda invoiced solo.
6844
+ *
6845
+ * POST /v1/purchase_receipts
6846
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
6847
+ */
6848
+ create(params: CreatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6849
+ /**
6850
+ * Listar tickets de compra
6851
+ *
6852
+ * Los más recientes primero.
6853
+ *
6854
+ * GET /v1/purchase_receipts
6855
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
6856
+ */
6857
+ list(params?: ListPurchaseReceiptsParams, options?: RequestOptions): List<PurchaseReceipt>;
6858
+ /**
6859
+ * Ver un ticket de compra
6860
+ *
6861
+ * Con la factura recibida que lo cubre, si ya llegó.
6862
+ *
6863
+ * GET /v1/purchase_receipts/{id}
6864
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
6865
+ */
6866
+ get(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6867
+ /**
6868
+ * Corregir un ticket de compra
6869
+ *
6870
+ * Corrige o llena sus datos; solo cambia lo que mande (null borra un dato). Con store_tax_id y total corregidos se vuelve a buscar su factura.
6871
+ *
6872
+ * POST /v1/purchase_receipts/{id}
6873
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
6874
+ */
6875
+ update(id: string, params?: UpdatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6876
+ /**
6877
+ * Borrar un ticket de compra
6878
+ *
6879
+ * El ticket y su archivo, para siempre.
6880
+ *
6881
+ * DELETE /v1/purchase_receipts/{id}
6882
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
6883
+ */
6884
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
6885
+ /**
6886
+ * Leer el ticket de nuevo
6887
+ *
6888
+ * La IA vuelve a leer el archivo y llena solo los datos que siguen vacíos. Cuenta en el límite diario de tickets de compra.
6889
+ *
6890
+ * POST /v1/purchase_receipts/{id}/read
6891
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
6892
+ */
6893
+ read(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6894
+ /**
6895
+ * Pedir la factura a la tienda
6896
+ *
6897
+ * fiscalisto: la tienda factura con Fiscalisto (store.on_fiscalisto), se timbra al momento con los datos fiscales del emisor y el ticket queda invoiced. email: le manda a la tienda los datos fiscales y la foto; las respuestas van a reply_to. portal o manual: usted la pidió, solo queda requested. Pide el uso de use (G03 por omisión).
6898
+ *
6899
+ * POST /v1/purchase_receipts/{id}/request
6900
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
6901
+ */
6902
+ requestInvoice(id: string, params: RequestPurchaseReceiptInvoiceParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6903
+ /**
6904
+ * Ya llegó la factura
6905
+ *
6906
+ * Para una factura que llegó por otro lado. Con invoice (sat_… o UUID), la factura recibida que lo cubre; una factura cubre un solo ticket.
6907
+ *
6908
+ * POST /v1/purchase_receipts/{id}/mark_invoiced
6909
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
6910
+ */
6911
+ markInvoiced(id: string, params?: MarkPurchaseReceiptInvoicedParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6912
+ /**
6913
+ * Marcar como no deducible
6914
+ *
6915
+ * La tienda no dio factura: el gasto queda como no deducible.
6916
+ *
6917
+ * POST /v1/purchase_receipts/{id}/mark_non_deductible
6918
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
6919
+ */
6920
+ markNonDeductible(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6921
+ /**
6922
+ * Volver a pedir la factura
6923
+ *
6924
+ * Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
6925
+ *
6926
+ * POST /v1/purchase_receipts/{id}/reopen
6927
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
6928
+ */
6929
+ reopen(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6930
+ }
6645
6931
  /** Pagos y notas de crédito: fiscalisto.payments. */
6646
6932
  export declare class PaymentsResource {
6647
6933
  #private;
@@ -7589,7 +7875,7 @@ export declare class StoreConnectionsResource {
7589
7875
  /**
7590
7876
  * Conectar una tienda
7591
7877
  *
7592
- * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. Mercado Libre: queda pending hasta que el vendedor autorice en authorize_url. Desde entonces cada pedido pagado es un ticket (folio SHOP-1001 o ML-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
7878
+ * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. WooCommerce: con la dirección de la tienda y una llave de su API REST de Lectura/Escritura, igual. Mercado Libre, Tiendanube y Amazon: queda pending hasta que el vendedor autorice en authorize_url (Amazon no tiene webhooks: sus pedidos se leen cada hora). Desde entonces cada pedido pagado es un ticket (folio SHOP-1001, WEB-1001, TN-1001, ML-… o AMZ-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
7593
7879
  *
7594
7880
  * POST /v1/store_connections
7595
7881
  * @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
@@ -7915,6 +8201,7 @@ export declare class FiscalistoApi extends Core {
7915
8201
  readonly invoices: InvoicesResource;
7916
8202
  readonly receivables: ReceivablesResource;
7917
8203
  readonly bankTransactions: BankTransactionsResource;
8204
+ readonly purchaseReceipts: PurchaseReceiptsResource;
7918
8205
  readonly payments: PaymentsResource;
7919
8206
  readonly creditNotes: CreditNotesResource;
7920
8207
  readonly advances: AdvancesResource;
package/dist/generated.js CHANGED
@@ -580,6 +580,123 @@ export class BankTransactionsResource {
580
580
  return this.#client.request({ method: "POST", path: `/v1/bank_transactions/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
581
581
  }
582
582
  }
583
+ /** Tickets de compra: fiscalisto.purchaseReceipts. */
584
+ export class PurchaseReceiptsResource {
585
+ #client;
586
+ constructor(client) {
587
+ this.#client = client;
588
+ }
589
+ /**
590
+ * Guardar un ticket de compra
591
+ *
592
+ * La foto o el PDF de un ticket que el emisor pagó sin factura, en base64. La IA lee la tienda, su RFC, la fecha, el total, la forma de pago, el folio, los datos que pide su portal y la liga de facturación; lo que usted mande gana a lo que se lea. El mismo archivo dos veces devuelve el ticket que ya estaba, sin leerlo otra vez. Si llega una factura de esa tienda por el mismo total con las descargas del SAT, el ticket queda invoiced solo.
593
+ *
594
+ * POST /v1/purchase_receipts
595
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
596
+ */
597
+ create(params, options) {
598
+ return this.#client.request({ method: "POST", path: "/v1/purchase_receipts", body: params, idempotent: true }, options);
599
+ }
600
+ /**
601
+ * Listar tickets de compra
602
+ *
603
+ * Los más recientes primero.
604
+ *
605
+ * GET /v1/purchase_receipts
606
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
607
+ */
608
+ list(params, options) {
609
+ return this.#client.list({ path: "/v1/purchase_receipts", query: params }, options);
610
+ }
611
+ /**
612
+ * Ver un ticket de compra
613
+ *
614
+ * Con la factura recibida que lo cubre, si ya llegó.
615
+ *
616
+ * GET /v1/purchase_receipts/{id}
617
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
618
+ */
619
+ get(id, options) {
620
+ return this.#client.request({ method: "GET", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
621
+ }
622
+ /**
623
+ * Corregir un ticket de compra
624
+ *
625
+ * Corrige o llena sus datos; solo cambia lo que mande (null borra un dato). Con store_tax_id y total corregidos se vuelve a buscar su factura.
626
+ *
627
+ * POST /v1/purchase_receipts/{id}
628
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
629
+ */
630
+ update(id, params, options) {
631
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
632
+ }
633
+ /**
634
+ * Borrar un ticket de compra
635
+ *
636
+ * El ticket y su archivo, para siempre.
637
+ *
638
+ * DELETE /v1/purchase_receipts/{id}
639
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
640
+ */
641
+ delete(id, options) {
642
+ return this.#client.request({ method: "DELETE", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
643
+ }
644
+ /**
645
+ * Leer el ticket de nuevo
646
+ *
647
+ * La IA vuelve a leer el archivo y llena solo los datos que siguen vacíos. Cuenta en el límite diario de tickets de compra.
648
+ *
649
+ * POST /v1/purchase_receipts/{id}/read
650
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
651
+ */
652
+ read(id, options) {
653
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/read`, idempotent: true }, options);
654
+ }
655
+ /**
656
+ * Pedir la factura a la tienda
657
+ *
658
+ * fiscalisto: la tienda factura con Fiscalisto (store.on_fiscalisto), se timbra al momento con los datos fiscales del emisor y el ticket queda invoiced. email: le manda a la tienda los datos fiscales y la foto; las respuestas van a reply_to. portal o manual: usted la pidió, solo queda requested. Pide el uso de use (G03 por omisión).
659
+ *
660
+ * POST /v1/purchase_receipts/{id}/request
661
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
662
+ */
663
+ requestInvoice(id, params, options) {
664
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/request`, body: params, idempotent: true }, options);
665
+ }
666
+ /**
667
+ * Ya llegó la factura
668
+ *
669
+ * Para una factura que llegó por otro lado. Con invoice (sat_… o UUID), la factura recibida que lo cubre; una factura cubre un solo ticket.
670
+ *
671
+ * POST /v1/purchase_receipts/{id}/mark_invoiced
672
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
673
+ */
674
+ markInvoiced(id, params, options) {
675
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_invoiced`, body: params, idempotent: true }, options);
676
+ }
677
+ /**
678
+ * Marcar como no deducible
679
+ *
680
+ * La tienda no dio factura: el gasto queda como no deducible.
681
+ *
682
+ * POST /v1/purchase_receipts/{id}/mark_non_deductible
683
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
684
+ */
685
+ markNonDeductible(id, options) {
686
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_non_deductible`, idempotent: true }, options);
687
+ }
688
+ /**
689
+ * Volver a pedir la factura
690
+ *
691
+ * Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
692
+ *
693
+ * POST /v1/purchase_receipts/{id}/reopen
694
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
695
+ */
696
+ reopen(id, options) {
697
+ return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
698
+ }
699
+ }
583
700
  /** Pagos y notas de crédito: fiscalisto.payments. */
584
701
  export class PaymentsResource {
585
702
  #client;
@@ -1761,7 +1878,7 @@ export class StoreConnectionsResource {
1761
1878
  /**
1762
1879
  * Conectar una tienda
1763
1880
  *
1764
- * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. Mercado Libre: queda pending hasta que el vendedor autorice en authorize_url. Desde entonces cada pedido pagado es un ticket (folio SHOP-1001 o ML-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
1881
+ * Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. WooCommerce: con la dirección de la tienda y una llave de su API REST de Lectura/Escritura, igual. Mercado Libre, Tiendanube y Amazon: queda pending hasta que el vendedor autorice en authorize_url (Amazon no tiene webhooks: sus pedidos se leen cada hora). Desde entonces cada pedido pagado es un ticket (folio SHOP-1001, WEB-1001, TN-1001, ML-… o AMZ-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
1765
1882
  *
1766
1883
  * POST /v1/store_connections
1767
1884
  * @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
@@ -2161,6 +2278,7 @@ export class FiscalistoApi extends Core {
2161
2278
  invoices = new InvoicesResource(this);
2162
2279
  receivables = new ReceivablesResource(this);
2163
2280
  bankTransactions = new BankTransactionsResource(this);
2281
+ purchaseReceipts = new PurchaseReceiptsResource(this);
2164
2282
  payments = new PaymentsResource(this);
2165
2283
  creditNotes = new CreditNotesResource(this);
2166
2284
  advances = new AdvancesResource(this);