# Exportar a Excel (/docs/developers/api-reference/payroll-calculation/export-excel) ## Descripcion general [#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 [#endpoint] `GET https://app.integranom.com/api/v1/payroll-calendars/{payroll_calendar_number}/periods/{period_number}/export-excel` **Path params:** * `payroll_calendar_number` — entero positivo, el número del calendario. * `period_number` — el periodo, con el formato `{fiscal_year}-{sequence_number}` (por ejemplo `2026-14`). ## Descarga el libro de la corrida [#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`. **cURL** ```bash curl -X GET "https://app.integranom.com/api/v1/payroll-calendars/1/periods/2026-14/export-excel" \ -H "Authorization: Bearer TU_API_KEY" \ -OJ ``` **Respuesta** ```http HTTP/1.1 200 OK Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet Content-Disposition: attachment; filename="nomina-corrida-14.xlsx" Cache-Control: no-store ``` ## Contenido del libro [#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` [#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` [#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` [#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 [#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. |