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

Условный заказ содержит три одинаковых изделия, клиент принял два. Результат — две подтверждённые единицы выдачи и одна с отдельным дальнейшим исходом. Не превращайте остаток автоматически в возврат на склад, пока предусмотренная приёмка не состоялась. Эта статья про учёт выдачи; денежные, кассовые и юридические последствия согласуются отдельно.

Остаток получает действие, а не пропадает

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

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

Подтверждение относится к одной попытке и ревизии

Условная команда подтверждения:
delivery_attempt: <тестовая попытка>
line_id: <строка заказа>
delivered_now: 2
expected_revision: <прочитанная версия>
operation_id: <стабильный ID>
remainder_action: <согласованный исход>

PostgreSQL 18 позволяет ограничить UPDATE условием WHERE и получить изменённые строки через RETURNING. Проверено 13 октября 2026 года. В приложении это можно использовать для проверки ожидаемой ревизии. Пример выше — условный договор операции, не готовый запрос к вашей базе; контроль количества и связей всех строк проектируется отдельно.

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

Кнопка могла сработать, но ответ потерялся. Повтор с прежним operation_id должен найти подтверждённый результат, не прибавляя ещё две единицы. При том же ID и другом количестве нужен конфликт. В режиме без сети интерфейс отличает локальный черновик от подтверждённой сервером выдачи; надпись «сохранено» не должна обещать больше известного.

Приёмка читает следующий маршрут остатка

  1. Выдать две единицы из трёх на стенде.
  2. Прочитать историю и открытое количество.
  3. Повторить операцию после имитации потери ответа.
  4. Изменить задание параллельно и разрешить конфликт.
  5. Провести согласованный возврат или новую попытку остатка.

Склад, диспетчер и клиентский экран должны использовать один подтверждённый результат. Событие частичной выдачи не заменяется общим «доставлено» при переводе во внешнюю систему. Если внешний API не умеет частичный исход, выберите и документируйте поддерживаемое представление, оставив детали внутри; неизвестное сопоставление не закрывает заказ наугад.

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

Для передачи разработчику подготовьте схему количеств, состояния попытки и обезличенный повтор одной команды. Откат новой формы сохраняет уже принятые частичные результаты; прежний экран не получает права превратить их в полную выдачу. Готовность подтверждается цепочкой: две единицы выданы, одна имеет объяснимый дальнейший путь, повтор ничего не удвоил.

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