fiscalisto 0.1.19 → 0.1.21
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 +345 -16
- package/dist/generated.js +119 -1
- 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.21";
|
|
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.21";
|
|
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
|
@@ -119,6 +119,8 @@ export declare const ErrorCode: {
|
|
|
119
119
|
readonly PayrollReplacementInvalid: "payroll_replacement_invalid";
|
|
120
120
|
/** No se pudo dibujar el PDF de ese CFDI (su XML trae algo que el generador no lee). Descargue el XML: es el documento válido ante el SAT. */
|
|
121
121
|
readonly PdfUnavailable: "pdf_unavailable";
|
|
122
|
+
/** El ticket de compra no se puede guardar, corregir o pedir así (un archivo que no es foto ni PDF, un RFC o uso que no corresponde, una tienda que no factura con Fiscalisto, faltan datos fiscales del emisor…). El mensaje dice por qué. */
|
|
123
|
+
readonly PurchaseReceiptInvalid: "purchase_receipt_invalid";
|
|
122
124
|
/** La cotización no tiene los datos fiscales del cliente: agrégueselos con POST /v1/quotes/{id} (customer) o mándela con auto_invoice para que los dé al aceptarla. */
|
|
123
125
|
readonly QuoteCustomerMissing: "quote_customer_missing";
|
|
124
126
|
/** La cotización no se pudo guardar o ya no cambia (aceptada, rechazada o facturada), o no se puede mandar así. El mensaje dice por qué. */
|
package/dist/error-codes.js
CHANGED
|
@@ -120,6 +120,8 @@ export const ErrorCode = {
|
|
|
120
120
|
PayrollReplacementInvalid: "payroll_replacement_invalid",
|
|
121
121
|
/** No se pudo dibujar el PDF de ese CFDI (su XML trae algo que el generador no lee). Descargue el XML: es el documento válido ante el SAT. */
|
|
122
122
|
PdfUnavailable: "pdf_unavailable",
|
|
123
|
+
/** El ticket de compra no se puede guardar, corregir o pedir así (un archivo que no es foto ni PDF, un RFC o uso que no corresponde, una tienda que no factura con Fiscalisto, faltan datos fiscales del emisor…). El mensaje dice por qué. */
|
|
124
|
+
PurchaseReceiptInvalid: "purchase_receipt_invalid",
|
|
123
125
|
/** La cotización no tiene los datos fiscales del cliente: agrégueselos con POST /v1/quotes/{id} (customer) o mándela con auto_invoice para que los dé al aceptarla. */
|
|
124
126
|
QuoteCustomerMissing: "quote_customer_missing",
|
|
125
127
|
/** La cotización no se pudo guardar o ya no cambia (aceptada, rechazada o facturada), o no se puede mandar así. El mensaje dice por qué. */
|
package/dist/generated.d.ts
CHANGED
|
@@ -554,7 +554,7 @@ export interface Retention {
|
|
|
554
554
|
internal_folio: string | null;
|
|
555
555
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
556
556
|
date: string | null;
|
|
557
|
-
/** 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)
|
|
557
|
+
/** 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. */
|
|
558
558
|
code: string;
|
|
559
559
|
/** Descripción de la retención (DescRetenc). */
|
|
560
560
|
description: string | null;
|
|
@@ -622,6 +622,8 @@ export interface Retention {
|
|
|
622
622
|
mortgage_interest?: Record<string, unknown>;
|
|
623
623
|
/** Complemento de operaciones financieras derivadas de capital (Operacionesconderivados 1.0), obligatorio con code 24. */
|
|
624
624
|
financial_derivatives?: Record<string, unknown>;
|
|
625
|
+
/** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
|
|
626
|
+
platform?: Record<string, unknown>;
|
|
625
627
|
/** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
|
|
626
628
|
cancellation: {
|
|
627
629
|
/** pending (espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó) o lapsed (venció; puede pedirla otra vez). */
|
|
@@ -980,7 +982,7 @@ export interface ExternalPayrollReceiptPreview {
|
|
|
980
982
|
warnings: {
|
|
981
983
|
/** El campo de la solicitud. */
|
|
982
984
|
param: string;
|
|
983
|
-
/** 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)
|
|
985
|
+
/** 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. */
|
|
984
986
|
code: string;
|
|
985
987
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
986
988
|
message: string;
|
|
@@ -2515,7 +2517,7 @@ export interface Diot {
|
|
|
2515
2517
|
/** Lo que conviene revisar antes de presentarla. */
|
|
2516
2518
|
warnings: string[];
|
|
2517
2519
|
}
|
|
2518
|
-
/** Una tienda de Shopify
|
|
2520
|
+
/** Una tienda de Shopify, WooCommerce, Tiendanube, Mercado Libre o Amazon cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
|
|
2519
2521
|
export interface StoreConnection {
|
|
2520
2522
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
2521
2523
|
id: string;
|
|
@@ -2525,13 +2527,15 @@ export interface StoreConnection {
|
|
|
2525
2527
|
object: "store_connection";
|
|
2526
2528
|
/** El emisor dueño de la tienda. */
|
|
2527
2529
|
issuer: string;
|
|
2528
|
-
/** shopify o
|
|
2529
|
-
platform: "shopify" | "mercadolibre";
|
|
2530
|
-
/** El dominio de la tienda
|
|
2530
|
+
/** shopify, woocommerce, tiendanube, mercadolibre o amazon. */
|
|
2531
|
+
platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
|
|
2532
|
+
/** El dominio de la tienda (Shopify, WooCommerce), o el id de la tienda en Tiendanube o del vendedor en Mercado Libre y Amazon (al autorizar). */
|
|
2531
2533
|
shop: string | null;
|
|
2532
|
-
/**
|
|
2534
|
+
/** El nombre de la tienda según su plataforma, o null. */
|
|
2535
|
+
name: string | null;
|
|
2536
|
+
/** pending (Mercado Libre, Tiendanube o Amazon esperan que se autorice en authorize_url), active o disconnected. */
|
|
2533
2537
|
status: "pending" | "active" | "disconnected";
|
|
2534
|
-
/** Si está pending: la página de
|
|
2538
|
+
/** Si está pending: la página de la plataforma donde el vendedor autoriza (vale un día; cada consulta da una nueva). Si no, null. */
|
|
2535
2539
|
authorize_url: string | null;
|
|
2536
2540
|
/** Cómo se vuelve ticket cada pedido. */
|
|
2537
2541
|
settings: {
|
|
@@ -2549,8 +2553,10 @@ export interface StoreConnection {
|
|
|
2549
2553
|
payment_form: string | null;
|
|
2550
2554
|
/** c_FormaPago por pasarela o tipo de pago. */
|
|
2551
2555
|
payment_forms: Record<string, string>;
|
|
2552
|
-
/** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en
|
|
2556
|
+
/** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en las demás plataformas. */
|
|
2553
2557
|
auto_invoice: boolean | null;
|
|
2558
|
+
/** WooCommerce y Tiendanube: si el comprador recibe su enlace para facturar (nota del pedido o correo); null en las demás plataformas. */
|
|
2559
|
+
notify_buyer: boolean | null;
|
|
2554
2560
|
};
|
|
2555
2561
|
/** Cuántos pedidos se han vuelto tickets. */
|
|
2556
2562
|
orders_count: number;
|
|
@@ -2750,6 +2756,80 @@ export interface BankImport {
|
|
|
2750
2756
|
/** Los depósitos agregados. */
|
|
2751
2757
|
data: BankTransaction[];
|
|
2752
2758
|
}
|
|
2759
|
+
/** Un ticket de compra del emisor sin factura: lo que se leyó de su foto y si ya se pidió, llegó o no es deducible. */
|
|
2760
|
+
export interface PurchaseReceipt {
|
|
2761
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
2762
|
+
id: string;
|
|
2763
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
2764
|
+
livemode: boolean;
|
|
2765
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2766
|
+
object: "purchase_receipt";
|
|
2767
|
+
/** El emisor (el que compró). */
|
|
2768
|
+
issuer: string;
|
|
2769
|
+
/** pending (por pedir), requested (pedida a la tienda), invoiced (ya tiene factura) o non_deductible (no hubo factura). */
|
|
2770
|
+
status: "pending" | "requested" | "invoiced" | "non_deductible";
|
|
2771
|
+
/** La tienda: name, tax_id (su RFC), email, portal_url (su portal o la liga del QR) y on_fiscalisto (factura con Fiscalisto: method fiscalisto la timbra al momento). */
|
|
2772
|
+
store: {
|
|
2773
|
+
/** Nombre. */
|
|
2774
|
+
name: string | null;
|
|
2775
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
2776
|
+
tax_id: string | null;
|
|
2777
|
+
/** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
|
|
2778
|
+
email: string | null;
|
|
2779
|
+
/** Su portal de facturación o la liga del QR, o null. */
|
|
2780
|
+
portal_url: string | null;
|
|
2781
|
+
/** true si factura con Fiscalisto: method fiscalisto timbra la factura al momento. */
|
|
2782
|
+
on_fiscalisto: boolean;
|
|
2783
|
+
};
|
|
2784
|
+
/** El día de la compra (AAAA-MM-DD), o null. */
|
|
2785
|
+
date: string | null;
|
|
2786
|
+
/** El total pagado, en pesos, o null. */
|
|
2787
|
+
total: number | null;
|
|
2788
|
+
/** efectivo, tarjeta u otro, o null. */
|
|
2789
|
+
payment_method: "efectivo" | "tarjeta" | "otro" | null;
|
|
2790
|
+
/** El folio o número de ticket, o null. */
|
|
2791
|
+
folio: string | null;
|
|
2792
|
+
/** Otros datos que pide el portal de la tienda para facturar (Web ID, sucursal, caja…). */
|
|
2793
|
+
fields: {
|
|
2794
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
2795
|
+
label: string;
|
|
2796
|
+
/** Lo que dice el ticket en ese dato. */
|
|
2797
|
+
value: string;
|
|
2798
|
+
}[];
|
|
2799
|
+
/** El uso de la factura que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
|
|
2800
|
+
use: string | null;
|
|
2801
|
+
/** Una nota, o null. */
|
|
2802
|
+
note: string | null;
|
|
2803
|
+
/** ai (lo leyó la IA), manual (se mandaron los datos) o null. */
|
|
2804
|
+
read_by: "ai" | "manual" | null;
|
|
2805
|
+
/** Por qué no se leyó o qué revisar (foto borrosa, no parece un ticket…), o null. */
|
|
2806
|
+
read_note: string | null;
|
|
2807
|
+
/** El tipo del archivo guardado (image/jpeg, application/pdf…). */
|
|
2808
|
+
file_type: string | null;
|
|
2809
|
+
/** true si se pagó en efectivo más de $2,000: aunque tenga factura, no es deducible (LISR art. 27 fr. III). */
|
|
2810
|
+
cash_over_limit: boolean;
|
|
2811
|
+
/** Por pedir: los días que le quedan al mes de la compra, en hora de México (muchas tiendas solo facturan dentro del mes); si no, null. */
|
|
2812
|
+
days_left_in_month: number | null;
|
|
2813
|
+
/** Cuándo y cómo se pidió (method: fiscalisto, email, portal o manual; to: la tienda o su correo), o null. */
|
|
2814
|
+
requested: {
|
|
2815
|
+
/** egreso (la factura completa y después una nota de crédito por el anticipo, opción A) o remanente (la factura solo por lo que falta, opción B). */
|
|
2816
|
+
method: string | null;
|
|
2817
|
+
/** A quién (correos separados por comas). */
|
|
2818
|
+
to: string | null;
|
|
2819
|
+
/** Cuándo se pidió. */
|
|
2820
|
+
at: string | null;
|
|
2821
|
+
} | null;
|
|
2822
|
+
/** El folio fiscal de la factura que lo cubre, o null. */
|
|
2823
|
+
invoice_uuid: string | null;
|
|
2824
|
+
/** La factura recibida (sat_…) que lo cubre, si ya llegó con las descargas del SAT, o null. */
|
|
2825
|
+
invoice: string | null;
|
|
2826
|
+
/** Cuándo quedó facturado, o null. */
|
|
2827
|
+
invoiced_at: string | null;
|
|
2828
|
+
/** Cuándo se marcó no deducible, o null. */
|
|
2829
|
+
non_deductible_at: string | null;
|
|
2830
|
+
/** Cuándo se guardó. */
|
|
2831
|
+
created_at: string | null;
|
|
2832
|
+
}
|
|
2753
2833
|
/** Una liga para que el dueño de un emisor suba su CSD y firme con su e.firma. */
|
|
2754
2834
|
export interface IssuerOnboardingLink {
|
|
2755
2835
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
@@ -2922,6 +3002,16 @@ export interface BankTransactionList {
|
|
|
2922
3002
|
/** La ruta de esta lista. */
|
|
2923
3003
|
url: string;
|
|
2924
3004
|
}
|
|
3005
|
+
export interface PurchaseReceiptList {
|
|
3006
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
3007
|
+
object: "list";
|
|
3008
|
+
/** Los objetos de esta página. */
|
|
3009
|
+
data: PurchaseReceipt[];
|
|
3010
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
3011
|
+
has_more: boolean;
|
|
3012
|
+
/** La ruta de esta lista. */
|
|
3013
|
+
url: string;
|
|
3014
|
+
}
|
|
2925
3015
|
export interface AdvanceList {
|
|
2926
3016
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2927
3017
|
object: "list";
|
|
@@ -4431,6 +4521,99 @@ export interface ClassifyBankTransactionParams {
|
|
|
4431
4521
|
/** Una nota para su equipo (de dónde vino, por qué). */
|
|
4432
4522
|
note?: string;
|
|
4433
4523
|
}
|
|
4524
|
+
export interface CreatePurchaseReceiptParams {
|
|
4525
|
+
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
4526
|
+
issuer?: string;
|
|
4527
|
+
/** La foto (JPG, PNG o WebP) o el PDF, en base64; hasta 8 MB. */
|
|
4528
|
+
file: string;
|
|
4529
|
+
/** image/jpeg, image/png, image/webp o application/pdf. */
|
|
4530
|
+
file_type: "image/jpeg" | "image/png" | "image/webp" | "application/pdf";
|
|
4531
|
+
/** Lo que dice el código QR del ticket, si ya lo leyó (suele ser la liga del portal). */
|
|
4532
|
+
qr_text?: string;
|
|
4533
|
+
/** false para no leerlo con IA y mandar los datos usted. Por omisión se lee y se llena lo que no mandó. */
|
|
4534
|
+
read?: boolean;
|
|
4535
|
+
/** El nombre de la tienda. */
|
|
4536
|
+
store_name?: string | null;
|
|
4537
|
+
/** El RFC de la tienda (el que factura). */
|
|
4538
|
+
store_tax_id?: string | null;
|
|
4539
|
+
/** El día de la compra (AAAA-MM-DD). */
|
|
4540
|
+
date?: string | null;
|
|
4541
|
+
/** El total pagado, en pesos. */
|
|
4542
|
+
total?: number | null;
|
|
4543
|
+
/** efectivo, tarjeta u otro. */
|
|
4544
|
+
payment_method?: "efectivo" | "tarjeta" | "otro" | null;
|
|
4545
|
+
/** El folio o número de ticket. */
|
|
4546
|
+
folio?: string | null;
|
|
4547
|
+
/** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
|
|
4548
|
+
fields?: {
|
|
4549
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
4550
|
+
label: string;
|
|
4551
|
+
/** Lo que dice el ticket en ese dato. */
|
|
4552
|
+
value: string;
|
|
4553
|
+
}[];
|
|
4554
|
+
/** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
|
|
4555
|
+
portal_url?: string | null;
|
|
4556
|
+
/** El correo de facturación de la tienda. */
|
|
4557
|
+
store_email?: string | null;
|
|
4558
|
+
/** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
|
|
4559
|
+
use?: string | null;
|
|
4560
|
+
/** Una nota para su equipo. */
|
|
4561
|
+
note?: string | null;
|
|
4562
|
+
}
|
|
4563
|
+
/** Los parámetros de GET /v1/purchase_receipts. */
|
|
4564
|
+
export interface ListPurchaseReceiptsParams {
|
|
4565
|
+
/** Cuántos por página, de 1 a 100. Por omisión 10. */
|
|
4566
|
+
limit?: number;
|
|
4567
|
+
/** El id del último de la página anterior, para la siguiente. */
|
|
4568
|
+
starting_after?: string;
|
|
4569
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
4570
|
+
issuer?: string;
|
|
4571
|
+
/** pending, requested, invoiced o non_deductible. */
|
|
4572
|
+
status?: "pending" | "requested" | "invoiced" | "non_deductible";
|
|
4573
|
+
}
|
|
4574
|
+
export interface UpdatePurchaseReceiptParams {
|
|
4575
|
+
/** El nombre de la tienda. */
|
|
4576
|
+
store_name?: string | null;
|
|
4577
|
+
/** El RFC de la tienda (el que factura). */
|
|
4578
|
+
store_tax_id?: string | null;
|
|
4579
|
+
/** El día de la compra (AAAA-MM-DD). */
|
|
4580
|
+
date?: string | null;
|
|
4581
|
+
/** El total pagado, en pesos. */
|
|
4582
|
+
total?: number | null;
|
|
4583
|
+
/** efectivo, tarjeta u otro. */
|
|
4584
|
+
payment_method?: "efectivo" | "tarjeta" | "otro" | null;
|
|
4585
|
+
/** El folio o número de ticket. */
|
|
4586
|
+
folio?: string | null;
|
|
4587
|
+
/** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
|
|
4588
|
+
fields?: {
|
|
4589
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
4590
|
+
label: string;
|
|
4591
|
+
/** Lo que dice el ticket en ese dato. */
|
|
4592
|
+
value: string;
|
|
4593
|
+
}[];
|
|
4594
|
+
/** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
|
|
4595
|
+
portal_url?: string | null;
|
|
4596
|
+
/** El correo de facturación de la tienda. */
|
|
4597
|
+
store_email?: string | null;
|
|
4598
|
+
/** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
|
|
4599
|
+
use?: string | null;
|
|
4600
|
+
/** Una nota para su equipo. */
|
|
4601
|
+
note?: string | null;
|
|
4602
|
+
}
|
|
4603
|
+
export interface RequestPurchaseReceiptInvoiceParams {
|
|
4604
|
+
/** fiscalisto (la tienda factura con Fiscalisto: se timbra al momento), email (le mandamos a la tienda sus datos y la foto), portal o manual (usted la pidió; solo se marca pedida). */
|
|
4605
|
+
method: "fiscalisto" | "email" | "portal" | "manual";
|
|
4606
|
+
/** email: el correo de la tienda. Por omisión, store_email. */
|
|
4607
|
+
to?: string;
|
|
4608
|
+
/** email: unas líneas para la tienda. */
|
|
4609
|
+
message?: string;
|
|
4610
|
+
/** email y fiscalisto: el correo al que la tienda manda la factura. Por omisión, el correo de respuesta del emisor. */
|
|
4611
|
+
reply_to?: string;
|
|
4612
|
+
}
|
|
4613
|
+
export interface MarkPurchaseReceiptInvoicedParams {
|
|
4614
|
+
/** La factura recibida que lo cubre: su id (sat_…) o su folio fiscal (UUID). Sin ella, solo se marca facturado. */
|
|
4615
|
+
invoice?: string;
|
|
4616
|
+
}
|
|
4434
4617
|
export interface CreatePaymentParams {
|
|
4435
4618
|
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
4436
4619
|
issuer?: string;
|
|
@@ -4556,7 +4739,7 @@ export type ApplyAdvanceParams = {
|
|
|
4556
4739
|
export interface CreateRetentionParams {
|
|
4557
4740
|
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
4558
4741
|
issuer?: string;
|
|
4559
|
-
/** 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)
|
|
4742
|
+
/** 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. */
|
|
4560
4743
|
code: string;
|
|
4561
4744
|
/** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
|
|
4562
4745
|
description?: string | null;
|
|
@@ -4585,7 +4768,7 @@ export interface CreateRetentionParams {
|
|
|
4585
4768
|
to_month?: number;
|
|
4586
4769
|
};
|
|
4587
4770
|
/** Totales (Totales). */
|
|
4588
|
-
totals
|
|
4771
|
+
totals?: {
|
|
4589
4772
|
/** Monto total de la operación (MontoTotOperacion). */
|
|
4590
4773
|
operation: number;
|
|
4591
4774
|
/** Monto gravado (MontoTotGrav). Por omisión, operation menos exempt. */
|
|
@@ -4594,7 +4777,7 @@ export interface CreateRetentionParams {
|
|
|
4594
4777
|
exempt?: number;
|
|
4595
4778
|
};
|
|
4596
4779
|
/** Impuestos del comprobante, por tipo. */
|
|
4597
|
-
taxes
|
|
4780
|
+
taxes?: {
|
|
4598
4781
|
/** Impuesto: isr, iva o ieps (ImpuestoRet 001, 002, 003). */
|
|
4599
4782
|
tax: string;
|
|
4600
4783
|
/** Base del impuesto retenido (BaseRet). */
|
|
@@ -4604,6 +4787,46 @@ export interface CreateRetentionParams {
|
|
|
4604
4787
|
/** Tipo de pago de la retención (TipoPagoRet): 01 definitivo IVA, 02 definitivo IEPS, 03 definitivo ISR, 04 provisional ISR. Por omisión el usual de cada impuesto. */
|
|
4605
4788
|
payment_type?: string;
|
|
4606
4789
|
}[];
|
|
4790
|
+
/** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
|
|
4791
|
+
platform?: {
|
|
4792
|
+
/** Tipo de servicio (TipoDeServ), c_TipoDeServ: 01 transporte de pasajeros, 02 entrega de alimentos, 03 entrega de bienes, 04 hospedaje, 05 comercio de bienes, 06 otros servicios, 07 a 09 servicios digitales de extranjeros, 11 apuestas y sorteos (desde 2026). */
|
|
4793
|
+
type: string;
|
|
4794
|
+
/** Cada cuánto paga la plataforma (Periodicidad): 01 semanal, 02 mensual (por omisión), 03 diaria, 04 quincenal, 05 otra. */
|
|
4795
|
+
periodicity?: string;
|
|
4796
|
+
/** true si la persona física optó por que el ISR retenido sea pago definitivo (LISR 113-B): TipoPagoRet 03 en lugar de 04. */
|
|
4797
|
+
isr_definitive?: boolean;
|
|
4798
|
+
/** true si se le deposita en una cuenta en el extranjero: se retiene el 100% del IVA (LIF 2026 art. 25-IX-c). */
|
|
4799
|
+
foreign_account?: boolean;
|
|
4800
|
+
/** Cada operación (DetallesDelServicio), hasta 5,000. Lo pagado en efectivo (payment_form 01) va en la constancia pero no en las bases. */
|
|
4801
|
+
services: {
|
|
4802
|
+
/** Fecha en que el cliente pagó (FechaServ), AAAA-MM-DD, dentro del mes del periodo. */
|
|
4803
|
+
date: string;
|
|
4804
|
+
/** Forma de pago de la operación (FormaPagoServ), c_FormaPagoServ: 01 efectivo, 02 transferencia, 03 tarjeta de crédito, 04 monedero, 05 dinero electrónico, 06 débito, 07 tarjeta de servicios, 08 intermediario de pagos, 09 premios o bonificaciones. */
|
|
4805
|
+
payment_form: string;
|
|
4806
|
+
/** Precio sin IVA (PrecioServSinIVA). */
|
|
4807
|
+
price: number;
|
|
4808
|
+
/** Tasa del impuesto trasladado (TasaCuota): 0.16 (por omisión), 0.08 o 0 de IVA; 0.5 de IEPS solo con type 11, donde cada jugada va dos veces: una operación con su IVA y otra con su IEPS (el SAT pide un impuesto por operación). Sin tasa en premios (09), que desde 2026 no suman en totals. */
|
|
4809
|
+
rate?: number | string | null;
|
|
4810
|
+
/** Subtipo (SubTipServ), c_SubTipoServ: con type 01, 01 personal (por omisión), 02 compartido, 03 plus o 04 cancelación; con type 11, 08 apuestas (por omisión) o 09 sorteos. */
|
|
4811
|
+
subtype?: string | null;
|
|
4812
|
+
/** RFC (persona física) del tercero autorizado que prestó el servicio (RFCTerceroAutorizado). */
|
|
4813
|
+
authorized_tax_id?: string | null;
|
|
4814
|
+
/** Comisión de la plataforma por la operación (ComisionDelServicio): amount mayor que cero y percent opcional (0.001 a 1). Obligatoria en cada operación con IVA; no va en premios ni en las de IEPS. */
|
|
4815
|
+
commission?: {
|
|
4816
|
+
/** Importe. */
|
|
4817
|
+
amount: number;
|
|
4818
|
+
/** El porcentaje de la comisión sobre el precio, de 0.001 a 1 (0.25 es 25%). Opcional. */
|
|
4819
|
+
percent?: number | null;
|
|
4820
|
+
} | null;
|
|
4821
|
+
/** Contribución gubernamental pagada, como el impuesto sobre hospedaje (ContribucionGubernamental): amount de al menos 1.00 y state (01 a 32). */
|
|
4822
|
+
contribution?: {
|
|
4823
|
+
/** Importe. */
|
|
4824
|
+
amount: number;
|
|
4825
|
+
/** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
|
|
4826
|
+
state: string;
|
|
4827
|
+
} | null;
|
|
4828
|
+
}[];
|
|
4829
|
+
};
|
|
4607
4830
|
/** Complemento de dividendos. */
|
|
4608
4831
|
dividends?: {
|
|
4609
4832
|
/** Tipo de dividendo o utilidad distribuida (CveTipDivOUtil), c_TipoDividendoOUtilidadDistribuida. */
|
|
@@ -5674,8 +5897,8 @@ export interface GetDiotFileParams {
|
|
|
5674
5897
|
export interface CreateStoreConnectionParams {
|
|
5675
5898
|
/** El emisor (iss_…) dueño de la tienda. Por omisión, su único emisor. */
|
|
5676
5899
|
issuer?: string;
|
|
5677
|
-
/** shopify o
|
|
5678
|
-
platform: "shopify" | "mercadolibre";
|
|
5900
|
+
/** shopify, woocommerce, mercadolibre, tiendanube o amazon. */
|
|
5901
|
+
platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
|
|
5679
5902
|
/** Shopify: el dominio de la tienda (mi-tienda.myshopify.com). */
|
|
5680
5903
|
shop?: string;
|
|
5681
5904
|
/** Shopify: el Client ID de la app de la tienda (Dev Dashboard). */
|
|
@@ -5684,7 +5907,13 @@ export interface CreateStoreConnectionParams {
|
|
|
5684
5907
|
client_secret?: string;
|
|
5685
5908
|
/** Shopify, solo apps personalizadas antiguas: su token de la Admin API (shpat_…); client_secret es entonces su API secret key. */
|
|
5686
5909
|
access_token?: string;
|
|
5687
|
-
/**
|
|
5910
|
+
/** WooCommerce: la dirección de la tienda (https://mitienda.com). */
|
|
5911
|
+
site?: string;
|
|
5912
|
+
/** WooCommerce: la Clave de cliente (ck_…) de una llave de la API REST con permisos de Lectura/Escritura. */
|
|
5913
|
+
consumer_key?: string;
|
|
5914
|
+
/** WooCommerce: la Clave secreta de cliente (cs_…) de esa llave. Se guarda cifrada y nunca se muestra. */
|
|
5915
|
+
consumer_secret?: string;
|
|
5916
|
+
/** Mercado Libre, Tiendanube y Amazon: a dónde volver después de autorizar (se agregan store_connection y status). */
|
|
5688
5917
|
return_url?: string;
|
|
5689
5918
|
/** Cómo se vuelve ticket cada pedido. */
|
|
5690
5919
|
settings?: {
|
|
@@ -5704,6 +5933,8 @@ export interface CreateStoreConnectionParams {
|
|
|
5704
5933
|
payment_forms?: Record<string, string>;
|
|
5705
5934
|
/** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
|
|
5706
5935
|
auto_invoice?: boolean;
|
|
5936
|
+
/** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
|
|
5937
|
+
notify_buyer?: boolean;
|
|
5707
5938
|
};
|
|
5708
5939
|
}
|
|
5709
5940
|
/** Los parámetros de GET /v1/store_connections. */
|
|
@@ -5734,6 +5965,8 @@ export interface UpdateStoreConnectionParams {
|
|
|
5734
5965
|
payment_forms?: Record<string, string>;
|
|
5735
5966
|
/** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
|
|
5736
5967
|
auto_invoice?: boolean;
|
|
5968
|
+
/** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
|
|
5969
|
+
notify_buyer?: boolean;
|
|
5737
5970
|
};
|
|
5738
5971
|
}
|
|
5739
5972
|
export interface ImportStoreOrdersParams {
|
|
@@ -6642,6 +6875,101 @@ export declare class BankTransactionsResource {
|
|
|
6642
6875
|
*/
|
|
6643
6876
|
reopen(id: string, options?: RequestOptions): Promise<BankTransaction>;
|
|
6644
6877
|
}
|
|
6878
|
+
/** Tickets de compra: fiscalisto.purchaseReceipts. */
|
|
6879
|
+
export declare class PurchaseReceiptsResource {
|
|
6880
|
+
#private;
|
|
6881
|
+
constructor(client: Client);
|
|
6882
|
+
/**
|
|
6883
|
+
* Guardar un ticket de compra
|
|
6884
|
+
*
|
|
6885
|
+
* La foto o el PDF de un ticket que el emisor pagó sin factura, en base64. La IA lee la tienda, su RFC, la fecha, el total, la forma de pago, el folio, los datos que pide su portal y la liga de facturación; lo que usted mande gana a lo que se lea. El mismo archivo dos veces devuelve el ticket que ya estaba, sin leerlo otra vez. Si llega una factura de esa tienda por el mismo total con las descargas del SAT, el ticket queda invoiced solo.
|
|
6886
|
+
*
|
|
6887
|
+
* POST /v1/purchase_receipts
|
|
6888
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
|
|
6889
|
+
*/
|
|
6890
|
+
create(params: CreatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6891
|
+
/**
|
|
6892
|
+
* Listar tickets de compra
|
|
6893
|
+
*
|
|
6894
|
+
* Los más recientes primero.
|
|
6895
|
+
*
|
|
6896
|
+
* GET /v1/purchase_receipts
|
|
6897
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
|
|
6898
|
+
*/
|
|
6899
|
+
list(params?: ListPurchaseReceiptsParams, options?: RequestOptions): List<PurchaseReceipt>;
|
|
6900
|
+
/**
|
|
6901
|
+
* Ver un ticket de compra
|
|
6902
|
+
*
|
|
6903
|
+
* Con la factura recibida que lo cubre, si ya llegó.
|
|
6904
|
+
*
|
|
6905
|
+
* GET /v1/purchase_receipts/{id}
|
|
6906
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
|
|
6907
|
+
*/
|
|
6908
|
+
get(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6909
|
+
/**
|
|
6910
|
+
* Corregir un ticket de compra
|
|
6911
|
+
*
|
|
6912
|
+
* Corrige o llena sus datos; solo cambia lo que mande (null borra un dato). Con store_tax_id y total corregidos se vuelve a buscar su factura.
|
|
6913
|
+
*
|
|
6914
|
+
* POST /v1/purchase_receipts/{id}
|
|
6915
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
|
|
6916
|
+
*/
|
|
6917
|
+
update(id: string, params?: UpdatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6918
|
+
/**
|
|
6919
|
+
* Borrar un ticket de compra
|
|
6920
|
+
*
|
|
6921
|
+
* El ticket y su archivo, para siempre.
|
|
6922
|
+
*
|
|
6923
|
+
* DELETE /v1/purchase_receipts/{id}
|
|
6924
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
|
|
6925
|
+
*/
|
|
6926
|
+
delete(id: string, options?: RequestOptions): Promise<Deleted>;
|
|
6927
|
+
/**
|
|
6928
|
+
* Leer el ticket de nuevo
|
|
6929
|
+
*
|
|
6930
|
+
* La IA vuelve a leer el archivo y llena solo los datos que siguen vacíos. Cuenta en el límite diario de tickets de compra.
|
|
6931
|
+
*
|
|
6932
|
+
* POST /v1/purchase_receipts/{id}/read
|
|
6933
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
|
|
6934
|
+
*/
|
|
6935
|
+
read(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6936
|
+
/**
|
|
6937
|
+
* Pedir la factura a la tienda
|
|
6938
|
+
*
|
|
6939
|
+
* fiscalisto: la tienda factura con Fiscalisto (store.on_fiscalisto), se timbra al momento con los datos fiscales del emisor y el ticket queda invoiced. email: le manda a la tienda los datos fiscales y la foto; las respuestas van a reply_to. portal o manual: usted la pidió, solo queda requested. Pide el uso de use (G03 por omisión).
|
|
6940
|
+
*
|
|
6941
|
+
* POST /v1/purchase_receipts/{id}/request
|
|
6942
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
|
|
6943
|
+
*/
|
|
6944
|
+
requestInvoice(id: string, params: RequestPurchaseReceiptInvoiceParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6945
|
+
/**
|
|
6946
|
+
* Ya llegó la factura
|
|
6947
|
+
*
|
|
6948
|
+
* Para una factura que llegó por otro lado. Con invoice (sat_… o UUID), la factura recibida que lo cubre; una factura cubre un solo ticket.
|
|
6949
|
+
*
|
|
6950
|
+
* POST /v1/purchase_receipts/{id}/mark_invoiced
|
|
6951
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
|
|
6952
|
+
*/
|
|
6953
|
+
markInvoiced(id: string, params?: MarkPurchaseReceiptInvoicedParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6954
|
+
/**
|
|
6955
|
+
* Marcar como no deducible
|
|
6956
|
+
*
|
|
6957
|
+
* La tienda no dio factura: el gasto queda como no deducible.
|
|
6958
|
+
*
|
|
6959
|
+
* POST /v1/purchase_receipts/{id}/mark_non_deductible
|
|
6960
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
|
|
6961
|
+
*/
|
|
6962
|
+
markNonDeductible(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6963
|
+
/**
|
|
6964
|
+
* Volver a pedir la factura
|
|
6965
|
+
*
|
|
6966
|
+
* Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
|
|
6967
|
+
*
|
|
6968
|
+
* POST /v1/purchase_receipts/{id}/reopen
|
|
6969
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
|
|
6970
|
+
*/
|
|
6971
|
+
reopen(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6972
|
+
}
|
|
6645
6973
|
/** Pagos y notas de crédito: fiscalisto.payments. */
|
|
6646
6974
|
export declare class PaymentsResource {
|
|
6647
6975
|
#private;
|
|
@@ -7589,7 +7917,7 @@ export declare class StoreConnectionsResource {
|
|
|
7589
7917
|
/**
|
|
7590
7918
|
* Conectar una tienda
|
|
7591
7919
|
*
|
|
7592
|
-
* Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. Mercado Libre: queda pending hasta que el vendedor autorice en authorize_url. Desde entonces cada pedido pagado es un ticket (folio SHOP-1001
|
|
7920
|
+
* Shopify: con el dominio y las llaves de la app de la tienda (Dev Dashboard, permisos read_orders y write_orders) registra los webhooks y queda active. WooCommerce: con la dirección de la tienda y una llave de su API REST de Lectura/Escritura, igual. Mercado Libre, Tiendanube y Amazon: queda pending hasta que el vendedor autorice en authorize_url (Amazon no tiene webhooks: sus pedidos se leen cada hora). Desde entonces cada pedido pagado es un ticket (folio SHOP-1001, WEB-1001, TN-1001, ML-… o AMZ-…), que su comprador factura en el portal o entra en la factura global; un pedido cancelado o reembolsado completo cancela su ticket.
|
|
7593
7921
|
*
|
|
7594
7922
|
* POST /v1/store_connections
|
|
7595
7923
|
* @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
|
|
@@ -7915,6 +8243,7 @@ export declare class FiscalistoApi extends Core {
|
|
|
7915
8243
|
readonly invoices: InvoicesResource;
|
|
7916
8244
|
readonly receivables: ReceivablesResource;
|
|
7917
8245
|
readonly bankTransactions: BankTransactionsResource;
|
|
8246
|
+
readonly purchaseReceipts: PurchaseReceiptsResource;
|
|
7918
8247
|
readonly payments: PaymentsResource;
|
|
7919
8248
|
readonly creditNotes: CreditNotesResource;
|
|
7920
8249
|
readonly advances: AdvancesResource;
|