Notas de crédito (NDC)

¿Qué son las notas de crédito?

Las notas de crédito (NDC) son incentivos que una empresa puede otorgar a sus clientes para futuras compras. Funcionan como un método de pago que el cliente puede usar más adelante.

Dependiendo de la empresa, estos incentivos pueden llamarse:

• Bonos
• Vales
• Recompensas
• Notas de crédito

En Handy, utilizamos el término Notas de Crédito (NDC) para unificar este concepto.

¿Para qué sirven?

Las NDC permiten:

• Premiar a clientes por compras o promociones
• Ofrecer incentivos comerciales
• Gestionar saldos a favor de clientes

Una vez creadas, los clientes pueden usarlas como parte del pago en:

• Entregas
• Ventas en ruta

OJO: no funcionan o se aplican durante el proceso de preventa.

📋 Estados operativos de una nota de crédito

Cada NDC puede encontrarse en uno de los siguientes estados:

• Activa: disponible para usar
• Vencida: ya pasó su fecha de expiración
• Cancelada: fue cancelada manualmente
• Usada: ya se consumió completamente

Puedes filtrarlas desde el listado según:

• Fecha
• Cliente
• Estado
• Si están activas

⏰ Todos los días a las 2:00 AM:

• El sistema revisa las NDC por fecha y cambia su estado a Vencidas.
• Evita que se utilicen durante el día.

➕ ¿Cómo dar de alta una NDC?

Las NDC pueden generarse de tres formas:

• De manera individual en web.
• Importando un archivo Excel.
• Mediante API (más abajo te dejamos los detalles)

🔹 Cada nota:

• Tiene un código único.
• Puede autogenerarse si no se envía uno.
• Solo puede recibir saldo una vez al crearse.

👤 Visualización en el perfil del cliente

En el detalle del cliente podrás ver:

• Todas sus NDC activas
• El saldo total disponible

En la app móvil:

• Se muestra el saldo disponible
• Puedes acceder al listado completo tocando el monto.

🛒 Uso en ventas en ruta

• Se pueden aplicar NDC al crear una venta.
• No pueden superar el monto total, se tiene que utilizar completa, o no aplica.
• No te permite quedarle debiendo al usuario parte de la NDC.
• Aplican tanto para contado, como crédito.

💡 También:

• Se registran en el historial
• Afectan el saldo del cliente
• Aparecen en los tickets

🔄 Reversión en ventas

Cuando una venta en ruta se elimina o edita:

• Las NDC aplicadas se eliminan de la venta.
• El saldo se restaura.
• La NDC vuelve a estado Activa, para utilizarse posteriormente.

🚚 Impacto durante el cierre de ruta

Durante el cierre de ruta:

• Se contabilizan todas las NDC usadas
• El monto a recibir disminuye en operaciones de contado.

(Pues del efectivo entrante, una parte de esa venta se pagó con NDC)

** **

📦 Uso en entregas

El comportamiento es muy similar a venta en ruta:

Cuando un cliente tiene NDC disponibles:

• Se mostrará un indicador al confirmar una entrega
• Podrás seleccionar cuáles aplicar

❌ Reglas importantes:

• Siempre se tiene que utilizar el monto total de la NDC, no funciona por partes.
• La suma de NDC nunca puede superar el monto de la entrega.
• Si lo supera, el botón de aplicar se desactiva.

💡 Al aplicarlas:

• Se registra el movimiento en el historial de la NDC
• Se asocian a la entrega
• Se ajusta el saldo del cliente directamente.

🔄 Reversión en entregas

Si una entrega se edita o cancela:

• Y el nuevo monto es menor que las NDC aplicadas.

(siempre se utilizan completas o no se aplican)

• 👉 Se revierten automáticamente.

Esto significa:

• Las NDC vuelven a estar disponibles.
• Se corrige el saldo del cliente.

🔌 API de notas de crédito

Si necesitas integrar este flujo, estos son los endpoints disponibles:

• GET /creditNote → Listado
• GET /creditNote/{id} → Detalle
• POST /creditNote → Crear
• PUT /creditNote/{id} → Editar
• POST /creditNote/cancel/{id} → Cancelar
• DELETE /creditNote/{id} → Eliminar

Ejemplo de creación:

{
  "amount": 400.0,
  "customerId": 2,
  "externalId": 111,
  "origin": "Odoo",
  "expirationDate": "31/03/2026 23:59:59"
}

Consideraciones:

• Solo puedes editar el monto si no ha sido utilizada
• Si ya tiene uso:
• • No se puede editar
  • No se puede cancelar
  • No se puede eliminar

Si tienes alguna duda sobre esta funcionalidad, estamos en el chat para ayudarte.☺️

Actualizado el: 22/04/2026