---
title: "Documentación Técnica de la API de Dataico: Eventos de Recepción (EV)"
description: "Guía técnica para crear y consultar Eventos de Recepción mediante la API v2 de Dataico: tipos de evento y sus códigos (acuse, reclamo con claim_reason…"
---

[Ir directamente al contenido](https://portaldelcliente.dataico.com/es/knowledge/documentación-técnica-de-la-api-de-dataico-eventos-de-recepción#main-content)

Español

Traducciones de Mostrar submenú de

![facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png\]](https://portaldelcliente.dataico.com/hs-fs/hubfs/social-suggested-images/facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png?height=40&name=facturaelectronica.dataico.comhs-fshubfslogoDataico2-1.png)

Abrir navegación principal

Cerrar navegación principal

- Español
  
  Traducciones de Mostrar submenú de
- <https://www.dataico.com/>

<https://www.dataico.com/>

 ¿Cómo podemos ayudarte?

- No hay sugerencias porque el campo de búsqueda está vacío.

1. [Centro de Ayuda](https://portaldelcliente.dataico.com/es/knowledge?hsLang=es)
2. [Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es)
3. [Eventos de Recepción (EV)](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#eventos-de-recepci%C3%B3n-ev)

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

## Guía Práctica

**Swagger (API Documentation):** [API DOCS Documentación Técnica de EV](https://app.dataico.com/api-docs?_rp_=WyJeICJd&_gl=1*67zun2*_gcl_au*MTczMTE5MTAyNC4xNzEzMjA3NDM1*_ga*MTUxODQxNTY1Ny4xNzA1MzIxMTEw*_ga_LDHDBY31MN*MTcxODQ1ODcwOC4xMDEuMS4xNzE4NDYxNzQyLjMwLjAuMA..)

---

### **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](https://portaldelcliente.dataico.com/es/knowledge/super-llave-api?hsLang=es) 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**

El ejemplo de la petición, con cada campo, está en la [documentación técnica de la API](https://app.dataico.com/api-docs).

#### **Tipos de evento (`event_type`)**

| `event_type` | Código DIAN | Qué es |
| --- | --- | --- |
| `ACUSE_DE_RECIBO` | 030 | Acuse de recibo de la factura |
| `RECLAMO` | 031 | Rechazo (reclamo) de la factura. Exige `claim_reason` |
| `RECIBO_DE_PRESTACION` | 032 | Recibo del bien o de la prestación del servicio |
| `ACEPTACION_EXPRESA` | 033 | Aceptación expresa |
| `ACEPTACION_TACITA` | 034 | Aceptación tácita: la emite el vendedor sobre su propia factura cuando el comprador no se pronunció a tiempo |

`claim_reason` en un `RECLAMO` acepta `DOCUMENTO_INCONSISTENCIAS`, `MERCANCIA_NO_ENTREGADA_TOTALMENTE`, `MERCANCIA_NO_ENTREGADA_PARCIALMENTE` y `SERVICIO_NO_PRESTADO`. Sin él, la respuesta es `Campo "claim_reason" es mandatorio para un evento de reclamo`.

#### **Quién va en `person` y quién en `receiver`**

| Objeto | Quién es | Notas |
| --- | --- | --- |
| `person` | La persona de tu empresa que hace el evento | `first_name` es obligatorio siempre. Si es una persona jurídica, va la razón social en `first_name` |
| `receiver` | El **vendedor**, quien emitió la factura | Se guarda como proveedor en tu cuenta. La dirección va en el mismo nivel de `receiver`, como el `customer` de la factura. En la aceptación tácita, que emites tú sobre tu propia factura, `receiver` es tu cliente (el comprador), y por eso no tiene que ser un proveedor |

Ejemplo de acuse de recibo:

```
{
  "reception_event": {
    "event_type": "ACUSE_DE_RECIBO",
    "document_cufe": "<CUFE de la factura recibida>",
    "issue_date": "12/11/2026",
    "person": {
      "party_identification_type": "CC",
      "party_identification": "1000000000",
      "first_name": "Ana",
      "family_name": "Pérez"
    },
    "receiver": {
      "party_identification_type": "NIT",
      "party_identification": "900000000",
      "party_type": "PERSONA_JURIDICA",
      "company_name": "PROVEEDOR S.A.S.",
      "regimen": "ORDINARIO",
      "tax_level_code": "RESPONSABLE_DE_IVA",
      "department": "11",
      "city": "001",
      "address_line": "Calle 1 # 2-3",
      "country_code": "CO"
    }
  }
}
```

**Datos de la factura.** Con el `document_cufe`, Dataico consulta la factura en la DIAN y toma de ahí el tipo, el número y la fecha del documento: los `document_type`, `document_number` y `document_issue_date` que envíes se reemplazan. Envíalos igual: si la DIAN no autoriza la consulta, se usan los del JSON.

### **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](https://portaldelcliente.dataico.com/es/knowledge/consultar-eventos-de-recepci%C3%B3n-por-api?hsLang=es).

### **Recursos Adicionales**

- [Consultar evento de recepción por API](https://portaldelcliente.dataico.com/es/knowledge/consultar-eventos-de-recepci%C3%B3n-por-api?hsLang=es)

- [Módulo de Terceros](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-terceros?hsLang=es#main-content)

    - [Conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-terceros?hsLang=es#conceptos)
- [Módulo de Ventas](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#main-content)

    - [Onboarding Facturación](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#onboarding-facturaci%C3%B3n)
    - [Generales](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#generales)
    - [Facturas](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#facturas)
    - [Cotizaciones](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#cotizaciones)
    - [Notas crédito](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-cr%C3%A9dito)
    - [Notas débito](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-d%C3%A9bito)
    - [Facturación electrónica](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#facturaci%C3%B3n-electr%C3%B3nica)
    - [Onboarding POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#onboarding-pos-electr%C3%B3nico)
    - [Generalidades de Documento Equivalente POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#generalidades-de-documento-equivalente-pos-electr%C3%B3nico)
    - [Notas de Ajuste POS Electrónico](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-ventas?hsLang=es#notas-de-ajuste-pos-electr%C3%B3nico)
- [Módulo de Contabilidad](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#main-content)

    - [Onboarding y conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#onboarding-y-conceptos)
    - [Configuración del módulo contable](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#configuraci%C3%B3n-del-m%C3%B3dulo-contable)
    - [Reglas y automatización](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#reglas-y-automatizaci%C3%B3n)
    - [Asientos y comprobantes](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#asientos-y-comprobantes)
    - [Reportes financieros](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#reportes-financieros)
    - [Certificados y exógena](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-contabilidad?hsLang=es#certificados-y-ex%C3%B3gena)
- [Módulo de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#main-content)

    - [Onboarding y conceptos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#onboarding-y-conceptos)
    - [Configuración de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#configuraci%C3%B3n-de-n%C3%B3mina)
    - [Empleados, contratos y terminaciones](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#empleados-contratos-y-terminaciones)
    - [Novedades y horas extras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#novedades-y-horas-extras)
    - [Liquidación de Nómina](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#liquidaci%C3%B3n-de-n%C3%B3mina)
    - [Prestaciones Sociales](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#prestaciones-sociales)
    - [Colillas de Pago](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#colillas-de-pago)
    - [Nómina Electrónica](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-n%C3%B3mina?hsLang=es#n%C3%B3mina-electr%C3%B3nica)
- [Módulo de Compras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#main-content)

    - [Compras](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#compras)
    - [Documento Soporte](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#documento-soporte)
    - [Habilitar Documento Soporte](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#habilitar-documento-soporte)
    - [Eventos de Recepción](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#eventos-de-recepci%C3%B3n)
    - [Errores, notificaciones y rechazos de Eventos de Recepción](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#errores-notificaciones-y-rechazos-de-eventos-de-recepci%C3%B3n)
    - [Facturas Electrónicas de Compra](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-compras?hsLang=es#facturas-electr%C3%B3nicas-de-compra)
- [Módulo de Cartera](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#main-content)

    - [Onboarding](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#onboarding)
    - [Cuentas por Cobrar y cuentas por Pagar](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#cuentas-por-cobrar-y-cuentas-por-pagar)
    - [Bancos.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#bancos)
    - [Configuración Módulo de Cartera](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-cartera?hsLang=es#configuraci%C3%B3n-m%C3%B3dulo-de-cartera)
- [Módulo de Productos e Inventarios](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#main-content)

    - [Productos](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#productos)
    - [Inventarios.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#inventarios)
    - [Ajuste de inventarios.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#ajuste-de-inventarios)
    - [Productos de compra.](https://portaldelcliente.dataico.com/es/knowledge/m%C3%B3dulo-de-productos-e-inventarios?hsLang=es#productos-de-compra)
- [Suscripciones](https://portaldelcliente.dataico.com/es/knowledge/suscripciones?hsLang=es)
- [Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#main-content)

    - [Modelo de Integración API DATAICO S.A.S](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#modelo-de-integraci%C3%B3n-api-dataico-s-a-s)
    - [Factura Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#factura-electr%C3%B3nica)
    - [Guía de Solución de Problemas API DATAICO FE](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#gu%C3%ADa-de-soluci%C3%B3n-de-problemas-api-dataico-fe)
    - [Nómina Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#n%C3%B3mina-electr%C3%B3nica)
    - [Documento Soporte (DS)](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#documento-soporte-ds)
    - [Eventos de Recepción (EV)](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#eventos-de-recepci%C3%B3n-ev)
    - [Sector Salud](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#sector-salud)
    - [POS ELECTRÓNICO](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#pos-electr%C3%B3nico)
- [Importaciones](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#main-content)

    - [General](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#general)
    - [Contabilidad](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#contabilidad)
    - [Productos](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#productos)
    - [Terceros](https://portaldelcliente.dataico.com/es/knowledge/importaciones?hsLang=es#terceros)
- [Preguntas frecuentes (FAQ)](https://portaldelcliente.dataico.com/es/knowledge/preguntas-frecuentes-faq?hsLang=es)
- [Anexos Técnicos y Resoluciones](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#main-content)

    - [Resolución 000119 de 2024.](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#resoluci%C3%B3n-000119-de-2024)
    - [Anexo 1.9](https://portaldelcliente.dataico.com/es/knowledge/anexos-t%C3%A9cnicos-y-resoluciones?hsLang=es#anexo-1-9)
- [Recursos adicionales](https://portaldelcliente.dataico.com/es/knowledge/recursos-adicionales?hsLang=es)
- [Shopify](https://portaldelcliente.dataico.com/es/knowledge/shopify?hsLang=es)

[![Chill listening crop-3](https://portaldelcliente.dataico.com/hs-fs/hubfs/Lod%20DT.png?width=110&height=32&name=Lod%20DT.png "Chill listening crop-3")](https://www.dataico.com/)

Copyright © 2026, DATAICO S.A.S