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

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/json
  • Auth-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 como DIAN_NO_ENVIADO.
  • Si tu empresa no tiene eventos sobre esa factura, la respuesta es 200 con reception_events como 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

Recursos Adicionales