Подключение FBS через API Wildberries: пошаговая инструкция
Подключение FBS через API Wildberries позволяет автоматизировать обработку заказов, исключить ручной ввод и синхронизировать складские остатки. В этой инструкции — точные шаги от регистрации приложения до первого тестового заказа.
Сравнение
| Критерий | По теме страницы | Ручное управление FBS через личный кабинет |
|---|---|---|
| Сложность реализации | Требует навыков программирования | Доступно без кода |
| Скорость обработки заказов | Автоматически, менее 1 секунды | Вручную, 1–5 минут на заказ |
| Ошибки ручного ввода | Исключены | Вероятны опечатки и пропуски |
| Гибкость интеграции | Полный контроль над данными | Только стандартный функционал |
| Стоимость внедрения | Бесплатно (требуется разработчик) | Бесплатно (базовый) |
Как это работает
Перейдите в раздел «Разработчикам» -> «API», нажмите «Создать приложение», укажите название и разрешения.
Скопируйте сгенерированный JWT-токен. Это ключ для всех запросов.
Укажите URL вашего сервера для приёма уведомлений о заказах и возвратах.
Отправьте тестовый GET-запрос к /api/v3/orders — в ответ должен прийти список заказов.
Получайте новые заказы через API/вебхуки, передавайте трек-номера и обновляйте статусы.
Подробно
Регистрация приложения и получение токена
Чтобы получить доступ к API Wildberries, войдите в личный кабинет продавца, перейдите в раздел «Разработчикам» -> «API», нажмите «Создать приложение». Укажите название, выберите права (минимум: заказы, склад, уведомления). После создания скопируйте токен (JWT) — он потребуется для всех запросов к API. Храните токен в защищённом месте, не передавайте третьим лицам.
Автоматическая передача трек-номеров и обновление статусов
При отгрузке по FBS каждый заказ необходимо маркировать трек-номером, полученным от службы доставки. Через API отправьте PATCH-запрос на эндпоинт /api/v3/orders/{id}/meta с новым статусом и кодом маршрута. Статус отгрузки присваивается автоматически после сканирования на складе Wildberries. Рекомендуется настроить cron-задачу для обновления статусов каждые 15 минут.
Словарь терминов
Отзывы
Настроила FBS через API за один день. Автоматизация сократила время обработки заказов втрое. Ошибки ушли. Рекомендую.
Пошаговая инструкция помогла быстро запустить интеграцию для сети магазинов. Особенно полезен раздел о вебхуках.
Частые вопросы
Как часто обновлять статусы заказов через API?
Рекомендуется каждые 15–30 минут, чтобы статусы на Wildberries обновлялись своевременно.
Что нужно указать в вебхуке?
Укажите URL вашего сервера, который принимает POST-запросы. Настройте поддержку HTTPS.
Могу ли я использовать API без программиста?
Если нет опыта работы с REST API, рекомендуется привлечь разработчика или использовать готовые сервисы-агрегаторы.
Начните автоматизировать FBS уже сегодня — следуйте нашей инструкции и сэкономьте часы ручной работы.
