Esta guía te indica qué códigos debes enviar en la API para crear documentos equivalentes electrónicos según los valores definidos con base en la DIAN.¿Qué campos debes enviar?#
En esta parte de la API debes usar principalmente dos campos:code: indica el tipo de documento equivalente que quieres generar.
typeOperation: indica la modalidad de operación para ese tipo de documento.
code usan los mismos typeOperation. Por eso debes elegir la combinación correcta.1. Tipos de documento permitidos (code)#
Código (code) | ¿Qué documento representa? | ¿Cuándo se usa? |
|---|
20 | Documento equivalente electrónico del tiquete de máquina registradora con sistema P.O.S. | Cuando registras ventas tipo POS como documento equivalente electrónico. |
25 | Boleta de ingreso a cine | Cuando vendes entradas para funciones de cine. |
27 | Boleta de ingreso a espectáculos públicos | Cuando vendes entradas para conciertos, teatro, eventos deportivos u otros espectáculos públicos. |
35 | Tiquete de transporte de pasajeros terrestre | Cuando emites tiquetes para transporte terrestre de pasajeros. |
40 | Documento expedido para el cobro de peajes | Cuando registras cobros de peaje. |
50 | Tiquete de billete de transporte aéreo de pasajeros | Cuando emites tiquetes de transporte aéreo. |
Ejemplo mínimo, solo tipo de documento:2. Tipos de operación (typeOperation) por código#
2.1 Para 20, 25, 35, 40, 50#
Estos códigos admiten un solo tipo de operación:Código de operación (typeOperation) | Significado |
|---|
10 | Código único para documentos equivalentes que no tienen más de un modo de operación. |
{"code": "20", "typeOperation": "10"}
{"code": "25", "typeOperation": "10"}
{"code": "35", "typeOperation": "10"}
{"code": "40", "typeOperation": "10"}
{"code": "50", "typeOperation": "10"}
Aclaración para 40 cobro de peajes#
Cuando uses el documento equivalente para cobro de peajes, debes incluir una descripción del bien o servicio cobrado. Esa descripción puede ser:Específica: por ejemplo, "Paso por peaje de vehículo categoría I".
Genérica: por ejemplo, "Servicio de peaje".
Servicio: Cobro de peaje en estación Andes Norte
Descripción: Servicio de peaje para vehículo categoría II
Categoría del vehículo: II
{
"code": "40",
"typeOperation": "10",
"lines": [
{
"code": "PROD001",
"name": "Servicio de peaje",
"description": "Servicio de peaje para vehículo categoría II"
}
]
}
2.2 Para 27 espectáculos públicos#
El código 27 tiene varias modalidades. Debes escoger una según el tipo de evento y la forma de comercialización:Código de operación (typeOperation) | Significado |
|---|
271 | Estándar de espectáculos públicos de las artes escénicas. |
272 | Mandato de espectáculos públicos de las artes escénicas. |
273 | Estándar de otros espectáculos públicos. |
274 | Mandato de otros espectáculos públicos. |
{"code": "27", "typeOperation": "271"}
3. Reglas rápidas para no fallar en la integración#
Si code es 20, 25, 35, 40 o 50, usa siempre typeOperation: "10".
Si code es 27, usa uno de estos valores: 271, 272, 273 o 274.
No mezcles códigos no permitidos. Por ejemplo, {"code":"20","typeOperation":"271"} es una combinación inválida.
4. Plantillas listas para copiar#
{"code":"20","typeOperation":"10"}
{"code":"25","typeOperation":"10"}
{"code":"27","typeOperation":"271"}
{"code":"27","typeOperation":"272"}
{"code":"27","typeOperation":"273"}
{"code":"27","typeOperation":"274"}
{"code":"35","typeOperation":"10"}
{"code":"40","typeOperation":"10"}
{"code":"50","typeOperation":"10"}
Modificado en 2026-05-22 20:41:16
