Referencia de la APIRegistros patronales
Listar
Descripcion general
Este endpoint permite obtener un listado paginado de los registros patronales (IMSS) pertenecientes a tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Cada registro está vinculado a una razón social mediante legal_entity_number. Los registros eliminados se excluyen automáticamente. El tamaño de página es fijo en 20 resultados.
risk_premium se serializa como string decimal (por ejemplo "0.0054355") para preservar la precisión. premium_effective_from se serializa como timestamp ISO 8601.
Endpoint
GET
https://app.integranom.com/api/v1/employer-registrationsConsulta multiples registros patronales
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
legal_entity_number | integer | No | - | Restringe los resultados a una sola razón social. |
active | "true" | "false" | No | - | Filtra por el flag is_active. |
Consulta un registro patronal especifico
Se puede buscar un registro patronal particular por su número org-scoped o por el número IMSS exacto. El campo number distingue mayúsculas y minúsculas.
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
employer_registration_number | integer | No | - | Filtra por número org-scoped exacto del registro patronal. |
number | string | No | - | Filtra por número IMSS exacto. |
Errores
| Status | Causa |
|---|---|
400 | Valor inválido en employer_registration_number, legal_entity_number o active; o legal_entity_number no corresponde a una razón social de la organización. |
401 | API key ausente o inválida. |