FBS API в 2026 году: как автоматизировать заказы и отгрузки

FBS API — обычный рабочий инструмент автоматизации, и бояться самой технологии не нужно. Через программный интерфейс SelSup получает новые заказы, обновляет остатки, связывает маркировку, печать этикеток и отгрузки со складским процессом. Селлеру не требуется разрабатывать весь обмен с нуля: готовый маршрут уже собран в SelSup.

Справочники площадок описывают отдельные методы, но редко показывают весь путь заказа от остатка до возврата и действия склада при временном сбое. Здесь мы собрали этот маршрут целиком и объяснили, где SelSup снимает ручную работу. Поэтому дочитайте статью до конца.

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

Что такое FBS API и какие операции он связывает

При FBS товар хранит и собирает продавец, а после передачи заказ попадает в логистику маркетплейса. API — набор правил, по которым две программы обмениваются данными. Например, складская система получает сборочное задание автоматически и показывает его комплектовщику.

Личный кабинет и API управляют одним процессом, но разными способами. В кабинете сотрудник нажимает кнопки. Через API те же действия выполняет программа: получает заказ, резервирует товар, передаёт результат сборки и забирает документы.

Для одной площадки и нескольких заказов в день ручного процесса может быть достаточно. При нескольких кабинетах и складах API снижает риск двойной продажи: один физический остаток нельзя одновременно обещать Wildberries, Ozon и Яндекс Маркету.

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

Какие операции FBS нужно связать через API? Сначала определите полный путь заказа, а для подключения кабинета используйте инструкцию по интеграции маркетплейсов с SelSup.

Чтобы увидеть оставшиеся ручные действия, разберите FBS-процесс на демонстрации SelSup.

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

Подробно схема FBS разобрана отдельно в статье о хранении, сборке, отгрузке и возвратах. Здесь сосредоточимся на обмене данными.

Безопасная цепочка FBS-заказа

Получить заказ недостаточно. После ответа API система должна сохранить внешний ID, проверить, не загружался ли он раньше, зарезервировать остаток и только затем показать задание складу. Без резерва товар может уйти в другой заказ.

Если сейчас заказы, резерв и печать живут в разных окнах, соберите их в одном процессе SelSup. Перед запуском сверьте кабинет и права по инструкции подключения Wildberries.

1. Обновить остаток. В API отдавайте только доступный к продаже запас.
2. Получить новые и изменённые заказы. Храните ID, кабинет, склад, срок, время правки и тип заказа для точной сверки и роли.
3. Проверить заказ на дубль. Один ответ API не должен давать два задания: сверяйте ID, дату, склад и товар до новой записи.
4. Поставить товар в резерв. Ставьте резерв сразу, а физический факт списывайте лишь после сборки, сдачи или отмены по факту.
5. Собрать и промаркировать. Сканируйте товар и код, чтобы связать их с нужным заказом, кабинетом, складом, листом сборки и датой.
6. Получить этикетки. Дождитесь файла и свяжите его с заказом.
7. Сформировать отгрузку. Берите лишь готовые заказы из зоны сдачи; проверьте место, дату, короб, акт и общий штрихкод.
8. Проверить результат. После команды читайте новый статус; при сбое сверяйте очередь, ID, дату, тип операции и повтор без дубля.

Сборку без ручной сверки кодов и стикеров покажем на демонстрации SelSup для Wildberries.

Как работают FBS API маркетплейсов

Wildberries: заказы, поставки и маркировка. Состав кабинета и рабочие разделы также разобраны в материале про личный кабинет продавца Wildberries.

В Wildberries основная сущность склада — сборочное задание на одну единицу товара. Если покупатель заказал десять одинаковых товаров, API вернёт десять заданий. Связать их с одной покупкой можно по общему orderUid.

Минимальная цепочка начинается с получения новых заданий через GET /api/v3/orders/new. Историю за период забирают отдельно, а актуальные статусы проверяют по ID. Список заказов и их текущий статус — разные данные.

Дальше продавец создаёт поставку, добавляет в неё задания, получает стикеры и передаёт поставку в доставку. Заказ и поставка — разные объекты: заказ относится к товару покупателя, а поставка объединяет готовые задания для одной передачи Wildberries.

Для маркируемого товара к заданию передают обязательный для категории идентификатор. Это может быть код «Честного знака», УИН, IMEI, GTIN, срок годности или номер декларации. Отсутствие идентификатора остановит следующий этап.

У методов есть лимиты. В текущей документации общий блок заказов, поставок и пропусков допускает 300 запросов в минуту с интервалом 200 мс и всплеском до 20 запросов; ответы 4XX расходуют лимит быстрее. Ошибочный запрос нельзя бесконечно повторять. Его нужно остановить, записать причину и вернуть в очередь после исправления данных.

Правила схемы FBS Wildberries собраны отдельно: сроки, комиссия и штрафы разобраны в практической статье.

Ozon: отправления, акты и несколько отгрузок.

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

Путь от статуса к этикетке и акту можно проверить на демонстрации Ozon FBS в SelSup.

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

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

В Ozon встречаются методы разных версий, а отдельные обучающие материалы сохраняются дольше переходного периода. Перед разработкой проверяйте метод в действующей Seller API документации, а не только в старой статье или примере кода.

Базовый процесс FBS Ozon описан отдельно в инструкции о продаже со своего склада.

Яндекс Маркет: заказы, ярлыки и возвраты.

Яндекс Маркет делит методы по объектам: магазин, товар, остаток, цена, заказ, отгрузка, ярлык, возврат и отчёт. Такая структура полезна и для собственной интеграции: сначала определите владельца каждого объекта, а потом выбирайте методы.

Заранее назначьте источник истины для каждого поля. Например, SelSup может быть источником доступного остатка, а Маркет — источником нового заказа и статуса доставки. Если сотрудник изменил количество в кабинете площадки, решите, перезапишет ли его следующая синхронизация. Иначе две системы будут менять одно поле по очереди.

Отгрузка на Маркете имеет собственные документы: акт приёма-передачи, лист сборки, транспортную накладную и фактический акт. Этикетки заказа и грузового места получают отдельными методами. Нельзя хранить один файл с названием «этикетка» и надеяться, что склад выберет правильный.

Общий складской контур для Яндекс Маркета и других кабинетов покажем на демонстрации SelSup.

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

Чем API площадок отличаются друг от друга

Сравнивайте не названия методов, а объекты и владельцев данных. Для контроля показателей Wildberries используйте отдельный разбор аналитики Wildberries, а влияние ошибок на прибыль проверяйте через юнит‑экономику маркетплейсов.

Эту таблицу нельзя превращать в один универсальный алгоритм. Общий у площадок только бизнес-процесс, а названия сущностей, статусы, документы и допустимая последовательность действий различаются.

Проверьте карту кабинетов и прав без передачи ключей в переписке на демонстрации SelSup.

Токены, права и безопасность

Бояться API-ключа не нужно: это штатный способ связать кабинет с рабочей системой. Важно использовать его по назначению — не вставлять в публичный сайт, общую таблицу или чат. В SelSup сотрудник работает с результатом операции в пределах своей роли, а сам токен не нужно передавать ему для ежедневной сборки заказов.

Для каждого кабинета и интеграции создавайте отдельный персональный токен с минимальными правами. Добавляйте его через штатную форму SelSup и не передавайте сотрудникам в чатах или общих таблицах. Полный порядок описан в инструкции по интеграции SelSup с Wildberries. Для ежедневной работы выдавайте сотруднику отдельную роль в SelSup: так для поддерживаемых операций ему не потребуется доступ к кабинету маркетплейса. Действия вне интеграции владелец выполняет на стороне площадки.

• Выдавайте минимальные права. Если системе нужны заказы и остатки, ей не обязательно разрешать изменение финансовых настроек.
• Разделяйте кабинеты. У каждого юрлица и площадки должна быть понятная связь с конкретным токеном.
• Записывайте дату замены ключа. После отзыва старого токена интеграция должна показать ошибку авторизации, а не молча перестать обновлять заказы.
• Не выводите ключ в журнал. Для диагностики достаточно метода, времени, кабинета, кода ответа и ID операции.

Как не терять заказы при сбоях API

Сбой интеграции влияет не только на очередь запросов, но и на доступность товара и прибыль. Чтобы заранее определить контрольные показатели, используйте материал о PIM‑системе для маркетплейсов; правила защиты кабинета собраны отдельно в статье о мошенничестве вокруг Wildberries.

Маркетплейс может временно отвечать медленно, вернуть 429 из-за лимита или 5XX из-за ошибки сервера. Интернет на складе тоже может пропасть. Такие ситуации должны замедлять очередь, а не останавливать работу навсегда.

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

Команды на изменение состояния требуют отдельной защиты. Перед повторной отправкой система проверяет результат предыдущей операции по внешнему ID. Если ответ на подтверждение отгрузки потерялся, сначала проверьте текущий статус и только потом повторяйте команду.

Контроль FBS-ошибок в одном окне SelSup покажем, если сейчас их приходится искать по разным кабинетам.

Писать интеграцию самим или подключить SelSup

Собственная разработка оправдана при особом складском процессе, команде разработчиков и ответственном за изменения API. Стоимость — это не только первый код, но и обновления методов, наблюдение за очередями, разбор ошибок и поддержка каждого кабинета.

В SelSup уже связан весь путь FBS-заказа: остаток, резерв, приоритет, складское задание, подбор, сборка, маркировка, печать, упаковка, отгрузка и история действий. Более 10 000 клиентов используют FBS в SelSup.

Сотрудник получает одно понятное действие на текущем этапе, а владелец видит, где заказ задержался и кто менял его состояние. Это не отменяет API площадок — SelSup берёт на себя различия между ними и превращает ответы методов в рабочие операции склада.

Сравните оба пути на ваших объёмах и кабинетах со специалистом SelSup.

Стоимость SelSup сравнивайте со всей ценой ручного и самописного процесса: временем разработчиков, контролем очередей, повторной обработкой заказов и возможными потерями из-за неверного остатка. Чем больше кабинетов и складов, тем быстрее растёт эта скрытая нагрузка, даже если первый обмен по API уже работает.

AI Office SelSup можно подключить к данным и рабочим процессам компании. Права на анализ, подготовку черновиков и выполнение действий настраиваются отдельно. Начинайте с одного процесса и оставляйте изменяющие операции под контролем владельца, пока не проверите сценарий на своих данных.

Чек-лист запуска FBS API

1. Нарисуйте путь заказа. Откуда берётся доступный остаток, кто создаёт резерв, где печатают этикетку и чем подтверждают отгрузку.
2. Составьте карту кабинетов. Площадка, юрлицо, магазин, склад, токен и его права.
3. Определите владельца каждого поля. Какая система задаёт остаток, цену, статус и код маркировки.
4. Сохраните внешние ID. Заказ, позиция, поставка, коробка, отгрузка и документ не должны склеиваться в один номер.
5. Добавьте очередь ошибок. Сотрудник должен видеть, что не отправилось и почему.
6. Проверьте повторы. Один заказ, два одинаковых ответа и повторное нажатие не должны создавать дубль.
7. Протестируйте маркировку и возврат. Именно эти ветки чаще всего отличаются от обычного заказа.
8. Запустите один кабинет. После контрольной сверки подключайте остальные.

Пройдите чек-лист на реальном кабинете вместе со специалистом SelSup.

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

Частые вопросы

Нужен ли программист для работы по FBS?

Для ручной работы в кабинете программист не нужен. Для собственной прямой интеграции потребуется разработчик и поддержка. Если используете готовый сервис, настройку выполняют без разработки полного API-контура с нуля.

Можно ли получать заказы через API, а собирать в кабинете?

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

Что лучше: вебхуки или регулярный опрос?

Вебхуки быстрее сообщают о событии, но их недостаточно как единственной защиты. Надёжный контур принимает событие и периодически сверяет изменённые заказы через API. Если вебхук потерялся, сверка восстановит данные.

Можно ли одной интеграцией подключить Wildberries, Ozon и Яндекс Маркет?

Можно построить общий интерфейс склада, но внутри нужны отдельные адаптеры. У площадок различаются сущности, статусы, маркировка, документы и лимиты. Унифицировать нужно действие сотрудника, а не притворяться, что API одинаковые.

Хотите проверить FBS API на своих кабинетах и складе? Запишитесь на демонстрацию SelSup: разберём один реальный заказ, покажем обмен данными и определим, какие ручные шаги можно убрать.

Есть ли API у SelSup?

Да, документация для интеграторов размещена на api.selsup.ru. Через неё можно связывать SelSup с PIM, ERP, 1С, интернет-магазином, доставкой и внутренними сервисами. Права выдавайте только для нужных операций.

С чего начать прямо сейчас?

Возьмите один новый FBS-заказ и пройдите его до принятой отгрузки: остаток → резерв → сборка → маркировка → этикетка → передача → статус. Все ручные копирования и места без подтверждения станут списком для автоматизации.