FBS-схема с Wildberries

FBS-схема Wildberries (Fulfillment by Seller) — это продажа со своего склада: заказы приходят от маркетплейса, а сборку, упаковку и передачу в доставку выполняет продавец. На стороне 1С-Битрикс это означает полноценный цикл обработки сборочных заданий через Marketplace API. Разберём его по шагам.

FBS против FBO: в чём разница для интеграции

Wildberries работает по двум основным моделям, и они требуют принципиально разной интеграции:

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

Marketplace API: инструменты FBS

Весь цикл FBS обслуживает Marketplace API (marketplace-api.wildberries.ru). Токен для него генерируется в ЛК поставщика с категорией «Маркетплейс». Ключевые методы:

• GET /api/v3/warehouses — склады продавца (нужен warehouseId);
• PUT /api/v3/stocks/{warehouseId} — обновление остатков по баркодам;
• GET /api/v3/orders/new — новые сборочные задания;
• POST /api/v3/supplies — создание поставки;
• GET /api/v3/orders/{id}/stickers — стикеры (этикетки) для сборочных заданий.

Логика построена вокруг сборочных заданий (по сути — заказ на одну единицу) и поставок (supplies), в которые задания группируются перед отгрузкой. Из Битрикс запросы отправляют через Bitrix\Main\Web\HttpClient, соблюдая лимиты каждого метода.

Остатки на складе продавца

FBS начинается с корректных остатков: если на складе WB (продавца) числится товар, которого нет физически, вы получите отмену и штраф. Поэтому остатки — самый частый по обновлению поток.

1. получить warehouseId складов продавца методом GET /api/v3/warehouses и сохранить;
2. из источника остатков (1С, МойСклад, складской модуль Битрикс) взять актуальные значения;
3. отправить их батчем по баркодам через PUT /api/v3/stocks/{warehouseId}.

Обновление ставят на агент с периодом 5–15 минут по изменённым позициям. Баркод здесь — ключ: он должен совпадать с баркодом в карточке WB и в учётной системе.

Цикл обработки сборочного задания

После продажи WB создаёт сборочное задание, и продавец обязан провести его по этапам в отведённое время. В интеграции с Битрикс цикл выглядит так:

1. агент опрашивает GET /api/v3/orders/new и забирает новые задания;
2. для каждого задания создаётся заказ в Битрикс/учёте с сохранением внешнего ID (идемпотентность);
3. задания группируются в поставку (POST /api/v3/supplies), задания добавляются в неё;
4. печатаются стикеры (GET /api/v3/orders/{id}/stickers) и клеятся на упаковку;
5. поставка закрывается и передаётся в доставку, WB получает статус отгрузки.

Каждый переход статуса важно отражать и в Битрикс, и на WB. Просрочка сборки ведёт к автоотмене и снижению рейтинга продавца, поэтому опрос новых заданий делают частым (каждые несколько минут), а сам процесс — с уведомлениями складу.

Реализация на стороне 1С-Битрикс

FBS-обмен оформляют отдельным модулем с набором агентов, каждый со своей задачей:

Агенты запускают через cron (/bitrix/modules/main/tools/cron_events.php), а не на хитах — HTTP-запросы к WB не должны тормозить витрину. Заказы FBS удобно заводить в стандартный модуль sale Битрикс с признаком канала, чтобы они попадали в общую обработку и, при необходимости, уходили в 1С или CRM. Токен, warehouseId и маппинг баркодов хранят в настройках модуля, а весь обмен логируют.

• идемпотентность заказов — по внешнему ID сборочного задания;
• retry с задержкой при 429 и сетевых сбоях;
• мониторинг: непринятые задания и просроченные сборки — на видное место.

Риски FBS и как их снять

FBS строже FBO по дисциплине: маркетплейс штрафует за отмены и просрочки. Основные риски и меры:

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

Итог

FBS-схема с Wildberries требует на стороне 1С-Битрикс полноценного цикла: актуальные остатки на складе продавца, приём сборочных заданий, формирование поставок, печать стикеров и передача статусов через Marketplace API. Ключевые опоры — единый складской контур без перепродажи, идемпотентность заказов, частый опрос новых заданий и устойчивость к сбоям и лимитам API.

Мы в B2Bsite реализуем FBS как модуль на 1С-Битрикс: с агентами по расписанию, заведением заказов в модуль sale, печатью этикеток, логом и мониторингом просрочек. Связываем остатки с 1С или МойСклад и, при необходимости, добавляем доставку для схемы DBS, чтобы продажи со своего склада шли без ручной рутины и штрафов.