API

¿Cómo crear y revocar llaves API en Dataico?

Pasos para crear una llave API desde Dataico, guardarla en el momento en que se muestra, revocarla cuando ya no se usa, y cómo un aliado opera sobre sus empresas hijas con una sola llave.

Consultar Documento Soporte por API

Endpoint GET para consultar un Documento Soporte por consecutivo mediante la API v2 de Dataico.

Consultar Nota de Ajuste por API

Endpoint GET para consultar una nota de ajuste a DS por consecutivo mediante la API v2 de Dataico.

Crear Nota de Ajuste a DS por API

Endpoint POST para crear una nota de ajuste a un Documento Soporte mediante la API v2 de Dataico.

Documentación Técnica de la API de Dataico: Documento Soporte (DS)

Guía técnica para crear Documentos Soporte en Adquisición mediante la API v2 de Dataico.

Consultar Eventos de Recepción por API

Endpoint GET de la API v2 de Dataico para consultar un Evento de Recepción por su número, o todos los que la empresa emitió sobre una factura recibida por su CUFE.

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

Guía técnica para crear y consultar Eventos de Recepción mediante la API v2 de Dataico.

Consulta de Factura por API

Endpoints GET para consultar facturas electrónicas por consecutivo o por uuid usando la API de Dataico.

Consulta DIAN Terceros por API

Endpoint GET para consultar en la DIAN los datos de un tercero (empresa con NIT o persona con cédula) usando la API de Dataico: parámetros, respuesta y errores.

Crear Nota Crédito por API

Endpoint POST para crear Notas Crédito a facturas electrónicas usando la API de Dataico.

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

Referencia técnica para crear facturas electrónicas vía API: autenticación, numeración, ambiente (env), numeración flexible, endpoint POST, vincular resoluciones de la DIAN y estructuras JSON disponibles.

Error API: Debe enviar un dataico account id válido

Causas y solución para el error 'Debe enviar un dataico account id válido', que aparece cuando dataico_account_id está vacío, es booleano, está mal copiado o es de una cuenta distinta a la del Auth-token. Antes este caso podía llegar como 'No implementation of method :db ... java.lang.Boolean'.

Error API: Ciudad inválida para el departamento

Causa y solución para el error 'Ciudad X es inválida para el departamento Y' en la dirección del cliente de una factura por API.

Error API: falta la tasa de cambio en una factura en moneda extranjera

Causa y solución del error que devuelve la API cuando se factura en una moneda distinta de COP sin enviar la tasa de cambio y su fecha.

Error API: No estás autorizado para usar esta cuenta de DATAICO

Causas y solución para el error de autenticación 'No estás autorizado para usar esta cuenta de DATAICO', que aparece cuando el Auth-token no corresponde a ninguna credencial vigente.

Error API: Números de Factura Inválidos

Causas y solución para el error de consecutivo de factura fuera de secuencia, que aparece cuando la factura se envía con numeración no flexible (numbering.flexible en false).

Error API: No se encuentra numeración en la cuenta de DATAICO

Causas y solución para el error cuando la cuenta no tiene una numeración con el prefijo y la resolución del JSON en el ambiente pedido (env PRUEBAS o PRODUCCION).

Error API: la fecha de pago es anterior a la fecha de emisión

Causa y solución del error de fecha de pago anterior a la fecha de emisión en facturas a crédito, que antes de septiembre de 2026 llegaba como error null.

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

Tabla de errores comunes al integrar la API de Factura Electrónica de Dataico: mensaje exacto, causa y solución.

Nota Débito sin factura de referencia (API)

Cómo emitir por API una Nota Débito autónoma (sin factura de referencia) con sin_factura_referenciada: campos obligatorios, errores posibles y qué cambia en el documento (CustomizationID 32, sin BillingReference, con InvoicePeriod, sin celda del CUFE en el PDF).

Nota Débito por API

Endpoint POST para crear Notas Débito a facturas electrónicas usando la API de Dataico.

Reenviar Factura Electrónica por API

Endpoint PUT para reenviar a la DIAN una factura existente con estado DIAN_NO_ENVIADO, y para enviar la factura al cliente con representación gráfica personalizada o con adjuntos.

Modelo de Integración API DATAICO

Índice de todos los endpoints disponibles en la API de DATAICO por tipo de documento electrónico.

Consultar Nómina por API

Endpoint GET para consultar una nómina electrónica por prefijo y número mediante la API v2 de Dataico: parámetros, campos de la respuesta y error 404.

Consultar Nota de Eliminación por API

Endpoint GET para consultar una nota de eliminación de nómina electrónica por prefijo y número mediante la API v2 de Dataico: parámetros, campos de la respuesta y error 404.

Consultar Nota de Reemplazo por API

Endpoint GET para consultar una nota de reemplazo de nómina electrónica por prefijo y número mediante la API v2 de Dataico: parámetros, campos de la respuesta y error 404.

Crear Nota de Eliminación por API

Endpoints POST para crear notas de eliminación de nómina electrónica de forma individual y por lotes mediante la API v2 de Dataico, con un ejemplo JSON y la numeración que exige producción.

Crear Notas de Reemplazo por API

Endpoints POST para crear notas de reemplazo de nómina electrónica de forma individual y por lotes mediante la API v2 de Dataico, con la referencia al documento original y las validaciones de numeración y empleado.

Documentación Técnica de la API de Dataico: Nómina Electrónica

Guía técnica para crear nómina electrónica individual y por lotes mediante la API v2 de Dataico: autenticación, software, ambiente, restricción por modelo de empleado, conceptos con sus campos obligatorios y recomendaciones de transmisión.

Envío en bloque de nómina electrónica: respuesta asíncrona con job-id

Referencia del flujo asíncrono de los endpoints en bloque de nómina electrónica (API v2): el 201 con job-id, cómo consultar el estado en /job-status, cómo obtener el resultado en /batch-result y cómo leer los documentos que fallaron.

Guía de errores de la API de Nómina Electrónica

Referencia de errores comunes al integrar la API v2 de Nómina Electrónica de Dataico, con el mensaje exacto, la causa y la solución: autenticación, software, campos y días de los devengados, porcentajes, numeraciones, lotes, cupo del plan y modelo de empleado con fecha de vigencia.

API: Anulación del Documento Equivalente Electrónico POS

Proceso de dos pasos para anular documentos POS Electrónico emitiendo una Nota de Ajuste Electrónica vía API.

Documentación Técnica de la API de DATAICO POS Electrónico

Referencia técnica para crear y consultar documentos POS Electrónico vía API: autenticación, numeración, endpoints POST y GET, formato de las claves del JSON y estructura de ejemplo.

Crear Nota Crédito por API (Sector Salud)

Endpoint POST para crear Notas Crédito a facturas electrónicas del sector salud usando la API de Dataico.

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

Referencia técnica para crear facturas electrónicas del sector salud vía API: autenticación, numeración, endpoint POST, versión API_SALUD_V2 y sus reglas de contrato, póliza y cobertura, y estructuras JSON por tipo de operación.

Modalidad de Pago en Facturas con Operación del Sector Salud

Valores válidos del campo payment_modality para facturas electrónicas del sector salud, con base normativa en la Resolución 948 de 2026 del Ministerio de Salud.

Nota Débito por API (Sector Salud)

Endpoint POST para crear Notas Débito a facturas electrónicas del sector salud usando la API de Dataico.

Manual de Configuración: Integración Shopify - Dataico

Guía paso a paso para configurar el webhook de Shopify y conectarlo con Dataico para la generación automática de facturas electrónicas.