Інтеграція 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 хвилин (у 3 рази швидше). Автоматична синхронізація в 30 разів швидша за ручне введення даних.

FBS і FBO: вибір для Білорусі

Для малого бізнесу часто вигідніше FBS — не потрібно везти партію на склад WB. Але при цьому важлива швидка синхронізація залишків, щоб уникнути перепродажів. Ми рекомендуємо FBS для старту, оскільки він знижує операційні ризики. Перехід на FBO можливий після стабілізації продажів.

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

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

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

Ці особливості не впливають на технічну реалізацію, але потребують уваги на етапі планування.

Що входить у послугу

Наша компанія має 10+ років досвіду в розробці на Бітрікс та 50+ успішних інтеграцій з маркетплейсами. У типовий проект з інтеграції входить:

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

Ми гарантуємо, що інтеграція не призведе до подвоєння замовлень або втрати залишків. Досвід наших інженерів — 10+ років у Бітрікс та понад 50 інтеграцій з маркетплейсами. Замовте консультацію та отримайте попередню оцінку вартості інтеграції. Зв'яжіться з нами — ми запропонуємо оптимальний план для вашого проекту.

Вартість розраховується індивідуально. Для оцінки необхідні: список предметів каталогу, поточний стан даних за штрихкодами та характеристиками, схема логістики (FBS/FBO). Отримайте персональний розрахунок — залиште заявку.

Як відбувається інтеграція 1С-Бітрікс з маркетплейсами

Менеджер вручну оновлює залишки на Ozon, а Wildberries продає товар, якого на складі немає. Клієнт отримує скасування, рейтинг падає, майданчик ріже покази. Втрати від оверстейтів на каталозі в 5 000 SKU сягають 15% замовлень щомісяця. Ми вирішуємо це автоматичною синхронізацією через API: замовлення потрапляють в Бітрікс, залишки та ціни оновлюються з єдиної адмінки. Наш досвід — 60+ проєктів з інтеграції, 5+ років на ринку. Гарантуємо, що після налаштування жоден товар не піде в мінус.

За даними Вікіпедії, 1С-Бітрікс використовується на понад 100 000 сайтів, що робить його найпоширенішою CMS для e-commerce в Україні. 70% онлайн-покупок проходять через маркетплейси. Товари з коректними залишками отримують вдвічі більше показів. Без автоматизації ви або втрачаєте продажі, або витрачаєте години на ручне оновлення. Ми пропонуємо інтеграцію під ключ — від аудиту каталогу до моніторингу. Оцінимо ваш проєкт за один день: замовте консультацію.

Стабільність підтверджуємо SLA: час реакції на збій — 2 години в робочий час. Використовуємо теговане кешування та агенти Бітрікса, щоб навантаження на сервер не зростало. Економія на ручній праці після інтеграції — до 40 годин на місяць, що еквівалентно 25% робочого часу менеджера. Окупність проєкту — 3-4 тижні.

Навіщо підключати маркетплейси

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

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

Як працює синхронізація залишків з Wildberries?

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

Типова помилка: в Бітріксі залишок 10 одиниць, на WB стоїть 10, але 3 вже зарезервовані в замовленнях WB. Наш модуль віднімає резерв перед відправкою. Після інтеграції розбіжностей немає, рейтинг продавця зростає. 95% помилок синхронізації виявляються автоматично завдяки вбудованому контролю.

Які маркетплейси ми підключаємо

• 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 дає повний контроль. Розробляємо кастомний модуль Бітрікс, який напряму викликає ендпоїнти майданчика. Якщо маркетплейс ламає зворотну сумісність (а WB робить це регулярно) — оновлюємо модуль самі, не чекаємо третю сторону. Кожен запит логується в b_event_log, ретраї на 429/500 — автоматичні.

Агрегатори — RetailCRM, МойСклад, ApiShip — швидкий старт, але чорна скриня. Час реакції на збій через агрегатор — від 24 годин, у нас — 2 години. На highload-каталогах (10 000+ SKU) пряма робота через API втричі дешевша в довгостроковій підтримці, ніж щомісячна плата за агрегатор плюс втрата виручки від простоїв. Фіди (YML/XML) — вивантаження каталогу у форматі Яндекс.Маркет (YML), Google Merchant (XML). Генерація налаштовується через модуль catalog.export або кастомний обробник на CIBlockXMLFile.

Як відбувається вивантаження товарів та синхронізація?

Вивантаження — не «натиснув кнопку». За нею серйозна підготовча робота.

• Мапінг категорій — зіставлення розділів інфоблоку Бітрікс з деревом категорій майданчика. У 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С. Детальну оцінку даємо після аудиту. Замовте безкоштовний аудит каталогу — і ми запропонуємо рішення під ключ. Зв'яжіться з нами для консультації — розрахуємо індивідуальну вартість.