Ir al contenido
Nómina

FISCALISTO / API / REFERENCIA

Ver un empleado

Abrir en ChatGPTAbrir en Claude
GET
/v1/employees/{id}

Un empleado con sus datos y lo que el SAT podría rechazar en warnings.

Autorización

bearerAuth
headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Parámetros de la ruta

id*string

El id del objeto.

Cuerpo de la respuesta

Correcto.

application/json
  1. response

Un empleado de un emisor, para sus recibos de nómina.

id*string

Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

object*string

Qué tipo de objeto es («invoice», «customer»…).

issuer*string

El emisor (iss_…).

number*string

Número de empleado (NumEmpleado).

name*string

Nombre completo del empleado.

tax_id*string

RFC (Rfc), 12 caracteres una persona moral y 13 una física.

curp*string

CURP, 18 caracteres.

social_security_number*string

Número de seguridad social (NumSeguridadSocial), 11 dígitos.

zip*string

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.

email*|

Correo del empleado, a donde van sus recibos.

start_date*string

Fecha 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*number

Salario diario.

integrated_daily_salary*number

Salario diario integrado (SalarioDiarioIntegrado): no menor al salario diario.

contract_type*string

Tipo de contrato (TipoContrato), c_TipoContrato. Por omisión 01, por tiempo indeterminado.

workday_type*string

Tipo de jornada (TipoJornada), c_TipoJornada. Por omisión 01, diurna.

regime_type*string

Tipo de régimen (TipoRegimen): 02 sueldos y salarios.

periodicity*string

Periodicidad del pago (PeriodicidadPago): 02 semanal, 03 catorcenal, 04 quincenal (por omisión), 05 mensual.

risk_class*string

Clase de riesgo del puesto ante el IMSS (RiesgoPuesto), 1 a 5. Por omisión 1.

state*string

Entidad federativa donde trabaja (ClaveEntFed): JAL, CMX, NLE…

border_zone*boolean

true si trabaja en la zona libre de la frontera norte (salario mínimo de frontera).

unionized*boolean

true 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*string

Cuándo se creó, ISO 8601 con la hora de la Ciudad de México (-06:00).

Formatodate-time
curl -X GET 'https://api.fiscalisto.com/v1/employees/string' \  -H 'Authorization: Bearer fk_test_…'
{  "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"}

Crear un empleado POST

Un empleado del emisor para sus recibos de nómina: RFC, CURP, NSS, salario diario, salario diario integrado y periodicidad. Lo que no mande tiene el valor usual (contrato indefinido, jornada diurna, quincenal, riesgo clase I). warnings dice lo que el SAT podría rechazar.

Actualizar un empleado POST

Cambia solo los campos que manda; los recibos ya timbrados no cambian.