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

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

Wildberries работает на белорусском рынке с теми же техническими интерфейсами, что и в России: единое API Marketplace, один кабинет продавца. Для магазина на 1С-Битрикс интеграция означает двустороннюю синхронизацию: товарный каталог и остатки уходят на WB, заказы с WB приходят в Битрикс для обработки. Без автоматизации этот процесс превращается в ежедневную ручную работу с высоким риском ошибок.

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

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

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

• 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 — штрихкод поставки для маркировки

Карточки товаров: самая трудоёмкая часть

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

WB не принимает товары с пустыми обязательными характеристиками. При первой загрузке нужно:

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

Маппинг характеристик WB ↔ свойства Битрикс — самая кропотливая часть. Для каталога с 10 предметами (джинсы, майки, куртки…) это 10 таблиц соответствий.

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

Остатки на 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 позиций за запрос.

Получение и обработка заказов

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 этикетки.

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

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

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

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

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