fiscalisto 0.1.19 → 0.1.20
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 +298 -11
- 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.20";
|
|
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.20";
|
|
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
|
@@ -2515,7 +2515,7 @@ export interface Diot {
|
|
|
2515
2515
|
/** Lo que conviene revisar antes de presentarla. */
|
|
2516
2516
|
warnings: string[];
|
|
2517
2517
|
}
|
|
2518
|
-
/** Una tienda de Shopify
|
|
2518
|
+
/** Una tienda de Shopify, WooCommerce, Tiendanube, Mercado Libre o Amazon cuyos pedidos pagados se vuelven tickets de autofactura del emisor. */
|
|
2519
2519
|
export interface StoreConnection {
|
|
2520
2520
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
2521
2521
|
id: string;
|
|
@@ -2525,13 +2525,15 @@ export interface StoreConnection {
|
|
|
2525
2525
|
object: "store_connection";
|
|
2526
2526
|
/** El emisor dueño de la tienda. */
|
|
2527
2527
|
issuer: string;
|
|
2528
|
-
/** shopify o
|
|
2529
|
-
platform: "shopify" | "mercadolibre";
|
|
2530
|
-
/** El dominio de la tienda
|
|
2528
|
+
/** shopify, woocommerce, tiendanube, mercadolibre o amazon. */
|
|
2529
|
+
platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
|
|
2530
|
+
/** 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
2531
|
shop: string | null;
|
|
2532
|
-
/**
|
|
2532
|
+
/** El nombre de la tienda según su plataforma, o null. */
|
|
2533
|
+
name: string | null;
|
|
2534
|
+
/** pending (Mercado Libre, Tiendanube o Amazon esperan que se autorice en authorize_url), active o disconnected. */
|
|
2533
2535
|
status: "pending" | "active" | "disconnected";
|
|
2534
|
-
/** Si está pending: la página de
|
|
2536
|
+
/** 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
2537
|
authorize_url: string | null;
|
|
2536
2538
|
/** Cómo se vuelve ticket cada pedido. */
|
|
2537
2539
|
settings: {
|
|
@@ -2549,8 +2551,10 @@ export interface StoreConnection {
|
|
|
2549
2551
|
payment_form: string | null;
|
|
2550
2552
|
/** c_FormaPago por pasarela o tipo de pago. */
|
|
2551
2553
|
payment_forms: Record<string, string>;
|
|
2552
|
-
/** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en
|
|
2554
|
+
/** Mercado Libre: si se timbra al momento con los datos fiscales del comprador; null en las demás plataformas. */
|
|
2553
2555
|
auto_invoice: boolean | null;
|
|
2556
|
+
/** WooCommerce y Tiendanube: si el comprador recibe su enlace para facturar (nota del pedido o correo); null en las demás plataformas. */
|
|
2557
|
+
notify_buyer: boolean | null;
|
|
2554
2558
|
};
|
|
2555
2559
|
/** Cuántos pedidos se han vuelto tickets. */
|
|
2556
2560
|
orders_count: number;
|
|
@@ -2750,6 +2754,80 @@ export interface BankImport {
|
|
|
2750
2754
|
/** Los depósitos agregados. */
|
|
2751
2755
|
data: BankTransaction[];
|
|
2752
2756
|
}
|
|
2757
|
+
/** 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. */
|
|
2758
|
+
export interface PurchaseReceipt {
|
|
2759
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
2760
|
+
id: string;
|
|
2761
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
2762
|
+
livemode: boolean;
|
|
2763
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2764
|
+
object: "purchase_receipt";
|
|
2765
|
+
/** El emisor (el que compró). */
|
|
2766
|
+
issuer: string;
|
|
2767
|
+
/** pending (por pedir), requested (pedida a la tienda), invoiced (ya tiene factura) o non_deductible (no hubo factura). */
|
|
2768
|
+
status: "pending" | "requested" | "invoiced" | "non_deductible";
|
|
2769
|
+
/** 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). */
|
|
2770
|
+
store: {
|
|
2771
|
+
/** Nombre. */
|
|
2772
|
+
name: string | null;
|
|
2773
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
2774
|
+
tax_id: string | null;
|
|
2775
|
+
/** Correo a donde se envía (varios separados por comas). Solo se usa si se pide enviarlo. */
|
|
2776
|
+
email: string | null;
|
|
2777
|
+
/** Su portal de facturación o la liga del QR, o null. */
|
|
2778
|
+
portal_url: string | null;
|
|
2779
|
+
/** true si factura con Fiscalisto: method fiscalisto timbra la factura al momento. */
|
|
2780
|
+
on_fiscalisto: boolean;
|
|
2781
|
+
};
|
|
2782
|
+
/** El día de la compra (AAAA-MM-DD), o null. */
|
|
2783
|
+
date: string | null;
|
|
2784
|
+
/** El total pagado, en pesos, o null. */
|
|
2785
|
+
total: number | null;
|
|
2786
|
+
/** efectivo, tarjeta u otro, o null. */
|
|
2787
|
+
payment_method: "efectivo" | "tarjeta" | "otro" | null;
|
|
2788
|
+
/** El folio o número de ticket, o null. */
|
|
2789
|
+
folio: string | null;
|
|
2790
|
+
/** Otros datos que pide el portal de la tienda para facturar (Web ID, sucursal, caja…). */
|
|
2791
|
+
fields: {
|
|
2792
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
2793
|
+
label: string;
|
|
2794
|
+
/** Lo que dice el ticket en ese dato. */
|
|
2795
|
+
value: string;
|
|
2796
|
+
}[];
|
|
2797
|
+
/** El uso de la factura que se pide, o null: G03 si el régimen del emisor lo permite, si no S01. */
|
|
2798
|
+
use: string | null;
|
|
2799
|
+
/** Una nota, o null. */
|
|
2800
|
+
note: string | null;
|
|
2801
|
+
/** ai (lo leyó la IA), manual (se mandaron los datos) o null. */
|
|
2802
|
+
read_by: "ai" | "manual" | null;
|
|
2803
|
+
/** Por qué no se leyó o qué revisar (foto borrosa, no parece un ticket…), o null. */
|
|
2804
|
+
read_note: string | null;
|
|
2805
|
+
/** El tipo del archivo guardado (image/jpeg, application/pdf…). */
|
|
2806
|
+
file_type: string | null;
|
|
2807
|
+
/** true si se pagó en efectivo más de $2,000: aunque tenga factura, no es deducible (LISR art. 27 fr. III). */
|
|
2808
|
+
cash_over_limit: boolean;
|
|
2809
|
+
/** 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. */
|
|
2810
|
+
days_left_in_month: number | null;
|
|
2811
|
+
/** Cuándo y cómo se pidió (method: fiscalisto, email, portal o manual; to: la tienda o su correo), o null. */
|
|
2812
|
+
requested: {
|
|
2813
|
+
/** 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). */
|
|
2814
|
+
method: string | null;
|
|
2815
|
+
/** A quién (correos separados por comas). */
|
|
2816
|
+
to: string | null;
|
|
2817
|
+
/** Cuándo se pidió. */
|
|
2818
|
+
at: string | null;
|
|
2819
|
+
} | null;
|
|
2820
|
+
/** El folio fiscal de la factura que lo cubre, o null. */
|
|
2821
|
+
invoice_uuid: string | null;
|
|
2822
|
+
/** La factura recibida (sat_…) que lo cubre, si ya llegó con las descargas del SAT, o null. */
|
|
2823
|
+
invoice: string | null;
|
|
2824
|
+
/** Cuándo quedó facturado, o null. */
|
|
2825
|
+
invoiced_at: string | null;
|
|
2826
|
+
/** Cuándo se marcó no deducible, o null. */
|
|
2827
|
+
non_deductible_at: string | null;
|
|
2828
|
+
/** Cuándo se guardó. */
|
|
2829
|
+
created_at: string | null;
|
|
2830
|
+
}
|
|
2753
2831
|
/** Una liga para que el dueño de un emisor suba su CSD y firme con su e.firma. */
|
|
2754
2832
|
export interface IssuerOnboardingLink {
|
|
2755
2833
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
@@ -2922,6 +3000,16 @@ export interface BankTransactionList {
|
|
|
2922
3000
|
/** La ruta de esta lista. */
|
|
2923
3001
|
url: string;
|
|
2924
3002
|
}
|
|
3003
|
+
export interface PurchaseReceiptList {
|
|
3004
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
3005
|
+
object: "list";
|
|
3006
|
+
/** Los objetos de esta página. */
|
|
3007
|
+
data: PurchaseReceipt[];
|
|
3008
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
3009
|
+
has_more: boolean;
|
|
3010
|
+
/** La ruta de esta lista. */
|
|
3011
|
+
url: string;
|
|
3012
|
+
}
|
|
2925
3013
|
export interface AdvanceList {
|
|
2926
3014
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2927
3015
|
object: "list";
|
|
@@ -4431,6 +4519,99 @@ export interface ClassifyBankTransactionParams {
|
|
|
4431
4519
|
/** Una nota para su equipo (de dónde vino, por qué). */
|
|
4432
4520
|
note?: string;
|
|
4433
4521
|
}
|
|
4522
|
+
export interface CreatePurchaseReceiptParams {
|
|
4523
|
+
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
4524
|
+
issuer?: string;
|
|
4525
|
+
/** La foto (JPG, PNG o WebP) o el PDF, en base64; hasta 8 MB. */
|
|
4526
|
+
file: string;
|
|
4527
|
+
/** image/jpeg, image/png, image/webp o application/pdf. */
|
|
4528
|
+
file_type: "image/jpeg" | "image/png" | "image/webp" | "application/pdf";
|
|
4529
|
+
/** Lo que dice el código QR del ticket, si ya lo leyó (suele ser la liga del portal). */
|
|
4530
|
+
qr_text?: string;
|
|
4531
|
+
/** false para no leerlo con IA y mandar los datos usted. Por omisión se lee y se llena lo que no mandó. */
|
|
4532
|
+
read?: boolean;
|
|
4533
|
+
/** El nombre de la tienda. */
|
|
4534
|
+
store_name?: string | null;
|
|
4535
|
+
/** El RFC de la tienda (el que factura). */
|
|
4536
|
+
store_tax_id?: string | null;
|
|
4537
|
+
/** El día de la compra (AAAA-MM-DD). */
|
|
4538
|
+
date?: string | null;
|
|
4539
|
+
/** El total pagado, en pesos. */
|
|
4540
|
+
total?: number | null;
|
|
4541
|
+
/** efectivo, tarjeta u otro. */
|
|
4542
|
+
payment_method?: "efectivo" | "tarjeta" | "otro" | null;
|
|
4543
|
+
/** El folio o número de ticket. */
|
|
4544
|
+
folio?: string | null;
|
|
4545
|
+
/** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
|
|
4546
|
+
fields?: {
|
|
4547
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
4548
|
+
label: string;
|
|
4549
|
+
/** Lo que dice el ticket en ese dato. */
|
|
4550
|
+
value: string;
|
|
4551
|
+
}[];
|
|
4552
|
+
/** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
|
|
4553
|
+
portal_url?: string | null;
|
|
4554
|
+
/** El correo de facturación de la tienda. */
|
|
4555
|
+
store_email?: string | null;
|
|
4556
|
+
/** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
|
|
4557
|
+
use?: string | null;
|
|
4558
|
+
/** Una nota para su equipo. */
|
|
4559
|
+
note?: string | null;
|
|
4560
|
+
}
|
|
4561
|
+
/** Los parámetros de GET /v1/purchase_receipts. */
|
|
4562
|
+
export interface ListPurchaseReceiptsParams {
|
|
4563
|
+
/** Cuántos por página, de 1 a 100. Por omisión 10. */
|
|
4564
|
+
limit?: number;
|
|
4565
|
+
/** El id del último de la página anterior, para la siguiente. */
|
|
4566
|
+
starting_after?: string;
|
|
4567
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
4568
|
+
issuer?: string;
|
|
4569
|
+
/** pending, requested, invoiced o non_deductible. */
|
|
4570
|
+
status?: "pending" | "requested" | "invoiced" | "non_deductible";
|
|
4571
|
+
}
|
|
4572
|
+
export interface UpdatePurchaseReceiptParams {
|
|
4573
|
+
/** El nombre de la tienda. */
|
|
4574
|
+
store_name?: string | null;
|
|
4575
|
+
/** El RFC de la tienda (el que factura). */
|
|
4576
|
+
store_tax_id?: string | null;
|
|
4577
|
+
/** El día de la compra (AAAA-MM-DD). */
|
|
4578
|
+
date?: string | null;
|
|
4579
|
+
/** El total pagado, en pesos. */
|
|
4580
|
+
total?: number | null;
|
|
4581
|
+
/** efectivo, tarjeta u otro. */
|
|
4582
|
+
payment_method?: "efectivo" | "tarjeta" | "otro" | null;
|
|
4583
|
+
/** El folio o número de ticket. */
|
|
4584
|
+
folio?: string | null;
|
|
4585
|
+
/** Otros datos que pide el portal de la tienda (Web ID, sucursal, caja…), hasta 8. */
|
|
4586
|
+
fields?: {
|
|
4587
|
+
/** Cómo lo llama el ticket (Web ID, Sucursal…). */
|
|
4588
|
+
label: string;
|
|
4589
|
+
/** Lo que dice el ticket en ese dato. */
|
|
4590
|
+
value: string;
|
|
4591
|
+
}[];
|
|
4592
|
+
/** La dirección del portal de facturación de la tienda (o la liga de autofactura de su QR). */
|
|
4593
|
+
portal_url?: string | null;
|
|
4594
|
+
/** El correo de facturación de la tienda. */
|
|
4595
|
+
store_email?: string | null;
|
|
4596
|
+
/** El uso de la factura (G03, I01…). Por omisión G03 si el régimen del emisor lo permite. */
|
|
4597
|
+
use?: string | null;
|
|
4598
|
+
/** Una nota para su equipo. */
|
|
4599
|
+
note?: string | null;
|
|
4600
|
+
}
|
|
4601
|
+
export interface RequestPurchaseReceiptInvoiceParams {
|
|
4602
|
+
/** 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). */
|
|
4603
|
+
method: "fiscalisto" | "email" | "portal" | "manual";
|
|
4604
|
+
/** email: el correo de la tienda. Por omisión, store_email. */
|
|
4605
|
+
to?: string;
|
|
4606
|
+
/** email: unas líneas para la tienda. */
|
|
4607
|
+
message?: string;
|
|
4608
|
+
/** email y fiscalisto: el correo al que la tienda manda la factura. Por omisión, el correo de respuesta del emisor. */
|
|
4609
|
+
reply_to?: string;
|
|
4610
|
+
}
|
|
4611
|
+
export interface MarkPurchaseReceiptInvoicedParams {
|
|
4612
|
+
/** La factura recibida que lo cubre: su id (sat_…) o su folio fiscal (UUID). Sin ella, solo se marca facturado. */
|
|
4613
|
+
invoice?: string;
|
|
4614
|
+
}
|
|
4434
4615
|
export interface CreatePaymentParams {
|
|
4435
4616
|
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
4436
4617
|
issuer?: string;
|
|
@@ -5674,8 +5855,8 @@ export interface GetDiotFileParams {
|
|
|
5674
5855
|
export interface CreateStoreConnectionParams {
|
|
5675
5856
|
/** El emisor (iss_…) dueño de la tienda. Por omisión, su único emisor. */
|
|
5676
5857
|
issuer?: string;
|
|
5677
|
-
/** shopify o
|
|
5678
|
-
platform: "shopify" | "mercadolibre";
|
|
5858
|
+
/** shopify, woocommerce, mercadolibre, tiendanube o amazon. */
|
|
5859
|
+
platform: "shopify" | "mercadolibre" | "amazon" | "tiendanube" | "woocommerce";
|
|
5679
5860
|
/** Shopify: el dominio de la tienda (mi-tienda.myshopify.com). */
|
|
5680
5861
|
shop?: string;
|
|
5681
5862
|
/** Shopify: el Client ID de la app de la tienda (Dev Dashboard). */
|
|
@@ -5684,7 +5865,13 @@ export interface CreateStoreConnectionParams {
|
|
|
5684
5865
|
client_secret?: string;
|
|
5685
5866
|
/** Shopify, solo apps personalizadas antiguas: su token de la Admin API (shpat_…); client_secret es entonces su API secret key. */
|
|
5686
5867
|
access_token?: string;
|
|
5687
|
-
/**
|
|
5868
|
+
/** WooCommerce: la dirección de la tienda (https://mitienda.com). */
|
|
5869
|
+
site?: string;
|
|
5870
|
+
/** WooCommerce: la Clave de cliente (ck_…) de una llave de la API REST con permisos de Lectura/Escritura. */
|
|
5871
|
+
consumer_key?: string;
|
|
5872
|
+
/** WooCommerce: la Clave secreta de cliente (cs_…) de esa llave. Se guarda cifrada y nunca se muestra. */
|
|
5873
|
+
consumer_secret?: string;
|
|
5874
|
+
/** Mercado Libre, Tiendanube y Amazon: a dónde volver después de autorizar (se agregan store_connection y status). */
|
|
5688
5875
|
return_url?: string;
|
|
5689
5876
|
/** Cómo se vuelve ticket cada pedido. */
|
|
5690
5877
|
settings?: {
|
|
@@ -5704,6 +5891,8 @@ export interface CreateStoreConnectionParams {
|
|
|
5704
5891
|
payment_forms?: Record<string, string>;
|
|
5705
5892
|
/** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
|
|
5706
5893
|
auto_invoice?: boolean;
|
|
5894
|
+
/** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
|
|
5895
|
+
notify_buyer?: boolean;
|
|
5707
5896
|
};
|
|
5708
5897
|
}
|
|
5709
5898
|
/** Los parámetros de GET /v1/store_connections. */
|
|
@@ -5734,6 +5923,8 @@ export interface UpdateStoreConnectionParams {
|
|
|
5734
5923
|
payment_forms?: Record<string, string>;
|
|
5735
5924
|
/** Mercado Libre: timbrar en cuanto se paga si el comprador dejó sus datos fiscales completos. Por omisión true. */
|
|
5736
5925
|
auto_invoice?: boolean;
|
|
5926
|
+
/** WooCommerce y Tiendanube: mandar al comprador el enlace para facturar (WooCommerce, como nota al cliente del pedido; Tiendanube, por correo). Por omisión true. */
|
|
5927
|
+
notify_buyer?: boolean;
|
|
5737
5928
|
};
|
|
5738
5929
|
}
|
|
5739
5930
|
export interface ImportStoreOrdersParams {
|
|
@@ -6642,6 +6833,101 @@ export declare class BankTransactionsResource {
|
|
|
6642
6833
|
*/
|
|
6643
6834
|
reopen(id: string, options?: RequestOptions): Promise<BankTransaction>;
|
|
6644
6835
|
}
|
|
6836
|
+
/** Tickets de compra: fiscalisto.purchaseReceipts. */
|
|
6837
|
+
export declare class PurchaseReceiptsResource {
|
|
6838
|
+
#private;
|
|
6839
|
+
constructor(client: Client);
|
|
6840
|
+
/**
|
|
6841
|
+
* Guardar un ticket de compra
|
|
6842
|
+
*
|
|
6843
|
+
* 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.
|
|
6844
|
+
*
|
|
6845
|
+
* POST /v1/purchase_receipts
|
|
6846
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
|
|
6847
|
+
*/
|
|
6848
|
+
create(params: CreatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6849
|
+
/**
|
|
6850
|
+
* Listar tickets de compra
|
|
6851
|
+
*
|
|
6852
|
+
* Los más recientes primero.
|
|
6853
|
+
*
|
|
6854
|
+
* GET /v1/purchase_receipts
|
|
6855
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
|
|
6856
|
+
*/
|
|
6857
|
+
list(params?: ListPurchaseReceiptsParams, options?: RequestOptions): List<PurchaseReceipt>;
|
|
6858
|
+
/**
|
|
6859
|
+
* Ver un ticket de compra
|
|
6860
|
+
*
|
|
6861
|
+
* Con la factura recibida que lo cubre, si ya llegó.
|
|
6862
|
+
*
|
|
6863
|
+
* GET /v1/purchase_receipts/{id}
|
|
6864
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
|
|
6865
|
+
*/
|
|
6866
|
+
get(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6867
|
+
/**
|
|
6868
|
+
* Corregir un ticket de compra
|
|
6869
|
+
*
|
|
6870
|
+
* 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.
|
|
6871
|
+
*
|
|
6872
|
+
* POST /v1/purchase_receipts/{id}
|
|
6873
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
|
|
6874
|
+
*/
|
|
6875
|
+
update(id: string, params?: UpdatePurchaseReceiptParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6876
|
+
/**
|
|
6877
|
+
* Borrar un ticket de compra
|
|
6878
|
+
*
|
|
6879
|
+
* El ticket y su archivo, para siempre.
|
|
6880
|
+
*
|
|
6881
|
+
* DELETE /v1/purchase_receipts/{id}
|
|
6882
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
|
|
6883
|
+
*/
|
|
6884
|
+
delete(id: string, options?: RequestOptions): Promise<Deleted>;
|
|
6885
|
+
/**
|
|
6886
|
+
* Leer el ticket de nuevo
|
|
6887
|
+
*
|
|
6888
|
+
* 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.
|
|
6889
|
+
*
|
|
6890
|
+
* POST /v1/purchase_receipts/{id}/read
|
|
6891
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
|
|
6892
|
+
*/
|
|
6893
|
+
read(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6894
|
+
/**
|
|
6895
|
+
* Pedir la factura a la tienda
|
|
6896
|
+
*
|
|
6897
|
+
* 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).
|
|
6898
|
+
*
|
|
6899
|
+
* POST /v1/purchase_receipts/{id}/request
|
|
6900
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
|
|
6901
|
+
*/
|
|
6902
|
+
requestInvoice(id: string, params: RequestPurchaseReceiptInvoiceParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6903
|
+
/**
|
|
6904
|
+
* Ya llegó la factura
|
|
6905
|
+
*
|
|
6906
|
+
* 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.
|
|
6907
|
+
*
|
|
6908
|
+
* POST /v1/purchase_receipts/{id}/mark_invoiced
|
|
6909
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
|
|
6910
|
+
*/
|
|
6911
|
+
markInvoiced(id: string, params?: MarkPurchaseReceiptInvoicedParams, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6912
|
+
/**
|
|
6913
|
+
* Marcar como no deducible
|
|
6914
|
+
*
|
|
6915
|
+
* La tienda no dio factura: el gasto queda como no deducible.
|
|
6916
|
+
*
|
|
6917
|
+
* POST /v1/purchase_receipts/{id}/mark_non_deductible
|
|
6918
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
|
|
6919
|
+
*/
|
|
6920
|
+
markNonDeductible(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6921
|
+
/**
|
|
6922
|
+
* Volver a pedir la factura
|
|
6923
|
+
*
|
|
6924
|
+
* Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
|
|
6925
|
+
*
|
|
6926
|
+
* POST /v1/purchase_receipts/{id}/reopen
|
|
6927
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
|
|
6928
|
+
*/
|
|
6929
|
+
reopen(id: string, options?: RequestOptions): Promise<PurchaseReceipt>;
|
|
6930
|
+
}
|
|
6645
6931
|
/** Pagos y notas de crédito: fiscalisto.payments. */
|
|
6646
6932
|
export declare class PaymentsResource {
|
|
6647
6933
|
#private;
|
|
@@ -7589,7 +7875,7 @@ export declare class StoreConnectionsResource {
|
|
|
7589
7875
|
/**
|
|
7590
7876
|
* Conectar una tienda
|
|
7591
7877
|
*
|
|
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
|
|
7878
|
+
* 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
7879
|
*
|
|
7594
7880
|
* POST /v1/store_connections
|
|
7595
7881
|
* @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
|
|
@@ -7915,6 +8201,7 @@ export declare class FiscalistoApi extends Core {
|
|
|
7915
8201
|
readonly invoices: InvoicesResource;
|
|
7916
8202
|
readonly receivables: ReceivablesResource;
|
|
7917
8203
|
readonly bankTransactions: BankTransactionsResource;
|
|
8204
|
+
readonly purchaseReceipts: PurchaseReceiptsResource;
|
|
7918
8205
|
readonly payments: PaymentsResource;
|
|
7919
8206
|
readonly creditNotes: CreditNotesResource;
|
|
7920
8207
|
readonly advances: AdvancesResource;
|
package/dist/generated.js
CHANGED
|
@@ -580,6 +580,123 @@ export class BankTransactionsResource {
|
|
|
580
580
|
return this.#client.request({ method: "POST", path: `/v1/bank_transactions/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
|
|
581
581
|
}
|
|
582
582
|
}
|
|
583
|
+
/** Tickets de compra: fiscalisto.purchaseReceipts. */
|
|
584
|
+
export class PurchaseReceiptsResource {
|
|
585
|
+
#client;
|
|
586
|
+
constructor(client) {
|
|
587
|
+
this.#client = client;
|
|
588
|
+
}
|
|
589
|
+
/**
|
|
590
|
+
* Guardar un ticket de compra
|
|
591
|
+
*
|
|
592
|
+
* 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.
|
|
593
|
+
*
|
|
594
|
+
* POST /v1/purchase_receipts
|
|
595
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/create-purchase-receipt
|
|
596
|
+
*/
|
|
597
|
+
create(params, options) {
|
|
598
|
+
return this.#client.request({ method: "POST", path: "/v1/purchase_receipts", body: params, idempotent: true }, options);
|
|
599
|
+
}
|
|
600
|
+
/**
|
|
601
|
+
* Listar tickets de compra
|
|
602
|
+
*
|
|
603
|
+
* Los más recientes primero.
|
|
604
|
+
*
|
|
605
|
+
* GET /v1/purchase_receipts
|
|
606
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/list-purchase-receipts
|
|
607
|
+
*/
|
|
608
|
+
list(params, options) {
|
|
609
|
+
return this.#client.list({ path: "/v1/purchase_receipts", query: params }, options);
|
|
610
|
+
}
|
|
611
|
+
/**
|
|
612
|
+
* Ver un ticket de compra
|
|
613
|
+
*
|
|
614
|
+
* Con la factura recibida que lo cubre, si ya llegó.
|
|
615
|
+
*
|
|
616
|
+
* GET /v1/purchase_receipts/{id}
|
|
617
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/get-purchase-receipt
|
|
618
|
+
*/
|
|
619
|
+
get(id, options) {
|
|
620
|
+
return this.#client.request({ method: "GET", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
|
|
621
|
+
}
|
|
622
|
+
/**
|
|
623
|
+
* Corregir un ticket de compra
|
|
624
|
+
*
|
|
625
|
+
* 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.
|
|
626
|
+
*
|
|
627
|
+
* POST /v1/purchase_receipts/{id}
|
|
628
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/update-purchase-receipt
|
|
629
|
+
*/
|
|
630
|
+
update(id, params, options) {
|
|
631
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
|
|
632
|
+
}
|
|
633
|
+
/**
|
|
634
|
+
* Borrar un ticket de compra
|
|
635
|
+
*
|
|
636
|
+
* El ticket y su archivo, para siempre.
|
|
637
|
+
*
|
|
638
|
+
* DELETE /v1/purchase_receipts/{id}
|
|
639
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/delete-purchase-receipt
|
|
640
|
+
*/
|
|
641
|
+
delete(id, options) {
|
|
642
|
+
return this.#client.request({ method: "DELETE", path: `/v1/purchase_receipts/${encodeURIComponent(id)}` }, options);
|
|
643
|
+
}
|
|
644
|
+
/**
|
|
645
|
+
* Leer el ticket de nuevo
|
|
646
|
+
*
|
|
647
|
+
* 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.
|
|
648
|
+
*
|
|
649
|
+
* POST /v1/purchase_receipts/{id}/read
|
|
650
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/read-purchase-receipt
|
|
651
|
+
*/
|
|
652
|
+
read(id, options) {
|
|
653
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/read`, idempotent: true }, options);
|
|
654
|
+
}
|
|
655
|
+
/**
|
|
656
|
+
* Pedir la factura a la tienda
|
|
657
|
+
*
|
|
658
|
+
* 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).
|
|
659
|
+
*
|
|
660
|
+
* POST /v1/purchase_receipts/{id}/request
|
|
661
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/request-purchase-receipt-invoice
|
|
662
|
+
*/
|
|
663
|
+
requestInvoice(id, params, options) {
|
|
664
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/request`, body: params, idempotent: true }, options);
|
|
665
|
+
}
|
|
666
|
+
/**
|
|
667
|
+
* Ya llegó la factura
|
|
668
|
+
*
|
|
669
|
+
* 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.
|
|
670
|
+
*
|
|
671
|
+
* POST /v1/purchase_receipts/{id}/mark_invoiced
|
|
672
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-invoiced
|
|
673
|
+
*/
|
|
674
|
+
markInvoiced(id, params, options) {
|
|
675
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_invoiced`, body: params, idempotent: true }, options);
|
|
676
|
+
}
|
|
677
|
+
/**
|
|
678
|
+
* Marcar como no deducible
|
|
679
|
+
*
|
|
680
|
+
* La tienda no dio factura: el gasto queda como no deducible.
|
|
681
|
+
*
|
|
682
|
+
* POST /v1/purchase_receipts/{id}/mark_non_deductible
|
|
683
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/mark-purchase-receipt-non-deductible
|
|
684
|
+
*/
|
|
685
|
+
markNonDeductible(id, options) {
|
|
686
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/mark_non_deductible`, idempotent: true }, options);
|
|
687
|
+
}
|
|
688
|
+
/**
|
|
689
|
+
* Volver a pedir la factura
|
|
690
|
+
*
|
|
691
|
+
* Deshace mark_non_deductible o mark_invoiced: vuelve a requested si ya se había pedido, si no a pending.
|
|
692
|
+
*
|
|
693
|
+
* POST /v1/purchase_receipts/{id}/reopen
|
|
694
|
+
* @see https://fiscalisto.com/docs/api/referencia/tickets-de-compra/reopen-purchase-receipt
|
|
695
|
+
*/
|
|
696
|
+
reopen(id, options) {
|
|
697
|
+
return this.#client.request({ method: "POST", path: `/v1/purchase_receipts/${encodeURIComponent(id)}/reopen`, idempotent: true }, options);
|
|
698
|
+
}
|
|
699
|
+
}
|
|
583
700
|
/** Pagos y notas de crédito: fiscalisto.payments. */
|
|
584
701
|
export class PaymentsResource {
|
|
585
702
|
#client;
|
|
@@ -1761,7 +1878,7 @@ export class StoreConnectionsResource {
|
|
|
1761
1878
|
/**
|
|
1762
1879
|
* Conectar una tienda
|
|
1763
1880
|
*
|
|
1764
|
-
* 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
|
|
1881
|
+
* 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.
|
|
1765
1882
|
*
|
|
1766
1883
|
* POST /v1/store_connections
|
|
1767
1884
|
* @see https://fiscalisto.com/docs/api/referencia/tiendas-en-linea/create-store-connection
|
|
@@ -2161,6 +2278,7 @@ export class FiscalistoApi extends Core {
|
|
|
2161
2278
|
invoices = new InvoicesResource(this);
|
|
2162
2279
|
receivables = new ReceivablesResource(this);
|
|
2163
2280
|
bankTransactions = new BankTransactionsResource(this);
|
|
2281
|
+
purchaseReceipts = new PurchaseReceiptsResource(this);
|
|
2164
2282
|
payments = new PaymentsResource(this);
|
|
2165
2283
|
creditNotes = new CreditNotesResource(this);
|
|
2166
2284
|
advances = new AdvancesResource(this);
|