Интеграция 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). Получите персональный расчёт — оставьте заявку.

Интеграция 1С-Битрикс с маркетплейсами

Менеджер вручную обновляет остатки на Ozon, а Wildberries продаёт товар, которого на складе нет. Клиент получает отмену, рейтинг падает, площадка режет показы. Мы решаем это автоматической синхронизацией через API: заказы падают в Битрикс, остатки и цены обновляются из единой админки. Наш опыт — 60+ проектов по интеграции с Ozon, WB, Яндекс.Маркет. Гарантируем, что после настройки ни один товар не уйдёт в минус.

Важность автоматизации: 70% онлайн-покупок в России проходят через маркетплейсы. Товары с корректными остатками получают вдвое больше показов. Без автоматизации вы либо теряете продажи из-за оверстейтов, либо тратите часы на ручное обновление. Мы предлагаем интеграцию под ключ — от аудита каталога до мониторинга. Оценим ваш проект за один день: напишите для консультации.

Стабильность подтверждаем SLA: время реакции на сбой — 2 часа в рабочее время. Используем тегированное кэширование и агенты Битрикса, чтобы нагрузка на сервер не росла. Экономия на ручном труде после интеграции — до 40 часов в месяц, что при ставке менеджера даёт около 60 000 ₽ экономии.

Зачем подключать маркетплейсы

Маркетплейсы — готовый трафик, который один интернет-магазин не соберёт. Более половины онлайн-покупок — через площадки. Вам остаётся ассортимент и цены.

• Каналы продаж — миллионы покупателей с картой в руке.
• Единое управление — товары, остатки, заказы из всех каналов в Битриксе. Никакого ручного ввода.
• Сквозная аналитика — маржинальность по каждому каналу. Решения на цифрах, не на интуиции.

Как работает синхронизация остатков с Wildberries?

API поставщика WB требует обновлять стоки на складах каждые 15–30 минут. Иначе остатки расходятся с сайтом, покупатель оформляет заказ на несуществующий товар. Мы настраиваем агент Битрикса: CAgent::AddAgent() с интервалом 15 минут, который дёргает /api/v3/stocks. Данные берутся из торгового каталога с учётом резервов.

Типичная ошибка: в Битриксе остаток 10 единиц, на WB стоит 10, но 3 уже зарезервированы в заказах WB. Наш модуль вычитает резерв перед отправкой. Результат: после интеграции расхождений нет, рейтинг продавца растёт. Потери от оверстейтов на каталоге в 5 000 SKU составляют в среднем 150 000 ₽ в месяц — интеграция окупается за 3–4 недели.

Какие маркетплейсы подключаем

• Ozon — Seller API v3. Создание карточек (/v3/product/import), обновление цен (/v1/product/import/prices), остатки (/v2/products/stocks), заказы FBO/FBS (/v3/posting/fbs/list), возвраты. Настраиваем автогенерацию штрихкодов и этикеток через label/task.
• Wildberries — API поставщика. Выгрузка номенклатуры с характеристиками по категориям (/content/v2/cards/upload), баркоды, синхронизация остатков на складах WB (/api/v3/stocks), обработка заказов и поставок, медиаконтент.
• Яндекс.Маркет — Partner API. Каталог через фид или push-модель, цены, остатки, заказы DBS/FBS/FBY (/campaigns/{campaignId}/orders), интеграция с Яндекс.Доставкой.
• СберМегаМаркет — Merchant API. Товары, офферы, заказы, синхронизация статусов.
• Другие — AliExpress Россия, Авито, отраслевые площадки (Lamoda, Leroy Merlin).

Механизмы интеграции: прямой API или агрегатор?

Прямая интеграция через API — самый надёжный путь. Разрабатываем кастомный модуль Битрикс, который напрямую дёргает эндпоинты площадки. Полный контроль: если маркетплейс ломает обратную совместимость (а WB делает это регулярно) — обновляем модуль сами, не ждём третью сторону. Каждый запрос логируется в b_event_log, ретраи на 429/500 — автоматические.

Агрегаторы — RetailCRM, МойСклад, ApiShip. Быстрый старт, но чёрный ящик: когда что-то ломается, дебажить через чужой слой — удовольствие сомнительное. Подходит при ограниченном бюджете. Фиды (YML/XML) — выгрузка каталога в формате Яндекс.Маркет (YML), Google Merchant (XML). Генерация настраивается через модуль catalog.export или кастомный обработчик на CIBlockXMLFile.

Почему прямая интеграция выгоднее агрегаторов? Агрегаторы унифицируют обмен с разными площадками, но каждая новая версия API маркетплейса требует обновления со стороны агрегатора. Ждать исправления — дни. Прямая интеграция даёт контроль: мы обновляем модуль в день изменения. Типичное время реакции на сбой в интеграции через агрегатор — от 24 часов, у нас — 2 часа. Экономия на потерянных заказах за месяц может достигать 200 000 ₽. Практика показывает: на highload-каталогах (10 000+ SKU) прямая работа через API в три раза дешевле в долгосрочной поддержке, чем ежемесячная плата за агрегатор плюс потеря выручки от простоев.

Выгрузка товаров и синхронизация

Выгрузка — не «нажал кнопку». За ней серьёзная подготовительная работа.

• Маппинг категорий — сопоставление разделов инфоблока Битрикс с деревом категорий площадки. У Ozon своя таксономия (/v1/description-category/tree), у WB — своя. Обязательные атрибуты различаются.
• Маппинг свойств — свойства инфоблока (PROPERTY_*) → характеристики маркетплейса. Конвертация единиц, форматов — автоматически через таблицу соответствий в highload-инфоблоке.
• Обогащение карточек — rich-контент для Ozon, видеообзоры для WB, 360-фото. Площадки ранжируют по заполненности: между «голой» и проработанной карточкой разница в продажах двукратная.
• Изображения — автоматическая генерация в нужных разрешениях через CFile::ResizeImageGet().

Синхронизация — по расписанию через агенты CAgent::AddAgent():

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

Заказы с площадок падают в b_sale_order автоматически и обрабатываются в едином потоке.

• Создание — заказ приходит со всеми реквизитами. Модуль парсит ответ API, создаёт заказ через \Bitrix\Sale\Order::create(), привязывает к типу плательщика и платёжной системе маркетплейса.
• Единый поток — менеджеры работают с заказами из всех каналов в одном интерфейсе. Источник заказа виден в свойстве ORDER_PROP.
• Синхронизация статусов — собрали, отгрузили, доставили — статус обновляется на маркетплейсе через callback. Обработчик OnSaleStatusOrder.
• Возвраты — отмена на маркетплейсе создаёт возврат в Битрикс. Остатки возвращаются на склад автоматически.
• Передача в 1С — заказы уходят в 1С:Предприятие через штатный обмен CommerceML. Один источник правды.

Мониторинг и стабильность

Мультиканальная торговля без мониторинга — хаос. Мы ставим на контроль каждый канал.

• Контроль остатков — оповещения при расхождениях между Битрикс, маркетплейсом и 1С. Товар с нулевым остатком блокируется автоматически — нельзя продать то, чего нет. Проверка через cron каждые 10 минут.
• Логирование и ретраи — каждый запрос к API логируется в b_event_log с телом запроса и ответа. Сбой? Автоповтор с экспоненциальным backoff. Критическая ошибка? Уведомление в Telegram-бот админа.
• Ценообразование — автоматический расчёт с учётом комиссий площадки, логистики и целевой маржи. Формула в настройках модуля: price = base_price / (1 - commission) + logistics.
• Аналитика — дашборд: выручка, заказы, средний чек, возвраты, маржинальность по каждому маркетплейсу отдельно. Обновляется раз в час.

Подход к интеграции и объём работ

1. Аудит — смотрим каталог Битрикс, структуру инфоблоков, существующие обмены с 1С. Определяем готовность данных. Бывает, 80% работы — привести карточки в порядок: заполнить обязательные свойства, унифицировать единицы измерения.
2. Стратегия — приоритетные площадки, модель (FBO/FBS/DBS), глубина интеграции.
3. Разработка модулей — маппинг, валидация, обработка ошибок. Покрываем unit-тестами критичные сценарии: разбиение заказа, пересчёт остатков при частичной отмене.
4. Тестирование — выгрузка тестовых товаров, эмуляция заказов через sandbox API площадок, пограничные случаи (нулевой остаток, товар без фото, цена ниже минимальной).
5. Запуск — последовательно запускаем интеграции, мониторим первые обмены в реалтайме.
6. Сопровождение — площадки регулярно обновляют API (WB — без предупреждения). Адаптируемся оперативно.

В работу входит:

• Аудит текущего каталога, инфоблоков и обмена с 1С — документация с рекомендациями.
• Разработка модуля интеграции (на каждый маркетплейс) с исходным кодом.
• Настройка маппинга категорий и свойств.
• Конфигурация агентов и webhook’ов.
• Тестирование в sandbox и на реальных данных.
• Обучение менеджеров работе с единым потоком заказов.
• Мониторинг в течение первых двух недель после запуска.
• Техническая поддержка и обновления при изменениях API площадок.

Сроки

Конкретные сроки зависят от объёма каталога, количества площадок, сложности маппинга и состояния обмена с 1С. Детальную оценку даём после аудита. Закажите аудит каталога — бесплатно оценим ваш проект и предложим решение под ключ. Свяжитесь с нами, чтобы получить консультацию по интеграции и рассчитать индивидуальную стоимость.