Exportar nómina ciega
Descarga el Excel de autorización del periodo, sin importes por empleado.
Descripcion general
Este endpoint descarga la nómina ciega del periodo en un archivo Excel (.xlsx): el libro de autorización que se comparte para firma. Trae los totales globales de la corrida y, por persona, únicamente días e incidencias — nunca el importe individual de nadie.
Es el mismo libro que la plataforma genera desde la corrida, para cuando alguien debe autorizar la nómina sin ver los sueldos de cada empleado.
A diferencia del resto de la API, la respuesta no es JSON: es el archivo binario. Solo los errores se devuelven en JSON.
Requiere un periodo calculated o closed (un periodo sin abrir o en draft todavía no tiene resultados que exportar). Requiere que la API key tenga el permiso Exportar nómina.
Endpoint
https://app.integranom.com/api/v1/payroll-calendars/{payroll_calendar_number}/periods/{period_number}/export-blind-excelPath params:
payroll_calendar_number— entero positivo, el número del calendario.period_number— el periodo, con el formato{fiscal_year}-{sequence_number}(por ejemplo2026-14).
Descarga el libro de autorización
La respuesta es el archivo .xlsx tal cual (no va en base64 ni envuelto en JSON). El nombre del archivo viaja en el encabezado Content-Disposition: con curl -OJ se guarda como nomina-ciega-corrida-14.xlsx. Algunos clientes REST ignoran ese encabezado y guardan la respuesta sin extensión — el archivo es correcto, solo renómbralo agregando .xlsx.
Contenido del libro
Dos hojas, ambas con el encabezado de la corrida (razón social, calendario, periodo y fecha de generación).
Hoja 1 — Autorización
Los totales de la corrida: Generales (empleados, percepciones, deducciones y neto), Percepciones por concepto, Deducciones por concepto, y Costo patronal por concepto con el costo total empresa.
Hoja 2 — Personal
Una fila por empleado, sin importes:
| Columna | Descripcion |
|---|---|
| Número de empleado / Nombre completo | Identidad del empleado. |
| Puesto | Puesto del empleado. |
| Días pagados / Faltas / Incapacidades | Días del periodo para esa persona. |
| Incidencias | Cuántas incidencias del periodo tiene registradas. |
Diferencia con la exportación completa
| Nómina ciega | Exportación completa | |
|---|---|---|
| Totales de la corrida | Sí | Sí |
| Importes por empleado | No | Sí |
| Días e incidencias por empleado | Sí | Sí |
| Desglose por concepto por empleado | No | Sí |
Errores
Los errores sí se devuelven en JSON.
| Status | Código | Causa |
|---|---|---|
400 | — | payroll_calendar_number o period_number inválidos en la URL. |
401 | — | API key ausente o inválida. |
403 | — | La API key no tiene el permiso Exportar nómina. |
404 | — | El calendario o el periodo no existen, o la corrida no tiene empleados calculados. |
409 | NOT_CALCULATED | El periodo aún no se ha calculado, así que no hay resultados que exportar. |