Documentación API - Descargar ACK De Documento

1. Información General

Propiedad	Valor
Nombre	GET ACK By LDF
Versión	1
Última actualización	2025/11/19
Responsable / Equipo	GoldTeam

Este servicio permite la descarga del archivo XML correspondiente al acuse (ACK) asociado a un documento electrónico.

El sistema recibe el identificador interno IdDocumento mediante binding especializado, consulta el repositorio remoto Repext, recupera el 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:

Sin autenticación (AllowAnonymous / bindings internos)

El endpoint opera bajo un binding propietario LDFParameterBinding que resuelve automáticamente el identificador del documento. No requiere autenticación explícita desde el canal cliente.

4. Estructura General

GET /Documents/{LDF}/Ack

Elemento	Descripción
Entrada	Texto codificado (LDF) convertido internamente a IdDocumento.
Salida	Archivo XML (binario).

El endpoint consulta el servicio Repext para obtener el contenido del archivo ACK en formato XML y lo expone como descarga directa.

El nombre del archivo es generado dinámicamente utilizando el patrón: {LDF_ACK}.xml.

Headers

Nombre	Tipo	Requerido	Descripción	Ejemplo
Accept	string	Sí	Tipo de contenido esperado por el cliente.	application/xml
Content-Type	string	No	Opcional para operaciones GET.	application/json

Parámetros

Nombre	Tipo	Requerido	Descripción	Ejemplo
LDF	string	Sí	Identificador codificado del documento procesado mediante LDFParameterBinding.	FACTURA-UBL(900124159;SETT4576734;2025-11-18;PRINCIPAL;PRINCIPAL)

5. Modelos de Datos

Request

No tiene body.

Únicamente se envía el parámetro LDF.

Response (XML descargable)

El servicio retorna:

Content-Type: application/octet-stream
Content-Disposition: attachment; filename="{LDF_ACK}.xml"

El archivo corresponde al contenido del ACK generado por la DIAN o ecosistema relacionado y almacenado en el módulo Repext.

CURL Ejemplo

curl --location 'https://apimng-beta.facture.co/Documents/FACTURA-UBL(900399741;SETP994712393;2026-06-10;PHABILITACION;PRINCIPAL)/Ack' \
--header 'Authorization: Bearer     TOKEN DE AUTENTICACIÓN' \
--header 'X-WHO: KEY'"

Respuestas Posibles

Código	Significado	Descripción
200	OK	El XML de acuse fue encontrado y entregado exitosamente.
400	Bad Request	El parámetro LDF es inválido o no se pudo resolver el identificador.
404	Not Found	No existe acuse asociado al documento solicitado.
500	Internal Server Error	Error al consultar Repext o recuperar el archivo XML.

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	ACK no encontrado	El documento no tiene acuse emitido o aún no sincroniza.	Validar estado de envíos y tiempos de réplica.
400	LDF inválido	El valor no puede ser decodificado.	Revisar integridad del parámetro.
500	Error en RepextClient	Fallo en el servicio externo de réplica.	Validar disponibilidad del servicio remoto.
500	Archivo corrupto o vacío	El XML retornado no posee contenido válido.	Revisar logs y almacenamiento en origen.