fiscalisto 0.1.20 → 0.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.d.ts 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.20";
7
+ export declare const VERSION = "0.1.21";
8
8
  /**
9
9
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
10
10
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
package/dist/core.js CHANGED
@@ -3,7 +3,7 @@
3
3
  * errores y las listas que se recorren solas. Los recursos (generated.ts) solo dicen qué ruta
4
4
  * llamar.
5
5
  */
6
- export const VERSION = "0.1.20";
6
+ export const VERSION = "0.1.21";
7
7
  /**
8
8
  * La versión de la API para la que se hizo este SDK: la manda en cada solicitud
9
9
  * (Fiscalisto-Version), así actualizar la API no cambia lo que recibe hasta que actualice el SDK.
@@ -554,7 +554,7 @@ export interface Retention {
554
554
  internal_folio: string | null;
555
555
  /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
556
556
  date: string | null;
557
- /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) aún no se puede emitir. */
557
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
558
558
  code: string;
559
559
  /** Descripción de la retención (DescRetenc). */
560
560
  description: string | null;
@@ -622,6 +622,8 @@ export interface Retention {
622
622
  mortgage_interest?: Record<string, unknown>;
623
623
  /** Complemento de operaciones financieras derivadas de capital (Operacionesconderivados 1.0), obligatorio con code 24. */
624
624
  financial_derivatives?: Record<string, unknown>;
625
+ /** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
626
+ platform?: Record<string, unknown>;
625
627
  /** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
626
628
  cancellation: {
627
629
  /** pending (espera la respuesta del cliente), accepted (cancelada), rejected (el cliente la rechazó) o lapsed (venció; puede pedirla otra vez). */
@@ -980,7 +982,7 @@ export interface ExternalPayrollReceiptPreview {
980
982
  warnings: {
981
983
  /** El campo de la solicitud. */
982
984
  param: string;
983
- /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) aún no se puede emitir. */
985
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
984
986
  code: string;
985
987
  /** Qué pasó y cómo corregirlo, para una persona. */
986
988
  message: string;
@@ -4737,7 +4739,7 @@ export type ApplyAdvanceParams = {
4737
4739
  export interface CreateRetentionParams {
4738
4740
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4739
4741
  issuer?: string;
4740
- /** 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) aún no se puede emitir. */
4742
+ /** Clave de la retención (CveRetenc), c_CveRetenc: 01 servicios profesionales, 05 arrendamiento, 14 dividendos, 16 intereses, 18 pagos al extranjero… Las claves 14, 16, 17 y 18 a 24 llevan su complemento (dividends, interest, trust_lease, foreign_payment, share_sale, prize, trust, retirement_plan, mortgage_interest, financial_derivatives); la 26 (plataformas tecnológicas) lleva platform, y sus totals y taxes se calculan de las operaciones. */
4741
4743
  code: string;
4742
4744
  /** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
4743
4745
  description?: string | null;
@@ -4766,7 +4768,7 @@ export interface CreateRetentionParams {
4766
4768
  to_month?: number;
4767
4769
  };
4768
4770
  /** Totales (Totales). */
4769
- totals: {
4771
+ totals?: {
4770
4772
  /** Monto total de la operación (MontoTotOperacion). */
4771
4773
  operation: number;
4772
4774
  /** Monto gravado (MontoTotGrav). Por omisión, operation menos exempt. */
@@ -4775,7 +4777,7 @@ export interface CreateRetentionParams {
4775
4777
  exempt?: number;
4776
4778
  };
4777
4779
  /** Impuestos del comprobante, por tipo. */
4778
- taxes: {
4780
+ taxes?: {
4779
4781
  /** Impuesto: isr, iva o ieps (ImpuestoRet 001, 002, 003). */
4780
4782
  tax: string;
4781
4783
  /** Base del impuesto retenido (BaseRet). */
@@ -4785,6 +4787,46 @@ export interface CreateRetentionParams {
4785
4787
  /** Tipo de pago de la retención (TipoPagoRet): 01 definitivo IVA, 02 definitivo IEPS, 03 definitivo ISR, 04 provisional ISR. Por omisión el usual de cada impuesto. */
4786
4788
  payment_type?: string;
4787
4789
  }[];
4790
+ /** Complemento de servicios de plataformas tecnológicas (ServiciosPlataformasTecnologicas 1.0), obligatorio con code 26: una constancia por mes, receptor y tipo de servicio. totals y taxes se calculan de services con las tasas del SAT (ISR de LISR 113-A y LIF 2026 art. 25; IVA 50% o 100%; IEPS en apuestas); si los manda, deben coincidir. */
4791
+ platform?: {
4792
+ /** Tipo de servicio (TipoDeServ), c_TipoDeServ: 01 transporte de pasajeros, 02 entrega de alimentos, 03 entrega de bienes, 04 hospedaje, 05 comercio de bienes, 06 otros servicios, 07 a 09 servicios digitales de extranjeros, 11 apuestas y sorteos (desde 2026). */
4793
+ type: string;
4794
+ /** Cada cuánto paga la plataforma (Periodicidad): 01 semanal, 02 mensual (por omisión), 03 diaria, 04 quincenal, 05 otra. */
4795
+ periodicity?: string;
4796
+ /** true si la persona física optó por que el ISR retenido sea pago definitivo (LISR 113-B): TipoPagoRet 03 en lugar de 04. */
4797
+ isr_definitive?: boolean;
4798
+ /** true si se le deposita en una cuenta en el extranjero: se retiene el 100% del IVA (LIF 2026 art. 25-IX-c). */
4799
+ foreign_account?: boolean;
4800
+ /** Cada operación (DetallesDelServicio), hasta 5,000. Lo pagado en efectivo (payment_form 01) va en la constancia pero no en las bases. */
4801
+ services: {
4802
+ /** Fecha en que el cliente pagó (FechaServ), AAAA-MM-DD, dentro del mes del periodo. */
4803
+ date: string;
4804
+ /** Forma de pago de la operación (FormaPagoServ), c_FormaPagoServ: 01 efectivo, 02 transferencia, 03 tarjeta de crédito, 04 monedero, 05 dinero electrónico, 06 débito, 07 tarjeta de servicios, 08 intermediario de pagos, 09 premios o bonificaciones. */
4805
+ payment_form: string;
4806
+ /** Precio sin IVA (PrecioServSinIVA). */
4807
+ price: number;
4808
+ /** Tasa del impuesto trasladado (TasaCuota): 0.16 (por omisión), 0.08 o 0 de IVA; 0.5 de IEPS solo con type 11, donde cada jugada va dos veces: una operación con su IVA y otra con su IEPS (el SAT pide un impuesto por operación). Sin tasa en premios (09), que desde 2026 no suman en totals. */
4809
+ rate?: number | string | null;
4810
+ /** Subtipo (SubTipServ), c_SubTipoServ: con type 01, 01 personal (por omisión), 02 compartido, 03 plus o 04 cancelación; con type 11, 08 apuestas (por omisión) o 09 sorteos. */
4811
+ subtype?: string | null;
4812
+ /** RFC (persona física) del tercero autorizado que prestó el servicio (RFCTerceroAutorizado). */
4813
+ authorized_tax_id?: string | null;
4814
+ /** Comisión de la plataforma por la operación (ComisionDelServicio): amount mayor que cero y percent opcional (0.001 a 1). Obligatoria en cada operación con IVA; no va en premios ni en las de IEPS. */
4815
+ commission?: {
4816
+ /** Importe. */
4817
+ amount: number;
4818
+ /** El porcentaje de la comisión sobre el precio, de 0.001 a 1 (0.25 es 25%). Opcional. */
4819
+ percent?: number | null;
4820
+ } | null;
4821
+ /** Contribución gubernamental pagada, como el impuesto sobre hospedaje (ContribucionGubernamental): amount de al menos 1.00 y state (01 a 32). */
4822
+ contribution?: {
4823
+ /** Importe. */
4824
+ amount: number;
4825
+ /** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
4826
+ state: string;
4827
+ } | null;
4828
+ }[];
4829
+ };
4788
4830
  /** Complemento de dividendos. */
4789
4831
  dividends?: {
4790
4832
  /** Tipo de dividendo o utilidad distribuida (CveTipDivOUtil), c_TipoDividendoOUtilidadDistribuida. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "fiscalisto",
3
- "version": "0.1.20",
3
+ "version": "0.1.21",
4
4
  "description": "SDK y CLI de la API de facturación electrónica (CFDI 4.0) de Fiscalisto, para TypeScript y JavaScript.",
5
5
  "keywords": [
6
6
  "cfdi",