1. Notas débito
APIs Rest de Aliaddo
  • API Nitro (Facturacón Masiva)
    • Introducción
    • Autenticación
    • Códigos de respuesta de la API
    • Facturas electrónicas
      • Crear factura electrónica
      • Crear factura sector salud
      • Crear factura divisas
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos soporte
      • Crear documento soporte
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • Documentos equivalentes
      • 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 ID
      • 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
        POST
      • Consultar por ID
        GET
      • Consultar por prefijo y consecutivo
        GET
    • 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 soporte
      • Crear nota de ajuste
      • Consultar por ID
      • Consultar por prefijo y consecutivo
    • 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
  • API ERP Cloud
    • Autenticación
    • Respuestas API
    • Límite de request
    • VENTAS
      • Facturas
        • Crear factura de venta
        • Consultar facturas
        • Consultar una factura
        • Editar factura de venta
        • Pagar factura
        • Anular una factura
      • Cotizaciones
        • Crear cotización
        • Consultar cotizaciones
        • Consultar una cotización
        • Editar cotización
        • Anular cotización
      • Ordenes de Venta
        • Crear orden de venta
        • Consultar ordenes de venta
        • Consultar una orden de venta
        • Editar orden de venta
        • Anular orden de venta
      • Remisiones
        • Crear remisión
        • Consultar remisiones
        • Consultar una remisión
        • Editar remisión
        • Anular remisión
    • COMPRAS
      • Facturas de compra
        • Consultar una factura
        • Editar factura
        • Anular una factura
        • Consultar facturas
        • Pagar factura de compra
        • Crear factura
    • Contactos
      • Consultar los contactos
      • Crear contacto
      • Eliminar un contacto
      • Consultar un contacto
      • Editar contacto
    • Productos
      • Consultar un producto
      • Eliminar un producto
      • Editar un producto
      • Crear un producto
      • Consultar los productos
      • Consultar categorías
      • Consultar unidades de medidas
      • Consultar listas de precios
      • Consultar stock
    • Bodegas
      • Consultar bodegas
    • Contabilidad
      • Consultar tipos de comprobantes
      • Crear asiento contable
      • Consultar asientos contables
      • Anular asiento contable
      • Consultar cuentas contables
      • Consultar un asiento contable
      • Consultar cuentas contables por código
      • Consultar tipos de comprobantes por código
    • Centros de costo
      • Consultar centros de costos
    • Impuestos
      • Consultar un impuesto
      • Consultar los impuestos
      • Editar impuesto
      • Crear impuesto
      • Eliminar un impuesto
    • Retenciones
      • Consultar las retenciones
      • Crear retención
      • Eliminar una retención
      • Editar retención
    • Sucursales
      • Consultar sucursales
    • Vendedores
      • Lista de vendedores
    • Usuarios
      • Consultar usuarios
    • CRM
      • Deals
        • Crear negocio
        • Consultar negocios
        • Editar negocio
        • Eliminar un negocio
      • Leads
        • Consultar Leads
        • Crear lead
        • Consultar etapas del ciclo de vida
        • Editar lead
        • Eliminar lead
      • Territorios
        • Consultar territorios
      • Pipelines
        • Consultar procesos
        • Consultar etapas de un proceso
      • Fuentes
        • Consultar fuentes
      • Activities
        • Crear actividad
        • Consultar actividades
        • Consultar actividades
        • Editar actividad
        • Eliminar actividad
      • Consultar propietarios
  • APIs Heredadas (Legacy)
    • API FE de primera generación
      • Introducción
      • Cuotas y Límites
      • Primeros Pasos
        • Consideraciones Importantes
        • Manual Operativo de la Plataforma
        • Generar X-API-KEY
        • Librerías
        • Formatos PDF
        • Diccionario de Datos
          • Sobre el Diccionario de Datos
          • Factura
          • Nota Crédito
          • Nota Débito
          • Documento Soporte
          • Nota de Ajuste
          • Listas de Códigos
            • Sobre las Listas de Códigos
            • Códigos de Factura
            • Códigos de Nota Crédito
            • Códigos de Nota Débito
            • Códigos de Actividades Económicas
            • Códigos de Ciudad
            • Códigos de Forma de Pago
            • Códigos de Moneda
            • Códigos de País
            • Códigos de Región
            • Códigos de Unidades de Medida
            • Códigos de Responsabilidad Fiscal
      • Errores y Rechazos
        • Errores Comunes
        • Códigos de Rechazo y Advertencia de la DIAN
          • Códigos de Rechazo y Advertencia de la DIAN
          • Rechazos de Factura
          • Rechazos de Nota Crédito
          • Rechazos de Nota Débito
      • Modo Pruebas
        • Enviar Factura a Pruebas
        • Enviar Nota Crédito a Pruebas
        • Enviar Nota Débito a Pruebas
        • Enviar Documento Soporte a Pruebas
        • Enviar Nota de Ajuste a Pruebas
      • Modo Habilitacion
        • Enviar Factura para Habilitación
        • Enviar Nota Crédito para Habilitación
        • Enviar Nota Débito para Habilitación
      • produccion
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
        • Documento sin título
      • archivo-plano.csv
        • Importar archivo plano
        • Consideraciones sobre el archivo plano
        • estructura-del-archivo-plano
          • Factura
          • Nota crédito
          • Nota débito
          • Estructura del archivo plano
    • API Nómina de primera generación
      • Table of contents
      • Cuotas y límites
      • Introducción
      • primeros-pasos
        • Documento sin título
        • estructura-de-los-datos
          • Documento sin título
          • Documento sin título
          • Documento sin título
          • Estructura de los datos
          • listas-de-codigos
            • Códigos de ciudad
            • Códigos de moneda
            • Códigos de municipio
            • Códigos de país
            • Códigos de departamento
            • Documento de identificación
            • Medios de pago
            • Periodo de Nómina
            • Listas de códigos
            • Subtipo de Trabajador
            • Tipo de contrato
            • Tipo de Hora Extra o Recargo: Porcentaje
            • Tipo de Incapacidad
            • Tipo de trabajador
      • modo-produccion
        • reemplazar-nomina
          • Enviar reemplazo de nómina para producción
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para producción
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina para producción
          • Eliminar Nómina
      • modo-habilitacion
        • untitled-1
          • Enviar reemplazo de nómina en habilitación
          • Reemplazar Nómina
        • enviar-nomina
          • Enviar documento para habilitación
          • Enviar Nómina
        • eliminar-nomina
          • Eliminación de nómina en habilitación
          • Eliminar Nómina
      • modo-pruebas
        • untitled
          • Enviar documento para pruebas
          • Enviar Nómina
        • reemplazar-nomina
          • Enviar reemplazo de nómina para pruebas
          • Reemplazar Nómina
        • eliminar-nomina
          • Eliminación de nómina para pruebas
          • Eliminar Nómina
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Schemas ERP Cloud API
    • ISV Legacy
      • Factura Electrónica
      • Sucursal
      • Resolución
      • Cliente
      • Detalle
      • Descuentos
      • Cargos
      • Impuestos
      • Retenciones
      • Mandante
      • Total
      • Campos Personalizados
      • Nota Crédito
      • Nota Débito
      • Documento Soporte
      • Nota de Ajuste
      • Proveedor
    • 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. Notas débito

Crear nota débito

Probando
POST
/v2/documents/invoices/debit-notes
Crea una Nota débito electrónica para ajustes positivos a facturas existentes. Empleada para cargos adicionales, omisiones o correcciones al alza, manteniendo referencia al documento original.

Solicitud

Autorización
Bearer Token
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
or
Parámetros del Body application/json

Ejemplos

Respuestas

🟢200OK
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v2/documents/invoices/debit-notes' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": "92",
    "typeOperation": "30",
    "mode": "Test",
    "format": "Estandar",
    "size": "Estandar",
    "testSetId": "0e3d0669-03ed-4f70-a237-c9541d22c5a1",
    "prefix": "NTD",
    "consecutive": 1,
    "orderReference": "ORD-2025-001",
    "currencyCode": "COP",
    "currencyRate": 0,
    "issuedAt": "2026-03-10",
    "dueAt": "2026-03-10",
    "periodStartDate": "2026-03-10",
    "periodEndDate": "2026-03-10",
    "deliveryAt": "2026-03-10",
    "incoterms": "CFR",
    "deliveryTerms": "Entrega en puerta",
    "terms": "Términos y condiciones comerciales",
    "termDay": 30,
    "paymentMeanCode": "10",
    "sellerName": "Juan Vendedor",
    "branch": {
        "name": "Sucursal Principal",
        "address": "Calle Ficticia 123, Edificio Empresarial",
        "regionCode": "11",
        "regionName": "Departamento Ejemplo",
        "cityCode": "11001",
        "cityName": "Ciudad Ejemplo",
        "phone": "1234567890"
    },
    "resolution": {
        "key": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
        "prefix": "SETP",
        "number": 18760000001,
        "rangeInitial": 990000000,
        "rangeFinal": 995000000,
        "validFrom": "2019-01-19",
        "validUntil": "2030-01-19"
    },
    "customer": {
        "companyName": "Mi empresa S.A",
        "personType": "2",
        "regimeType": "49",
        "firstName": "Nombres del cliente",
        "lastName": "Apellidos del cliente",
        "identification": "1234567890",
        "digitCheck": "2",
        "identificationTypeCode": "13",
        "email": "clienteemail@gmail.com",
        "phone": "1234567890",
        "responsibleFor": "ZZ",
        "responsibilities": "R-99-PN",
        "BillingAddress": {
            "address": "Tu dirección 01 #02-03",
            "countryName": "Colombia",
            "countryCode": "CO",
            "regionName": "Bogotá",
            "regionCode": "11",
            "cityName": "Bogotá",
            "cityCode": "11001",
            "postalCode": "110011",
            "neighborhood": "Chapinero",
            "phone": "1234567890",
            "contactName": "Nombre Contacto"
        },
        "ShippingAddress": {
            "address": "Tu dirección 01 #02-03",
            "countryName": "Colombia",
            "countryCode": "CO",
            "regionName": "Bogotá",
            "regionCode": "11",
            "cityName": "Bogotá",
            "cityCode": "11001",
            "postalCode": "110011",
            "neighborhood": "Chapinero",
            "phone": "1234567890",
            "contactName": "Nombre Contacto"
        }
    },
    "lines": [
        {
            "code": "PROD001",
            "name": "Producto número 1",
            "modelName": "Modelo Prueba",
            "description": "Descrpción del producto número 1",
            "brandName": "Marca1",
            "itemCodeSupplier": "Supplier123",
            "unitMeasurementCode": "94",
            "unitMeasurementName": "Unidad",
            "price": 10000,
            "quantity": 5,
            "discountAmount": 5000,
            "chargeAmount": 5000,
            "standardType": "001",
            "standardCode": "10101501",
            "discounts": [
                {
                    "name": "Descuento por volumen",
                    "type": "P",
                    "rate": 10,
                    "amount": 1000
                }
            ],
            "charges": [
                {
                    "name": "Costo de envío",
                    "type": "F",
                    "rate": 1000,
                    "amount": 1000
                }
            ],
            "taxes": [
                {
                    "name": "IVA",
                    "code": "01",
                    "type": "P",
                    "rate": 19,
                    "amount": 1900,
                    "base": 10000
                }
            ],
            "withholdings": [
                {
                    "name": "ReteIVA",
                    "code": "05",
                    "type": "P",
                    "rate": 15,
                    "amount": 285,
                    "base": 1900
                }
            ]
        }
    ],
    "totals": {
        "amount": 50000,
        "prepaymentAmount": 0,
        "taxesAmount": 9500,
        "withholdingAmount": 1425,
        "discountsAmount": 0,
        "chargesAmount": 0
    },
    "notes": [
        "Nota importante 1",
        "Nota importante 2"
    ],
    "remark": "Comentarios adicionales",
    "conceptCode": "1",
    "invoicePrefix": "FAC",
    "invoiceConsecutive": 123456,
    "invoiceCuv": "fe9a3a7a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
    "invoiceIssuedAt": "2026-03-10",
    "invoiceSequence": "FAC123456"
}'
Respuesta Ejemplo de Respuesta
{}
Modificado en 2026-06-03 14:46:56
Anterior
Consultar por prefijo y consecutivo
Siguiente
Consultar por ID
Built with