1. Estructura de datos
Muisca
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Consultar resoluciones
    • Resoluciones
      GET
  • Facturas electrónicas
    • Crear factura sector salud
      POST
    • Crear factura divisas
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
    • Crear factura electrónica
      POST
  • Documentos soporte
    • Crear documento soporte
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos equivalentes
    • Consultar por ID
    • Crear tiquete P.O.S
    • Crear tiquete de transporte terrestre
    • Crear tiquete de cine
    • Crear tiquete de cobro de peajes
    • Crear tiquete aereo
    • Crear boleta de ingreso a espectáculos públicos
    • Consultar por prefijo y consecutivo
  • 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 débito al documento equivalente
    • Crear nota débito al documento equivalente
    • 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 de ajuste al documento soporte
    • Consultar por ID
    • Consultar por prefijo y consecutivo
    • Crear nota de ajuste
  • Preguntas frecuentes
    • ¿Cómo funciona la contingencia Dian en Nitro?
    • ¿Cómo autenticarme en la API?
    • ¿Cómo pruebo antes de pasar a producción?
    • ¿Debo reenviar un documento rechazado?
    • ¿Cuál es la diferencia entre pruebas, habilitación y producción?
    • ¿Dónde obtengo la API Key?
    • ¿Qué ambientes existen?
    • ¿Qué formatos de documentos puedo enviar?
    • ¿Qué hago si la Dian rechaza un documento?
    • ¿Qué pasa cuando la Dian no responde?
    • ¿Qué significa un código de respuesta HTTP?
    • ¿Qué significa el estado DianNoDisponible?
  • 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
  • Schemas
    • Organización
      • AddCompany
      • AddUser
    • Response
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Productos
    • LineaProductoPeaje
    • NotasCred/Deb/Ajus
    • Sucursal
    • Supplier2
    • Dirección
    • Resolución
    • Cliente
    • Totales
    • Descuento
    • Cargos
    • Propinas
    • Transporte
    • TikectAereo
    • Cinema
    • EspectaculoPublico
    • SectorSalud
    • ComprayVentaDeDivisas
    • Retencioness
    • Impuestos
    • Mandante
  1. Estructura de datos

Notas de ajuste débito y crédito al documento equivalente

Esta guía te explica cómo reportar en la API las notas de ajuste de tipo débito y crédito para documentos equivalentes.

1. Tipo de documento de la nota (code)#

Para notas de ajuste al documento equivalente, debes usar estos códigos:
codeTipo de nota
93Nota de ajuste de tipo débito al documento equivalente
94Nota de ajuste de tipo crédito al documento equivalente

2. Tipo de operación admitido (typeOperation)#

Tanto para code: "93" como para code: "94", typeOperation indica qué tipo de documento equivalente estás referenciando.
typeOperationReferencia al documento equivalente
20Con referencia a documento tiquete de máquina registradora con sistema P.O.S.
25Con referencia a documento equivalente boleta de ingreso a cine
27Con referencia a documento equivalente boleta de ingreso a espectáculos públicos
35Con referencia a documento equivalente tiquete de transporte de pasajeros terrestre
40Con referencia a documento equivalente documento expedido para el cobro de peajes
50Con referencia a documento equivalente tiquete de billete de transporte aéreo de pasajeros

3. Regla práctica#

code define el tipo de nota: 93 es débito y 94 es crédito.
typeOperation define el documento equivalente afectado: 20, 25, 27, 35, 40 o 50.
conceptCode define el concepto de corrección y sus valores permitidos dependen del tipo de nota (93 o 94).

4. Ejemplos JSON#

Nota débito sobre POS:
{"code":"93","typeOperation":"20"}
Nota crédito sobre boleta de cine:
{"code":"94","typeOperation":"25"}
Nota débito sobre boleta de espectáculos públicos:
{"code":"93","typeOperation":"27"}
Nota crédito sobre tiquete de transporte terrestre:
{"code":"94","typeOperation":"35"}
Nota débito sobre peajes:
{"code":"93","typeOperation":"40"}
Nota crédito sobre tiquete aéreo:
{"code":"94","typeOperation":"50"}

5. Errores comunes#

Usar code: "20" o similares en una nota de ajuste. Debes usar 93 o 94.
Enviar typeOperation: "93" o "94". Estos valores pertenecen a code, no a typeOperation.
Referenciar un typeOperation fuera del listado permitido.

6. Campos adicionales requeridos en el JSON de nota de ajuste#

Al generar una nota de ajuste, además de code y typeOperation, debes enviar los datos de referencia del documento original:
{
  "conceptCode": "1",
  "invoicePrefix": "SETP",
  "invoiceConsecutive": 994110417,
  "invoiceCuv": "5743c2b14ddf8d51f24e1e40640e050f1c381163d83822c10f4387031d7f4c725e1565469702986248647309eb3d84d1",
  "invoiceIssuedAt": "2026-02-10",
  "invoiceSequence": "SETP994110417"
}
Significado de los campos:
conceptCode: código del concepto de la nota de ajuste, ver tabla de conceptos.
invoicePrefix: prefijo del documento equivalente referenciado.
invoiceConsecutive: consecutivo numérico del documento referenciado.
invoiceCuv: CUV del documento equivalente referenciado.
invoiceIssuedAt: fecha de emisión del documento referenciado en formato YYYY-MM-DD.
invoiceSequence: secuencia completa del documento referenciado, prefijo más consecutivo.

Conceptos de corrección (conceptCode)#

El valor de conceptCode depende del tipo de nota indicado en code.

Nota crédito (code: "94")#

conceptCodeDescripción
1Devolución parcial de los bienes y/o no aceptación parcial del servicio
2Anulación de factura electrónica
3Rebaja o descuento parcial o total
4Ajuste de precio
5Otros

Nota débito (code: "93")#

conceptCodeDescripción
1Intereses
2Gastos por cobrar
3Cambio del valor
4Otro
Ejemplo completo de nota crédito sobre boleta de cine:
{
  "code": "94",
  "typeOperation": "25",
  "conceptCode": "1",
  "invoicePrefix": "SETP",
  "invoiceConsecutive": 994110417,
  "invoiceCuv": "5743c2b14ddf8d51f24e1e40640e050f1c381163d83822c10f4387031d7f4c725e1565469702986248647309eb3d84d1",
  "invoiceIssuedAt": "2026-02-10",
  "invoiceSequence": "SETP994110417"
}
Modificado en 2026-08-29 16:34:33
Anterior
Modos de ambiente de facturación
Siguiente
Notas crédito y débito de factura electrónica de venta
Built with