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

Referencia completa: API DOCS Documentación Técnica POS Electrónico

Autenticación

La API utiliza el encabezado Auth-token como método de autenticación para la transmisión de Documentos POS Electrónico. Puede ser una llave API o el Auth Token de la cuenta, que aparece en Opciones (parte superior) > Configuración. El POS no usa dataico_account_id: toma la empresa de la credencial.

Habilitación

Si es tu primera vez en DATAICO, debes habilitar el software ante la DIAN antes de emitir documentos POS Electrónicos. Consulta Cómo activar y conectar Dataico con la DIAN para hacer Documento Equivalente POS Electrónico.

Numeración

Para obtener los datos de autorización de tu numeración o consecutivo de Documento POS Electrónico:

Ventas > POS > Numeraciones

En esta sección encontrarás el Prefijo y el consecutivo actual utilizado. Para obtener el número de resolución o editar el consecutivo inicial, haz clic en el ícono [Editar configuración].

Nota: Si aún no cuentas con una resolución de Documento POS Electrónico asociada a tu cuenta DATAICO, consulta el artículo Cómo asociar una numeración para crear Documento Equivalente POS Electrónico

Crear Documento POS Electrónico

Método: POST

Endpoint: https://api.dataico.com/direct/dataico_api/v2/pos-invoices

Headers:

Content-Type: application/json
Auth-token: <tu llave API o el Auth Token de la cuenta>

A diferencia de la factura electrónica, el JSON del POS usa claves con guion, no con guion bajo: por ejemplo issue-date, send-dian, dian-resolution y payment-means.

Estructuras JSON disponibles

Documento POS Electrónico: estructura básica

Consultar Documento POS Electrónico

Método: GET

Endpoint: https://api.dataico.com/direct/dataico_api/v2/pos-invoices/{prefijo}/{número}

Reemplaza {prefijo} y {número} por los del documento POS. Usa los mismos headers de la creación.