Consultar Eventos de Recepción por API
Documentación Técnica de la API de DATAICO Eventos de Recepción
Consultar eventos de recepción por número o por CUFE
Método: GET
Endpoint: https://api.dataico.com/direct/dataico_api/v2/reception_events
Params
Envía exactamente uno de estos dos parámetros:
| Parámetro | Valor de ejemplo | Qué devuelve |
|---|---|---|
number |
EV60 |
Un evento, con su detalle completo, dentro de reception_event |
document_cufe |
El CUFE de una factura recibida | La lista de eventos que tu empresa emitió sobre esa factura, dentro de reception_events |
El valor de number incluye el prefijo de la numeración de eventos (por ejemplo, EV60).
Headers
Content-type: application/jsonAuth-token(Cuenta Dataico)
Qué trae la lista por CUFE
Cada elemento de reception_events trae number, event_type, issue_date, cude, dian_status y email_status. Los eventos de tipo RECLAMO traen además claim_reason.
{
"reception_events": [
{
"number": "EV38",
"event_type": "ACUSE_DE_RECIBO",
"issue_date": "03/11/2026 10:15:02",
"cude": "f1c2...",
"dian_status": "DIAN_ACEPTADO",
"email_status": "CORREO_ENVIADO"
}
]
}
Los eventos salen en este orden:
| Código DIAN | event_type |
Evento |
|---|---|---|
| 030 | ACUSE_DE_RECIBO |
Acuse de recibo de la factura |
| 032 | RECIBO_DE_PRESTACION |
Recibo del bien o prestación del servicio |
| 033 | ACEPTACION_EXPRESA |
Aceptación expresa |
| 031 | RECLAMO |
Reclamo de la factura |
- La lista no incluye la aceptación tácita (034): ese evento lo emite el vendedor sobre su propia factura.
- Solo aparecen los eventos que tu empresa emitió en Dataico. Un evento emitido con otro proveedor no aparece.
- Incluye los eventos que todavía no se enviaron a la DIAN. Revisa
dian_status: un evento sin enviar llega comoDIAN_NO_ENVIADO. - Si tu empresa no tiene eventos sobre esa factura, la respuesta es
200conreception_eventscomo una lista vacía. No es un error.
dian_status puede ser DIAN_NO_ENVIADO, DIAN_PENDIENTE, DIAN_CONFLICTO, DIAN_ACEPTADO o DIAN_RECHAZADO. email_status puede ser CORREO_NO_ENVIADO, CORREO_PENDIENTE, CORREO_ENVIADO, CORREO_RECIBIDO, CORREO_ABIERTO, CORREO_FALLO, CORREO_REBOTADO, CORREO_SPAM o CORREO_DESCARTADO.
Qué trae la consulta por número
La consulta por number es la que devuelve los archivos del evento. Para obtener el PDF o el XML de un evento de la lista, consulta con su number: GET /reception_events?number=EV38.
Dentro de reception_event llegan number, issue_date, numbering (con el prefix), uuid, cude, dian_status, email_status, pdf_url, xml_url y xml, que es la respuesta de la DIAN codificada en base64. Con un evento de producción que ya tiene respuesta de la DIAN, aceptado o rechazado, llegan también validation_date y, si la DIAN dejó mensajes, dian_messages. Esta respuesta no trae event_type.
Respuestas de error
Los errores llegan dentro de errors, cada uno con su error y su path, que es una lista:
{
"errors": [
{
"error": "Debe enviar el parámetro 'number' o 'document_cufe'",
"path": ["reception_event"]
}
]
}
| Código HTTP | Mensaje | Cuándo |
|---|---|---|
400 |
Envíe solo uno de los parámetros 'number' o 'document_cufe' |
La petición trae los dos parámetros |
400 |
Debe enviar el parámetro 'number' o 'document_cufe' |
La petición no trae ninguno |
400 |
El parámetro 'document_cufe' no tiene un formato de CUFE válido |
El valor tiene caracteres distintos de letras y números. El path es ["document_cufe"] |
404 |
No se encuentra evento de recepcion con el numero 'EV38' |
No existe un evento con ese número |