Водителя не пускают на склад по одной из двух причин: пропуск не оформили вовсе или оформили не тот. Этим словом на Ozon называются три разных объекта: поставка на склад по FBO, отгрузка перевозки по FBS и вывоз возвратов. У каждого свой путь в кабинете, свой крайний срок и свой набор обязательных полей. Разбираем по официальной справке площадки и по спецификации Seller API.
Оговорка про актуальность. Состояние на 8 сентября 2026 года. Сроки и названия разделов кабинета площадка меняет, поэтому перед отгрузкой сверяйте их со своей заявкой и с текущей справкой.
Сначала про риск: пропуск оформляют в трёх разных местах
Главная ошибка здесь организационная. Продавец помнит про пропуск по поставке, потому что без него заказ не переходит в нужный статус, и забывает про такой же документ по вывозу возвратов, потому что заявка на вывоз живёт в другом разделе кабинета. Машина приезжает, возвраты остаются на складе, рейс оплачен впустую.
| Что оформляем | Где в кабинете | Крайний срок |
|---|---|---|
| Поставка FBO | FBO → Заявки на поставку, заявка в статусе «Заполнение данных» или «Готово к отгрузке» | заполнить не позже чем за 2 часа до поставки |
| Вывоз возвратов | Товародвижение → Складские операции → Заявки на вывоз, столбец «Пропуск» | изменить данные не позже чем за 24 часа до начала отгрузки |
| Отгрузка перевозки FBS | оформляется по перевозке, в API отдельным семейством методов | привязан к слоту перевозки |
Два дедлайна из этой таблицы работают по-разному. Для поставки срок стоит на первичном заполнении: данные автомобиля и водителя вносятся минимум за 2 часа. Для вывоза возвратов справка фиксирует срок именно на изменении: правки принимаются не позже чем за 24 часа до начала отгрузки и только пока заявка находится в одном из трёх статусов: «Необходимо выбрать время отгрузки», «Необходимо указать пропуск», «Готова к отгрузке». Как только заявка выходит из этих статусов, данные водителя заморожены.
Практический вывод: если водителя меняют в день отгрузки, по вывозу возвратов вы уже опоздали. Планировать замену нужно за сутки. Полный порядок работы с заявками на вывоз разбирали в материале про вывоз товаров со склада.
Четыре поля, которые спрашивают всегда
Состав данных одинаковый во всех трёх случаях:
- марка и модель автомобиля;
- номер автомобиля;
- ФИО водителя;
- телефон водителя.
Пропуск по поставке FBO выписывается электронным: скачивать его не нужно, достаточно внести данные в заявку. Кнопка называется «Добавьте данные автомобиля», и рядом с полями есть галочка «Запомнить данные для будущего заполнения»: сохранённый водитель подставится в следующие заявки по клику на поле.
Отдельная грабля касается нескольких машин, и на поставке FBO она работает наоборот. Справка для продавцов маркетплейса говорит прямо: привезти продукцию нужно одной машиной, поэтому указать данные сразу нескольких в одной заявке не получится. Обратное при этом разрешено: несколько поставок можно привезти в одном автомобиле, если они чётко разделены между собой. А вот на вывозе возвратов, где машин в заявке может быть несколько, данные заполняются на каждую, иначе водителя не пропустят.
Важная оговорка про источники. Единый пропуск на несколько заказов, вкладка «Заполнить пропуск» и путь через раздел товародвижения относятся к порталу поставщиков Ozon Retail Center: это другая модель работы, где площадка закупает товар у поставщика. У продавца маркетплейса кабинет другой, и все пути в этой статье даны для него.
Если поставку везёт транспортная компания, держите с ней связь до самой отгрузки: при смене водителя или автомобиля данные в заявке нужно обновить, а если машина не приедет вовремя, на точке отгрузки могут отказать в приёмке. Справка советует заранее прописывать в договоре с перевозчиком условия поставки на склады площадки и неустойку за срыв.
Возвраты той же машиной: флаг, который по умолчанию выключен
В спецификации у пропуска на перевозку есть необязательное поле with_returns с описанием «true, если будете вывозить возвраты» и значением по умолчанию false. Смысл простой: машина, которая привезла отгрузку, может забрать возвраты тем же рейсом, но только если это заявлено заранее.
Дефолт false означает, что по умолчанию обратный груз не запланирован. Документ оформлен, машина приехала, возвраты не отдадут. Флаг доступен и при создании, и при обновлении, поэтому решение можно поменять до отгрузки.
Что именно вы получаете обратно вместе с возвратами и как отличить брак от отказа покупателя, разбирали в материале про приёмку товара.
Что видно в спецификации: девять методов и три семейства
Методы въезда в Seller API разложены по двум разделам документации, и это первое, что путает при интеграции. Шесть методов создания, обновления и удаления плюс список лежат в разделе «Пропуски». Ещё два метода живут в разделе доставки FBO.
| Семейство | Путь создания | Обязательные поля |
|---|---|---|
| Поставка FBO | /v1/supply-order/pass/create |
идентификатор заявки на поставку и четыре поля по машине |
| Перевозка FBS | /v1/carriage/pass/create |
идентификатор перевозки и четыре поля по машине |
| Возврат | /v1/return/pass/create |
семь полей на каждый въезд |
У возвратного въезда набор шире, потому что он не привязан к готовой перевозке и описывает приезд машины сам по себе. К четырём полям водителя и машины добавляются время прибытия в формате UTC, идентификатор точки отгрузки и идентификатор вашего склада. Про время прибытия спецификация уточняет: в это время пропуск начнёт действовать. То есть у него есть момент старта, и приехать раньше него нельзя.
Две технические детали, которые ломают интеграции:
Номер автомобиля назван по-разному. В методах перевозки и возврата это vehicle_license_plate, в методе поставки FBO это vehicle_number. Одно и то же значение, два имени поля, отдельный маппинг на каждое семейство.
Обновление данных по перевозке требует полный набор. В запросе обязательны идентификатор пропуска и все четыре поля по машине сразу. Прислать один изменившийся номер не получится: метод ждёт весь объект целиком.
Сохранил не значит приняли
У пропуска на поставку FBO схема асинхронная, и это единственное место, где ответ метода легко принять за успех. Метод создания возвращает идентификатор операции, а результат смотрится отдельным методом статуса. В ответе четыре состояния: Unknown, Success, InProgress, Failed. Пока состояние InProgress, данные ещё обрабатываются.
Рядом лежит перечисление причин отказа, и оно объясняет большинство случаев «я всё заполнил, а пропуска нет»:
| Код | Что означает |
|---|---|
INVALID_ORDER_STATE |
заявка в статусе, который не принимает данные машины |
VEHICLE_NOT_REQUIRED |
по этой заявке данные автомобиля указывать не нужно |
ORDER_NOT_BELONG_CONTRACTOR |
заявку создало другое юридическое лицо |
ORDER_NOT_BELONG_COMPANY |
заявка принадлежит другому кабинету |
Обратите внимание на второй код. Существуют заявки, по которым пропуск в принципе не оформляется, и попытка его создать вернёт отказ. Это нормальное состояние, а не ошибка заполнения.
Ответ с кодом 200 приходит и в случае отказа: причина лежит внутри тела ответа в поле ошибок. Судить об успехе по коду ответа здесь нельзя, нужно читать статус операции. Это общее свойство площадки, с которым мы сталкивались и в других разделах API.
Потерял пропуск или заблокировали въезд: где смотреть
Метод списка пропусков решает ровно эту задачу. Он отдаёт активные и неактивные заявки с фильтрами по цели въезда, точке отгрузки, складу продавца и конкретным идентификаторам.
Цель въезда в фильтре принимает два значения: FBS_DELIVERY для отгрузки и FBS_RETURN для вывоза возвратов. Если параметр не указан, учитываются обе цели. В каждой записи ответа приходит признак активности заявки, время въезда в UTC, данные водителя и машины, идентификаторы точки отгрузки и своего склада.
Отсюда рабочая последовательность при спорной ситуации на воротах: запросить список по нужному складу, найти запись по номеру машины, посмотреть признак активности и время въезда. Неактивная заявка объясняет отказ на воротах без переписки с поддержкой.
Ограничения метода стоит учесть заранее. Записей в ответе максимум 1000, столько же по умолчанию. Постраничный обход идёт курсором: пустой курсор означает, что данных больше нет. И главное: метод показывает въезды по перевозке и по возврату. Поставка FBO в этот список не попадает, у неё свой метод статуса.
Живая проверка. 8 сентября 2026 года метод списка на одном нашем кабинете вернул пустой массив и пустой курсор. Это одна проверка на одном кабинете: въезды там через API не оформлялись, отгрузки идут через пункты приёма. Вывод из этого один: пустой ответ метода сам по себе не признак поломки, сначала проверяется, оформлялось ли что-то вообще.
Что нужно водителю, кроме пропуска
Пропуск открывает ворота, но не закрывает вопрос документов. По памятке площадки водитель предъявляет паспорт и доверенность на получение товара, а сотрудники склада могут снять с них копию. Без доверенности приезд на вывоз возвратов теряет смысл: ворота открылись, груз не отдадут.
Правила на территории влияют на время рейса напрямую:
- максимальная скорость на территории склада 10 км/ч;
- парковка только на местах с разметкой, иначе автомобиль могут эвакуировать;
- покинуть склад нужно в течение 30 минут после отгрузки товаров;
- перед разгрузкой двигатель глушится, ставится стояночный тормоз и подкладываются противооткатные упоры.
Запреты на территории: проносить оружие, взрывчатые и токсические вещества, животных и птиц; курить вне отведённых мест; мыть и ремонтировать автомобиль (сломавшийся эвакуируется своими силами); оставлять мусор, упаковку и сломанные палеты; разводить огонь; находиться в состоянии опьянения; фотографировать и снимать видео.
Последствие нарушений площадка описывает без вариантов: могут запретить въезд или не принять поставку. Для наёмного рейса это означает потерянный слот и повторную запись.
Требования к самому грузу лежат отдельно от требований к машине: их разбирали в материале про требования к упаковке.
Чек-лист перед выездом машины
- Определите, какой из трёх пропусков вам нужен: поставка FBO, отгрузка перевозки или вывоз возвратов.
- Для поставки заполните данные минимум за 2 часа и убедитесь, что заказ перешёл в статус «Оформлен на поставку».
- Правки по вывозу возвратов внесите не позже чем за 24 часа до начала отгрузки, пока заявка в подходящем статусе.
- Если машин несколько, заполните данные на каждую отдельно.
- Если один рейс забирает несколько заказов, используйте единый пропуск вместо нескольких.
- Нужны возвраты обратным рейсом: поднимите флаг вывоза возвратов, по умолчанию он выключен.
- При работе через API проверьте статус операции, а не только код ответа.
- Выдайте водителю паспорт и доверенность на получение товара.
- Предупредите про 10 км/ч, разметку парковки и 30 минут на выезд после отгрузки.
Что это меняет в планировании
Пропуск выглядит формальностью до первого сорванного рейса. Два срока стоит держать в календаре отдельно от слота: 2 часа на заполнение по поставке и сутки на любые правки по вывозу возвратов. Отсчёт у обоих идёт от момента отгрузки на складе, поэтому время на дорогу в них не заложено.
Как устроена сама поставка на склад и чем отличается набор документов на въезде, разбирали в материале про поставку на склад Ozon. Про схему работы, при которой отгрузки идут короткими рейсами со своего склада, есть материал про FBS.
Если оформление пропусков, слотов и рейсов забирает рабочее время, эту часть можно отдать на сторону: мы принимаем товар на своём складе в Королёве и отгружаем на склады маркетплейсов сами. Посмотреть условия и посчитать стоимость можно на странице фулфилмента и в калькуляторе.
Источники: официальная справка Ozon для продавцов (страницы «Оформить пропуск на склад», «Оформить пропуск на склад и забрать товары», «Памятка для водителей») и спецификация Ozon Seller API (разделы «Пропуски» и «Доставка FBO»), проверено 8 сентября 2026 года. Раздел про поставку FBO уточнён 16 сентября 2026 года по базе знаний Ozon для продавцов (страница «Информация об автомобиле и водителе»): страницы docs.ozon.ru относятся к порталу поставщиков Retail Center, а не к кабинету продавца маркетплейса.