Documentación del API
Descarga UBL Documento Nómina Electrónica
1. Información General
| Propiedad |
Valor |
| Nombre |
Obtener URL XML NE Alianzas |
| Versión |
1 |
| Última actualización |
2026/06/05 |
| Responsable / Equipo |
GoldTeam |
Servicio orientado a la descarga del archivo XML asociado a un documento
previamente identificado mediante IdDocumento.
Interactúa con RepexT para obtener el contenido XML y lo entrega al
cliente como archivo descargable.
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:
- MasterKey (vía parámetro URL {token})
- JWT (vía API Management)
Ejemplo
Authorization: Bearer {token}
4. Estructura General
GET
/PayrollAlliances/GetPayrollXml/{ldf}/{token}
| Elemento |
Descripción |
| Entrada |
Parámetro LDF convertido internamente a IdDocumento y parámetro
token MasterKey suministrado al cliente.
|
| 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. |
NOMINA-ELECTRONICA(...) |
| token |
string |
Sí |
Token de seguridad suministrado al cliente. |
c5b8b7a9-857a-4ac9-ab98-227eb78b44b7 |
5. Modelos de Datos
Ejemplo Request
GET PayrollAlliances/GetXmlByLdf/NOMINA-ELECTRONICA(900399741;SPNE701;2026-05-12;PRINCIPAL;PRINCIPAL)/aaaaaaaa-bbbb-bbbb-cccc-dddddddd
Ejemplo Response
La respuesta es un archivo XML binario.
<?xml version="1.0" encoding="UTF-8"?>
<NominaIndividual>
...
</NominaIndividual>
CURL Ejemplo
curl --location 'https://apimng-qa.facture.co/PayrollAlliances/GetPayrollXml/NOMINA-ELECTRONICA(900399741;SPNE701;2026-05-12;PRINCIPAL;PRINCIPAL)/c5b8b7a9-857a-4ac9-ab98-227eb78b44b7' \
--header 'X-Who: suscripcion key' \
--header 'Authorization: TOKEN AUTENTICACION'
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
- Rate limit por producto: máximo 5 usuarios concurrentes por segundo.
- Rate limit por usuario: máximo 5 peticiones por segundo por usuario.
- Respuesta si se excede: 429 Too Many Requests.
- 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. |