Consulta de Factura por API
Este artículo detalla cómo consultar facturas electrónicas por consecutivo utilizando la API de Dataico. Sigue los pasos a continuación para realizar la consulta correctamente.
Referencia técnica para consultar facturas electrónicas por consecutivo.
Consultar Factura
Método: GET
Endpoint: https://api.dataico.com/direct/dataico_api/v2/invoices
Parámetros (Params):
| Parámetro | Descripción | Ejemplo |
|---|---|---|
number |
Consecutivo de la factura | FE18 |
Headers:
Content-Type: application/jsonAuth-token: <tu llave API o el Auth Token de la cuenta>
Configuración en Postman
Configura la solicitud con el método GET, agrega el parámetro number en Params y el Auth-token en Headers.
La respuesta trae la factura dentro del objeto invoice. Si no existe una factura con ese consecutivo, la API responde No se encuentra documento con este numero.
Qué trae la respuesta: estado, PDF y XML
La consulta devuelve los mismos campos que la creación de la factura:
| Campo | Para qué sirve |
|---|---|
dian_status |
Estado ante la DIAN: DIAN_ACEPTADO, DIAN_RECHAZADO, DIAN_NO_ENVIADO o DIAN_PENDIENTE |
pdf_url |
Enlace para descargar el PDF de la factura |
xml_url |
Enlace para descargar el XML |
xml |
El XML en base64 si la factura está aceptada; si no, la respuesta de la DIAN con el motivo |
cufe, qrcode |
Para construir tu propia representación gráfica |
email_status |
Estado del correo al cliente |
dian_send_error_code |
Solo si el envío no se completó: el motivo, en un mensaje |
No necesitas guardar pdf_url ni xml_url al crear la factura: cada consulta los trae de nuevo.
Dataico no avisa por webhook cuando cambia el estado de una factura. Para saber si una factura quedó aceptada, consúltala con este endpoint. Si quedó en DIAN_NO_ENVIADO, reenvíala con Reenviar factura por API.
Consultar Factura por uuid
Si guardaste el uuid que devolvió la API al crear la factura, también puedes consultarla así:
Método: GET
Endpoint: https://api.dataico.com/direct/dataico_api/v2/invoices/{uuid}