Импортированный остаток часто описывает склад на момент выгрузки, а не на момент окончания загрузки. Если между этими моментами прошла продажа, простая замена числа возвращает уже списанный товар. Перед повторным импортом установите время среза и смысл файла: полный снимок, изменения или результат инвентаризации. Эти данные требуют разных правил применения.

Проверку проведите на стенде. Пусть файл содержит 20 штук, затем до его применения проходит списание трёх. Ожидаемый итог зависит от договора источников: при авторитетном снимке до продажи и известных последующих движениях получится 17. Если нельзя доказать границу и состав движений, арифметика «добавим разницу» небезопасна — нужна сверка.

Сначала паспорт загрузки, потом изменение остатка

Условный паспорт снимка:
source: <согласованный источник>
snapshot_id: <стабильный ID>
cutoff: <момент или позиция журнала>
warehouse: <явный склад>
mode: absolute_snapshot
apply_result: accepted / conflict / rejected

Часы двух систем могут расходиться, а сообщения приходить с задержкой. Когда интеграция предоставляет последовательность или позицию журнала, используйте её по документированному договору вместо догадки по времени получения файла. Отдельно объясните, что означает отсутствующая строка: нулевой остаток, неподдерживаемый товар или товар вне выборки. Нельзя превращать её в ноль по умолчанию.

Три способа разрулить конкуренцию

ПодходКогда применимОграничение
Отказ при изменении ревизииЕсть версия остатка на исходной границеНужен разбор конфликтующей строки
Снимок плюс последующие движенияЕсть полный журнал после срезаПропущенное движение искажает итог
Согласованное окно загрузкиДопустима краткая управляемая паузаВнешние операции нельзя забыть

Не вычитайте продажу повторно, если поставщик уже включил её в свой снимок. Состав среза должен быть проверяемым по идентичности операции. Условный журнал показывает одну продажу, но два уведомления о ней: это одно движение с повтором доставки. Повтор файла с прежним snapshot_id тоже не должен создавать вторую корректировку.

Разбор файла и проверку справочников удобно выполнять во временном наборе данных. Публикация подготовленного результата — отдельный шаг с проверкой актуальности. Сам факт, что все строки прочитаны без ошибки, ещё не означает, что файл можно применить: пока шёл разбор, склад мог измениться.

Транзакция сама не задаёт границу снимка

В PostgreSQL 18 уровень Read Committed позволяет последовательным запросам одной транзакции видеть разные подтверждённые изменения. Более строгие уровни имеют свои правила и могут требовать повторить транзакцию после конфликта сериализации. Источник проверен 13 октября 2026 года. Поэтому надпись «импорт в транзакции» не доказывает сохранность новых движений; нужны выбранный алгоритм и конкурентный тест.

  1. Снять тестовый снимок исходного остатка.
  2. Провести списание до применения файла.
  3. Применить файл по выбранному договору и объяснить итог.
  4. Повторить тот же файл после потери подтверждения.
  5. Добавить задержанное движение и конфликт одной строки.

Для большой загрузки заранее решите, допускается ли частичный результат. Если одна строка конфликтует, интерфейс должен показать принятые и отклонённые позиции без обещания «всё обновлено». При пакетной обработке сохраняйте контрольную точку и идентичность загрузки: перезапуск продолжает тот же процесс, а не стирает уже прошедшие продажи.

Восстановление после плохого импорта начинается с исходного снимка, журнала применения и подтверждённых движений. Возврат старого файла не является откатом: после него могли случиться новые операции. Передайте владельцу обмена обезличенный паспорт загрузки и цепочку одного товара. Согласуйте ограниченную корректировку расхождения и только затем повторите импорт по исправленному протоколу.

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