fiscalisto 0.1.55 → 0.1.57

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.55";
7
+ export declare const VERSION = "0.1.57";
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.55";
6
+ export const VERSION = "0.1.57";
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.
@@ -491,7 +491,7 @@ export interface Invoice {
491
491
  global?: Record<string, unknown>;
492
492
  /** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
493
493
  cancellation: {
494
- /** pending (espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó) o lapsed (venció; puede pedirla otra vez). */
494
+ /** `pending`: el SAT tiene la solicitud (la termina en minutos, o espera la respuesta del receptor). `accepted`: cancelada. `rejected`: el receptor la rechazó. `lapsed`: el SAT nunca la registró; puede pedirse otra vez. `scheduled`: el SAT aún no la acepta (no registra el CFDI que la sustituye, o rechazó la firma un momento) y Fiscalisto la vuelve a pedir sola. `failed`: Fiscalisto dejó de intentarlo; pídala de nuevo con POST /v1/invoices/{id}/cancel. */
495
495
  status: string | null;
496
496
  /** Motivo de cancelación (c_MotivoCancelacion): 01 con errores con relación (lleva substitution), 02 con errores sin relación (por omisión), 03 no se llevó a cabo, 04 solo en una factura global, cuando una venta incluida se facturó a nombre del cliente. */
497
497
  motive: string | null;
@@ -499,6 +499,10 @@ export interface Invoice {
499
499
  substitution: string | null;
500
500
  /** Cuándo se canceló. */
501
501
  canceled_at: string | null;
502
+ /** Con `scheduled`: cuándo la vuelve a pedir Fiscalisto (null: en los próximos 15 minutos). */
503
+ next_attempt_at: string | null;
504
+ /** Con `scheduled` o `failed`: por qué no ha pasado. */
505
+ error: string | null;
502
506
  } | null;
503
507
  /** El envío por correo: a quién, con copia a quién y cuándo (null si no se ha enviado). */
504
508
  email: {
@@ -551,10 +555,25 @@ export interface Invoice {
551
555
  substitutes?: {
552
556
  /** La factura sustituida (inv_…). */
553
557
  invoice: string;
554
- /** true si la sustituida ya quedó cancelada. */
558
+ /** true si la sustituida ya quedó cancelada. false no es definitivo: vea substitutes.cancellation. */
555
559
  canceled: boolean;
556
560
  /** Por qué no se pudo cancelar la sustituida (cancélela con POST /v1/invoices/{id}/cancel). */
557
561
  cancel_error?: string;
562
+ /** La cancelación de la anterior, igual que su `cancellation` en GET /v1/invoices/{id}: `accepted` si ya quedó cancelada, `pending` si el SAT la está terminando (o espera al receptor), `scheduled` si Fiscalisto la vuelve a pedir sola, `failed` si hay que pedirla de nuevo. El webhook de la anterior dice cuando cambia. */
563
+ cancellation: {
564
+ /** `pending`: el SAT tiene la solicitud (la termina en minutos, o espera la respuesta del receptor). `accepted`: cancelada. `rejected`: el receptor la rechazó. `lapsed`: el SAT nunca la registró; puede pedirse otra vez. `scheduled`: el SAT aún no la acepta (no registra el CFDI que la sustituye, o rechazó la firma un momento) y Fiscalisto la vuelve a pedir sola. `failed`: Fiscalisto dejó de intentarlo; pídala de nuevo con POST /v1/invoices/{id}/cancel. */
565
+ status: string | null;
566
+ /** Motivo de cancelación (c_MotivoCancelacion): 01 con errores con relación (lleva substitution), 02 con errores sin relación (por omisión), 03 no se llevó a cabo, 04 solo en una factura global, cuando una venta incluida se facturó a nombre del cliente. */
567
+ motive: string | null;
568
+ /** El comprobante que sustituye a este (su id o su UUID), con el motivo 01. */
569
+ substitution: string | null;
570
+ /** Cuándo se canceló. */
571
+ canceled_at: string | null;
572
+ /** Con `scheduled`: cuándo la vuelve a pedir Fiscalisto (null: en los próximos 15 minutos). */
573
+ next_attempt_at: string | null;
574
+ /** Con `scheduled` o `failed`: por qué no ha pasado. */
575
+ error: string | null;
576
+ } | null;
558
577
  };
559
578
  /** La aplicación del anticipo: método, nota de aplicación y su estado. */
560
579
  advance_application?: {
@@ -664,7 +683,7 @@ export interface Retention {
664
683
  platform?: Record<string, unknown>;
665
684
  /** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
666
685
  cancellation: {
667
- /** pending (espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó) o lapsed (venció; puede pedirla otra vez). */
686
+ /** pending (el SAT la tiene: la termina en minutos o espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó), lapsed (venció; puede pedirla otra vez), scheduled (Fiscalisto la vuelve a pedir sola) o failed (Fiscalisto dejó de intentarlo; pídala de nuevo). */
668
687
  status: string;
669
688
  /** Motivo de cancelación (c_MotivoCancelacion): 01 con errores con relación (lleva substitution), 02 con errores sin relación (por omisión), 03 no se llevó a cabo, 04 solo en una factura global, cuando una venta incluida se facturó a nombre del cliente. */
670
689
  motive: string | null;
@@ -4396,14 +4415,14 @@ export interface CfdiVerification {
4396
4415
  checked_at: string;
4397
4416
  }
4398
4417
  /** Lo que puede pasar: el tipo de cada evento. */
4399
- export type EventType = "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready";
4418
+ export type EventType = "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.cancellation_failed" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready";
4400
4419
  /** Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks). */
4401
4420
  export interface EventBase<T extends EventType = EventType, O = unknown> {
4402
4421
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
4403
4422
  id: string;
4404
4423
  /** Qué tipo de objeto es («invoice», «customer»…). */
4405
4424
  object: "event";
4406
- /** Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, payroll_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, quote.withdrawn, sales_order.confirmed, sales_order.customer_confirmed, sales_order.delivered, sales_order.paid, sales_order.canceled, supplier_invoice.received, supplier_invoice.approved, supplier_invoice.rejected, supplier_invoice.scheduled, supplier_invoice.paid, portal_supplier.approved, issuer.ready, balance.low, usage.high o test_clock.ready. */
4425
+ /** Qué pasó: invoice.stamped, invoice.failed, invoice.canceled, invoice.cancellation_pending, invoice.cancellation_rejected, invoice.cancellation_failed, invoice.paid, invoice.partially_paid, retention.stamped, retention.failed, retention.canceled, invoice_batch.completed, payroll_batch.completed, customer_data_request.completed, sat_download.completed, sat_download.failed, sat_declaration.created, sat_declaration.updated, ticket.invoiced, ticket.included_in_global, recurring_invoice.failed, quote.viewed, quote.accepted, quote.changes_requested, quote.rejected, quote.withdrawn, sales_order.confirmed, sales_order.customer_confirmed, sales_order.delivered, sales_order.paid, sales_order.canceled, supplier_invoice.received, supplier_invoice.approved, supplier_invoice.rejected, supplier_invoice.scheduled, supplier_invoice.paid, portal_supplier.approved, issuer.ready, balance.low, usage.high o test_clock.ready. */
4407
4426
  type: T;
4408
4427
  /** Versión de la API con que se armó el objeto. */
4409
4428
  api_version: string;
@@ -4417,7 +4436,7 @@ export interface EventBase<T extends EventType = EventType, O = unknown> {
4417
4436
  };
4418
4437
  }
4419
4438
  /** Un evento: según su type, data.object es la factura, la constancia o el lote. */
4420
- export type Event = EventBase<"invoice.stamped", Invoice> | EventBase<"invoice.failed", Invoice> | EventBase<"invoice.canceled", Invoice> | EventBase<"invoice.cancellation_pending", Invoice> | EventBase<"invoice.cancellation_rejected", Invoice> | EventBase<"invoice.paid", Invoice> | EventBase<"invoice.partially_paid", Invoice> | EventBase<"invoice.email_bounced", Invoice> | EventBase<"invoice.email_complained", Invoice> | EventBase<"retention.stamped", Retention> | EventBase<"retention.failed", Retention> | EventBase<"retention.canceled", Retention> | EventBase<"invoice_batch.completed", InvoiceBatch> | EventBase<"payroll_batch.completed", PayrollBatch> | EventBase<"customer_data_request.completed", CustomerDataRequest> | EventBase<"sat_download.completed", SatDownload> | EventBase<"sat_download.failed", SatDownload> | EventBase<"sat_declaration.created", SatDeclaration> | EventBase<"sat_declaration.updated", SatDeclaration> | EventBase<"ticket.invoiced", Ticket> | EventBase<"ticket.included_in_global", Ticket> | EventBase<"recurring_invoice.failed", RecurringInvoice> | EventBase<"quote.viewed", Quote> | EventBase<"quote.accepted", Quote> | EventBase<"quote.changes_requested", Quote> | EventBase<"quote.rejected", Quote> | EventBase<"quote.withdrawn", Quote> | EventBase<"sales_order.confirmed", SalesOrder> | EventBase<"sales_order.customer_confirmed", SalesOrder> | EventBase<"sales_order.delivered", SalesOrder> | EventBase<"sales_order.paid", SalesOrder> | EventBase<"sales_order.canceled", SalesOrder> | EventBase<"supplier_invoice.received", SupplierInvoice> | EventBase<"supplier_invoice.approved", SupplierInvoice> | EventBase<"supplier_invoice.rejected", SupplierInvoice> | EventBase<"supplier_invoice.scheduled", SupplierInvoice> | EventBase<"supplier_invoice.paid", SupplierInvoice> | EventBase<"portal_supplier.approved", PortalSupplier> | EventBase<"issuer.ready", Issuer> | EventBase<"balance.low", Balance> | EventBase<"usage.high", Usage> | EventBase<"test_clock.ready", TestClock>;
4439
+ export type Event = EventBase<"invoice.stamped", Invoice> | EventBase<"invoice.failed", Invoice> | EventBase<"invoice.canceled", Invoice> | EventBase<"invoice.cancellation_pending", Invoice> | EventBase<"invoice.cancellation_rejected", Invoice> | EventBase<"invoice.cancellation_failed", Invoice> | EventBase<"invoice.paid", Invoice> | EventBase<"invoice.partially_paid", Invoice> | EventBase<"invoice.email_bounced", Invoice> | EventBase<"invoice.email_complained", Invoice> | EventBase<"retention.stamped", Retention> | EventBase<"retention.failed", Retention> | EventBase<"retention.canceled", Retention> | EventBase<"invoice_batch.completed", InvoiceBatch> | EventBase<"payroll_batch.completed", PayrollBatch> | EventBase<"customer_data_request.completed", CustomerDataRequest> | EventBase<"sat_download.completed", SatDownload> | EventBase<"sat_download.failed", SatDownload> | EventBase<"sat_declaration.created", SatDeclaration> | EventBase<"sat_declaration.updated", SatDeclaration> | EventBase<"ticket.invoiced", Ticket> | EventBase<"ticket.included_in_global", Ticket> | EventBase<"recurring_invoice.failed", RecurringInvoice> | EventBase<"quote.viewed", Quote> | EventBase<"quote.accepted", Quote> | EventBase<"quote.changes_requested", Quote> | EventBase<"quote.rejected", Quote> | EventBase<"quote.withdrawn", Quote> | EventBase<"sales_order.confirmed", SalesOrder> | EventBase<"sales_order.customer_confirmed", SalesOrder> | EventBase<"sales_order.delivered", SalesOrder> | EventBase<"sales_order.paid", SalesOrder> | EventBase<"sales_order.canceled", SalesOrder> | EventBase<"supplier_invoice.received", SupplierInvoice> | EventBase<"supplier_invoice.approved", SupplierInvoice> | EventBase<"supplier_invoice.rejected", SupplierInvoice> | EventBase<"supplier_invoice.scheduled", SupplierInvoice> | EventBase<"supplier_invoice.paid", SupplierInvoice> | EventBase<"portal_supplier.approved", PortalSupplier> | EventBase<"issuer.ready", Issuer> | EventBase<"balance.low", Balance> | EventBase<"usage.high", Usage> | EventBase<"test_clock.ready", TestClock>;
4421
4440
  /** Confirmación de que se borró. */
4422
4441
  export interface Deleted {
4423
4442
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -5085,6 +5104,15 @@ export interface InvoiceCreate {
5085
5104
  office?: string;
5086
5105
  }[];
5087
5106
  };
5107
+ /** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
5108
+ hydrocarbon?: {
5109
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
5110
+ permit_type: string;
5111
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
5112
+ permit_number: string;
5113
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
5114
+ subproduct: string;
5115
+ };
5088
5116
  /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
5089
5117
  addenda?: Record<string, string>;
5090
5118
  }[];
@@ -5826,7 +5854,7 @@ export interface ExternalPayrollReceiptCreate {
5826
5854
  social_security_number?: string;
5827
5855
  /** FechaInicioRelLaboral. */
5828
5856
  start_date?: string;
5829
- /** Antigüedad (P52W o P1Y2M3D). Sin el campo y con registro patronal: semanas desde start_date hasta el fin del periodo. */
5857
+ /** Antigüedad (P52W o P1Y2M3D). Sin el campo y con registro patronal: semanas desde start_date hasta el fin del periodo (días si es menos de una semana, P3D). */
5830
5858
  seniority?: string;
5831
5859
  /** Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. */
5832
5860
  contract_type: string;
@@ -6895,6 +6923,8 @@ export interface CreatePayrollReceiptParams {
6895
6923
  };
6896
6924
  /** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
6897
6925
  days?: number;
6926
+ /** El recibo vigente (inv_… o UUID) que este corrige, calculado por Fiscalisto para el mismo empleado: el nuevo se calcula con los datos del empleado como están ahora, va relacionado con 04 y el anterior se cancela con motivo 01. Para un recibo que calculó su sistema use POST /v1/payroll_receipts/external con replaces. */
6927
+ replaces?: string;
6898
6928
  /** true para mandar el PDF y el XML por correo al timbrar, con el diseño de Fiscalisto. Por omisión no se envía. */
6899
6929
  send_email?: boolean;
6900
6930
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
@@ -6916,6 +6946,8 @@ export interface PreviewPayrollReceiptParams {
6916
6946
  };
6917
6947
  /** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
6918
6948
  days?: number;
6949
+ /** El recibo vigente (inv_… o UUID) que este corrige, calculado por Fiscalisto para el mismo empleado: el nuevo se calcula con los datos del empleado como están ahora, va relacionado con 04 y el anterior se cancela con motivo 01. Para un recibo que calculó su sistema use POST /v1/payroll_receipts/external con replaces. */
6950
+ replaces?: string;
6919
6951
  /** true para mandar el PDF y el XML por correo al timbrar, con el diseño de Fiscalisto. Por omisión no se envía. */
6920
6952
  send_email?: boolean;
6921
6953
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
@@ -8574,6 +8606,15 @@ export interface CreateQuoteParams {
8574
8606
  office?: string;
8575
8607
  }[];
8576
8608
  };
8609
+ /** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
8610
+ hydrocarbon?: {
8611
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
8612
+ permit_type: string;
8613
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
8614
+ permit_number: string;
8615
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
8616
+ subproduct: string;
8617
+ };
8577
8618
  /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
8578
8619
  addenda?: Record<string, string>;
8579
8620
  }[];
@@ -8729,6 +8770,15 @@ export interface UpdateQuoteParams {
8729
8770
  office?: string;
8730
8771
  }[];
8731
8772
  };
8773
+ /** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
8774
+ hydrocarbon?: {
8775
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
8776
+ permit_type: string;
8777
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
8778
+ permit_number: string;
8779
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
8780
+ subproduct: string;
8781
+ };
8732
8782
  /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
8733
8783
  addenda?: Record<string, string>;
8734
8784
  }[];
@@ -8890,6 +8940,15 @@ export interface CreateSalesOrderParams {
8890
8940
  office?: string;
8891
8941
  }[];
8892
8942
  };
8943
+ /** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
8944
+ hydrocarbon?: {
8945
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
8946
+ permit_type: string;
8947
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
8948
+ permit_number: string;
8949
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
8950
+ subproduct: string;
8951
+ };
8893
8952
  /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
8894
8953
  addenda?: Record<string, string>;
8895
8954
  }[];
@@ -9054,6 +9113,15 @@ export interface UpdateSalesOrderParams {
9054
9113
  office?: string;
9055
9114
  }[];
9056
9115
  };
9116
+ /** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
9117
+ hydrocarbon?: {
9118
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
9119
+ permit_type: string;
9120
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
9121
+ permit_number: string;
9122
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
9123
+ subproduct: string;
9124
+ };
9057
9125
  /** Addenda del receptor (Walmart, Soriana…), con sus propios campos. */
9058
9126
  addenda?: Record<string, string>;
9059
9127
  }[];
@@ -9173,7 +9241,7 @@ export interface RollWebhookSecretParams {
9173
9241
  }
9174
9242
  export interface TestWebhookEndpointParams {
9175
9243
  /** El evento a mandar. Por omisión invoice.stamped. */
9176
- type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready";
9244
+ type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.cancellation_failed" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready";
9177
9245
  }
9178
9246
  /** Los parámetros de GET /v1/webhook_endpoints/{id}/deliveries. */
9179
9247
  export interface ListWebhookDeliveriesParams {
@@ -9191,7 +9259,7 @@ export interface ListEventsParams {
9191
9259
  /** El id del último de la página anterior, para la siguiente. */
9192
9260
  starting_after?: string;
9193
9261
  /** Solo de este tipo (invoice.stamped), o todos los de un recurso con un comodín (invoice.*). */
9194
- type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready" | "invoice.*" | "invoice_batch.*" | "payroll_batch.*" | "recurring_invoice.*" | "quote.*" | "sales_order.*" | "supplier_invoice.*" | "portal_supplier.*" | "ticket.*" | "retention.*" | "customer_data_request.*" | "sat_download.*" | "sat_declaration.*" | "issuer.*" | "balance.*" | "usage.*" | "test_clock.*";
9262
+ type?: "invoice.stamped" | "invoice.failed" | "invoice.canceled" | "invoice.cancellation_pending" | "invoice.cancellation_rejected" | "invoice.cancellation_failed" | "invoice.paid" | "invoice.partially_paid" | "invoice.email_bounced" | "invoice.email_complained" | "retention.stamped" | "retention.failed" | "retention.canceled" | "invoice_batch.completed" | "payroll_batch.completed" | "customer_data_request.completed" | "sat_download.completed" | "sat_download.failed" | "sat_declaration.created" | "sat_declaration.updated" | "ticket.invoiced" | "ticket.included_in_global" | "recurring_invoice.failed" | "quote.viewed" | "quote.accepted" | "quote.changes_requested" | "quote.rejected" | "quote.withdrawn" | "sales_order.confirmed" | "sales_order.customer_confirmed" | "sales_order.delivered" | "sales_order.paid" | "sales_order.canceled" | "supplier_invoice.received" | "supplier_invoice.approved" | "supplier_invoice.rejected" | "supplier_invoice.scheduled" | "supplier_invoice.paid" | "portal_supplier.approved" | "issuer.ready" | "balance.low" | "usage.high" | "test_clock.ready" | "invoice.*" | "invoice_batch.*" | "payroll_batch.*" | "recurring_invoice.*" | "quote.*" | "sales_order.*" | "supplier_invoice.*" | "portal_supplier.*" | "ticket.*" | "retention.*" | "customer_data_request.*" | "sat_download.*" | "sat_declaration.*" | "issuer.*" | "balance.*" | "usage.*" | "test_clock.*";
9195
9263
  /** Solo los de este objeto (inv_…, ret_…, bat_…). */
9196
9264
  object?: string;
9197
9265
  /** false: los que algún webhook no recibió (su último intento falló). true: los que recibieron todos los webhooks a los que se mandaron. */