Descuentos y cargos
lines como a nivel de factura.1. Estructura general
discounts como charges se envían como arreglos de objetos con esta estructura:name: nombre o descripción del descuento o cargo.type: forma de aplicación del valor.rate: porcentaje aplicado, solo cuando type es P.amount: valor monetario del descuento o cargo.2. Significado de type
type | Significado | Cómo interpretarlo |
|---|---|---|
P | Porcentaje | El ajuste se define por porcentaje en rate sobre la base correspondiente. |
F | Valor fijo | El ajuste se define por valor fijo en amount. |
1.
P, informa rate con el porcentaje y amount con el valor resultante.2.
F, rate debe ir en 0 y el valor aplicable va en amount.3. A nivel de detalle (lines)
"lines": [
{
"charges": [
{
"name": "Mi cargo",
"type": "F",
"rate": 0,
"amount": 800
}
],
"discounts": [
{
"name": "Mi descuento",
"type": "P",
"rate": 10,
"amount": 500
}
]
}
]800.10 % cuyo valor calculado es 500.4. A nivel de factura
{
"charges": [
{
"name": "Mi cargo",
"type": "F",
"rate": 0,
"amount": 800
}
],
"discounts": [
{
"name": "Mi descuento",
"type": "P",
"rate": 10,
"amount": 500
}
]
}800.10 % con valor 500.5. Diferencia entre nivel detalle y nivel factura
lines[].discounts y lines[].charges): aplica solo al ítem donde lo informas.discounts y charges en raíz): aplica al total del documento.6. Propinas (tip)
tip y solo aplica a nivel de factura.{
"tip": {
"base": 50000,
"rate": 10,
"amount": 5000
}
}tip:10 % del valor total de la factura.base corresponde al valor sobre el cual se calcula la propina.rate corresponde al porcentaje aplicado.amount corresponde al valor calculado de la propina.50000.10 %.5000.7. Validaciones recomendadas
type en P o F.name vacío.amount negativo.type es P, valida rate mayor que 0.type es F, permite rate en 0.amount corresponda al cálculo esperado cuando type sea P.tip, valida que rate sea mayor que 0 y menor o igual a 10.tip, valida que amount corresponda al porcentaje aplicado sobre base.tip, valida que exista solo a nivel de factura.8. Errores comunes
type diferente de P o F.type en P con rate en 0.amount que es el valor monetario con rate que es el porcentaje.lines.10 % del total de la factura.9. Checklist rápido
type corresponde al comportamiento esperado, P o F.rate y amount son coherentes.tip, está solo a nivel factura y no supera el 10 %.Modificado en 2026-05-22 20:41:16