# Exportar nómina ciega (/docs/developers/api-reference/payroll-calculation/export-blind-excel)

## Descripcion general [#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 [#endpoint]

`GET https://app.integranom.com/api/v1/payroll-calendars/{payroll_calendar_number}/periods/{period_number}/export-blind-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 autorización [#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`.

**cURL**

```bash
curl -X GET "https://app.integranom.com/api/v1/payroll-calendars/1/periods/2026-14/export-blind-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-ciega-corrida-14.xlsx"
Cache-Control: no-store

<contenido binario del archivo .xlsx>
```

## Contenido del libro [#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` [#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` [#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 [#diferencia-con-la-exportación-completa]

|                                    | Nómina ciega | [Exportación completa](/docs/developers/api-reference/payroll-calculation/export-excel) |
| ---------------------------------- | ------------ | --------------------------------------------------------------------------------------- |
| 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 [#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.         |