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

Notas crédito y débito de factura electrónica de venta

Esta guía te explica cómo construir el JSON para notas crédito y notas débito de la factura electrónica de venta.

1. Tipo de documento (code)#

codeDocumento
91Nota crédito
92Nota débito

2. Tipo de operación (typeOperation)#

2.1 Para nota crédito (code: "91")#

typeOperationDescripción
20Nota crédito que referencia una factura electrónica
22Nota crédito sin referencia a una factura electrónica

2.2 Para nota débito (code: "92")#

typeOperationDescripción
30Nota débito que referencia una factura electrónica
32Nota débito sin referencia a una factura electrónica

3. Conceptos de corrección (conceptCode)#

3.1 Para notas crédito (code: "91")#

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
5Descuento comercial por pronto pago
6Descuento comercial por volumen de ventas

3.2 Para notas débito (code: "92")#

conceptCodeDescripción
1Intereses
2Gastos por cobrar
3Cambio del valor
4Otros

4. Campos adicionales en el JSON#

Tal como en las notas del documento equivalente, en estas notas debes agregar:
{
  "conceptCode": "1",
  "invoicePrefix": "SETP",
  "invoiceConsecutive": 994110417,
  "invoiceCuv": "5743c2b14ddf8d51f24e1e40640e050f1c381163d83822c10f4387031d7f4c725e1565469702986248647309eb3d84d1",
  "invoiceIssuedAt": "2026-02-10",
  "invoiceSequence": "SETP994110417"
}
Significado rápido:
conceptCode: concepto de corrección de la nota.
invoicePrefix: prefijo de la factura referenciada.
invoiceConsecutive: consecutivo de la factura referenciada.
invoiceCuv: CUV de la factura referenciada.
invoiceIssuedAt: fecha de emisión de la factura referenciada.
invoiceSequence: secuencia completa de la factura referenciada.

5. Ejemplos completos#

Nota crédito con referencia:
{
  "code": "91",
  "typeOperation": "20",
  "conceptCode": "2",
  "invoicePrefix": "SETP",
  "invoiceConsecutive": 994110417,
  "invoiceCuv": "5743c2b14ddf8d51f24e1e40640e050f1c381163d83822c10f4387031d7f4c725e1565469702986248647309eb3d84d1",
  "invoiceIssuedAt": "2026-02-10",
  "invoiceSequence": "SETP994110417"
}
Nota débito con referencia:
{
  "code": "92",
  "typeOperation": "30",
  "conceptCode": "1",
  "invoicePrefix": "SETP",
  "invoiceConsecutive": 994110417,
  "invoiceCuv": "5743c2b14ddf8d51f24e1e40640e050f1c381163d83822c10f4387031d7f4c725e1565469702986248647309eb3d84d1",
  "invoiceIssuedAt": "2026-02-10",
  "invoiceSequence": "SETP994110417"
}

6. Errores comunes#

Enviar code: "91" con typeOperation de nota débito, 30 o 32.
Enviar code: "92" con typeOperation de nota crédito, 20 o 22.
Usar conceptCode fuera de la lista permitida para cada tipo de nota.
Omitir los campos de referencia invoicePrefix, invoiceConsecutive, invoiceCuv, invoiceIssuedAt, invoiceSequence.
Modificado en 2026-03-11 16:42:11
Anterior
Notas de ajuste débito y crédito al documento equivalente
Siguiente
Introducción
Built with