Для передачи Экспресс-заказа Яндекс Маркета курьеру предусмотрена проверка кода подтверждения через API. Готовность заказа и успешная проверка кода — два отдельных шага. Наличие упакованного товара у двери не означает, что интеграция уже подтвердила передачу нужному получателю.

Подготовить заказ до прихода курьера

Официальная последовательность начинается с получения сведений о заказе и подготовки необходимых данных экземпляров. Затем заказ упаковывают, получают ярлыки методом delivery/labels и наклеивают их. Перевод в PROCESSING с подстатусом READY_TO_SHIP обозначает готовность к отгрузке.

Если магазин использует собственный номер заказа, передать внешний идентификатор можно на этапе PROCESSING/STARTED. Это помогает связать внутреннюю сборочную ведомость с заказом площадки. Не заменяйте при этом идентификатор Маркета своим номером в запросах, которые ожидают orderId: связь нужна для сверки, а не для произвольной подстановки.

Код проверяется до физической передачи

Курьер сообщает код подтверждения. Магазин передаёт его в orders/{orderId}/verifyEac и, по инструкции, отдаёт заказ после успешной проверки. В рабочем интерфейсе полезно явно показывать номер заказа и результат проверки, чтобы сотрудник не ориентировался только на появление курьера в помещении.

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

Что делать с недостачей

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

Разделите ответственность за сборку и выдачу. Сотрудник у точки передачи должен видеть окончательный состав и правильный ярлык; вопрос замены отсутствующего товара нельзя решать произвольно уже при передаче курьеру. Операционное решение должно быть отражено в актуальном заказе до его отправки.

Как проверить рабочее место

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

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