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.
@@ -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
- /** El folio (Folio) que se le asignó, o null. */
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 no impidieron timbrar (por ejemplo, el XML se guardará después). */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 (por omisión), H87 pieza, ACT actividad… */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 (por omisión), H87 pieza, ACT actividad… */
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), 3 letras. */
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): 05 envío de mercancías propias. */
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 (Rfc), 12 caracteres una persona moral y 13 una física. */
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 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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 (por omisión), H87 pieza, ACT actividad… */
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;