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

Extensiones de facturas

Este documento describe qué objetos adicionales debes agregar al JSON base dependiendo del tipo de documento electrónico que desees crear ante la DIAN.

🚗 1. Documento equivalente – Transporte de pasajeros terrestre#

Código DIAN: 35

➕ Agregar al JSON:#

"transport": {
  "vehicleLicensePlate": "ABC123",
  "meansOfTransport": "automotor",
  "placeOfOrigin": "Bogotá",
  "placeOfDestination": "Medellín"
}

📌 Descripción#

transport: Información del transporte utilizado.
vehicleLicensePlate: Placa del vehículo.
meansOfTransport: Medio de transporte.
placeOfOrigin: Lugar de origen.
placeOfDestination: Lugar de destino.

✈️ 2. Documento equivalente – Transporte aéreo de pasajeros#

Código DIAN: 50

➕ Agregar al JSON:#

"airTickets": [
  {
    "reserveNumber": "ABC123 / XY789Z / 1234567890",
    "identificationNumber": "123456789 / AB123456",
    "name": "MARÍA FERNANDA GARCÍA LÓPEZ",
    "email": "pasajero@correo.com"
  }
]

📌 Descripción#

airTickets: Lista de pasajeros incluidos en el tiquete aéreo.
reserveNumber: Número de reserva.
identificationNumber: Documento del pasajero.
name: Nombre completo.
email: Correo electrónico.

🎬 3. Documento equivalente – Boleta de ingreso a cine#

Código DIAN: 25

➕ Agregar al JSON:#

"cinema": {
  "nameTheater": "Cine Colombia Andino",
  "addressTheater": "Calle 82 # 11-51, Bogotá D.C.",
  "showroomNumberOrName": "Sala 5 / Sala VIP / Sala IMAX",
  "chairNumber": "F12 / A5 / BUT-15",
  "nameFunction": "Duna: Parte Dos",
  "location": "Platea Central",
  "exhibitionDay": "2024-03-15",
  "exhibitionTime": "19:30"
}

📌 Descripción#

Información detallada del evento cinematográfico:
Sala
Silla
Función
Fecha y hora de exhibición

🎟️ 4. Documento equivalente – Boleta de ingreso a espectáculos públicos#

Código DIAN: 27

➕ Agregar al JSON:#

"ticketPublicShows": {
  "producerName": "PRODUCCIONES ARTÍSTICAS COLOMBIA SAS",
  "producerNIT": "9001234567",
  "lepCode": "LEP-2024-001234",
  "eventName": "CONCIERTO SHAKIRA",
  "ticketLocation": "PLATEA VIP",
  "pulepCode": "PV-LEP-001",
  "ticketType": "GENERAL",
  "salePhase": "PREVENTA_1",
  "eventCategory": "CONCIERTO",
  "countrySubentity": "ANTIOQUIA",
  "countrySubentityCode": "05",
  "cityName": "MEDELLÍN",
  "id": "ENT2024123456789",
  "eventLocation": "ESTADIO ATANASIO GIRARDOT",
  "dateEvent": "2024-06-15",
  "timeEvent": "20:00"
}

📌 Descripción#

Incluye información completa del evento:
Productor
Código LEP / PULEP
Ubicación
Fecha y hora
Tipo de entrada

🏥 5. Factura electrónica – Sector salud#

➕ Agregar al JSON:#

"healthSector": {
  "serviceProviderCode": "string",
  "paymentMethod": "string",
  "coverageOrBenefitPlan": "string",
  "contractNumber": "string",
  "policyNumber": "string",
  "copayment": "string",
  "moderatorFee": "string",
  "sharedPaymentsInVoluntaryPlans": "string",
  "advance": "string",
  "startDateService": "string",
  "endDateService": "string"
}

📌 Descripción#

Información obligatoria para servicios del sector salud:
Código del prestador
Método de pago
Plan o cobertura
Copagos y cuotas moderadoras
Fechas del servicio

💱 6. Documento con moneda de compra y venta de divisas#

➕ Agregar al JSON:#

"purchaseAndSaleCurrencies": {
  "code": "15"
}

📌 Descripción#

Permite indicar el código de moneda cuando la compra y la venta manejan monedas diferentes.

📌 Consideraciones Generales#

Estos objetos deben agregarse al mismo nivel del JSON principal, junto a customer, lines, totals, etc.
Solo se deben enviar cuando el tipo de documento (code) lo requiera.
Si el documento no corresponde a alguno de estos casos, no deben incluirse estos objetos.
Todos los datos deben cumplir con las validaciones establecidas por la DIAN.

🧾 Resumen Rápido#

Tipo DocumentoCódigo DIANObjeto a Enviar
Transporte terrestre35transport
Transporte aéreo50airTickets
Boleta cine25cinema
Espectáculos públicos27ticketPublicShows
Sector saludSegún apliquehealthSector
Moneda diferenteSegún apliquepurchaseAndSaleCurrencies

✅ Con esta guía podrás extender tu JSON base correctamente dependiendo del tipo de documento electrónico que necesites generar.
Modificado en 2026-03-25 21:13:20
Anterior
Documentos equivalentes
Siguiente
Factura electrónica de venta
Built with