fiscalisto 0.1.20 → 0.1.22

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.22";
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.22";
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). */
@@ -804,6 +806,24 @@ export interface Employee {
804
806
  department: string | null;
805
807
  /** Puesto (Puesto). */
806
808
  position: string | null;
809
+ /** CLABE de su cuenta, a donde le paga el archivo para el banco, o null. */
810
+ clabe: string | null;
811
+ /** Nombre(s) como en su CURP, o null (los archivos del IMSS lo separan con la CURP). */
812
+ given_names: string | null;
813
+ /** Primer apellido como en su CURP, o null. */
814
+ first_surname: string | null;
815
+ /** Segundo apellido, o null. */
816
+ second_surname: string | null;
817
+ /** Tipo de trabajador del IMSS: 1 permanente, 2 eventual de la ciudad, 3 eventual de la construcción, 4 eventual del campo. */
818
+ imss_worker_type: string;
819
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. */
820
+ imss_salary_type: string;
821
+ /** Semana o jornada reducida: 0 normal, 1 a 5 días a la semana, 6 jornada de menos de 8 horas. */
822
+ imss_reduced_week: string;
823
+ /** Unidad de medicina familiar del IMSS, o null. */
824
+ family_medicine_unit: string | null;
825
+ /** Causa de la baja ante el IMSS cuando tiene end_date (2 separación voluntaria por omisión), o null. */
826
+ exit_reason: string | null;
807
827
  /** Lo que el SAT podría observar de sus datos, antes de timbrar. */
808
828
  warnings: string[];
809
829
  /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
@@ -980,7 +1000,7 @@ export interface ExternalPayrollReceiptPreview {
980
1000
  warnings: {
981
1001
  /** El campo de la solicitud. */
982
1002
  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. */
1003
+ /** 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
1004
  code: string;
985
1005
  /** Qué pasó y cómo corregirlo, para una persona. */
986
1006
  message: string;
@@ -1117,6 +1137,139 @@ export interface PayrollBatch {
1117
1137
  } | null;
1118
1138
  }[];
1119
1139
  }
1140
+ /** El archivo para pagar la nómina desde el portal del banco (no cobra nada). */
1141
+ export interface PayrollBankFile {
1142
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1143
+ object: "payroll_bank_file";
1144
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1145
+ livemode: boolean;
1146
+ /** El emisor (iss_…). */
1147
+ issuer: string;
1148
+ /** El formato del banco: bbva, banamex, banorte, santander o spei (CSV). */
1149
+ layout: "bbva" | "banamex" | "banorte" | "santander" | "spei";
1150
+ /** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
1151
+ payment_date: string;
1152
+ /** La CLABE de la cuenta de cargo. */
1153
+ account: string | null;
1154
+ /** El nombre con que el portal del banco lo espera. */
1155
+ file_name: string;
1156
+ /** text/plain para los portales de los bancos, text/csv para spei. */
1157
+ content_type: "text/plain" | "text/csv";
1158
+ /** El archivo como texto, con renglones terminados en CR LF. */
1159
+ content: string;
1160
+ /** El mismo archivo en Windows-1252 (ANSI), en base64: guárdelo tal cual para subirlo. */
1161
+ content_base64: string;
1162
+ /** Total en la moneda del comprobante (Total). */
1163
+ total: number;
1164
+ /** Cuántos pagos lleva. */
1165
+ count: number;
1166
+ /** Cada pago del archivo, en el orden en que va. */
1167
+ payments: {
1168
+ /** El empleado (emp_…); null si el recibo lo timbró otro sistema y no hay empleado con ese RFC. */
1169
+ employee: string | null;
1170
+ /** Número de empleado (NumEmpleado). */
1171
+ number: string | null;
1172
+ /** Nombre. */
1173
+ name: string;
1174
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1175
+ tax_id: string;
1176
+ /** El neto a pagar: la suma de sus recibos con esa fecha de pago. */
1177
+ amount: number;
1178
+ /** La CLABE a donde se paga. */
1179
+ clabe: string;
1180
+ /** true: a otro banco por SPEI; false: a una cuenta del mismo banco. */
1181
+ spei: boolean;
1182
+ /** Serie y folio de los recibos que paga. */
1183
+ receipts: string[];
1184
+ }[];
1185
+ /** Quién no va en el archivo y por qué (sin CLABE, otro banco…). */
1186
+ excluded: {
1187
+ /** El empleado (emp_…); null si el recibo lo timbró otro sistema y no hay empleado con ese RFC. */
1188
+ employee: string | null;
1189
+ /** Número de empleado (NumEmpleado). */
1190
+ number: string | null;
1191
+ /** Nombre. */
1192
+ name: string;
1193
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1194
+ tax_id: string;
1195
+ /** El neto a pagar: la suma de sus recibos con esa fecha de pago. */
1196
+ amount: number;
1197
+ /** Por qué no va en el archivo. */
1198
+ reason: string;
1199
+ }[];
1200
+ }
1201
+ /** Un movimiento afiliatorio del IMSS de un empleado: alta, modificación de salario, baja o reingreso. */
1202
+ export interface ImssMovement {
1203
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1204
+ id: string;
1205
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1206
+ livemode: boolean;
1207
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1208
+ object: "imss_movement";
1209
+ /** El emisor (iss_…). */
1210
+ issuer: string;
1211
+ /** El empleado (emp_…). */
1212
+ employee: string;
1213
+ /** Su número de empleado. */
1214
+ employee_number: string;
1215
+ /** Su nombre completo. */
1216
+ employee_name: string;
1217
+ /** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
1218
+ social_security_number: string;
1219
+ /** alta, reingreso, modificacion (de salario) o baja. */
1220
+ kind: "alta" | "reingreso" | "modificacion" | "baja";
1221
+ /** El tipo de movimiento del IMSS: 08 alta o reingreso, 07 modificación, 02 baja. */
1222
+ movement_type: "08" | "07" | "02";
1223
+ /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
1224
+ date: string;
1225
+ /** Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario. */
1226
+ integrated_daily_salary: number | null;
1227
+ /** En bajas, la causa (1 a 9 o A); null en los demás. */
1228
+ exit_reason: string | null;
1229
+ /** automatic: lo registró el alta o el cambio del empleado; manual: se agregó a mano. */
1230
+ source: "automatic" | "manual";
1231
+ /** pending: falta presentarlo al IMSS; reported: ya se presentó (ya no cambia). */
1232
+ status: "pending" | "reported";
1233
+ /** Cuándo se marcó como presentado, o null. */
1234
+ reported_at: string | null;
1235
+ /** Lo que el IMSS rechazaría en su renglón (vacío: listo para el archivo). */
1236
+ problems: string[];
1237
+ }
1238
+ /** Los archivos para presentar movimientos en IDSE o importarlos en SUA. */
1239
+ export interface ImssFiles {
1240
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1241
+ object: "imss_files";
1242
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1243
+ livemode: boolean;
1244
+ /** El emisor (iss_…). */
1245
+ issuer: string;
1246
+ /** idse o sua. */
1247
+ format: "idse" | "sua";
1248
+ /** Los archivos: en IDSE uno por tipo de movimiento; en SUA ASEG.TXT y MOVT.TXT. */
1249
+ files: {
1250
+ /** El nombre del archivo. */
1251
+ file_name: string;
1252
+ /** Qué lleva, en palabras. */
1253
+ description: string;
1254
+ /** Cuántos movimientos lleva. */
1255
+ count: number;
1256
+ /** El archivo como texto, renglones terminados en CR LF. */
1257
+ content: string;
1258
+ /** El archivo en Windows-1252 (ANSI, como lo leen IDSE y SUA), en base64. */
1259
+ content_base64: string;
1260
+ }[];
1261
+ /** Los movimientos que van en los archivos. */
1262
+ movements: string[];
1263
+ /** Los que se quedaron fuera y por qué (un NSS inválido…). */
1264
+ refused: {
1265
+ /** El movimiento (imv_…). */
1266
+ movement: string;
1267
+ /** El nombre del empleado. */
1268
+ employee_name: string;
1269
+ /** Lo que el IMSS rechazaría en su renglón. */
1270
+ problems: string[];
1271
+ }[];
1272
+ }
1120
1273
  /** Una clave de un catálogo del SAT. */
1121
1274
  export interface SatCatalogEntry {
1122
1275
  /** La clave en el catálogo del SAT. */
@@ -3050,6 +3203,16 @@ export interface PayrollBatchList {
3050
3203
  /** La ruta de esta lista. */
3051
3204
  url: string;
3052
3205
  }
3206
+ export interface ImssMovementList {
3207
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3208
+ object: "list";
3209
+ /** Los objetos de esta página. */
3210
+ data: ImssMovement[];
3211
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3212
+ has_more: boolean;
3213
+ /** La ruta de esta lista. */
3214
+ url: string;
3215
+ }
3053
3216
  export interface InvoiceBatchList {
3054
3217
  /** Qué tipo de objeto es («invoice», «customer»…). */
3055
3218
  object: "list";
@@ -4737,7 +4900,7 @@ export type ApplyAdvanceParams = {
4737
4900
  export interface CreateRetentionParams {
4738
4901
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
4739
4902
  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. */
4903
+ /** 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
4904
  code: string;
4742
4905
  /** Descripción de la retención (DescRetenc); obligatoria con la clave 25 (otro tipo). */
4743
4906
  description?: string | null;
@@ -4766,7 +4929,7 @@ export interface CreateRetentionParams {
4766
4929
  to_month?: number;
4767
4930
  };
4768
4931
  /** Totales (Totales). */
4769
- totals: {
4932
+ totals?: {
4770
4933
  /** Monto total de la operación (MontoTotOperacion). */
4771
4934
  operation: number;
4772
4935
  /** Monto gravado (MontoTotGrav). Por omisión, operation menos exempt. */
@@ -4775,7 +4938,7 @@ export interface CreateRetentionParams {
4775
4938
  exempt?: number;
4776
4939
  };
4777
4940
  /** Impuestos del comprobante, por tipo. */
4778
- taxes: {
4941
+ taxes?: {
4779
4942
  /** Impuesto: isr, iva o ieps (ImpuestoRet 001, 002, 003). */
4780
4943
  tax: string;
4781
4944
  /** Base del impuesto retenido (BaseRet). */
@@ -4785,6 +4948,46 @@ export interface CreateRetentionParams {
4785
4948
  /** 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
4949
  payment_type?: string;
4787
4950
  }[];
4951
+ /** 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. */
4952
+ platform?: {
4953
+ /** 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). */
4954
+ type: string;
4955
+ /** Cada cuánto paga la plataforma (Periodicidad): 01 semanal, 02 mensual (por omisión), 03 diaria, 04 quincenal, 05 otra. */
4956
+ periodicity?: string;
4957
+ /** true si la persona física optó por que el ISR retenido sea pago definitivo (LISR 113-B): TipoPagoRet 03 en lugar de 04. */
4958
+ isr_definitive?: boolean;
4959
+ /** true si se le deposita en una cuenta en el extranjero: se retiene el 100% del IVA (LIF 2026 art. 25-IX-c). */
4960
+ foreign_account?: boolean;
4961
+ /** Cada operación (DetallesDelServicio), hasta 5,000. Lo pagado en efectivo (payment_form 01) va en la constancia pero no en las bases. */
4962
+ services: {
4963
+ /** Fecha en que el cliente pagó (FechaServ), AAAA-MM-DD, dentro del mes del periodo. */
4964
+ date: string;
4965
+ /** 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. */
4966
+ payment_form: string;
4967
+ /** Precio sin IVA (PrecioServSinIVA). */
4968
+ price: number;
4969
+ /** 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. */
4970
+ rate?: number | string | null;
4971
+ /** 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. */
4972
+ subtype?: string | null;
4973
+ /** RFC (persona física) del tercero autorizado que prestó el servicio (RFCTerceroAutorizado). */
4974
+ authorized_tax_id?: string | null;
4975
+ /** 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. */
4976
+ commission?: {
4977
+ /** Importe. */
4978
+ amount: number;
4979
+ /** El porcentaje de la comisión sobre el precio, de 0.001 a 1 (0.25 es 25%). Opcional. */
4980
+ percent?: number | null;
4981
+ } | null;
4982
+ /** Contribución gubernamental pagada, como el impuesto sobre hospedaje (ContribucionGubernamental): amount de al menos 1.00 y state (01 a 32). */
4983
+ contribution?: {
4984
+ /** Importe. */
4985
+ amount: number;
4986
+ /** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
4987
+ state: string;
4988
+ } | null;
4989
+ }[];
4990
+ };
4788
4991
  /** Complemento de dividendos. */
4789
4992
  dividends?: {
4790
4993
  /** Tipo de dividendo o utilidad distribuida (CveTipDivOUtil), c_TipoDividendoOUtilidadDistribuida. */
@@ -5047,6 +5250,24 @@ export interface CreateEmployeeParams {
5047
5250
  department?: string | null;
5048
5251
  /** Puesto (Puesto). */
5049
5252
  position?: string | null;
5253
+ /** CLABE de 18 dígitos de la cuenta del empleado: a donde le paga el archivo para el banco (POST /v1/payroll_bank_files). */
5254
+ clabe?: string | null;
5255
+ /** Nombre(s), como en su CURP. Con first_surname y second_surname, los archivos del IMSS (IDSE y SUA) escriben el nombre en sus tres partes; sin ellos, Fiscalisto lo separa con la CURP. */
5256
+ given_names?: string | null;
5257
+ /** Primer apellido, como en su CURP. */
5258
+ first_surname?: string | null;
5259
+ /** Segundo apellido (vacío si tiene uno). */
5260
+ second_surname?: string | null;
5261
+ /** Tipo de trabajador del IMSS: 1 permanente, 2 eventual de la ciudad, 3 eventual de la construcción, 4 eventual del campo. Por omisión 1. */
5262
+ imss_worker_type?: "1" | "2" | "3" | "4";
5263
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. Por omisión 0. */
5264
+ imss_salary_type?: "0" | "1" | "2";
5265
+ /** Semana o jornada reducida: 0 normal, 1 a 5 los días que trabaja a la semana, 6 jornada de menos de 8 horas. Por omisión 0. */
5266
+ imss_reduced_week?: "0" | "1" | "2" | "3" | "4" | "5" | "6";
5267
+ /** Unidad de medicina familiar (UMF) del IMSS, opcional. */
5268
+ family_medicine_unit?: string | null;
5269
+ /** Causa de la baja ante el IMSS, con end_date: 1 término de contrato, 2 separación voluntaria (la usual), 3 abandono, 4 defunción, 5 clausura, 6 otras, 7 ausentismo, 8 rescisión, 9 jubilación, A pensión. */
5270
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5050
5271
  }
5051
5272
  /** Los parámetros de GET /v1/employees. */
5052
5273
  export interface ListEmployeesParams {
@@ -5098,6 +5319,24 @@ export interface UpdateEmployeeParams {
5098
5319
  department?: string | null;
5099
5320
  /** Puesto (Puesto). */
5100
5321
  position?: string | null;
5322
+ /** CLABE de 18 dígitos de la cuenta del empleado: a donde le paga el archivo para el banco (POST /v1/payroll_bank_files). */
5323
+ clabe?: string | null;
5324
+ /** Nombre(s), como en su CURP. Con first_surname y second_surname, los archivos del IMSS (IDSE y SUA) escriben el nombre en sus tres partes; sin ellos, Fiscalisto lo separa con la CURP. */
5325
+ given_names?: string | null;
5326
+ /** Primer apellido, como en su CURP. */
5327
+ first_surname?: string | null;
5328
+ /** Segundo apellido (vacío si tiene uno). */
5329
+ second_surname?: string | null;
5330
+ /** Tipo de trabajador del IMSS: 1 permanente, 2 eventual de la ciudad, 3 eventual de la construcción, 4 eventual del campo. Por omisión 1. */
5331
+ imss_worker_type?: "1" | "2" | "3" | "4";
5332
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. Por omisión 0. */
5333
+ imss_salary_type?: "0" | "1" | "2";
5334
+ /** Semana o jornada reducida: 0 normal, 1 a 5 los días que trabaja a la semana, 6 jornada de menos de 8 horas. Por omisión 0. */
5335
+ imss_reduced_week?: "0" | "1" | "2" | "3" | "4" | "5" | "6";
5336
+ /** Unidad de medicina familiar (UMF) del IMSS, opcional. */
5337
+ family_medicine_unit?: string | null;
5338
+ /** Causa de la baja ante el IMSS, con end_date: 1 término de contrato, 2 separación voluntaria (la usual), 3 abandono, 4 defunción, 5 clausura, 6 otras, 7 ausentismo, 8 rescisión, 9 jubilación, A pensión. */
5339
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5101
5340
  }
5102
5341
  export interface CreatePayrollReceiptParams {
5103
5342
  /** El empleado (emp_…). */
@@ -5190,6 +5429,73 @@ export interface ListPayrollBatchesParams {
5190
5429
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5191
5430
  issuer?: string;
5192
5431
  }
5432
+ export interface CreatePayrollBankFileParams {
5433
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5434
+ issuer?: string;
5435
+ /** La fecha de pago de los recibos (FechaPago): se pagan los recibos de nómina timbrados con esa fecha, sumados por empleado. También es el día en que el banco aplica el archivo. */
5436
+ payment_date: string;
5437
+ /** El formato del banco: bbva (Net Cash), banamex (BancaNet, layout D), banorte (Banorte en su Empresa), santander (Enlace, solo cuentas Santander) o spei (CSV para cualquier banco). Por omisión, el del banco de account. */
5438
+ layout?: "bbva" | "banamex" | "banorte" | "santander" | "spei";
5439
+ /** La CLABE de la cuenta de cargo del emisor. Por omisión, la que se usó la última vez en la app, o su primera cuenta bancaria. */
5440
+ account?: string;
5441
+ /** El archivo del día (1 a 99): un segundo archivo el mismo día lleva otro número. Por omisión 1. */
5442
+ sequence?: number;
5443
+ /** Banamex: su número de cliente de BancaNet (12 dígitos). */
5444
+ client_number?: string;
5445
+ /** Banorte: su número de emisora (5 dígitos). */
5446
+ issuer_number?: string;
5447
+ }
5448
+ export interface CreateImssMovementParams {
5449
+ /** El empleado (emp_…). */
5450
+ employee: string;
5451
+ /** alta (o reingreso): tipo 08; modificacion: cambio de salario, tipo 07; baja: tipo 02. */
5452
+ kind: "alta" | "reingreso" | "modificacion" | "baja";
5453
+ /** El día en que surte efecto (AAAA-MM-DD, hora de México). El IMSS no acepta más de unos días de anticipación. */
5454
+ date: string;
5455
+ /** El salario diario integrado que se declara (en altas, reingresos y modificaciones). El archivo lo topa a 25 UMA y nunca baja del salario mínimo. */
5456
+ integrated_daily_salary?: number | null;
5457
+ /** Solo en bajas: 1 término de contrato, 2 separación voluntaria, 3 abandono, 4 defunción, 5 clausura, 6 otras, 7 ausentismo, 8 rescisión, 9 jubilación, A pensión. */
5458
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5459
+ }
5460
+ /** Los parámetros de GET /v1/imss_movements. */
5461
+ export interface ListImssMovementsParams {
5462
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
5463
+ limit?: number;
5464
+ /** El id del último de la página anterior, para la siguiente. */
5465
+ starting_after?: string;
5466
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5467
+ issuer?: string;
5468
+ /** pending (por omisión) o reported. */
5469
+ status?: "pending" | "reported";
5470
+ }
5471
+ export interface ReportImssMovementsParams {
5472
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5473
+ issuer?: string;
5474
+ /** Los movimientos (imv_…) que el IMSS ya recibió, hasta 1,000. */
5475
+ movements: string[];
5476
+ /** true (por omisión): marcarlos como presentados; false: devolverlos a pendientes (si los marcó por error). */
5477
+ reported?: boolean;
5478
+ }
5479
+ export interface UpdateImssMovementParams {
5480
+ /** alta (o reingreso): tipo 08; modificacion: cambio de salario, tipo 07; baja: tipo 02. */
5481
+ kind?: "alta" | "reingreso" | "modificacion" | "baja";
5482
+ /** El día en que surte efecto (AAAA-MM-DD, hora de México). El IMSS no acepta más de unos días de anticipación. */
5483
+ date?: string;
5484
+ /** El salario diario integrado que se declara (en altas, reingresos y modificaciones). El archivo lo topa a 25 UMA y nunca baja del salario mínimo. */
5485
+ integrated_daily_salary?: number | null;
5486
+ /** Solo en bajas: 1 término de contrato, 2 separación voluntaria, 3 abandono, 4 defunción, 5 clausura, 6 otras, 7 ausentismo, 8 rescisión, 9 jubilación, A pensión. */
5487
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5488
+ }
5489
+ export interface CreateImssFilesParams {
5490
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5491
+ issuer?: string;
5492
+ /** idse: los archivos de IDSE (uno por tipo: reingresos, modificaciones, bajas); sua: ASEG.TXT (altas) y MOVT.TXT (los demás) para importar en SUA. */
5493
+ format: "idse" | "sua";
5494
+ /** Los movimientos (imv_…) pendientes que van en los archivos. Por omisión, todos los pendientes. */
5495
+ movements?: string[];
5496
+ /** IDSE: la guía de 5 dígitos de su subdelegación. Por omisión, la que se guardó en la app. */
5497
+ guide?: string;
5498
+ }
5193
5499
  export interface CreateInvoiceBatchParams {
5194
5500
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5195
5501
  issuer?: string;
@@ -7179,6 +7485,93 @@ export declare class PayrollBatchesResource {
7179
7485
  */
7180
7486
  get(id: string, options?: RequestOptions): Promise<PayrollBatch>;
7181
7487
  }
7488
+ /** Nómina: fiscalisto.payrollBankFiles. */
7489
+ export declare class PayrollBankFilesResource {
7490
+ #private;
7491
+ constructor(client: Client);
7492
+ /**
7493
+ * Archivo para pagar la nómina en el banco
7494
+ *
7495
+ * El archivo de dispersión que paga el neto de cada empleado desde el portal de su banco: BBVA (Net Cash), Banamex (BancaNet, layout D), Banorte (Banorte en su Empresa), Santander (Enlace) o un CSV de SPEI para cualquier banco. Toma los recibos de nómina timbrados (y no cancelados) con esa fecha de pago, los suma por empleado y le paga a la CLABE de su ficha (clabe en el empleado): a la misma institución por cuenta, a otra por SPEI. No cobra ni mueve dinero: usted lo sube al banco y lo autoriza ahí. Quien no se puede pagar (sin CLABE, otro banco en Santander) va en excluded con su razón. Suba el primero como prueba: cada portal lo valida antes de cargar nada.
7496
+ *
7497
+ * POST /v1/payroll_bank_files
7498
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-payroll-bank-file
7499
+ */
7500
+ create(params: CreatePayrollBankFileParams, options?: RequestOptions): Promise<PayrollBankFile>;
7501
+ }
7502
+ /** Nómina: fiscalisto.imssMovements. */
7503
+ export declare class ImssMovementsResource {
7504
+ #private;
7505
+ constructor(client: Client);
7506
+ /**
7507
+ * Agregar un movimiento del IMSS
7508
+ *
7509
+ * Un movimiento afiliatorio a mano. Casi nunca hace falta: al crear un empleado se registra su alta, al cambiar su integrated_daily_salary la modificación (con fecha de hoy), al ponerle end_date su baja y al volver a contratarlo su reingreso. Queda pendiente de presentar.
7510
+ *
7511
+ * POST /v1/imss_movements
7512
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-movement
7513
+ */
7514
+ create(params: CreateImssMovementParams, options?: RequestOptions): Promise<ImssMovement>;
7515
+ /**
7516
+ * Listar movimientos del IMSS
7517
+ *
7518
+ * Los movimientos del emisor por presentar (status=pending, por omisión: todos, del más antiguo al más reciente, como van en los archivos) o ya presentados (status=reported: los 500 más recientes).
7519
+ *
7520
+ * GET /v1/imss_movements
7521
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/list-imss-movements
7522
+ */
7523
+ list(params?: ListImssMovementsParams, options?: RequestOptions): List<ImssMovement>;
7524
+ /**
7525
+ * Marcar movimientos como presentados
7526
+ *
7527
+ * Cuando el IMSS ya los recibió (el acuse de IDSE o la importación en SUA): pasan a reported y ya no cambian ni se borran. Con reported false vuelven a pendientes. Devuelve los movimientos como quedaron.
7528
+ *
7529
+ * POST /v1/imss_movements/report
7530
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/report-imss-movements
7531
+ */
7532
+ report(params: ReportImssMovementsParams, options?: RequestOptions): Promise<ImssMovementList>;
7533
+ /**
7534
+ * Ver un movimiento del IMSS
7535
+ *
7536
+ * El movimiento con lo que el IMSS rechazaría en problems.
7537
+ *
7538
+ * GET /v1/imss_movements/{id}
7539
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/get-imss-movement
7540
+ */
7541
+ get(id: string, options?: RequestOptions): Promise<ImssMovement>;
7542
+ /**
7543
+ * Cambiar un movimiento del IMSS
7544
+ *
7545
+ * Solo uno pendiente: uno ya presentado se queda como lo tiene el IMSS.
7546
+ *
7547
+ * POST /v1/imss_movements/{id}
7548
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/update-imss-movement
7549
+ */
7550
+ update(id: string, params?: UpdateImssMovementParams, options?: RequestOptions): Promise<ImssMovement>;
7551
+ /**
7552
+ * Borrar un movimiento del IMSS
7553
+ *
7554
+ * Solo uno pendiente (por ejemplo, un alta registrada por error).
7555
+ *
7556
+ * DELETE /v1/imss_movements/{id}
7557
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/delete-imss-movement
7558
+ */
7559
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
7560
+ }
7561
+ /** Nómina: fiscalisto.imssFiles. */
7562
+ export declare class ImssFilesResource {
7563
+ #private;
7564
+ constructor(client: Client);
7565
+ /**
7566
+ * Archivos para IDSE o SUA
7567
+ *
7568
+ * Los archivos de los movimientos pendientes: para IDSE (formato de 168 posiciones, un archivo por tipo: reingresos, modificaciones de salario y bajas; necesita la guía de su subdelegación) o para importar en SUA (ASEG.TXT con las altas y MOVT.TXT con los demás). El salario se declara topado a 25 UMA y nunca abajo del mínimo. El emisor necesita employer_registration. Los que el IMSS rechazaría van en refused con su razón. No los marca como presentados: hágalo con POST /v1/imss_movements/report cuando el IMSS los reciba.
7569
+ *
7570
+ * POST /v1/imss_files
7571
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-files
7572
+ */
7573
+ create(params: CreateImssFilesParams, options?: RequestOptions): Promise<ImssFiles>;
7574
+ }
7182
7575
  /** Lotes: fiscalisto.invoiceBatches. */
7183
7576
  export declare class InvoiceBatchesResource {
7184
7577
  #private;
@@ -8209,6 +8602,9 @@ export declare class FiscalistoApi extends Core {
8209
8602
  readonly employees: EmployeesResource;
8210
8603
  readonly payrollReceipts: PayrollReceiptsResource;
8211
8604
  readonly payrollBatches: PayrollBatchesResource;
8605
+ readonly payrollBankFiles: PayrollBankFilesResource;
8606
+ readonly imssMovements: ImssMovementsResource;
8607
+ readonly imssFiles: ImssFilesResource;
8212
8608
  readonly invoiceBatches: InvoiceBatchesResource;
8213
8609
  readonly taxIds: TaxIdsResource;
8214
8610
  readonly branches: BranchesResource;
package/dist/generated.js CHANGED
@@ -1010,6 +1010,115 @@ export class PayrollBatchesResource {
1010
1010
  return this.#client.request({ method: "GET", path: `/v1/payroll_batches/${encodeURIComponent(id)}` }, options);
1011
1011
  }
1012
1012
  }
1013
+ /** Nómina: fiscalisto.payrollBankFiles. */
1014
+ export class PayrollBankFilesResource {
1015
+ #client;
1016
+ constructor(client) {
1017
+ this.#client = client;
1018
+ }
1019
+ /**
1020
+ * Archivo para pagar la nómina en el banco
1021
+ *
1022
+ * El archivo de dispersión que paga el neto de cada empleado desde el portal de su banco: BBVA (Net Cash), Banamex (BancaNet, layout D), Banorte (Banorte en su Empresa), Santander (Enlace) o un CSV de SPEI para cualquier banco. Toma los recibos de nómina timbrados (y no cancelados) con esa fecha de pago, los suma por empleado y le paga a la CLABE de su ficha (clabe en el empleado): a la misma institución por cuenta, a otra por SPEI. No cobra ni mueve dinero: usted lo sube al banco y lo autoriza ahí. Quien no se puede pagar (sin CLABE, otro banco en Santander) va en excluded con su razón. Suba el primero como prueba: cada portal lo valida antes de cargar nada.
1023
+ *
1024
+ * POST /v1/payroll_bank_files
1025
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-payroll-bank-file
1026
+ */
1027
+ create(params, options) {
1028
+ return this.#client.request({ method: "POST", path: "/v1/payroll_bank_files", body: params, idempotent: true }, options);
1029
+ }
1030
+ }
1031
+ /** Nómina: fiscalisto.imssMovements. */
1032
+ export class ImssMovementsResource {
1033
+ #client;
1034
+ constructor(client) {
1035
+ this.#client = client;
1036
+ }
1037
+ /**
1038
+ * Agregar un movimiento del IMSS
1039
+ *
1040
+ * Un movimiento afiliatorio a mano. Casi nunca hace falta: al crear un empleado se registra su alta, al cambiar su integrated_daily_salary la modificación (con fecha de hoy), al ponerle end_date su baja y al volver a contratarlo su reingreso. Queda pendiente de presentar.
1041
+ *
1042
+ * POST /v1/imss_movements
1043
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-movement
1044
+ */
1045
+ create(params, options) {
1046
+ return this.#client.request({ method: "POST", path: "/v1/imss_movements", body: params, idempotent: true }, options);
1047
+ }
1048
+ /**
1049
+ * Listar movimientos del IMSS
1050
+ *
1051
+ * Los movimientos del emisor por presentar (status=pending, por omisión: todos, del más antiguo al más reciente, como van en los archivos) o ya presentados (status=reported: los 500 más recientes).
1052
+ *
1053
+ * GET /v1/imss_movements
1054
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/list-imss-movements
1055
+ */
1056
+ list(params, options) {
1057
+ return this.#client.list({ path: "/v1/imss_movements", query: params }, options);
1058
+ }
1059
+ /**
1060
+ * Marcar movimientos como presentados
1061
+ *
1062
+ * Cuando el IMSS ya los recibió (el acuse de IDSE o la importación en SUA): pasan a reported y ya no cambian ni se borran. Con reported false vuelven a pendientes. Devuelve los movimientos como quedaron.
1063
+ *
1064
+ * POST /v1/imss_movements/report
1065
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/report-imss-movements
1066
+ */
1067
+ report(params, options) {
1068
+ return this.#client.request({ method: "POST", path: "/v1/imss_movements/report", body: params, idempotent: true }, options);
1069
+ }
1070
+ /**
1071
+ * Ver un movimiento del IMSS
1072
+ *
1073
+ * El movimiento con lo que el IMSS rechazaría en problems.
1074
+ *
1075
+ * GET /v1/imss_movements/{id}
1076
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/get-imss-movement
1077
+ */
1078
+ get(id, options) {
1079
+ return this.#client.request({ method: "GET", path: `/v1/imss_movements/${encodeURIComponent(id)}` }, options);
1080
+ }
1081
+ /**
1082
+ * Cambiar un movimiento del IMSS
1083
+ *
1084
+ * Solo uno pendiente: uno ya presentado se queda como lo tiene el IMSS.
1085
+ *
1086
+ * POST /v1/imss_movements/{id}
1087
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/update-imss-movement
1088
+ */
1089
+ update(id, params, options) {
1090
+ return this.#client.request({ method: "POST", path: `/v1/imss_movements/${encodeURIComponent(id)}`, body: params, idempotent: true }, options);
1091
+ }
1092
+ /**
1093
+ * Borrar un movimiento del IMSS
1094
+ *
1095
+ * Solo uno pendiente (por ejemplo, un alta registrada por error).
1096
+ *
1097
+ * DELETE /v1/imss_movements/{id}
1098
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/delete-imss-movement
1099
+ */
1100
+ delete(id, options) {
1101
+ return this.#client.request({ method: "DELETE", path: `/v1/imss_movements/${encodeURIComponent(id)}` }, options);
1102
+ }
1103
+ }
1104
+ /** Nómina: fiscalisto.imssFiles. */
1105
+ export class ImssFilesResource {
1106
+ #client;
1107
+ constructor(client) {
1108
+ this.#client = client;
1109
+ }
1110
+ /**
1111
+ * Archivos para IDSE o SUA
1112
+ *
1113
+ * Los archivos de los movimientos pendientes: para IDSE (formato de 168 posiciones, un archivo por tipo: reingresos, modificaciones de salario y bajas; necesita la guía de su subdelegación) o para importar en SUA (ASEG.TXT con las altas y MOVT.TXT con los demás). El salario se declara topado a 25 UMA y nunca abajo del mínimo. El emisor necesita employer_registration. Los que el IMSS rechazaría van en refused con su razón. No los marca como presentados: hágalo con POST /v1/imss_movements/report cuando el IMSS los reciba.
1114
+ *
1115
+ * POST /v1/imss_files
1116
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-files
1117
+ */
1118
+ create(params, options) {
1119
+ return this.#client.request({ method: "POST", path: "/v1/imss_files", body: params, idempotent: true }, options);
1120
+ }
1121
+ }
1013
1122
  /** Lotes: fiscalisto.invoiceBatches. */
1014
1123
  export class InvoiceBatchesResource {
1015
1124
  #client;
@@ -2286,6 +2395,9 @@ export class FiscalistoApi extends Core {
2286
2395
  employees = new EmployeesResource(this);
2287
2396
  payrollReceipts = new PayrollReceiptsResource(this);
2288
2397
  payrollBatches = new PayrollBatchesResource(this);
2398
+ payrollBankFiles = new PayrollBankFilesResource(this);
2399
+ imssMovements = new ImssMovementsResource(this);
2400
+ imssFiles = new ImssFilesResource(this);
2289
2401
  invoiceBatches = new InvoiceBatchesResource(this);
2290
2402
  taxIds = new TaxIdsResource(this);
2291
2403
  branches = new BranchesResource(this);