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

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

Wildberries — закрытая экосистема с нестандартным API. В отличие от Ozon и Яндекс.Маркета, здесь нет единого Seller API с понятной документацией. API разбит на несколько независимых сервисов (Content API, Marketplace API, Statistics API, Prices API), каждый со своей авторизацией, лимитами и форматами данных. Интеграция с 1С-Битрикс требует работы с каждым из этих сервисов отдельно.

Структура API Wildberries

Авторизация — через токены, генерируемые в личном кабинете поставщика: Настройки → Доступ к API. Для каждого сервиса можно создать отдельный токен с ограниченными правами.

Все запросы — REST, JSON. Авторизация через заголовок Authorization: Bearer <token>.

Загрузка карточек товаров: Content API

Создание карточки — POST /content/v2/cards/upload. Структура карточки WB принципиально отличается от инфоблока Битрикс:

Номенклатура (nmID) — верхний уровень, объединяющий варианты товара. Внутри — массив sizes, где каждый размер имеет свой skus[] (список штрихкодов). WB идентифицирует конкретный товар по штрихкоду, а не по артикулу.

Обязательные поля при создании карточки:

• vendorCode — артикул поставщика. В Битрикс — свойство ARTICLE или ARTNUMBER.
• brand — бренд. Должен совпадать с зарегистрированным в WB.
• title — название. WB генерирует его автоматически из категории + бренд + характеристики. Ручное название может быть отклонено.
• description — до 5000 символов.
• subjectID — ID категории WB. Получается через GET /content/v2/object/all.
• characteristics — массив характеристик, зависящих от категории.
• sizes[].skus[] — штрихкоды для каждого размера.

Характеристики (characteristics). У каждой категории WB — свой набор обязательных характеристик. Получить список: GET /content/v2/object/charcs?subjectID={id}. Характеристики бывают текстовые и справочные. Для справочных — значение должно точно совпадать с вариантом из справочника WB.

Маппинг на инфоблок Битрикс:

Элемент инфоблока → nmID (после создания WB возвращает nmID)
  ├── NAME → title (но WB может переопределить)
  ├── PROPERTY_ARTICLE → vendorCode
  ├── PROPERTY_BRAND → brand
  ├── DETAIL_TEXT → description
  ├── PROPERTY_COLOR → characteristics[{id: N}]
  └── DETAIL_PICTURE + PROPERTY_PHOTOS → mediaFiles[]

Торговые предложения → sizes[]
  ├── PROPERTY_SIZE → techSize
  ├── PROPERTY_BARCODE → skus[]
  └── Цена → (через Prices API отдельно)

Загрузка фотографий

Фотографии загружаются отдельным запросом: POST /content/v2/cards/upload/add для привязки медиафайлов к карточке. WB принимает фото по URL — указываете массив ссылок на изображения с вашего сервера. Требования: минимум 900×1200 px, формат JPG/PNG, белый фон для большинства категорий.

В Битрикс изображения хранятся в /upload/iblock/. URL формируется как https://ваш-домен.ru/upload/iblock/xxx/photo.jpg. Убедитесь, что файлы доступны по прямому URL без авторизации.

Управление ценами

Prices API работает отдельно от Content API. Метод POST /api/v2/upload/task устанавливает цену и скидку:

• price — цена до скидки (розничная).
• discount — процент скидки. Итоговая цена = price * (1 - discount/100).

WB навязывает SPP (скидку постоянного покупателя) поверх вашей скидки. Итоговая цена для покупателя = ваша цена - ваша скидка - SPP. Это значит, что при установке цены из Битрикс нужно учитывать SPP — иначе маржинальность будет ниже ожидаемой.

Синхронизация: cron-агент в Битрикс каждые 15–30 минут проверяет товары с изменённой ценой в b_catalog_price и отправляет пакетный запрос. Лимит — 1000 товаров за запрос.

Остатки и заказы (FBS)

Остатки FBS. Метод PUT /api/v3/stocks/{warehouseId} обновляет остатки на складе поставщика. warehouseId — ID вашего склада в WB (создаётся в ЛК). Каждый товар идентифицируется по штрихкоду (sku), а не по артикулу. Маппинг штрихкод → элемент инфоблока должен быть однозначным.

Заказы FBS. Получение новых заказов: GET /api/v3/orders/new. Каждый заказ содержит skus[] — штрихкоды заказанных товаров. Обработчик на стороне Битрикс:

1. По штрихкоду находит элемент инфоблока / торговое предложение.
2. Создаёт заказ в sale с маппингом товаров.
3. При сборке — вызывает PUT /api/v3/orders/{orderId}/confirm и формирует стикер для упаковки через POST /api/v3/orders/stickers.

Важно: WB не передаёт данные покупателя (имя, адрес, телефон) поставщику. Заказ в Битрикс создаётся с минимальным набором данных — по сути, только список товаров и сумма.

Типичные проблемы

Карточка не создаётся. Причина — неправильный subjectID или отсутствие обязательной характеристики. API возвращает ошибку с описанием, но иногда описание неинформативно. Проверяйте набор характеристик для категории через /content/v2/object/charcs.

Дубли карточек. WB может объединять карточки с одинаковым штрихкодом или артикулом. Если при интеграции штрихкоды некорректны — вместо обновления существующей карточки создаётся новая.

Rate limiting. Content API — до 100 запросов в минуту. При массовой загрузке каталога нужна очередь с задержкой. В Битрикс реализуется через агенты с пошаговой обработкой.