fiscalisto 0.1.9 → 0.1.11
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/agent-guide.d.ts +1 -1
- package/dist/agent-guide.js +6 -0
- package/dist/cli.js +58 -8
- package/dist/core.d.ts +1 -1
- package/dist/core.js +1 -1
- package/dist/error-codes.d.ts +11 -3
- package/dist/error-codes.js +11 -3
- package/dist/generated.d.ts +559 -120
- package/dist/generated.js +22 -0
- package/dist/mock-routes.gen.js +1 -1
- package/package.json +1 -1
package/dist/generated.d.ts
CHANGED
|
@@ -118,6 +118,223 @@ export interface Issuer {
|
|
|
118
118
|
}
|
|
119
119
|
/** Un concepto, con los mismos campos con que se mandó. */
|
|
120
120
|
export type InvoiceItem = Record<string, unknown>;
|
|
121
|
+
/** El complemento de nómina 1.2 como se timbró: tipo, periodo, patrón, empleado, percepciones, deducciones, otros pagos, sus nodos y los totales. */
|
|
122
|
+
export interface InvoicePayroll {
|
|
123
|
+
/** TipoNomina: O ordinaria, E extraordinaria. */
|
|
124
|
+
type: "O" | "E";
|
|
125
|
+
/** fiscalisto: lo calculó Fiscalisto (POST /v1/payroll_receipts); external: lo calculó su sistema de nómina y se timbró tal cual (POST /v1/payroll_receipts/external). */
|
|
126
|
+
calculation: "fiscalisto" | "external";
|
|
127
|
+
/** Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual. */
|
|
128
|
+
periodicity: string;
|
|
129
|
+
/** Periodo pagado: FechaInicialPago, FechaFinalPago y FechaPago. */
|
|
130
|
+
period: {
|
|
131
|
+
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
132
|
+
start: string;
|
|
133
|
+
/** Último día del periodo (FechaFinalPago), AAAA-MM-DD. */
|
|
134
|
+
end: string;
|
|
135
|
+
/** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
|
|
136
|
+
payment_date: string;
|
|
137
|
+
};
|
|
138
|
+
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
139
|
+
days: number;
|
|
140
|
+
/** Los ids de su sistema de nómina (solo en recibos external). */
|
|
141
|
+
references: {
|
|
142
|
+
/** El id del empleado en su sistema de nómina. */
|
|
143
|
+
employee_id: string | null;
|
|
144
|
+
/** El id de la corrida de nómina en su sistema. */
|
|
145
|
+
payroll_run_id: string | null;
|
|
146
|
+
} | null;
|
|
147
|
+
/** El patrón (Emisor del complemento): registro patronal y CURP si es persona física. */
|
|
148
|
+
employer: {
|
|
149
|
+
/** Registro patronal ante el IMSS (RegistroPatronal), 11 caracteres. Necesario para timbrar nómina. */
|
|
150
|
+
employer_registration: string | null;
|
|
151
|
+
/** CURP, 18 caracteres. */
|
|
152
|
+
curp: string | null;
|
|
153
|
+
/** RFC del patrón de origen (RfcPatronOrigen). */
|
|
154
|
+
origin_tax_id?: string;
|
|
155
|
+
/** Entidad del SNCF (EntidadSNCF). */
|
|
156
|
+
sncf?: {
|
|
157
|
+
/** Origen del recurso (OrigenRecurso): IP, IF o IM. */
|
|
158
|
+
resource_origin: string;
|
|
159
|
+
/** Monto de recursos propios (MontoRecursoPropio), con IM. */
|
|
160
|
+
own_resource_amount: number | null;
|
|
161
|
+
};
|
|
162
|
+
};
|
|
163
|
+
/** El empleado (Nomina/Receptor), como se timbró. */
|
|
164
|
+
employee: {
|
|
165
|
+
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
166
|
+
id: string | null;
|
|
167
|
+
/** Número de empleado (NumEmpleado). */
|
|
168
|
+
number: string;
|
|
169
|
+
/** CURP, 18 caracteres. */
|
|
170
|
+
curp: string;
|
|
171
|
+
/** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
|
|
172
|
+
social_security_number: string | null;
|
|
173
|
+
/** Fecha de inicio de la relación laboral (FechaInicioRelLaboral), AAAA-MM-DD. */
|
|
174
|
+
start_date: string | null;
|
|
175
|
+
/** Antigüedad (P52W, P1Y2M3D). */
|
|
176
|
+
seniority: string | null;
|
|
177
|
+
/** Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. */
|
|
178
|
+
contract_type: string;
|
|
179
|
+
/** true si es sindicalizado (Sindicalizado). */
|
|
180
|
+
unionized: boolean | null;
|
|
181
|
+
/** Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna. */
|
|
182
|
+
workday_type: string | null;
|
|
183
|
+
/** Tipo de régimen (TipoRegimen): 02 sueldos y salarios. */
|
|
184
|
+
regime_type: string;
|
|
185
|
+
/** Departamento (Departamento). */
|
|
186
|
+
department: string | null;
|
|
187
|
+
/** Puesto (Puesto). */
|
|
188
|
+
position: string | null;
|
|
189
|
+
/** Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1. */
|
|
190
|
+
risk_class: string | null;
|
|
191
|
+
/** Salario base de cotización (SalarioBaseCotApor). */
|
|
192
|
+
contribution_base_salary: number | null;
|
|
193
|
+
/** Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario. */
|
|
194
|
+
integrated_daily_salary: number | null;
|
|
195
|
+
/** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
|
|
196
|
+
state: string;
|
|
197
|
+
/** Banco (Banco), c_Banco. */
|
|
198
|
+
bank?: string;
|
|
199
|
+
/** Cuenta bancaria o CLABE (CuentaBancaria). */
|
|
200
|
+
bank_account?: string;
|
|
201
|
+
/** Subcontratación (SubContratacion). */
|
|
202
|
+
subcontracting?: {
|
|
203
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
204
|
+
tax_id: string;
|
|
205
|
+
/** Porcentaje de tiempo (PorcentajeTiempo). */
|
|
206
|
+
percentage: number;
|
|
207
|
+
}[];
|
|
208
|
+
};
|
|
209
|
+
/** Percepciones (Percepcion): sueldo y demás, gravado y exento. */
|
|
210
|
+
perceptions: {
|
|
211
|
+
/** Tipo de percepción (TipoPercepcion), c_TipoPercepcion: 001 sueldos… */
|
|
212
|
+
type: string;
|
|
213
|
+
/** Clave del patrón (Clave). */
|
|
214
|
+
key: string;
|
|
215
|
+
/** Concepto (Concepto). */
|
|
216
|
+
concept: string;
|
|
217
|
+
/** Importe gravado (ImporteGravado). */
|
|
218
|
+
taxed: number;
|
|
219
|
+
/** Importe exento (ImporteExento). */
|
|
220
|
+
exempt: number;
|
|
221
|
+
/** Horas extra (HorasExtra), con la percepción 019. */
|
|
222
|
+
overtime?: {
|
|
223
|
+
/** Días con horas extra (Dias). */
|
|
224
|
+
days: number;
|
|
225
|
+
/** c_TipoHoras: 01 dobles, 02 triples, 03 simples. */
|
|
226
|
+
hours_type: string;
|
|
227
|
+
/** Horas extra (HorasExtra). */
|
|
228
|
+
hours: number;
|
|
229
|
+
/** Importe pagado (ImportePagado). */
|
|
230
|
+
amount_paid: number;
|
|
231
|
+
}[];
|
|
232
|
+
/** Acciones o títulos (AccionesOTitulos), con la percepción 045. */
|
|
233
|
+
stock_options?: {
|
|
234
|
+
/** Valor de mercado (ValorMercado). */
|
|
235
|
+
market_value: number;
|
|
236
|
+
/** Precio al otorgarse (PrecioAlOtorgarse). */
|
|
237
|
+
grant_price: number;
|
|
238
|
+
};
|
|
239
|
+
}[];
|
|
240
|
+
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
241
|
+
deductions: {
|
|
242
|
+
/** Tipo de deducción (TipoDeduccion), c_TipoDeduccion: 001 IMSS, 002 ISR… */
|
|
243
|
+
type: string;
|
|
244
|
+
/** Clave del patrón (Clave). */
|
|
245
|
+
key: string;
|
|
246
|
+
/** Concepto (Concepto). */
|
|
247
|
+
concept: string;
|
|
248
|
+
/** Importe (Importe). */
|
|
249
|
+
amount: number;
|
|
250
|
+
}[];
|
|
251
|
+
/** Otros pagos (OtroPago): subsidio para el empleo. */
|
|
252
|
+
other_payments: {
|
|
253
|
+
/** Tipo de otro pago (TipoOtroPago), c_TipoOtroPago: 002 subsidio para el empleo. */
|
|
254
|
+
type: string;
|
|
255
|
+
/** Clave del patrón (Clave). */
|
|
256
|
+
key: string;
|
|
257
|
+
/** Concepto (Concepto). */
|
|
258
|
+
concept: string;
|
|
259
|
+
/** Importe pagado (Importe). */
|
|
260
|
+
amount: number;
|
|
261
|
+
/** Subsidio causado (SubsidioCausado). */
|
|
262
|
+
subsidy_caused?: number;
|
|
263
|
+
/** Del subsidio causado, el ISR que evitó (no va en el XML). */
|
|
264
|
+
subsidy_applied?: number;
|
|
265
|
+
/** Compensación del saldo a favor (CompensacionSaldosAFavor), con el 004. */
|
|
266
|
+
balance_compensation?: {
|
|
267
|
+
/** Saldo a favor (SaldoAFavor). */
|
|
268
|
+
balance: number;
|
|
269
|
+
/** Año del saldo a favor (Año). */
|
|
270
|
+
year: number;
|
|
271
|
+
/** Remanente del saldo a favor (RemanenteSalFav). */
|
|
272
|
+
remaining: number;
|
|
273
|
+
};
|
|
274
|
+
}[];
|
|
275
|
+
/** SeparacionIndemnizacion (percepciones 022, 023, 025). */
|
|
276
|
+
separation?: {
|
|
277
|
+
/** Total pagado (TotalPagado). */
|
|
278
|
+
total_paid: number;
|
|
279
|
+
/** Años de servicio (NumAñosServicio). */
|
|
280
|
+
years_of_service: number;
|
|
281
|
+
/** Último sueldo mensual ordinario (UltimoSueldoMensOrd). */
|
|
282
|
+
last_monthly_salary: number;
|
|
283
|
+
/** Ingreso acumulable (IngresoAcumulable). */
|
|
284
|
+
accumulable_income: number;
|
|
285
|
+
/** Ingreso no acumulable (IngresoNoAcumulable). */
|
|
286
|
+
non_accumulable_income: number;
|
|
287
|
+
};
|
|
288
|
+
/** JubilacionPensionRetiro (percepciones 039, 044). */
|
|
289
|
+
retirement?: {
|
|
290
|
+
/** Total en una exhibición (TotalUnaExhibicion). */
|
|
291
|
+
total_one_payment?: number;
|
|
292
|
+
/** Total en parcialidades (TotalParcialidad). */
|
|
293
|
+
total_installment?: number;
|
|
294
|
+
/** Monto diario (MontoDiario). */
|
|
295
|
+
daily_amount?: number;
|
|
296
|
+
/** Ingreso acumulable (IngresoAcumulable). */
|
|
297
|
+
accumulable_income: number;
|
|
298
|
+
/** Ingreso no acumulable (IngresoNoAcumulable). */
|
|
299
|
+
non_accumulable_income: number;
|
|
300
|
+
};
|
|
301
|
+
/** Incapacidades (percepción 014 o deducción 006). */
|
|
302
|
+
disabilities?: {
|
|
303
|
+
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
304
|
+
days: number;
|
|
305
|
+
/** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
|
|
306
|
+
type: string;
|
|
307
|
+
/** Importe. */
|
|
308
|
+
amount: number | null;
|
|
309
|
+
}[];
|
|
310
|
+
/** Totales: percepciones, deducciones, otros pagos y el neto a pagar. */
|
|
311
|
+
totals: {
|
|
312
|
+
/** Total de sueldos, salarios y asimilados (TotalSueldos). */
|
|
313
|
+
salaries: number;
|
|
314
|
+
/** Total gravado (TotalGravado). */
|
|
315
|
+
taxed: number;
|
|
316
|
+
/** Total exento (TotalExento). */
|
|
317
|
+
exempt: number;
|
|
318
|
+
/** Total de separación e indemnización (TotalSeparacionIndemnizacion). */
|
|
319
|
+
separation: number;
|
|
320
|
+
/** Total de jubilación, pensión o retiro (TotalJubilacionPensionRetiro). */
|
|
321
|
+
retirement: number;
|
|
322
|
+
/** Total de percepciones (TotalPercepciones). */
|
|
323
|
+
perceptions: number;
|
|
324
|
+
/** Otras deducciones (TotalOtrasDeducciones). */
|
|
325
|
+
other_deductions: number;
|
|
326
|
+
/** Impuestos retenidos (TotalImpuestosRetenidos). */
|
|
327
|
+
taxes_withheld: number;
|
|
328
|
+
/** Total de deducciones (TotalDeducciones). */
|
|
329
|
+
deductions: number;
|
|
330
|
+
/** Total de otros pagos (TotalOtrosPagos). */
|
|
331
|
+
other_payments: number;
|
|
332
|
+
/** Subtotal del comprobante: percepciones más otros pagos. */
|
|
333
|
+
subtotal: number;
|
|
334
|
+
/** Neto a pagar al empleado. */
|
|
335
|
+
net: number;
|
|
336
|
+
};
|
|
337
|
+
}
|
|
121
338
|
/** Un CFDI 4.0 emitido: factura de ingreso o global, traslado, nota de crédito (E), complemento de pago (P) o recibo de nómina (N). */
|
|
122
339
|
export interface Invoice {
|
|
123
340
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
@@ -136,13 +353,13 @@ export interface Invoice {
|
|
|
136
353
|
status: "processing" | "pending" | "valid" | "rejected" | "canceled";
|
|
137
354
|
/** Folio fiscal que asigna el SAT (UUID del Timbre Fiscal Digital), en mayúsculas. */
|
|
138
355
|
uuid: string | null;
|
|
139
|
-
/**
|
|
356
|
+
/** La serie (Serie) con que se timbró, o null. */
|
|
140
357
|
series: string | null;
|
|
141
|
-
/**
|
|
358
|
+
/** El folio (Folio) que se le asignó, o null. */
|
|
142
359
|
folio: string | null;
|
|
143
360
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
144
361
|
date: string | null;
|
|
145
|
-
/**
|
|
362
|
+
/** El cliente (Receptor) como quedó en el CFDI: RFC, nombre, régimen fiscal y código postal (y foreign si es extranjero). */
|
|
146
363
|
customer: {
|
|
147
364
|
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
148
365
|
tax_id: string | null;
|
|
@@ -171,7 +388,7 @@ export interface Invoice {
|
|
|
171
388
|
subtotal: number | null;
|
|
172
389
|
/** Descuento (Descuento). */
|
|
173
390
|
discount: number | null;
|
|
174
|
-
/**
|
|
391
|
+
/** Los impuestos del comprobante sumados por tipo: IVA e IEPS trasladados, IVA e ISR retenidos e impuestos locales; null en un complemento de pago. */
|
|
175
392
|
taxes: {
|
|
176
393
|
/** IVA trasladado. */
|
|
177
394
|
iva: number | null;
|
|
@@ -231,100 +448,7 @@ export interface Invoice {
|
|
|
231
448
|
}[];
|
|
232
449
|
} | null;
|
|
233
450
|
/** Solo en un recibo de nómina (type N). */
|
|
234
|
-
payroll?:
|
|
235
|
-
/** Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual. */
|
|
236
|
-
periodicity: string;
|
|
237
|
-
/** Periodo (Periodo): mes inicial, mes final y año. */
|
|
238
|
-
period: {
|
|
239
|
-
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
240
|
-
start: string;
|
|
241
|
-
/** Último día del periodo (FechaFinalPago), AAAA-MM-DD. */
|
|
242
|
-
end: string;
|
|
243
|
-
/** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
|
|
244
|
-
payment_date: string;
|
|
245
|
-
};
|
|
246
|
-
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
247
|
-
days: number;
|
|
248
|
-
/** El patrón (Emisor del complemento): registro patronal y CURP si es persona física. */
|
|
249
|
-
employer: {
|
|
250
|
-
/** Registro patronal ante el IMSS (RegistroPatronal), 11 caracteres. Necesario para timbrar nómina. */
|
|
251
|
-
employer_registration: string | null;
|
|
252
|
-
/** CURP, 18 caracteres. */
|
|
253
|
-
curp: string | null;
|
|
254
|
-
};
|
|
255
|
-
/** El empleado (emp_…). */
|
|
256
|
-
employee: {
|
|
257
|
-
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
258
|
-
id: string | null;
|
|
259
|
-
/** Número de empleado (NumEmpleado). */
|
|
260
|
-
number: string;
|
|
261
|
-
/** CURP, 18 caracteres. */
|
|
262
|
-
curp: string;
|
|
263
|
-
/** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
|
|
264
|
-
social_security_number: string | null;
|
|
265
|
-
/** Fecha de inicio de la relación laboral (FechaInicioRelLaboral), AAAA-MM-DD. */
|
|
266
|
-
start_date: string;
|
|
267
|
-
/** Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. */
|
|
268
|
-
contract_type: string;
|
|
269
|
-
/** true si es sindicalizado (Sindicalizado). */
|
|
270
|
-
unionized: boolean;
|
|
271
|
-
/** Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna. */
|
|
272
|
-
workday_type: string;
|
|
273
|
-
/** Tipo de régimen (TipoRegimen): 02 sueldos y salarios. */
|
|
274
|
-
regime_type: string;
|
|
275
|
-
/** Departamento (Departamento). */
|
|
276
|
-
department?: string | null;
|
|
277
|
-
/** Puesto (Puesto). */
|
|
278
|
-
position?: string | null;
|
|
279
|
-
/** Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1. */
|
|
280
|
-
risk_class: string | null;
|
|
281
|
-
/** Salario base de cotización (SalarioBaseCotApor). */
|
|
282
|
-
contribution_base_salary: number | null;
|
|
283
|
-
/** Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario. */
|
|
284
|
-
integrated_daily_salary: number | null;
|
|
285
|
-
/** Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE… */
|
|
286
|
-
state: string;
|
|
287
|
-
};
|
|
288
|
-
/** Percepciones (Percepcion): sueldo y demás, gravado y exento. */
|
|
289
|
-
perceptions: {
|
|
290
|
-
/** Tipo de percepción (TipoPercepcion), c_TipoPercepcion: 001 sueldos… */
|
|
291
|
-
type: string;
|
|
292
|
-
/** Clave del patrón (Clave). */
|
|
293
|
-
key: string;
|
|
294
|
-
/** Concepto (Concepto). */
|
|
295
|
-
concept: string;
|
|
296
|
-
/** Importe gravado (ImporteGravado). */
|
|
297
|
-
taxed: number;
|
|
298
|
-
/** Importe exento (ImporteExento). */
|
|
299
|
-
exempt: number;
|
|
300
|
-
}[];
|
|
301
|
-
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
302
|
-
deductions: {
|
|
303
|
-
/** Tipo de deducción (TipoDeduccion), c_TipoDeduccion: 001 IMSS, 002 ISR… */
|
|
304
|
-
type: string;
|
|
305
|
-
/** Clave del patrón (Clave). */
|
|
306
|
-
key: string;
|
|
307
|
-
/** Concepto (Concepto). */
|
|
308
|
-
concept: string;
|
|
309
|
-
/** Importe (Importe). */
|
|
310
|
-
amount: number;
|
|
311
|
-
}[];
|
|
312
|
-
/** Otros pagos (OtroPago): subsidio para el empleo. */
|
|
313
|
-
other_payments: {
|
|
314
|
-
/** Tipo de otro pago (TipoOtroPago), c_TipoOtroPago: 002 subsidio para el empleo. */
|
|
315
|
-
type: string;
|
|
316
|
-
/** Clave del patrón (Clave). */
|
|
317
|
-
key: string;
|
|
318
|
-
/** Concepto (Concepto). */
|
|
319
|
-
concept: string;
|
|
320
|
-
/** Importe pagado (Importe). */
|
|
321
|
-
amount: number;
|
|
322
|
-
/** Subsidio causado (SubsidioCausado). */
|
|
323
|
-
subsidy_caused?: number;
|
|
324
|
-
/** Del subsidio causado, el ISR que evitó (no va en el XML). */
|
|
325
|
-
subsidy_applied?: number;
|
|
326
|
-
}[];
|
|
327
|
-
};
|
|
451
|
+
payroll?: InvoicePayroll;
|
|
328
452
|
/** Solo en una factura global. */
|
|
329
453
|
global?: Record<string, unknown>;
|
|
330
454
|
/** La cancelación, si se pidió: estado, motivo, sustituto y cuándo. */
|
|
@@ -405,7 +529,7 @@ export interface Retention {
|
|
|
405
529
|
status: "processing" | "valid" | "rejected" | "canceled";
|
|
406
530
|
/** Folio fiscal que asigna el SAT (UUID del Timbre Fiscal Digital), en mayúsculas. */
|
|
407
531
|
uuid: string | null;
|
|
408
|
-
/**
|
|
532
|
+
/** El número de la constancia en la serie del emisor (internal_folio es el que se imprime, RET1…). */
|
|
409
533
|
folio: number | null;
|
|
410
534
|
/** Folio interno (FolioInt): RET1, RET2… */
|
|
411
535
|
internal_folio: string | null;
|
|
@@ -674,7 +798,7 @@ export interface PayrollReceiptPreview {
|
|
|
674
798
|
employee: string;
|
|
675
799
|
/** Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual. */
|
|
676
800
|
periodicity: string;
|
|
677
|
-
/**
|
|
801
|
+
/** El periodo de pago: primer y último día y el día de pago (FechaInicialPago, FechaFinalPago y FechaPago). */
|
|
678
802
|
period: {
|
|
679
803
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
680
804
|
start: string;
|
|
@@ -699,6 +823,24 @@ export interface PayrollReceiptPreview {
|
|
|
699
823
|
taxed: number;
|
|
700
824
|
/** Importe exento (ImporteExento). */
|
|
701
825
|
exempt: number;
|
|
826
|
+
/** Horas extra (HorasExtra), con la percepción 019. */
|
|
827
|
+
overtime?: {
|
|
828
|
+
/** Días con horas extra (Dias). */
|
|
829
|
+
days: number;
|
|
830
|
+
/** c_TipoHoras: 01 dobles, 02 triples, 03 simples. */
|
|
831
|
+
hours_type: string;
|
|
832
|
+
/** Horas extra (HorasExtra). */
|
|
833
|
+
hours: number;
|
|
834
|
+
/** Importe pagado (ImportePagado). */
|
|
835
|
+
amount_paid: number;
|
|
836
|
+
}[];
|
|
837
|
+
/** Acciones o títulos (AccionesOTitulos), con la percepción 045. */
|
|
838
|
+
stock_options?: {
|
|
839
|
+
/** Valor de mercado (ValorMercado). */
|
|
840
|
+
market_value: number;
|
|
841
|
+
/** Precio al otorgarse (PrecioAlOtorgarse). */
|
|
842
|
+
grant_price: number;
|
|
843
|
+
};
|
|
702
844
|
}[];
|
|
703
845
|
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
704
846
|
deductions: {
|
|
@@ -725,6 +867,15 @@ export interface PayrollReceiptPreview {
|
|
|
725
867
|
subsidy_caused?: number;
|
|
726
868
|
/** Del subsidio causado, el ISR que evitó (no va en el XML). */
|
|
727
869
|
subsidy_applied?: number;
|
|
870
|
+
/** Compensación del saldo a favor (CompensacionSaldosAFavor), con el 004. */
|
|
871
|
+
balance_compensation?: {
|
|
872
|
+
/** Saldo a favor (SaldoAFavor). */
|
|
873
|
+
balance: number;
|
|
874
|
+
/** Año del saldo a favor (Año). */
|
|
875
|
+
year: number;
|
|
876
|
+
/** Remanente del saldo a favor (RemanenteSalFav). */
|
|
877
|
+
remaining: number;
|
|
878
|
+
};
|
|
728
879
|
}[];
|
|
729
880
|
/** El cálculo del ISR del periodo: base, tarifa, subsidio y resultado. */
|
|
730
881
|
isr: {
|
|
@@ -738,9 +889,9 @@ export interface PayrollReceiptPreview {
|
|
|
738
889
|
exempt_minimum: boolean;
|
|
739
890
|
/** El ajuste de fin de mes: subsidio revertido y el ISR que retiene. */
|
|
740
891
|
adjustment?: {
|
|
741
|
-
/**
|
|
892
|
+
/** El subsidio para el empleo que se revierte en el ajuste. */
|
|
742
893
|
reversed: number;
|
|
743
|
-
/** El
|
|
894
|
+
/** El ISR que se retiene después del ajuste. */
|
|
744
895
|
isr: number;
|
|
745
896
|
};
|
|
746
897
|
};
|
|
@@ -752,6 +903,10 @@ export interface PayrollReceiptPreview {
|
|
|
752
903
|
taxed: number;
|
|
753
904
|
/** Total exento (TotalExento). */
|
|
754
905
|
exempt: number;
|
|
906
|
+
/** Total de separación e indemnización (TotalSeparacionIndemnizacion). */
|
|
907
|
+
separation: number;
|
|
908
|
+
/** Total de jubilación, pensión o retiro (TotalJubilacionPensionRetiro). */
|
|
909
|
+
retirement: number;
|
|
755
910
|
/** Total de percepciones (TotalPercepciones). */
|
|
756
911
|
perceptions: number;
|
|
757
912
|
/** Otras deducciones (TotalOtrasDeducciones). */
|
|
@@ -768,6 +923,43 @@ export interface PayrollReceiptPreview {
|
|
|
768
923
|
net: number;
|
|
769
924
|
};
|
|
770
925
|
}
|
|
926
|
+
/** Un recibo calculado por su sistema, revisado y sin timbrar: lo que se timbraría, tal cual. */
|
|
927
|
+
export interface ExternalPayrollReceiptPreview {
|
|
928
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
929
|
+
object: "payroll_receipt_preview";
|
|
930
|
+
/** external: los importes son los que calculó su sistema. */
|
|
931
|
+
calculation: "external";
|
|
932
|
+
/** El emisor (iss_…). */
|
|
933
|
+
issuer: string;
|
|
934
|
+
/** El empleado como receptor del CFDI (Receptor). */
|
|
935
|
+
customer: {
|
|
936
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
937
|
+
tax_id: string;
|
|
938
|
+
/** Nombre o razón social tal como está en la constancia de situación fiscal, sin el régimen de capital (sin «S.A. de C.V.»). */
|
|
939
|
+
legal_name: string;
|
|
940
|
+
/** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
|
|
941
|
+
zip: string;
|
|
942
|
+
};
|
|
943
|
+
/** El recibo de nómina 1.2: empleado, periodo, percepciones, deducciones y otros pagos. */
|
|
944
|
+
payroll: InvoicePayroll;
|
|
945
|
+
/** SubTotal: percepciones más otros pagos. */
|
|
946
|
+
subtotal: number;
|
|
947
|
+
/** Descuento: las deducciones. */
|
|
948
|
+
discount: number;
|
|
949
|
+
/** Total: el neto a pagar. */
|
|
950
|
+
total: number;
|
|
951
|
+
/** Lo que el SAT podría observar; no impide timbrar. */
|
|
952
|
+
warnings: {
|
|
953
|
+
/** El campo de la solicitud. */
|
|
954
|
+
param: string;
|
|
955
|
+
/** 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. */
|
|
956
|
+
code: string;
|
|
957
|
+
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
958
|
+
message: string;
|
|
959
|
+
}[];
|
|
960
|
+
/** El XML que se mandaría al PAC, sin sello ni timbre: sus importes son exactamente los que mandó. */
|
|
961
|
+
unsigned_xml: string;
|
|
962
|
+
}
|
|
771
963
|
/** Un anticipo timbrado que aún no se aplica. */
|
|
772
964
|
export interface Advance {
|
|
773
965
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
@@ -776,11 +968,11 @@ export interface Advance {
|
|
|
776
968
|
uuid: string;
|
|
777
969
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
778
970
|
date: string;
|
|
779
|
-
/**
|
|
971
|
+
/** La serie (Serie) del anticipo, o null. */
|
|
780
972
|
series: string | null;
|
|
781
|
-
/**
|
|
973
|
+
/** El folio (Folio) del anticipo, o null. */
|
|
782
974
|
folio: string | null;
|
|
783
|
-
/**
|
|
975
|
+
/** El cliente del anticipo: RFC y nombre. */
|
|
784
976
|
customer: {
|
|
785
977
|
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
786
978
|
tax_id: string;
|
|
@@ -857,8 +1049,10 @@ export interface SatListCheck {
|
|
|
857
1049
|
name: string | null;
|
|
858
1050
|
/** true si el RFC aparece en alguna lista, aunque haya desvirtuado. */
|
|
859
1051
|
listed: boolean;
|
|
860
|
-
/** high: 69-B o 69-B Bis como presunto o definitivo (el SAT dice que simula operaciones; sus facturas no se pueden deducir). medium: una lista del art. 69 (no localizado, créditos firmes o exigibles, cancelados, sentencias, CSD sin efectos). none: no aparece, o ya desvirtuó o tiene sentencia favorable. */
|
|
861
|
-
risk: "high" | "medium" | "none";
|
|
1052
|
+
/** high: 69-B o 69-B Bis como presunto o definitivo (el SAT dice que simula operaciones; sus facturas no se pueden deducir). medium: una lista del art. 69 (no localizado, créditos firmes o exigibles, cancelados, sentencias, CSD sin efectos). none: no aparece en ninguna, con todas las listas al día, o ya desvirtuó o tiene sentencia favorable. unknown: no aparece, pero alguna lista no se pudo actualizar (vea lists_unavailable): no lo dé por limpio. */
|
|
1053
|
+
risk: "high" | "medium" | "none" | "unknown";
|
|
1054
|
+
/** true si todas las listas se leyeron con éxito en los últimos dos días. Con false, que no aparezca no significa que esté limpio. */
|
|
1055
|
+
verified: boolean;
|
|
862
1056
|
/** Cada lista en que aparece; vacía si no aparece en ninguna. */
|
|
863
1057
|
lists: {
|
|
864
1058
|
/** 69b: art. 69-B (operaciones simuladas). 69b_bis: art. 69-B Bis (pérdidas fiscales). 69: art. 69 (no localizados, adeudos, cancelados). */
|
|
@@ -876,6 +1070,8 @@ export interface SatListCheck {
|
|
|
876
1070
|
}[];
|
|
877
1071
|
/** Cuándo se actualizaron las listas por última vez (cada día a las 00:00 de la Ciudad de México). */
|
|
878
1072
|
lists_updated_at: string | null;
|
|
1073
|
+
/** Las listas que no se pudieron confirmar (su última actualización falló, falta o tiene más de dos días). Vacía si todas están al día. */
|
|
1074
|
+
lists_unavailable: string[];
|
|
879
1075
|
}
|
|
880
1076
|
/** Si los datos fiscales de un cliente van a pasar el SAT. */
|
|
881
1077
|
export interface TaxIdValidation {
|
|
@@ -1197,7 +1393,7 @@ export interface SatDeclaration {
|
|
|
1197
1393
|
fields: {
|
|
1198
1394
|
/** El renglón como lo imprime el SAT. */
|
|
1199
1395
|
label: string;
|
|
1200
|
-
/**
|
|
1396
|
+
/** El valor del renglón como lo trae la declaración (número o texto). */
|
|
1201
1397
|
value: number | string;
|
|
1202
1398
|
}[];
|
|
1203
1399
|
}[];
|
|
@@ -1205,7 +1401,7 @@ export interface SatDeclaration {
|
|
|
1205
1401
|
receipt: {
|
|
1206
1402
|
/** Cada impuesto del acuse. */
|
|
1207
1403
|
concepts: {
|
|
1208
|
-
/**
|
|
1404
|
+
/** El concepto de la línea de captura (ISR, IVA…) como lo da el SAT. */
|
|
1209
1405
|
concept: string;
|
|
1210
1406
|
/** Lo que resultó a cargo. */
|
|
1211
1407
|
due: number | null;
|
|
@@ -1434,7 +1630,7 @@ export interface StockMovement {
|
|
|
1434
1630
|
lot: string | null;
|
|
1435
1631
|
/** Lo que lo causó: type invoice (id es el UUID del CFDI), adjustment (adj_…), receipt, transfer, count o ticket. */
|
|
1436
1632
|
source: {
|
|
1437
|
-
/**
|
|
1633
|
+
/** Qué lo movió: invoice (una factura; id es su UUID), adjustment (un ajuste, adj_…), count (un conteo) u otro origen. */
|
|
1438
1634
|
type: string;
|
|
1439
1635
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
1440
1636
|
id: string;
|
|
@@ -1852,7 +2048,7 @@ export interface FinancialStatements {
|
|
|
1852
2048
|
month: {
|
|
1853
2049
|
/** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
|
|
1854
2050
|
sections: {
|
|
1855
|
-
/**
|
|
2051
|
+
/** La sección: ingresos, costos, gastos, financiamiento u otros. */
|
|
1856
2052
|
key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
|
|
1857
2053
|
/** Nombre. */
|
|
1858
2054
|
name: string;
|
|
@@ -1884,7 +2080,7 @@ export interface FinancialStatements {
|
|
|
1884
2080
|
year_to_date: {
|
|
1885
2081
|
/** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
|
|
1886
2082
|
sections: {
|
|
1887
|
-
/**
|
|
2083
|
+
/** La sección: ingresos, costos, gastos, financiamiento u otros. */
|
|
1888
2084
|
key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
|
|
1889
2085
|
/** Nombre. */
|
|
1890
2086
|
name: string;
|
|
@@ -2375,7 +2571,7 @@ export interface BankTransaction {
|
|
|
2375
2571
|
invoices: string[];
|
|
2376
2572
|
/** Lo que el depósito pagaría de cada factura (por inv_…). */
|
|
2377
2573
|
amounts: Record<string, number>;
|
|
2378
|
-
/**
|
|
2574
|
+
/** PUE: facturas por cobrar que quedan pagadas al conciliar; PPD: se pagan con su complemento de pago (POST /v1/payments). */
|
|
2379
2575
|
method: "PPD" | "PUE";
|
|
2380
2576
|
/** high (el monto y además el RFC, el nombre o el folio coinciden) o medium (revíselo antes). */
|
|
2381
2577
|
confidence: "high" | "medium";
|
|
@@ -2502,7 +2698,7 @@ export interface Deleted {
|
|
|
2502
2698
|
}
|
|
2503
2699
|
/** Todos los errores tienen esta forma. */
|
|
2504
2700
|
export interface ApiError {
|
|
2505
|
-
/**
|
|
2701
|
+
/** El error: type, code, message (en el idioma pedido), param (el campo a corregir), doc_url y request_id. */
|
|
2506
2702
|
error: {
|
|
2507
2703
|
/** La familia del error: invalid_request_error, authentication_error, permission_error, not_found_error, idempotency_error, rate_limit_error, invoice_error, balance_error o api_error. */
|
|
2508
2704
|
type: "invalid_request_error" | "authentication_error" | "permission_error" | "not_found_error" | "idempotency_error" | "rate_limit_error" | "invoice_error" | "balance_error" | "api_error";
|
|
@@ -3650,6 +3846,231 @@ export interface InvoiceCreate {
|
|
|
3650
3846
|
/** 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. */
|
|
3651
3847
|
metadata?: Record<string, string>;
|
|
3652
3848
|
}
|
|
3849
|
+
/** Un recibo de nómina que calculó su sistema, con todos sus conceptos e importes: se timbra tal cual. */
|
|
3850
|
+
export interface ExternalPayrollReceiptCreate {
|
|
3851
|
+
/** El emisor (patrón) del recibo; sin él, el único emisor de su cuenta en este modo. */
|
|
3852
|
+
issuer?: string;
|
|
3853
|
+
/** TipoNomina: O ordinaria (periodicidad 01–10) o E extraordinaria (periodicidad 99). */
|
|
3854
|
+
type: "O" | "E";
|
|
3855
|
+
/** PeriodicidadPago (c_PeriodicidadPago). */
|
|
3856
|
+
periodicity: string;
|
|
3857
|
+
/** FechaInicialPago, FechaFinalPago y FechaPago. */
|
|
3858
|
+
period: {
|
|
3859
|
+
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
3860
|
+
start: string;
|
|
3861
|
+
/** Último día del periodo (FechaFinalPago), AAAA-MM-DD. */
|
|
3862
|
+
end: string;
|
|
3863
|
+
/** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
|
|
3864
|
+
payment_date: string;
|
|
3865
|
+
};
|
|
3866
|
+
/** NumDiasPagados: de 0.001 a 36160, hasta 3 decimales. */
|
|
3867
|
+
days: number;
|
|
3868
|
+
/** El patrón (Emisor del complemento): registro patronal y CURP si es persona física. */
|
|
3869
|
+
employer?: {
|
|
3870
|
+
/** Registro patronal. Sin el campo: el del emisor cuando el contrato es 01–08. null: sin registro patronal. */
|
|
3871
|
+
registration?: string | null;
|
|
3872
|
+
/** CURP del patrón persona física. Sin el campo: la guardada en el emisor. */
|
|
3873
|
+
curp?: string | null;
|
|
3874
|
+
/** RfcPatronOrigen. */
|
|
3875
|
+
origin_tax_id?: string;
|
|
3876
|
+
/** EntidadSNCF, solo para entidades adheridas al SNCF. */
|
|
3877
|
+
sncf?: {
|
|
3878
|
+
/** OrigenRecurso: IP, IF o IM. */
|
|
3879
|
+
resource_origin: string;
|
|
3880
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3881
|
+
own_resource_amount?: number;
|
|
3882
|
+
};
|
|
3883
|
+
};
|
|
3884
|
+
/** El empleado (Receptor y Nomina/Receptor) con los datos de su sistema de nómina; no usa ni cambia los empleados de Fiscalisto. */
|
|
3885
|
+
employee: {
|
|
3886
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
3887
|
+
tax_id: string;
|
|
3888
|
+
/** Nombre. */
|
|
3889
|
+
name: string;
|
|
3890
|
+
/** Código postal del domicilio fiscal, 5 dígitos, como en la constancia de situación fiscal. El de un emisor es el lugar de expedición (LugarExpedicion) de sus comprobantes. */
|
|
3891
|
+
zip: string;
|
|
3892
|
+
/** CURP, 18 caracteres. */
|
|
3893
|
+
curp: string;
|
|
3894
|
+
/** NumEmpleado. */
|
|
3895
|
+
number: string;
|
|
3896
|
+
/** Para send_email; no va en el XML. */
|
|
3897
|
+
email?: string | null;
|
|
3898
|
+
/** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
|
|
3899
|
+
social_security_number?: string;
|
|
3900
|
+
/** FechaInicioRelLaboral. */
|
|
3901
|
+
start_date?: string;
|
|
3902
|
+
/** Antigüedad (P52W o P1Y2M3D). Sin el campo y con registro patronal: semanas desde start_date hasta el fin del periodo. */
|
|
3903
|
+
seniority?: string;
|
|
3904
|
+
/** Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. */
|
|
3905
|
+
contract_type: string;
|
|
3906
|
+
/** Tipo de régimen (TipoRegimen): 02 sueldos y salarios. */
|
|
3907
|
+
regime_type: string;
|
|
3908
|
+
/** true si es sindicalizado (Sindicalizado). */
|
|
3909
|
+
unionized?: boolean;
|
|
3910
|
+
/** Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna. */
|
|
3911
|
+
workday_type?: string;
|
|
3912
|
+
/** Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1. */
|
|
3913
|
+
risk_class?: string;
|
|
3914
|
+
/** Departamento (Departamento). */
|
|
3915
|
+
department?: string;
|
|
3916
|
+
/** Puesto (Puesto). */
|
|
3917
|
+
position?: string;
|
|
3918
|
+
/** SalarioBaseCotApor. */
|
|
3919
|
+
contribution_base_salary?: number;
|
|
3920
|
+
/** SalarioDiarioIntegrado. */
|
|
3921
|
+
integrated_daily_salary?: number;
|
|
3922
|
+
/** ClaveEntFed (c_Estado): JAL, CMX, NLE… */
|
|
3923
|
+
state: string;
|
|
3924
|
+
/** Banco (c_Banco); no va con una CLABE. */
|
|
3925
|
+
bank?: string;
|
|
3926
|
+
/** CuentaBancaria: CLABE de 18 dígitos, tarjeta o cuenta. */
|
|
3927
|
+
bank_account?: string;
|
|
3928
|
+
/** SubContratacion: el porcentaje suma 100. */
|
|
3929
|
+
subcontracting?: {
|
|
3930
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
3931
|
+
tax_id: string;
|
|
3932
|
+
/** PorcentajeTiempo. */
|
|
3933
|
+
percentage: number;
|
|
3934
|
+
}[];
|
|
3935
|
+
};
|
|
3936
|
+
/** Percepciones (Percepcion): sueldo y demás, gravado y exento. */
|
|
3937
|
+
perceptions?: {
|
|
3938
|
+
/** TipoPercepcion (c_TipoPercepcion): 001 sueldos, 002 aguinaldo… */
|
|
3939
|
+
type: string;
|
|
3940
|
+
/** Clave del patrón (3 a 15 caracteres). */
|
|
3941
|
+
key: string;
|
|
3942
|
+
/** Concepto del pago (ConceptoPago), c_TipoContribuyenteSujetoRetencion. */
|
|
3943
|
+
concept: string;
|
|
3944
|
+
/** ImporteGravado. */
|
|
3945
|
+
taxed: number;
|
|
3946
|
+
/** ImporteExento. */
|
|
3947
|
+
exempt: number;
|
|
3948
|
+
/** HorasExtra: solo con la percepción 019. */
|
|
3949
|
+
overtime?: {
|
|
3950
|
+
/** Días con horas extra (Dias). */
|
|
3951
|
+
days: number;
|
|
3952
|
+
/** c_TipoHoras: 01 dobles, 02 triples, 03 simples. */
|
|
3953
|
+
hours_type: string;
|
|
3954
|
+
/** Horas extra (HorasExtra). */
|
|
3955
|
+
hours: number;
|
|
3956
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3957
|
+
amount_paid: number;
|
|
3958
|
+
}[];
|
|
3959
|
+
/** AccionesOTitulos: solo con la percepción 045. */
|
|
3960
|
+
stock_options?: {
|
|
3961
|
+
/** Valor de mercado (ValorMercado). */
|
|
3962
|
+
market_value: number;
|
|
3963
|
+
/** Precio al otorgarse (PrecioAlOtorgarse). */
|
|
3964
|
+
grant_price: number;
|
|
3965
|
+
};
|
|
3966
|
+
}[];
|
|
3967
|
+
/** SeparacionIndemnizacion: con las percepciones 022, 023 o 025. */
|
|
3968
|
+
separation?: {
|
|
3969
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3970
|
+
total_paid: number;
|
|
3971
|
+
/** NumAñosServicio. */
|
|
3972
|
+
years_of_service: number;
|
|
3973
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3974
|
+
last_monthly_salary: number;
|
|
3975
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3976
|
+
accumulable_income: number;
|
|
3977
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3978
|
+
non_accumulable_income: number;
|
|
3979
|
+
};
|
|
3980
|
+
/** JubilacionPensionRetiro: con las percepciones 039 o 044. */
|
|
3981
|
+
retirement?: {
|
|
3982
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3983
|
+
total_one_payment?: number;
|
|
3984
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3985
|
+
total_installment?: number;
|
|
3986
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3987
|
+
daily_amount?: number;
|
|
3988
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3989
|
+
accumulable_income: number;
|
|
3990
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3991
|
+
non_accumulable_income: number;
|
|
3992
|
+
};
|
|
3993
|
+
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
3994
|
+
deductions?: {
|
|
3995
|
+
/** TipoDeduccion (c_TipoDeduccion): 001 IMSS, 002 ISR, 010 Infonavit… */
|
|
3996
|
+
type: string;
|
|
3997
|
+
/** El archivo .key en base64 (puede traer el prefijo data:). */
|
|
3998
|
+
key: string;
|
|
3999
|
+
/** Concepto de los egresos (IntegracEgresos/ConceptoS), hasta 100 caracteres. */
|
|
4000
|
+
concept: string;
|
|
4001
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4002
|
+
amount: number;
|
|
4003
|
+
}[];
|
|
4004
|
+
/** Otros pagos (OtroPago): subsidio para el empleo. */
|
|
4005
|
+
other_payments?: {
|
|
4006
|
+
/** TipoOtroPago (c_TipoOtroPago): 002 subsidio para el empleo… */
|
|
4007
|
+
type: string;
|
|
4008
|
+
/** El archivo .key en base64 (puede traer el prefijo data:). */
|
|
4009
|
+
key: string;
|
|
4010
|
+
/** Concepto del pago (ConceptoPago), c_TipoContribuyenteSujetoRetencion. */
|
|
4011
|
+
concept: string;
|
|
4012
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4013
|
+
amount: number;
|
|
4014
|
+
/** SubsidioCausado: solo con el 002. */
|
|
4015
|
+
subsidy_caused?: number;
|
|
4016
|
+
/** CompensacionSaldosAFavor: solo con el 004. */
|
|
4017
|
+
balance_compensation?: {
|
|
4018
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4019
|
+
balance: number;
|
|
4020
|
+
/** Año (Ejercicio). */
|
|
4021
|
+
year: number;
|
|
4022
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4023
|
+
remaining: number;
|
|
4024
|
+
};
|
|
4025
|
+
}[];
|
|
4026
|
+
/** Incapacidades: con la percepción 014 o la deducción 006. */
|
|
4027
|
+
disabilities?: {
|
|
4028
|
+
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
4029
|
+
days: number;
|
|
4030
|
+
/** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
|
|
4031
|
+
type: string;
|
|
4032
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4033
|
+
amount?: number;
|
|
4034
|
+
}[];
|
|
4035
|
+
/** Los totales que calculó su sistema: Fiscalisto los compara al centavo con las líneas y rechaza el recibo si no cuadran. */
|
|
4036
|
+
totals: {
|
|
4037
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4038
|
+
perceptions: number;
|
|
4039
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4040
|
+
deductions: number;
|
|
4041
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4042
|
+
other_payments: number;
|
|
4043
|
+
/** Neto: percepciones más otros pagos menos deducciones. */
|
|
4044
|
+
net: number;
|
|
4045
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4046
|
+
salaries?: number;
|
|
4047
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4048
|
+
separation?: number;
|
|
4049
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4050
|
+
retirement?: number;
|
|
4051
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4052
|
+
taxed?: number;
|
|
4053
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4054
|
+
exempt?: number;
|
|
4055
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4056
|
+
taxes_withheld?: number;
|
|
4057
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4058
|
+
other_deductions?: number;
|
|
4059
|
+
};
|
|
4060
|
+
/** Sus ids: el empleado y la corrida de nómina. payroll_run_id es obligatorio en un recibo extraordinario. */
|
|
4061
|
+
references?: {
|
|
4062
|
+
/** El id del empleado en su sistema. */
|
|
4063
|
+
employee_id?: string;
|
|
4064
|
+
/** El id de la corrida de nómina en su sistema. */
|
|
4065
|
+
payroll_run_id?: string;
|
|
4066
|
+
};
|
|
4067
|
+
/** El recibo vigente (inv_… o UUID) que este sustituye: relación 04 y se cancela con motivo 01. */
|
|
4068
|
+
replaces?: string;
|
|
4069
|
+
/** 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. */
|
|
4070
|
+
send_email?: boolean;
|
|
4071
|
+
/** 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. */
|
|
4072
|
+
metadata?: Record<string, string>;
|
|
4073
|
+
}
|
|
3653
4074
|
export interface UpdateAccountParams {
|
|
3654
4075
|
/** La versión de la API de la cuenta: la que reciben sus solicitudes sin Fiscalisto-Version y sus webhooks sin api_version propio. Pruebe antes la nueva con el encabezado. */
|
|
3655
4076
|
api_version: string;
|
|
@@ -3880,7 +4301,7 @@ export interface CreateCreditNoteParams {
|
|
|
3880
4301
|
description?: string;
|
|
3881
4302
|
/** Forma de pago (FormaPago), clave de c_FormaPago: 01 efectivo, 03 transferencia, 04 tarjeta de crédito, 28 débito, 99 por definir… Obligatoria con PUE; con PPD es 99. */
|
|
3882
4303
|
payment_form: string;
|
|
3883
|
-
/** Tipo de relación (TipoRelacion): 01 nota de crédito
|
|
4304
|
+
/** Tipo de relación (TipoRelacion) con la factura: 01 nota de crédito (por omisión) o 03 devolución de mercancía. */
|
|
3884
4305
|
relationship?: "01" | "03";
|
|
3885
4306
|
/** 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. */
|
|
3886
4307
|
send_email?: boolean;
|
|
@@ -4326,7 +4747,7 @@ export interface UpdateEmployeeParams {
|
|
|
4326
4747
|
export interface CreatePayrollReceiptParams {
|
|
4327
4748
|
/** El empleado (emp_…). */
|
|
4328
4749
|
employee: string;
|
|
4329
|
-
/**
|
|
4750
|
+
/** El periodo de pago: primer y último día (FechaInicialPago, FechaFinalPago) y, si no es el último, el día de pago (FechaPago). */
|
|
4330
4751
|
period: {
|
|
4331
4752
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
4332
4753
|
start: string;
|
|
@@ -4345,7 +4766,7 @@ export interface CreatePayrollReceiptParams {
|
|
|
4345
4766
|
export interface PreviewPayrollReceiptParams {
|
|
4346
4767
|
/** El empleado (emp_…). */
|
|
4347
4768
|
employee: string;
|
|
4348
|
-
/**
|
|
4769
|
+
/** El periodo de pago: primer y último día (FechaInicialPago, FechaFinalPago) y, si no es el último, el día de pago (FechaPago). */
|
|
4349
4770
|
period: {
|
|
4350
4771
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
4351
4772
|
start: string;
|
|
@@ -4421,7 +4842,7 @@ export interface CreateBranchParams {
|
|
|
4421
4842
|
phone?: string | null;
|
|
4422
4843
|
/** Correo, para el PDF. */
|
|
4423
4844
|
email?: string | null;
|
|
4424
|
-
/**
|
|
4845
|
+
/** La serie de cada tipo de CFDI que se timbra desde ella (invoice, credit_note, payment, transfer), hasta 25 caracteres cada una; la que no mande usa la del emisor. */
|
|
4425
4846
|
series?: {
|
|
4426
4847
|
/** Serie de sus facturas (tipo I); sin ella, la del emisor. */
|
|
4427
4848
|
invoice?: string | null;
|
|
@@ -4470,7 +4891,7 @@ export interface UpdateBranchParams {
|
|
|
4470
4891
|
phone?: string | null;
|
|
4471
4892
|
/** Correo, para el PDF. */
|
|
4472
4893
|
email?: string | null;
|
|
4473
|
-
/**
|
|
4894
|
+
/** La serie de cada tipo de CFDI que se timbra desde ella (invoice, credit_note, payment, transfer), hasta 25 caracteres cada una; la que no mande usa la del emisor. */
|
|
4474
4895
|
series?: {
|
|
4475
4896
|
/** Serie de sus facturas (tipo I); sin ella, la del emisor. */
|
|
4476
4897
|
invoice?: string | null;
|
|
@@ -5062,7 +5483,7 @@ export interface CreateRecurringInvoiceParams {
|
|
|
5062
5483
|
/** La zona de esa hora. Por omisión America/Mexico_City. */
|
|
5063
5484
|
time_zone?: "America/Mexico_City" | "America/Cancun" | "America/Mazatlan" | "America/Hermosillo" | "America/Tijuana" | "America/Ciudad_Juarez";
|
|
5064
5485
|
};
|
|
5065
|
-
/** La factura que se repite: el cuerpo de POST /v1/invoices, sin issuer, folio, date, global ni metadata. En description puede usar {mes}, {mes anterior}, {mes siguiente}, {año}, {año anterior}, {año siguiente} y {periodo}: cada factura los llena con su fecha. */
|
|
5486
|
+
/** La factura que se repite: el cuerpo de POST /v1/invoices, sin issuer, folio, date, global ni metadata. En description puede usar {mes}, {mes anterior}, {mes siguiente}, {año}, {año anterior}, {año siguiente} y {periodo}: cada factura los llena con su fecha. Como se escriben es como salen: {mes} «noviembre», {Mes} «Noviembre», {MES} «NOVIEMBRE». */
|
|
5066
5487
|
invoice: InvoiceCreate;
|
|
5067
5488
|
/** Mandar cada factura al correo del cliente (customer.email o el del catálogo). Por omisión true. */
|
|
5068
5489
|
send_email?: boolean;
|
|
@@ -6134,6 +6555,24 @@ export declare class PayrollReceiptsResource {
|
|
|
6134
6555
|
* @see https://fiscalisto.com/docs/api/referencia/nomina/preview-payroll-receipt
|
|
6135
6556
|
*/
|
|
6136
6557
|
preview(params: PreviewPayrollReceiptParams, options?: RequestOptions): Promise<PayrollReceiptPreview>;
|
|
6558
|
+
/**
|
|
6559
|
+
* Timbrar un recibo calculado por su sistema
|
|
6560
|
+
*
|
|
6561
|
+
* Para un sistema de nómina que ya calculó el recibo: timbra exactamente sus percepciones (gravado y exento), deducciones, otros pagos, horas extra, incapacidades, separación o jubilación, ordinario (type O) o extraordinario (type E: aguinaldo, PTU, finiquito). Fiscalisto no recalcula ni redondea nada: revisa el XSD, los catálogos del SAT, la Matriz de errores y que sus totales cuadren, y si algo falla responde payroll_invalid con todos los problemas en errors[] (cada uno con su param). Un recibo ordinario por empleado (RFC) y periodo; uno extraordinario por empleado y payroll_run_id. Repetirlo con los mismos importes devuelve el mismo recibo; con otros importes, 409 payroll_receipt_exists (corríjalo con replaces). Queda como factura tipo N.
|
|
6562
|
+
*
|
|
6563
|
+
* POST /v1/payroll_receipts/external
|
|
6564
|
+
* @see https://fiscalisto.com/docs/api/referencia/nomina/create-external-payroll-receipt
|
|
6565
|
+
*/
|
|
6566
|
+
createExternal(params: ExternalPayrollReceiptCreate, options?: RequestOptions): Promise<Invoice>;
|
|
6567
|
+
/**
|
|
6568
|
+
* Revisar un recibo calculado por su sistema, sin timbrar
|
|
6569
|
+
*
|
|
6570
|
+
* Las mismas revisiones que al timbrar, sin timbrar ni usar timbres: devuelve el recibo como se timbraría, los avisos y el XML sin sellar (unsigned_xml), con sus importes tal cual. Si algo falla, payroll_invalid con errors[].
|
|
6571
|
+
*
|
|
6572
|
+
* POST /v1/payroll_receipts/external/preview
|
|
6573
|
+
* @see https://fiscalisto.com/docs/api/referencia/nomina/preview-external-payroll-receipt
|
|
6574
|
+
*/
|
|
6575
|
+
previewExternal(params: ExternalPayrollReceiptCreate, options?: RequestOptions): Promise<ExternalPayrollReceiptPreview>;
|
|
6137
6576
|
}
|
|
6138
6577
|
/** Lotes: fiscalisto.invoiceBatches. */
|
|
6139
6578
|
export declare class InvoiceBatchesResource {
|