fiscalisto 0.1.21 → 0.1.23

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.
@@ -347,6 +347,8 @@ export interface Invoice {
347
347
  issuer: string;
348
348
  /** La sucursal (brn_…) desde donde se timbró, o null (el domicilio fiscal del emisor). Sus pagos y notas de crédito la siguen. */
349
349
  branch: string | null;
350
+ /** Su centro de costo (ccn_…), o null. El que mandó al crearla, o el que le puso o cambió después con POST /v1/invoices/{id}. */
351
+ cost_center: string | null;
350
352
  /** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
351
353
  type: "I" | "E" | "P" | "T" | "N";
352
354
  /** processing: el PAC no ha contestado (se resuelve sola; escuche invoice.stamped). valid: timbrada. pending: timbrada con una cancelación en espera del cliente. rejected: el SAT o el PAC no la aceptaron (ver error). canceled: cancelada. */
@@ -806,6 +808,24 @@ export interface Employee {
806
808
  department: string | null;
807
809
  /** Puesto (Puesto). */
808
810
  position: string | null;
811
+ /** CLABE de su cuenta, a donde le paga el archivo para el banco, o null. */
812
+ clabe: string | null;
813
+ /** Nombre(s) como en su CURP, o null (los archivos del IMSS lo separan con la CURP). */
814
+ given_names: string | null;
815
+ /** Primer apellido como en su CURP, o null. */
816
+ first_surname: string | null;
817
+ /** Segundo apellido, o null. */
818
+ second_surname: string | null;
819
+ /** Tipo de trabajador del IMSS: 1 permanente, 2 eventual de la ciudad, 3 eventual de la construcción, 4 eventual del campo. */
820
+ imss_worker_type: string;
821
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. */
822
+ imss_salary_type: string;
823
+ /** Semana o jornada reducida: 0 normal, 1 a 5 días a la semana, 6 jornada de menos de 8 horas. */
824
+ imss_reduced_week: string;
825
+ /** Unidad de medicina familiar del IMSS, o null. */
826
+ family_medicine_unit: string | null;
827
+ /** Causa de la baja ante el IMSS cuando tiene end_date (2 separación voluntaria por omisión), o null. */
828
+ exit_reason: string | null;
809
829
  /** Lo que el SAT podría observar de sus datos, antes de timbrar. */
810
830
  warnings: string[];
811
831
  /** Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00). */
@@ -1119,6 +1139,139 @@ export interface PayrollBatch {
1119
1139
  } | null;
1120
1140
  }[];
1121
1141
  }
1142
+ /** El archivo para pagar la nómina desde el portal del banco (no cobra nada). */
1143
+ export interface PayrollBankFile {
1144
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1145
+ object: "payroll_bank_file";
1146
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1147
+ livemode: boolean;
1148
+ /** El emisor (iss_…). */
1149
+ issuer: string;
1150
+ /** El formato del banco: bbva, banamex, banorte, santander o spei (CSV). */
1151
+ layout: "bbva" | "banamex" | "banorte" | "santander" | "spei";
1152
+ /** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
1153
+ payment_date: string;
1154
+ /** La CLABE de la cuenta de cargo. */
1155
+ account: string | null;
1156
+ /** El nombre con que el portal del banco lo espera. */
1157
+ file_name: string;
1158
+ /** text/plain para los portales de los bancos, text/csv para spei. */
1159
+ content_type: "text/plain" | "text/csv";
1160
+ /** El archivo como texto, con renglones terminados en CR LF. */
1161
+ content: string;
1162
+ /** El mismo archivo en Windows-1252 (ANSI), en base64: guárdelo tal cual para subirlo. */
1163
+ content_base64: string;
1164
+ /** Total en la moneda del comprobante (Total). */
1165
+ total: number;
1166
+ /** Cuántos pagos lleva. */
1167
+ count: number;
1168
+ /** Cada pago del archivo, en el orden en que va. */
1169
+ payments: {
1170
+ /** El empleado (emp_…); null si el recibo lo timbró otro sistema y no hay empleado con ese RFC. */
1171
+ employee: string | null;
1172
+ /** Número de empleado (NumEmpleado). */
1173
+ number: string | null;
1174
+ /** Nombre. */
1175
+ name: string;
1176
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1177
+ tax_id: string;
1178
+ /** El neto a pagar: la suma de sus recibos con esa fecha de pago. */
1179
+ amount: number;
1180
+ /** La CLABE a donde se paga. */
1181
+ clabe: string;
1182
+ /** true: a otro banco por SPEI; false: a una cuenta del mismo banco. */
1183
+ spei: boolean;
1184
+ /** Serie y folio de los recibos que paga. */
1185
+ receipts: string[];
1186
+ }[];
1187
+ /** Quién no va en el archivo y por qué (sin CLABE, otro banco…). */
1188
+ excluded: {
1189
+ /** El empleado (emp_…); null si el recibo lo timbró otro sistema y no hay empleado con ese RFC. */
1190
+ employee: string | null;
1191
+ /** Número de empleado (NumEmpleado). */
1192
+ number: string | null;
1193
+ /** Nombre. */
1194
+ name: string;
1195
+ /** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
1196
+ tax_id: string;
1197
+ /** El neto a pagar: la suma de sus recibos con esa fecha de pago. */
1198
+ amount: number;
1199
+ /** Por qué no va en el archivo. */
1200
+ reason: string;
1201
+ }[];
1202
+ }
1203
+ /** Un movimiento afiliatorio del IMSS de un empleado: alta, modificación de salario, baja o reingreso. */
1204
+ export interface ImssMovement {
1205
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1206
+ id: string;
1207
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1208
+ livemode: boolean;
1209
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1210
+ object: "imss_movement";
1211
+ /** El emisor (iss_…). */
1212
+ issuer: string;
1213
+ /** El empleado (emp_…). */
1214
+ employee: string;
1215
+ /** Su número de empleado. */
1216
+ employee_number: string;
1217
+ /** Su nombre completo. */
1218
+ employee_name: string;
1219
+ /** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
1220
+ social_security_number: string;
1221
+ /** alta, reingreso, modificacion (de salario) o baja. */
1222
+ kind: "alta" | "reingreso" | "modificacion" | "baja";
1223
+ /** El tipo de movimiento del IMSS: 08 alta o reingreso, 07 modificación, 02 baja. */
1224
+ movement_type: "08" | "07" | "02";
1225
+ /** Fecha de emisión (Fecha), hora de la Ciudad de México. */
1226
+ date: string;
1227
+ /** Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario. */
1228
+ integrated_daily_salary: number | null;
1229
+ /** En bajas, la causa (1 a 9 o A); null en los demás. */
1230
+ exit_reason: string | null;
1231
+ /** automatic: lo registró el alta o el cambio del empleado; manual: se agregó a mano. */
1232
+ source: "automatic" | "manual";
1233
+ /** pending: falta presentarlo al IMSS; reported: ya se presentó (ya no cambia). */
1234
+ status: "pending" | "reported";
1235
+ /** Cuándo se marcó como presentado, o null. */
1236
+ reported_at: string | null;
1237
+ /** Lo que el IMSS rechazaría en su renglón (vacío: listo para el archivo). */
1238
+ problems: string[];
1239
+ }
1240
+ /** Los archivos para presentar movimientos en IDSE o importarlos en SUA. */
1241
+ export interface ImssFiles {
1242
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1243
+ object: "imss_files";
1244
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1245
+ livemode: boolean;
1246
+ /** El emisor (iss_…). */
1247
+ issuer: string;
1248
+ /** idse o sua. */
1249
+ format: "idse" | "sua";
1250
+ /** Los archivos: en IDSE uno por tipo de movimiento; en SUA ASEG.TXT y MOVT.TXT. */
1251
+ files: {
1252
+ /** El nombre del archivo. */
1253
+ file_name: string;
1254
+ /** Qué lleva, en palabras. */
1255
+ description: string;
1256
+ /** Cuántos movimientos lleva. */
1257
+ count: number;
1258
+ /** El archivo como texto, renglones terminados en CR LF. */
1259
+ content: string;
1260
+ /** El archivo en Windows-1252 (ANSI, como lo leen IDSE y SUA), en base64. */
1261
+ content_base64: string;
1262
+ }[];
1263
+ /** Los movimientos que van en los archivos. */
1264
+ movements: string[];
1265
+ /** Los que se quedaron fuera y por qué (un NSS inválido…). */
1266
+ refused: {
1267
+ /** El movimiento (imv_…). */
1268
+ movement: string;
1269
+ /** El nombre del empleado. */
1270
+ employee_name: string;
1271
+ /** Lo que el IMSS rechazaría en su renglón. */
1272
+ problems: string[];
1273
+ }[];
1274
+ }
1122
1275
  /** Una clave de un catálogo del SAT. */
1123
1276
  export interface SatCatalogEntry {
1124
1277
  /** La clave en el catálogo del SAT. */
@@ -1431,6 +1584,8 @@ export interface SatInvoice {
1431
1584
  };
1432
1585
  /** Su estado en el SAT cuando se revisó: active (vigente) o canceled. null si aún no se revisa. */
1433
1586
  sat_status: "active" | "canceled" | null;
1587
+ /** Su centro de costo (ccn_…), o null. Póngalo o cámbielo con POST /v1/sat_invoices/{id}. */
1588
+ cost_center: string | null;
1434
1589
  /** La descarga (sdl_…) que la trajo, o null. */
1435
1590
  sat_download: string | null;
1436
1591
  /** Cuándo llegó. */
@@ -1643,6 +1798,29 @@ export interface Branch {
1643
1798
  /** Cuándo cambió por última vez. */
1644
1799
  updated_at: string | null;
1645
1800
  }
1801
+ /** Un centro de costo del emisor: una obra, proyecto, sucursal o área por la que separa sus ingresos y gastos. */
1802
+ export interface CostCenter {
1803
+ /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
1804
+ id: string;
1805
+ /** true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. */
1806
+ livemode: boolean;
1807
+ /** Qué tipo de objeto es («invoice», «customer»…). */
1808
+ object: "cost_center";
1809
+ /** El emisor del centro de costo. */
1810
+ issuer: string;
1811
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». */
1812
+ name: string;
1813
+ /** Su clave (por ejemplo «CC-01»), o null. */
1814
+ code: string | null;
1815
+ /** true si está archivado: ya no se ponen facturas en él, pero las suyas lo conservan. */
1816
+ archived: boolean;
1817
+ /** Cuántas facturas tiene, emitidas y recibidas. */
1818
+ invoices: number;
1819
+ /** Cuándo se creó. */
1820
+ created_at: string | null;
1821
+ /** Cuándo cambió por última vez. */
1822
+ updated_at: string | null;
1823
+ }
1646
1824
  /** Un almacén del emisor: el de la Matriz y uno por sucursal se crean solos; cada factura saca existencias del de su sucursal. */
1647
1825
  export interface Warehouse {
1648
1826
  /** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
@@ -3052,6 +3230,16 @@ export interface PayrollBatchList {
3052
3230
  /** La ruta de esta lista. */
3053
3231
  url: string;
3054
3232
  }
3233
+ export interface ImssMovementList {
3234
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3235
+ object: "list";
3236
+ /** Los objetos de esta página. */
3237
+ data: ImssMovement[];
3238
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3239
+ has_more: boolean;
3240
+ /** La ruta de esta lista. */
3241
+ url: string;
3242
+ }
3055
3243
  export interface InvoiceBatchList {
3056
3244
  /** Qué tipo de objeto es («invoice», «customer»…). */
3057
3245
  object: "list";
@@ -3072,6 +3260,16 @@ export interface BranchList {
3072
3260
  /** La ruta de esta lista. */
3073
3261
  url: string;
3074
3262
  }
3263
+ export interface CostCenterList {
3264
+ /** Qué tipo de objeto es («invoice», «customer»…). */
3265
+ object: "list";
3266
+ /** Los objetos de esta página. */
3267
+ data: CostCenter[];
3268
+ /** true si hay más: pida la siguiente con starting_after igual al id del último. */
3269
+ has_more: boolean;
3270
+ /** La ruta de esta lista. */
3271
+ url: string;
3272
+ }
3075
3273
  export interface CustomerList {
3076
3274
  /** Qué tipo de objeto es («invoice», «customer»…). */
3077
3275
  object: "list";
@@ -3308,6 +3506,8 @@ export interface InvoiceCreate {
3308
3506
  issuer?: string;
3309
3507
  /** Sucursal (brn_…) desde donde se factura: su código postal va en LugarExpedicion, su dirección en el PDF y, si las tiene, sus series. Sin ella, el domicilio fiscal del emisor (la Matriz). */
3310
3508
  branch?: string;
3509
+ /** Su centro de costo (ccn_…): la obra, proyecto, sucursal o área a la que pertenece, para ver ingresos y gastos por centro en Reportes. No cambia el CFDI. Sus notas de crédito lo toman solas. */
3510
+ cost_center?: string;
3311
3511
  /** Almacén (whs_…) de donde salen sus productos con track_stock. Por omisión, el de su sucursal (o el de la Matriz). */
3312
3512
  warehouse?: string;
3313
3513
  /** Cliente (Receptor): el id de uno de su catálogo (cus_…) o sus datos en un objeto. */
@@ -4440,6 +4640,8 @@ export interface ListInvoicesParams {
4440
4640
  created_gte?: string;
4441
4641
  /** Creadas hasta, en ISO 8601. Un día solo (2026-10-31) incluye el día completo en hora de la Ciudad de México. */
4442
4642
  created_lte?: string;
4643
+ /** Solo las de este centro de costo (ccn_…), o none para las que no tienen. */
4644
+ cost_center?: string;
4443
4645
  }
4444
4646
  /** Los parámetros de GET /v1/invoices/{id}. */
4445
4647
  export interface GetInvoiceParams {
@@ -4448,6 +4650,10 @@ export interface GetInvoiceParams {
4448
4650
  /** true para preguntar su estado al SAT ahora (cancelaciones en espera). */
4449
4651
  refresh?: boolean;
4450
4652
  }
4653
+ export interface UpdateInvoiceParams {
4654
+ /** Su centro de costo (ccn_…), o null para quitárselo. Solo facturas, notas de crédito y recibos de nómina timbrados. */
4655
+ cost_center?: string | null;
4656
+ }
4451
4657
  /** Los parámetros de GET /v1/invoices/{id}/pdf. */
4452
4658
  export interface GetInvoicePdfParams {
4453
4659
  /** Con un UUID en vez del id, el emisor (iss_…) si la cuenta tiene varios. */
@@ -5089,6 +5295,24 @@ export interface CreateEmployeeParams {
5089
5295
  department?: string | null;
5090
5296
  /** Puesto (Puesto). */
5091
5297
  position?: string | null;
5298
+ /** CLABE de 18 dígitos de la cuenta del empleado: a donde le paga el archivo para el banco (POST /v1/payroll_bank_files). */
5299
+ clabe?: string | null;
5300
+ /** 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. */
5301
+ given_names?: string | null;
5302
+ /** Primer apellido, como en su CURP. */
5303
+ first_surname?: string | null;
5304
+ /** Segundo apellido (vacío si tiene uno). */
5305
+ second_surname?: string | null;
5306
+ /** 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. */
5307
+ imss_worker_type?: "1" | "2" | "3" | "4";
5308
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. Por omisión 0. */
5309
+ imss_salary_type?: "0" | "1" | "2";
5310
+ /** 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. */
5311
+ imss_reduced_week?: "0" | "1" | "2" | "3" | "4" | "5" | "6";
5312
+ /** Unidad de medicina familiar (UMF) del IMSS, opcional. */
5313
+ family_medicine_unit?: string | null;
5314
+ /** 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. */
5315
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5092
5316
  }
5093
5317
  /** Los parámetros de GET /v1/employees. */
5094
5318
  export interface ListEmployeesParams {
@@ -5140,6 +5364,24 @@ export interface UpdateEmployeeParams {
5140
5364
  department?: string | null;
5141
5365
  /** Puesto (Puesto). */
5142
5366
  position?: string | null;
5367
+ /** CLABE de 18 dígitos de la cuenta del empleado: a donde le paga el archivo para el banco (POST /v1/payroll_bank_files). */
5368
+ clabe?: string | null;
5369
+ /** 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. */
5370
+ given_names?: string | null;
5371
+ /** Primer apellido, como en su CURP. */
5372
+ first_surname?: string | null;
5373
+ /** Segundo apellido (vacío si tiene uno). */
5374
+ second_surname?: string | null;
5375
+ /** 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. */
5376
+ imss_worker_type?: "1" | "2" | "3" | "4";
5377
+ /** Tipo de salario del IMSS: 0 fijo, 1 variable, 2 mixto. Por omisión 0. */
5378
+ imss_salary_type?: "0" | "1" | "2";
5379
+ /** 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. */
5380
+ imss_reduced_week?: "0" | "1" | "2" | "3" | "4" | "5" | "6";
5381
+ /** Unidad de medicina familiar (UMF) del IMSS, opcional. */
5382
+ family_medicine_unit?: string | null;
5383
+ /** 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. */
5384
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5143
5385
  }
5144
5386
  export interface CreatePayrollReceiptParams {
5145
5387
  /** El empleado (emp_…). */
@@ -5232,6 +5474,73 @@ export interface ListPayrollBatchesParams {
5232
5474
  /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5233
5475
  issuer?: string;
5234
5476
  }
5477
+ export interface CreatePayrollBankFileParams {
5478
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5479
+ issuer?: string;
5480
+ /** 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. */
5481
+ payment_date: string;
5482
+ /** 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. */
5483
+ layout?: "bbva" | "banamex" | "banorte" | "santander" | "spei";
5484
+ /** 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. */
5485
+ account?: string;
5486
+ /** El archivo del día (1 a 99): un segundo archivo el mismo día lleva otro número. Por omisión 1. */
5487
+ sequence?: number;
5488
+ /** Banamex: su número de cliente de BancaNet (12 dígitos). */
5489
+ client_number?: string;
5490
+ /** Banorte: su número de emisora (5 dígitos). */
5491
+ issuer_number?: string;
5492
+ }
5493
+ export interface CreateImssMovementParams {
5494
+ /** El empleado (emp_…). */
5495
+ employee: string;
5496
+ /** alta (o reingreso): tipo 08; modificacion: cambio de salario, tipo 07; baja: tipo 02. */
5497
+ kind: "alta" | "reingreso" | "modificacion" | "baja";
5498
+ /** 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. */
5499
+ date: string;
5500
+ /** 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. */
5501
+ integrated_daily_salary?: number | null;
5502
+ /** 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. */
5503
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5504
+ }
5505
+ /** Los parámetros de GET /v1/imss_movements. */
5506
+ export interface ListImssMovementsParams {
5507
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
5508
+ limit?: number;
5509
+ /** El id del último de la página anterior, para la siguiente. */
5510
+ starting_after?: string;
5511
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5512
+ issuer?: string;
5513
+ /** pending (por omisión) o reported. */
5514
+ status?: "pending" | "reported";
5515
+ }
5516
+ export interface ReportImssMovementsParams {
5517
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5518
+ issuer?: string;
5519
+ /** Los movimientos (imv_…) que el IMSS ya recibió, hasta 1,000. */
5520
+ movements: string[];
5521
+ /** true (por omisión): marcarlos como presentados; false: devolverlos a pendientes (si los marcó por error). */
5522
+ reported?: boolean;
5523
+ }
5524
+ export interface UpdateImssMovementParams {
5525
+ /** alta (o reingreso): tipo 08; modificacion: cambio de salario, tipo 07; baja: tipo 02. */
5526
+ kind?: "alta" | "reingreso" | "modificacion" | "baja";
5527
+ /** 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. */
5528
+ date?: string;
5529
+ /** 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. */
5530
+ integrated_daily_salary?: number | null;
5531
+ /** 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. */
5532
+ exit_reason?: "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "A" | null;
5533
+ }
5534
+ export interface CreateImssFilesParams {
5535
+ /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5536
+ issuer?: string;
5537
+ /** 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. */
5538
+ format: "idse" | "sua";
5539
+ /** Los movimientos (imv_…) pendientes que van en los archivos. Por omisión, todos los pendientes. */
5540
+ movements?: string[];
5541
+ /** IDSE: la guía de 5 dígitos de su subdelegación. Por omisión, la que se guardó en la app. */
5542
+ guide?: string;
5543
+ }
5235
5544
  export interface CreateInvoiceBatchParams {
5236
5545
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5237
5546
  issuer?: string;
@@ -5355,6 +5664,38 @@ export interface UpdateBranchParams {
5355
5664
  /** true la archiva: ya no se puede facturar desde ella, y sus facturas la siguen nombrando. false la restaura. */
5356
5665
  archived?: boolean;
5357
5666
  }
5667
+ export interface CreateCostCenterParams {
5668
+ /** El emisor (iss_…). Por omisión, su único emisor. */
5669
+ issuer?: string;
5670
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». No se repite en el emisor (sin importar mayúsculas). */
5671
+ name: string;
5672
+ /** Su clave, si su contabilidad usa claves (por ejemplo «CC-01»). */
5673
+ code?: string | null;
5674
+ }
5675
+ /** Los parámetros de GET /v1/cost_centers. */
5676
+ export interface ListCostCentersParams {
5677
+ /** Cuántos por página, de 1 a 100. Por omisión 10. */
5678
+ limit?: number;
5679
+ /** El id del último de la página anterior, para la siguiente. */
5680
+ starting_after?: string;
5681
+ /** El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. */
5682
+ issuer?: string;
5683
+ /** true para incluir los archivados. */
5684
+ include_archived?: boolean;
5685
+ }
5686
+ export interface UpdateCostCenterParams {
5687
+ /** Cómo lo llama su equipo, por ejemplo «Obra Norte». No se repite en el emisor (sin importar mayúsculas). */
5688
+ name?: string;
5689
+ /** Su clave, si su contabilidad usa claves (por ejemplo «CC-01»). */
5690
+ code?: string | null;
5691
+ /** true lo archiva: ya no se pueden poner facturas en él, pero las suyas lo conservan. false lo restaura. */
5692
+ archived?: boolean;
5693
+ }
5694
+ /** Los parámetros de DELETE /v1/cost_centers/{id}. */
5695
+ export interface DeleteCostCenterParams {
5696
+ /** Otro centro de costo (ccn_…) que se queda con sus facturas. */
5697
+ move_to?: string;
5698
+ }
5358
5699
  export interface CreateCustomerParams {
5359
5700
  /** Emisor (iss_…). Si la llave tiene un solo emisor o la cuenta tiene uno solo, puede omitirse. */
5360
5701
  issuer?: string;
@@ -5712,6 +6053,12 @@ export interface ListSatInvoicesParams {
5712
6053
  date_gte?: string;
5713
6054
  /** Con fecha hasta este día (AAAA-MM-DD), incluido. */
5714
6055
  date_lte?: string;
6056
+ /** Solo las de este centro de costo (ccn_…), o none para las que no tienen. */
6057
+ cost_center?: string;
6058
+ }
6059
+ export interface UpdateSatInvoiceParams {
6060
+ /** Su centro de costo (ccn_…), o null para quitárselo. Los complementos de pago y los traslados no llevan. */
6061
+ cost_center?: string | null;
5715
6062
  }
5716
6063
  export interface RefreshSatDeclarationsParams {
5717
6064
  /** El emisor (iss_…). Por omisión, su único emisor. */
@@ -6738,6 +7085,15 @@ export declare class InvoicesResource {
6738
7085
  * @see https://fiscalisto.com/docs/api/referencia/facturas/get-invoice
6739
7086
  */
6740
7087
  get(id: string, params?: GetInvoiceParams, options?: RequestOptions): Promise<Invoice>;
7088
+ /**
7089
+ * Actualizar una factura
7090
+ *
7091
+ * Lo que se puede cambiar de una factura timbrada sin tocar el CFDI: su centro de costo (cost_center, o null para quitárselo). Los complementos de pago y los traslados no llevan.
7092
+ *
7093
+ * POST /v1/invoices/{id}
7094
+ * @see https://fiscalisto.com/docs/api/referencia/facturas/update-invoice
7095
+ */
7096
+ update(id: string, params?: UpdateInvoiceParams, options?: RequestOptions): Promise<Invoice>;
6741
7097
  /**
6742
7098
  * Descargar el PDF
6743
7099
  *
@@ -7221,6 +7577,93 @@ export declare class PayrollBatchesResource {
7221
7577
  */
7222
7578
  get(id: string, options?: RequestOptions): Promise<PayrollBatch>;
7223
7579
  }
7580
+ /** Nómina: fiscalisto.payrollBankFiles. */
7581
+ export declare class PayrollBankFilesResource {
7582
+ #private;
7583
+ constructor(client: Client);
7584
+ /**
7585
+ * Archivo para pagar la nómina en el banco
7586
+ *
7587
+ * 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.
7588
+ *
7589
+ * POST /v1/payroll_bank_files
7590
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-payroll-bank-file
7591
+ */
7592
+ create(params: CreatePayrollBankFileParams, options?: RequestOptions): Promise<PayrollBankFile>;
7593
+ }
7594
+ /** Nómina: fiscalisto.imssMovements. */
7595
+ export declare class ImssMovementsResource {
7596
+ #private;
7597
+ constructor(client: Client);
7598
+ /**
7599
+ * Agregar un movimiento del IMSS
7600
+ *
7601
+ * 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.
7602
+ *
7603
+ * POST /v1/imss_movements
7604
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-movement
7605
+ */
7606
+ create(params: CreateImssMovementParams, options?: RequestOptions): Promise<ImssMovement>;
7607
+ /**
7608
+ * Listar movimientos del IMSS
7609
+ *
7610
+ * 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).
7611
+ *
7612
+ * GET /v1/imss_movements
7613
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/list-imss-movements
7614
+ */
7615
+ list(params?: ListImssMovementsParams, options?: RequestOptions): List<ImssMovement>;
7616
+ /**
7617
+ * Marcar movimientos como presentados
7618
+ *
7619
+ * 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.
7620
+ *
7621
+ * POST /v1/imss_movements/report
7622
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/report-imss-movements
7623
+ */
7624
+ report(params: ReportImssMovementsParams, options?: RequestOptions): Promise<ImssMovementList>;
7625
+ /**
7626
+ * Ver un movimiento del IMSS
7627
+ *
7628
+ * El movimiento con lo que el IMSS rechazaría en problems.
7629
+ *
7630
+ * GET /v1/imss_movements/{id}
7631
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/get-imss-movement
7632
+ */
7633
+ get(id: string, options?: RequestOptions): Promise<ImssMovement>;
7634
+ /**
7635
+ * Cambiar un movimiento del IMSS
7636
+ *
7637
+ * Solo uno pendiente: uno ya presentado se queda como lo tiene el IMSS.
7638
+ *
7639
+ * POST /v1/imss_movements/{id}
7640
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/update-imss-movement
7641
+ */
7642
+ update(id: string, params?: UpdateImssMovementParams, options?: RequestOptions): Promise<ImssMovement>;
7643
+ /**
7644
+ * Borrar un movimiento del IMSS
7645
+ *
7646
+ * Solo uno pendiente (por ejemplo, un alta registrada por error).
7647
+ *
7648
+ * DELETE /v1/imss_movements/{id}
7649
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/delete-imss-movement
7650
+ */
7651
+ delete(id: string, options?: RequestOptions): Promise<Deleted>;
7652
+ }
7653
+ /** Nómina: fiscalisto.imssFiles. */
7654
+ export declare class ImssFilesResource {
7655
+ #private;
7656
+ constructor(client: Client);
7657
+ /**
7658
+ * Archivos para IDSE o SUA
7659
+ *
7660
+ * 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.
7661
+ *
7662
+ * POST /v1/imss_files
7663
+ * @see https://fiscalisto.com/docs/api/referencia/nomina/create-imss-files
7664
+ */
7665
+ create(params: CreateImssFilesParams, options?: RequestOptions): Promise<ImssFiles>;
7666
+ }
7224
7667
  /** Lotes: fiscalisto.invoiceBatches. */
7225
7668
  export declare class InvoiceBatchesResource {
7226
7669
  #private;
@@ -7317,6 +7760,56 @@ export declare class BranchesResource {
7317
7760
  */
7318
7761
  delete(id: string, options?: RequestOptions): Promise<Deleted>;
7319
7762
  }
7763
+ /** Centros de costo: fiscalisto.costCenters. */
7764
+ export declare class CostCentersResource {
7765
+ #private;
7766
+ constructor(client: Client);
7767
+ /**
7768
+ * Crear un centro de costo
7769
+ *
7770
+ * Una parte del negocio del emisor que quiere ver por separado: una obra, un proyecto, una sucursal, un área. Sus facturas lo toman con cost_center al crearlas, o después con POST /v1/invoices/{id} y POST /v1/sat_invoices/{id}. Un nombre que ya existe contesta cost_center_exists. Hasta 500 por emisor.
7771
+ *
7772
+ * POST /v1/cost_centers
7773
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/create-cost-center
7774
+ */
7775
+ create(params: CreateCostCenterParams, options?: RequestOptions): Promise<CostCenter>;
7776
+ /**
7777
+ * Listar centros de costo
7778
+ *
7779
+ * Los centros de costo del emisor, los más recientes primero, con cuántas facturas tiene cada uno. Los archivados solo con include_archived=true.
7780
+ *
7781
+ * GET /v1/cost_centers
7782
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/list-cost-centers
7783
+ */
7784
+ list(params?: ListCostCentersParams, options?: RequestOptions): List<CostCenter>;
7785
+ /**
7786
+ * Ver un centro de costo
7787
+ *
7788
+ * Un centro de costo del emisor.
7789
+ *
7790
+ * GET /v1/cost_centers/{id}
7791
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/get-cost-center
7792
+ */
7793
+ get(id: string, options?: RequestOptions): Promise<CostCenter>;
7794
+ /**
7795
+ * Actualizar un centro de costo
7796
+ *
7797
+ * Cambia solo lo que manda. archived: true lo archiva (ya no se ponen facturas en él y las suyas lo conservan), false lo restaura.
7798
+ *
7799
+ * POST /v1/cost_centers/{id}
7800
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/update-cost-center
7801
+ */
7802
+ update(id: string, params?: UpdateCostCenterParams, options?: RequestOptions): Promise<CostCenter>;
7803
+ /**
7804
+ * Borrar un centro de costo
7805
+ *
7806
+ * Sus facturas pasan a move_to (así junta dos en uno) o se quedan sin centro de costo. No se puede deshacer; para dejar de usarlo sin tocar sus facturas, archívelo.
7807
+ *
7808
+ * DELETE /v1/cost_centers/{id}
7809
+ * @see https://fiscalisto.com/docs/api/referencia/centros-de-costo/delete-cost-center
7810
+ */
7811
+ delete(id: string, params?: DeleteCostCenterParams, options?: RequestOptions): Promise<Deleted>;
7812
+ }
7320
7813
  /** Clientes: fiscalisto.customers. */
7321
7814
  export declare class CustomersResource {
7322
7815
  #private;
@@ -7696,6 +8189,15 @@ export declare class SatInvoicesResource {
7696
8189
  * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/get-sat-invoice
7697
8190
  */
7698
8191
  get(id: string, options?: RequestOptions): Promise<SatInvoice>;
8192
+ /**
8193
+ * Actualizar una factura del SAT
8194
+ *
8195
+ * Lo que se puede cambiar de un CFDI del SAT sin tocarlo: su centro de costo (cost_center, o null para quitárselo), para ver sus gastos por obra, proyecto o área.
8196
+ *
8197
+ * POST /v1/sat_invoices/{id}
8198
+ * @see https://fiscalisto.com/docs/api/referencia/descargas-del-sat/update-sat-invoice
8199
+ */
8200
+ update(id: string, params?: UpdateSatInvoiceParams, options?: RequestOptions): Promise<SatInvoice>;
7699
8201
  /**
7700
8202
  * Descargar el XML de una factura del SAT
7701
8203
  *
@@ -8251,9 +8753,13 @@ export declare class FiscalistoApi extends Core {
8251
8753
  readonly employees: EmployeesResource;
8252
8754
  readonly payrollReceipts: PayrollReceiptsResource;
8253
8755
  readonly payrollBatches: PayrollBatchesResource;
8756
+ readonly payrollBankFiles: PayrollBankFilesResource;
8757
+ readonly imssMovements: ImssMovementsResource;
8758
+ readonly imssFiles: ImssFilesResource;
8254
8759
  readonly invoiceBatches: InvoiceBatchesResource;
8255
8760
  readonly taxIds: TaxIdsResource;
8256
8761
  readonly branches: BranchesResource;
8762
+ readonly costCenters: CostCentersResource;
8257
8763
  readonly customers: CustomersResource;
8258
8764
  readonly customerDataRequests: CustomerDataRequestsResource;
8259
8765
  readonly products: ProductsResource;