Modelo de Integración API DATAICO

La API de DATAICO proporciona una descripción detallada de los métodos disponibles, incluyendo ejemplos relacionados con cada una de las estructuras de los documentos electrónicos.

Endpoints Disponibles

General

• Autenticación con llaves API (incluida la llave de aliado con x-on-behalf-of): ver ¿Cómo crear y revocar llaves API en Dataico?
• Vincular resoluciones de la DIAN y listar numeraciones: ver Documentación Técnica FE
• Integración con Shopify: ver Manual de Configuración: Integración Shopify

Factura Electrónica (FE)

• Autentificación: ver Documentación Técnica FE
• Numeración: ver Documentación Técnica FE
• Crear factura: ver Documentación Técnica FE
• Consultar factura: ver Consulta de factura por API
• Reenviar factura: ver Reenviar factura electrónica por API
• Crear Nota Crédito: ver Crear Nota Crédito API
• Crear Nota Débito: ver Nota Débito en API
• Nota Débito sin factura de referencia: ver Nota Débito sin factura de referencia
• Consulta tercero DIAN: ver Consulta DIAN Terceros
• Guía de solución de problemas: ver Guía de Solución de Problemas

Factura Electrónica Sector Salud (FE_SS)

• Autentificación: ver Documentación Técnica FE Sector Salud
• Numeración: ver Documentación Técnica FE Sector Salud
• Crear factura: ver Documentación Técnica FE Sector Salud
• Consultar factura: ver Consulta de factura por API
• Reenviar factura: ver Reenviar factura electrónica por API
• Crear Nota Crédito: ver Crear Nota Crédito API (Sector Salud)
• Crear Nota Débito: ver Nota Débito en API (Sector Salud)
• Guía de solución de problemas: ver Guía de Solución de Problemas

Documento Soporte de Pago de Nómina Electrónica (NE)

• Autentificación, Numeración, Tipos de conceptos, Crear nómina, Consultar nómina, Crear nota de reemplazo, Consultar nota de reemplazo, Crear nota de eliminación, Consultar nota de eliminación: ver API DOCS Documentación Técnica de NE
• Guía de solución de problemas: ver Guía de errores de Nómina Electrónica

Documento Soporte en Adquisición (DS)

• Autentificación, Numeración, Crear documento soporte: ver Documentación Técnica DS
• Consultar documento soporte: ver Consultar Documento Soporte por API
• Crear nota de ajuste: ver Crear Nota de Ajuste a DS por API
• Consultar nota de ajuste: ver Consultar Nota de Ajuste por API

Eventos Recepción (EV)

• Autentificación, Numeración, Crear Acuse de recibo, Crear Recibo del bien o prestación del servicio, Crear Aceptación expresa, Crear Reclamo: ver Documentación Técnica EV
• Consultar eventos de recepción: ver Consultar Eventos de Recepción por API

Documento POS Electrónico (POS)

• Autentificación: ver Documentación Técnica POS Electrónico
• Numeración: ver Documentación Técnica POS Electrónico
• Crear documento POS Electrónico: ver Documentación Técnica POS Electrónico
• Consultar documento POS Electrónico: ver Documentación Técnica POS Electrónico
• Anulación (Nota de Ajuste): ver Anulación del Documento Equivalente POS

Límite de solicitudes

Cada token puede hacer hasta 100 solicitudes cada 10 segundos y tiene además un límite de solicitudes en curso al mismo tiempo. Si usas una llave de empresa aliada con x-on-behalf-of, los límites cuentan por cada empresa hija.

Al superar cualquiera de los dos, la API responde con estado 429 y el header Retry-After, con los segundos que debes esperar antes de reintentar. Las solicitudes rechazadas también cuentan dentro de la ventana de 10 segundos, así que reintentar de inmediato no acorta la espera. Para evitarlo, envía las solicitudes en serie o con poca concurrencia y respeta Retry-After.

Recursos Adicionales

• Swagger FE: API DOCS Documentación Técnica de FE
• Swagger NE: API DOCS Documentación Técnica de NE
• Swagger DS / EV / POS: API DOCS