Ciclo de vida del documento

Estados de los documentos de AdapterDian, advertencias de la DIAN, descargas en PDF, XML y ZIP, reenvío por correo y descarte de documentos sin validar.

La emisión es asíncrona. El POST responde 202 Accepted con un transaction_id y "status": "pending", y el documento sigue su curso por su cuenta. El mismo ciclo aplica a todos los tipos: factura de venta, notas crédito y débito, documento soporte, nota de ajuste y nómina.

Estados

GET /invoices/v1/sales-invoices/{id} (y su equivalente para cada tipo) devuelve status, document_number, cufe, correlation_id, created_at y warnings.

`status`	Significado
`pending`	Aceptado y encolado.
`sent`	Enviado al proveedor tecnológico.
`validated`	La DIAN lo validó. Tiene número y CUFE.
`rejected`	La DIAN no lo validó.
`failed`	No se pudo procesar.
`cancelled`	Declarado en el contrato.

Un documento validado puede traer advertencias

warnings son notificaciones de la autoridad tributaria. No implican rechazo, pero señalan datos maestros (cliente, productos) que conviene revisar. Se conservan incluso cuando el documento se validó.

Listado

GET /invoices/v1/sales-invoices lista lo que tu tenant ha emitido, lo más reciente primero. Filtros: status, number (número DIAN exacto), issued_from, issued_to, page y per_page (25 por defecto, tope 100). La respuesta trae total, los documentos que cumplen el filtro.

Los documentos emitidos fuera de AdapterDian no aparecen: el listado sale de la base del adaptador para que ningún tenant vea los documentos de otro.

Descargas

Disponibles cuando el documento ya tiene número DIAN. Antes de eso responde 409 nombrando el estado actual.

GET /invoices/v1/sales-invoices/{id}/{format}

curl -OJ https://adapterdian.piensait.com/functions/v1/invoices/v1/sales-invoices/$TRANSACTION_ID/pdf \
  -H "Authorization: Bearer $ADAPTERDIAN_API_KEY"

`format`	Contenido
`pdf`, `xml`	El documento.
`attached-xml`	Incluye la respuesta de la autoridad tributaria.
`zip`	El paquete que iría por correo. Trae además `X-Email-Subject`, percent-encoded.

Reenvío por correo

POST /invoices/v1/sales-invoices/{id}/email con { "email": "…" } envía el documento con su representación gráfica. El destinatario es obligatorio y no se deduce del cliente del documento. Exige invoices:write.

Descarte

DELETE /invoices/v1/sales-invoices/{id} solo funciona con documentos que la DIAN no ha validado: es la salida para un documento pendiente que necesitas volver a crear corregido. Un documento validado responde 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.

Eventos RADIAN sobre tus facturas

GET /invoices/v1/sales-invoices/{id}/events muestra cómo respondió tu cliente a una factura que emitiste: acuse, reclamo o si dejó vencer el plazo de tres días hábiles. Solo existe para facturas de venta.