---
title: Documentación Técnica de la API de Dataico - Factura Electrónica
description: "Referencia técnica para crear facturas electrónicas vía API: autenticación, numeración, ambiente (env), numeración flexible, endpoint POST, vincular…"
---

[Ir directamente al contenido](https://portaldelcliente.dataico.com/es/knowledge/documentación-técnica-de-la-api-de-dataico-factura-electrónica#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. [Factura Electrónica.](https://portaldelcliente.dataico.com/es/knowledge/integraci%C3%B3n-api-dataico-s-a-s?hsLang=es#factura-electr%C3%B3nica)

# Documentación Técnica de la API de Dataico - Factura Electrónica

Referencia completa: [API DOCS Documentación Técnica de FE](https://app.dataico.com/api-docs)

### **Autenticación**

Cada petición lleva el encabezado `Auth-token`. Ahí puedes enviar cualquiera de estas dos credenciales:

- Una **llave API** creada por tu empresa en **Opciones \> Configuración**, botón **Llaves API**. Es la opción recomendada para integraciones nuevas. Ver [¿Cómo crear y revocar llaves API en Dataico?](https://portaldelcliente.dataico.com/es/knowledge/super-llave-api?hsLang=es).
- El **Auth Token** de la cuenta, que aparece en **Opciones (parte superior) \> Configuración**.

Además, el cuerpo de la factura debe traer el campo `dataico_account_id` con el **Dataico Account Id** de la cuenta, que también aparece en **Opciones \> Configuración**. Debe ser exactamente la cuenta a la que pertenece la credencial del `Auth-token` (o la empresa hija, si eres aliado y usas el encabezado `x-on-behalf-of`). Si no coincide, la API responde `Debe enviar un dataico account id válido (debe ser un uuid como a7ec34ae-f30b-40e8-b3a8-93bfc4c37d70)`.

### **Numeración**

Para obtener los datos de autorización de tu numeración o consecutivo de facturación electrónica:

**Ventas \> Facturas \> Numeraciones \> \[Editar\]**

En la pantalla de edición de la numeración encontrarás el prefijo, número de resolución y el consecutivo actual.

Si tu resolución todavía no aparece en Dataico, puedes traerla de la DIAN por API (ver Vincular resoluciones de la DIAN por API).

### **Ambiente (`env`) y numeración flexible**

Dos campos de la factura deciden cómo se procesa:

- **`env`** lleva `PRUEBAS` o `PRODUCCION`. Con `PRUEBAS` la API solo busca las numeraciones de pruebas de la habilitación ante la DIAN (resolución `18760000001`); con `PRODUCCION`, solo las de producción. Escríbelo con cuidado: **cualquier valor distinto de `PRODUCCION`, o no enviarlo, se trata como pruebas** sin dar error, y la API responde que no encuentra la numeración.
- **`numbering.flexible`** define qué tan estricto es el consecutivo. Por defecto es `true`: basta con que el número esté dentro del rango de la resolución y no exista todavía. Con `false`, el número debe ser exactamente el siguiente de la numeración.

### **Crear Factura Electrónica**

**Método:** POST

**Endpoint:** `https://api.dataico.com/direct/dataico_api/v2/invoices`

**Headers:**

- `Content-Type: application/json`
- `Auth-token: <tu llave API o el Auth Token de la cuenta>`

#### **Recibos Referencia (`receipt_documents`)**

Si tu cliente lleva su propio control de recepción de mercancía (un albarán, un DAFI, una guía de remisión), puedes enviar esos identificadores en la solicitud de creación con el campo opcional `receipt_documents`, un arreglo de textos:

```
"receipt_documents": ["ALB-4471", "DAFI-9930"]
```

- Puedes enviar tantos como necesites, y repetir el mismo identificador.
- Si no envías el campo, el documento se crea sin referencias.
- Cada entrada viaja al **XML de la DIAN** y aparece en el **PDF**, en el bloque de datos junto a la Orden de Compra.

Es el mismo campo **Recibos Referencia** que se llena desde la interfaz de Dataico. Ver [¿Cómo agregar Recibos Referencia a una factura o nota?](https://portaldelcliente.dataico.com/es/knowledge/recibos-referencia-en-documentos-de-venta?hsLang=es).

#### **Ejemplo JSON**

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).

### **Vincular resoluciones de la DIAN por API**

Este endpoint consulta en la DIAN las resoluciones autorizadas al software de facturación de tu empresa y las crea o asocia como numeraciones en Dataico. Sirve, por ejemplo, cuando acabas de solicitar una resolución nueva y quieres usarla desde tu integración sin entrar a la interfaz.

**Método:** POST

**Endpoint:** `https://api.dataico.com/direct/dataico_api/v2/numberings/sync_dian/invoice`

Para resoluciones de Documento Soporte, usa `support-doc` en lugar de `invoice`: `https://api.dataico.com/direct/dataico_api/v2/numberings/sync_dian/support-doc`

**Headers:**

- `Content-Type: application/json`
- `Auth-token: <tu llave API o el Auth Token de la cuenta>`

No necesita cuerpo.

**Respuesta de ejemplo:**

```
{
  "numberings": [
    {
      "prefix": "<prefijo>",
      "dian_resolutions": [
        {
          "number": "<número de resolución>",
          "start": 1,
          "end": 1000,
          "technical_key": "<clave técnica>",
          "start_date": "<dd/MM/yyyy>",
          "end_date": "<dd/MM/yyyy>",
          "code": "SDJ-001",
          "code_msg": "<mensaje>"
        }
      ]
    }
  ]
}
```

Cada resolución trae un `code`: `SDJ-001` si se acaba de agregar a tu cuenta y `SDJ-002` si ya existía. Usa `code` para saberlo, no el texto de `code_msg`, que puede no corresponder al caso. La respuesta trae además `errors`: si todo salió bien es `[{"message": null}]`, y un texto en `message` es el error (por ejemplo, cuando la DIAN no autoriza la consulta); en ese caso `numberings` trae las numeraciones que ya tenías. Si usas otro valor en lugar de `invoice` o `support-doc`, la API responde con un error que te indica los dos módulos válidos.

#### **Listar tus numeraciones**

Para ver las numeraciones que ya tiene la cuenta:

**Método:** GET

**Endpoint:** `https://api.dataico.com/direct/dataico_api/v2/numberings/{modulo}`

Donde `{modulo}` es `invoice`, `credit-note`, `debit-note` o `support-doc`. La respuesta tiene la misma forma que la de vincular resoluciones.

### **Recursos Adicionales**

- [Ciudades y departamentos: la Lista Departamentos del DANE](https://portaldelcliente.dataico.com/es/knowledge/como-importar-terceros-con-una-plantilla?hsLang=es), con nombres, en **Importación \> Terceros \> Descarga de Referencias**
- [Unidades de medida: código y descripción](https://portaldelcliente.dataico.com/es/knowledge/unidad-de-medida?hsLang=es), en el campo **Unidad de medida** del producto
- [Código países](https://www.dian.gov.co/atencionciudadano/formulariosinstructivos/Formularios/2012/paises_2012.pdf)
- [Guía de Solución de Problemas API DATAICO FE](https://portaldelcliente.dataico.com/es/knowledge/gu%C3%ADa-de-soluci%C3%B3n-de-problemas-api-dataico-factura-electr%C3%B3nica?hsLang=es)
- [Consultar factura por API](https://portaldelcliente.dataico.com/es/knowledge/documentaci%C3%B3n-t%C3%A9cnica-de-la-api-de-dataico-factura-electr%C3%B3nica-1?hsLang=es)
- [Reenviar factura por API](https://portaldelcliente.dataico.com/es/knowledge/reenviar-a-la-dian-una-factura-existente-de-la-cuenta-dataico-con-el-estado-dian_no_enviado?hsLang=es)
- [Crear Nota Crédito](https://portaldelcliente.dataico.com/es/knowledge/crear-nota-cr%C3%A9dito?hsLang=es)
- [Crear Nota Débito](https://portaldelcliente.dataico.com/es/knowledge/crear-nota-d%C3%A9bito?hsLang=es)
- [¿Cómo crear y revocar llaves API en Dataico?](https://portaldelcliente.dataico.com/es/knowledge/super-llave-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