Расхождение появляется, когда каждая строка округляет бонусы отдельно, а итоговый экран считает процент от общей суммы. Выберите один алгоритм: либо бонусы от итоговой eligible-суммы с последующим распределением, либо сумма строк с единым правилом. Оба результата допустимы только если правило явно закреплено и одинаково во всех сервисах.

Деньги храните в minor units, а промежуточный бонусный коэффициент — как decimal или рациональное число. Commercetools различает cent precision и high precision money и позволяет задавать HalfEven, HalfUp или HalfDown; это наглядно показывает, почему имя режима должно быть частью версии расчёта.

Маленький заказ показывает большую проблему

СтрокаEligible amount1,5% точноОкругление HalfUp
A1,000,0150,02
B1,000,0150,02
C1,000,0150,02
Итого по строкам3,000,0450,06
От общего итога3,000,0450,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 и ожидаемого распределения. Имя клиента, товары и платёжные реквизиты не влияют на математику.

Проверенные источники