FISCALISTO / API / REFERENCIA
Calcular un recibo sin timbrar
El recibo como se timbraría (percepciones, ISR con el subsidio para el empleo, cuotas IMSS y el neto), sin timbrar ni usar timbres.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
Idempotency-Key?stringOpcional (los SDK la mandan solos). Si la respuesta se pierde, repita la solicitud con el mismo valor durante 24 horas: contesta lo mismo, con idempotent-replayed: true, y no lo hace dos veces (ni crea, ni manda correos, ni cobra).
1 <= length <= 255application/json- body
employee*stringEl empleado (emp_…).
1 <= lengthperiod*Periodo (Periodo): mes inicial, mes final y año.
days?numberDías pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan.
0 < value <= 31send_email?booleantrue para mandar el PDF y el XML por correo al timbrar, con el diseño de Fiscalisto. Por omisión no se envía.
metadata?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.
Correcto.
application/json- response
El recibo como se timbraría: percepciones, deducciones (ISR, IMSS), otros pagos (subsidio) y el neto.
object*stringQué tipo de objeto es («invoice», «customer»…).
employee*stringEl empleado (emp_…).
periodicity*stringPeriodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual.
period*Periodo (Periodo): mes inicial, mes final y año.
days*numberDías pagados (NumDiasPagados). Por omisión, todos los del periodo que le tocan.
contribution_base_salary*numberSalario base de cotización (SalarioBaseCotApor).
perceptions*array<>Percepciones (Percepcion): sueldo y demás, gravado y exento.
deductions*array<>Deducciones (Deduccion): ISR, cuotas IMSS y demás.
other_payments*array<>Otros pagos (OtroPago): subsidio para el empleo.
isr*El cálculo del ISR del periodo: base, tarifa, subsidio y resultado.
totals*Totales: percepciones, deducciones, otros pagos y el neto a pagar.
curl -X POST 'https://api.fiscalisto.com/v1/payroll_receipts/preview' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "employee": "emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV", "period": { "start": "2026-10-10", "end": "2026-10-16" }}'{ "object": "payroll_receipt_preview", "employee": "emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV", "periodicity": "02", "period": { "start": "2026-10-10", "end": "2026-10-16", "payment_date": "2026-10-16" }, "days": 7, "contribution_base_salary": 334.66, "perceptions": [ { "type": "001", "key": "001", "concept": "Sueldo", "taxed": 2240, "exempt": 0 } ], "deductions": [ { "type": "001", "key": "001", "concept": "Cuotas IMSS", "amount": 55.63 }, { "type": "002", "key": "002", "concept": "ISR", "amount": 37.73 } ], "other_payments": [ { "type": "002", "key": "002", "concept": "Subsidio para el empleo del Decreto que otorga el subsidio para el empleo (DOF 1 de mayo de 2024)", "amount": 0, "subsidy_caused": 123.34, "subsidy_applied": 123.34 } ], "isr": { "tariff": 161.07, "subsidy": 123.34, "withheld": 37.73, "exempt_minimum": false }, "totals": { "salaries": 2240, "taxed": 2240, "exempt": 0, "perceptions": 2240, "other_deductions": 55.63, "taxes_withheld": 37.73, "deductions": 93.36, "other_payments": 0, "subtotal": 2240, "net": 2146.64 }}Timbrar un recibo de nómina POST
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.
Listar lotes GET
Los lotes de facturas, los más recientes primero, con cuántas se timbraron y cuántas fallaron.