Dataico
ReferenciaActualizado 9 de octubre de 2026

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

Swagger (API Documentation): API DOCS Documentación Técnica de DS

Autenticación

Para la transmisión de DS, la API utiliza el encabezado Auth-token como método de autenticación. Puede ser una llave API 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.

Numeración

Para obtener los datos de autorización de tu numeración o consecutivo de Documento Soporte:

Compras / Documento Soporte > Numeraciones > [Editar]

Si tu resolución de Documento Soporte todavía no aparece en Dataico, puedes traerla de la DIAN con POST https://api.dataico.com/direct/dataico_api/v2/numberings/sync_dian/support-doc. Ver Vincular resoluciones de la DIAN por API.

Crear documento soporte

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/support_docs

Headers

  • Content-type: application/json
  • Auth-token (Cuenta Dataico)

El JSON va dentro del objeto support_doc, y send_dian y send_email van dentro de ese mismo objeto. No hace falta enviar dataico_account_id: la cuenta sale del Auth-token.

Estructura JSON estándar

Cuando generation_type es ACUMULADO_SEMANAL, cada objeto de items debe incluir period_date, la fecha de compra del ítem. Se acepta el formato dd/MM/yyyy o dd/MM/yyyy HH:mm:ss. La DIAN exige esta fecha con la regla DSFC02a.

Si falta en algún ítem o viene con un formato inválido, la solicitud se rechaza antes de transmitirse a la DIAN, con este mensaje:

Cada ítem requiere 'period_date' (fecha de compra) en formato dd/MM/yyyy o dd/MM/yyyy HH:mm:ss cuando 'generation_type' es ACUMULADO_SEMANAL. Si falta o el formato es inválido, la DIAN rechaza el documento con la regla DSFC02a: 'No se informó fecha de compra'.

Esta exigencia aplica solo al Documento Soporte, no a la Nota de Ajuste. Tampoco aplica a las demás formas de generación, donde period_date es opcional.

Ejemplo mínimo del campo dentro de un ítem:

{
  "generation_type": "ACUMULADO_SEMANAL",
  "items": [
    {
      "period_date": "21/02/2019"
    }
  ]
}

Recursos Adicionales

¿Este artículo te fue útil?

Volver a API