Listar incidencias
Consulta las incidencias del periodo que lee la nómina, con su estatus de autorización.
Descripcion general
Este endpoint lista las incidencias del registro global de asistencia que caen dentro de la ventana de fechas del periodo, para los empleados del calendario — las que el cálculo de esa corrida lee (la nómina lee el registro global en vivo, por fecha). El cálculo solo paga las filas con approval_status: "approved": las horas extra pendientes de autorizar o rechazadas aparecen en el listado, pero no se pagan.
Es la forma de verificar qué va a ver la nómina de un periodo sin filtrar el registro global a mano.
Requiere que la API key tenga el permiso Listar periodos de nómina.
Endpoint
https://app.integranom.com/api/v1/payroll-calendars/{payroll_calendar_number}/periods/{period_number}/incidencesPath params:
payroll_calendar_number— entero positivo, el número del calendario.period_number— el periodo, con el formato{fiscal_year}-{sequence_number}(por ejemplo2026-11).
Consulta las incidencias del periodo
Devuelve las incidencias de la corrida, paginadas de 20 en 20 y ordenadas por fecha.
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. |
employee_number | integer | No | - | Filtra por empleado. |
incidence_code | string | No | - | Filtra por el código del tipo de incidencia (por ejemplo FALTA). |
source | string | No | - | Filtra por el origen exacto de la captura. Repetible para incluir varios. |
origin | internal | external | No | - | Filtra por la clasificación del origen. Se puede combinar con source. |
Campos de cada fila
| Campo | Tipo | Descripcion |
|---|---|---|
date | string (YYYY-MM-DD) | Día de la incidencia. Siempre dentro del periodo. |
employee_number | integer | Número del empleado. |
employee_name | string | Nombre completo del empleado. |
incidence_code | string | Código del tipo de incidencia. |
incidence_name | string | Nombre del tipo de incidencia. |
unit | "days" | "hours" | "count" | Unidad del tipo de incidencia. |
quantity | number | Cantidad registrada. Los tipos days registran 1, salvo las vacaciones de medio día, que registran 0.5. |
notes | string | null | Notas de la captura. |
approval_status | "approved" | "pending" | "rejected" | Estatus de autorización. Las horas extra dobles y triples quedan en pending hasta que las autorizan todos los niveles configurados, y en rejected si alguno las rechaza; la nómina solo paga las approved. Los demás tipos siempre son approved. |
source | string | Origen exacto de la captura: attendance_module, payroll_run, employee_portal, api o time_clock. |
origin | "internal" | "external" | Clasificación del origen: internal cuando la capturó el equipo de nómina en la plataforma; external en cualquier otro caso (portal de colaborador, reloj checador, integraciones). |
captured_by | string | null | Nombre de quien registró la incidencia: una persona, la integración que la envió o la plataforma. null si ese autor ya no existe. |
updated_by | string | null | Nombre de quien la modificó por última vez. null si nunca se ha editado. |
Son las mismas incidencias del registro global, acotadas a la ventana de fechas del periodo — no hay un registro aparte por periodo.
Errores
| Status | Causa |
|---|---|
400 | payroll_calendar_number o period_number inválidos, o filtro inválido. |
401 | API key ausente o inválida. |
403 | La API key no tiene el permiso Listar periodos de nómina. |
404 | El calendario o el periodo no existen en esta organización. |