Skip to main content
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:

​
Generar certificado financiero

Request URL: 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).
​
int
required
Código del tipo de certificado financiero a generar. Se obtiene del servicio de tipos de certificados financieros.
​
int
required
Año gravable del certificado (ej. 2025).
​
int
required
Código único del cliente (ID) para el que se genera el certificado.
​
string
Forma de entrega del PDF.Cualquier valor diferente de true (incluidos 1 y 0) se trata como false y el PDF se visualiza en línea.
​
GUID
required
Identificador único de la empresa.
​
GUID
required
Token de sesión del cliente.

​
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:
​
array
Listado con el certificado generado.