Nómina
FISCALISTO / API / REFERENCIA
FISCALISTO / API / REFERENCIA
Cambia solo los campos que manda; los recibos ya timbrados no cambian.
bearerAuthAutorizaciónBearer <llave>Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.
id*stringEl id del objeto.
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/jsonnumber?stringNúmero de empleado (NumEmpleado).
1 <= length <= 15name?stringNombre completo del empleado, como en su constancia de situación fiscal.
1 <= length <= 300tax_id?stringRFC (Rfc), 12 caracteres una persona moral y 13 una física.
curp?stringCURP, 18 caracteres.
social_security_number?stringNúmero de seguridad social (NumSeguridadSocial), 11 dígitos.
zip?stringCó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.
^\d{5}$email?|Correo del empleado, a donde van sus recibos con send_email.
start_date?stringFecha de inicio de la relación laboral (FechaInicioRelLaboral), AAAA-MM-DD.
^\d{4}-\d{2}-\d{2}$end_date?|Último día trabajado si ya no trabaja ahí, AAAA-MM-DD.
daily_salary?numberSalario diario.
0 < valueintegrated_daily_salary?numberSalario diario integrado (SalarioDiarioIntegrado): no menor al salario diario.
0 < valuecontract_type?stringTipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado.
"01""02""03""04""05""06""07""08"workday_type?stringTipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna.
periodicity?stringPeriodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual.
risk_class?stringClase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1.
state?stringEntidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE…
border_zone?booleantrue si trabaja en la zona libre de la frontera norte (salario mínimo de frontera).
unionized?booleantrue si es sindicalizado (Sindicalizado).
department?|Departamento (Departamento).
position?|Puesto (Puesto).
Correcto.
application/jsonUn empleado de un emisor, para sus recibos de nómina.
id*stringIdentificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).
livemode*booleantrue en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.
object*stringQué tipo de objeto es («invoice», «customer»…).
issuer*stringEl emisor (iss_…).
number*stringNúmero de empleado (NumEmpleado).
name*stringNombre completo del empleado.
tax_id*stringRFC (Rfc), 12 caracteres una persona moral y 13 una física.
curp*stringCURP, 18 caracteres.
social_security_number*stringNúmero de seguridad social (NumSeguridadSocial), 11 dígitos.
zip*stringCó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.
email*|Correo del empleado, a donde van sus recibos.
start_date*stringFecha de inicio de la relación laboral (FechaInicioRelLaboral), AAAA-MM-DD.
end_date*|Último día trabajado si ya no trabaja ahí, AAAA-MM-DD.
daily_salary*numberSalario diario.
integrated_daily_salary*numberSalario diario integrado (SalarioDiarioIntegrado): no menor al salario diario.
contract_type*stringTipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado.
workday_type*stringTipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna.
regime_type*stringTipo de régimen (TipoRegimen): 02 sueldos y salarios.
periodicity*stringPeriodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual.
risk_class*stringClase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1.
state*stringEntidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE…
border_zone*booleantrue si trabaja en la zona libre de la frontera norte (salario mínimo de frontera).
unionized*booleantrue si es sindicalizado (Sindicalizado).
department*|Departamento (Departamento).
position*|Puesto (Puesto).
warnings*array<string>Lo que el SAT podría observar de sus datos, antes de timbrar.
created_at*stringCuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).
date-timecurl -X POST 'https://api.fiscalisto.com/v1/employees/string' \ -H 'Authorization: Bearer fk_test_…' \ -H 'Idempotency-Key: 8f14e45f-ceea-467a-9575-6a1b0e5f3c21' \ -H 'Content-Type: application/json' \ -d '{ "daily_salary": 350, "integrated_daily_salary": 366}'{ "id": "emp_OufpKqnrvx9p3RxmD1RIDgEHzKYPYnYBlV", "object": "employee", "livemode": false, "issuer": "iss_OufpKqnrvx9p", "number": "9", "name": "ANA GÓMEZ RUIZ", "tax_id": "GORA800101JK2", "curp": "GORA800101MDFMZN09", "social_security_number": "12345678903", "zip": "06000", "email": null, "start_date": "2024-03-04", "end_date": null, "daily_salary": 320, "integrated_daily_salary": 334.66, "contract_type": "01", "workday_type": "01", "regime_type": "02", "periodicity": "02", "risk_class": "1", "state": "CMX", "border_zone": false, "unionized": false, "department": null, "position": null, "warnings": [], "created_at": "2026-10-20T09:02:11-06:00"}