Exportar a Excel
Descarga los resultados del periodo en un archivo .xlsx.
Descripcion general
Este endpoint descarga los resultados de un periodo en un archivo Excel (.xlsx): un libro de tres hojas — totales de la corrida, detalle por empleado y conceptos fila por fila.
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-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 la corrida
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-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
Las tres hojas llevan el encabezado de la corrida (razón social, calendario, periodo y fecha de generación).
Hoja 1 — Resumen
Los totales de la corrida, agrupados por sección: Generales (empleados, percepciones, percepciones no monetarias, deducciones y neto), Percepciones por concepto (gravado, exento y total), Deducciones por concepto, y Costo patronal por concepto con el costo total empresa. Cada concepto del catálogo aparece con su clave y su nombre (P001 - Sueldo).
Cuando los datos lo permiten, agrega IMSS patrón desglosado por rama. Si algún empleado no cuenta con ese desglose, la hoja lo advierte con una nota y sus cuotas se reflejan solo en el total de IMSS patronal.
Hoja 2 — Detalle
Formato ancho: una fila por empleado y una columna por concepto, con una fila final de totales. Las columnas de identidad y los encabezados quedan congelados para poder desplazarte.
| Columna | Descripcion |
|---|---|
| Número de empleado / Nombre completo | Identidad del empleado. |
| RFC / NSS / Puesto | Datos fiscales y laborales. |
| Banco / CLABE | Datos bancarios para la dispersión. |
| Días del periodo / Días pagados / Faltas / Incapacidades | Días del periodo y su desglose. |
| Salario diario / SBC / Factor de integración | Bases salariales. |
| (una columna por concepto) | Percepciones y deducciones, cada concepto en su columna; los demás conceptos a cargo del patrón van después de las cuotas. El encabezado lleva la clave y el nombre (P001 - Sueldo), o solo el nombre si no es un concepto del catálogo. |
| Total percepciones / Percepciones no monetarias / Total deducciones | Totales del empleado. |
| Neto a depositar | Lo que se deposita al empleado. |
| Cuotas IMSS e INFONAVIT | Quince columnas fijas con las cuotas del patrón (PAT) y del empleado (EMP), en este orden: 4001 Riesgo de trabajo - PAT, 4002 Cuota fija enf. y mat. - PAT, 4003 Excedente 3 UMA - PAT, 4004 Excedente 3 UMA - EMP, 4005 Prestaciones en dinero - PAT, 4006 Prestaciones en dinero - EMP, 4007 Gastos médicos pensionados - PAT, 4008 Gastos médicos pensionados - EMP, 4009 Invalidez y vida - PAT, 4010 Invalidez y vida - EMP, 4011 Guarderías y prest. sociales - PAT, I005 Retiro (SAR) - PAT, 4012 Cesantía y vejez - patronal, 4013 Cesantía y vejez - EMP e I004 INFONAVIT patronal. Estas claves son etiquetas del reporte, no conceptos del catálogo. Sin desglose por rama, el archivo muestra O001 - IMSS patronal y O002 - INFONAVIT patronal; si solo algunos empleados no lo tienen, conserva O001 - IMSS patronal para ellos. Cuando el patrón absorbe las cuotas de un empleado, sus columnas EMP quedan en cero. |
| Costo social patronal | Todo el costo a cargo del patrón: IMSS, INFONAVIT, impuesto sobre nómina, vales y demás conceptos. |
| Costo social empleado | IMSS descontado al empleado en el recibo. Es informativo y no se suma al costo total empresa. |
| Costo total empresa | Costo del empleado para la empresa. |
Hoja 3 — Conceptos
Formato largo: una fila por empleado y concepto, pensada para tablas dinámicas.
| Columna | Descripcion |
|---|---|
| Número de empleado / Nombre completo | Identidad del empleado. |
| Tipo | Percepción, deducción o costo patronal. |
| Código / Concepto | Clave del concepto en el recibo (P001) y su nombre. En lo que no es un concepto del catálogo, Código lleva el identificador de cálculo de la línea (isn). |
| Gravado / Exento / Importe | Importes del concepto para ese empleado. |
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 en esta organización. |
409 | NOT_CALCULATED | El periodo aún no se ha calculado, así que no hay resultados que exportar. |