Wildberries и 1С через API
API Wildberries быстро меняется, поэтому интеграцию с 1С нужно строить с запасом прочности. Архитектура, сопоставление товаров, лимиты и что делать, когда API недоступен.
Продавцу на Wildberries с учётом в 1С рано или поздно надоедает переносить остатки, цены и заказы руками. Связка через API решает это, но у WB есть особенность, о которой стоит знать до начала работ: API развивается быстро. Методы и форматы обновляются, старые версии выводят из эксплуатации, документация иногда догоняет изменения уже после них. Интеграцию, написанную «один раз и навсегда», через несколько месяцев придётся чинить. Поэтому строить её нужно так, чтобы изменения на стороне WB не роняли учёт.
Архитектура: не стучитесь в WB напрямую из 1С
Самый очевидный вариант — обработка в 1С, которая по расписанию ходит в API маркетплейса. Для небольшого ассортимента он работает, но на объёме начинаются проблемы: 1С медленно работает с сетью, долгие запросы блокируют сеансы, а обработку ошибок и повторов в ней писать неудобно.
Надёжнее поставить между ними промежуточный слой — шину. Это может быть сценарий в n8n, очередь вроде RabbitMQ или небольшой собственный сервис. Шина забирает изменения из 1С, раскладывает их в очередь, отправляет в WB с учётом лимитов, повторяет при ошибках и складывает в журнал каждую операцию. 1С общается только с шиной и не ждёт ответа маркетплейса.
Что синхронизируется
- Карточки товаров. Создание и обновление номенклатуры, характеристики, фото. Обычно карточки ведут в кабинете WB, а из 1С синхронизируют только связку.
- Цены и скидки. Из 1С в WB. Учитывайте, что итоговая цена для покупателя складывается из вашей цены, вашей скидки и акций маркетплейса.
- Остатки. Для схемы со склада продавца (FBS, DBS) — из 1С в WB по каждому вашему складу. Для схемы со склада маркетплейса (FBW) остатками управляет WB, их имеет смысл забирать в 1С для отчётности.
- Заказы и сборочные задания. Из WB в 1С: новые заказы, статусы, отмены.
- Финансы. Отчёты о реализации, удержания, возвраты — для бухгалтерии и управленческого учёта.
Сопоставление товаров — фундамент
У товара на WB несколько идентификаторов: артикул WB, ваш артикул продавца и баркоды по размерам. В 1С — своя номенклатура и характеристики. Прежде чем что-то синхронизировать, нужна таблица соответствия, где каждой позиции 1С однозначно соответствует позиция WB. Большинство ошибок с остатками начинается здесь: один баркод привязан к двум позициям, размер заведён как отдельный товар, у части позиций нет баркода вовсе.
Лимиты и ошибки
У API WB есть ограничения частоты запросов, и они разные для разных групп методов: цены, остатки, заказы и статистика живут по своим правилам. Значения меняются, поэтому не зашивайте их в код константами, а смотрите актуальную документацию и стройте отправку с динамической паузой: получили ответ «слишком много запросов» — подождали дольше и повторили.
Отдельно — токены доступа. Они создаются в личном кабинете продавца с выбором категорий доступа и имеют срок действия. Истёкший токен — частая причина «внезапно перестало работать». Записывайте срок и ставьте напоминание заранее.
Когда API недоступен
Например, если API на час перестаёт отвечать, а интеграция без очереди просто пропускает обновления, остатки на WB застынут в прошлом. Покупатели закажут то, чего уже нет, и вам придётся отменять заказы. С очередью неотправленные изменения дождутся восстановления и уйдут, а алерт в Telegram сообщит ответственному о сбое.
Поэтому минимальный набор для критичной связки:
- Очередь с повторами для всех исходящих изменений.
- Журнал операций: что отправили, когда, какой получили ответ.
- Алерты при серии ошибок или долгом отсутствии успешных обменов.
- Ежедневная сверка остатков и цен между 1С и WB с отчётом о расхождениях.
- Аналитику и финансы грузить в 1С агрегатами по дням, а не построчно.
Готовый модуль или своя разработка
Для типовых конфигураций 1С есть готовые модули и сервисы-коннекторы к маркетплейсам. Если ассортимент небольшой, процессы стандартные и 1С типовая, начните с них: это быстрее и дешевле. Своя интеграция оправдана, когда 1С сильно доработана, когда нужно работать сразу с несколькими маркетплейсами по единым правилам или когда готовые решения не справляются с объёмом.
Правила маркетплейсов, условия работы и API меняются, поэтому перед стартом проекта сверяйтесь с актуальной документацией WB. Похожие грабли у Ozon разобраны в статье связка Ozon и 1С — что обычно ломается, а про мониторинг обменов — в материале как ловить рассинхрон с 1С вовремя. Сами интеграции делаем в рамках услуги интеграция с 1С.
Если нужно связать Wildberries с 1С или починить существующую связку, напишите в Telegram или MAX.