Інтеграція 1С-Бітрікс з Wildberries Білорусь

Інтеграція 1С-Бітрікс з Wildberries Білорусь

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

API Wildberries: що використовуємо

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

Ключові методи для інтеграції з 1С-Бітрікс:

• 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 із властивостями інфоблоку 1С-Бітрікс
3. Нормалізувати значення: WB вимагає значень із довідника (наприклад, кольори — строго зі словника WB, не довільні рядки)

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

Синхронізація залишків

Залишки на WB оновлюються через POST /api/v3/warehouses/{warehouseId}/stocks. Для білоруських продавців склад може бути як власним (FBS — fulfillment by seller), так і складом WB (FBO). При FBS оновлюємо залишки з 1С-Бітрікс, при FBO — залишки вже на стороні WB.

WB використовує баркоди (штрихкоди) для ідентифікації SKU при оновленні залишків. Баркод призначається при створенні картки. Зберігаємо маппінг WB_barcode → 1С-Бітрікс_offer_id в окремій таблиці.

Оновлення залишків за всіма SKU раз на 15–30 хвилин — стандартна практика. При цьому WB обмежує: не більше 1000 позицій за запит.

Отримання та обробка замовлень

GET /api/v3/orders/new повертає нові замовлення зі статусом «Очікує складання». Для кожного замовлення:

1. Знаходимо відповідний товар у 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).