> ## 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.

# Certificaciones tributarias

El servicio permite a los usuarios generar en formato PDF un certificado financiero del cliente (certificados de retención, entre otros) para un año determinado. El PDF se puede descargar, visualizar en línea en el navegador u obtener codificado en base64 dentro de un JSON.

El método de solicitud es GET y no requiere el encabezado "Authorization": el cliente se identifica con el token de sesión (`Token`) y el identificador de la empresa (`UUID`) enviados en la URL, para que el certificado se pueda abrir directamente en el navegador.

## Prerequisitos

Antes de generar un certificado financiero, se debe contar con los siguientes datos:

* Código del cliente (TerceroID), identificador de la empresa (UUID) y token de sesión (Token), obtenidos del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)
* Código del tipo de certificado obtenido del servicio de [tipos de certificados financieros](https://tech.sedierp.com/tipos-de-certificados-financieros.md)

## Generar certificado financiero

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/CertificadosFinancieros/Generar](https://portal.sedierp.com/API_FAC/api/CertificadosFinancieros/Generar)\
**Tipo:** GET \
**Respuesta:** application/pdf

Los parámetros se envían en la URL (query string).

**TipoCertificadoFinancieroID** `int` *required*

Código del tipo de certificado financiero a generar. Se obtiene del servicio de [tipos de certificados financieros](https://tech.sedierp.com/tipos-de-certificados-financieros.md).

**Ano** `int` *required*

Año gravable del certificado (ej. 2025).

**TerceroID** `int` *required*

Código único del cliente (ID) para el que se genera el certificado.

**Attachment** `string`

Forma de entrega del PDF.

| Valor | Respuesta |
| - | - |
| true | Descarga el PDF como archivo adjunto con el nombre del certificado. |
| false | Visualiza el PDF en línea en el navegador. |
| (vacío) o null | Retorna un JSON con el PDF codificado en base64. |

Cualquier valor diferente de `true` (incluidos `1` y `0`) se trata como `false` y el PDF se visualiza en línea.

**UUID** `GUID` *required*

Identificador único de la empresa.

**Token** `GUID` *required*

Token de sesión del cliente.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/CertificadosFinancieros/Generar?TipoCertificadoFinancieroID=1&Ano=2025&TerceroID=48213&Attachment=true&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output certificado.pdf
```

### Validaciones

El servicio realiza las siguientes validaciones antes de generar el certificado. Si alguna no se cumple, no se genera el certificado y se retorna HTTP 400 con el mensaje correspondiente en texto plano.

* `TipoCertificadoFinancieroID` y `Ano` son obligatorios y deben ser diferentes de 0.
* `TerceroID` y `Token` son obligatorios.
* `TerceroID` debe ser numérico y `UUID` y `Token` deben tener formato GUID.
* El `UUID` debe corresponder a una empresa y debe existir información para generar el certificado; de lo contrario se retorna "No se encontraron certificados para generar".

### Respuesta

Según el parámetro `Attachment`, el servicio retorna:

* **`Attachment=true`:** el archivo PDF (`Content-Type: application/pdf`) con el encabezado `Content-Disposition: attachment` y el nombre del certificado, para que el navegador lo descargue.
* **`Attachment=false`:** el archivo PDF (`Content-Type: application/pdf`) sin nombre de archivo, para que el navegador lo muestre en línea.
* **`Attachment` vacío o null:** un JSON con los siguientes campos:

**rows** `array`

Listado con el certificado generado.

**propiedades**

**File** `string`

Contenido del PDF codificado en base64.

**FileName** `string`

Nombre del archivo PDF del certificado.

**MimeType** `string`

Tipo de contenido del archivo: "application/pdf".

```bash Request theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/CertificadosFinancieros/Generar?TipoCertificadoFinancieroID=1&Ano=2025&TerceroID=48213&Attachment=true&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output certificado.pdf
```

```text Descarga theme={null}
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=CertificadoRetencionFuente_2025.pdf; filename*=UTF-8''CertificadoRetencionFuente_2025.pdf

(contenido binario del PDF)
```

```json Base64 theme={null}
{
    "rows": [
        {
            "File": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoK...",
            "FileName": "CertificadoRetencionFuente_2025.pdf",
            "MimeType": "application/pdf"
        }
    ]
}
```

```text Error theme={null}
El parametro Token es obligatorio
```

```text Sin resultados theme={null}
No se encontraron certificados para generar
```


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