fiscalisto 0.1.37 → 0.1.38
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 +1 -1
- package/dist/core.js +1 -1
- package/dist/error-codes.d.ts +2 -0
- package/dist/error-codes.js +2 -0
- package/dist/generated.d.ts +268 -5
- package/dist/generated.js +82 -0
- package/dist/mock-routes.gen.js +1 -1
- package/package.json +1 -1
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.
|
|
7
|
+
export declare const VERSION = "0.1.38";
|
|
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.
|
|
6
|
+
export const VERSION = "0.1.38";
|
|
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.
|
package/dist/error-codes.d.ts
CHANGED
|
@@ -193,6 +193,8 @@ export declare const ErrorCode: {
|
|
|
193
193
|
readonly StorePlatformUnavailable: "store_platform_unavailable";
|
|
194
194
|
/** 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
195
|
readonly SubstitutionUnsupported: "substitution_unsupported";
|
|
196
|
+
/** 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é. */
|
|
197
|
+
readonly SupplierInvoiceInvalid: "supplier_invoice_invalid";
|
|
196
198
|
/** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
|
|
197
199
|
readonly TestClockAdvancing: "test_clock_advancing";
|
|
198
200
|
/** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
|
package/dist/error-codes.js
CHANGED
|
@@ -194,6 +194,8 @@ export const ErrorCode = {
|
|
|
194
194
|
StorePlatformUnavailable: "store_platform_unavailable",
|
|
195
195
|
/** 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
196
|
SubstitutionUnsupported: "substitution_unsupported",
|
|
197
|
+
/** 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é. */
|
|
198
|
+
SupplierInvoiceInvalid: "supplier_invoice_invalid",
|
|
197
199
|
/** El reloj se está adelantando en otra solicitud (409, con Retry-After). Espere a test_clock.ready y repita. */
|
|
198
200
|
TestClockAdvancing: "test_clock_advancing",
|
|
199
201
|
/** El emisor ya tiene un reloj de prueba: adelántelo, o bórrelo para volver a la hora real. */
|
package/dist/generated.d.ts
CHANGED
|
@@ -3502,6 +3502,145 @@ export interface SalesOrder {
|
|
|
3502
3502
|
/** Cuándo se creó. */
|
|
3503
3503
|
created_at: string | null;
|
|
3504
3504
|
}
|
|
3505
|
+
/** Un proveedor del Portal de proveedores del emisor: su alta, sus documentos, la cuenta a la que se le paga y su calificación. */
|
|
3506
|
+
export interface PortalSupplier {
|
|
3507
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
3508
|
+
id: string;
|
|
3509
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
3510
|
+
livemode: boolean;
|
|
3511
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
3512
|
+
object: "portal_supplier";
|
|
3513
|
+
/** El emisor de su cuenta (iss_…) cuyo portal es. */
|
|
3514
|
+
issuer: string;
|
|
3515
|
+
/** El RFC del proveedor. */
|
|
3516
|
+
tax_id: string;
|
|
3517
|
+
/** Su nombre o razón social, o null si aún no lo da. */
|
|
3518
|
+
name: string | null;
|
|
3519
|
+
/** Los correos a los que le escribimos. */
|
|
3520
|
+
emails: string[];
|
|
3521
|
+
/** Su teléfono, o null. */
|
|
3522
|
+
phone: string | null;
|
|
3523
|
+
/** invited (invitado), onboarding (dando su alta), in_review (alta por revisar), approved (puede mandar facturas), rejected o suspended. */
|
|
3524
|
+
status: "invited" | "onboarding" | "in_review" | "approved" | "rejected" | "suspended";
|
|
3525
|
+
/** true si da servicios especializados (REPSE). */
|
|
3526
|
+
repse: boolean;
|
|
3527
|
+
/** 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. */
|
|
3528
|
+
documents: {
|
|
3529
|
+
/** true cuando todo lo obligatorio de su alta está aprobado y vigente. */
|
|
3530
|
+
complete: boolean;
|
|
3531
|
+
/** Cuántos documentos obligatorios no ha subido. */
|
|
3532
|
+
missing: number;
|
|
3533
|
+
/** Cuántos esperan revisión. */
|
|
3534
|
+
pending: number;
|
|
3535
|
+
/** Cuántos vencieron. */
|
|
3536
|
+
expired: number;
|
|
3537
|
+
/** Cuántos vencen en los próximos 7 días. */
|
|
3538
|
+
expiring: number;
|
|
3539
|
+
};
|
|
3540
|
+
/** 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. */
|
|
3541
|
+
bank_account: {
|
|
3542
|
+
/** La CLABE de 18 dígitos. */
|
|
3543
|
+
clabe: string;
|
|
3544
|
+
/** El banco, o null. */
|
|
3545
|
+
bank: string | null;
|
|
3546
|
+
/** El titular de la cuenta, o null. */
|
|
3547
|
+
holder: string | null;
|
|
3548
|
+
/** Estado del objeto. */
|
|
3549
|
+
status: "pending" | "approved" | "rejected";
|
|
3550
|
+
/** Mientras una CLABE nueva está pending, la anterior, a la que se le sigue pagando; si no, null. */
|
|
3551
|
+
previous_clabe: string | null;
|
|
3552
|
+
} | null;
|
|
3553
|
+
/** 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. */
|
|
3554
|
+
score: {
|
|
3555
|
+
/** Valor de la mercancía (ValorMercancia); obligatorio en transporte aéreo. */
|
|
3556
|
+
value: number | null;
|
|
3557
|
+
/** Nivel educativo (nivelEducativo). */
|
|
3558
|
+
level: "excellent" | "good" | "fair" | "poor" | null;
|
|
3559
|
+
/** Partes del transporte que posee o arrienda (ParteTransporte), c_ParteTransporte. */
|
|
3560
|
+
parts: {
|
|
3561
|
+
/** 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). */
|
|
3562
|
+
part: "invoices" | "deliveries" | "prices" | "documents" | "complements";
|
|
3563
|
+
/** Valor de la mercancía (ValorMercancia); obligatorio en transporte aéreo. */
|
|
3564
|
+
value: number | null;
|
|
3565
|
+
/** En cuántos de los total casos lo hizo bien. */
|
|
3566
|
+
good: number;
|
|
3567
|
+
/** Total en la moneda del comprobante (Total). */
|
|
3568
|
+
total: number;
|
|
3569
|
+
}[];
|
|
3570
|
+
};
|
|
3571
|
+
/** La última vez que entró a su portal, o null. */
|
|
3572
|
+
last_seen_at: string | null;
|
|
3573
|
+
/** Cuándo se invitó o se registró. */
|
|
3574
|
+
created_at: string | null;
|
|
3575
|
+
/** Cuándo cambió por última vez. */
|
|
3576
|
+
updated_at: string | null;
|
|
3577
|
+
}
|
|
3578
|
+
/** 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. */
|
|
3579
|
+
export interface SupplierInvoice {
|
|
3580
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
3581
|
+
id: string;
|
|
3582
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
3583
|
+
livemode: boolean;
|
|
3584
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
3585
|
+
object: "supplier_invoice";
|
|
3586
|
+
/** El emisor de su cuenta (iss_…) que la recibió. */
|
|
3587
|
+
issuer: string;
|
|
3588
|
+
/** El proveedor (sup_…) que la mandó. */
|
|
3589
|
+
supplier: string;
|
|
3590
|
+
/** El RFC del proveedor. */
|
|
3591
|
+
supplier_tax_id: string;
|
|
3592
|
+
/** El folio fiscal (UUID del timbre). */
|
|
3593
|
+
uuid: string;
|
|
3594
|
+
/** La misma factura en sus facturas recibidas (sat_…), para su XML y su PDF, o null. */
|
|
3595
|
+
sat_invoice: string | null;
|
|
3596
|
+
/** Su serie, o null. */
|
|
3597
|
+
series: string | null;
|
|
3598
|
+
/** Su folio, o null. */
|
|
3599
|
+
folio: string | null;
|
|
3600
|
+
/** income (factura de ingreso) o credit_note (nota de crédito). */
|
|
3601
|
+
type: "income" | "credit_note";
|
|
3602
|
+
/** La fecha de la factura. */
|
|
3603
|
+
date: string;
|
|
3604
|
+
/** La moneda. */
|
|
3605
|
+
currency: string;
|
|
3606
|
+
/** El total de la factura. */
|
|
3607
|
+
total: number;
|
|
3608
|
+
/** Lo que se le paga: el total sin las diferencias con su orden ni el descuento de pronto pago aceptado. */
|
|
3609
|
+
payable: number;
|
|
3610
|
+
/** PUE o PPD. */
|
|
3611
|
+
payment_method: string | null;
|
|
3612
|
+
/** received (por revisar), approved, scheduled (con fecha de pago), paid o rejected. */
|
|
3613
|
+
status: "received" | "approved" | "scheduled" | "paid" | "rejected";
|
|
3614
|
+
/** La orden de compra que factura (OC-12), o null. */
|
|
3615
|
+
purchase_order: string | null;
|
|
3616
|
+
/** true si cuadró con su orden, false si tuvo diferencias, null sin orden. */
|
|
3617
|
+
matches_purchase_order: boolean | null;
|
|
3618
|
+
/** El folio de su contrarecibo, o null. */
|
|
3619
|
+
contrarecibo: string | null;
|
|
3620
|
+
/** El día en que vence por sus fechas de pago, o null. */
|
|
3621
|
+
due_on: string | null;
|
|
3622
|
+
/** El día programado para pagarla, o null. */
|
|
3623
|
+
scheduled_on: string | null;
|
|
3624
|
+
/** El día en que se pagó, o null. */
|
|
3625
|
+
paid_on: string | null;
|
|
3626
|
+
/** Lo que se pagó, o null. */
|
|
3627
|
+
paid_amount: number | null;
|
|
3628
|
+
/** La referencia del pago, o null. */
|
|
3629
|
+
payment_reference: string | null;
|
|
3630
|
+
/** Por qué se rechazó, o null. */
|
|
3631
|
+
rejection_reason: string | null;
|
|
3632
|
+
/** Lo que se revisó y quedó como aviso (code y message), para que su equipo lo vea. */
|
|
3633
|
+
warnings: {
|
|
3634
|
+
/** 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. */
|
|
3635
|
+
code: string;
|
|
3636
|
+
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
3637
|
+
message: string;
|
|
3638
|
+
}[];
|
|
3639
|
+
/** Cuándo llegó. */
|
|
3640
|
+
received_at: string | null;
|
|
3641
|
+
/** Cuándo se aprobó, o null. */
|
|
3642
|
+
approved_at: string | null;
|
|
3643
|
+
}
|
|
3505
3644
|
/** Una entrega del pedido, con su remisión (REM-1): lo que salió del almacén. */
|
|
3506
3645
|
export interface SalesOrderDelivery {
|
|
3507
3646
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
@@ -3848,14 +3987,14 @@ export interface WebhookTest {
|
|
|
3848
3987
|
};
|
|
3849
3988
|
}
|
|
3850
3989
|
/** 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";
|
|
3990
|
+
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
3991
|
/** Algo que pasó en su cuenta: el objeto completo como quedó. Se manda a sus webhooks firmado (Standard Webhooks). */
|
|
3853
3992
|
export interface EventBase<T extends EventType = EventType, O = unknown> {
|
|
3854
3993
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
3855
3994
|
id: string;
|
|
3856
3995
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
3857
3996
|
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. */
|
|
3997
|
+
/** 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
3998
|
type: T;
|
|
3860
3999
|
/** Versión de la API con que se armó el objeto. */
|
|
3861
4000
|
api_version: string;
|
|
@@ -3869,7 +4008,7 @@ export interface EventBase<T extends EventType = EventType, O = unknown> {
|
|
|
3869
4008
|
};
|
|
3870
4009
|
}
|
|
3871
4010
|
/** 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>;
|
|
4011
|
+
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
4012
|
/** Confirmación de que se borró. */
|
|
3874
4013
|
export interface Deleted {
|
|
3875
4014
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
@@ -4231,6 +4370,26 @@ export interface SatRetentionList {
|
|
|
4231
4370
|
/** La ruta de esta lista. */
|
|
4232
4371
|
url: string;
|
|
4233
4372
|
}
|
|
4373
|
+
export interface PortalSupplierList {
|
|
4374
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4375
|
+
object: "list";
|
|
4376
|
+
/** Los objetos de esta página. */
|
|
4377
|
+
data: PortalSupplier[];
|
|
4378
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
4379
|
+
has_more: boolean;
|
|
4380
|
+
/** La ruta de esta lista. */
|
|
4381
|
+
url: string;
|
|
4382
|
+
}
|
|
4383
|
+
export interface SupplierInvoiceList {
|
|
4384
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4385
|
+
object: "list";
|
|
4386
|
+
/** Los objetos de esta página. */
|
|
4387
|
+
data: SupplierInvoice[];
|
|
4388
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
4389
|
+
has_more: boolean;
|
|
4390
|
+
/** La ruta de esta lista. */
|
|
4391
|
+
url: string;
|
|
4392
|
+
}
|
|
4234
4393
|
export interface SatDeclarationList {
|
|
4235
4394
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4236
4395
|
object: "list";
|
|
@@ -7277,6 +7436,44 @@ export interface ListSatRetentionsParams {
|
|
|
7277
7436
|
/** Solo las que cubren este mes (1 a 12): una anual de enero a diciembre cubre todos. */
|
|
7278
7437
|
month?: number;
|
|
7279
7438
|
}
|
|
7439
|
+
/** Los parámetros de GET /v1/portal_suppliers. */
|
|
7440
|
+
export interface ListPortalSuppliersParams {
|
|
7441
|
+
/** Cuántos por página, de 1 a 100. Por omisión 10. */
|
|
7442
|
+
limit?: number;
|
|
7443
|
+
/** El id del último de la página anterior, para la siguiente. */
|
|
7444
|
+
starting_after?: string;
|
|
7445
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
7446
|
+
issuer?: string;
|
|
7447
|
+
/** Solo los que estén en este estado. */
|
|
7448
|
+
status?: "invited" | "onboarding" | "in_review" | "approved" | "rejected" | "suspended";
|
|
7449
|
+
/** Solo el de este RFC. */
|
|
7450
|
+
tax_id?: string;
|
|
7451
|
+
}
|
|
7452
|
+
/** Los parámetros de GET /v1/supplier_invoices. */
|
|
7453
|
+
export interface ListSupplierInvoicesParams {
|
|
7454
|
+
/** Cuántos por página, de 1 a 100. Por omisión 10. */
|
|
7455
|
+
limit?: number;
|
|
7456
|
+
/** El id del último de la página anterior, para la siguiente. */
|
|
7457
|
+
starting_after?: string;
|
|
7458
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
7459
|
+
issuer?: string;
|
|
7460
|
+
/** Solo las que estén en este estado. */
|
|
7461
|
+
status?: "received" | "approved" | "scheduled" | "paid" | "rejected";
|
|
7462
|
+
/** Solo las de este proveedor (sup_…). */
|
|
7463
|
+
supplier?: string;
|
|
7464
|
+
/** Solo las que llegaron desde este día (AAAA-MM-DD). */
|
|
7465
|
+
received_since?: string;
|
|
7466
|
+
}
|
|
7467
|
+
export interface ScheduleSupplierInvoiceParams {
|
|
7468
|
+
/** El día en que la pagará (AAAA-MM-DD, hoy o después). El proveedor lo ve. */
|
|
7469
|
+
pay_on: string;
|
|
7470
|
+
}
|
|
7471
|
+
export interface MarkSupplierInvoicePaidParams {
|
|
7472
|
+
/** El día en que la pagó (AAAA-MM-DD, hoy o antes). */
|
|
7473
|
+
paid_on: string;
|
|
7474
|
+
/** La referencia del pago (la de la transferencia o del ERP), o null. */
|
|
7475
|
+
reference?: string | null;
|
|
7476
|
+
}
|
|
7280
7477
|
export interface RefreshSatDeclarationsParams {
|
|
7281
7478
|
/** El emisor (iss_…). Por omisión, su único emisor. */
|
|
7282
7479
|
issuer?: string;
|
|
@@ -8345,7 +8542,7 @@ export interface RollWebhookSecretParams {
|
|
|
8345
8542
|
}
|
|
8346
8543
|
export interface TestWebhookEndpointParams {
|
|
8347
8544
|
/** 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";
|
|
8545
|
+
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
8546
|
}
|
|
8350
8547
|
/** Los parámetros de GET /v1/events. */
|
|
8351
8548
|
export interface ListEventsParams {
|
|
@@ -8354,7 +8551,7 @@ export interface ListEventsParams {
|
|
|
8354
8551
|
/** El id del último de la página anterior, para la siguiente. */
|
|
8355
8552
|
starting_after?: string;
|
|
8356
8553
|
/** 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.*";
|
|
8554
|
+
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
8555
|
/** Solo los de este objeto (inv_…, ret_…, bat_…). */
|
|
8359
8556
|
object?: string;
|
|
8360
8557
|
/** 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 +10388,70 @@ export declare class SatRetentionsResource {
|
|
|
10191
10388
|
*/
|
|
10192
10389
|
pdf(id: string, options?: RequestOptions): Promise<Uint8Array>;
|
|
10193
10390
|
}
|
|
10391
|
+
/** Portal de proveedores: fiscalisto.portalSuppliers. */
|
|
10392
|
+
export declare class PortalSuppliersResource {
|
|
10393
|
+
#private;
|
|
10394
|
+
constructor(client: Client);
|
|
10395
|
+
/**
|
|
10396
|
+
* Listar proveedores del portal
|
|
10397
|
+
*
|
|
10398
|
+
* 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.
|
|
10399
|
+
*
|
|
10400
|
+
* GET /v1/portal_suppliers
|
|
10401
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-portal-suppliers
|
|
10402
|
+
*/
|
|
10403
|
+
list(params?: ListPortalSuppliersParams, options?: RequestOptions): List<PortalSupplier>;
|
|
10404
|
+
/**
|
|
10405
|
+
* Ver un proveedor del portal
|
|
10406
|
+
*
|
|
10407
|
+
* Su alta, sus documentos, su cuenta bancaria y su calificación por partes.
|
|
10408
|
+
*
|
|
10409
|
+
* GET /v1/portal_suppliers/{id}
|
|
10410
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-portal-supplier
|
|
10411
|
+
*/
|
|
10412
|
+
get(id: string, options?: RequestOptions): Promise<PortalSupplier>;
|
|
10413
|
+
}
|
|
10414
|
+
/** Portal de proveedores: fiscalisto.supplierInvoices. */
|
|
10415
|
+
export declare class SupplierInvoicesResource {
|
|
10416
|
+
#private;
|
|
10417
|
+
constructor(client: Client);
|
|
10418
|
+
/**
|
|
10419
|
+
* Listar facturas de proveedores
|
|
10420
|
+
*
|
|
10421
|
+
* 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.
|
|
10422
|
+
*
|
|
10423
|
+
* GET /v1/supplier_invoices
|
|
10424
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/list-supplier-invoices
|
|
10425
|
+
*/
|
|
10426
|
+
list(params?: ListSupplierInvoicesParams, options?: RequestOptions): List<SupplierInvoice>;
|
|
10427
|
+
/**
|
|
10428
|
+
* Ver una factura de proveedor
|
|
10429
|
+
*
|
|
10430
|
+
* 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.
|
|
10431
|
+
*
|
|
10432
|
+
* GET /v1/supplier_invoices/{id}
|
|
10433
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/get-supplier-invoice
|
|
10434
|
+
*/
|
|
10435
|
+
get(id: string, options?: RequestOptions): Promise<SupplierInvoice>;
|
|
10436
|
+
/**
|
|
10437
|
+
* Programar el pago de una factura de proveedor
|
|
10438
|
+
*
|
|
10439
|
+
* 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.
|
|
10440
|
+
*
|
|
10441
|
+
* POST /v1/supplier_invoices/{id}/schedule
|
|
10442
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/schedule-supplier-invoice
|
|
10443
|
+
*/
|
|
10444
|
+
schedule(id: string, params: ScheduleSupplierInvoiceParams, options?: RequestOptions): Promise<SupplierInvoice>;
|
|
10445
|
+
/**
|
|
10446
|
+
* Marcar pagada una factura de proveedor
|
|
10447
|
+
*
|
|
10448
|
+
* 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.
|
|
10449
|
+
*
|
|
10450
|
+
* POST /v1/supplier_invoices/{id}/mark_paid
|
|
10451
|
+
* @see https://fiscalisto.com/docs/api/referencia/portal-de-proveedores/mark-supplier-invoice-paid
|
|
10452
|
+
*/
|
|
10453
|
+
markPaid(id: string, params: MarkSupplierInvoicePaidParams, options?: RequestOptions): Promise<SupplierInvoice>;
|
|
10454
|
+
}
|
|
10194
10455
|
/** Declaraciones del SAT: fiscalisto.satDeclarations. */
|
|
10195
10456
|
export declare class SatDeclarationsResource {
|
|
10196
10457
|
#private;
|
|
@@ -10903,6 +11164,8 @@ export declare class FiscalistoApi extends Core {
|
|
|
10903
11164
|
readonly satDownloads: SatDownloadsResource;
|
|
10904
11165
|
readonly satInvoices: SatInvoicesResource;
|
|
10905
11166
|
readonly satRetentions: SatRetentionsResource;
|
|
11167
|
+
readonly portalSuppliers: PortalSuppliersResource;
|
|
11168
|
+
readonly supplierInvoices: SupplierInvoicesResource;
|
|
10906
11169
|
readonly satDeclarations: SatDeclarationsResource;
|
|
10907
11170
|
readonly tickets: TicketsResource;
|
|
10908
11171
|
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);
|