Documentación del API
Descargar PDF De Documento
1. Información General
| Propiedad |
Valor |
| Nombre |
GetBinaryByLdf – Descarga de representación PDF (vía LDF) |
| Versión |
1 |
| Última actualización |
2025/11/19 |
| Responsable / Equipo |
GoldTeam |
Servicio orientado a la entrega de la representación gráfica (PDF)
de un documento electrónico, obteniéndola directamente desde Repext
utilizando el identificador LDF.
Si no existe representación gráfica disponible, el servicio retorna
un PDF genérico indicando Documento No Disponible.
2. Base URL
| Ambiente |
URL |
| Producción |
https://apimng-pro.facture.co |
| Beta |
https://apimng-beta.facture.co |
3. Autenticación
Tipo de autenticación: JWT
Authorization: Bearer {token}
4. Estructura General
GET
/Documents/{LDF}/RepresentacionGrafica/BinarioByLDF
| Elemento |
Descripción |
| Entrada |
Parámetro LDF (IdDocumento) |
| Salida |
Binario PDF |
Obtiene la representación gráfica de un documento electrónico
consultando directamente Repext por medio del identificador LDF.
Headers
| Nombre |
Tipo |
Requerido |
Descripción |
Ejemplo |
| Authorization |
string |
Sí |
Token JWT del cliente |
Bearer {token} |
| Accept |
string |
Sí |
Tipo de respuesta esperado |
application/pdf |
| Content-Type |
string |
No aplica |
No requerido para solicitudes GET |
N/A |
Parámetros
| Nombre |
Tipo |
Requerido |
Descripción |
Ejemplo |
| idDocumento |
LDF (objeto compuesto) |
Sí |
Identificador del documento electrónico estructurado mediante LDF. |
N/A |
5. Modelos de Datos
Ejemplo Request
{
"idDocumento": "Representación LDF del documento"
}
Ejemplo Response
Tipo: Binario (PDF)
Content-Disposition: attachment; filename="File.pdf"
CURL Ejemplo
curl --location 'https://apimng-beta.facture.co/Documents/FACTURA-UBL(900399741;SETP994712393;2026-06-10;PHABILITACION;PRINCIPAL)/RepresentacionGrafica/Binario' \
--header 'Authorization: Bearer TOKEN DE AUTENTICACIÓN ' \
--header 'X-WHO: KEY'
No incluir masterKey. Sustituir {data} por el valor LDF correspondiente.
Respuestas Posibles
| Código |
Significado |
Descripción |
| 200 |
OK |
Retorna el PDF solicitado. |
| 400 |
Bad Request |
Formato LDF inválido o parámetros inconsistentes. |
| 401 |
Unauthorized |
Token ausente o inválido. |
| 404 |
Not Found |
No existe representación gráfica para el documento. |
| 500 |
Internal Server Error |
Error no controlado en el procesamiento o en Repext. |
6. Rate Limit
| Concepto |
Valor |
| Por producto |
Máximo 5 usuarios concurrentes por segundo |
| Por usuario |
Máximo 5 peticiones por segundo |
| Respuesta al exceder el límite |
429 Too Many Requests |
| Condiciones especiales |
N/A |
7. Errores Comunes
| Código |
Error |
Causa |
Solución |
| 404 |
Document_Not_Available |
Repext no tiene PDF para dicho documento. |
Validar origen del documento o intentar regeneración por canal autorizado. |
| 400 |
LDF inválido |
Información incompleta o mal estructurada. |
Verificar la construcción del LDF. |
| 500 |
Error interno |
Falla en servicios internos o conexión con Repext. |
Reintentar y revisar logs. |