¿Qué es una nota de débito electrónica?

Es uno de los seis comprobantes electrónicos de Hacienda v4.4 (código 02, Nota de Débito Electrónica). Sirve para incrementar el monto de un comprobante que ya emitiste y que Hacienda ya aceptó. Como una factura electrónica aceptada es inmutable —no se edita ni se reemite—, la nota de débito es el mecanismo formal para cobrar algo de más sobre esa venta anterior.

Al igual que la nota de crédito, siempre referencia el documento original (por su clave de 50 dígitos o su número). Sin esa referencia, Hacienda la rechaza: una nota de débito no vive sola, siempre corrige a alguien.

Emitís una nota de débito cuando, después de facturar, necesitás cobrarle más al mismo cliente por esa misma venta. Los casos típicos:

• Intereses por mora cuando el cliente paga una factura a crédito fuera de plazo.
• Un cargo que se omitió en la factura original (un flete, una comisión, una gestión de cobro).
• Un ajuste al alza de precio pactado después de emitida la factura.
• Diferencias de cambio a favor del emisor sobre una venta ya documentada.

La confusión más común es usar una nota de crédito para «corregir hacia arriba». No: la nota de crédito solo va hacia abajo (resta, devuelve o anula). Si el monto sube, la herramienta es la nota de débito. Este cuadro lo resume:

En la versión 4.4 (obligatoria desde el 1 de setiembre de 2025, con prórroga desde junio) la nota de débito conserva los mismos requisitos estructurales que cualquier comprobante: clave numérica de 50 dígitos, consecutivo de 20, firma XAdES-EPES con tu certificado .p12 y envío a Hacienda. Lo propio de la nota de débito es la referencia obligatoria al documento que corrige, con cuatro datos: tipo de documento referenciado, su número/clave, la fecha de emisión y un código de referencia con la razón del ajuste.

No emitir cuando corresponde —o dejar diferencias sin documentar— cae dentro de las infracciones de los artículos 83 y 86 del Código de Normas y Procedimientos Tributarios, con multas que pueden llegar a 100 salarios base y cierre del negocio. Documentar el cargo con su nota de débito es, además de correcto, la forma de dejarlo respaldado ante Hacienda.

Igual que cualquier otro comprobante: un POST a /api/nota-debito (o al endpoint genérico /api/procesar con tipo_documento: "02"), agregando el objeto referencia al documento original. Nosotros armamos el XML v4.4, lo firmamos con XAdES, lo enviamos a Hacienda y le mandamos al receptor el PDF y los XML por correo. Vos solo declarás el cargo.

curl -X POST 'https://api.plaxp.com/api/nota-debito' \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $PLAXP_API_KEY" \
  -d '{
    "tipo_documento": "02",
    "codigo_sucursal": "001",
    "codigo_caja": "001",
    "consecutivo": 87,
    "condicion_venta": "01",
    "medios_pago": [{ "tipo": "01", "monto": 5650 }],
    "receptor": {
      "tipo_identificacion": "02",
      "identificacion": "3101123456",
      "nombre": "Constructora El Roble S.A.",
      "correo": "[email protected]"
    },
    "referencia": {
      "tipo_doc": "01",
      "numero": "50601070226310112345600100001010000000870199999999",
      "fecha_emision": "2026-07-02T10:15:00-06:00",
      "codigo": "02",
      "razon": "Cargo por gestion omitida en la factura original"
    },
    "lineas": [{
      "codigo_cabys": "8511000000000",
      "detalle": "Cargo por gestion de cobro",
      "cantidad": 1,
      "precio_unitario": 5000,
      "codigo_tarifa": "08",
      "tarifa": 13
    }]
  }'

La respuesta es HTTP 202: recibís la clave y el consecutivo al instante, mientras la firma y el envío ocurren en background. Para saber si Hacienda la aceptó, consultás el estado por la clave — nosotros hacemos el polling contra Hacienda por vos. Y si sale rechazada, el catálogo de errores de Hacienda te dice qué corregir.

¿Preferís no tocar código? La nota de débito también se emite desde el panel: elegís el documento original, indicás el cargo y Plaxp arma la referencia sola. Los detalles del flujo por API están en la documentación de la API.