fiscalisto 0.1.19 → 0.1.21

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.21";
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.21";
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é. */
@@ -554,7 +554,7 @@ export interface Retention {
554
554
  internal_folio: string | null;
555
555
  /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
556
556
  date: string | null;
557
- /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) aún no se puede emitir. */
557
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
558
558
  code: string;
559
559
  /** Descripción de la retención (DescRetenc). */
560
560
  description: string | null;
@@ -622,6 +622,8 @@ export interface Retention {
622
622
  mortgage_interest?: Record<string, unknown>;
623
623
  /** Complemento de operaciones financieras derivadas de capital (Operacionesconderivados 1.0), obligatorio con code 24. */
624
624
  financial_derivatives?: Record<string, unknown>;
625
+ /** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
626
+ platform?: Record<string, unknown>;
625
627
  /** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
626
628
  cancellation: {
627
629
  /** pending (espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó) o lapsed (venció; puede pedirla otra vez). */
@@ -980,7 +982,7 @@ export interface ExternalPayrollReceiptPreview {
980
982
  warnings: {
981
983
  /** El campo de la solicitud. */
982
984
  param: string;
983
- /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) aún no se puede emitir. */
985
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
984
986
  code: string;
985
987
  /** Qué pasó y cómo corregirlo, para una persona. */
986
988
  message: string;
@@ -2515,7 +2517,7 @@ export interface Diot {
2515
2517
  /** Lo que conviene revisar antes de presentarla. */
2516
2518
  warnings: string[];
2517
2519
  }
2518
- /** Una tienda de Shopify o Mercado Libre cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
2520
+ /** Una tienda de Shopify, WooCommerce, Tiendanube, Mercado Libre o Amazon cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
2519
2521
  export interface StoreConnection {
2520
2522
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
2521
2523
  id: string;
@@ -2525,13 +2527,15 @@ export interface StoreConnection {
2525
2527
  object: "store_connection";
2526
2528
  /** El emisor dueño de la tienda. */
2527
2529
  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). */
2530
+ /** shopify, woocommerce, tiendanube, mercadolibre o amazon. */
2531
+ platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
2532
+ /** 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
2533
  shop: string | null;
2532
- /** pending (Mercado Libre espera que el vendedor autorice en authorize_url), active o disconnected. */
2534
+ /** El nombre de la tienda según su plataforma, o null. */
2535
+ name: string | null;
2536
+ /** pending (Mercado Libre, Tiendanube o Amazon esperan que se autorice en authorize_url), active o disconnected. */
2533
2537
  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. */
2538
+ /** 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
2539
  authorize_url: string | null;
2536
2540
  /** Cómo se vuelve ticket cada pedido. */
2537
2541
  settings: {
@@ -2549,8 +2553,10 @@ export interface StoreConnection {
2549
2553
  payment_form: string | null;
2550
2554
  /** c_FormaPago por pasarela o tipo de pago. */
2551
2555
  payment_forms: Record<string, string>;
2552
- /** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en Shopify. */
2556
+ /** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en las demás plataformas. */
2553
2557
  auto_invoice: boolean | null;
2558
+ /** WooCommerce y Tiendanube: si el comprador recibe su enlace para facturar (nota del pedido o correo); null en las demás plataformas. */
2559
+ notify_buyer: boolean | null;
2554
2560
  };
2555
2561
  /** Cuántos pedidos se han vuelto tickets. */
2556
2562
  orders_count: number;
@@ -2750,6 +2756,80 @@ export interface BankImport {
2750
2756
  /** Los depósitos agregados. */
2751
2757
  data: BankTransaction[];
2752
2758
  }
2759
+ /** 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. */
2760
+ export interface PurchaseReceipt {
2761
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
2762
+ id: string;
2763
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
2764
+ livemode: boolean;
2765
+ /** Qué tipo de objeto es («invoice», «customer»…). */
2766
+ object: "purchase_receipt";
2767
+ /** El emisor (el que compró). */
2768
+ issuer: string;
2769
+ /** pending (por pedir), requested (pedida a la tienda), invoiced (ya tiene factura) o non_deductible (no hubo factura). */
2770
+ status: "pending" | "requested" | "invoiced" | "non_deductible";
2771
+ /** 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). */
2772
+ store: {
2773
+ /** Nombre. */
2774
+ name: string | null;
2775
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
2776
+ tax_id: string | null;
2777
+ /** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
2778
+ email: string | null;
2779
+ /** Su portal de facturación o la liga del QR, o null. */
2780
+ portal_url: string | null;
2781
+ /** true si factura con Fiscalisto: method fiscalisto timbra la factura al momento. */
2782
+ on_fiscalisto: boolean;
2783
+ };
2784
+ /** El día de la compra (AAAA-MM-DD), o null. */
2785
+ date: string | null;
2786
+ /** El total pagado, en pesos, o null. */
2787
+ total: number | null;
2788
+ /** efectivo, tarjeta u otro, o null. */
2789
+ payment_method: "efectivo" | "tarjeta" | "otro" | null;
2790
+ /** El folio o número de ticket, o null. */
2791
+ folio: string | null;
2792
+ /** Otros datos que pide el portal de la tienda para facturar (Web ID, sucursal, caja…). */
2793
+ fields: {
2794
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
2795
+ label: string;
2796
+ /** Lo que dice el ticket en ese dato. */
2797
+ value: string;
2798
+ }[];
2799
+ /** El uso de la factura que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
2800
+ use: string | null;
2801
+ /** Una nota, o null. */
2802
+ note: string | null;
2803
+ /** ai (lo leyó la IA), manual (se mandaron los datos) o null. */
2804
+ read_by: "ai" | "manual" | null;
2805
+ /** Por qué no se leyó o qué revisar (foto borrosa, no parece un ticket…), o null. */
2806
+ read_note: string | null;
2807
+ /** El tipo del archivo guardado (image/jpeg, application/pdf…). */
2808
+ file_type: string | null;
2809
+ /** true si se pagó en efectivo más de $2,000: aunque tenga factura, no es deducible (LISR art. 27 fr. III). */
2810
+ cash_over_limit: boolean;
2811
+ /** 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. */
2812
+ days_left_in_month: number | null;
2813
+ /** Cuándo y cómo se pidió (method: fiscalisto, email, portal o manual; to: la tienda o su correo), o null. */
2814
+ requested: {
2815
+ /** 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). */
2816
+ method: string | null;
2817
+ /** A quién (correos separados por comas). */
2818
+ to: string | null;
2819
+ /** Cuándo se pidió. */
2820
+ at: string | null;
2821
+ } | null;
2822
+ /** El folio fiscal de la factura que lo cubre, o null. */
2823
+ invoice_uuid: string | null;
2824
+ /** La factura recibida (sat_…) que lo cubre, si ya llegó con las descargas del SAT, o null. */
2825
+ invoice: string | null;
2826
+ /** Cuándo quedó facturado, o null. */
2827
+ invoiced_at: string | null;
2828
+ /** Cuándo se marcó no deducible, o null. */
2829
+ non_deductible_at: string | null;
2830
+ /** Cuándo se guardó. */
2831
+ created_at: string | null;
2832
+ }
2753
2833
  /** Una liga para que el dueño de un emisor suba su CSD y firme con su e.firma. */
2754
2834
  export interface IssuerOnboardingLink {
2755
2835
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -2922,6 +3002,16 @@ export interface BankTransactionList {
2922
3002
  /** La ruta de esta lista. */
2923
3003
  url: string;
2924
3004
  }
3005
+ export interface PurchaseReceiptList {
3006
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3007
+ object: "list";
3008
+ /** Los objetos de esta página. */
3009
+ data: PurchaseReceipt[];
3010
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3011
+ has_more: boolean;
3012
+ /** La ruta de esta lista. */
3013
+ url: string;
3014
+ }
2925
3015
  export interface AdvanceList {
2926
3016
  /** Qué tipo de objeto es («invoice», «customer»…). */
2927
3017
  object: "list";
@@ -4431,6 +4521,99 @@ export interface ClassifyBankTransactionParams {
4431
4521
  /** Una nota para su equipo (de dónde vino, por qué). */
4432
4522
  note?: string;
4433
4523
  }
4524
+ export interface CreatePurchaseReceiptParams {
4525
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4526
+ issuer?: string;
4527
+ /** La foto (JPG, PNG o WebP) o el PDF, en base64; hasta 8 MB. */
4528
+ file: string;
4529
+ /** image/jpeg, image/png, image/webp o application/pdf. */
4530
+ file_type: "image/jpeg" | "image/png" | "image/webp" | "application/pdf";
4531
+ /** Lo que dice el código QR del ticket, si ya lo leyó (suele ser la liga del portal). */
4532
+ qr_text?: string;
4533
+ /** false para no leerlo con IA y mandar los datos usted. Por omisión se lee y se llena lo que no mandó. */
4534
+ read?: boolean;
4535
+ /** El nombre de la tienda. */
4536
+ store_name?: string | null;
4537
+ /** El RFC de la tienda (el que factura). */
4538
+ store_tax_id?: string | null;
4539
+ /** El día de la compra (AAAA-MM-DD). */
4540
+ date?: string | null;
4541
+ /** El total pagado, en pesos. */
4542
+ total?: number | null;
4543
+ /** efectivo, tarjeta u otro. */
4544
+ payment_method?: "efectivo" | "tarjeta" | "otro" | null;
4545
+ /** El folio o número de ticket. */
4546
+ folio?: string | null;
4547
+ /** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
4548
+ fields?: {
4549
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
4550
+ label: string;
4551
+ /** Lo que dice el ticket en ese dato. */
4552
+ value: string;
4553
+ }[];
4554
+ /** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
4555
+ portal_url?: string | null;
4556
+ /** El correo de facturación de la tienda. */
4557
+ store_email?: string | null;
4558
+ /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
4559
+ use?: string | null;
4560
+ /** Una nota para su equipo. */
4561
+ note?: string | null;
4562
+ }
4563
+ /** Los parámetros de GET /v1/purchase_receipts. */
4564
+ export interface ListPurchaseReceiptsParams {
4565
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
4566
+ limit?: number;
4567
+ /** El id del último de la página anterior, para la siguiente. */
4568
+ starting_after?: string;
4569
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
4570
+ issuer?: string;
4571
+ /** pending, requested, invoiced o non_deductible. */
4572
+ status?: "pending" | "requested" | "invoiced" | "non_deductible";
4573
+ }
4574
+ export interface UpdatePurchaseReceiptParams {
4575
+ /** El nombre de la tienda. */
4576
+ store_name?: string | null;
4577
+ /** El RFC de la tienda (el que factura). */
4578
+ store_tax_id?: string | null;
4579
+ /** El día de la compra (AAAA-MM-DD). */
4580
+ date?: string | null;
4581
+ /** El total pagado, en pesos. */
4582
+ total?: number | null;
4583
+ /** efectivo, tarjeta u otro. */
4584
+ payment_method?: "efectivo" | "tarjeta" | "otro" | null;
4585
+ /** El folio o número de ticket. */
4586
+ folio?: string | null;
4587
+ /** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
4588
+ fields?: {
4589
+ /** Cómo lo llama el ticket (Web ID, Sucursal…). */
4590
+ label: string;
4591
+ /** Lo que dice el ticket en ese dato. */
4592
+ value: string;
4593
+ }[];
4594
+ /** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
4595
+ portal_url?: string | null;
4596
+ /** El correo de facturación de la tienda. */
4597
+ store_email?: string | null;
4598
+ /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
4599
+ use?: string | null;
4600
+ /** Una nota para su equipo. */
4601
+ note?: string | null;
4602
+ }
4603
+ export interface RequestPurchaseReceiptInvoiceParams {
4604
+ /** 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). */
4605
+ method: "fiscalisto" | "email" | "portal" | "manual";
4606
+ /** email: el correo de la tienda. Por omisión, store_email. */
4607
+ to?: string;
4608
+ /** email: unas líneas para la tienda. */
4609
+ message?: string;
4610
+ /** email y fiscalisto: el correo al que la tienda manda la factura. Por omisión, el correo de respuesta del emisor. */
4611
+ reply_to?: string;
4612
+ }
4613
+ export interface MarkPurchaseReceiptInvoicedParams {
4614
+ /** La factura recibida que lo cubre: su id (sat_…) o su folio fiscal (UUID). Sin ella, solo se marca facturado. */
4615
+ invoice?: string;
4616
+ }
4434
4617
  export interface CreatePaymentParams {
4435
4618
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4436
4619
  issuer?: string;
@@ -4556,7 +4739,7 @@ export type ApplyAdvanceParams = {
4556
4739
  export interface CreateRetentionParams {
4557
4740
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4558
4741
  issuer?: string;
4559
- /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) aún no se puede emitir. */
4742
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
4560
4743
  code: string;
4561
4744
  /** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
4562
4745
  description?: string | null;
@@ -4585,7 +4768,7 @@ export interface CreateRetentionParams {
4585
4768
  to_month?: number;
4586
4769
  };
4587
4770
  /** Totales (Totales). */
4588
- totals: {
4771
+ totals?: {
4589
4772
  /** Monto total de la operación (MontoTotOperacion). */
4590
4773
  operation: number;
4591
4774
  /** Monto gravado (MontoTotGrav). Por omisión, operation menos exempt. */
@@ -4594,7 +4777,7 @@ export interface CreateRetentionParams {
4594
4777
  exempt?: number;
4595
4778
  };
4596
4779
  /** Impuestos del comprobante, por tipo. */
4597
- taxes: {
4780
+ taxes?: {
4598
4781
  /** Impuesto: isr, iva o ieps (ImpuestoRet 001, 002, 003). */
4599
4782
  tax: string;
4600
4783
  /** Base del impuesto retenido (BaseRet). */
@@ -4604,6 +4787,46 @@ export interface CreateRetentionParams {
4604
4787
  /** Tipo de pago de la retención (TipoPagoRet): 01 definitivo IVA, 02 definitivo IEPS, 03 definitivo ISR, 04 provisional ISR. Por omisión el usual de cada impuesto. */
4605
4788
  payment_type?: string;
4606
4789
  }[];
4790
+ /** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
4791
+ platform?: {
4792
+ /** Tipo de servicio (TipoDeServ), c_TipoDeServ: 01 transporte de pasajeros, 02 entrega de alimentos, 03 entrega de bienes, 04 hospedaje, 05 comercio de bienes, 06 otros servicios, 07 a 09 servicios digitales de extranjeros, 11 apuestas y sorteos (desde 2026). */
4793
+ type: string;
4794
+ /** Cada cuánto paga la plataforma (Periodicidad): 01 semanal, 02 mensual (por omisión), 03 diaria, 04 quincenal, 05 otra. */
4795
+ periodicity?: string;
4796
+ /** true si la persona física optó por que el ISR retenido sea pago definitivo (LISR 113-B): TipoPagoRet 03 en lugar de 04. */
4797
+ isr_definitive?: boolean;
4798
+ /** true si se le deposita en una cuenta en el extranjero: se retiene el 100% del IVA (LIF 2026 art. 25-IX-c). */
4799
+ foreign_account?: boolean;
4800
+ /** Cada operación (DetallesDelServicio), hasta 5,000. Lo pagado en efectivo (payment_form 01) va en la constancia pero no en las bases. */
4801
+ services: {
4802
+ /** Fecha en que el cliente pagó (FechaServ), AAAA-MM-DD, dentro del mes del periodo. */
4803
+ date: string;
4804
+ /** Forma de pago de la operación (FormaPagoServ), c_FormaPagoServ: 01 efectivo, 02 transferencia, 03 tarjeta de crédito, 04 monedero, 05 dinero electrónico, 06 débito, 07 tarjeta de servicios, 08 intermediario de pagos, 09 premios o bonificaciones. */
4805
+ payment_form: string;
4806
+ /** Precio sin IVA (PrecioServSinIVA). */
4807
+ price: number;
4808
+ /** Tasa del impuesto trasladado (TasaCuota): 0.16 (por omisión), 0.08 o 0 de IVA; 0.5 de IEPS solo con type 11, donde cada jugada va dos veces: una operación con su IVA y otra con su IEPS (el SAT pide un impuesto por operación). Sin tasa en premios (09), que desde 2026 no suman en totals. */
4809
+ rate?: number | string | null;
4810
+ /** Subtipo (SubTipServ), c_SubTipoServ: con type 01, 01 personal (por omisión), 02 compartido, 03 plus o 04 cancelación; con type 11, 08 apuestas (por omisión) o 09 sorteos. */
4811
+ subtype?: string | null;
4812
+ /** RFC (persona física) del tercero autorizado que prestó el servicio (RFCTerceroAutorizado). */
4813
+ authorized_tax_id?: string | null;
4814
+ /** Comisión de la plataforma por la operación (ComisionDelServicio): amount mayor que cero y percent opcional (0.001 a 1). Obligatoria en cada operación con IVA; no va en premios ni en las de IEPS. */
4815
+ commission?: {
4816
+ /** Importe. */
4817
+ amount: number;
4818
+ /** El porcentaje de la comisión sobre el precio, de 0.001 a 1 (0.25 es 25%). Opcional. */
4819
+ percent?: number | null;
4820
+ } | null;
4821
+ /** Contribución gubernamental pagada, como el impuesto sobre hospedaje (ContribucionGubernamental): amount de al menos 1.00 y state (01 a 32). */
4822
+ contribution?: {
4823
+ /** Importe. */
4824
+ amount: number;
4825
+ /** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
4826
+ state: string;
4827
+ } | null;
4828
+ }[];
4829
+ };
4607
4830
  /** Complemento de dividendos. */
4608
4831
  dividends?: {
4609
4832
  /** Tipo de dividendo o utilidad distribuida (CveTipDivOUtil), c_TipoDividendoOUtilidadDistribuida. */
@@ -5674,8 +5897,8 @@ export interface GetDiotFileParams {
5674
5897
  export interface CreateStoreConnectionParams {
5675
5898
  /** El emisor (iss_…) dueño de la tienda. Por omisión, su único emisor. */
5676
5899
  issuer?: string;
5677
- /** shopify o mercadolibre. */
5678
- platform: "shopify" | "mercadolibre";
5900
+ /** shopify, woocommerce, mercadolibre, tiendanube o amazon. */
5901
+ platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
5679
5902
  /** Shopify: el dominio de la tienda (mi-tienda.myshopify.com). */
5680
5903
  shop?: string;
5681
5904
  /** Shopify: el Client ID de la app de la tienda (Dev Dashboard). */
@@ -5684,7 +5907,13 @@ export interface CreateStoreConnectionParams {
5684
5907
  client_secret?: string;
5685
5908
  /** Shopify, solo apps personalizadas antiguas: su token de la Admin API (shpat_…); client_secret es entonces su API secret key. */
5686
5909
  access_token?: string;
5687
- /** Mercado Libre: a dónde volver después de autorizar (se agregan store_connection y status). */
5910
+ /** WooCommerce: la dirección de la tienda (https://mitienda.com). */
5911
+ site?: string;
5912
+ /** WooCommerce: la Clave de cliente (ck_…) de una llave de la API REST con permisos de Lectura/Escritura. */
5913
+ consumer_key?: string;
5914
+ /** WooCommerce: la Clave secreta de cliente (cs_…) de esa llave. Se guarda cifrada y nunca se muestra. */
5915
+ consumer_secret?: string;
5916
+ /** Mercado Libre, Tiendanube y Amazon: a dónde volver después de autorizar (se agregan store_connection y status). */
5688
5917
  return_url?: string;
5689
5918
  /** Cómo se vuelve ticket cada pedido. */
5690
5919
  settings?: {
@@ -5704,6 +5933,8 @@ export interface CreateStoreConnectionParams {
5704
5933
  payment_forms?: Record<string, string>;
5705
5934
  /** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
5706
5935
  auto_invoice?: boolean;
5936
+ /** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
5937
+ notify_buyer?: boolean;
5707
5938
  };
5708
5939
  }
5709
5940
  /** Los parámetros de GET /v1/store_connections. */
@@ -5734,6 +5965,8 @@ export interface UpdateStoreConnectionParams {
5734
5965
  payment_forms?: Record<string, string>;
5735
5966
  /** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
5736
5967
  auto_invoice?: boolean;
5968
+ /** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
5969
+ notify_buyer?: boolean;
5737
5970
  };
5738
5971
  }
5739
5972
  export interface ImportStoreOrdersParams {
@@ -6642,6 +6875,101 @@ export declare class BankTransactionsResource {
6642
6875
  */
6643
6876
  reopen(id: string, options?: RequestOptions): Promise<BankTransaction>;
6644
6877
  }
6878
+ /** Tickets de compra: fiscalisto.purchaseReceipts. */
6879
+ export declare class PurchaseReceiptsResource {
6880
+ #private;
6881
+ constructor(client: Client);
6882
+ /**
6883
+ * Guardar un ticket de compra
6884
+ *
6885
+ * 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.
6886
+ *
6887
+ * POST /v1/purchase_receipts
6888
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
6889
+ */
6890
+ create(params: CreatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6891
+ /**
6892
+ * Listar tickets de compra
6893
+ *
6894
+ * Los más recientes primero.
6895
+ *
6896
+ * GET /v1/purchase_receipts
6897
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
6898
+ */
6899
+ list(params?: ListPurchaseReceiptsParams, options?: RequestOptions): List<PurchaseReceipt>;
6900
+ /**
6901
+ * Ver un ticket de compra
6902
+ *
6903
+ * Con la factura recibida que lo cubre, si ya llegó.
6904
+ *
6905
+ * GET /v1/purchase_receipts/{id}
6906
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
6907
+ */
6908
+ get(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6909
+ /**
6910
+ * Corregir un ticket de compra
6911
+ *
6912
+ * 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.
6913
+ *
6914
+ * POST /v1/purchase_receipts/{id}
6915
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
6916
+ */
6917
+ update(id: string, params?: UpdatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6918
+ /**
6919
+ * Borrar un ticket de compra
6920
+ *
6921
+ * El ticket y su archivo, para siempre.
6922
+ *
6923
+ * DELETE /v1/purchase_receipts/{id}
6924
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
6925
+ */
6926
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
6927
+ /**
6928
+ * Leer el ticket de nuevo
6929
+ *
6930
+ * 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.
6931
+ *
6932
+ * POST /v1/purchase_receipts/{id}/read
6933
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
6934
+ */
6935
+ read(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6936
+ /**
6937
+ * Pedir la factura a la tienda
6938
+ *
6939
+ * 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).
6940
+ *
6941
+ * POST /v1/purchase_receipts/{id}/request
6942
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
6943
+ */
6944
+ requestInvoice(id: string, params: RequestPurchaseReceiptInvoiceParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6945
+ /**
6946
+ * Ya llegó la factura
6947
+ *
6948
+ * 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.
6949
+ *
6950
+ * POST /v1/purchase_receipts/{id}/mark_invoiced
6951
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
6952
+ */
6953
+ markInvoiced(id: string, params?: MarkPurchaseReceiptInvoicedParams, options?: RequestOptions): Promise<PurchaseReceipt>;
6954
+ /**
6955
+ * Marcar como no deducible
6956
+ *
6957
+ * La tienda no dio factura: el gasto queda como no deducible.
6958
+ *
6959
+ * POST /v1/purchase_receipts/{id}/mark_non_deductible
6960
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
6961
+ */
6962
+ markNonDeductible(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6963
+ /**
6964
+ * Volver a pedir la factura
6965
+ *
6966
+ * Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
6967
+ *
6968
+ * POST /v1/purchase_receipts/{id}/reopen
6969
+ * @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
6970
+ */
6971
+ reopen(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
6972
+ }
6645
6973
  /** Pagos y notas de crédito: fiscalisto.payments. */
6646
6974
  export declare class PaymentsResource {
6647
6975
  #private;
@@ -7589,7 +7917,7 @@ export declare class StoreConnectionsResource {
7589
7917
  /**
7590
7918
  * Conectar una tienda
7591
7919
  *
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.
7920
+ * 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
7921
  *
7594
7922
  * POST /v1/store_connections
7595
7923
  * @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
@@ -7915,6 +8243,7 @@ export declare class FiscalistoApi extends Core {
7915
8243
  readonly invoices: InvoicesResource;
7916
8244
  readonly receivables: ReceivablesResource;
7917
8245
  readonly bankTransactions: BankTransactionsResource;
8246
+ readonly purchaseReceipts: PurchaseReceiptsResource;
7918
8247
  readonly payments: PaymentsResource;
7919
8248
  readonly creditNotes: CreditNotesResource;
7920
8249
  readonly advances: AdvancesResource;