Referencia de la APITipos de incidencia
Listar
Descripcion general
Este endpoint permite obtener un listado paginado del catálogo de tipos de incidencia. El catálogo es fijo y administrado por la plataforma: es el mismo para todas las organizaciones, no está ligado a una razón social y no se puede crear, editar ni eliminar desde la API. Su code es único en todo el catálogo y es el identificador que usas al capturar incidencias. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación.
Endpoint
GET
https://app.integranom.com/api/v1/incidence-typesConsulta multiples tipos de incidencia
Devuelve todo el catálogo, paginado de 20 en 20. Puedes acotar el listado por categoría, por unidad, por su mapeo a nómina o por su flag activo.
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. |
category | TIME | MONETARY | No | - | Filtra por categoría del tipo. |
unit | days | hours | count | No | - | Filtra por la unidad de captura. |
payroll_mapping | string | No | - | Filtra por el mapeo a nómina (por ejemplo faltas, overtime_double_hours). |
active | "true" | "false" | No | - | Filtra por el flag is_active. |
Consulta un tipo de incidencia por codigo
Busca un tipo de incidencia particular por su código con code. La coincidencia es exacta.
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
code | string | No | - | Filtra por el código exacto del tipo de incidencia. |
Campos de cada fila
| Campo | Tipo | Descripcion |
|---|---|---|
code | string | Código del tipo. Único en todo el catálogo; es el que usas para capturar incidencias. |
name | string | Nombre legible del tipo. |
category | "TIME" | "MONETARY" | Categoría del tipo. Sólo los TIME se capturan en el ledger de asistencia. |
unit | "days" | "hours" | "count" | Unidad en la que se captura la incidencia (días, horas u ocurrencias). |
payroll_mapping | string | Columna de nómina a la que se acumula la incidencia; none si es informativa. |
is_paid | boolean | true si la incidencia es con goce de sueldo. |
is_active | boolean | Flag activo del tipo. |
sort_order | integer | Orden de despliegue dentro del catálogo. |
created_at | string (ISO 8601) | Fecha de creación del tipo. |
updated_at | string (ISO 8601) | Última modificación del tipo. |
Errores
| Status | Causa |
|---|---|
400 | Valor inválido en algún filtro (category, unit, payroll_mapping o active). |
401 | API key ausente o inválida. |