Hola equipo de Alegra,
Estoy intentando implementar descuentos en facturas de venta a través de la API y la documentación actual no es clara en este punto.
Ya he probado distintas estructuras y parámetros según la documentación, pero en todos los casos el descuento no se refleja correctamente en la factura generada.
¿Podrían por favor indicarme:
- Cuál es la forma correcta de enviar descuentos vía API
- Qué campos exactos deben usarse (nombre, tipo de dato, ubicación dentro del request)
- Si existe alguna limitación o condición especial para que estos descuentos se apliquen correctamente
Si tienen un ejemplo funcional de request (idealmente en JSON), sería de gran ayuda.
Quedo atento, gracias.
Hola, un gusto saludarte.
Entiendo perfectamente que la implementación de descuentos es un punto crítico para tu integración. Tras validar la documentación técnica, te confirmo que actualmente los descuentos en el API de Alegra se manejan exclusivamente a nivel de ítem. No es posible aplicar un descuento global sobre el total de la factura de forma directa en un solo campo del encabezado.
Para que el descuento se refleje correctamente en la factura, debe incluirse dentro del arreglo de objetos de la propiedad items.
Campos exactos para descuentos:
discount: Nombre del campo.
Tipo de dato: Number (Decimal).
Lógica: Representa el porcentaje de descuento a aplicar sobre el precio del ítem (ej. para un 10% de descuento, el valor debe ser 10).
Ubicación: Dentro de cada objeto del array items.
Limitaciones y condiciones especiales:
Cálculo por ítem: Al ser un descuento por línea, el API restará el porcentaje indicado al price antes de calcular los impuestos asociados a dicho ítem.
Persistencia: Si el campo se envía como null o se omite, el sistema asumirá un descuento de 0.
Ejemplo funcional del array de item con descuento:
“client”: “1”,
“items”: [
{
“id”: “1”,
“price”: 100000,
“quantity”: 1,
“discount”: 10,
“tax”: [
{
“id”: “1”
}
]
}
]
En este ejemplo, el sistema aplicará un 10% de descuento al producto, dejando la base imponible en 90,000 para el cálculo de impuestos.
Enlace de documentación: Crear factura de venta