fiscalisto 0.1.41 → 0.1.43

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.41";
7
+ export declare const VERSION = "0.1.43";
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.41";
6
+ export const VERSION = "0.1.43";
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.
@@ -3,7 +3,7 @@
3
3
  * `if (error.code === ErrorCode.InvoiceRejected)`. Vea https://fiscalisto.com/docs/api/errores.
4
4
  */
5
5
  export declare const ErrorCode: {
6
- /** Suspendimos la cuenta API (todas sus llaves, o solo las de producción) por un uso que rompe los términos del servicio. El mensaje dice por qué; escríbanos a soporte@fiscalisto.com para reactivarla. */
6
+ /** Suspendimos la API de la empresa (todas sus llaves, o solo las de producción) por un uso que rompe los términos del servicio. El mensaje dice por qué; escríbanos a soporte@fiscalisto.com para reactivarla. */
7
7
  readonly AccountSuspended: "account_suspended";
8
8
  /** No existe esa versión de la API (en Fiscalisto-Version o api_version). El mensaje dice cuáles hay; vea Versiones. */
9
9
  readonly ApiVersionInvalid: "api_version_invalid";
@@ -161,7 +161,7 @@ export declare const ErrorCode: {
161
161
  readonly RecurringNotDue: "recurring_not_due";
162
162
  /** La factura recurrente está en pausa: reanúdela con active: true para timbrarla. */
163
163
  readonly RecurringPaused: "recurring_paused";
164
- /** Otra solicitud con la misma Idempotency-Key sigue en proceso, o otra solicitud está cambiando el mismo objeto (dos actualizaciones del mismo cliente a la vez esperan su turno hasta 15 segundos) (409, con Retry-After). Repítala en un momento con la misma llave: contestará lo mismo. */
164
+ /** Otra solicitud con la misma Idempotency-Key sigue en proceso, otra solicitud está cambiando el mismo objeto (dos actualizaciones del mismo cliente a la vez esperan su turno hasta 15 segundos), u otro comprobante que se timbra a la vez no terminó en unos segundos (otro recibo de nómina del mismo empleado, otro pago de la misma factura) (409, con Retry-After). Repítala en un momento con la misma llave: contestará lo mismo. */
165
165
  readonly RequestInProgress: "request_in_progress";
166
166
  /** No existe un objeto con ese id (o es de otro emisor o del otro modo). */
167
167
  readonly ResourceMissing: "resource_missing";
@@ -4,7 +4,7 @@
4
4
  * `if (error.code === ErrorCode.InvoiceRejected)`. Vea https://fiscalisto.com/docs/api/errores.
5
5
  */
6
6
  export const ErrorCode = {
7
- /** Suspendimos la cuenta API (todas sus llaves, o solo las de producción) por un uso que rompe los términos del servicio. El mensaje dice por qué; escríbanos a soporte@fiscalisto.com para reactivarla. */
7
+ /** Suspendimos la API de la empresa (todas sus llaves, o solo las de producción) por un uso que rompe los términos del servicio. El mensaje dice por qué; escríbanos a soporte@fiscalisto.com para reactivarla. */
8
8
  AccountSuspended: "account_suspended",
9
9
  /** No existe esa versión de la API (en Fiscalisto-Version o api_version). El mensaje dice cuáles hay; vea Versiones. */
10
10
  ApiVersionInvalid: "api_version_invalid",
@@ -162,7 +162,7 @@ export const ErrorCode = {
162
162
  RecurringNotDue: "recurring_not_due",
163
163
  /** La factura recurrente está en pausa: reanúdela con active: true para timbrarla. */
164
164
  RecurringPaused: "recurring_paused",
165
- /** Otra solicitud con la misma Idempotency-Key sigue en proceso, o otra solicitud está cambiando el mismo objeto (dos actualizaciones del mismo cliente a la vez esperan su turno hasta 15 segundos) (409, con Retry-After). Repítala en un momento con la misma llave: contestará lo mismo. */
165
+ /** Otra solicitud con la misma Idempotency-Key sigue en proceso, otra solicitud está cambiando el mismo objeto (dos actualizaciones del mismo cliente a la vez esperan su turno hasta 15 segundos), u otro comprobante que se timbra a la vez no terminó en unos segundos (otro recibo de nómina del mismo empleado, otro pago de la misma factura) (409, con Retry-After). Repítala en un momento con la misma llave: contestará lo mismo. */
166
166
  RequestInProgress: "request_in_progress",
167
167
  /** No existe un objeto con ese id (o es de otro emisor o del otro modo). */
168
168
  ResourceMissing: "resource_missing",
@@ -123,7 +123,14 @@ export interface Issuer {
123
123
  employer_registration: string | null;
124
124
  /** CURP, 18 caracteres. */
125
125
  curp: string | null;
126
- /** RFC con el que se timbra: el del emisor en producción y el de pruebas del SAT (EKU9003173C9) en pruebas. */
126
+ /** Donataria autorizada (régimen 603): el oficio del SAT que la autoriza a recibir donativos deducibles (o su renovación). Va en cada recibo de donativo (`donation` de POST /v1/invoices); null lo quita. El emisor debe tener tax_system 603. En pruebas sirve cualquier número y una fecha pasada. */
127
+ donation_authorization: {
128
+ /** Número del oficio de autorización, hasta 100 caracteres. */
129
+ number: string;
130
+ /** Fecha del oficio, AAAA-MM-DD; no puede ser futura. */
131
+ date: string | null;
132
+ } | null;
133
+ /** RFC con el que se timbra: el del emisor en producción y el de pruebas del SAT (EKU9003173C9) en pruebas, con régimen 601 o, si el emisor es donataria (tax_system 603), 603. */
127
134
  stamps_as: string;
128
135
  /** El entorno de prueba (sbx_…) al que pertenece, o null si es de la cuenta. Vea /v1/sandboxes. */
129
136
  sandbox: string | null;
@@ -436,6 +443,8 @@ export interface Invoice {
436
443
  amount_due: number | null;
437
444
  /** Lo cobrado: complementos de pago y notas de crédito vigentes, o todo si es PUE pagada. null si no aplica. */
438
445
  amount_paid: number | null;
446
+ /** Una PUE que estuvo por cobrar (paid_later o mark_unpaid): el día en que el cliente pagó (AAAA-MM-DD), el que dijo POST /v1/invoices/{id}/mark_paid o el del depósito conciliado con ella. null si no hay fecha de pago registrada (una PUE pagada al timbrarse), si no se ha pagado o si es PPD (sus pagos están en sus complementos). */
447
+ paid_on: string | null;
439
448
  /** CFDI relacionados (CfdiRelacionados): tipo de relación de c_TipoRelacion y los UUID. */
440
449
  related: Record<string, unknown> | null;
441
450
  /** Solo en un complemento de pago (type P). */
@@ -3913,7 +3922,7 @@ export interface PurchaseReceipt {
3913
3922
  /** Lo que dice el ticket en ese dato. */
3914
3923
  value: string;
3915
3924
  }[];
3916
- /** El uso de la factura que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
3925
+ /** El uso del CFDI que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
3917
3926
  use: string | null;
3918
3927
  /** Una nota, o null. */
3919
3928
  note: string | null;
@@ -5157,11 +5166,11 @@ export interface InvoiceCreate {
5157
5166
  /** Norma o artículo (norma). */
5158
5167
  norm?: string;
5159
5168
  }[];
5160
- /** Complemento de donatarias. */
5169
+ /** Complemento de donatarias: un recibo de donativo. El emisor debe ser donataria (tax_system 603) con su oficio en donation_authorization (POST /v1/issuers/{id}). */
5161
5170
  donation?: {
5162
- /** true si el donativo es en especie (va sin forma de pago en efectivo). */
5171
+ /** true si el donativo es en especie (bienes): va con forma de pago 12 (dación en pago) y un concepto por cada tipo de bien. */
5163
5172
  in_kind?: boolean;
5164
- /** true si el donativo es deducible para quien lo da. */
5173
+ /** true si el donante ya había deducido los bienes que dona: el recibo dice que el donativo no es deducible. */
5165
5174
  deducted?: boolean;
5166
5175
  };
5167
5176
  /** Impuestos locales (complemento implocal): traslados y retenciones estatales. */
@@ -5583,6 +5592,13 @@ export interface CreateIssuerParams {
5583
5592
  employer_registration?: string | null;
5584
5593
  /** CURP, 18 caracteres. */
5585
5594
  curp?: string | null;
5595
+ /** Donataria autorizada (régimen 603): el oficio del SAT que la autoriza a recibir donativos deducibles (o su renovación). Va en cada recibo de donativo (`donation` de POST /v1/invoices); null lo quita. El emisor debe tener tax_system 603. En pruebas sirve cualquier número y una fecha pasada. */
5596
+ donation_authorization?: {
5597
+ /** Número del oficio de autorización, hasta 100 caracteres. */
5598
+ number: string;
5599
+ /** Fecha del oficio, AAAA-MM-DD; no puede ser futura. */
5600
+ date: string;
5601
+ } | null;
5586
5602
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
5587
5603
  metadata?: Record<string, string>;
5588
5604
  }
@@ -5608,6 +5624,13 @@ export interface UpdateIssuerParams {
5608
5624
  employer_registration?: string | null;
5609
5625
  /** CURP, 18 caracteres. */
5610
5626
  curp?: string | null;
5627
+ /** Donataria autorizada (régimen 603): el oficio del SAT que la autoriza a recibir donativos deducibles (o su renovación). Va en cada recibo de donativo (`donation` de POST /v1/invoices); null lo quita. El emisor debe tener tax_system 603. En pruebas sirve cualquier número y una fecha pasada. */
5628
+ donation_authorization?: {
5629
+ /** Número del oficio de autorización, hasta 100 caracteres. */
5630
+ number: string;
5631
+ /** Fecha del oficio, AAAA-MM-DD; no puede ser futura. */
5632
+ date: string;
5633
+ } | null;
5611
5634
  /** Sus propios datos: hasta 50 llaves de 40 caracteres con valores de texto de hasta 500. No van al CFDI; vuelven en el objeto y en los webhooks. */
5612
5635
  metadata?: Record<string, string> | null;
5613
5636
  }
@@ -5691,6 +5714,10 @@ export interface CancelInvoiceParams {
5691
5714
  /** El comprobante que sustituye a este (su id o su UUID), con el motivo 01. */
5692
5715
  substitution?: string;
5693
5716
  }
5717
+ export interface MarkInvoicePaidParams {
5718
+ /** El día en que el cliente pagó (AAAA-MM-DD, no antes de la factura ni después de hoy); hoy si no se indica. Queda en paid_on. */
5719
+ paid_on?: string;
5720
+ }
5694
5721
  /** Los parámetros de GET /v1/receivables. */
5695
5722
  export interface ListReceivablesParams {
5696
5723
  /** Cuántos por página, de 1 a 100. Por omisión 10. */
@@ -5774,7 +5801,7 @@ export interface CreatePurchaseReceiptParams {
5774
5801
  portal_url?: string | null;
5775
5802
  /** El correo de facturación de la tienda. */
5776
5803
  store_email?: string | null;
5777
- /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
5804
+ /** El uso del CFDI (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
5778
5805
  use?: string | null;
5779
5806
  /** Una nota para su equipo. */
5780
5807
  note?: string | null;
@@ -5814,7 +5841,7 @@ export interface UpdatePurchaseReceiptParams {
5814
5841
  portal_url?: string | null;
5815
5842
  /** El correo de facturación de la tienda. */
5816
5843
  store_email?: string | null;
5817
- /** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
5844
+ /** El uso del CFDI (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
5818
5845
  use?: string | null;
5819
5846
  /** Una nota para su equipo. */
5820
5847
  note?: string | null;
@@ -8976,12 +9003,12 @@ export declare class InvoicesResource {
8976
9003
  /**
8977
9004
  * Marcar pagada
8978
9005
  *
8979
- * Una factura PUE timbrada con paid_later (o marcada por cobrar) ya se pagó: queda paid y llega invoice.paid. Una PPD se paga con su complemento de pago (POST /v1/payments).
9006
+ * Una factura PUE timbrada con paid_later (o marcada por cobrar) ya se pagó: queda paid, con paid_on el día que indique (hoy si no), y llega invoice.paid. Una PPD se paga con su complemento de pago (POST /v1/payments).
8980
9007
  *
8981
9008
  * POST /v1/invoices/{id}/mark_paid
8982
9009
  * @see https://fiscalisto.com/docs/api/referencia/cuentas-por-cobrar/mark-invoice-paid
8983
9010
  */
8984
- markPaid(id: string, options?: RequestOptions): Promise<Invoice>;
9011
+ markPaid(id: string, params?: MarkInvoicePaidParams, options?: RequestOptions): Promise<Invoice>;
8985
9012
  /**
8986
9013
  * Marcar por cobrar
8987
9014
  *
package/dist/generated.js CHANGED
@@ -480,13 +480,13 @@ export class InvoicesResource {
480
480
  /**
481
481
  * Marcar pagada
482
482
  *
483
- * Una factura PUE timbrada con paid_later (o marcada por cobrar) ya se pagó: queda paid y llega invoice.paid. Una PPD se paga con su complemento de pago (POST /v1/payments).
483
+ * Una factura PUE timbrada con paid_later (o marcada por cobrar) ya se pagó: queda paid, con paid_on el día que indique (hoy si no), y llega invoice.paid. Una PPD se paga con su complemento de pago (POST /v1/payments).
484
484
  *
485
485
  * POST /v1/invoices/{id}/mark_paid
486
486
  * @see https://fiscalisto.com/docs/api/referencia/cuentas-por-cobrar/mark-invoice-paid
487
487
  */
488
- markPaid(id, options) {
489
- return this.#client.request({ method: "POST", path: `/v1/invoices/${encodeURIComponent(id)}/mark_paid`, idempotent: true }, options);
488
+ markPaid(id, params, options) {
489
+ return this.#client.request({ method: "POST", path: `/v1/invoices/${encodeURIComponent(id)}/mark_paid`, body: params, idempotent: true }, options);
490
490
  }
491
491
  /**
492
492
  * Marcar por cobrar