Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

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/json
  • Auth-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}

Recursos Adicionales