1. Estructura de datos
API de Facturación Aliaddo NITRO
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Facturas electrónicas
    • Crear factura electrónica
      POST
    • Crear factura sector salud
      POST
    • Crear factura divisas
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos soporte
    • Crear documento soporte
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos equivalentes
    • Crear tiquete P.O.S
      POST
    • Crear tiquete de transporte terrestre
      POST
    • Crear tiquete de cine
      POST
    • Crear tiquete de cobro de peajes
      POST
    • Crear tiquete aereo
      POST
    • Crear boleta de ingreso a espectáculos públicos
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Notas crédito
    • Crear nota crédito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Notas débito
    • Crear nota débito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento soporte
    • Crear nota de ajuste
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota crédito al documento equivalente
    • Crear nota crédito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota débito al documento equivalente
    • Crear nota débito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento equivalente
    • Crear nota de ajuste al documento equivalente
  • Lista de valores
    • Actividades económicas
    • Ciudades
    • Códigos de monedas
    • Código estandar del producto
    • Condiciones de entrega (INCOTERMS)
    • Departamentos
    • Medios de pagos
    • Paises
    • Responsabilidades fiscales
    • Tipos de identificacion
    • Tipos de documentos electrónicos
    • Tipos de operación
    • Tipos de persona
    • Tipos de regimen
    • Tributos (Impuestos/Retenciones)
    • Unidades de cantidad
    • Responsable de impuestos
    • Códigos Postales de Colombia
  • Estructura de datos
    • Ancho del PDF
    • Descuentos y cargos
    • Direcciones del cliente
    • Documentos equivalentes
    • Extensiones de facturas
    • Factura electrónica de venta
    • Factura electrónica sector salud
    • Factura electrónica de venta y compra de divisas
    • Formatos permitidos PDF
    • ID set de pruebas DIAN
    • Modo contingencia
    • Modos de ambiente de facturación
    • Notas de ajuste débito y crédito al documento equivalente
    • Notas crédito y débito de factura electrónica de venta
  • Guía para importar archivos
    • Introducción
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Impuestos
    • Mandante
    • Retencioness
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Supplier
    • Dirección
    • Resolución
    • Cliente
    • Productos
    • LineaProductoPeaje
    • Totales
    • SectorSalud
    • Transporte
    • Sucursal
    • RequestResponse
    • Cinema
    • TikectAereo
    • EspectaculoPublico
    • ComprayVentaDeDivisas
    • Retenciones
    • Descuento
    • Propinas
    • Cargos
    • Supplier2
    • NotasCred/Deb/Ajus
  1. Estructura de datos

Modo contingencia

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ódigoDescripción
03Contingencia por parte del emisor
04Contingencia 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ódigoDescripción
07Contingencia por parte del emisor
08Contingencia 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#

typeOperationDocumento
20Documento equivalente electrónico del tiquete de máquina registradora con sistema P.O.S.
25Boleta de ingreso a cine
27Boleta de ingreso a espectáculos públicos
35Tiquete de transporte de pasajeros terrestre
40Documento expedido para el cobro de peajes
50Tiquete 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 documentocodetypeOperation
Factura - Contingencia emisor03No aplica
Factura - Contingencia DIAN04No aplica
Documento equivalente - Emisor0720, 25, 27, 35, 40, 50
Documento equivalente - DIAN0820, 25, 27, 35, 40, 50
Usa estos valores para generar correctamente documentos en modo contingencia desde la API.
Modificado en 2026-03-11 16:40:17
Anterior
ID set de pruebas DIAN
Siguiente
Modos de ambiente de facturación
Built with