fiscalisto 0.1.37 → 0.1.39

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.37";
7
+ export declare const VERSION = "0.1.39";
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.37";
6
+ export const VERSION = "0.1.39";
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.
@@ -91,6 +91,8 @@ export declare const ErrorCode: {
91
91
  readonly IssuerCreationLimit: "issuer_creation_limit";
92
92
  /** Ese RFC ya es un emisor de la cuenta en este modo. */
93
93
  readonly IssuerExists: "issuer_exists";
94
+ /** El emisor es una empresa de la app conectada a la cuenta (source empresa): con la API solo se usa su Portal de proveedores. */
95
+ readonly IssuerLinkedEmpresa: "issuer_linked_empresa";
94
96
  /** No existe ese emisor en la cuenta (o es del otro modo). */
95
97
  readonly IssuerMissing: "issuer_missing";
96
98
  /** La llave no puede usar ese emisor. */
@@ -193,6 +195,8 @@ export declare const ErrorCode: {
193
195
  readonly StorePlatformUnavailable: "store_platform_unavailable";
194
196
  /** Los complementos de pago y las notas de crédito no se sustituyen: se cancelan y se emite otro. Un recibo de nómina se sustituye con POST /v1/payroll_receipts/external y replaces. */
195
197
  readonly SubstitutionUnsupported: "substitution_unsupported";
198
+ /** La factura del proveedor no admite eso en su estado (por ejemplo, programar una que no está aprobada, una fecha de pago pasada o marcar pagada una ya pagada), o el SAT la reporta cancelada. El mensaje dice por qué. */
199
+ readonly SupplierInvoiceInvalid: "supplier_invoice_invalid";
196
200
  /** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
197
201
  readonly TestClockAdvancing: "test_clock_advancing";
198
202
  /** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
@@ -92,6 +92,8 @@ export const ErrorCode = {
92
92
  IssuerCreationLimit: "issuer_creation_limit",
93
93
  /** Ese RFC ya es un emisor de la cuenta en este modo. */
94
94
  IssuerExists: "issuer_exists",
95
+ /** El emisor es una empresa de la app conectada a la cuenta (source empresa): con la API solo se usa su Portal de proveedores. */
96
+ IssuerLinkedEmpresa: "issuer_linked_empresa",
95
97
  /** No existe ese emisor en la cuenta (o es del otro modo). */
96
98
  IssuerMissing: "issuer_missing",
97
99
  /** La llave no puede usar ese emisor. */
@@ -194,6 +196,8 @@ export const ErrorCode = {
194
196
  StorePlatformUnavailable: "store_platform_unavailable",
195
197
  /** Los complementos de pago y las notas de crédito no se sustituyen: se cancelan y se emite otro. Un recibo de nómina se sustituye con POST /v1/payroll_receipts/external y replaces. */
196
198
  SubstitutionUnsupported: "substitution_unsupported",
199
+ /** La factura del proveedor no admite eso en su estado (por ejemplo, programar una que no está aprobada, una fecha de pago pasada o marcar pagada una ya pagada), o el SAT la reporta cancelada. El mensaje dice por qué. */
200
+ SupplierInvoiceInvalid: "supplier_invoice_invalid",
197
201
  /** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
198
202
  TestClockAdvancing: "test_clock_advancing",
199
203
  /** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
@@ -70,6 +70,8 @@ export interface Issuer {
70
70
  livemode: boolean;
71
71
  /** Qué tipo de objeto es («invoice», «customer»…). */
72
72
  object: "issuer";
73
+ /** api si lo creó con la API o en Desarrolladores; empresa si es una empresa de la app conectada a su cuenta (Desarrolladores › Emisores › Conectar una empresa): con ella solo se usa su Portal de proveedores, y status siempre es active. */
74
+ source: "api" | "empresa";
73
75
  /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
74
76
  tax_id: string;
75
77
  /** 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.»). */
@@ -3502,6 +3504,145 @@ export interface SalesOrder {
3502
3504
  /** Cuándo se creó. */
3503
3505
  created_at: string | null;
3504
3506
  }
3507
+ /** Un proveedor del Portal de proveedores del emisor: su alta, sus documentos, la cuenta a la que se le paga y su calificación. */
3508
+ export interface PortalSupplier {
3509
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3510
+ id: string;
3511
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
3512
+ livemode: boolean;
3513
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3514
+ object: "portal_supplier";
3515
+ /** El emisor de su cuenta (iss_…) cuyo portal es. */
3516
+ issuer: string;
3517
+ /** El RFC del proveedor. */
3518
+ tax_id: string;
3519
+ /** Su nombre o razón social, o null si aún no lo da. */
3520
+ name: string | null;
3521
+ /** Los correos a los que le escribimos. */
3522
+ emails: string[];
3523
+ /** Su teléfono, o null. */
3524
+ phone: string | null;
3525
+ /** invited (invitado), onboarding (dando su alta), in_review (alta por revisar), approved (puede mandar facturas), rejected o suspended. */
3526
+ status: "invited" | "onboarding" | "in_review" | "approved" | "rejected" | "suspended";
3527
+ /** true si da servicios especializados (REPSE). */
3528
+ repse: boolean;
3529
+ /** Su alta: complete cuando todo lo obligatorio está aprobado y vigente, y cuántos documentos faltan, esperan revisión, vencieron o están por vencer. */
3530
+ documents: {
3531
+ /** true cuando todo lo obligatorio de su alta está aprobado y vigente. */
3532
+ complete: boolean;
3533
+ /** Cuántos documentos obligatorios no ha subido. */
3534
+ missing: number;
3535
+ /** Cuántos esperan revisión. */
3536
+ pending: number;
3537
+ /** Cuántos vencieron. */
3538
+ expired: number;
3539
+ /** Cuántos vencen en los próximos 7 días. */
3540
+ expiring: number;
3541
+ };
3542
+ /** La cuenta a la que se le paga, o null. Una nueva queda pending hasta que se aprueba en la app; mientras, se le paga a previous_clabe. */
3543
+ bank_account: {
3544
+ /** La CLABE de 18 dígitos. */
3545
+ clabe: string;
3546
+ /** El banco, o null. */
3547
+ bank: string | null;
3548
+ /** El titular de la cuenta, o null. */
3549
+ holder: string | null;
3550
+ /** Estado del objeto. */
3551
+ status: "pending" | "approved" | "rejected";
3552
+ /** Mientras una CLABE nueva está pending, la anterior, a la que se le sigue pagando; si no, null. */
3553
+ previous_clabe: string | null;
3554
+ } | null;
3555
+ /** Su calificación de 0 a 100 de los últimos 12 meses (value, null sin datos; level excellent, good, fair o poor) y cada parte: invoices (facturas a la primera), deliveries (entregas a tiempo), prices (precio y cantidad de la orden), documents (documentos al día) y complements (complementos de pago), con good de total casos. */
3556
+ score: {
3557
+ /** Valor de la mercancía (ValorMercancia); obligatorio en transporte aéreo. */
3558
+ value: number | null;
3559
+ /** Nivel educativo (nivelEducativo). */
3560
+ level: "excellent" | "good" | "fair" | "poor" | null;
3561
+ /** Partes del transporte que posee o arrienda (ParteTransporte), c_ParteTransporte. */
3562
+ parts: {
3563
+ /** invoices (facturas a la primera), deliveries (entregas a tiempo), prices (precio y cantidad de la orden), documents (documentos al día) o complements (complementos de pago). */
3564
+ part: "invoices" | "deliveries" | "prices" | "documents" | "complements";
3565
+ /** Valor de la mercancía (ValorMercancia); obligatorio en transporte aéreo. */
3566
+ value: number | null;
3567
+ /** En cuántos de los total casos lo hizo bien. */
3568
+ good: number;
3569
+ /** Total en la moneda del comprobante (Total). */
3570
+ total: number;
3571
+ }[];
3572
+ };
3573
+ /** La última vez que entró a su portal, o null. */
3574
+ last_seen_at: string | null;
3575
+ /** Cuándo se invitó o se registró. */
3576
+ created_at: string | null;
3577
+ /** Cuándo cambió por última vez. */
3578
+ updated_at: string | null;
3579
+ }
3580
+ /** Una factura que un proveedor le mandó al emisor por su Portal de proveedores, con lo que se revisó, su orden de compra, su contrarecibo y sus fechas de pago. */
3581
+ export interface SupplierInvoice {
3582
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3583
+ id: string;
3584
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
3585
+ livemode: boolean;
3586
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3587
+ object: "supplier_invoice";
3588
+ /** El emisor de su cuenta (iss_…) que la recibió. */
3589
+ issuer: string;
3590
+ /** El proveedor (sup_…) que la mandó. */
3591
+ supplier: string;
3592
+ /** El RFC del proveedor. */
3593
+ supplier_tax_id: string;
3594
+ /** El folio fiscal (UUID del timbre). */
3595
+ uuid: string;
3596
+ /** La misma factura en sus facturas recibidas (sat_…), para su XML y su PDF, o null. */
3597
+ sat_invoice: string | null;
3598
+ /** Su serie, o null. */
3599
+ series: string | null;
3600
+ /** Su folio, o null. */
3601
+ folio: string | null;
3602
+ /** income (factura de ingreso) o credit_note (nota de crédito). */
3603
+ type: "income" | "credit_note";
3604
+ /** La fecha de la factura. */
3605
+ date: string;
3606
+ /** La moneda. */
3607
+ currency: string;
3608
+ /** El total de la factura. */
3609
+ total: number;
3610
+ /** Lo que se le paga: el total sin las diferencias con su orden ni el descuento de pronto pago aceptado. */
3611
+ payable: number;
3612
+ /** PUE o PPD. */
3613
+ payment_method: string | null;
3614
+ /** received (por revisar), approved, scheduled (con fecha de pago), paid o rejected. */
3615
+ status: "received" | "approved" | "scheduled" | "paid" | "rejected";
3616
+ /** La orden de compra que factura (OC-12), o null. */
3617
+ purchase_order: string | null;
3618
+ /** true si cuadró con su orden, false si tuvo diferencias, null sin orden. */
3619
+ matches_purchase_order: boolean | null;
3620
+ /** El folio de su contrarecibo, o null. */
3621
+ contrarecibo: string | null;
3622
+ /** El día en que vence por sus fechas de pago, o null. */
3623
+ due_on: string | null;
3624
+ /** El día programado para pagarla, o null. */
3625
+ scheduled_on: string | null;
3626
+ /** El día en que se pagó, o null. */
3627
+ paid_on: string | null;
3628
+ /** Lo que se pagó, o null. */
3629
+ paid_amount: number | null;
3630
+ /** La referencia del pago, o null. */
3631
+ payment_reference: string | null;
3632
+ /** Por qué se rechazó, o null. */
3633
+ rejection_reason: string | null;
3634
+ /** Lo que se revisó y quedó como aviso (code y message), para que su equipo lo vea. */
3635
+ warnings: {
3636
+ /** 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. */
3637
+ code: string;
3638
+ /** Qué pasó y cómo corregirlo, para una persona. */
3639
+ message: string;
3640
+ }[];
3641
+ /** Cuándo llegó. */
3642
+ received_at: string | null;
3643
+ /** Cuándo se aprobó, o null. */
3644
+ approved_at: string | null;
3645
+ }
3505
3646
  /** Una entrega del pedido, con su remisión (REM-1): lo que salió del almacén. */
3506
3647
  export interface SalesOrderDelivery {
3507
3648
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3848,14 +3989,14 @@ export interface WebhookTest {
3848
3989
  };
3849
3990
  }
3850
3991
  /** Lo que puede pasar: el tipo de cada evento. */
3851
- 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" | "issuer.ready" | "balance.low" | "test_clock.ready";
3992
+ 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" | "test_clock.ready";
3852
3993
  /** Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks). */
3853
3994
  export interface EventBase<T extends EventType = EventType, O = unknown> {
3854
3995
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
3855
3996
  id: string;
3856
3997
  /** Qué tipo de objeto es («invoice», «customer»…). */
3857
3998
  object: "event";
3858
- /** 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, issuer.ready, balance.low o test_clock.ready. */
3999
+ /** 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 o test_clock.ready. */
3859
4000
  type: T;
3860
4001
  /** Versión de la API con que se armó el objeto. */
3861
4002
  api_version: string;
@@ -3869,7 +4010,7 @@ export interface EventBase<T extends EventType = EventType, O = unknown> {
3869
4010
  };
3870
4011
  }
3871
4012
  /** Un evento: según su type, data.object es la factura, la constancia o el lote. */
3872
- 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<"issuer.ready", Issuer> | EventBase<"balance.low", Balance> | EventBase<"test_clock.ready", TestClock>;
4013
+ 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<"test_clock.ready", TestClock>;
3873
4014
  /** Confirmación de que se borró. */
3874
4015
  export interface Deleted {
3875
4016
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -4231,6 +4372,26 @@ export interface SatRetentionList {
4231
4372
  /** La ruta de esta lista. */
4232
4373
  url: string;
4233
4374
  }
4375
+ export interface PortalSupplierList {
4376
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4377
+ object: "list";
4378
+ /** Los objetos de esta página. */
4379
+ data: PortalSupplier[];
4380
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4381
+ has_more: boolean;
4382
+ /** La ruta de esta lista. */
4383
+ url: string;
4384
+ }
4385
+ export interface SupplierInvoiceList {
4386
+ /** Qué tipo de objeto es («invoice», «customer»…). */
4387
+ object: "list";
4388
+ /** Los objetos de esta página. */
4389
+ data: SupplierInvoice[];
4390
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
4391
+ has_more: boolean;
4392
+ /** La ruta de esta lista. */
4393
+ url: string;
4394
+ }
4234
4395
  export interface SatDeclarationList {
4235
4396
  /** Qué tipo de objeto es («invoice», «customer»…). */
4236
4397
  object: "list";
@@ -7277,6 +7438,44 @@ export interface ListSatRetentionsParams {
7277
7438
  /** Solo las que cubren este mes (1 a 12): una anual de enero a diciembre cubre todos. */
7278
7439
  month?: number;
7279
7440
  }
7441
+ /** Los parámetros de GET /v1/portal_suppliers. */
7442
+ export interface ListPortalSuppliersParams {
7443
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
7444
+ limit?: number;
7445
+ /** El id del último de la página anterior, para la siguiente. */
7446
+ starting_after?: string;
7447
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7448
+ issuer?: string;
7449
+ /** Solo los que estén en este estado. */
7450
+ status?: "invited" | "onboarding" | "in_review" | "approved" | "rejected" | "suspended";
7451
+ /** Solo el de este RFC. */
7452
+ tax_id?: string;
7453
+ }
7454
+ /** Los parámetros de GET /v1/supplier_invoices. */
7455
+ export interface ListSupplierInvoicesParams {
7456
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
7457
+ limit?: number;
7458
+ /** El id del último de la página anterior, para la siguiente. */
7459
+ starting_after?: string;
7460
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
7461
+ issuer?: string;
7462
+ /** Solo las que estén en este estado. */
7463
+ status?: "received" | "approved" | "scheduled" | "paid" | "rejected";
7464
+ /** Solo las de este proveedor (sup_…). */
7465
+ supplier?: string;
7466
+ /** Solo las que llegaron desde este día (AAAA-MM-DD). */
7467
+ received_since?: string;
7468
+ }
7469
+ export interface ScheduleSupplierInvoiceParams {
7470
+ /** El día en que la pagará (AAAA-MM-DD, hoy o después). El proveedor lo ve. */
7471
+ pay_on: string;
7472
+ }
7473
+ export interface MarkSupplierInvoicePaidParams {
7474
+ /** El día en que la pagó (AAAA-MM-DD, hoy o antes). */
7475
+ paid_on: string;
7476
+ /** La referencia del pago (la de la transferencia o del ERP), o null. */
7477
+ reference?: string | null;
7478
+ }
7280
7479
  export interface RefreshSatDeclarationsParams {
7281
7480
  /** El emisor (iss_…). Por omisión, su único emisor. */
7282
7481
  issuer?: string;
@@ -8345,7 +8544,7 @@ export interface RollWebhookSecretParams {
8345
8544
  }
8346
8545
  export interface TestWebhookEndpointParams {
8347
8546
  /** El evento a mandar. Por omisión invoice.stamped. */
8348
- 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" | "issuer.ready" | "balance.low" | "test_clock.ready";
8547
+ 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" | "test_clock.ready";
8349
8548
  }
8350
8549
  /** Los parámetros de GET /v1/events. */
8351
8550
  export interface ListEventsParams {
@@ -8354,7 +8553,7 @@ export interface ListEventsParams {
8354
8553
  /** El id del último de la página anterior, para la siguiente. */
8355
8554
  starting_after?: string;
8356
8555
  /** Solo de este tipo (invoice.stamped), o todos los de un recurso con un comodín (invoice.*). */
8357
- 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" | "issuer.ready" | "balance.low" | "test_clock.ready" | "invoice.*" | "invoice_batch.*" | "payroll_batch.*" | "recurring_invoice.*" | "quote.*" | "sales_order.*" | "ticket.*" | "retention.*" | "customer_data_request.*" | "sat_download.*" | "sat_declaration.*" | "issuer.*" | "balance.*" | "test_clock.*";
8556
+ 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" | "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.*" | "test_clock.*";
8358
8557
  /** Solo los de este objeto (inv_…, ret_…, bat_…). */
8359
8558
  object?: string;
8360
8559
  /** false: los que algún webhook no recibió (su último intento falló). true: los que recibieron todos los webhooks a los que se mandaron. */
@@ -10191,6 +10390,70 @@ export declare class SatRetentionsResource {
10191
10390
  */
10192
10391
  pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
10193
10392
  }
10393
+ /** Portal de proveedores: fiscalisto.portalSuppliers. */
10394
+ export declare class PortalSuppliersResource {
10395
+ #private;
10396
+ constructor(client: Client);
10397
+ /**
10398
+ * Listar proveedores del portal
10399
+ *
10400
+ * Los proveedores invitados o registrados en el Portal de proveedores del emisor, los más recientes primero: su alta, sus documentos, la cuenta a la que se le paga y su calificación.
10401
+ *
10402
+ * GET /v1/portal_suppliers
10403
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-portal-suppliers
10404
+ */
10405
+ list(params?: ListPortalSuppliersParams, options?: RequestOptions): List<PortalSupplier>;
10406
+ /**
10407
+ * Ver un proveedor del portal
10408
+ *
10409
+ * Su alta, sus documentos, su cuenta bancaria y su calificación por partes.
10410
+ *
10411
+ * GET /v1/portal_suppliers/{id}
10412
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-portal-supplier
10413
+ */
10414
+ get(id: string, options?: RequestOptions): Promise<PortalSupplier>;
10415
+ }
10416
+ /** Portal de proveedores: fiscalisto.supplierInvoices. */
10417
+ export declare class SupplierInvoicesResource {
10418
+ #private;
10419
+ constructor(client: Client);
10420
+ /**
10421
+ * Listar facturas de proveedores
10422
+ *
10423
+ * Las facturas que mandaron sus proveedores por el portal, las más recientes primero. Para llevar a su ERP lo aprobado: status=approved, o escuche supplier_invoice.approved.
10424
+ *
10425
+ * GET /v1/supplier_invoices
10426
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-supplier-invoices
10427
+ */
10428
+ list(params?: ListSupplierInvoicesParams, options?: RequestOptions): List<SupplierInvoice>;
10429
+ /**
10430
+ * Ver una factura de proveedor
10431
+ *
10432
+ * Con su estado, su orden de compra, su contrarecibo y sus fechas de pago. Su XML y su PDF: GET /v1/sat_invoices/{sat_invoice}/xml y /pdf.
10433
+ *
10434
+ * GET /v1/supplier_invoices/{id}
10435
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-supplier-invoice
10436
+ */
10437
+ get(id: string, options?: RequestOptions): Promise<SupplierInvoice>;
10438
+ /**
10439
+ * Programar el pago de una factura de proveedor
10440
+ *
10441
+ * El día en que la pagará, como «Programar pago» en la app: el proveedor lo ve en su portal y llega supplier_invoice.scheduled. Solo una aprobada o ya programada; si el SAT la reporta cancelada, 400 supplier_invoice_invalid.
10442
+ *
10443
+ * POST /v1/supplier_invoices/{id}/schedule
10444
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/schedule-supplier-invoice
10445
+ */
10446
+ schedule(id: string, params: ScheduleSupplierInvoiceParams, options?: RequestOptions): Promise<SupplierInvoice>;
10447
+ /**
10448
+ * Marcar pagada una factura de proveedor
10449
+ *
10450
+ * El pago que hizo su ERP o su banco, como «Marcar pagada» en la app: el proveedor lo ve, y si es PPD le pedimos su complemento de pago. Llega supplier_invoice.paid.
10451
+ *
10452
+ * POST /v1/supplier_invoices/{id}/mark_paid
10453
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/mark-supplier-invoice-paid
10454
+ */
10455
+ markPaid(id: string, params: MarkSupplierInvoicePaidParams, options?: RequestOptions): Promise<SupplierInvoice>;
10456
+ }
10194
10457
  /** Declaraciones del SAT: fiscalisto.satDeclarations. */
10195
10458
  export declare class SatDeclarationsResource {
10196
10459
  #private;
@@ -10903,6 +11166,8 @@ export declare class FiscalistoApi extends Core {
10903
11166
  readonly satDownloads: SatDownloadsResource;
10904
11167
  readonly satInvoices: SatInvoicesResource;
10905
11168
  readonly satRetentions: SatRetentionsResource;
11169
+ readonly portalSuppliers: PortalSuppliersResource;
11170
+ readonly supplierInvoices: SupplierInvoicesResource;
10906
11171
  readonly satDeclarations: SatDeclarationsResource;
10907
11172
  readonly tickets: TicketsResource;
10908
11173
  readonly accounting: AccountingResource;
package/dist/generated.js CHANGED
@@ -2277,6 +2277,86 @@ export class SatRetentionsResource {
2277
2277
  return this.#client.request({ method: "GET", path: `/v1/sat_retentions/${encodeURIComponent(id)}/pdf`, as: "bytes" }, options);
2278
2278
  }
2279
2279
  }
2280
+ /** Portal de proveedores: fiscalisto.portalSuppliers. */
2281
+ export class PortalSuppliersResource {
2282
+ #client;
2283
+ constructor(client) {
2284
+ this.#client = client;
2285
+ }
2286
+ /**
2287
+ * Listar proveedores del portal
2288
+ *
2289
+ * Los proveedores invitados o registrados en el Portal de proveedores del emisor, los más recientes primero: su alta, sus documentos, la cuenta a la que se le paga y su calificación.
2290
+ *
2291
+ * GET /v1/portal_suppliers
2292
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-portal-suppliers
2293
+ */
2294
+ list(params, options) {
2295
+ return this.#client.list({ path: "/v1/portal_suppliers", query: params }, options);
2296
+ }
2297
+ /**
2298
+ * Ver un proveedor del portal
2299
+ *
2300
+ * Su alta, sus documentos, su cuenta bancaria y su calificación por partes.
2301
+ *
2302
+ * GET /v1/portal_suppliers/{id}
2303
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-portal-supplier
2304
+ */
2305
+ get(id, options) {
2306
+ return this.#client.request({ method: "GET", path: `/v1/portal_suppliers/${encodeURIComponent(id)}` }, options);
2307
+ }
2308
+ }
2309
+ /** Portal de proveedores: fiscalisto.supplierInvoices. */
2310
+ export class SupplierInvoicesResource {
2311
+ #client;
2312
+ constructor(client) {
2313
+ this.#client = client;
2314
+ }
2315
+ /**
2316
+ * Listar facturas de proveedores
2317
+ *
2318
+ * Las facturas que mandaron sus proveedores por el portal, las más recientes primero. Para llevar a su ERP lo aprobado: status=approved, o escuche supplier_invoice.approved.
2319
+ *
2320
+ * GET /v1/supplier_invoices
2321
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-supplier-invoices
2322
+ */
2323
+ list(params, options) {
2324
+ return this.#client.list({ path: "/v1/supplier_invoices", query: params }, options);
2325
+ }
2326
+ /**
2327
+ * Ver una factura de proveedor
2328
+ *
2329
+ * Con su estado, su orden de compra, su contrarecibo y sus fechas de pago. Su XML y su PDF: GET /v1/sat_invoices/{sat_invoice}/xml y /pdf.
2330
+ *
2331
+ * GET /v1/supplier_invoices/{id}
2332
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-supplier-invoice
2333
+ */
2334
+ get(id, options) {
2335
+ return this.#client.request({ method: "GET", path: `/v1/supplier_invoices/${encodeURIComponent(id)}` }, options);
2336
+ }
2337
+ /**
2338
+ * Programar el pago de una factura de proveedor
2339
+ *
2340
+ * El día en que la pagará, como «Programar pago» en la app: el proveedor lo ve en su portal y llega supplier_invoice.scheduled. Solo una aprobada o ya programada; si el SAT la reporta cancelada, 400 supplier_invoice_invalid.
2341
+ *
2342
+ * POST /v1/supplier_invoices/{id}/schedule
2343
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/schedule-supplier-invoice
2344
+ */
2345
+ schedule(id, params, options) {
2346
+ return this.#client.request({ method: "POST", path: `/v1/supplier_invoices/${encodeURIComponent(id)}/schedule`, body: params, idempotent: true }, options);
2347
+ }
2348
+ /**
2349
+ * Marcar pagada una factura de proveedor
2350
+ *
2351
+ * El pago que hizo su ERP o su banco, como «Marcar pagada» en la app: el proveedor lo ve, y si es PPD le pedimos su complemento de pago. Llega supplier_invoice.paid.
2352
+ *
2353
+ * POST /v1/supplier_invoices/{id}/mark_paid
2354
+ * @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/mark-supplier-invoice-paid
2355
+ */
2356
+ markPaid(id, params, options) {
2357
+ return this.#client.request({ method: "POST", path: `/v1/supplier_invoices/${encodeURIComponent(id)}/mark_paid`, body: params, idempotent: true }, options);
2358
+ }
2359
+ }
2280
2360
  /** Declaraciones del SAT: fiscalisto.satDeclarations. */
2281
2361
  export class SatDeclarationsResource {
2282
2362
  #client;
@@ -3145,6 +3225,8 @@ export class FiscalistoApi extends Core {
3145
3225
  satDownloads = new SatDownloadsResource(this);
3146
3226
  satInvoices = new SatInvoicesResource(this);
3147
3227
  satRetentions = new SatRetentionsResource(this);
3228
+ portalSuppliers = new PortalSuppliersResource(this);
3229
+ supplierInvoices = new SupplierInvoicesResource(this);
3148
3230
  satDeclarations = new SatDeclarationsResource(this);
3149
3231
  tickets = new TicketsResource(this);
3150
3232
  accounting = new AccountingResource(this);