Documentos equivalentes

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.

No todos los 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:

{"code": "20"}

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.

Ejemplo válido:

{"code": "20", "typeOperation": "10"}

También son válidos, por la misma regla:

{"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".

Además, debes indicar la categoría del vehículo por la cual se está cobrando la tarifa del peaje.

Ejemplo fácil de entender:

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

Ejemplo de referencia en un detalle del documento:

{
  "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.

Ejemplo válido:

{"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"}

¿Qué campos debes enviar?#

1. Tipos de documento permitidos (code)#

2. Tipos de operación (typeOperation) por código#

2.1 Para 20, 25, 35, 40, 50#

Aclaración para 40 cobro de peajes#

2.2 Para 27 espectáculos públicos#

3. Reglas rápidas para no fallar en la integración#

4. Plantillas listas para copiar#