Emitir ND

Caso: un cliente entró en mora y corresponde cobrarle intereses sobre una factura ya aceptada. La Nota de Débito (ND) referencia la FE original y agrega un cargo adicional.

Para que la ND sea válida, el producto que cobra el interés (en el ejemplo, idProducto: 999) debe estar dado de alta en el catálogo, idealmente como “Intereses moratorios” o equivalente.

{
  "tipo": "NotaDebito",
  "idUsuario": 7,
  "cliente": { "idCliente": 42 },
  "condicionVenta": "01",
  "medioPago": "01",
  "moneda": "CRC",
  "lineas": [
    { "idProducto": 999, "cantidad": 1, "precioUnitario": 5000.00 }
  ],
  "referencias": [
    {
      "tipoDocumento": "01",
      "numero": "<clave_factura_original>",
      "codigo": "10",
      "razon": "Cargo por interés moratorio 30 días"
    }
  ]
}

El código de motivo

10 es nota de débito financiera: el código que corresponde a intereses, moras y cargos adicionales. 04 (referencia a otro documento) también es válido como vínculo genérico.

No usar 01 en una ND salvo que se quiera exactamente eso: además de declarar que la nota anula el documento referenciado, 01 es el único código con el que una nota de débito descuenta inventario.

El código va en codigo o en razon, indistintamente. Una referencia con solo texto libre en ambos campos se rechaza con 400. Ver código de referencia.

Precio del cargo

El ejemplo envía precioUnitario porque el monto del interés se calcula por fuera y no sale del catálogo. Es lo recomendable para una ND.

Si se omite precioUnitario, se usa el precio de lista del producto — convertido a la moneda de la nota si el catálogo está escrito en otra. Ver multi-moneda.

Moneda

La ND hereda la moneda y el tipo de cambio del documento que referencia, aunque el request envíe otros. Hacienda exige que coincidan y rechaza si no (errores -510 y -511).

El producto 999 del ejemplo debe existir previamente en el catálogo. Si aún no está registrado, debe crearse antes de intentar emitir la ND.