fiscalisto 0.1.10 → 0.1.12
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 +15 -3
- package/dist/error-codes.js +15 -3
- package/dist/generated.d.ts +567 -121
- package/dist/generated.js +25 -3
- 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;
|
|
@@ -670,11 +794,20 @@ export interface Employee {
|
|
|
670
794
|
export interface PayrollReceiptPreview {
|
|
671
795
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
672
796
|
object: "payroll_receipt_preview";
|
|
797
|
+
/** Mándelo en POST /v1/payroll_receipts para timbrar exactamente este recibo: si al timbrar se calcula otro, contesta 409 payroll_calculation_changed sin timbrar. */
|
|
798
|
+
confirmation_token: string;
|
|
799
|
+
/** Lo que el recibo no incluye o pronto no se podrá calcular; no impide timbrar. */
|
|
800
|
+
warnings: {
|
|
801
|
+
/** finiquito_not_included: el empleado se fue en el periodo y el recibo no trae su finiquito; payroll_rates_pending: aún no se cargan los valores (ISR, subsidio, salario mínimo, UMA) de una fecha próxima. */
|
|
802
|
+
code: string;
|
|
803
|
+
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
804
|
+
message: string;
|
|
805
|
+
}[];
|
|
673
806
|
/** El empleado (emp_…). */
|
|
674
807
|
employee: string;
|
|
675
808
|
/** Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual. */
|
|
676
809
|
periodicity: string;
|
|
677
|
-
/**
|
|
810
|
+
/** El periodo de pago: primer y último día y el día de pago (FechaInicialPago, FechaFinalPago y FechaPago). */
|
|
678
811
|
period: {
|
|
679
812
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
680
813
|
start: string;
|
|
@@ -699,6 +832,24 @@ export interface PayrollReceiptPreview {
|
|
|
699
832
|
taxed: number;
|
|
700
833
|
/** Importe exento (ImporteExento). */
|
|
701
834
|
exempt: number;
|
|
835
|
+
/** Horas extra (HorasExtra), con la percepción 019. */
|
|
836
|
+
overtime?: {
|
|
837
|
+
/** Días con horas extra (Dias). */
|
|
838
|
+
days: number;
|
|
839
|
+
/** c_TipoHoras: 01 dobles, 02 triples, 03 simples. */
|
|
840
|
+
hours_type: string;
|
|
841
|
+
/** Horas extra (HorasExtra). */
|
|
842
|
+
hours: number;
|
|
843
|
+
/** Importe pagado (ImportePagado). */
|
|
844
|
+
amount_paid: number;
|
|
845
|
+
}[];
|
|
846
|
+
/** Acciones o títulos (AccionesOTitulos), con la percepción 045. */
|
|
847
|
+
stock_options?: {
|
|
848
|
+
/** Valor de mercado (ValorMercado). */
|
|
849
|
+
market_value: number;
|
|
850
|
+
/** Precio al otorgarse (PrecioAlOtorgarse). */
|
|
851
|
+
grant_price: number;
|
|
852
|
+
};
|
|
702
853
|
}[];
|
|
703
854
|
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
704
855
|
deductions: {
|
|
@@ -725,6 +876,15 @@ export interface PayrollReceiptPreview {
|
|
|
725
876
|
subsidy_caused?: number;
|
|
726
877
|
/** Del subsidio causado, el ISR que evitó (no va en el XML). */
|
|
727
878
|
subsidy_applied?: number;
|
|
879
|
+
/** Compensación del saldo a favor (CompensacionSaldosAFavor), con el 004. */
|
|
880
|
+
balance_compensation?: {
|
|
881
|
+
/** Saldo a favor (SaldoAFavor). */
|
|
882
|
+
balance: number;
|
|
883
|
+
/** Año del saldo a favor (Año). */
|
|
884
|
+
year: number;
|
|
885
|
+
/** Remanente del saldo a favor (RemanenteSalFav). */
|
|
886
|
+
remaining: number;
|
|
887
|
+
};
|
|
728
888
|
}[];
|
|
729
889
|
/** El cálculo del ISR del periodo: base, tarifa, subsidio y resultado. */
|
|
730
890
|
isr: {
|
|
@@ -738,9 +898,9 @@ export interface PayrollReceiptPreview {
|
|
|
738
898
|
exempt_minimum: boolean;
|
|
739
899
|
/** El ajuste de fin de mes: subsidio revertido y el ISR que retiene. */
|
|
740
900
|
adjustment?: {
|
|
741
|
-
/**
|
|
901
|
+
/** El subsidio para el empleo que se revierte en el ajuste. */
|
|
742
902
|
reversed: number;
|
|
743
|
-
/** El
|
|
903
|
+
/** El ISR que se retiene después del ajuste. */
|
|
744
904
|
isr: number;
|
|
745
905
|
};
|
|
746
906
|
};
|
|
@@ -752,6 +912,10 @@ export interface PayrollReceiptPreview {
|
|
|
752
912
|
taxed: number;
|
|
753
913
|
/** Total exento (TotalExento). */
|
|
754
914
|
exempt: number;
|
|
915
|
+
/** Total de separación e indemnización (TotalSeparacionIndemnizacion). */
|
|
916
|
+
separation: number;
|
|
917
|
+
/** Total de jubilación, pensión o retiro (TotalJubilacionPensionRetiro). */
|
|
918
|
+
retirement: number;
|
|
755
919
|
/** Total de percepciones (TotalPercepciones). */
|
|
756
920
|
perceptions: number;
|
|
757
921
|
/** Otras deducciones (TotalOtrasDeducciones). */
|
|
@@ -768,6 +932,43 @@ export interface PayrollReceiptPreview {
|
|
|
768
932
|
net: number;
|
|
769
933
|
};
|
|
770
934
|
}
|
|
935
|
+
/** Un recibo calculado por su sistema, revisado y sin timbrar: lo que se timbraría, tal cual. */
|
|
936
|
+
export interface ExternalPayrollReceiptPreview {
|
|
937
|
+
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
938
|
+
object: "payroll_receipt_preview";
|
|
939
|
+
/** external: los importes son los que calculó su sistema. */
|
|
940
|
+
calculation: "external";
|
|
941
|
+
/** El emisor (iss_…). */
|
|
942
|
+
issuer: string;
|
|
943
|
+
/** El empleado como receptor del CFDI (Receptor). */
|
|
944
|
+
customer: {
|
|
945
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
946
|
+
tax_id: string;
|
|
947
|
+
/** 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.»). */
|
|
948
|
+
legal_name: string;
|
|
949
|
+
/** Código postal del domicilio fiscal del cliente (DomicilioFiscalReceptor), 5 dígitos. */
|
|
950
|
+
zip: string;
|
|
951
|
+
};
|
|
952
|
+
/** El recibo de nómina 1.2: empleado, periodo, percepciones, deducciones y otros pagos. */
|
|
953
|
+
payroll: InvoicePayroll;
|
|
954
|
+
/** SubTotal: percepciones más otros pagos. */
|
|
955
|
+
subtotal: number;
|
|
956
|
+
/** Descuento: las deducciones. */
|
|
957
|
+
discount: number;
|
|
958
|
+
/** Total: el neto a pagar. */
|
|
959
|
+
total: number;
|
|
960
|
+
/** Lo que el SAT podría observar; no impide timbrar. */
|
|
961
|
+
warnings: {
|
|
962
|
+
/** El campo de la solicitud. */
|
|
963
|
+
param: string;
|
|
964
|
+
/** 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. */
|
|
965
|
+
code: string;
|
|
966
|
+
/** Qué pasó y cómo corregirlo, para una persona. */
|
|
967
|
+
message: string;
|
|
968
|
+
}[];
|
|
969
|
+
/** El XML que se mandaría al PAC, sin sello ni timbre: sus importes son exactamente los que mandó. */
|
|
970
|
+
unsigned_xml: string;
|
|
971
|
+
}
|
|
771
972
|
/** Un anticipo timbrado que aún no se aplica. */
|
|
772
973
|
export interface Advance {
|
|
773
974
|
/** Qué tipo de objeto es («invoice», «customer»…). */
|
|
@@ -776,11 +977,11 @@ export interface Advance {
|
|
|
776
977
|
uuid: string;
|
|
777
978
|
/** Fecha de emisión (Fecha), hora de la Ciudad de México. */
|
|
778
979
|
date: string;
|
|
779
|
-
/**
|
|
980
|
+
/** La serie (Serie) del anticipo, o null. */
|
|
780
981
|
series: string | null;
|
|
781
|
-
/**
|
|
982
|
+
/** El folio (Folio) del anticipo, o null. */
|
|
782
983
|
folio: string | null;
|
|
783
|
-
/**
|
|
984
|
+
/** El cliente del anticipo: RFC y nombre. */
|
|
784
985
|
customer: {
|
|
785
986
|
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
786
987
|
tax_id: string;
|
|
@@ -1201,7 +1402,7 @@ export interface SatDeclaration {
|
|
|
1201
1402
|
fields: {
|
|
1202
1403
|
/** El renglón como lo imprime el SAT. */
|
|
1203
1404
|
label: string;
|
|
1204
|
-
/**
|
|
1405
|
+
/** El valor del renglón como lo trae la declaración (número o texto). */
|
|
1205
1406
|
value: number | string;
|
|
1206
1407
|
}[];
|
|
1207
1408
|
}[];
|
|
@@ -1209,7 +1410,7 @@ export interface SatDeclaration {
|
|
|
1209
1410
|
receipt: {
|
|
1210
1411
|
/** Cada impuesto del acuse. */
|
|
1211
1412
|
concepts: {
|
|
1212
|
-
/**
|
|
1413
|
+
/** El concepto de la línea de captura (ISR, IVA…) como lo da el SAT. */
|
|
1213
1414
|
concept: string;
|
|
1214
1415
|
/** Lo que resultó a cargo. */
|
|
1215
1416
|
due: number | null;
|
|
@@ -1438,7 +1639,7 @@ export interface StockMovement {
|
|
|
1438
1639
|
lot: string | null;
|
|
1439
1640
|
/** Lo que lo causó: type invoice (id es el UUID del CFDI), adjustment (adj_…), receipt, transfer, count o ticket. */
|
|
1440
1641
|
source: {
|
|
1441
|
-
/**
|
|
1642
|
+
/** Qué lo movió: invoice (una factura; id es su UUID), adjustment (un ajuste, adj_…), count (un conteo) u otro origen. */
|
|
1442
1643
|
type: string;
|
|
1443
1644
|
/** Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). */
|
|
1444
1645
|
id: string;
|
|
@@ -1856,7 +2057,7 @@ export interface FinancialStatements {
|
|
|
1856
2057
|
month: {
|
|
1857
2058
|
/** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
|
|
1858
2059
|
sections: {
|
|
1859
|
-
/**
|
|
2060
|
+
/** La sección: ingresos, costos, gastos, financiamiento u otros. */
|
|
1860
2061
|
key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
|
|
1861
2062
|
/** Nombre. */
|
|
1862
2063
|
name: string;
|
|
@@ -1888,7 +2089,7 @@ export interface FinancialStatements {
|
|
|
1888
2089
|
year_to_date: {
|
|
1889
2090
|
/** Ingresos, costos, gastos, financiamiento y otros, cada uno con su total. */
|
|
1890
2091
|
sections: {
|
|
1891
|
-
/**
|
|
2092
|
+
/** La sección: ingresos, costos, gastos, financiamiento u otros. */
|
|
1892
2093
|
key: "ingresos" | "costos" | "gastos" | "financiamiento" | "otros";
|
|
1893
2094
|
/** Nombre. */
|
|
1894
2095
|
name: string;
|
|
@@ -2379,7 +2580,7 @@ export interface BankTransaction {
|
|
|
2379
2580
|
invoices: string[];
|
|
2380
2581
|
/** Lo que el depósito pagaría de cada factura (por inv_…). */
|
|
2381
2582
|
amounts: Record<string, number>;
|
|
2382
|
-
/**
|
|
2583
|
+
/** PUE: facturas por cobrar que quedan pagadas al conciliar; PPD: se pagan con su complemento de pago (POST /v1/payments). */
|
|
2383
2584
|
method: "PPD" | "PUE";
|
|
2384
2585
|
/** high (el monto y además el RFC, el nombre o el folio coinciden) o medium (revíselo antes). */
|
|
2385
2586
|
confidence: "high" | "medium";
|
|
@@ -2506,7 +2707,7 @@ export interface Deleted {
|
|
|
2506
2707
|
}
|
|
2507
2708
|
/** Todos los errores tienen esta forma. */
|
|
2508
2709
|
export interface ApiError {
|
|
2509
|
-
/**
|
|
2710
|
+
/** El error: type, code, message (en el idioma pedido), param (el campo a corregir), doc_url y request_id. */
|
|
2510
2711
|
error: {
|
|
2511
2712
|
/** 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. */
|
|
2512
2713
|
type: "invalid_request_error" | "authentication_error" | "permission_error" | "not_found_error" | "idempotency_error" | "rate_limit_error" | "invoice_error" | "balance_error" | "api_error";
|
|
@@ -3654,12 +3855,237 @@ export interface InvoiceCreate {
|
|
|
3654
3855
|
/** 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. */
|
|
3655
3856
|
metadata?: Record<string, string>;
|
|
3656
3857
|
}
|
|
3858
|
+
/** Un recibo de nómina que calculó su sistema, con todos sus conceptos e importes: se timbra tal cual. */
|
|
3859
|
+
export interface ExternalPayrollReceiptCreate {
|
|
3860
|
+
/** El emisor (patrón) del recibo; sin él, el único emisor de su cuenta en este modo. */
|
|
3861
|
+
issuer?: string;
|
|
3862
|
+
/** TipoNomina: O ordinaria (periodicidad 01–10) o E extraordinaria (periodicidad 99). */
|
|
3863
|
+
type: "O" | "E";
|
|
3864
|
+
/** PeriodicidadPago (c_PeriodicidadPago). */
|
|
3865
|
+
periodicity: string;
|
|
3866
|
+
/** FechaInicialPago, FechaFinalPago y FechaPago. */
|
|
3867
|
+
period: {
|
|
3868
|
+
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
3869
|
+
start: string;
|
|
3870
|
+
/** Último día del periodo (FechaFinalPago), AAAA-MM-DD. */
|
|
3871
|
+
end: string;
|
|
3872
|
+
/** Fecha de pago (FechaPago), AAAA-MM-DD. Por omisión el último día del periodo. */
|
|
3873
|
+
payment_date: string;
|
|
3874
|
+
};
|
|
3875
|
+
/** NumDiasPagados: de 0.001 a 36160, hasta 3 decimales. */
|
|
3876
|
+
days: number;
|
|
3877
|
+
/** El patrón (Emisor del complemento): registro patronal y CURP si es persona física. */
|
|
3878
|
+
employer?: {
|
|
3879
|
+
/** Registro patronal. Sin el campo: el del emisor cuando el contrato es 01–08. null: sin registro patronal. */
|
|
3880
|
+
registration?: string | null;
|
|
3881
|
+
/** CURP del patrón persona física. Sin el campo: la guardada en el emisor. */
|
|
3882
|
+
curp?: string | null;
|
|
3883
|
+
/** RfcPatronOrigen. */
|
|
3884
|
+
origin_tax_id?: string;
|
|
3885
|
+
/** EntidadSNCF, solo para entidades adheridas al SNCF. */
|
|
3886
|
+
sncf?: {
|
|
3887
|
+
/** OrigenRecurso: IP, IF o IM. */
|
|
3888
|
+
resource_origin: string;
|
|
3889
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3890
|
+
own_resource_amount?: number;
|
|
3891
|
+
};
|
|
3892
|
+
};
|
|
3893
|
+
/** El empleado (Receptor y Nomina/Receptor) con los datos de su sistema de nómina; no usa ni cambia los empleados de Fiscalisto. */
|
|
3894
|
+
employee: {
|
|
3895
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
3896
|
+
tax_id: string;
|
|
3897
|
+
/** Nombre. */
|
|
3898
|
+
name: string;
|
|
3899
|
+
/** 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. */
|
|
3900
|
+
zip: string;
|
|
3901
|
+
/** CURP, 18 caracteres. */
|
|
3902
|
+
curp: string;
|
|
3903
|
+
/** NumEmpleado. */
|
|
3904
|
+
number: string;
|
|
3905
|
+
/** Para send_email; no va en el XML. */
|
|
3906
|
+
email?: string | null;
|
|
3907
|
+
/** Número de seguridad social (NumSeguridadSocial), 11 dígitos. */
|
|
3908
|
+
social_security_number?: string;
|
|
3909
|
+
/** FechaInicioRelLaboral. */
|
|
3910
|
+
start_date?: string;
|
|
3911
|
+
/** Antigüedad (P52W o P1Y2M3D). Sin el campo y con registro patronal: semanas desde start_date hasta el fin del periodo. */
|
|
3912
|
+
seniority?: string;
|
|
3913
|
+
/** Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado. */
|
|
3914
|
+
contract_type: string;
|
|
3915
|
+
/** Tipo de régimen (TipoRegimen): 02 sueldos y salarios. */
|
|
3916
|
+
regime_type: string;
|
|
3917
|
+
/** true si es sindicalizado (Sindicalizado). */
|
|
3918
|
+
unionized?: boolean;
|
|
3919
|
+
/** Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna. */
|
|
3920
|
+
workday_type?: string;
|
|
3921
|
+
/** Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1. */
|
|
3922
|
+
risk_class?: string;
|
|
3923
|
+
/** Departamento (Departamento). */
|
|
3924
|
+
department?: string;
|
|
3925
|
+
/** Puesto (Puesto). */
|
|
3926
|
+
position?: string;
|
|
3927
|
+
/** SalarioBaseCotApor. */
|
|
3928
|
+
contribution_base_salary?: number;
|
|
3929
|
+
/** SalarioDiarioIntegrado. */
|
|
3930
|
+
integrated_daily_salary?: number;
|
|
3931
|
+
/** ClaveEntFed (c_Estado): JAL, CMX, NLE… */
|
|
3932
|
+
state: string;
|
|
3933
|
+
/** Banco (c_Banco); no va con una CLABE. */
|
|
3934
|
+
bank?: string;
|
|
3935
|
+
/** CuentaBancaria: CLABE de 18 dígitos, tarjeta o cuenta. */
|
|
3936
|
+
bank_account?: string;
|
|
3937
|
+
/** SubContratacion: el porcentaje suma 100. */
|
|
3938
|
+
subcontracting?: {
|
|
3939
|
+
/** RFC (Rfc), 12 caracteres una persona moral y 13 una física. */
|
|
3940
|
+
tax_id: string;
|
|
3941
|
+
/** PorcentajeTiempo. */
|
|
3942
|
+
percentage: number;
|
|
3943
|
+
}[];
|
|
3944
|
+
};
|
|
3945
|
+
/** Percepciones (Percepcion): sueldo y demás, gravado y exento. */
|
|
3946
|
+
perceptions?: {
|
|
3947
|
+
/** TipoPercepcion (c_TipoPercepcion): 001 sueldos, 002 aguinaldo… */
|
|
3948
|
+
type: string;
|
|
3949
|
+
/** Clave del patrón (3 a 15 caracteres). */
|
|
3950
|
+
key: string;
|
|
3951
|
+
/** Concepto del pago (ConceptoPago), c_TipoContribuyenteSujetoRetencion. */
|
|
3952
|
+
concept: string;
|
|
3953
|
+
/** ImporteGravado. */
|
|
3954
|
+
taxed: number;
|
|
3955
|
+
/** ImporteExento. */
|
|
3956
|
+
exempt: number;
|
|
3957
|
+
/** HorasExtra: solo con la percepción 019. */
|
|
3958
|
+
overtime?: {
|
|
3959
|
+
/** Días con horas extra (Dias). */
|
|
3960
|
+
days: number;
|
|
3961
|
+
/** c_TipoHoras: 01 dobles, 02 triples, 03 simples. */
|
|
3962
|
+
hours_type: string;
|
|
3963
|
+
/** Horas extra (HorasExtra). */
|
|
3964
|
+
hours: number;
|
|
3965
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3966
|
+
amount_paid: number;
|
|
3967
|
+
}[];
|
|
3968
|
+
/** AccionesOTitulos: solo con la percepción 045. */
|
|
3969
|
+
stock_options?: {
|
|
3970
|
+
/** Valor de mercado (ValorMercado). */
|
|
3971
|
+
market_value: number;
|
|
3972
|
+
/** Precio al otorgarse (PrecioAlOtorgarse). */
|
|
3973
|
+
grant_price: number;
|
|
3974
|
+
};
|
|
3975
|
+
}[];
|
|
3976
|
+
/** SeparacionIndemnizacion: con las percepciones 022, 023 o 025. */
|
|
3977
|
+
separation?: {
|
|
3978
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3979
|
+
total_paid: number;
|
|
3980
|
+
/** NumAñosServicio. */
|
|
3981
|
+
years_of_service: number;
|
|
3982
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3983
|
+
last_monthly_salary: number;
|
|
3984
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3985
|
+
accumulable_income: number;
|
|
3986
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3987
|
+
non_accumulable_income: number;
|
|
3988
|
+
};
|
|
3989
|
+
/** JubilacionPensionRetiro: con las percepciones 039 o 044. */
|
|
3990
|
+
retirement?: {
|
|
3991
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3992
|
+
total_one_payment?: number;
|
|
3993
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3994
|
+
total_installment?: number;
|
|
3995
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3996
|
+
daily_amount?: number;
|
|
3997
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
3998
|
+
accumulable_income: number;
|
|
3999
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4000
|
+
non_accumulable_income: number;
|
|
4001
|
+
};
|
|
4002
|
+
/** Deducciones (Deduccion): ISR, cuotas IMSS y demás. */
|
|
4003
|
+
deductions?: {
|
|
4004
|
+
/** TipoDeduccion (c_TipoDeduccion): 001 IMSS, 002 ISR, 010 Infonavit… */
|
|
4005
|
+
type: string;
|
|
4006
|
+
/** El archivo .key en base64 (puede traer el prefijo data:). */
|
|
4007
|
+
key: string;
|
|
4008
|
+
/** Concepto de los egresos (IntegracEgresos/ConceptoS), hasta 100 caracteres. */
|
|
4009
|
+
concept: string;
|
|
4010
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4011
|
+
amount: number;
|
|
4012
|
+
}[];
|
|
4013
|
+
/** Otros pagos (OtroPago): subsidio para el empleo. */
|
|
4014
|
+
other_payments?: {
|
|
4015
|
+
/** TipoOtroPago (c_TipoOtroPago): 002 subsidio para el empleo… */
|
|
4016
|
+
type: string;
|
|
4017
|
+
/** El archivo .key en base64 (puede traer el prefijo data:). */
|
|
4018
|
+
key: string;
|
|
4019
|
+
/** Concepto del pago (ConceptoPago), c_TipoContribuyenteSujetoRetencion. */
|
|
4020
|
+
concept: string;
|
|
4021
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4022
|
+
amount: number;
|
|
4023
|
+
/** SubsidioCausado: solo con el 002. */
|
|
4024
|
+
subsidy_caused?: number;
|
|
4025
|
+
/** CompensacionSaldosAFavor: solo con el 004. */
|
|
4026
|
+
balance_compensation?: {
|
|
4027
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4028
|
+
balance: number;
|
|
4029
|
+
/** Año (Ejercicio). */
|
|
4030
|
+
year: number;
|
|
4031
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4032
|
+
remaining: number;
|
|
4033
|
+
};
|
|
4034
|
+
}[];
|
|
4035
|
+
/** Incapacidades: con la percepción 014 o la deducción 006. */
|
|
4036
|
+
disabilities?: {
|
|
4037
|
+
/** Días pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan. */
|
|
4038
|
+
days: number;
|
|
4039
|
+
/** Tipo de comprobante (TipoDeComprobante): I ingreso, E egreso, P pago, T traslado, N nómina. */
|
|
4040
|
+
type: string;
|
|
4041
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4042
|
+
amount?: number;
|
|
4043
|
+
}[];
|
|
4044
|
+
/** Los totales que calculó su sistema: Fiscalisto los compara al centavo con las líneas y rechaza el recibo si no cuadran. */
|
|
4045
|
+
totals: {
|
|
4046
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4047
|
+
perceptions: number;
|
|
4048
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4049
|
+
deductions: number;
|
|
4050
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4051
|
+
other_payments: number;
|
|
4052
|
+
/** Neto: percepciones más otros pagos menos deducciones. */
|
|
4053
|
+
net: number;
|
|
4054
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4055
|
+
salaries?: number;
|
|
4056
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4057
|
+
separation?: number;
|
|
4058
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4059
|
+
retirement?: number;
|
|
4060
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4061
|
+
taxed?: number;
|
|
4062
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4063
|
+
exempt?: number;
|
|
4064
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4065
|
+
taxes_withheld?: number;
|
|
4066
|
+
/** Pesos con hasta 2 decimales, como se timbran: Fiscalisto no los redondea. */
|
|
4067
|
+
other_deductions?: number;
|
|
4068
|
+
};
|
|
4069
|
+
/** Sus ids: el empleado y la corrida de nómina. payroll_run_id es obligatorio en un recibo extraordinario. */
|
|
4070
|
+
references?: {
|
|
4071
|
+
/** El id del empleado en su sistema. */
|
|
4072
|
+
employee_id?: string;
|
|
4073
|
+
/** El id de la corrida de nómina en su sistema. */
|
|
4074
|
+
payroll_run_id?: string;
|
|
4075
|
+
};
|
|
4076
|
+
/** El recibo vigente (inv_… o UUID) que este sustituye: relación 04 y se cancela con motivo 01. */
|
|
4077
|
+
replaces?: string;
|
|
4078
|
+
/** 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. */
|
|
4079
|
+
send_email?: boolean;
|
|
4080
|
+
/** 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. */
|
|
4081
|
+
metadata?: Record<string, string>;
|
|
4082
|
+
}
|
|
3657
4083
|
export interface UpdateAccountParams {
|
|
3658
4084
|
/** 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. */
|
|
3659
4085
|
api_version: string;
|
|
3660
4086
|
}
|
|
3661
4087
|
export interface ResetTestDataParams {
|
|
3662
|
-
/** true (por omisión) para dejarle a cada emisor de pruebas
|
|
4088
|
+
/** true (por omisión) para dejarle a cada emisor de pruebas 2 clientes y 3 productos de ejemplo. false para dejarlo vacío. */
|
|
3663
4089
|
seed?: boolean;
|
|
3664
4090
|
}
|
|
3665
4091
|
export interface CreateSandboxParams {
|
|
@@ -3884,7 +4310,7 @@ export interface CreateCreditNoteParams {
|
|
|
3884
4310
|
description?: string;
|
|
3885
4311
|
/** 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. */
|
|
3886
4312
|
payment_form: string;
|
|
3887
|
-
/** Tipo de relación (TipoRelacion): 01 nota de crédito
|
|
4313
|
+
/** Tipo de relación (TipoRelacion) con la factura: 01 nota de crédito (por omisión) o 03 devolución de mercancía. */
|
|
3888
4314
|
relationship?: "01" | "03";
|
|
3889
4315
|
/** 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. */
|
|
3890
4316
|
send_email?: boolean;
|
|
@@ -4330,7 +4756,7 @@ export interface UpdateEmployeeParams {
|
|
|
4330
4756
|
export interface CreatePayrollReceiptParams {
|
|
4331
4757
|
/** El empleado (emp_…). */
|
|
4332
4758
|
employee: string;
|
|
4333
|
-
/**
|
|
4759
|
+
/** El periodo de pago: primer y último día (FechaInicialPago, FechaFinalPago) y, si no es el último, el día de pago (FechaPago). */
|
|
4334
4760
|
period: {
|
|
4335
4761
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
4336
4762
|
start: string;
|
|
@@ -4345,11 +4771,13 @@ export interface CreatePayrollReceiptParams {
|
|
|
4345
4771
|
send_email?: boolean;
|
|
4346
4772
|
/** 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. */
|
|
4347
4773
|
metadata?: Record<string, string>;
|
|
4774
|
+
/** El confirmation_token de POST /v1/payroll_receipts/preview: timbra solo si el recibo calculado ahora es exactamente el que revisó (si no, 409 payroll_calculation_changed y no timbra). Sin él, timbra el que calcule en ese momento. */
|
|
4775
|
+
confirmation_token?: string;
|
|
4348
4776
|
}
|
|
4349
4777
|
export interface PreviewPayrollReceiptParams {
|
|
4350
4778
|
/** El empleado (emp_…). */
|
|
4351
4779
|
employee: string;
|
|
4352
|
-
/**
|
|
4780
|
+
/** El periodo de pago: primer y último día (FechaInicialPago, FechaFinalPago) y, si no es el último, el día de pago (FechaPago). */
|
|
4353
4781
|
period: {
|
|
4354
4782
|
/** Primer día del periodo (FechaInicialPago), AAAA-MM-DD. */
|
|
4355
4783
|
start: string;
|
|
@@ -4425,7 +4853,7 @@ export interface CreateBranchParams {
|
|
|
4425
4853
|
phone?: string | null;
|
|
4426
4854
|
/** Correo, para el PDF. */
|
|
4427
4855
|
email?: string | null;
|
|
4428
|
-
/**
|
|
4856
|
+
/** 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. */
|
|
4429
4857
|
series?: {
|
|
4430
4858
|
/** Serie de sus facturas (tipo I); sin ella, la del emisor. */
|
|
4431
4859
|
invoice?: string | null;
|
|
@@ -4474,7 +4902,7 @@ export interface UpdateBranchParams {
|
|
|
4474
4902
|
phone?: string | null;
|
|
4475
4903
|
/** Correo, para el PDF. */
|
|
4476
4904
|
email?: string | null;
|
|
4477
|
-
/**
|
|
4905
|
+
/** 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. */
|
|
4478
4906
|
series?: {
|
|
4479
4907
|
/** Serie de sus facturas (tipo I); sin ella, la del emisor. */
|
|
4480
4908
|
invoice?: string | null;
|
|
@@ -5500,7 +5928,7 @@ export declare class TestDataResource {
|
|
|
5500
5928
|
/**
|
|
5501
5929
|
* Reiniciar los datos de prueba
|
|
5502
5930
|
*
|
|
5503
|
-
* Deja el modo de pruebas como nuevo: cada emisor de pruebas conserva su RFC y su CSD de pruebas pero pierde sus facturas, clientes, productos, lotes, ligas y descargas, y se borran los eventos y el registro de solicitudes de pruebas. Las llaves y los webhooks se quedan. Con seed (por omisión) deja
|
|
5931
|
+
* Deja el modo de pruebas como nuevo: cada emisor de pruebas conserva su RFC y su CSD de pruebas pero pierde sus facturas, clientes, productos, lotes, ligas y descargas, y se borran los eventos y el registro de solicitudes de pruebas. Las llaves y los webhooks se quedan. Con seed (por omisión) deja 2 clientes y 3 productos de ejemplo. Solo con una llave fk_test_; producción nunca se toca.
|
|
5504
5932
|
*
|
|
5505
5933
|
* POST /v1/test_data/reset
|
|
5506
5934
|
* @see https://fiscalisto.com/docs/api/referencia/cuenta/reset-test-data
|
|
@@ -6123,7 +6551,7 @@ export declare class PayrollReceiptsResource {
|
|
|
6123
6551
|
/**
|
|
6124
6552
|
* Timbrar un recibo de nómina
|
|
6125
6553
|
*
|
|
6126
|
-
* Nómina ordinaria (Nómina 1.2): Fiscalisto calcula sueldo, ISR con subsidio al empleo e IMSS del empleado y el periodo, como la app. Queda como factura tipo N (GET /v1/invoices/{id}). El emisor necesita employer_registration.
|
|
6554
|
+
* Nómina ordinaria (Nómina 1.2): Fiscalisto calcula sueldo, ISR con subsidio al empleo e IMSS del empleado y el periodo, como la app, y nada más: aguinaldo, PTU, finiquitos, bonos, horas extra, Infonavit o préstamos los calcula su sistema y se timbran con POST /v1/payroll_receipts/external (pedirlos aquí contesta payroll_calculation_unsupported). Revise antes el recibo con POST /v1/payroll_receipts/preview y mande su confirmation_token: así solo se timbra el recibo que revisó (si cambió, 409 payroll_calculation_changed). Queda como factura tipo N (GET /v1/invoices/{id}). El emisor necesita employer_registration.
|
|
6127
6555
|
*
|
|
6128
6556
|
* POST /v1/payroll_receipts
|
|
6129
6557
|
* @see https://fiscalisto.com/docs/api/referencia/nomina/create-payroll-receipt
|
|
@@ -6132,12 +6560,30 @@ export declare class PayrollReceiptsResource {
|
|
|
6132
6560
|
/**
|
|
6133
6561
|
* Calcular un recibo sin timbrar
|
|
6134
6562
|
*
|
|
6135
|
-
* El recibo como se timbraría (percepciones, ISR con el subsidio para el empleo, cuotas IMSS y el neto), sin timbrar ni usar timbres.
|
|
6563
|
+
* El recibo como se timbraría (percepciones, ISR con el subsidio para el empleo, cuotas IMSS y el neto), sin timbrar ni usar timbres, con el confirmation_token que lo timbra tal cual y los avisos de lo que no incluye (un finiquito, valores del año que aún no se cargan).
|
|
6136
6564
|
*
|
|
6137
6565
|
* POST /v1/payroll_receipts/preview
|
|
6138
6566
|
* @see https://fiscalisto.com/docs/api/referencia/nomina/preview-payroll-receipt
|
|
6139
6567
|
*/
|
|
6140
6568
|
preview(params: PreviewPayrollReceiptParams, options?: RequestOptions): Promise<PayrollReceiptPreview>;
|
|
6569
|
+
/**
|
|
6570
|
+
* Timbrar un recibo calculado por su sistema
|
|
6571
|
+
*
|
|
6572
|
+
* 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.
|
|
6573
|
+
*
|
|
6574
|
+
* POST /v1/payroll_receipts/external
|
|
6575
|
+
* @see https://fiscalisto.com/docs/api/referencia/nomina/create-external-payroll-receipt
|
|
6576
|
+
*/
|
|
6577
|
+
createExternal(params: ExternalPayrollReceiptCreate, options?: RequestOptions): Promise<Invoice>;
|
|
6578
|
+
/**
|
|
6579
|
+
* Revisar un recibo calculado por su sistema, sin timbrar
|
|
6580
|
+
*
|
|
6581
|
+
* 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[].
|
|
6582
|
+
*
|
|
6583
|
+
* POST /v1/payroll_receipts/external/preview
|
|
6584
|
+
* @see https://fiscalisto.com/docs/api/referencia/nomina/preview-external-payroll-receipt
|
|
6585
|
+
*/
|
|
6586
|
+
previewExternal(params: ExternalPayrollReceiptCreate, options?: RequestOptions): Promise<ExternalPayrollReceiptPreview>;
|
|
6141
6587
|
}
|
|
6142
6588
|
/** Lotes: fiscalisto.invoiceBatches. */
|
|
6143
6589
|
export declare class InvoiceBatchesResource {
|