При подключении FBS продавцы часто сталкиваются с типовыми ошибками: API не отвечает, вебхуки не приходят, штрихкоды не сканируются. Вот решения, основанные на опыте и официальных источниках.
Сравнение
| Критерий | По теме страницы | Поддержка Wildberries |
|---|---|---|
| Сложность | Требует технической диагностики | Типовые решения из инструкций |
| Причина | Ошибка в коде, настройках или устаревший токен | Неправильный шаблон или повреждённый штрихкод |
| Решение | Тестирование API, обновление токена, проверка логов | Калибровка шаблона, увеличение DPI |
| Время на исправление | 30–60 минут | 10–15 минут |
| Необходимость специалиста | Часто требуется программист | Можно решить самостоятельно |
Как это работает
Проверьте код ответа: 200 успех, 401 — токен недействителен, 429 — превышен лимит.
В ЛК посмотрите журнал вебхуков: код ответа 200? Если нет, исправьте URL.
Убедитесь, что штрихкод чёрный, контрастный, размер не менее 50x30 мм.
Рекомендуется 300 DPI. Настройте принтер на высокое качество.
Если статус не меняется, передайте трек повторно и подождите 15 минут.
Подробно
Проблемы с API и вебхуками
Если API возвращает 401 Unauthorized, токен истёк или неверен. Создайте новый в разделе «Разработчикам». Если вебхуки не приходят, проверьте, что ваш сервер отвечает кодом 200, URL использует HTTPS, а в настройках выбраны правильные события. В личном кабинете есть журнал вебхуков — смотрите ошибки.
Проблемы с этикетками и статусами заказов
Нечитаемый штрихкод часто связан с маленьким размером этикетки (58x40) или низким DPI. Рекомендуется формат 75x50 мм и минимальный DPI 300. Если статус заказа не меняется после отгрузки, проверьте, что трек-номер передан корректно. Задержка может составлять до 15 минут.
Словарь терминов
Отзывы
Долго не мог настроить вебхуки — помогла проверка URL. Оказалось, нужен HTTPS с валидным сертификатом.
Этикетки не сканировались при 58x40 мм. Перешла на 75x50 — проблема ушла.
Частые вопросы
Почему API возвращает 429 Too Many Requests?
Превышен лимит — 10 запросов в секунду. Добавьте задержку между запросами.
Что делать, если вебхук приходит, но данные пустые?
Проверьте, что в настройках выбраны все необходимые поля. Обратитесь в техподдержку Wildberries.
Какой размер этикетки гарантирует читаемость?
75x50 мм при 300 DPI — оптимальный для любых сканеров.
Устраните типовые проблемы FBS за 15 минут: проверьте наши решения — выберите нужную ситуацию в списке.
