---
title: Guía de Solución de Problemas - API Factura Electrónica
description: "Tabla de errores comunes al integrar la API de Factura Electrónica de Dataico: mensaje exacto, causa y solución."
---

[Ir directamente al contenido](https://portaldelcliente.dataico.com/es/knowledge/guía-de-solución-de-problemas-api-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. [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)

# Guía de Solución de Problemas - API Factura Electrónica

## Este artículo cubre los errores más comunes al integrar la API de Factura Electrónica de Dataico.

Este artículo cubre los errores más comunes al integrar la API de Factura Electrónica de Dataico.

Para cada error encontrarás el mensaje exacto del response, la causa y la solución. Si necesitas más detalle, cada fila enlaza al artículo completo.

> **Sobre el código HTTP.** Ante un error, lee siempre el arreglo `errors` del response: trae el mensaje y el campo (`path`) que falló. Un error de validación del documento puede llegar con código HTTP 500 sin que sea una caída del servidor. Los errores de autenticación responden **401**.

| Mensaje de error (response) | Causa | Solución rápida | Artículo completo |
| --- | --- | --- | --- |
| `{"errors": "No estás autorizado para usar esta cuenta de DATAICO, por favor revisa los datos de conexión 'Dataico Account Id' y 'Auth Token'."}` (HTTP 401) | El `Auth-token` no corresponde a ningún Auth Token ni llave API vigente: está mal copiado, tiene espacios, está incompleto o fue revocado. | Copiar de nuevo la credencial desde **Opciones \> Configuración** (o crear una llave API) y verificar que no haya espacios al pegarla. | [Error: No estás autorizado](https://portaldelcliente.dataico.com/es/knowledge/error-no-est%C3%A1s-autorizado-a-usar-esta-cuenta-de-dataico?hsLang=es) |
| `{"errors": "Tu API key expiró. Genera una nueva desde la configuración de tu empresa."}` (HTTP 401) | La llave API llegó a su fecha de vencimiento. | Crear una llave nueva en **Opciones \> Configuración**, botón **Llaves API**, y reemplazarla en la integración. | [¿Cómo crear y revocar llaves API?](https://portaldelcliente.dataico.com/es/knowledge/super-llave-api?hsLang=es) |
| `{"errors": [{"error": "Debe enviar un dataico account id válido (debe ser un uuid como a7ec34ae-f30b-40e8-b3a8-93bfc4c37d70)", "path": ["invoice"]}]}` | El `dataico_account_id` del cuerpo está vacío, es booleano, está mal copiado o es de una cuenta distinta a la del `Auth-token`. | Copiar el **Dataico Account Id** de la misma cuenta del `Auth-token` desde **Opciones \> Configuración** y enviarlo como texto. | [Error: Debe enviar un dataico account id válido](https://portaldelcliente.dataico.com/es/knowledge/error-api-response-1?hsLang=es) |
| `"Ciudad 'X' es inválida para el departamento 'Y'."` | La ciudad (`city`) del cliente no pertenece al departamento (`department`) enviado. | Corregir `customer.city` y `customer.department`: ambos por nombre, o ambos por código (municipio de 3 dígitos y departamento de 2). | [Error: Ciudad inválida para el departamento](https://portaldelcliente.dataico.com/es/knowledge/error-api-response?hsLang=es) |
| `"El número para este documento '1' es inválido. Tiene que ser el siguiente número '3' para su numeración"` | La factura se envió con `numbering.flexible` en `false` y el número no es exactamente el siguiente de la numeración. Los números del mensaje van sin prefijo. | Enviar el número que indica el mensaje, o dejar `flexible` en `true` (valor por defecto). | [Error: Números de factura inválidos](https://portaldelcliente.dataico.com/es/knowledge/el-n%C3%BAmero-para-este-documento-994000320-es-inv%C3%A1lido.-tiene-que-ser-el-siguiente-n%C3%BAmero-994000637-para-su-numeraci%C3%B3n?hsLang=es) |
| `"La fecha de pago debe ser igual o posterior a la fecha de emisión cuando payment_means_type es CREDITO"` (antes de septiembre de 2026, el mismo caso llegaba como `{"errors": [{"path": ["invoice"], "error": null}]}`) | En una factura a crédito, la `payment_date` cae en un día calendario anterior al de la `issue_date`. La comparación es por día: una hora distinta dentro del mismo día no produce el error. | Enviar la `payment_date` con la misma fecha de la `issue_date` o con una posterior. | [Error: fecha de pago anterior a la fecha de emisión](https://portaldelcliente.dataico.com/es/knowledge/errorspathinvoiceerrornull?hsLang=es) |
| `"Para una moneda distinta de COP se deben especificar currency_exchange_rate (tasa de cambio) y currency_exchange_rate_date (fecha de tasa de cambio)"` | La factura se emite en una moneda distinta de `COP` y no trae la tasa de cambio, su fecha, o ninguna de las dos. | Agregar `currency_exchange_rate` y `currency_exchange_rate_date` a la factura. | [Error: falta la tasa de cambio en moneda extranjera](https://portaldelcliente.dataico.com/es/knowledge/error-moneda-sin-tasa-de-cambio?hsLang=es) |
| `{"errors":[{"error":"No se encuentra numeración '{\"prefix\" \"FEE\", \"resolution_number\" \"18760000001\"}' en la cuenta de DATAICO","path":["invoice"]}]}` | La cuenta de las credenciales no tiene una numeración con ese prefijo y resolución en el ambiente pedido (`env`). | Verificar en **Ventas \> Facturas \> Numeraciones** el prefijo y la resolución, y que `env` sea `PRUEBAS` para numeraciones de pruebas o `PRODUCCION` para las de producción. | [Error: No se encuentra numeración](https://portaldelcliente.dataico.com/es/knowledge/error-response-errorserrorno-se-encuentra-numeraci%C3%B3n-prefix-fee-resolution_number-18760000001-en-la-cuenta-de-dataicopathinvoice?hsLang=es) |
| `"Solo puede modificar Factura 'FE10' si esta DIAN rechazada."` | Enviaste por `POST` un número que ya existe en Dataico y esa factura no está rechazada por la DIAN. (Si está aceptada, la API devuelve la factura existente; si está rechazada, la reemplaza.) | Usar un número nuevo, o consultar la factura existente con [Consulta de 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). |  |
| `{"errors": [{"path": ["invoice", "charges", 0, "base_amount"], "error": "El campo es requerido"}]}` | El campo `charges` se envió como un objeto y no como un arreglo de objetos, así que la API no encuentra el `base_amount` de cada cargo. | Enviar `charges` como arreglo: `"charges": [{"reason": "PROPINA", "base_amount": 15000, "discount": false}]`. | Ver la sección al final de esta guía |
| `"Numero de documentos a crear '1' excede numero de documentos restantes en el plan."` | Se agotaron los documentos disponibles en el plan de la cuenta. | Revisar el plan en Dataico o escribirnos al chat de soporte para ampliarlo. |  |
| `{"errors": "Su empresa ha sido bloqueada."}` (HTTP 401) | La empresa está bloqueada en Dataico. Si es cliente de un aliado, el bloqueo puede venir de su aliado. | Si la empresa es cliente de un aliado, consulta primero con el aliado. Si no, escríbenos al chat de soporte. |  |
| `"El nombre del tercero es incorrecto."` | El cliente de la factura no trae el nombre que la DIAN exige para su tipo: `company_name` cuando `party_type` es `PERSONA_JURIDICA`, o `first_name` y `family_name` cuando es `PERSONA_NATURAL`. El `party_type` que envías reemplaza el que el cliente tenga guardado, así que un cliente creado como persona natural y enviado como jurídica necesita `company_name`. | Enviar el nombre que corresponde al `party_type` del cliente. La factura rechazada no consume consecutivo. |  |

### **Error "El campo es requerido" en el base\_amount de charges**

Este error aparece cuando el campo `charges` (cargos adicionales, como una propina) se envía como un **objeto** en lugar de un **arreglo de objetos**. La API espera una lista y, al recibir un objeto, marca el `base_amount` como faltante, una vez por cada clave del objeto.

**Estructura con el error:**

```
"charges": {
  "reason": "PROPINA",
  "base_amount": 15000,
  "discount": false
}
```

**Detalle (RESPONSE):**

```
{
  "errors": [
    {"path": ["invoice", "charges", 0, "base_amount"], "error": "El campo es requerido"},
    {"path": ["invoice", "charges", 1, "base_amount"], "error": "El campo es requerido"},
    {"path": ["invoice", "charges", 2, "base_amount"], "error": "El campo es requerido"}
  ]
}
```

**Estructura correcta:**

```
"charges": [
  {
    "reason": "PROPINA",
    "base_amount": 15000,
    "discount": false
  }
]
```

- `reason`: motivo del cargo (por ejemplo, `PROPINA`).
- `base_amount`: monto base del cargo.
- `discount`: `true` o `false`, según si el cargo es un descuento.

Corrige la estructura y reenvía el documento.

**¿El error no aparece en esta tabla?** Consulta la [Documentación Técnica de la API de Dataico](https://app.dataico.com/api-docs) o escríbenos al chat de soporte con el response completo.

- [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