fiscalisto 0.1.57 → 0.1.59
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/generated.d.ts +300 -42
- package/dist/generated.js +39 -1
- package/dist/mock-routes.gen.js +1 -1
- package/package.json +1 -1
package/dist/generated.d.ts
CHANGED
|
@@ -341,6 +341,19 @@ export interface InvoicePayroll {
|
|
|
341
341
|
/** Importe. */
|
|
342
342
|
amount: number | null;
|
|
343
343
|
}[];
|
|
344
|
+
/** En un recibo que calculó Fiscalisto: los días del IMSS. */
|
|
345
|
+
imss_days?: {
|
|
346
|
+
/** Días naturales del periodo que trabajó para el patrón: las cuotas del IMSS se causan por mes calendario (LSS art. 39), no por los días pagados. */
|
|
347
|
+
calendar_days: number;
|
|
348
|
+
/** Faltas del recibo. */
|
|
349
|
+
absences: number;
|
|
350
|
+
/** Días de incapacidad del recibo. */
|
|
351
|
+
disability_days: number;
|
|
352
|
+
/** Días que cotiza en enfermedades y maternidad (excedente, prestaciones en dinero, gastos médicos de pensionados): el periodo sin la incapacidad; las faltas cuentan (LSS art. 31 fr. I). */
|
|
353
|
+
sickness_and_maternity: number;
|
|
354
|
+
/** Días que cotiza en invalidez y vida y en cesantía en edad avanzada y vejez: además sin las faltas, hasta 7 por mes. */
|
|
355
|
+
disability_and_old_age: number;
|
|
356
|
+
};
|
|
344
357
|
/** Totales: percepciones, deducciones, otros pagos y el neto a pagar. */
|
|
345
358
|
totals: {
|
|
346
359
|
/** Total de sueldos, salarios y asimilados (TotalSueldos). */
|
|
@@ -391,7 +404,7 @@ export interface Invoice {
|
|
|
391
404
|
uuid: string | null;
|
|
392
405
|
/** La serie (Serie) con que se timbró, o null. */
|
|
393
406
|
series: string | null;
|
|
394
|
-
/**
|
|
407
|
+
/** Folio interno. En una rechazada es el que se intentó: no se gasta, y el siguiente CFDI de la serie lo usa. */
|
|
395
408
|
folio: string | null;
|
|
396
409
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
397
410
|
date: string | null;
|
|
@@ -547,7 +560,7 @@ export interface Invoice {
|
|
|
547
560
|
created_at: string | null;
|
|
548
561
|
/** 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. */
|
|
549
562
|
metadata: Record<string, string>;
|
|
550
|
-
/** Avisos que
|
|
563
|
+
/** Avisos sobre la factura (solo en la respuesta que la timbra o, con 202, la que la deja en proceso): se timbra como se mandó. */
|
|
551
564
|
warnings?: string[];
|
|
552
565
|
/** Por qué no se pudo mandar el correo; el comprobante sí se timbró. */
|
|
553
566
|
email_error?: string;
|
|
@@ -611,7 +624,7 @@ export interface Retention {
|
|
|
611
624
|
internal_folio: string | null;
|
|
612
625
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
613
626
|
date: string | null;
|
|
614
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
627
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
615
628
|
code: string;
|
|
616
629
|
/** Descripción de la retención (DescRetenc). */
|
|
617
630
|
description: string | null;
|
|
@@ -663,11 +676,13 @@ export interface Retention {
|
|
|
663
676
|
dividends?: Record<string, unknown>;
|
|
664
677
|
/** Complemento de intereses. */
|
|
665
678
|
interest?: Record<string, unknown>;
|
|
666
|
-
/** Complemento de pagos a extranjeros. */
|
|
679
|
+
/** Complemento de pagos a extranjeros: obligatorio con code 18, y con 01, 02, 04 y 05 cuando el receptor es extranjero. */
|
|
667
680
|
foreign_payment?: Record<string, unknown>;
|
|
681
|
+
/** Complemento de dividendos con su nodo Remanente (remanente distribuible), obligatorio con code 15. Si no lo manda, va sin proporción. */
|
|
682
|
+
distributable_remainder?: Record<string, unknown>;
|
|
668
683
|
/** Complemento de arrendamiento en fideicomiso (Arrendamientoenfideicomiso 1.0), obligatorio con code 17. */
|
|
669
684
|
trust_lease?: Record<string, unknown>;
|
|
670
|
-
/** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 19. */
|
|
685
|
+
/** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 06 y 19. */
|
|
671
686
|
share_sale?: Record<string, unknown>;
|
|
672
687
|
/** Complemento de premios (Premios 1.0), obligatorio con code 20. Sus montos son los de totals. */
|
|
673
688
|
prize?: Record<string, unknown>;
|
|
@@ -744,7 +759,7 @@ export interface Customer {
|
|
|
744
759
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
745
760
|
tax_id: string | null;
|
|
746
761
|
} | null;
|
|
747
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
762
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
748
763
|
ieps_taxpayer: boolean;
|
|
749
764
|
/** Su grupo de clientes (cgr_…), o null si no está en ninguno. */
|
|
750
765
|
group: string | null;
|
|
@@ -773,7 +788,7 @@ export interface Product {
|
|
|
773
788
|
description: string;
|
|
774
789
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
775
790
|
product_key: string;
|
|
776
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
791
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
777
792
|
unit_key: string;
|
|
778
793
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
779
794
|
unit_name: string | null;
|
|
@@ -806,6 +821,15 @@ export interface Product {
|
|
|
806
821
|
/** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
|
|
807
822
|
rate: number;
|
|
808
823
|
}[];
|
|
824
|
+
/** Complemento de Hidrocarburos y Petrolíferos: obligatorio en cada concepto de diésel (15101505) o gasolina (15101514, 15101515) de una factura o nota de crédito, en litros (LTR). */
|
|
825
|
+
hydrocarbon: {
|
|
826
|
+
/** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
|
|
827
|
+
permit_type: string;
|
|
828
|
+
/** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
|
|
829
|
+
permit_number: string;
|
|
830
|
+
/** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
|
|
831
|
+
subproduct: string;
|
|
832
|
+
} | null;
|
|
809
833
|
/** true si lleva existencias (Inventario). */
|
|
810
834
|
track_stock: boolean;
|
|
811
835
|
/** Su costo por unidad en pesos sin IVA, o null. */
|
|
@@ -908,7 +932,7 @@ export interface PayrollReceiptPreview {
|
|
|
908
932
|
confirmation_token: string;
|
|
909
933
|
/** Lo que el recibo no incluye o pronto no se podrá calcular; no impide timbrar. */
|
|
910
934
|
warnings: {
|
|
911
|
-
/** finiquito_not_included: el empleado se fue en el periodo y el recibo no trae su finiquito; payroll_rates_pending: aún no se cargan los valores (ISR, subsidio, salario mínimo, UMA) de una fecha próxima. */
|
|
935
|
+
/** finiquito_not_included: el empleado se fue en el periodo y el recibo no trae su finiquito; absences_over_monthly_limit: con este recibo pasa de 7 faltas en el mes y las de más cotizan como días trabajados (para dejar de cotizar, presente su aviso de baja); payroll_rates_pending: aún no se cargan los valores (ISR, subsidio, salario mínimo, UMA) de una fecha próxima. */
|
|
912
936
|
code: string;
|
|
913
937
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
914
938
|
message: string;
|
|
@@ -928,6 +952,19 @@ export interface PayrollReceiptPreview {
|
|
|
928
952
|
};
|
|
929
953
|
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
930
954
|
days: number;
|
|
955
|
+
/** Los días por los que se calcularon las cuotas obreras del IMSS. */
|
|
956
|
+
imss_days: {
|
|
957
|
+
/** Días naturales del periodo que trabajó para el patrón: las cuotas del IMSS se causan por mes calendario (LSS art. 39), no por los días pagados. */
|
|
958
|
+
calendar_days: number;
|
|
959
|
+
/** Faltas del recibo. */
|
|
960
|
+
absences: number;
|
|
961
|
+
/** Días de incapacidad del recibo. */
|
|
962
|
+
disability_days: number;
|
|
963
|
+
/** Días que cotiza en enfermedades y maternidad (excedente, prestaciones en dinero, gastos médicos de pensionados): el periodo sin la incapacidad; las faltas cuentan (LSS art. 31 fr. I). */
|
|
964
|
+
sickness_and_maternity: number;
|
|
965
|
+
/** Días que cotiza en invalidez y vida y en cesantía en edad avanzada y vejez: además sin las faltas, hasta 7 por mes. */
|
|
966
|
+
disability_and_old_age: number;
|
|
967
|
+
};
|
|
931
968
|
/** Salario base de cotización (SalarioBaseCotApor). */
|
|
932
969
|
contribution_base_salary: number;
|
|
933
970
|
/** Percepciones (Percepcion): sueldo y demás, gravado y exento. */
|
|
@@ -1071,7 +1108,7 @@ export interface ExternalPayrollReceiptPreview {
|
|
|
1071
1108
|
warnings: {
|
|
1072
1109
|
/** El campo de la solicitud. */
|
|
1073
1110
|
param: string;
|
|
1074
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
1111
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
1075
1112
|
code: string;
|
|
1076
1113
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
1077
1114
|
message: string;
|
|
@@ -1145,7 +1182,7 @@ export interface InvoicePreview {
|
|
|
1145
1182
|
total: number;
|
|
1146
1183
|
/** Lo que conviene revisar antes de timbrar (un cliente en las listas 69 o 69-B del SAT, una factura que parece duplicada); no impide timbrar. */
|
|
1147
1184
|
warnings: {
|
|
1148
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
1185
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
1149
1186
|
code: string;
|
|
1150
1187
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
1151
1188
|
message: string;
|
|
@@ -1360,6 +1397,8 @@ export interface InvoiceBatch {
|
|
|
1360
1397
|
total: number;
|
|
1361
1398
|
/** Por qué no se timbró. */
|
|
1362
1399
|
error: string | null;
|
|
1400
|
+
/** Solo en la respuesta de POST /v1/invoice_batches: los avisos de esta factura antes de timbrarla, los mismos que daría POST /v1/invoices. Se timbra como se mandó. */
|
|
1401
|
+
warnings?: string[];
|
|
1363
1402
|
}[];
|
|
1364
1403
|
}
|
|
1365
1404
|
/** Una nómina completa (hasta 1,000 recibos) timbrada en segundo plano. */
|
|
@@ -1625,7 +1664,7 @@ export interface CfdiSeals {
|
|
|
1625
1664
|
} | null;
|
|
1626
1665
|
/** Cada problema, con su código y qué significa. Vacía si valid es true. */
|
|
1627
1666
|
problems: {
|
|
1628
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
1667
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
1629
1668
|
code: "malformed_xml" | "missing_seal" | "certificate_unreadable" | "certificate_number_mismatch" | "certificate_not_issuer" | "certificate_not_csd" | "certificate_not_valid_at_issue" | "seal_mismatch" | "stamp_not_for_this_seal" | "sat_seal_mismatch";
|
|
1630
1669
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
1631
1670
|
message: string;
|
|
@@ -2811,6 +2850,8 @@ export interface SatFinding {
|
|
|
2811
2850
|
title: string;
|
|
2812
2851
|
/** Por qué importa y qué hacer, o null. */
|
|
2813
2852
|
explanation: string | null;
|
|
2853
|
+
/** Qué hacer con este hallazgo, en una frase o dos. */
|
|
2854
|
+
next_step: string;
|
|
2814
2855
|
/** Cuántos CFDI lo tienen, sin revisar. */
|
|
2815
2856
|
invoices: number;
|
|
2816
2857
|
/** De cuántos proveedores o clientes son esos CFDI. */
|
|
@@ -2852,6 +2893,102 @@ export interface SatFindingCounterparty {
|
|
|
2852
2893
|
title: string;
|
|
2853
2894
|
/** En cuántos de sus CFDI está, sin revisar. */
|
|
2854
2895
|
invoices: number;
|
|
2896
|
+
/** Qué hacer con este hallazgo, en una frase o dos. */
|
|
2897
|
+
next_step: string;
|
|
2898
|
+
}[];
|
|
2899
|
+
}
|
|
2900
|
+
/** Un proveedor del emisor en el periodo: cuánto le facturó, cuánto de eso tiene su evidencia completa (acuerdo, entrega y pago) y, si está en la lista 69-B, su plazo. */
|
|
2901
|
+
export interface MaterialitySupplier {
|
|
2902
|
+
/** Su RFC (el mismo que tax_id). */
|
|
2903
|
+
id: string;
|
|
2904
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
2905
|
+
livemode: boolean;
|
|
2906
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2907
|
+
object: "materiality_supplier";
|
|
2908
|
+
/** El emisor que recibió sus facturas. */
|
|
2909
|
+
issuer: string;
|
|
2910
|
+
/** El RFC del proveedor. */
|
|
2911
|
+
tax_id: string;
|
|
2912
|
+
/** Su nombre como viene en el CFDI, o null. */
|
|
2913
|
+
name: string | null;
|
|
2914
|
+
/** Cuántas facturas recibidas (ingresos, no canceladas) le dio en el periodo. */
|
|
2915
|
+
invoices: number;
|
|
2916
|
+
/** Lo que suman, en pesos (las de otra moneda, a su tipo de cambio). */
|
|
2917
|
+
total: number;
|
|
2918
|
+
/** Lo que suman las que no tienen su evidencia completa, en pesos. */
|
|
2919
|
+
unproven: number;
|
|
2920
|
+
/** Cuántas facturas están complete (acuerdo, entrega y pago), partial (alguna) y none (ninguna). */
|
|
2921
|
+
states: {
|
|
2922
|
+
/** Facturas con acuerdo, entrega y pago. */
|
|
2923
|
+
complete: number;
|
|
2924
|
+
/** Facturas con alguna de las tres pruebas, no todas. */
|
|
2925
|
+
partial: number;
|
|
2926
|
+
/** Facturas sin ninguna prueba. */
|
|
2927
|
+
none: number;
|
|
2928
|
+
};
|
|
2929
|
+
/** A cuántas facturas les falta el acuerdo, la entrega y el pago. */
|
|
2930
|
+
missing: {
|
|
2931
|
+
/** Facturas sin acuerdo (contrato u orden de compra). */
|
|
2932
|
+
agreement: number;
|
|
2933
|
+
/** Facturas sin entrega (recepción, entregables o fotos). */
|
|
2934
|
+
delivery: number;
|
|
2935
|
+
/** Facturas sin pago (complemento, pago en el portal o en la orden, banco o comprobante). */
|
|
2936
|
+
payment: number;
|
|
2937
|
+
};
|
|
2938
|
+
/** Si está en la lista 69-B: definitive (definitivo) o presumed (presunto); en definitivo, el día que se publicó, el último día de los 30 días hábiles para acreditar las operaciones o corregir y cuántos días hábiles quedan (negativo: ya venció). null: no está. */
|
|
2939
|
+
sat_list: {
|
|
2940
|
+
/** definitive (69-B definitivo) o presumed (69-B presunto). */
|
|
2941
|
+
status: "definitive" | "presumed";
|
|
2942
|
+
/** El día que el SAT lo publicó como definitivo (AAAA-MM-DD), o null. */
|
|
2943
|
+
published_on: string | null;
|
|
2944
|
+
/** El último de los 30 días hábiles para acreditar las operaciones o corregir (AAAA-MM-DD), o null. */
|
|
2945
|
+
deadline: string | null;
|
|
2946
|
+
/** Días hábiles que quedan, sin contar hoy; negativo si ya venció. null si no es definitivo. */
|
|
2947
|
+
business_days_left: number | null;
|
|
2948
|
+
} | null;
|
|
2949
|
+
/** Si está en el Portal de proveedores del emisor (para pedirle la evidencia desde la app). */
|
|
2950
|
+
in_supplier_portal: boolean;
|
|
2951
|
+
/** Cuándo se le pidió evidencia que todavía no manda, o null. */
|
|
2952
|
+
evidence_requested_at: string | null;
|
|
2953
|
+
}
|
|
2954
|
+
/** Una factura recibida (ingreso) con lo que prueba que la operación existió: qué tiene, qué le falta y de dónde salió cada evidencia. */
|
|
2955
|
+
export interface MaterialityInvoice {
|
|
2956
|
+
/** El UUID de la factura (el mismo que uuid). */
|
|
2957
|
+
id: string;
|
|
2958
|
+
/** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
|
|
2959
|
+
livemode: boolean;
|
|
2960
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
2961
|
+
object: "materiality_invoice";
|
|
2962
|
+
/** El emisor que la recibió. */
|
|
2963
|
+
issuer: string;
|
|
2964
|
+
/** El folio fiscal (UUID). */
|
|
2965
|
+
uuid: string;
|
|
2966
|
+
/** Su serie, o null. */
|
|
2967
|
+
series: string | null;
|
|
2968
|
+
/** Su folio, o null. */
|
|
2969
|
+
folio: string | null;
|
|
2970
|
+
/** Su fecha (AAAA-MM-DD). */
|
|
2971
|
+
date: string;
|
|
2972
|
+
/** El RFC del proveedor que la emitió. */
|
|
2973
|
+
supplier_tax_id: string;
|
|
2974
|
+
/** Su nombre como viene en el CFDI, o null. */
|
|
2975
|
+
supplier_name: string | null;
|
|
2976
|
+
/** Su total en pesos (de otra moneda, a su tipo de cambio). */
|
|
2977
|
+
total: number;
|
|
2978
|
+
/** complete (tiene acuerdo, entrega y pago), partial (alguno) o none (ninguno). */
|
|
2979
|
+
state: "complete" | "partial" | "none";
|
|
2980
|
+
/** Lo que ya tiene: agreement (contrato u orden de compra), delivery (recepción, entregables o fotos), payment (complemento, pago en el portal o en la orden, banco o comprobante). */
|
|
2981
|
+
has: ("agreement" | "delivery" | "payment")[];
|
|
2982
|
+
/** Lo que le falta, de lo mismo. */
|
|
2983
|
+
missing: ("agreement" | "delivery" | "payment")[];
|
|
2984
|
+
/** De dónde salió cada evidencia: source es un código estable (orden_compra, recepcion, complemento_pago, pago_banco, foto, mensaje_portal…), proves lo que prueba (null: respaldo que no prueba nada solo) y label lo dice en palabras. */
|
|
2985
|
+
evidence: {
|
|
2986
|
+
/** De dónde salió: orden_compra, recepcion, complemento_pago, pago_banco, foto, mensaje_portal… */
|
|
2987
|
+
source: string;
|
|
2988
|
+
/** Lo que prueba: agreement, delivery o payment; null si solo respalda. */
|
|
2989
|
+
proves: "agreement" | "delivery" | "payment" | null;
|
|
2990
|
+
/** De dónde salió, en palabras. */
|
|
2991
|
+
label: string;
|
|
2855
2992
|
}[];
|
|
2856
2993
|
}
|
|
2857
2994
|
/** Una venta que su comprador puede facturar él mismo en el portal del emisor (autofactura). */
|
|
@@ -2890,7 +3027,7 @@ export interface Ticket {
|
|
|
2890
3027
|
description: string;
|
|
2891
3028
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
2892
3029
|
product_key: string;
|
|
2893
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
3030
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
2894
3031
|
unit_key: string;
|
|
2895
3032
|
/** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
|
|
2896
3033
|
iva: string | null;
|
|
@@ -2956,6 +3093,10 @@ export interface SelfInvoicing {
|
|
|
2956
3093
|
portal_accent: string | null;
|
|
2957
3094
|
/** Las esquinas del portal en píxeles (0 a 24), o null para las de Fiscalisto. */
|
|
2958
3095
|
portal_radius: number | null;
|
|
3096
|
+
/** Cuando se factura una persona moral que retiene (1.25% de ISR en RESICO, o lo del producto). keep_total: la base crece y la factura suma lo que se pagó. subtract: la base es la del ticket y el total es lo pagado menos la retención. */
|
|
3097
|
+
retention_mode: "keep_total" | "subtract";
|
|
3098
|
+
/** ticket: la factura global lleva un concepto «Venta» por ticket, con su folio. summary: solo el monto total del periodo, uno por combinación de impuestos (NoIdentificacion «Resumen»), para una persona física en RESICO (regla 2.7.1.21 de la RMF 2026). */
|
|
3099
|
+
global_concepts: "ticket" | "summary";
|
|
2959
3100
|
}
|
|
2960
3101
|
/** Una factura que el emisor timbra solo, cada mes, semana o día. */
|
|
2961
3102
|
export interface RecurringInvoice {
|
|
@@ -3016,7 +3157,7 @@ export interface RecurringInvoice {
|
|
|
3016
3157
|
product_key: string;
|
|
3017
3158
|
/** Cantidad (Cantidad). Por omisión 1. */
|
|
3018
3159
|
quantity?: number;
|
|
3019
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
3160
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
3020
3161
|
unit_key?: string;
|
|
3021
3162
|
/** Precio unitario antes de impuestos (ValorUnitario). */
|
|
3022
3163
|
unit_price: number;
|
|
@@ -3656,7 +3797,7 @@ export interface Quote {
|
|
|
3656
3797
|
product_key: string;
|
|
3657
3798
|
/** Cantidad (Cantidad). Por omisión 1. */
|
|
3658
3799
|
quantity?: number;
|
|
3659
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
3800
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
3660
3801
|
unit_key?: string;
|
|
3661
3802
|
/** Precio unitario antes de impuestos (ValorUnitario). */
|
|
3662
3803
|
unit_price: number;
|
|
@@ -3939,7 +4080,7 @@ export interface SupplierInvoice {
|
|
|
3939
4080
|
rejection_reason: string | null;
|
|
3940
4081
|
/** Lo que se revisó y quedó como aviso (code y message), para que su equipo lo vea. */
|
|
3941
4082
|
warnings: {
|
|
3942
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
4083
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
3943
4084
|
code: string;
|
|
3944
4085
|
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
3945
4086
|
message: string;
|
|
@@ -4377,7 +4518,7 @@ export interface CfdiVerification {
|
|
|
4377
4518
|
issuer_efos: boolean | null;
|
|
4378
4519
|
/** La respuesta del SAT tal cual (CodigoEstatus, Estado, EsCancelable, EstatusCancelacion, ValidacionEFOS), por si la necesita igual que el SAT. */
|
|
4379
4520
|
sat: {
|
|
4380
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
4521
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
4381
4522
|
code: string;
|
|
4382
4523
|
/** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
|
|
4383
4524
|
state: string;
|
|
@@ -4708,6 +4849,26 @@ export interface SatFindingCounterpartyList {
|
|
|
4708
4849
|
/** La ruta de esta lista. */
|
|
4709
4850
|
url: string;
|
|
4710
4851
|
}
|
|
4852
|
+
export interface MaterialitySupplierList {
|
|
4853
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4854
|
+
object: "list";
|
|
4855
|
+
/** Los objetos de esta página. */
|
|
4856
|
+
data: MaterialitySupplier[];
|
|
4857
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
4858
|
+
has_more: boolean;
|
|
4859
|
+
/** La ruta de esta lista. */
|
|
4860
|
+
url: string;
|
|
4861
|
+
}
|
|
4862
|
+
export interface MaterialityInvoiceList {
|
|
4863
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4864
|
+
object: "list";
|
|
4865
|
+
/** Los objetos de esta página. */
|
|
4866
|
+
data: MaterialityInvoice[];
|
|
4867
|
+
/** true si hay más: pida la siguiente con starting_after igual al id del último. */
|
|
4868
|
+
has_more: boolean;
|
|
4869
|
+
/** La ruta de esta lista. */
|
|
4870
|
+
url: string;
|
|
4871
|
+
}
|
|
4711
4872
|
export interface WarehouseList {
|
|
4712
4873
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
4713
4874
|
object: "list";
|
|
@@ -5007,7 +5168,7 @@ export interface InvoiceCreate {
|
|
|
5007
5168
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
5008
5169
|
tax_id: string;
|
|
5009
5170
|
};
|
|
5010
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
5171
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
5011
5172
|
ieps_taxpayer?: boolean;
|
|
5012
5173
|
};
|
|
5013
5174
|
/** Conceptos (Conceptos), al menos uno. */
|
|
@@ -5018,7 +5179,7 @@ export interface InvoiceCreate {
|
|
|
5018
5179
|
description?: string;
|
|
5019
5180
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
5020
5181
|
product_key?: string;
|
|
5021
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
5182
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
5022
5183
|
unit_key?: string;
|
|
5023
5184
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
5024
5185
|
unit_name?: string | null;
|
|
@@ -5602,6 +5763,8 @@ export interface InvoiceCreate {
|
|
|
5602
5763
|
};
|
|
5603
5764
|
}[];
|
|
5604
5765
|
};
|
|
5766
|
+
/** Solo en un traslado (type T) sin carta_porte: la regla de la RMF 2026 que lo permite. 2.7.7.2.1 mercancías propias en un traslado local (no medicamentos, hidrocarburos ni mercancías para despacho aduanero); 2.7.7.2.2 paquetería o mensajería en primera o última milla, un concepto por paquete con su número de guía en sku; 2.7.7.2.3 grúa de arrastre o salvamento local, relacionando con related (05) la factura de ingreso del servicio. Mandarlo es declarar que el traslado no transita por ningún tramo de jurisdicción federal. Los conceptos van con unit_price 0 y taxability 01 (por omisión en un traslado). */
|
|
5767
|
+
carta_porte_exemption?: "2.7.7.2.1" | "2.7.7.2.2" | "2.7.7.2.3";
|
|
5605
5768
|
/** Complemento INE (procesos electorales). */
|
|
5606
5769
|
ine?: {
|
|
5607
5770
|
/** Tipo de proceso (TipoProceso): Ordinario, Precampaña o Campaña. */
|
|
@@ -5612,7 +5775,7 @@ export interface InvoiceCreate {
|
|
|
5612
5775
|
accounting_id?: string;
|
|
5613
5776
|
/** Entidades (Entidad): clave del estado, ámbito y claves de contabilidad. */
|
|
5614
5777
|
entities?: {
|
|
5615
|
-
/** Clave de la entidad (ClaveEntidad),
|
|
5778
|
+
/** Clave de la entidad (ClaveEntidad): la del estado (JAL, QUE…), NAC (nacional) o la circunscripción CR1 a CR5; estas seis no van con ámbito Local. */
|
|
5616
5779
|
key: string;
|
|
5617
5780
|
/** Ámbito (Ambito): Local o Federal. */
|
|
5618
5781
|
scope?: "Local" | "Federal";
|
|
@@ -5647,12 +5810,12 @@ export interface InvoiceCreate {
|
|
|
5647
5810
|
/** Importe del impuesto local. */
|
|
5648
5811
|
amount: number;
|
|
5649
5812
|
}[];
|
|
5650
|
-
/** Exportación (Exportacion), c_Exportacion: 01 no aplica (por omisión), 02 definitiva
|
|
5813
|
+
/** Exportación (Exportacion), c_Exportacion: 01 no aplica (por omisión), 02 definitiva con clave A1 (lleva comercio_exterior), 03 temporal (sin él), 04 definitiva con clave distinta a A1 o sin enajenación (con o sin comercio_exterior; con él, incoterm opcional). */
|
|
5651
5814
|
export?: "01" | "02" | "03" | "04";
|
|
5652
5815
|
/** Complemento de comercio exterior 2.0. */
|
|
5653
5816
|
comercio_exterior?: {
|
|
5654
|
-
/** Motivo de traslado (MotivoTraslado):
|
|
5655
|
-
motive?: "05";
|
|
5817
|
+
/** Motivo de traslado (MotivoTraslado), c_MotivoTraslado, solo en un traslado: 01 mercancías facturadas con anterioridad (relacione la factura de venta en related), 02 reubicación de mercancías propias, 03 consignación, 04 para posterior enajenación, 05 propiedad de terceros (con owners), 99 otros. */
|
|
5818
|
+
motive?: "99" | "01" | "02" | "03" | "04" | "05";
|
|
5656
5819
|
/** Propietarios de la mercancía si no es el emisor (Propietario), con motive 05. */
|
|
5657
5820
|
owners?: {
|
|
5658
5821
|
/** Número de registro tributario del propietario (NumRegIdTrib). */
|
|
@@ -5838,7 +6001,7 @@ export interface ExternalPayrollReceiptCreate {
|
|
|
5838
6001
|
};
|
|
5839
6002
|
/** El empleado (Receptor y Nomina/Receptor) con los datos de su sistema de nómina; no usa ni cambia los empleados de Fiscalisto. */
|
|
5840
6003
|
employee: {
|
|
5841
|
-
/** RFC
|
|
6004
|
+
/** RFC del empleado. XAXX010101000 si falleció: con su nombre y su CURP. */
|
|
5842
6005
|
tax_id: string;
|
|
5843
6006
|
/** Nombre. */
|
|
5844
6007
|
name: string;
|
|
@@ -6423,7 +6586,7 @@ export interface CreateAdvanceParams {
|
|
|
6423
6586
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
6424
6587
|
tax_id: string;
|
|
6425
6588
|
};
|
|
6426
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
6589
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
6427
6590
|
ieps_taxpayer?: boolean;
|
|
6428
6591
|
};
|
|
6429
6592
|
/** Uso del CFDI (UsoCFDI), clave de c_UsoCFDI. Por omisión G03, o S01 con régimen 616. */
|
|
@@ -6471,7 +6634,7 @@ export type ApplyAdvanceParams = {
|
|
|
6471
6634
|
export interface CreateRetentionParams {
|
|
6472
6635
|
/** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
|
|
6473
6636
|
issuer?: string;
|
|
6474
|
-
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves
|
|
6637
|
+
/** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 06, 14 a 24 llevan su complemento, como lo pide el catálogo del SAT (share_sale con 06 y 19, dividends con 14, distributable_remainder con 15, interest, trust_lease, foreign_payment, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); 01, 02, 04 y 05 llevan foreign_payment cuando el receptor es extranjero; la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. 27 y 28 no se pueden emitir aquí. */
|
|
6475
6638
|
code: string;
|
|
6476
6639
|
/** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
|
|
6477
6640
|
description?: string | null;
|
|
@@ -6593,7 +6756,7 @@ export interface CreateRetentionParams {
|
|
|
6593
6756
|
/** Pérdida (Perdida). */
|
|
6594
6757
|
loss: number;
|
|
6595
6758
|
};
|
|
6596
|
-
/** Complemento de pagos a extranjeros. */
|
|
6759
|
+
/** Complemento de pagos a extranjeros: obligatorio con code 18, y con 01, 02, 04 y 05 cuando el receptor es extranjero. */
|
|
6597
6760
|
foreign_payment?: {
|
|
6598
6761
|
/** true si quien recibe es el beneficiario efectivo (EsBenefEfectDelCobro). */
|
|
6599
6762
|
beneficiary: boolean;
|
|
@@ -6610,6 +6773,11 @@ export interface CreateRetentionParams {
|
|
|
6610
6773
|
/** Nombre o razón social del beneficiario (NomDenRazSocB). */
|
|
6611
6774
|
beneficiary_name?: string | null;
|
|
6612
6775
|
};
|
|
6776
|
+
/** Complemento de dividendos con su nodo Remanente (remanente distribuible), obligatorio con code 15. Si no lo manda, va sin proporción. */
|
|
6777
|
+
distributable_remainder?: {
|
|
6778
|
+
/** Porcentaje de participación del integrante o socio en el remanente (ProporcionRem), opcional. */
|
|
6779
|
+
proportion?: number | null;
|
|
6780
|
+
};
|
|
6613
6781
|
/** Complemento de arrendamiento en fideicomiso (Arrendamientoenfideicomiso 1.0), obligatorio con code 17. */
|
|
6614
6782
|
trust_lease?: {
|
|
6615
6783
|
/** Pago provisional que el fiduciario efectuó al arrendador en el periodo (PagProvEfecPorFiduc). */
|
|
@@ -6627,7 +6795,7 @@ export interface CreateRetentionParams {
|
|
|
6627
6795
|
/** Qué son los otros conceptos distribuidos (DescrMontOtrosConceptDistr); obligatoria con other_amount. */
|
|
6628
6796
|
other_description?: string | null;
|
|
6629
6797
|
};
|
|
6630
|
-
/** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 19. */
|
|
6798
|
+
/** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 06 y 19. */
|
|
6631
6799
|
share_sale?: {
|
|
6632
6800
|
/** Descripción del contrato de intermediación (ContratoIntermediacion). */
|
|
6633
6801
|
contract: string;
|
|
@@ -6923,6 +7091,10 @@ export interface CreatePayrollReceiptParams {
|
|
|
6923
7091
|
};
|
|
6924
7092
|
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
6925
7093
|
days?: number;
|
|
7094
|
+
/** Faltas del periodo (días sin goce de sueldo), de 0 a 31: no se pagan (salen de days) y cotizan al IMSS solo en enfermedades y maternidad, hasta 7 por mes (LSS art. 31 fr. I). */
|
|
7095
|
+
absences?: number;
|
|
7096
|
+
/** Días de incapacidad que expidió el IMSS en el periodo, de 0 a 31: no se pagan (salen de days) y no causan cuotas obreras del IMSS (LSS art. 31 fr. IV). */
|
|
7097
|
+
disability_days?: number;
|
|
6926
7098
|
/** El recibo vigente (inv_… o UUID) que este corrige, calculado por Fiscalisto para el mismo empleado: el nuevo se calcula con los datos del empleado como están ahora, va relacionado con 04 y el anterior se cancela con motivo 01. Para un recibo que calculó su sistema use POST /v1/payroll_receipts/external con replaces. */
|
|
6927
7099
|
replaces?: string;
|
|
6928
7100
|
/** true para mandar el PDF y el XML por correo al timbrar, con el diseño de Fiscalisto. Por omisión no se envía. */
|
|
@@ -6946,6 +7118,10 @@ export interface PreviewPayrollReceiptParams {
|
|
|
6946
7118
|
};
|
|
6947
7119
|
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
6948
7120
|
days?: number;
|
|
7121
|
+
/** Faltas del periodo (días sin goce de sueldo), de 0 a 31: no se pagan (salen de days) y cotizan al IMSS solo en enfermedades y maternidad, hasta 7 por mes (LSS art. 31 fr. I). */
|
|
7122
|
+
absences?: number;
|
|
7123
|
+
/** Días de incapacidad que expidió el IMSS en el periodo, de 0 a 31: no se pagan (salen de days) y no causan cuotas obreras del IMSS (LSS art. 31 fr. IV). */
|
|
7124
|
+
disability_days?: number;
|
|
6949
7125
|
/** El recibo vigente (inv_… o UUID) que este corrige, calculado por Fiscalisto para el mismo empleado: el nuevo se calcula con los datos del empleado como están ahora, va relacionado con 04 y el anterior se cancela con motivo 01. Para un recibo que calculó su sistema use POST /v1/payroll_receipts/external con replaces. */
|
|
6950
7126
|
replaces?: string;
|
|
6951
7127
|
/** true para mandar el PDF y el XML por correo al timbrar, con el diseño de Fiscalisto. Por omisión no se envía. */
|
|
@@ -6982,8 +7158,12 @@ export interface CreatePayrollBatchParams {
|
|
|
6982
7158
|
/** Día de pago (FechaPago); sin él, el último día del periodo. */
|
|
6983
7159
|
payment_date?: string;
|
|
6984
7160
|
};
|
|
6985
|
-
/** Días pagados; sin él, todos los días que le tocan del periodo. */
|
|
7161
|
+
/** Días pagados; sin él, todos los días que le tocan del periodo menos absences y disability_days. */
|
|
6986
7162
|
days?: number;
|
|
7163
|
+
/** Faltas del periodo (días sin goce de sueldo), de 0 a 31: no se pagan (salen de days) y cotizan al IMSS solo en enfermedades y maternidad, hasta 7 por mes (LSS art. 31 fr. I). */
|
|
7164
|
+
absences?: number;
|
|
7165
|
+
/** Días de incapacidad que expidió el IMSS en el periodo, de 0 a 31: no se pagan (salen de days) y no causan cuotas obreras del IMSS (LSS art. 31 fr. IV). */
|
|
7166
|
+
disability_days?: number;
|
|
6987
7167
|
/** Mandarle su recibo por correo; sin él, lo que diga send_email del lote. Con true el empleado debe tener correo. */
|
|
6988
7168
|
send_email?: boolean;
|
|
6989
7169
|
/** Su identificador de este recibo, hasta 100 caracteres. */
|
|
@@ -7595,7 +7775,7 @@ export interface CreateCustomerParams {
|
|
|
7595
7775
|
price_list?: string | null;
|
|
7596
7776
|
/** Su propio descuento en cada concepto, en %; null: el de su grupo. */
|
|
7597
7777
|
discount_percent?: number | null;
|
|
7598
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
7778
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
7599
7779
|
ieps_taxpayer?: boolean;
|
|
7600
7780
|
}
|
|
7601
7781
|
/** Los parámetros de GET /v1/customers. */
|
|
@@ -7635,7 +7815,7 @@ export interface UpdateCustomerParams {
|
|
|
7635
7815
|
price_list?: string | null;
|
|
7636
7816
|
/** Su propio descuento en cada concepto, en %; null: el de su grupo. */
|
|
7637
7817
|
discount_percent?: number | null;
|
|
7638
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
7818
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
7639
7819
|
ieps_taxpayer?: boolean;
|
|
7640
7820
|
}
|
|
7641
7821
|
export interface CreateCustomerDataRequestParams {
|
|
@@ -7666,7 +7846,7 @@ export interface CreateProductParams {
|
|
|
7666
7846
|
description: string;
|
|
7667
7847
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
7668
7848
|
product_key: string;
|
|
7669
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
7849
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
7670
7850
|
unit_key?: string;
|
|
7671
7851
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
7672
7852
|
unit_name?: string | null;
|
|
@@ -7697,6 +7877,15 @@ export interface CreateProductParams {
|
|
|
7697
7877
|
/** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
|
|
7698
7878
|
rate: number;
|
|
7699
7879
|
}[];
|
|
7880
|
+
/** Diésel (15101505) y gasolinas (15101514, 15101515): el permiso de la CNE que lleva cada factura con él en el complemento de Hidrocarburos y Petrolíferos. Una factura cuyo concepto trae su propio hydrocarbon usa ese. null lo quita. */
|
|
7881
|
+
hydrocarbon?: {
|
|
7882
|
+
/** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
|
|
7883
|
+
permit_type: string;
|
|
7884
|
+
/** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
|
|
7885
|
+
permit_number: string;
|
|
7886
|
+
/** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
|
|
7887
|
+
subproduct?: string;
|
|
7888
|
+
} | null;
|
|
7700
7889
|
/** Lleva existencias (Inventario): cada factura que lo vende las saca del almacén de su sucursal, y una cancelada las regresa. Ver GET /v1/products/{id}/stock. */
|
|
7701
7890
|
track_stock?: boolean;
|
|
7702
7891
|
/** Su costo por unidad en pesos sin IVA, hasta que sus compras den otro: vale las existencias que entran sin unit_cost. */
|
|
@@ -7736,7 +7925,7 @@ export interface UpdateProductParams {
|
|
|
7736
7925
|
description?: string;
|
|
7737
7926
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
7738
7927
|
product_key?: string;
|
|
7739
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
7928
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
7740
7929
|
unit_key?: string;
|
|
7741
7930
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
7742
7931
|
unit_name?: string | null;
|
|
@@ -7767,6 +7956,15 @@ export interface UpdateProductParams {
|
|
|
7767
7956
|
/** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
|
|
7768
7957
|
rate: number;
|
|
7769
7958
|
}[];
|
|
7959
|
+
/** Diésel (15101505) y gasolinas (15101514, 15101515): el permiso de la CNE que lleva cada factura con él en el complemento de Hidrocarburos y Petrolíferos. Una factura cuyo concepto trae su propio hydrocarbon usa ese. null lo quita. */
|
|
7960
|
+
hydrocarbon?: {
|
|
7961
|
+
/** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
|
|
7962
|
+
permit_type: string;
|
|
7963
|
+
/** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
|
|
7964
|
+
permit_number: string;
|
|
7965
|
+
/** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
|
|
7966
|
+
subproduct?: string;
|
|
7967
|
+
} | null;
|
|
7770
7968
|
/** Lleva existencias (Inventario): cada factura que lo vende las saca del almacén de su sucursal, y una cancelada las regresa. Ver GET /v1/products/{id}/stock. */
|
|
7771
7969
|
track_stock?: boolean;
|
|
7772
7970
|
/** Su costo por unidad en pesos sin IVA, hasta que sus compras den otro: vale las existencias que entran sin unit_cost. */
|
|
@@ -7829,6 +8027,30 @@ export interface ListSatFindingCounterpartiesParams {
|
|
|
7829
8027
|
/** Solo quienes tienen este hallazgo (efos_definitivo, cancelado, regla_12…; el code de GET /v1/sat_findings). */
|
|
7830
8028
|
code?: string;
|
|
7831
8029
|
}
|
|
8030
|
+
/** Los parámetros de GET /v1/materiality_suppliers. */
|
|
8031
|
+
export interface ListMaterialitySuppliersParams {
|
|
8032
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
8033
|
+
issuer?: string;
|
|
8034
|
+
/** Facturas desde este día (AAAA-MM-DD). */
|
|
8035
|
+
date_gte?: string;
|
|
8036
|
+
/** Facturas hasta este día (AAAA-MM-DD, completo). */
|
|
8037
|
+
date_lte?: string;
|
|
8038
|
+
/** Solo este proveedor (su RFC). */
|
|
8039
|
+
supplier_tax_id?: string;
|
|
8040
|
+
}
|
|
8041
|
+
/** Los parámetros de GET /v1/materiality_invoices. */
|
|
8042
|
+
export interface ListMaterialityInvoicesParams {
|
|
8043
|
+
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
8044
|
+
issuer?: string;
|
|
8045
|
+
/** Facturas desde este día (AAAA-MM-DD). */
|
|
8046
|
+
date_gte?: string;
|
|
8047
|
+
/** Facturas hasta este día (AAAA-MM-DD, completo). */
|
|
8048
|
+
date_lte?: string;
|
|
8049
|
+
/** Solo las de este proveedor (su RFC). */
|
|
8050
|
+
supplier_tax_id?: string;
|
|
8051
|
+
/** Solo las de este estado: complete, partial o none. Sin él, las que no están completas. */
|
|
8052
|
+
state?: "complete" | "partial" | "none";
|
|
8053
|
+
}
|
|
7832
8054
|
/** Los parámetros de GET /v1/warehouses. */
|
|
7833
8055
|
export interface ListWarehousesParams {
|
|
7834
8056
|
/** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
|
|
@@ -8251,6 +8473,10 @@ export interface UpdateSelfInvoicingParams {
|
|
|
8251
8473
|
portal_accent?: string | null;
|
|
8252
8474
|
/** Lo redondo de las esquinas del portal, en píxeles (0 a 24). `null` pone el de Fiscalisto (10). */
|
|
8253
8475
|
portal_radius?: number | null;
|
|
8476
|
+
/** Cuando se factura una persona moral y retiene (1.25% de ISR a un emisor en RESICO, artículo 113-J de la LISR, o lo que diga el producto): `keep_total` (por omisión), la base crece para que la factura sume lo que se pagó; `subtract`, la base es la del ticket y la retención se resta, así que el total de la factura es menor a lo pagado. */
|
|
8477
|
+
retention_mode?: "keep_total" | "subtract";
|
|
8478
|
+
/** Los conceptos de la factura global: `ticket` (por omisión), uno «Venta» por ticket con su folio como `NoIdentificacion`; `summary`, solo el monto total del periodo, uno por combinación de impuestos con `NoIdentificacion` «Resumen» (regla 2.7.1.21 de la RMF 2026). `summary` es solo para un emisor persona física en RESICO (626); otro contesta `invalid_request`. */
|
|
8479
|
+
global_concepts?: "ticket" | "summary";
|
|
8254
8480
|
}
|
|
8255
8481
|
/** Los parámetros de GET /v1/accounting/journal_entries. */
|
|
8256
8482
|
export interface ListJournalEntriesParams {
|
|
@@ -8307,8 +8533,10 @@ export interface ListLedgerAccountsParams {
|
|
|
8307
8533
|
}
|
|
8308
8534
|
/** Los parámetros de GET /v1/accounting/electronic_accounting. */
|
|
8309
8535
|
export interface GetElectronicAccountingParams {
|
|
8310
|
-
/** El mes (AAAA-MM). */
|
|
8536
|
+
/** El mes (AAAA-MM), o AAAA-13 para la balanza de cierre de un ejercicio ya terminado. */
|
|
8311
8537
|
month: string;
|
|
8538
|
+
/** Solo con AAAA-13: true (por omisión) incluye la póliza de cierre, que cancela ingresos, costos y gastos contra el resultado del ejercicio (305.01 utilidad o 305.02 pérdida); false manda los saldos de diciembre sin movimientos. */
|
|
8539
|
+
closing_entry?: "true" | "false";
|
|
8312
8540
|
/** normal (BN, por omisión) o complementary (BC, con modified_on). */
|
|
8313
8541
|
type?: "normal" | "complementary";
|
|
8314
8542
|
/** complementary: el día en que se modificó (AAAA-MM-DD). */
|
|
@@ -8504,7 +8732,7 @@ export interface CreateQuoteParams {
|
|
|
8504
8732
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
8505
8733
|
tax_id: string;
|
|
8506
8734
|
};
|
|
8507
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
8735
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
8508
8736
|
ieps_taxpayer?: boolean;
|
|
8509
8737
|
} | {
|
|
8510
8738
|
/** A quién va dirigida. */
|
|
@@ -8520,7 +8748,7 @@ export interface CreateQuoteParams {
|
|
|
8520
8748
|
description?: string;
|
|
8521
8749
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
8522
8750
|
product_key?: string;
|
|
8523
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
8751
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
8524
8752
|
unit_key?: string;
|
|
8525
8753
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
8526
8754
|
unit_name?: string | null;
|
|
@@ -8668,7 +8896,7 @@ export interface UpdateQuoteParams {
|
|
|
8668
8896
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
8669
8897
|
tax_id: string;
|
|
8670
8898
|
};
|
|
8671
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
8899
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
8672
8900
|
ieps_taxpayer?: boolean;
|
|
8673
8901
|
} | {
|
|
8674
8902
|
/** A quién va dirigida. */
|
|
@@ -8684,7 +8912,7 @@ export interface UpdateQuoteParams {
|
|
|
8684
8912
|
description?: string;
|
|
8685
8913
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
8686
8914
|
product_key?: string;
|
|
8687
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
8915
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
8688
8916
|
unit_key?: string;
|
|
8689
8917
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
8690
8918
|
unit_name?: string | null;
|
|
@@ -8843,7 +9071,7 @@ export interface CreateSalesOrderParams {
|
|
|
8843
9071
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
8844
9072
|
tax_id: string;
|
|
8845
9073
|
};
|
|
8846
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
9074
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
8847
9075
|
ieps_taxpayer?: boolean;
|
|
8848
9076
|
};
|
|
8849
9077
|
/** Los conceptos, como en POST /v1/invoices (hasta 200). */
|
|
@@ -8854,7 +9082,7 @@ export interface CreateSalesOrderParams {
|
|
|
8854
9082
|
description?: string;
|
|
8855
9083
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
8856
9084
|
product_key?: string;
|
|
8857
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
9085
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
8858
9086
|
unit_key?: string;
|
|
8859
9087
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
8860
9088
|
unit_name?: string | null;
|
|
@@ -9016,7 +9244,7 @@ export interface UpdateSalesOrderParams {
|
|
|
9016
9244
|
/** Número de registro de identidad fiscal en su país (NumRegIdTrib). */
|
|
9017
9245
|
tax_id: string;
|
|
9018
9246
|
};
|
|
9019
|
-
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio. */
|
|
9247
|
+
/** true si el cliente es contribuyente de IEPS: el IEPS va desglosado en vez de sumado al precio, salvo el del alcohol y los tabacos (tasas 0.5, 1.6 y 0.304), que va en el precio siempre (LIEPS art. 19 fr. II). */
|
|
9020
9248
|
ieps_taxpayer?: boolean;
|
|
9021
9249
|
};
|
|
9022
9250
|
/** Los conceptos, como en POST /v1/invoices (hasta 200). */
|
|
@@ -9027,7 +9255,7 @@ export interface UpdateSalesOrderParams {
|
|
|
9027
9255
|
description?: string;
|
|
9028
9256
|
/** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
|
|
9029
9257
|
product_key?: string;
|
|
9030
|
-
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio
|
|
9258
|
+
/** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio, H87 pieza, ACT actividad… Por omisión H87 si la clave del producto es de un bien (segmentos 10 a 60) y E48 si es de un servicio. */
|
|
9031
9259
|
unit_key?: string;
|
|
9032
9260
|
/** Nombre de la unidad (Unidad), hasta 20 caracteres. */
|
|
9033
9261
|
unit_name?: string | null;
|
|
@@ -10907,6 +11135,34 @@ export declare class SatFindingCounterpartiesResource {
|
|
|
10907
11135
|
*/
|
|
10908
11136
|
list(params?: ListSatFindingCounterpartiesParams, options?: RequestOptions): List<SatFindingCounterparty>;
|
|
10909
11137
|
}
|
|
11138
|
+
/** Cumplimiento SAT: fiscalisto.materialitySuppliers. */
|
|
11139
|
+
export declare class MaterialitySuppliersResource {
|
|
11140
|
+
#private;
|
|
11141
|
+
constructor(client: Client);
|
|
11142
|
+
/**
|
|
11143
|
+
* Listar la materialidad por proveedor
|
|
11144
|
+
*
|
|
11145
|
+
* Como Materialidad en la app: los proveedores de las facturas recibidas (ingresos) del emisor en un periodo, con cuánto de lo que facturaron tiene evidencia completa de que la operación existió (acuerdo, entrega y pago). Primero los que están en 69-B definitivo (corre su plazo de 30 días hábiles), después los de más importe sin probar. Una página, hasta 500. Sin fechas, este año hasta hoy. No usa timbres.
|
|
11146
|
+
*
|
|
11147
|
+
* GET /v1/materiality_suppliers
|
|
11148
|
+
* @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-materiality-suppliers
|
|
11149
|
+
*/
|
|
11150
|
+
list(params?: ListMaterialitySuppliersParams, options?: RequestOptions): Promise<MaterialitySupplierList>;
|
|
11151
|
+
}
|
|
11152
|
+
/** Cumplimiento SAT: fiscalisto.materialityInvoices. */
|
|
11153
|
+
export declare class MaterialityInvoicesResource {
|
|
11154
|
+
#private;
|
|
11155
|
+
constructor(client: Client);
|
|
11156
|
+
/**
|
|
11157
|
+
* Listar facturas recibidas por probar
|
|
11158
|
+
*
|
|
11159
|
+
* Las facturas recibidas (ingresos) del emisor en un periodo que no tienen su evidencia completa, de mayor a menor importe, cada una con lo que tiene, lo que le falta y de dónde salió cada evidencia (orden de compra, recepción, complemento de pago, banco, archivos). Con state, solo las de ese estado. Una página, hasta 300; has_more dice que hay más (acorte el periodo o filtre por proveedor). No usa timbres.
|
|
11160
|
+
*
|
|
11161
|
+
* GET /v1/materiality_invoices
|
|
11162
|
+
* @see https://fiscalisto.com/docs/api/referencia/cumplimiento-sat/list-materiality-invoices
|
|
11163
|
+
*/
|
|
11164
|
+
list(params?: ListMaterialityInvoicesParams, options?: RequestOptions): Promise<MaterialityInvoiceList>;
|
|
11165
|
+
}
|
|
10910
11166
|
/** Inventario: fiscalisto.warehouses. */
|
|
10911
11167
|
export declare class WarehousesResource {
|
|
10912
11168
|
#private;
|
|
@@ -11580,7 +11836,7 @@ export declare class AccountingResource {
|
|
|
11580
11836
|
/**
|
|
11581
11837
|
* Descargar la contabilidad electrónica
|
|
11582
11838
|
*
|
|
11583
|
-
* El ZIP del mes para el Buzón Tributario: el catálogo (CT) y la balanza (BN, o BC si es complementaria), cada uno en su ZIP con el nombre que espera el SAT, en el formato 1.3 del Anexo 24. Con journal_request, también las pólizas (PL), que se entregan cuando el SAT las pide.
|
|
11839
|
+
* El ZIP del mes para el Buzón Tributario: el catálogo (CT) y la balanza (BN, o BC si es complementaria), cada uno en su ZIP con el nombre que espera el SAT, en el formato 1.3 del Anexo 24. Con journal_request, también las pólizas (PL), que se entregan cuando el SAT las pide. Con month AAAA-13, la balanza de comprobación ajustada al cierre del ejercicio (regla 2.8.1.6 RMF): solo la balanza, con los saldos finales de diciembre como saldos iniciales y, con closing_entry, la póliza de cierre.
|
|
11584
11840
|
*
|
|
11585
11841
|
* GET /v1/accounting/electronic_accounting
|
|
11586
11842
|
* @see https://fiscalisto.com/docs/api/referencia/contabilidad/get-electronic-accounting
|
|
@@ -12123,6 +12379,8 @@ export declare class FiscalistoApi extends Core {
|
|
|
12123
12379
|
readonly satMailboxMessages: SatMailboxMessagesResource;
|
|
12124
12380
|
readonly satFindings: SatFindingsResource;
|
|
12125
12381
|
readonly satFindingCounterparties: SatFindingCounterpartiesResource;
|
|
12382
|
+
readonly materialitySuppliers: MaterialitySuppliersResource;
|
|
12383
|
+
readonly materialityInvoices: MaterialityInvoicesResource;
|
|
12126
12384
|
readonly warehouses: WarehousesResource;
|
|
12127
12385
|
readonly stockMovements: StockMovementsResource;
|
|
12128
12386
|
readonly stockAdjustments: StockAdjustmentsResource;
|