Documentación API
Descargar UBL De Documento
1. Información General
| Propiedad |
Valor |
| Nombre |
GetXml |
| Versión |
1 |
| Última actualización |
2025/11/19 |
| Responsable / Equipo |
GoldTeam |
Servicio orientado a la descarga del archivo XML asociado a un documento
previamente identificado mediante LDF.
Interactúa con RepexT para obtener el contenido XML y lo entrega como
archivo descargable al cliente consumidor.
2. Base URL
| Ambiente |
URL |
| Producción |
https://apimng-pro.facture.co |
| Beta |
https://apimng-beta.facture.co |
3. Autenticación
Tipo: JWT (vía API Management)
Authorization: Bearer {token}
4. Estructura General
GET
/xml/{ldf}
| Elemento |
Valor |
| Entrada |
Parámetro LDF convertido internamente a IdDocumento. |
| Salida |
XML (application/octet-stream) |
Servicio que obtiene el archivo XML generado por RepexT para un documento
determinado y lo retorna como archivo descargable.
Headers
| Nombre |
Tipo |
Requerido |
Descripción |
Ejemplo |
| Accept |
string |
Sí |
Tipo de respuesta esperado |
application/octet-stream |
Parámetros URI
| Nombre |
Tipo |
Requerido |
Descripción |
Ejemplo |
| ldf |
string |
Sí |
LDF que identifica el documento. |
DTE|FV|12345|2024-01-01|01 |
5. Modelos de Datos
Ejemplo Request
GET /xml/DTE|FV|12345|2024-01-01|01
Ejemplo Response
<?xml version="1.0" encoding="UTF-8"?>
<Invoice>
...
</Invoice>
CURL Ejemplo
curl --location 'https://apimng-beta.facture.co/Documents/FACTURA-UBL(900399741;SETP994712393;2026-06-10;PHABILITACION;PRINCIPAL)/Xml' \
--header 'Authorization: Bearer TOKEN AUTENTICACIÓN' \
--header 'X-WHO: KEY'
Respuestas Posibles
| Código |
Significado |
Descripción |
| 200 |
OK |
Retorna el XML solicitado. |
| 400 |
Bad Request |
LDF inválido o no convertible a IdDocumento. |
| 404 |
Not Found |
No existe XML asociado en RepexT. |
| 500 |
Internal Server Error |
Error interno en la obtención del XML. |
6. Rate Limit
| Concepto |
Valor |
| Rate Limit |
NA |
| Respuesta si se excede |
429 Too Many Requests |
| Retry-After |
NA |
| Condiciones especiales |
N/A |
7. Errores Comunes
| Código |
Error |
Causa |
Solución |
| 400 |
LDF inválido |
Fallo en el binding hacia IdDocumento. |
Validar formato del LDF. |
| 404 |
XML no encontrado |
RepexT retornó bytes vacíos. |
Validar existencia del documento. |
| 500 |
Error al obtener binario |
RepexT no respondió o falló. |
Revisar AppInsights y dependencias. |