Создание LaaS-заказа Маркета: как не потерять резерв до подтверждения
Как оформить реальный заказ фулфилмента Маркета через API: выбрать доставку, подтвердить резерв в течение часа и сохранить все номера заказов по складам.
Содержание статьи
Создание заказа в фулфилменте Яндекс Маркета нужно связать с подтверждением покупки на собственном сайте. Если интеграция оставит реальный заказ черновиком, он не начнёт обычную обработку и может быть отменён. Ниже разобран действующий API модели LaaS; документация проверена 18 октября 2026 года. Это инструкция по операции, а не сообщение о запуске функции.
Подготовьте доступную доставку и состав покупки
Метод создания заказа работает при наличии нужного количества товара на складе Маркета. До его вызова получают доступные варианты доставки. В запрос передают выбранный вариант: курьерскую доставку либо пункт выдачи, но не оба способа одновременно.
Редакционная рекомендация — хранить выбранный покупателем маршрут вместе с составом корзины. Если сотрудник изменил адрес или товары после расчёта, нельзя без проверки использовать старое предложение доставки. Для оператора полезно показывать, какие исходные данные были проверены и какое изменение требует повторного расчёта.
Отдельно сопоставьте артикулы внешнего сайта и складского каталога. Общий запас не исправляет ошибку такого соответствия: организационные границы описаны в материале об общем стоке FBY и LaaS.
Выберите осмысленный момент подтверждения
При draft=true Маркет создаёт заказ в RESERVED. Его нужно перевести в PROCESSING с подстатусом STARTED в течение часа, иначе площадка отменит заказ. При draft=false обработка начинается без дополнительного подтверждения.
До внедрения определите событие, которое разрешает подтверждение: например, завершение внутренней проверки оплаченной покупки. Это решение процесса магазина, а не универсальное требование Маркета. Назначьте ответственного за зависший резерв и показывайте оставшееся время сотруднику, который может разобраться с покупкой. Обычная очередь поддержки без такого контроля способна обнаружить проблему уже после отмены.
Сохраните все созданные номера
Ответ метода содержит список заказов: при исполнении с разных складов создаётся отдельный заказ для каждого склада. Поэтому связь внешней покупки с Маркетом нельзя ограничивать одним полем, которое каждый следующий номер перезаписывает.
Условный пример: две позиции покупателя отправляются с разных складов. Внутренний заказ остаётся единым, но менеджеру нужны обе записи исполнения. Иначе первая посылка может выглядеть как полностью завершённая покупка, хотя движение второй ещё продолжается. Сохраните состав каждой части и доступную связь с исходной корзиной.
Примите интеграцию по завершённому циклу
Проверьте создание, сохранение номеров, подтверждение и последующее отображение статусов. При потере ответа сначала установите, что произошло на стороне Маркета; отсутствие записи в локальном журнале не доказывает, что заказ не появился.
Тестовый признак fake и черновик draft имеют разное назначение. Тестовый заказ не отгружается и не меняет остатки, поэтому он не подтверждает реальное движение запасов. Результатом приёмки должны стать понятные действия при незавершённом резерве и корректный учёт всех частей заказа.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы