Старый заказ меняется потому, что экран или отчёт заново умножает исходную цену на текущий курс. На этапе подтверждения сохраните денежный снимок: сумму в валюте покупателя, сумму учёта, валютные коды, применённый rate, правило округления, источник и timestamp. После этого обновление справочника влияет только на новые расчёты.
Не восстанавливайте прошлый курс «примерно по дате», если зафиксированной записи нет. Сначала остановите дальнейший пересчёт, сохраните имеющиеся платежные и документальные суммы, а спорные заказы пометьте для сверки. Изменение финансовой истории требует отдельной корректировки, а не тихого UPDATE.
В заказе остаются значения сделки
| Поле | Пример | Зачем хранить |
|---|---|---|
| presentment_amount | 89.90 EUR | Сумма, показанная и предъявленная покупателю |
| shop_amount | 9804.17 RUB | Сумма внутреннего учёта на момент заказа |
| applied_rate | 109.0564 | Объясняет преобразование без обращения к latest |
| rate_source | provider/reference/manual | Позволяет воспроизвести правило продукта |
| rate_observed_at | ISO 8601 timestamp | Отделяет момент котировки от создания записи |
| rounding_policy | line HalfUp 2 digits | Объясняет копеечные расхождения |
| pricing_version | 2026-09-30.3 | Связывает результат с версией calculator |
Shopify в объекте Order различает shop money и presentment money, а также исходные и текущие итоги после изменений и возвратов. Это полезная модель: финансовый факт хранится в заказе, а не выводится каждый раз из живого каталога.
Снимок создаётся в одной границе подтверждения
order_money_snapshot = {
presentment: { amount: "89.90", currency: "EUR" },
shop: { amount: "9804.17", currency: "RUB" },
rate: "109.0564",
rate_direction: "RUB_PER_EUR",
rate_source: "provider-quote",
observed_at: "2026-09-30T11:58:10Z",
pricing_version: "2026-09-30.3"
}Сохраняйте snapshot в той же транзакционной границе, где заказ получает подтверждённую версию. Если payment provider окончательно фиксирует сумму позже, запишите отдельный settlement snapshot: это другой факт, и он не должен перезаписывать цену для покупателя.
Направление курса подписывают явно
Число 109.0564 бесполезно без пары и направления. Поля base/quote либо имя RUB_PER_EUR предотвращают обратное деление. Decimal precision выбирайте шире, чем у конечной валюты; округляйте в обозначенной точке — по строке или по итогу — и сохраняйте полученный minor amount.
- Не используйте float для денег и курса в сохранённом результате.
- Не смешивайте reference rate с фактическим rate платёжного провайдера.
- Не меняйте currency code без миграции связанных сумм.
- Не пересчитывайте исходный total при открытии заказа в другой локали.
- Для refund заранее определите: возвращается исходная presentment amount или сумма по правилам провайдера.
Исправление данных начинается с источника истины
Для уже изменившихся заказов сопоставьте payment transaction, чек, invoice, письмо подтверждения и audit log. Если два независимых источника совпадают, используйте их как основание восстановления. Если оснований нет, не генерируйте фиктивный rate: сохраните known amount и признак unknown_rate.
Миграцию выполняйте пакетами с dry run: сначала отчёт order ID → old value → proposed value → evidence, затем согласование и только после этого запись. Каждый исправленный заказ получает audit entry и возможность отката к исходной строке.
Регрессия проверяет вчера и завтра
Создайте заказ по rate A, обновите справочник до rate B и снова откройте заказ, PDF и отчёт. Старый snapshot должен остаться A; новая корзина — получить B. Затем проведите частичный refund и убедитесь, что исходная и текущая суммы различаются осознанно.
Для ревью подготовьте схему денежных полей, один обезличенный заказ, источник rate и точку округления. Реальные реквизиты покупателя, идентификаторы платежа и банковские данные замените.