Один переключатель «доставлено» не описывает частичную выдачу. Курьеру нужен результат по строкам: сколько передано клиенту, что осталось и по какой причине. Начните с модели документа, а не с новой кнопки. Если сервер хранит только общий конечный статус, интерфейс частичного подтверждения всё равно потеряет смысл операции.
Условный заказ содержит три одинаковых изделия, клиент принял два. Результат — две подтверждённые единицы выдачи и одна с отдельным дальнейшим исходом. Не превращайте остаток автоматически в возврат на склад, пока предусмотренная приёмка не состоялась. Эта статья про учёт выдачи; денежные, кассовые и юридические последствия согласуются отдельно.
Остаток получает действие, а не пропадает
| Исход строки | Что фиксируем | Чего не делаем автоматически |
|---|---|---|
| Выдано частично | Фактическое количество и попытку | Не закрываем всё заказанное |
| Остаток в машине | Количество и предусмотренный следующий шаг | Не добавляем на склад |
| Перенос остатка | Новую согласованную попытку | Не повторяем уже выданные единицы |
| Отказ от остатка | Причину по процессу и маршрут возврата | Не подменяем физическую приёмку |
Заказанное, погруженное, выданное и принятое обратно — разные величины. Недостаточно потребовать «выдано не больше заказанного», если часть товара уже выдавалась в предыдущей попытке. Проверка должна учитывать накопленные подтверждения и количество именно текущей операции. Для разных единиц товара применяются свои правила точности.
Подтверждение относится к одной попытке и ревизии
Условная команда подтверждения:
delivery_attempt: <тестовая попытка>
line_id: <строка заказа>
delivered_now: 2
expected_revision: <прочитанная версия>
operation_id: <стабильный ID>
remainder_action: <согласованный исход>PostgreSQL 18 позволяет ограничить UPDATE условием WHERE и получить изменённые строки через RETURNING. Проверено 13 октября 2026 года. В приложении это можно использовать для проверки ожидаемой ревизии. Пример выше — условный договор операции, не готовый запрос к вашей базе; контроль количества и связей всех строк проектируется отдельно.
Если диспетчер изменил задание, пока курьер заполнял форму, старое подтверждение не должно молча заменить новую версию. Сервер возвращает конфликт, интерфейс сохраняет введённые количества и показывает актуальное состояние для согласования. Автоматически подставить новую ревизию и отправить всё снова означает обойти контроль.
Кнопка могла сработать, но ответ потерялся. Повтор с прежним operation_id должен найти подтверждённый результат, не прибавляя ещё две единицы. При том же ID и другом количестве нужен конфликт. В режиме без сети интерфейс отличает локальный черновик от подтверждённой сервером выдачи; надпись «сохранено» не должна обещать больше известного.
Приёмка читает следующий маршрут остатка
- Выдать две единицы из трёх на стенде.
- Прочитать историю и открытое количество.
- Повторить операцию после имитации потери ответа.
- Изменить задание параллельно и разрешить конфликт.
- Провести согласованный возврат или новую попытку остатка.
Склад, диспетчер и клиентский экран должны использовать один подтверждённый результат. Событие частичной выдачи не заменяется общим «доставлено» при переводе во внешнюю систему. Если внешний API не умеет частичный исход, выберите и документируйте поддерживаемое представление, оставив детали внутри; неизвестное сопоставление не закрывает заказ наугад.
Доказательство выдачи связывайте с попыткой и строками, к которым оно относится. Не требуйте лишние фотографии или персональные сведения ради технической проверки: тест можно провести без реального клиента. Исправление старого подтверждения проходит отдельный разрешённый процесс с историей причины, а не редактирование количества задним числом без следа.
Для передачи разработчику подготовьте схему количеств, состояния попытки и обезличенный повтор одной команды. Откат новой формы сохраняет уже принятые частичные результаты; прежний экран не получает права превратить их в полную выдачу. Готовность подтверждается цепочкой: две единицы выданы, одна имеет объяснимый дальнейший путь, повтор ничего не удвоил.