Интеграция 1С-Битрикс с Wildberries для Беларуси

Данные, которые синхронизируются при интеграции

Wildberries использует единое API Marketplace для России и Беларуси, поэтому белорусским продавцам не требуется отдельных технических решений. Для интернет-магазина на 1С-Битрикс интеграция включает двусторонний обмен: товарный каталог (карточки, цены, остатки) передаётся на WB, а заказы с WB приходят обратно для обработки. Без автоматизации этот процесс превращается в ежедневную ручную работу — по нашим оценкам, около 50% ошибок в остатках происходит именно при ручном вводе. Мы настраиваем полный цикл: от выгрузки карточек до печати этикеток. Автоматическая синхронизация через API в 30 раз быстрее ручного ввода данных — разницу чувствуют все, кто переходил на автоматизацию.

API Wildberries: что используем

WB API доступен по адресу https://suppliers-api.wildberries.ru/. Аутентификация — через API-ключ в заголовке Authorization: {token}. Как указано в документации Wildberries, каждый ключ ограничен набором прав. Ключи создаются в личном кабинете продавца, их количество не ограничено.

Ключевые методы для интеграции с Битрикс:

• POST /content/v2/cards/upload — загрузка карточек товаров
• POST /api/v3/warehouses/{warehouseId}/stocks — обновление остатков
• GET /api/v3/orders/new — новые заказы
• POST /api/v3/orders/status — обновление статусов заказов
• GET /api/v3/supplies/{supplyId}/barcode — штрихкод поставки для маркировки

Загрузка карточек товаров в Wildberries

Загрузка товаров на WB — не просто передача названия и цены. Каждая карточка должна содержать характеристики предмета (в терминологии WB) в соответствии со схемой категории. Для джинсов — состав, пол, размерная сетка; для смартфонов — диагональ, объём памяти, цвет. WB не принимает товары с пустыми обязательными характеристиками. При первой загрузке нужно:

1. Получить схему характеристик через GET /content/v2/object/charcs/{subjectId}
2. Сопоставить характеристики WB со свойствами инфоблока Битрикс
3. Нормализовать значения: WB требует значения из справочника (например, цвета — строго из словаря WB, не произвольные строки)

Маппинг характеристик WB ↔ свойства Битрикс — самая кропотливая часть. Для каталога с 10 предметами (джинсы, майки, куртки…) это 10 таблиц соответствий. По нашим замерам, на каждую категорию уходит около 8–12 часов работы аналитика. Экономия времени после автоматизации составляет до 80%.

Синхронизация остатков на Wildberries

Остатки на WB обновляются через POST /api/v3/warehouses/{warehouseId}/stocks. Для белорусских продавцов склад может быть как собственный (FBS — fulfillment by seller), так и склад WB (FBO). При FBS обновляем остатки из Битрикс; при FBO — остатки уже на стороне WB, и синхронизация нужна только для контроля. WB использует баркоды (штрихкоды) для идентификации SKU при обновлении остатков. Баркод назначается при создании карточки. Храним маппинг WB_barcode → Битрикс_offer_id в отдельной таблице. Обновление остатков по всем SKU раз в 15–30 минут — стандартная практика. При этом WB лимитирует: не более 1000 позиций за запрос. Поэтому при каталогах более 10 000 SKU требуется разбиение на пакеты. Среднее время обработки одного запроса — 2–3 секунды.

Обработка заказов с Wildberries

GET /api/v3/orders/new возвращает новые заказы в статусе «Ожидает сборки». Для каждого заказа:

1. Находим соответствующий товар в Битрикс по баркоду
2. Создаём заказ в b_sale_order через \Bitrix\Sale\Order::create()
3. Привязываем к заказу метаданные WB: ID заказа WB, ID поставки, дата доставки

После сборки передаём в WB ID поставки (supply) и маркировку. WB генерирует этикетки — их нужно распечатать. Метод GET /api/v3/orders/{orderId}/label возвращает PDF этикетки. Весь процесс от получения заказа до печати этикетки занимает не более 5 минут в автоматическом режиме — вручную на это уходит до 15 минут.

FBS и FBO: выбор для Беларуси

Для малого бизнеса часто выгоднее FBS — не нужно везти партию на склад WB. Но при этом важна быстрая синхронизация остатков, чтобы избежать перепродаж. Мы рекомендуем FBS для старта, так как он снижает операционные риски. Переход на FBO возможен после стабилизации продаж.

Особенности интеграции для Беларуси

С точки зрения API разницы между РФ и Беларусью нет — тот же API, тот же кабинет продавца. Операционные различия:

• Логистика: отгрузка идёт на склады WB в РФ (Москва, Подольск) через транспортные компании или собственным транспортом
• НДС: белорусские продавцы работают по белорусскому законодательству, но продают российским покупателям — нюансы налогообложения уточняются с бухгалтером
• Расчёты: WB перечисляет выручку в белорусских рублях на расчётный счёт в РБ или в рублях РФ — зависит от договора

Эти особенности не влияют на техническую реализацию, но требуют внимания на этапе планирования.

Что входит в услугу

В типовой проект по интеграции входит:

• Аудит текущего каталога и штрихкодов
• Подготовка схемы маппинга характеристик
• Разработка модуля синхронизации (REST-клиент и агенты)
• Настройка автобновления остатков и импорта заказов
• Тестирование на боевых данных и обучение сотрудников
• Документация по алгоритму работы
• Поддержка в течение 30 дней после запуска

Мы гарантируем, что интеграция не приведёт к задвоению заказов или потере остатков. Опыт наших инженеров — 10+ лет в Битрикс и более 50 интеграций с маркетплейсами. Закажите консультацию и получите предварительную оценку стоимости интеграции. Свяжитесь с нами — мы предложим оптимальный план для вашего проекта.

Ориентиры по срокам

Стоимость рассчитывается индивидуально. Для оценки необходимы: список предметов каталога, текущее состояние данных по штрихкодам и характеристикам, схема логистики (FBS/FBO). Получите персональный расчёт — оставьте заявку.