fiscalisto 0.1.52 → 0.1.53

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.52";
7
+ export declare const VERSION = "0.1.53";
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.52";
6
+ export const VERSION = "0.1.53";
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.
@@ -83,6 +83,8 @@ export declare const ErrorCode: {
83
83
  readonly InventoryRefused: "inventory_refused";
84
84
  /** La factura no cumple una regla del SAT que Fiscalisto revisa antes de mandarla al PAC (uso contra régimen, totales, complementos…). No se usó ningún timbre. */
85
85
  readonly InvoiceInvalid: "invoice_invalid";
86
+ /** El acuse de cancelación existe cuando el SAT ya canceló la factura (status canceled). Con una cancelación en espera del cliente (pending), espere invoice.canceled. */
87
+ readonly InvoiceNotCanceled: "invoice_not_canceled";
86
88
  /** Solo una factura de ingreso PUE vigente se marca pagada o por cobrar; una PPD se paga con su complemento de pago (type P). */
87
89
  readonly InvoiceNotMarkable: "invoice_not_markable";
88
90
  /** La acción es para facturas timbradas (enviar, cancelar, sustituir). */
@@ -84,6 +84,8 @@ export const ErrorCode = {
84
84
  InventoryRefused: "inventory_refused",
85
85
  /** La factura no cumple una regla del SAT que Fiscalisto revisa antes de mandarla al PAC (uso contra régimen, totales, complementos…). No se usó ningún timbre. */
86
86
  InvoiceInvalid: "invoice_invalid",
87
+ /** El acuse de cancelación existe cuando el SAT ya canceló la factura (status canceled). Con una cancelación en espera del cliente (pending), espere invoice.canceled. */
88
+ InvoiceNotCanceled: "invoice_not_canceled",
87
89
  /** Solo una factura de ingreso PUE vigente se marca pagada o por cobrar; una PPD se paga con su complemento de pago (type P). */
88
90
  InvoiceNotMarkable: "invoice_not_markable",
89
91
  /** La acción es para facturas timbradas (enviar, cancelar, sustituir). */
@@ -1060,6 +1060,80 @@ export interface ExternalPayrollReceiptPreview {
1060
1060
  /** El XML que se mandaría al PAC, sin sello ni timbre: sus importes son exactamente los que mandó. */
1061
1061
  unsigned_xml: string;
1062
1062
  }
1063
+ /** Una factura revisada y sin timbrar: lo que se timbraría ahora con POST /v1/invoices y el mismo cuerpo. */
1064
+ export interface InvoicePreview {
1065
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1066
+ object: "invoice_preview";
1067
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1068
+ livemode: boolean;
1069
+ /** El emisor (iss_…). */
1070
+ issuer: string;
1071
+ /** Sucursal (brn_…) desde donde se factura: su código postal va en LugarExpedicion, su dirección en el PDF y, si las tiene, sus series. Sin ella, el domicilio fiscal del emisor (la Matriz). */
1072
+ branch: string | null;
1073
+ /** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
1074
+ type: "I" | "E" | "T";
1075
+ /** Serie (Serie), hasta 25 caracteres. Cada serie lleva sus propios folios. */
1076
+ series: string | null;
1077
+ /** El folio que tendría si se timbrara ahora; otra factura timbrada antes puede tomarlo. */
1078
+ folio: string | null;
1079
+ /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
1080
+ date: string | null;
1081
+ /** Cliente (Receptor): el id de uno de su catálogo (cus_…) o sus datos en un objeto. */
1082
+ customer: {
1083
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1084
+ tax_id: string | null;
1085
+ /** Nombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»). */
1086
+ legal_name: string | null;
1087
+ /** Régimen fiscal (RegimenFiscal), clave de c_RegimenFiscal: 601, 612, 626… */
1088
+ tax_system?: string;
1089
+ /** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
1090
+ zip?: string;
1091
+ /** Si es extranjero: su país de residencia (ResidenciaFiscal, c_Pais) y su número de registro tributario (NumRegIdTrib), con el RFC genérico XEXX010101000. */
1092
+ foreign?: Record<string, unknown>;
1093
+ };
1094
+ /** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
1095
+ use: string | null;
1096
+ /** Forma de pago (FormaPago), clave de c_FormaPago: 01 efectivo, 03 transferencia, 04 tarjeta de crédito, 28 débito, 99 por definir… Obligatoria con PUE; con PPD es 99. */
1097
+ payment_form: string | null;
1098
+ /** Método de pago (MetodoPago): PUE (una sola exhibición, por omisión) o PPD (en parcialidades o diferido, se cobra con complementos de pago). */
1099
+ payment_method: string | null;
1100
+ /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
1101
+ currency: string;
1102
+ /** Tipo de cambio a pesos (TipoCambio). Obligatorio si la moneda no es MXN; use el del DOF del día anterior. */
1103
+ exchange_rate: number | null;
1104
+ /** Conceptos (Conceptos), al menos uno. */
1105
+ items: InvoiceItem[];
1106
+ /** Suma de los importes antes de impuestos y descuentos (SubTotal). */
1107
+ subtotal: number | null;
1108
+ /** Descuento (Descuento). */
1109
+ discount: number | null;
1110
+ /** Los impuestos de la factura, por tipo: IVA e IEPS trasladados, IVA e ISR retenidos e impuestos locales. */
1111
+ taxes: {
1112
+ /** IVA trasladado. */
1113
+ iva: number | null;
1114
+ /** IEPS trasladado. */
1115
+ ieps: number | null;
1116
+ /** IVA retenido. */
1117
+ iva_withheld: number | null;
1118
+ /** ISR retenido. */
1119
+ isr_withheld: number | null;
1120
+ /** Impuestos locales trasladados. */
1121
+ local_transferred: number | null;
1122
+ /** Impuestos locales retenidos. */
1123
+ local_withheld: number | null;
1124
+ } | null;
1125
+ /** Total en la moneda del comprobante (Total). */
1126
+ total: number;
1127
+ /** Lo que conviene revisar antes de timbrar (un cliente en las listas 69 o 69-B del SAT, una factura que parece duplicada); no impide timbrar. */
1128
+ warnings: {
1129
+ /** 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. */
1130
+ code: string;
1131
+ /** Qué pasó y cómo corregirlo, para una persona. */
1132
+ message: string;
1133
+ }[];
1134
+ /** El XML que se mandaría al PAC, sin sello ni timbre. */
1135
+ unsigned_xml: string;
1136
+ }
1063
1137
  /** Un anticipo timbrado que aún no se aplica. */
1064
1138
  export interface Advance {
1065
1139
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -1363,6 +1437,46 @@ export interface SatListCheck {
1363
1437
  /** Las listas que no se pudieron confirmar (su última actualización falló, falta o tiene más de dos días). Vacía si todas están al día. */
1364
1438
  lists_unavailable: string[];
1365
1439
  }
1440
+ /** Si los sellos del XML son auténticos, como los revisa el SAT: el Sello del emisor contra la cadena original y su certificado, y el SelloSAT del timbre contra el certificado del SAT. */
1441
+ export interface CfdiSeals {
1442
+ /** true si no hay ningún problema: el Sello corresponde a los datos y al certificado del emisor (un CSD de su RFC, vigente en la fecha de emisión) y el timbre es de este comprobante y del SAT. */
1443
+ valid: boolean;
1444
+ /** Si el Sello del emisor firma la cadena original de este XML con la llave del certificado que trae. false si alguien cambió un monto, un nombre o una fecha después de sellar. */
1445
+ issuer_seal_valid: boolean;
1446
+ /** El certificado del emisor que trae el XML (Certificado): número, RFC, nombre, si es CSD o e.firma y su vigencia. null si no se pudo leer. */
1447
+ certificate: {
1448
+ /** El número del certificado (20 dígitos), como lo da el SAT. */
1449
+ number: string;
1450
+ /** El RFC dueño del certificado. */
1451
+ tax_id: string | null;
1452
+ /** El nombre o razón social en el certificado. */
1453
+ name: string | null;
1454
+ /** csd si es un sello digital; fiel si es una e.firma (no se debe sellar con ella). */
1455
+ kind: "csd" | "fiel";
1456
+ /** Desde cuándo vale el certificado. */
1457
+ valid_from: string;
1458
+ /** Hasta cuándo vale el certificado. */
1459
+ valid_to: string;
1460
+ } | null;
1461
+ /** El timbre (TimbreFiscalDigital): si su SelloSAT es del SAT, con qué certificado del SAT y qué PAC lo timbró. null si el XML no está timbrado. */
1462
+ stamp: {
1463
+ /** Si el SelloSAT firma el timbre con el certificado del SAT (NoCertificadoSAT). null si el certificado del SAT no se pudo obtener en ese momento. */
1464
+ sat_seal_valid: boolean | null;
1465
+ /** El número del certificado del SAT que selló el timbre. */
1466
+ sat_certificate_number: string;
1467
+ /** El RFC del PAC que timbró (RfcProvCertif). */
1468
+ pac_tax_id: string | null;
1469
+ } | null;
1470
+ /** Cada problema, con su código y qué significa. Vacía si valid es true. */
1471
+ problems: {
1472
+ /** 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. */
1473
+ code: "malformed_xml" | "missing_seal" | "certificate_unreadable" | "certificate_number_mismatch" | "certificate_not_issuer" | "certificate_not_csd" | "certificate_not_valid_at_issue" | "seal_mismatch" | "stamp_not_for_this_seal" | "sat_seal_mismatch";
1474
+ /** Qué pasó y cómo corregirlo, para una persona. */
1475
+ message: string;
1476
+ }[];
1477
+ /** La cadena original del comprobante, como la arma el SAT con sus XSLT. null si el XML no se pudo leer. */
1478
+ original_string: string | null;
1479
+ }
1366
1480
  /** Si los datos fiscales de un cliente van a pasar el SAT. */
1367
1481
  export interface TaxIdValidation {
1368
1482
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -4033,6 +4147,54 @@ export interface EventResend {
4033
4147
  /** A cuántos webhooks salió. 0 si ninguno encendido escucha ese tipo de evento. */
4034
4148
  deliveries: number;
4035
4149
  }
4150
+ /** Cómo se ven los documentos de un emisor: nombre comercial, estilo y color del PDF, y logo. */
4151
+ export interface IssuerBranding {
4152
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4153
+ object: "issuer_branding";
4154
+ /** El emisor (iss_…). */
4155
+ issuer: string;
4156
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
4157
+ livemode: boolean;
4158
+ /** Su nombre comercial: va en grande en el PDF, el correo y la página de la factura; null: la razón social. */
4159
+ trade_name: string | null;
4160
+ /** Estilo del PDF: clasico, moderno, compacto o minimalista; null: clasico. */
4161
+ pdf_style: "clasico" | "moderno" | "compacto" | "minimalista" | null;
4162
+ /** Color del PDF (#RRGGBB); null: el de Fiscalisto (#5B48EE). */
4163
+ pdf_color: string | null;
4164
+ /** Dirección pública del logo; null si no tiene. */
4165
+ logo_url: string | null;
4166
+ }
4167
+ /** Lo que pasó con un evento en un webhook: su último intento, cuántos lleva y cuándo va el siguiente. */
4168
+ export interface WebhookDelivery {
4169
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4170
+ object: "webhook_delivery";
4171
+ /** El último intento (whd_…). Úselo en starting_after para la página siguiente. */
4172
+ id: string;
4173
+ /** El webhook (whe_…). */
4174
+ webhook_endpoint: string;
4175
+ /** El evento (evt_…). Reenvíelo con POST /v1/events/{id}/resend. */
4176
+ event: string;
4177
+ /** El tipo del evento (invoice.stamped…). */
4178
+ event_type: string | null;
4179
+ /** true si su servidor contestó 2xx en el último intento. */
4180
+ succeeded: boolean;
4181
+ /** El código HTTP que contestó su servidor; null si no se pudo conectar. */
4182
+ status: number | null;
4183
+ /** Qué falló (tiempo de espera, DNS, o el inicio de su respuesta); null si llegó. */
4184
+ error: string | null;
4185
+ /** Cuánto tardó su servidor en contestar el último intento. */
4186
+ duration_ms: number;
4187
+ /** Cuántas veces se ha mandado a este webhook, reenvíos incluidos. */
4188
+ attempts: number;
4189
+ /** true si el último intento fue un reenvío (POST /v1/events/{id}/resend). */
4190
+ resent: boolean;
4191
+ /** true si es un evento de prueba (POST /v1/webhook_endpoints/{id}/test); no se reintenta. */
4192
+ test: boolean;
4193
+ /** Cuándo fue el último intento. */
4194
+ created_at: string;
4195
+ /** Cuándo va el siguiente reintento automático; null si llegó o ya no hay más. */
4196
+ next_retry_at: string | null;
4197
+ }
4036
4198
  /** Lo que dice el SAT de un CFDI: si existe, si está vigente o cancelado y si se puede cancelar, con su emisor y su receptor en las listas del SAT. */
4037
4199
  export interface CfdiVerification {
4038
4200
  /** Qué tipo de objeto es («invoice», «customer»…). */
@@ -4087,6 +4249,8 @@ export interface CfdiVerification {
4087
4249
  /** Moneda, clave ISO 4217 de c_Moneda (MXN, USD, EUR…). Por omisión MXN. */
4088
4250
  currency: string | null;
4089
4251
  } | null;
4252
+ /** Los sellos del XML, si mandó xml de un CFDI 4.0: si el comprobante no se modificó después de sellarse y si el timbre es del SAT. null con qr o fields, o con un CFDI 3.3. */
4253
+ seals: CfdiSeals | null;
4090
4254
  /** El emisor en las listas del SAT (69-B, 69-B Bis y art. 69), como GET /v1/sat_lists/{tax_id}, sin costo. Solo cuando el SAT tiene el comprobante (active o canceled); null si no, o si las listas no se pudieron leer. */
4091
4255
  issuer_sat_lists: SatListCheck | null;
4092
4256
  /** El receptor en las listas del SAT, igual que el emisor. */
@@ -4588,6 +4752,16 @@ export interface WebhookEndpointList {
4588
4752
  /** La ruta de esta lista. */
4589
4753
  url: string;
4590
4754
  }
4755
+ export interface WebhookDeliveryList {
4756
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4757
+ object: "list";
4758
+ /** Los objetos de esta página. */
4759
+ data: WebhookDelivery[];
4760
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4761
+ has_more: boolean;
4762
+ /** La ruta de esta lista. */
4763
+ url: string;
4764
+ }
4591
4765
  export interface EventList {
4592
4766
  /** Qué tipo de objeto es («invoice», «customer»…). */
4593
4767
  object: "list";
@@ -5718,6 +5892,18 @@ export interface UploadCertificateParams {
5718
5892
  /** La contraseña de la llave privada (.key). Se usa para abrirla y no se guarda en texto. */
5719
5893
  password: string;
5720
5894
  }
5895
+ export interface UpdateIssuerBrandingParams {
5896
+ /** Su nombre comercial, si se presenta con otra marca: va en grande en el PDF, en el correo y en la página de la factura. null: la razón social. */
5897
+ trade_name?: string | null;
5898
+ /** Estilo del PDF: clasico (por omisión), moderno (encabezado y total con color, renglones alternados), compacto (letra chica, márgenes cortos) o minimalista (sin rellenos, el color solo en el total). */
5899
+ pdf_style?: "clasico" | "moderno" | "compacto" | "minimalista" | null;
5900
+ /** Color del PDF, como #2563EB. null: el de Fiscalisto (#5B48EE). */
5901
+ pdf_color?: string | null;
5902
+ }
5903
+ export interface UploadIssuerLogoParams {
5904
+ /** El logo, PNG o JPG de hasta 1 MB, en base64 (con o sin el prefijo data:image/png;base64,). Uno muy grande se reduce para el PDF. */
5905
+ file: string;
5906
+ }
5721
5907
  export interface SignEfirmaParams {
5722
5908
  /** El archivo .cer en base64 (puede traer el prefijo data:). */
5723
5909
  cer: string;
@@ -5778,6 +5964,11 @@ export interface GetInvoiceXmlParams {
5778
5964
  /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
5779
5965
  issuer?: string;
5780
5966
  }
5967
+ /** Los parámetros de GET /v1/invoices/{id}/cancellation_receipt. */
5968
+ export interface GetInvoiceCancellationReceiptParams {
5969
+ /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
5970
+ issuer?: string;
5971
+ }
5781
5972
  export interface SendInvoiceParams {
5782
5973
  /** A quién (correos separados por comas). */
5783
5974
  to?: string;
@@ -8692,6 +8883,15 @@ export interface TestWebhookEndpointParams {
8692
8883
  /** El evento a mandar. Por omisión invoice.stamped. */
8693
8884
  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";
8694
8885
  }
8886
+ /** Los parámetros de GET /v1/webhook_endpoints/{id}/deliveries. */
8887
+ export interface ListWebhookDeliveriesParams {
8888
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
8889
+ limit?: number;
8890
+ /** El id del último de la página anterior, para la siguiente. */
8891
+ starting_after?: string;
8892
+ /** false: solo los que fallaron en su último intento. true: solo los que llegaron. */
8893
+ succeeded?: boolean;
8894
+ }
8695
8895
  /** Los parámetros de GET /v1/events. */
8696
8896
  export interface ListEventsParams {
8697
8897
  /** Cuántos por página, de 1 a 100. Por omisión 10. */
@@ -8900,6 +9100,42 @@ export declare class IssuersResource {
8900
9100
  * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-certificate
8901
9101
  */
8902
9102
  uploadCertificate(id: string, params: UploadCertificateParams, options?: RequestOptions): Promise<Issuer>;
9103
+ /**
9104
+ * Ver el diseño del PDF
9105
+ *
9106
+ * Cómo se ven los documentos del emisor: su nombre comercial, el estilo y el color del PDF y su logo. Es lo mismo que Ajustes › Marca y documentos en la app.
9107
+ *
9108
+ * GET /v1/issuers/{id}/branding
9109
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/get-issuer-branding
9110
+ */
9111
+ getBranding(id: string, options?: RequestOptions): Promise<IssuerBranding>;
9112
+ /**
9113
+ * Cambiar el diseño del PDF
9114
+ *
9115
+ * Cambia el nombre comercial, el estilo (clasico, moderno, compacto o minimalista) y el color del PDF de las facturas, notas, pagos, recibos y cotizaciones del emisor, y de sus correos. Lo que no mande se queda como está; null vuelve al de omisión. Se ve en el siguiente PDF que pida, también de lo ya timbrado. Una sucursal puede tener el suyo (POST /v1/branches/{id}).
9116
+ *
9117
+ * POST /v1/issuers/{id}/branding
9118
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/update-issuer-branding
9119
+ */
9120
+ updateBranding(id: string, params?: UpdateIssuerBrandingParams, options?: RequestOptions): Promise<IssuerBranding>;
9121
+ /**
9122
+ * Subir el logo
9123
+ *
9124
+ * El logo del emisor (PNG o JPG de hasta 1 MB, en base64): va en sus PDF, sus correos y la página de la factura que ve su cliente. Reemplaza el anterior.
9125
+ *
9126
+ * POST /v1/issuers/{id}/logo
9127
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-issuer-logo
9128
+ */
9129
+ uploadLogo(id: string, params: UploadIssuerLogoParams, options?: RequestOptions): Promise<IssuerBranding>;
9130
+ /**
9131
+ * Quitar el logo
9132
+ *
9133
+ * Sus PDF y correos van sin logo, con su nombre.
9134
+ *
9135
+ * DELETE /v1/issuers/{id}/logo
9136
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/delete-issuer-logo
9137
+ */
9138
+ deleteLogo(id: string, options?: RequestOptions): Promise<IssuerBranding>;
8903
9139
  /**
8904
9140
  * Firmar el contrato con el PAC
8905
9141
  *
@@ -9031,6 +9267,15 @@ export declare class InvoicesResource {
9031
9267
  * @see https://fiscalisto.com/docs/api/referencia/facturas/list-invoices
9032
9268
  */
9033
9269
  list(params?: ListInvoicesParams, options?: RequestOptions): List<Invoice>;
9270
+ /**
9271
+ * Revisar una factura sin timbrar
9272
+ *
9273
+ * El mismo cuerpo y las mismas revisiones que POST /v1/invoices, sin timbrar ni usar timbres: devuelve la factura como se timbraría ahora (con los datos fiscales del emisor, el siguiente folio, el subtotal, los impuestos y el total que calcula Fiscalisto), los avisos (un cliente en las listas del SAT, un duplicado) y el XML sin sellar (unsigned_xml). Úsela para mostrar el total antes de cobrar o para validar en su sistema; si algo falla, invoice_invalid como al timbrar. No pide Idempotency-Key y sirve con una llave de solo lectura.
9274
+ *
9275
+ * POST /v1/invoices/preview
9276
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/preview-invoice
9277
+ */
9278
+ preview(params: InvoiceCreate, options?: RequestOptions): Promise<InvoicePreview>;
9034
9279
  /**
9035
9280
  * Ver una factura
9036
9281
  *
@@ -9067,6 +9312,15 @@ export declare class InvoicesResource {
9067
9312
  * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-xml
9068
9313
  */
9069
9314
  xml(id: string, params?: GetInvoiceXmlParams, options?: RequestOptions): Promise<string>;
9315
+ /**
9316
+ * Descargar el acuse de cancelación
9317
+ *
9318
+ * El acuse de cancelación del SAT (XML firmado por el SAT) de una factura cancelada: la prueba de que el SAT la canceló y cuándo. Antes de que el SAT la cancele (status valid o pending), 409 invoice_not_canceled.
9319
+ *
9320
+ * GET /v1/invoices/{id}/cancellation_receipt
9321
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-cancellation-receipt
9322
+ */
9323
+ cancellationReceipt(id: string, params?: GetInvoiceCancellationReceiptParams, options?: RequestOptions): Promise<string>;
9070
9324
  /**
9071
9325
  * Enviar por correo
9072
9326
  *
@@ -11260,6 +11514,15 @@ export declare class WebhookEndpointsResource {
11260
11514
  * @see https://fiscalisto.com/docs/api/referencia/webhooks/test-webhook-endpoint
11261
11515
  */
11262
11516
  test(id: string, params?: TestWebhookEndpointParams, options?: RequestOptions): Promise<WebhookTest>;
11517
+ /**
11518
+ * Listar entregas
11519
+ *
11520
+ * Qué pasó con cada evento en este webhook, el más reciente primero: una fila por evento con su último intento, cuántos lleva y cuándo va el siguiente reintento. Con succeeded=false ve los que su servidor no recibió, para reenviarlos con POST /v1/events/{id}/resend.
11521
+ *
11522
+ * GET /v1/webhook_endpoints/{id}/deliveries
11523
+ * @see https://fiscalisto.com/docs/api/referencia/webhooks/list-webhook-deliveries
11524
+ */
11525
+ listDeliveries(id: string, params?: ListWebhookDeliveriesParams, options?: RequestOptions): List<WebhookDelivery>;
11263
11526
  }
11264
11527
  /** Eventos: fiscalisto.events. */
11265
11528
  export declare class EventsResource {
package/dist/generated.js CHANGED
@@ -239,6 +239,50 @@ export class IssuersResource {
239
239
  uploadCertificate(id, params, options) {
240
240
  return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/certificates`, body: params, idempotent: true }, options);
241
241
  }
242
+ /**
243
+ * Ver el diseño del PDF
244
+ *
245
+ * Cómo se ven los documentos del emisor: su nombre comercial, el estilo y el color del PDF y su logo. Es lo mismo que Ajustes › Marca y documentos en la app.
246
+ *
247
+ * GET /v1/issuers/{id}/branding
248
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/get-issuer-branding
249
+ */
250
+ getBranding(id, options) {
251
+ return this.#client.request({ method: "GET", path: `/v1/issuers/${encodeURIComponent(id)}/branding` }, options);
252
+ }
253
+ /**
254
+ * Cambiar el diseño del PDF
255
+ *
256
+ * Cambia el nombre comercial, el estilo (clasico, moderno, compacto o minimalista) y el color del PDF de las facturas, notas, pagos, recibos y cotizaciones del emisor, y de sus correos. Lo que no mande se queda como está; null vuelve al de omisión. Se ve en el siguiente PDF que pida, también de lo ya timbrado. Una sucursal puede tener el suyo (POST /v1/branches/{id}).
257
+ *
258
+ * POST /v1/issuers/{id}/branding
259
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/update-issuer-branding
260
+ */
261
+ updateBranding(id, params, options) {
262
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/branding`, body: params, idempotent: true }, options);
263
+ }
264
+ /**
265
+ * Subir el logo
266
+ *
267
+ * El logo del emisor (PNG o JPG de hasta 1 MB, en base64): va en sus PDF, sus correos y la página de la factura que ve su cliente. Reemplaza el anterior.
268
+ *
269
+ * POST /v1/issuers/{id}/logo
270
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/upload-issuer-logo
271
+ */
272
+ uploadLogo(id, params, options) {
273
+ return this.#client.request({ method: "POST", path: `/v1/issuers/${encodeURIComponent(id)}/logo`, body: params, idempotent: true }, options);
274
+ }
275
+ /**
276
+ * Quitar el logo
277
+ *
278
+ * Sus PDF y correos van sin logo, con su nombre.
279
+ *
280
+ * DELETE /v1/issuers/{id}/logo
281
+ * @see https://fiscalisto.com/docs/api/referencia/emisores/delete-issuer-logo
282
+ */
283
+ deleteLogo(id, options) {
284
+ return this.#client.request({ method: "DELETE", path: `/v1/issuers/${encodeURIComponent(id)}/logo` }, options);
285
+ }
242
286
  /**
243
287
  * Firmar el contrato con el PAC
244
288
  *
@@ -400,6 +444,17 @@ export class InvoicesResource {
400
444
  list(params, options) {
401
445
  return this.#client.list({ path: "/v1/invoices", query: params }, options);
402
446
  }
447
+ /**
448
+ * Revisar una factura sin timbrar
449
+ *
450
+ * El mismo cuerpo y las mismas revisiones que POST /v1/invoices, sin timbrar ni usar timbres: devuelve la factura como se timbraría ahora (con los datos fiscales del emisor, el siguiente folio, el subtotal, los impuestos y el total que calcula Fiscalisto), los avisos (un cliente en las listas del SAT, un duplicado) y el XML sin sellar (unsigned_xml). Úsela para mostrar el total antes de cobrar o para validar en su sistema; si algo falla, invoice_invalid como al timbrar. No pide Idempotency-Key y sirve con una llave de solo lectura.
451
+ *
452
+ * POST /v1/invoices/preview
453
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/preview-invoice
454
+ */
455
+ preview(params, options) {
456
+ return this.#client.request({ method: "POST", path: "/v1/invoices/preview", body: params, idempotent: true }, options);
457
+ }
403
458
  /**
404
459
  * Ver una factura
405
460
  *
@@ -444,6 +499,17 @@ export class InvoicesResource {
444
499
  xml(id, params, options) {
445
500
  return this.#client.request({ method: "GET", path: `/v1/invoices/${encodeURIComponent(id)}/xml`, query: params, as: "text" }, options);
446
501
  }
502
+ /**
503
+ * Descargar el acuse de cancelación
504
+ *
505
+ * El acuse de cancelación del SAT (XML firmado por el SAT) de una factura cancelada: la prueba de que el SAT la canceló y cuándo. Antes de que el SAT la cancele (status valid o pending), 409 invoice_not_canceled.
506
+ *
507
+ * GET /v1/invoices/{id}/cancellation_receipt
508
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice-cancellation-receipt
509
+ */
510
+ cancellationReceipt(id, params, options) {
511
+ return this.#client.request({ method: "GET", path: `/v1/invoices/${encodeURIComponent(id)}/cancellation_receipt`, query: params, as: "text" }, options);
512
+ }
447
513
  /**
448
514
  * Enviar por correo
449
515
  *
@@ -3167,6 +3233,17 @@ export class WebhookEndpointsResource {
3167
3233
  test(id, params, options) {
3168
3234
  return this.#client.request({ method: "POST", path: `/v1/webhook_endpoints/${encodeURIComponent(id)}/test`, body: params, idempotent: true }, options);
3169
3235
  }
3236
+ /**
3237
+ * Listar entregas
3238
+ *
3239
+ * Qué pasó con cada evento en este webhook, el más reciente primero: una fila por evento con su último intento, cuántos lleva y cuándo va el siguiente reintento. Con succeeded=false ve los que su servidor no recibió, para reenviarlos con POST /v1/events/{id}/resend.
3240
+ *
3241
+ * GET /v1/webhook_endpoints/{id}/deliveries
3242
+ * @see https://fiscalisto.com/docs/api/referencia/webhooks/list-webhook-deliveries
3243
+ */
3244
+ listDeliveries(id, params, options) {
3245
+ return this.#client.list({ path: `/v1/webhook_endpoints/${encodeURIComponent(id)}/deliveries`, query: params }, options);
3246
+ }
3170
3247
  }
3171
3248
  /** Eventos: fiscalisto.events. */
3172
3249
  export class EventsResource {