Не переводите заказ в Received кнопкой из базы. Сначала возьмите один transfer ID и по каждой строке выпишите ordered_qty, shipped_qty, received_qty, canceled_qty и единицу измерения. Если товар физически приехал, но received_qty равен нулю, нужно восстановить событие приёмки; ручная смена заголовка скроет расхождение и оставит количество в виртуальном складе transit.

Состояние «в пути» — нормальная отдельная позиция товара между списанием источника и приходом назначения. Проблема начинается, когда сумма движений не объясняет текущее количество или header говорит одно, а строки другое. Поэтому главным доказательством служат движения и их ключи, а статус заголовка вычисляется из строк.

Три остатка должны сходиться в один баланс

transfer_line: TR-1042 / SKU-77
ordered_qty: 12

SHIP source -> transit      10  event=ship-884
RECEIVE transit -> dest      6  event=recv-901
RECEIVE transit -> dest      4  event=recv-915

source_delta  = -10
transit_delta = +10 - 6 - 4 = 0
dest_delta    = +6 + 4 = +10
line_status   = received

Microsoft Dynamics 365 отражает переход transfer order в Shipped после отгрузки и в Received после приёмки; при этом видны shipped quantity и статусы строк. Эта модель полезна и в собственной системе: частичная приёмка меняет количество конкретной строки, но не позволяет объявить весь документ завершённым раньше времени.

Симптом подсказывает, на каком шаге потерялось событие

НаблюдениеВероятная причинаЧто сравнить
В destination товар есть, transfer in_transitПриход записан вне workflowStock ledger и receive event ID
Received меньше фактаЧастичный scan не завершил postingLicense plate, строки и background job
Received больше shippedПовтор webhook или мобильной командыIdempotency key и duplicate events
Все строки received, header shippedНе сработала агрегация статусаOutbox/job и последняя ошибка
Количество верное только в одной единицеРазный conversion factorBase UOM и правило округления
Строка закрыта, transit не нольCancellation не создал обратное движениеCancel event и compensating entry

В системах с мобильной приёмкой отдельно проверьте registration, putaway work и posting. Документация Dynamics описывает конфигурацию, где мобильное получение и финансовая фоновая обработка разделены, а также сценарии частичной приёмки с несколькими license plates. Экран мог подтвердить физический scan, хотя последующий этап ещё не завершил документ.

Восстановление начинается с неизменяемого журнала

  1. Остановить новые действия только для спорного transfer ID, не блокируя весь склад.
  2. Снять snapshot строк документа, inventory ledger, mobile scans, outbox и ошибок фоновых задач.
  3. Сопоставить каждое физическое действие со стабильным event ID и количеством в base unit.
  4. Повторно обработать непроведённое событие с прежним idempotency key или создать помеченное compensating event.
  5. Пересчитать derived status из строк и проверить source, transit и destination balances.
  6. Зафиксировать причину ручного восстановления и снять локальную блокировку документа.

Не удаляйте уже проведённую приёмку, чтобы «нажать ещё раз». Если внешний запрос завершился, а ответ потерялся, повтор без дедупликации оприходует товар второй раз. Таблица processed_commands с UNIQUE по warehouse, transfer_id и command_id позволяет вернуть прежний результат на повтор.

Параллельная приёмка не должна принять больше отгруженного

Два терминала могут одновременно увидеть remaining_qty = 4 и оба принять по четыре. В транзакции блокируйте строку transfer_line через SELECT FOR UPDATE либо выполняйте условный UPDATE, который проходит только при received_qty + incoming_qty <= shipped_qty. PostgreSQL удерживает row-level lock до конца транзакции; внешние вызовы под ним делать нельзя, иначе короткая складская операция превратится в длинную очередь.

  • Одна команда содержит transfer ID, line ID, base quantity и command ID.
  • Повтор команды возвращает сохранённый результат без нового ledger entry.
  • Header status считается после commit движений, а не до него.
  • Timeout фоновой задачи оставляет событие retryable, но не создаёт новый identity.
  • Метрика показывает возраст старейшего in_transit и ненулевые balances закрытых строк.

Приёмка исправления на одном документе

Прогоните полную, частичную и повторную приёмку, затем два параллельных запроса на последний остаток. Для каждого сценария сохраните ledger entries и итоговые количества трёх локаций. Исправление готово, когда ни одна строка не принимает больше shipped_qty, закрытый transfer имеет нулевой transit, повтор command ID ничего не меняет, а status восстанавливается из журнала без ручного UPDATE.

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