> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Descarga de archivo ZIP

El servicio permite descargar en un archivo **.zip** los archivos de un documento electrónico emitido por la empresa: el XML del documento (AttachedDocument) y su representación gráfica en PDF. Aplica para facturas, notas crédito y notas débito.

El método de solicitud es GET y no requiere el encabezado "Authorization": los datos se envían como parámetros en la URL, por lo que el enlace se puede abrir directamente desde el navegador.

## Prerequisitos

Antes de descargar el documento, se debe contar con los siguientes datos:

* Identificador único de la empresa (UUID) asignado por SEDI-ERP
* Identificador único del documento (UniqueID), obtenido del servicio de [facturas del cliente](https://tech.sedierp.com/consulta-general-facturas.md), [notas crédito](https://tech.sedierp.com/extranet/notas-credito-consultar) o [notas débito](https://tech.sedierp.com/extranet/notas-debito-consultar)

## Descargar documento

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/Facturas/GenerarZIP](https://portal.sedierp.com/API_FAC/api/Facturas/GenerarZIP)\
**Tipo:** GET \
**Respuesta:** application/zip

**UniqueID** `GUID` *required*

Identificador único del documento electrónico.

**OrigenDocumento** `int` *required*

Tipo de documento electrónico.

| Código | Tipo de documento |
| - | - |
| 1 | Factura |
| 2 | Nota crédito |
| 3 | Nota débito |

**UUID** `GUID` *required*

Identificador único de la empresa.

**Token** `GUID` *required*

Token de sesión del cliente asignado por SEDI-ERP.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/Facturas/GenerarZIP?UniqueID=698236ef-c704-4063-bf81-f114677aced7&OrigenDocumento=1&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output documento.zip
```

### Respuesta

Si el documento existe, el servicio retorna el archivo .zip (`Content-Type: application/zip`) con los siguientes archivos:

| Archivo | Descripción |
| - | - |
| XML del AttachedDocument | Documento electrónico validado por la DIAN, con el nombre del archivo registrado en la plataforma. Se omite si el archivo no existe en el servidor. |
| `Factura_<Prefijo>-<Consecutivo>.pdf` | Representación gráfica del documento. Para notas crédito el nombre es `NotaCredito_<Sigla>-<Consecutivo>.pdf` y para notas débito `NotaDebito_<Sigla>-<Consecutivo>.pdf`. |

El nombre del archivo .zip se compone del prefijo (o sigla), el consecutivo y el número de documento del cliente, por ejemplo `FE15201032456789.zip`.

Si el documento no existe o el `OrigenDocumento` no es 1, 2 ni 3, el servicio responde HTTP 400 con el texto "No se encontro el documento en el sistema". Si algún parámetro no tiene el formato correcto (GUID o número), responde HTTP 400 con el detalle de la validación.

```bash Request theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/Facturas/GenerarZIP?UniqueID=698236ef-c704-4063-bf81-f114677aced7&OrigenDocumento=1&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output documento.zip
```

```text Exitosa theme={null}
HTTP/1.1 200 OK
Content-Type: application/zip
Content-Disposition: attachment; filename=FE15201032456789.zip

FE15201032456789.zip
├── ad09001234560002600001520.xml
└── Factura_FE-1520.pdf
```

```json Error theme={null}
"No se encontro el documento en el sistema"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.