Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

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

Guía Práctica

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

El ejemplo de la petición, con cada campo, está en la documentación técnica de la API. 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"
    }
  ]
}

Proveedor residente o no residente

resident_type dice si el proveedor reside en Colombia. Si no se envía, vale RESIDENTE. El tipo de identificación del proveedor (party_identification_type en customer) tiene que corresponder:

resident_type Tipos de identificación aceptados
RESIDENTE (por defecto) Solo NIT
NO_RESIDENTE NIT_OTRO_PAIS, PASAPORTE, IE (documento extranjero), CE, TE, PEP o NIT

Ejemplo de proveedor del exterior:

{
  "support_doc": {
    "resident_type": "NO_RESIDENTE",
    "customer": {
      "party_identification_type": "NIT_OTRO_PAIS",
      "party_identification": "123456789",
      "country_code": "US"
    }
  }
}

Si el tipo no corresponde, la respuesta es uno de estos mensajes:

El tipo de residente Colombiano sólo puede tener identificación NIT. ¡Por favor modificar el tercero!
El tipo de residente del exterior sólo puede tener identificación TE, CE, NIT, Pasaporte, Documento del Exterior, PEP, NIT de otro país. ¡Por favor modificar el tercero!

La Nota de Ajuste aplica la misma regla.

Obsequios

Un ítem con precio 0 o con descuento del 100 % necesita original_price, igual que en la factura. Ver Obsequios en la factura por API.

Corregir un documento soporte

El documento soporte no tiene PUT: un PUT a /support_docs/{uuid} responde No se encuentra esta acción. Para corregirlo, repite el POST con el mismo prefijo y número:

  • Si la DIAN todavía no lo aceptó, la API lo actualiza con el cuerpo nuevo.
  • Si ya está aceptado, responde El documento 'N' ya esta aceptado en la Dian y no se puede modificar (code 002). Para corregir un documento aceptado se emite una Nota de Ajuste.

Recursos Adicionales