Расхождение появляется, когда каждая строка округляет бонусы отдельно, а итоговый экран считает процент от общей суммы. Выберите один алгоритм: либо бонусы от итоговой eligible-суммы с последующим распределением, либо сумма строк с единым правилом. Оба результата допустимы только если правило явно закреплено и одинаково во всех сервисах.
Деньги храните в minor units, а промежуточный бонусный коэффициент — как decimal или рациональное число. Commercetools различает cent precision и high precision money и позволяет задавать HalfEven, HalfUp или HalfDown; это наглядно показывает, почему имя режима должно быть частью версии расчёта.
Маленький заказ показывает большую проблему
| Строка | Eligible amount | 1,5% точно | Округление HalfUp |
|---|---|---|---|
| A | 1,00 | 0,015 | 0,02 |
| B | 1,00 | 0,015 | 0,02 |
| C | 1,00 | 0,015 | 0,02 |
| Итого по строкам | 3,00 | 0,045 | 0,06 |
| От общего итога | 3,00 | 0,045 | 0,05 |
Разница в одну минимальную единицу не является случайным шумом: она повторяется массово и ломает сверку. Нельзя «подправить» total после расчёта без записи, какая строка получила остаток.
Алгоритм сначала получает eligible base
eligible_minor = sum(line.net_minor for eligible lines)
raw_points = eligible_minor * rate_numerator / rate_denominator
awarded_points = round(raw_points, mode = HALF_EVEN)
shares = largest_remainder(
total = awarded_points,
weights = eligible line net amounts,
tie_breaker = stable line_id
)
assert sum(shares) == awarded_pointsМетод наибольших остатков распределяет уже утверждённый total: сначала целая часть доли, затем оставшиеся единицы строкам с наибольшей дробной частью. Стабильный tie-breaker обязателен, иначе одинаковый заказ даст разные строки при повторе.
Бонус и деньги имеют разные шкалы
Если один бонус равен одному рублю, это всё равно две сущности: денежный minor unit и loyalty point. Для валют без двух десятичных знаков масштаб отличается; Stripe, например, требует передавать amount в minor unit конкретной валюты и отдельно перечисляет zero-decimal currencies.
- Не используйте binary float для сохраняемого финансового результата.
- Запишите rate, rounding mode, eligible base и calculator version в snapshot заказа.
- Скидки применяйте до или после начисления только по одному зафиксированному правилу.
- У исключённых товаров храните reason, а не просто нулевое начисление.
- Параллельное повторное подтверждение заказа закрывайте idempotency key.
Возврат использует сохранённое распределение
При возврате одной позиции снимайте не заново вычисленный процент, а начисление, которое действительно было закреплено за этой строкой. Для частичного количества используйте то же правило остатка и не позволяйте суммарному списанию превысить исходно начисленные points.
Если бонусы уже потрачены, финансовая операция и loyalty adjustment должны иметь отдельные статусы. Отрицательный баланс, ограничение возврата или ручная корректировка — продуктовые решения; их нельзя прятать внутри нового округления.
Инварианты ловят ошибку раньше отчёта
Проверьте значения точно на половине единицы, нулевую цену, три одинаковые строки, большую корзину, разные валютные fraction digits и повтор расчёта. Инварианты: сумма shares равна awarded points, total не отрицателен, возвраты не превышают начисление, одинаковый snapshot даёт одинаковый результат.
Для анализа достаточно calculator version, обезличенных line amounts, rate, rounding mode и ожидаемого распределения. Имя клиента, товары и платёжные реквизиты не влияют на математику.