Documentación Técnica de la API de Dataico: Eventos de Recepción (EV)

Swagger (API Documentation): API DOCS Documentación Técnica de EV

Autenticación

Para la transmisión de eventos de recepción, la API emplea el encabezado Auth-token como método de autenticación. Puede ser una llave API o el Auth Token de la cuenta: en la interfaz de Dataico, haz clic en las opciones en la parte superior y selecciona Configuración. No hace falta enviar dataico_account_id: la cuenta sale del Auth-token.

Numeración

Para obtener los datos de tu numeración o consecutivo de eventos de recepción:

Compras / Eventos Recepción > Numeraciones [Editar configuraciones para eventos de recepción]

Si tu cuenta todavía no tiene numeración de eventos, la API la crea al primer envío.

Crear evento de recepción

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/reception_events

Headers

Content-type: application/json
Auth-token (Cuenta Dataico)

Envío a la DIAN y correo

Los campos send_dian y send_email del JSON se suman a la configuración de eventos de recepción de tu cuenta: si allí tienes activado el envío automático a la DIAN o por correo, el evento se envía aunque el JSON diga false. Para que un evento no se envíe, el JSON debe ir en false y el envío automático debe estar desactivado en la configuración.

Estructura JSON estándar

Consultar eventos de recepción

Método: GET

Endpoint: https://api.dataico.com/direct/dataico_api/v2/reception_events

Envía exactamente uno de estos dos parámetros:

number: el número del evento, con su prefijo (por ejemplo, EV60). Devuelve ese evento con su detalle completo.
document_cufe: el CUFE de una factura recibida. Devuelve en reception_events los eventos que tu empresa emitió en Dataico sobre esa factura, sin la aceptación tácita.

Las respuestas de cada caso y los mensajes de error están en Consultar Eventos de Recepción por API.

Recursos Adicionales

Consultar evento de recepción por API