Documentación · Conceptos · API v1 · versión 2026-10-22
Archivos
Descargar el PDF, el XML, el ZIP y la respuesta de la DIAN de un documento, y entender cuándo están listos.
Cada documento validado tiene sus archivos, que se piden con un GET y llegan en binario, listos para guardar:
| Ruta | Archivo |
|---|---|
…/{id}/pdf |
La representación gráfica (PDF) |
…/{id}/xml |
El XML firmado |
…/{id}/zip |
El ZIP con el XML y el PDF |
…/{id}/dian_response |
La respuesta de la DIAN |
GET /v1/invoices/{id}/pdf
curl "https://api.trevol.si/v1/invoices/inv_3f0c1a2b3f0c1a2b3f0c1a2b3f0c1a2b/pdf" \
-H "Authorization: Bearer $TREVOL_API_KEY" \
-o invoice_pdf.pdfNo todos los documentos tienen todos los archivos: el documento soporte, la nómina y los eventos RADIAN no llevan PDF ni correo (xml, zip y dian_response; los eventos solo xml).
Cuándo están listos
El PDF, el ZIP y el correo al comprador se hacen después del 201, en segundo plano. delivery.status es:
nullsi el documento no estáaccepted;pendingmientras Trevol genera el PDF y el ZIP y manda el correo;completedcuando hay PDF, ZIP y el correo quedó en un estado final (sent,skipped,failed,bouncedocomplained). Unfailedque Trevol todavía va a reintentar cuenta comopending.
Entérate con el evento ….delivered (Webhooks) o consulta el documento. Si pides el PDF o el ZIP antes de que estén, se generan al momento; si el documento todavía no está validado, es file_unavailable (409), y si no se pudieron preparar ahora, un 503 reintentable.