Esta guía te explica cómo usar el modo contingencia al emitir documentos equivalentes desde la API de facturación electrónica.

¿Qué es modo contingencia?

El modo contingencia se usa cuando no puedes operar con normalidad y debes seguir emitiendo documentos.

En DIAN se manejan dos códigos:

07: contingencia por parte del emisor.

08: contingencia por parte de la DIAN.

¿Cuándo usar cada código?

Usa 07 cuando la falla está de tu lado.
Ejemplo: caída de tu sistema, falla de red de tu proveedor o indisponibilidad de tu infraestructura.

Usa 08 cuando la indisponibilidad está del lado de la DIAN.
Ejemplo: servicios DIAN no disponibles para recepción o validación.

Regla principal en la API

Para documentos equivalentes, en contingencia aplica esta regla:

code: indica la contingencia, 07 o 08.

typeOperation: indica el tipo de documento equivalente, 20, 25, 27, 35, 40, 50.

Ejemplos de payload

Contingencia por parte del emisor:

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

Contingencia por parte de la DIAN:

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

Espectáculos públicos en contingencia:

{"code":"07","typeOperation":"27"}

{"code":"08","typeOperation":"27"}

Diferencia contra operación normal

Operación normal:
code representa el tipo de documento equivalente, 20, 25, 27, 35, 40, 50.

Operación por contingencia:
en documentos equivalentes, code cambia a "07" o "08" y el documento equivalente lo debes informar en typeOperation.

Checklist rápido antes de enviar

¿Seleccionaste correctamente el origen de la falla en code, 07 u 08?

¿Informaste el tipo de documento equivalente en typeOperation, 20, 25, 27, 35, 40 o 50?

¿Tienes trazabilidad interna del motivo y del intervalo de contingencia?

Errores comunes

Enviar code con el tipo de documento, 20, 25, etc., cuando ya estás en contingencia.

Invertir los campos code y typeOperation en documentos equivalentes.

Usar 08 cuando la falla realmente es del emisor. En ese caso debes usar 07.

Documentos en contingencia - API Facturación Electrónica DIAN

Este documento describe los códigos que debes enviar en el JSON cuando necesites generar documentos en modo contingencia, ya sea por falla del emisor o por indisponibilidad de la DIAN.

Concepto de contingencia

Debes usar el modo contingencia cuando:

El sistema del emisor presenta fallas.

El servicio de la DIAN no está disponible.

En estos casos, el documento se genera con un código especial de contingencia y después lo transmites a la DIAN cuando el servicio vuelva a estar disponible.

1. Factura electrónica en contingencia

Para facturas electrónicas, el campo:

"code"

lo debes enviar con los siguientes valores:

Código	Descripción
03	Contingencia por parte del emisor
04	Contingencia por parte de la DIAN

Ejemplo

"code": "03"

2. Documentos equivalentes en contingencia

Para documentos equivalentes electrónicos en contingencia:

Código de contingencia

Código	Descripción
07	Contingencia por parte del emisor
08	Contingencia por parte de la DIAN

Este valor lo debes enviar en el campo:

"code"

Tipo de documento equivalente

Además, debes indicar el tipo de documento equivalente en el campo:

"typeOperation"

Valores permitidos

typeOperation	Documento
20	Documento equivalente electrónico del tiquete de máquina registradora con sistema P.O.S.
25	Boleta de ingreso a cine
27	Boleta de ingreso a espectáculos públicos
35	Tiquete de transporte de pasajeros terrestre
40	Documento expedido para el cobro de peajes
50	Tiquete de billete de transporte aéreo de pasajeros

Ejemplos

Ejemplo 1: Documento POS en contingencia por el emisor

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

Ejemplo 2: Boleta de cine en contingencia DIAN

{
  "code": "08",
  "typeOperation": "25"
}

Ejemplo 3: Factura electrónica en contingencia DIAN

{
  "code": "04"
}

Consideraciones importantes

El campo code define el tipo de contingencia.

El campo typeOperation es obligatorio para documentos equivalentes.

Los demás campos del JSON los debes enviar según el tipo de documento.

Los documentos generados en contingencia los debes transmitir posteriormente a la DIAN cuando el servicio esté disponible.

Resumen general

Tipo de documento	code	typeOperation
Factura - Contingencia emisor	03	No aplica
Factura - Contingencia DIAN	04	No aplica
Documento equivalente - Emisor	07	20, 25, 27, 35, 40, 50
Documento equivalente - DIAN	08	20, 25, 27, 35, 40, 50

Usa estos valores para generar correctamente documentos en modo contingencia desde la API.

Modo contingencia

¿Qué es modo contingencia?#

¿Cuándo usar cada código?#

Regla principal en la API#

Ejemplos de payload#

Diferencia contra operación normal#

Checklist rápido antes de enviar#

Errores comunes#

Documentos en contingencia - API Facturación Electrónica DIAN#

Concepto de contingencia#

1. Factura electrónica en contingencia#

Ejemplo#

2. Documentos equivalentes en contingencia#

Código de contingencia#

Tipo de documento equivalente#

Valores permitidos#

Ejemplos#

Ejemplo 1: Documento POS en contingencia por el emisor#

Ejemplo 2: Boleta de cine en contingencia DIAN#

Ejemplo 3: Factura electrónica en contingencia DIAN#

Consideraciones importantes#

Resumen general#