fiscalisto 0.1.57 → 0.1.58

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.d.ts CHANGED
@@ -4,7 +4,7 @@
4
4
  * llamar.
5
5
  */
6
6
  import type { ErrorCode } from "./error-codes.js";
7
- export declare const VERSION = "0.1.57";
7
+ export declare const VERSION = "0.1.58";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.57";
6
+ export const VERSION = "0.1.58";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -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>;
@@ -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,8 @@ 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;
2855
2898
  }[];
2856
2899
  }
2857
2900
  /** Una venta que su comprador puede facturar él mismo en el portal del emisor (autofactura). */
@@ -2890,7 +2933,7 @@ export interface Ticket {
2890
2933
  description: string;
2891
2934
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
2892
2935
  product_key: string;
2893
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
2936
+ /** 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
2937
  unit_key: string;
2895
2938
  /** Tasa de IVA trasladado: 0.16 (por omisión), 0.08 (región fronteriza), 0 o exento. */
2896
2939
  iva: string | null;
@@ -2956,6 +2999,10 @@ export interface SelfInvoicing {
2956
2999
  portal_accent: string | null;
2957
3000
  /** Las esquinas del portal en píxeles (0 a 24), o null para las de Fiscalisto. */
2958
3001
  portal_radius: number | null;
3002
+ /** 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. */
3003
+ retention_mode: "keep_total" | "subtract";
3004
+ /** 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). */
3005
+ global_concepts: "ticket" | "summary";
2959
3006
  }
2960
3007
  /** Una factura que el emisor timbra solo, cada mes, semana o día. */
2961
3008
  export interface RecurringInvoice {
@@ -3016,7 +3063,7 @@ export interface RecurringInvoice {
3016
3063
  product_key: string;
3017
3064
  /** Cantidad (Cantidad). Por omisión 1. */
3018
3065
  quantity?: number;
3019
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
3066
+ /** 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
3067
  unit_key?: string;
3021
3068
  /** Precio unitario antes de impuestos (ValorUnitario). */
3022
3069
  unit_price: number;
@@ -3656,7 +3703,7 @@ export interface Quote {
3656
3703
  product_key: string;
3657
3704
  /** Cantidad (Cantidad). Por omisión 1. */
3658
3705
  quantity?: number;
3659
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
3706
+ /** 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
3707
  unit_key?: string;
3661
3708
  /** Precio unitario antes de impuestos (ValorUnitario). */
3662
3709
  unit_price: number;
@@ -3939,7 +3986,7 @@ export interface SupplierInvoice {
3939
3986
  rejection_reason: string | null;
3940
3987
  /** Lo que se revisó y quedó como aviso (code y message), para que su equipo lo vea. */
3941
3988
  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. */
3989
+ /** 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
3990
  code: string;
3944
3991
  /** Qué pasó y cómo corregirlo, para una persona. */
3945
3992
  message: string;
@@ -4377,7 +4424,7 @@ export interface CfdiVerification {
4377
4424
  issuer_efos: boolean | null;
4378
4425
  /** La respuesta del SAT tal cual (CodigoEstatus, Estado, EsCancelable, EstatusCancelacion, ValidacionEFOS), por si la necesita igual que el SAT. */
4379
4426
  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. */
4427
+ /** 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
4428
  code: string;
4382
4429
  /** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
4383
4430
  state: string;
@@ -5018,7 +5065,7 @@ export interface InvoiceCreate {
5018
5065
  description?: string;
5019
5066
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
5020
5067
  product_key?: string;
5021
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
5068
+ /** 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
5069
  unit_key?: string;
5023
5070
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
5024
5071
  unit_name?: string | null;
@@ -5602,6 +5649,8 @@ export interface InvoiceCreate {
5602
5649
  };
5603
5650
  }[];
5604
5651
  };
5652
+ /** 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). */
5653
+ carta_porte_exemption?: "2.7.7.2.1" | "2.7.7.2.2" | "2.7.7.2.3";
5605
5654
  /** Complemento INE (procesos electorales). */
5606
5655
  ine?: {
5607
5656
  /** Tipo de proceso (TipoProceso): Ordinario, Precampaña o Campaña. */
@@ -5612,7 +5661,7 @@ export interface InvoiceCreate {
5612
5661
  accounting_id?: string;
5613
5662
  /** Entidades (Entidad): clave del estado, ámbito y claves de contabilidad. */
5614
5663
  entities?: {
5615
- /** Clave de la entidad (ClaveEntidad), 3 letras. */
5664
+ /** 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
5665
  key: string;
5617
5666
  /** Ámbito (Ambito): Local o Federal. */
5618
5667
  scope?: "Local" | "Federal";
@@ -5647,12 +5696,12 @@ export interface InvoiceCreate {
5647
5696
  /** Importe del impuesto local. */
5648
5697
  amount: number;
5649
5698
  }[];
5650
- /** Exportación (Exportacion), c_Exportacion: 01 no aplica (por omisión), 02 definitiva… */
5699
+ /** 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
5700
  export?: "01" | "02" | "03" | "04";
5652
5701
  /** Complemento de comercio exterior 2.0. */
5653
5702
  comercio_exterior?: {
5654
- /** Motivo de traslado (MotivoTraslado): 05 envío de mercancías propias. */
5655
- motive?: "05";
5703
+ /** 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. */
5704
+ motive?: "99" | "01" | "02" | "03" | "04" | "05";
5656
5705
  /** Propietarios de la mercancía si no es el emisor (Propietario), con motive 05. */
5657
5706
  owners?: {
5658
5707
  /** Número de registro tributario del propietario (NumRegIdTrib). */
@@ -5838,7 +5887,7 @@ export interface ExternalPayrollReceiptCreate {
5838
5887
  };
5839
5888
  /** El empleado (Receptor y Nomina/Receptor) con los datos de su sistema de nómina; no usa ni cambia los empleados de Fiscalisto. */
5840
5889
  employee: {
5841
- /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
5890
+ /** RFC del empleado. XAXX010101000 si falleció: con su nombre y su CURP. */
5842
5891
  tax_id: string;
5843
5892
  /** Nombre. */
5844
5893
  name: string;
@@ -6471,7 +6520,7 @@ export type ApplyAdvanceParams = {
6471
6520
  export interface CreateRetentionParams {
6472
6521
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
6473
6522
  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. */
6523
+ /** 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
6524
  code: string;
6476
6525
  /** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
6477
6526
  description?: string | null;
@@ -6593,7 +6642,7 @@ export interface CreateRetentionParams {
6593
6642
  /** Pérdida (Perdida). */
6594
6643
  loss: number;
6595
6644
  };
6596
- /** Complemento de pagos a extranjeros. */
6645
+ /** Complemento de pagos a extranjeros: obligatorio con code 18, y con 01, 02, 04 y 05 cuando el receptor es extranjero. */
6597
6646
  foreign_payment?: {
6598
6647
  /** true si quien recibe es el beneficiario efectivo (EsBenefEfectDelCobro). */
6599
6648
  beneficiary: boolean;
@@ -6610,6 +6659,11 @@ export interface CreateRetentionParams {
6610
6659
  /** Nombre o razón social del beneficiario (NomDenRazSocB). */
6611
6660
  beneficiary_name?: string | null;
6612
6661
  };
6662
+ /** Complemento de dividendos con su nodo Remanente (remanente distribuible), obligatorio con code 15. Si no lo manda, va sin proporción. */
6663
+ distributable_remainder?: {
6664
+ /** Porcentaje de participación del integrante o socio en el remanente (ProporcionRem), opcional. */
6665
+ proportion?: number | null;
6666
+ };
6613
6667
  /** Complemento de arrendamiento en fideicomiso (Arrendamientoenfideicomiso 1.0), obligatorio con code 17. */
6614
6668
  trust_lease?: {
6615
6669
  /** Pago provisional que el fiduciario efectuó al arrendador en el periodo (PagProvEfecPorFiduc). */
@@ -6627,7 +6681,7 @@ export interface CreateRetentionParams {
6627
6681
  /** Qué son los otros conceptos distribuidos (DescrMontOtrosConceptDistr); obligatoria con other_amount. */
6628
6682
  other_description?: string | null;
6629
6683
  };
6630
- /** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 19. */
6684
+ /** Complemento de enajenación de acciones u operaciones de valores (EnajenaciondeAcciones 1.0), obligatorio con code 06 y 19. */
6631
6685
  share_sale?: {
6632
6686
  /** Descripción del contrato de intermediación (ContratoIntermediacion). */
6633
6687
  contract: string;
@@ -6923,6 +6977,10 @@ export interface CreatePayrollReceiptParams {
6923
6977
  };
6924
6978
  /** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
6925
6979
  days?: number;
6980
+ /** 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). */
6981
+ absences?: number;
6982
+ /** 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). */
6983
+ disability_days?: number;
6926
6984
  /** 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
6985
  replaces?: string;
6928
6986
  /** 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 +7004,10 @@ export interface PreviewPayrollReceiptParams {
6946
7004
  };
6947
7005
  /** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
6948
7006
  days?: number;
7007
+ /** 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). */
7008
+ absences?: number;
7009
+ /** 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). */
7010
+ disability_days?: number;
6949
7011
  /** 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
7012
  replaces?: string;
6951
7013
  /** 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 +7044,12 @@ export interface CreatePayrollBatchParams {
6982
7044
  /** Día de pago (FechaPago); sin él, el último día del periodo. */
6983
7045
  payment_date?: string;
6984
7046
  };
6985
- /** Días pagados; sin él, todos los días que le tocan del periodo. */
7047
+ /** Días pagados; sin él, todos los días que le tocan del periodo menos absences y disability_days. */
6986
7048
  days?: number;
7049
+ /** 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). */
7050
+ absences?: number;
7051
+ /** 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). */
7052
+ disability_days?: number;
6987
7053
  /** Mandarle su recibo por correo; sin él, lo que diga send_email del lote. Con true el empleado debe tener correo. */
6988
7054
  send_email?: boolean;
6989
7055
  /** Su identificador de este recibo, hasta 100 caracteres. */
@@ -7666,7 +7732,7 @@ export interface CreateProductParams {
7666
7732
  description: string;
7667
7733
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
7668
7734
  product_key: string;
7669
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
7735
+ /** 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
7736
  unit_key?: string;
7671
7737
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
7672
7738
  unit_name?: string | null;
@@ -7697,6 +7763,15 @@ export interface CreateProductParams {
7697
7763
  /** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
7698
7764
  rate: number;
7699
7765
  }[];
7766
+ /** 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. */
7767
+ hydrocarbon?: {
7768
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
7769
+ permit_type: string;
7770
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
7771
+ permit_number: string;
7772
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
7773
+ subproduct?: string;
7774
+ } | null;
7700
7775
  /** 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
7776
  track_stock?: boolean;
7702
7777
  /** Su costo por unidad en pesos sin IVA, hasta que sus compras den otro: vale las existencias que entran sin unit_cost. */
@@ -7736,7 +7811,7 @@ export interface UpdateProductParams {
7736
7811
  description?: string;
7737
7812
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
7738
7813
  product_key?: string;
7739
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
7814
+ /** 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
7815
  unit_key?: string;
7741
7816
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
7742
7817
  unit_name?: string | null;
@@ -7767,6 +7842,15 @@ export interface UpdateProductParams {
7767
7842
  /** Tasa en por ciento (TasadeTraslado o TasadeRetencion). */
7768
7843
  rate: number;
7769
7844
  }[];
7845
+ /** 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. */
7846
+ hydrocarbon?: {
7847
+ /** Tipo de permiso de la CNE o la CRE (TipoPermiso, c_TipoPermiso): PER01 a PER11. */
7848
+ permit_type: string;
7849
+ /** Número de permiso de la CNE o la CRE (NumeroPermiso), como PL/12345/EXP/ES/2016: de 15 a 35 caracteres. */
7850
+ permit_number: string;
7851
+ /** Subproducto (SubProductoHYP, c_SubProductoHYP): SP16 gasolina regular, SP17 premium, SP18 diésel automotriz… */
7852
+ subproduct?: string;
7853
+ } | null;
7770
7854
  /** 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
7855
  track_stock?: boolean;
7772
7856
  /** Su costo por unidad en pesos sin IVA, hasta que sus compras den otro: vale las existencias que entran sin unit_cost. */
@@ -8251,6 +8335,10 @@ export interface UpdateSelfInvoicingParams {
8251
8335
  portal_accent?: string | null;
8252
8336
  /** Lo redondo de las esquinas del portal, en píxeles (0 a 24). `null` pone el de Fiscalisto (10). */
8253
8337
  portal_radius?: number | null;
8338
+ /** 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. */
8339
+ retention_mode?: "keep_total" | "subtract";
8340
+ /** 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`. */
8341
+ global_concepts?: "ticket" | "summary";
8254
8342
  }
8255
8343
  /** Los parámetros de GET /v1/accounting/journal_entries. */
8256
8344
  export interface ListJournalEntriesParams {
@@ -8520,7 +8608,7 @@ export interface CreateQuoteParams {
8520
8608
  description?: string;
8521
8609
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
8522
8610
  product_key?: string;
8523
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
8611
+ /** 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
8612
  unit_key?: string;
8525
8613
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
8526
8614
  unit_name?: string | null;
@@ -8684,7 +8772,7 @@ export interface UpdateQuoteParams {
8684
8772
  description?: string;
8685
8773
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
8686
8774
  product_key?: string;
8687
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
8775
+ /** 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
8776
  unit_key?: string;
8689
8777
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
8690
8778
  unit_name?: string | null;
@@ -8854,7 +8942,7 @@ export interface CreateSalesOrderParams {
8854
8942
  description?: string;
8855
8943
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
8856
8944
  product_key?: string;
8857
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
8945
+ /** 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
8946
  unit_key?: string;
8859
8947
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
8860
8948
  unit_name?: string | null;
@@ -9027,7 +9115,7 @@ export interface UpdateSalesOrderParams {
9027
9115
  description?: string;
9028
9116
  /** Clave del producto o servicio (ClaveProdServ), 8 dígitos de c_ClaveProdServ. Búsquela con GET /v1/sat_catalogs/product_keys?q=… */
9029
9117
  product_key?: string;
9030
- /** Clave de unidad (ClaveUnidad) de c_ClaveUnidad: E48 unidad de servicio (por omisión), H87 pieza, ACT actividad… */
9118
+ /** 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
9119
  unit_key?: string;
9032
9120
  /** Nombre de la unidad (Unidad), hasta 20 caracteres. */
9033
9121
  unit_name?: string | null;