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/jsonAuth-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(code002). Para corregir un documento aceptado se emite una Nota de Ajuste.
Recursos Adicionales
- Ciudades y departamentos: la Lista Departamentos del DANE, con nombres, en Importación > Terceros > Descarga de Referencias
- Unidades de medida: código y descripción, en el campo Unidad de medida del producto
- Consultar documento soporte por API
- Crear nota de ajuste a DS
- Consultar nota de ajuste por API