🇨🇴 Colombia
Esta ficha asume que conoces el protocolo de comunicación xPOS-Core. Aquí solo documentamos lo especifico de Colombia.
Resumen
| Aspecto | Valor |
|---|---|
Código country | co |
| Entidad tributaria | DIAN |
| Patrón | C — XML dual (DTE / DTE equivalente) |
inputType soportados | json, xml, xdoc, txt |
| Endpoint extra | – |
| Output | XML tributario firmado |
Mapeo de XSLT
| XSLT | Uso |
|---|---|
input_to_dte_co.xslt | Entradas json y xml → XML <root> → XML Gosocket. |
other_to_dte_co.xslt | Entrada txt → XML Gosocket. No pasa por input_to_dte. |
xdoc_to_dte_co.xslt | Entrada xdoc → XML Gosocket. No pasa por input_to_dte. |
dte_to_fiscal_co.xslt | XML Gosocket → DTE tributario DIAN. |
dteEQ_to_fiscal_co.xslt | XML Gosocket → DTE equivalente DIAN (según tipo de documento). |
custom_response_co.xslt | Genera custom_response cuando aplica. |
Tipos de documento (typeDoc)
Ejemplo WebSocket usa
typeDoc=01(factura electrónica). El parámetro es numérico:typeDoc=1ytypeDoc=01son equivalentes.
typeDoc | Documento |
|---|---|
| 01 | Factura electrónica de venta |
| 02 | Factura electrónica de venta — exportación |
| 03 | Documento electrónico de transmisión |
| 04 | Factura electrónica de venta — tipo 04 |
| 07 | Documento equivalente electrónico — contingencia |
| 08 | Documento equivalente electrónico — contingencia |
| 20 | Documento equivalente electrónico POS |
| 25 | Boleta de ingreso a cine |
| 27 | Boleta de ingreso a espectáculos públicos |
| 30 | Documento en juegos localizados y no localizados |
| 35 | Tiquete de transporte de pasajeros terrestre |
| 40 | Documento expedido para el cobro de peajes |
| 45 | Extracto expedido por sociedades financieras y fondos |
| 50 | Tiquete de billete de transporte aéreo de pasajeros |
| 55 | Documento de operación de bolsa de valores, agropecuaria y comodities |
| 60 | Documento expedido para los servicios públicos y domiciliarios |
| 91 | Nota crédito |
| 92 | Nota débito |
En la contingencia local, la factura (01) se convierte al tipo 03 o 04, y el documento equivalente al código de contingencia que le corresponde (08). Las notas (91 y 92) validan contra su propio esquema.
Campos del response específicos de Colombia
Colombia devuelve todo el nucleo + eco tributario completo + dos campos exclusivos:
| Campo | Descripción |
|---|---|
docNumber | Serie y número del documento (p. ej. SETP990044419). |
contingencyCode | Código de contingencia DIAN. |
countryIdentificationCode en Colombia es CUFE (factura electrónica) o CUDE (documento equivalente) según el tipo.
Ejemplo WebSocket
{
"env": "sbx",
"operation": "consolidate",
"typeDoc": 1,
"country": "co",
"inputType": "json",
"origin": "<taxId del emisor>",
"document": { /* factura electronica o documento equivalente */ }
}Reobtención de estados
El response de /api/v1/status en Colombia incluye, además del nucleo, estos campos:
| Campo | Descripción |
|---|---|
signedXml | XML tributario firmado con folio. |
param | test o consolidate. |
typedoc | Tipo DTE. |
date | Fecha transacción (aaaa-mm-ddTHH:mm:ss). |
Contingencia local (tipo 03)
Ante una interrupción de la DIAN, xPOS convierte y emite el documento en su modalidad de contingencia (tipo 03) localmente en el dispositivo, sin depender de servicios externos, y lo regulariza después cuando la autoridad se recupera.
Para contar con esta funcionalidad es requisito tener activado el Gestor de Folios y solicitar su activación al equipo de consultoría de Gosocket.
En equipos con varios emisores, la contingencia es independiente por empresa: se activa únicamente para la empresa afectada y las demás siguen emitiendo en línea.
Notas particulares
- Patrón C: el flujo bifurca el XSLT según tipo de documento (factura electrónica vs documento equivalente).
- Publica en Inbox-Gosocket.
Cambios en la versión 2.7.0
- Contingencia local (tipo 03) resuelta en el dispositivo — ver sección propia.
- Regla 90 más precisa: el mensaje recupera el documento previamente aceptado consultando el ambiente correcto de cada empresa.
- Respuesta de la DIAN legible en pantalla, con la opción Ver respuesta ET del dashboard.
- Corrección del formato de fecha en la autoreferencia que la DIAN observaba en ciertos documentos de contingencia.
- La descarga de configuración deja la instalación exactamente como el portal la define.