Archivos descargables
Listar, descargar y verificar el PDF, el XML y los documentos DIAN de cada revisión, y reintentar su generación.
Al terminar una revisión validada o rechazada se genera su PDF. En habilitación también se extrae la respuesta DIAN (ApplicationResponse) y, si fue aprobada, se firma el AttachedDocument con el certificado original. Ese contenedor incluye el XML firmado y la respuesta DIAN, y no se envía a la DIAN.
Listar y descargar
GET /v1/documents/{id}/artifacts?revision=1 devuelve cada archivo con estado pending, available o failed. Solo los available incluyen download_path, content_type, size_bytes y sha256.
GET /v1/artifacts/{id}/content descarga los bytes. Requiere documents:read y una clave de la misma empresa y ambiente.
- Los PDF se sirven con
application/pdf, descarga forzada,no-store,nosniffyETagigual al SHA-256. - Verifica que el tamaño y el SHA-256 coinciden con el listado antes de usar el archivo.
- Los archivos de revisiones anteriores conservan sus IDs y bytes.
- El piloto
webhook-pilot.tsmuestra la espera acotada y la verificación.
Reintentar un archivo fallido
Si aparece reason_code, corrige la causa y llama POST /v1/artifacts/{id}/retries con documents:write, una nueva Idempotency-Key y { "reason": "Reintentar tras corregir la causa" }.
- Reintentar un archivo disponible o pendiente devuelve conflicto.
- No cambia consecutivo, revisión, estado fiscal ni saldo.
- Los fallos transitorios tienen hasta ocho intentos automáticos por ciclo.
| Código | Significado |
|---|---|
DIAN_APPLICATION_RESPONSE_MISSING / DIAN_RESPONSE_SOURCE_MISSING | Falta la evidencia original de la DIAN; debe recuperarse. No se inventa una aprobación. |
ATTACHED_RESPONSE_UNAVAILABLE | Falta una dependencia del AttachedDocument. |
ATTACHED_SIGNING_AUTHORIZATION_BLOCKED | Revisa la autorización o el certificado original. |
El PDF puede estar disponible aunque fallen los demás archivos.
Contenido del PDF
- Identifica simulación, habilitación y rechazo cuando corresponde.
- Conserva los importes del XML e incluye la identidad y el QR si existen.
- Los caracteres que la fuente no cubre aparecen como códigos Unicode explícitos.
- Límite: 8 MiB. Generarlo no entrega correo ni cambia
delivery_status.
Para operadores
La generación de archivos requiere la migración 031_document_downloadables.sql antes de iniciar esas versiones; también programa revisiones terminales históricas, que quedan fallidas con causa visible si no conservan fuentes. Consultar la API no genera trabajo. Para volver al ejecutable anterior, detén los nuevos consumidores y conserva migración y archivos: no borres evidencia ni reviertas el esquema.
La autenticidad de la respuesta DIAN se apoya en el transporte TLS y su archivo inmutable; se verifica estructura y correlación, sin validación PKI independiente del certificado DIAN.