🇨🇴 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).
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). |
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.