Як підключити Bol.com до Elbuz: офери, замовлення, ціни в євро

Що вміє підключення Bol.com

• Підключення двома ключами — без прив'язки застосунку й без входу в кабінет із Elbuz.
• Завантаження оферів — назва, опис і бренд картки Bol.com, ваш артикул, EANНомер штрихкоду товару з 13 (іноді 8) цифр. Однаковий у всіх продавців, тому за ним зручно знаходити той самий товар у різних постачальників., ціна й залишок.
• Замовлення — відкриті при першому запуску, далі все змінене за останні дні.
• Ціни й залишки назад на Bol.com — по одному оферу, з окремим рядком журналу на кожну відмову.
• Публікація нових товарів — офер за EAN на наявну картку або нова картка за зіставленою категорією.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних → новий шаблон типу «Bol.com»

Інші входи

Довідники → Операції → Вивантаження даних — шаблон для цін і залишків

Право доступу

вікно «Завантаження даних» у «Правах груп»

Підготувати

Client ID і Client secret із Seller Dashboard Bol.com

Bol.com продає тільки покупцям у Нідерландах і Бельгії. Продавець, зареєстрований в іншій країні, потрапляє на майданчик лише за запрошенням Bol.com і через сертифікованого партнера з підключення. Це вирішується з Bol.com до підключення до Elbuz: без активного акаунта продавця ключів у кабінеті не буде.

Де взяти ключі Bol.com

Ключі продавець створює сам, жодного застосунку реєструвати не треба. Кабінет Bol.com — нідерландською, тому назви пунктів наведено як у ньому:

1. Увійдіть у Seller Dashboard (partner.bol.com) і відкрийте Instellingen → API-instellingen.
2. Створіть ключі для Retailer API, а не для Advertising API.
3. Скопіюйте Client ID і Client secret. Secret показується один раз: закрили вікно, не скопіювавши, — створіть нову пару.

У шаблоні завантаження типу «Bol.com» картка «Підключення» має чотири поля, обов'язкові — перші два:

Вставивши ключі, натисніть «Перевірити підключення». Elbuz отримає токен доступу й прочитає один ваш офер. Відповідь «Підключення працює. Bol.com» означає, що ключі скопійовано повністю й вони від Retailer API.

1

Client ID

2

Client secret

3

Мова карток

4

Термін доставки

1. Client ID — перша половина пари ключів із Seller Dashboard.
2. Client secret — секретна половина пари; після збереження вона прихована.
3. Мова карток — мова для нових карток (nl, nl-BE, fr, fr-BE).
4. Термін доставки — обіцянка покупцю для нових оферів.

Що переноситься в картку

Каталог Bol.com спільний: картку товару (назва, опис, фото) веде майданчик і знаходить її за EAN, а ваш офер — це ціна, залишок і термін доставки. Elbuz забирає список ваших оферів і до кожного окремо дочитує картку за EAN.

Чого з Bol.com не приходить: фото (у Retailer API немає посилань на зображення), характеристики, категорія. Галочка «Фото» у формі шаблону для Bol.com нічого не завантажує.

Усі нові товари лягають у службову категорію «Товари - bol». Вона створюється вимкненою й без участі у вивантаженнях: такі товари нікуди не поїдуть, доки ви не розкладете їх по своїх категоріях. Як прибрати службову категорію: службові категорії та бренди.

Що перезапише повторний прогін

Свій товар повторне завантаження шукає спершу за прив'язкою до офера, яку Elbuz запам'ятав минулого разу, а якщо її ще немає — за назвою. За EAN наявний товар каталогу не шукається: перший прогін прив'яже офер до вашої картки, лише якщо назва збігається, а артикула виробника й посилання на товар у картці немає. Інакше він заведе нову картку.

Порожнє значення з Bol.com заповнене поле не стирає. Якщо картку за EAN прочитати не вдалося, назва й опис уже заведеного товару лишаються як були, а не замінюються заглушкою.

Окремої галочки «не оновлювати назву» в шаблоні Bol.com немає. Хочете тримати свої назви й описи — увімкніть у картці товару перемикач «Не оновлювати» (секція «Захист під час імпорту»): прогін не змінить у ній нічого. Перемикач «Фіксована ціна» закриває від перезапису лише ціну. Для всього каталогу простіше зняти галочку «Товари» після першого прогону (сценарій).

Офер, якого в прогоні не було, завантаження не торкається: товар лишається з останньою ціною й залишком, не вимикається й не видаляється.

Як приходять замовлення

Elbuz бере замовлення, які відвантажуєте ви самі. Замовлення, що їх Bol.com відвантажує зі свого складу, у це підключення не потрапляють.

• Перший запуск забирає тільки відкриті замовлення — історії відвантажених Elbuz не переносить.
• Наступні запуски забирають усі замовлення, змінені з дати минулого запуску, із запасом у дванадцять годин. Так до вже завантажених доїжджають відвантаження й скасування.
• Далі ніж на 90 днів назад Elbuz не дивиться: стільки історії зберігає Bol.com.

У документ «Замовлення покупця» потрапляють номер і дата замовлення, ім'я та прізвище отримувача, телефон, пошта, адреса доставки (вулиця, будинок, місто, індекс, країна; для пункту видачі — його назва), позиції з цінами й сума в євро. Пошту Bol.com віддає анонімною, але постійною для покупця, тож повторні замовлення однієї людини збираються в одного контрагента.

Окремого статусу замовлення в Bol.com немає, Elbuz виводить його з рядків:

Зіставте коди зі своїми статусами кнопкою «Статуси замовлення» в картці «Повʼязані налаштування» форми шаблону. Що повторний прогін змінює в уже завантаженому замовленні — хто кого перезаписує: ваш статус чи майданчика.

1

Статуси замовлення

2

Налаштування розкладу

1. Статуси замовлення — зіставлення OPEN, SHIPPED, CANCELLED зі своїми статусами.
2. Налаштування розкладу — як часто забирати замовлення й каталог.

На Bol.com Elbuz нічого не підтверджує й не надсилає: відвантаження й трек-номер ви реєструєте в кабінеті Bol.com, і наступний прогін переведе замовлення в SHIPPED.

Якщо деталі окремого замовлення отримати не вдалося, у журналі буде рядок із його номером, а дата, від якої береться наступна порція, відступить назад. Наступний запуск забере це замовлення ще раз.

Як ціни й залишки повертаються на Bol.com

Зворотний напрямок — окремий шаблон вивантаження типу «Bol.com». У картці «Підключення» — ті самі Client ID і Client secret, а поле «Версія API (параметри майданчика)» задає мову карток і термін доставки через риску: nl|1-2.

1

Client ID

2

Client secret

3

Версія API (параметри майданчика)

1. Client ID — той самий ключ, що в шаблоні завантаження.
2. Client secret — секретна половина ключа.
3. Версія API (параметри майданчика) — мова карток і термін доставки через «|», наприклад nl|1-2.

З галочкою «Товари» в картці «Що вивантажувати» Elbuz відправляє кожен офер окремим запитом: ціну й залишок. Ключ офера він бере з прив'язки, яку зробило завантаження каталогу або минула публікація, тому спершу один раз завантажте каталог з Bol.com, потім налаштовуйте вивантаження. Товари з відбору без прив'язки пропускаються мовчки, якщо не ввімкнено «Публікувати нові товари».

• Валюта. Bol.com приймає тільки євро, а Elbuz надсилає ціну тим числом, яке стоїть у товарі, без перерахунку. Каталог у гривнях чи злотих — перерахуйте ціну формулою в «Налаштування вивантаження полів» шаблону, інакше 1500 гривень поїдуть як 1500 євро.
• Націнка для Bol.com задається тією ж формулою ціни в шаблоні вивантаження, ціни в каталозі лишаються як були.
• Межі ціни — від 1 до 9999 євро. Офер з ціною поза ними не відправляється, у журналі буде рядок «Bol.com: «…» — ціна … поза допустимим діапазоном 1–9999 EUR, офер не оновлено».
• Залишок менший за нуль відправляється як нуль.

Знімати чи видаляти офери Elbuz не вміє: товар, що випав із відбору, просто перестане отримувати оновлення. Щоб зупинити продаж, поставте нульовий залишок і дочекайтеся вивантаження або зніміть офер у кабінеті Bol.com.

Публікація нових товарів

З галочкою «Публікувати нові товари» в картці «Що вивантажувати» Elbuz виставляє офер для товару, у якого прив'язки до Bol.com ще немає. Потрібні штрихкод щонайменше з 8 цифр і ціна від 1 до 9999 євро.

1

Товари

2

Публікувати нові товари

1. Товари — оновлювати ціни й залишки привʼязаних оферів.
2. Публікувати нові товари — виставляти на Bol.com товари без привʼязки за EAN.

Офер іде з вашою ціною, залишком, артикулом (або номером товару в Elbuz, якщо артикула немає), терміном доставки з поля «Версія API» і станом із поля «Стан товару»:

Якщо офер на цей EAN у вас на Bol.com уже є (виставили в кабінеті або минулим запуском), Elbuz не створює другий, а знаходить наявний і прив'язує до товару. Кожна публікація — рядок журналу «Bol.com: опубліковано товар «…» (офер …)».

Якщо картки товару на Bol.com ще немає

Перед публікацією Elbuz перевіряє EAN у каталозі Bol.com. Картки немає — він надсилає її на перевірку майданчика: EAN, назву, опис, виробника, головне фото й категорію Bol.com. Категорію бере із зіставлення категорії товару.

Де: Довідники → Категорії → плитка «Зіставлення з маркетплейсами» → чип «Bol.com».

При першому відкритті натисніть «Завантажити довідник майданчика» — дерево категорій Bol.com підтягнеться з ключів шаблону завантаження. Далі зіставте свої категорії в колонці «Категорія Bol.com». Як працює вікно: зіставлення категорій з маркетплейсами.

1

Чип Bol.com

2

Категорія Bol.com

1. Чип Bol.com — показує колонки саме цього майданчика.
2. Колонка «Категорія Bol.com» — куди потрапить нова картка.

Обмеження нової картки:

• одна картка — один товар: варіацій (розмір, колір) Elbuz не групує;
• фото одне — перше посилання з товару, позначене як головне;
• характеристик, крім назви, опису й бренду, не надсилає — решту майданчик може попросити дозаповнити в кабінеті;
• мова картки — з поля «Версія API» (nl, nl-BE, fr, fr-BE).

Відповідь Bol.com Elbuz чекає кілька секунд. Встиг — у журналі «картку надіслано в каталог Bol.com (статус: SUCCESS)» або «картку відхилено: …» з причиною. Не встиг — статус PENDING: офер усе одно створюється й з'явиться на сайті Bol.com, коли майданчик схвалить картку.

Оновлення за розкладом

Миттєвих сповіщень Bol.com не надсилає: Elbuz сам звертається до майданчика за розкладом, який задає кнопка «Налаштування розкладу». Орієнтир — замовлення кілька разів на годину, каталог раз на добу, ціни й залишки частіше, якщо залишки рухливі. Вивантаження — окремий шаблон зі своїм розкладом і своїм перемикачем «Активний».

Ліміт звернень у Bol.com жорсткий: на замовлення — близько 25 запитів на хвилину. Отримавши відмову через ліміт, Elbuz чекає стільки, скільки сказав майданчик (до хвилини), і повторює до трьох разів. Найдовше вантажиться каталог, бо картку кожного офера Elbuz питає окремо, а вивантаження — бо кожен офер оновлюється своїм запитом.

Обрив прогону безпечний: каталог пишеться пачками по 500 оферів, замовлення шукаються за номером, а прив'язаний офер оновлюється за тим самим ключем. Загальні правила: якщо прогін обірвався.

Сценарії

1

Товари

2

Замовлення

1. Товари — забирати ваші офери Bol.com у каталог.
2. Замовлення — отримувати замовлення Bol.com.

Перенести каталог Bol.com у Elbuz

Що ввімкнути. Заповніть «Client ID» і «Client secret», у картці «Вибір даних для завантаження» — «Товари».

Що вийде. Кожен офер ляже в категорію «Товари - bol» з назвою, описом і брендом картки, вашим артикулом, штрихкодом, ціною в євро й залишком. Фото, характеристики й категорії додайте самі або з прайсу постачальника.

Приймати замовлення Bol.com

Що ввімкнути. Галочку «Замовлення»; кнопкою «Статуси замовлення» зіставити OPEN, SHIPPED, CANCELLED зі своїми статусами, кнопкою «Налаштування розкладу» задати регулярні запуски.

Що вийде. Перший прогін забере відкриті замовлення, наступні — усе змінене від дати в полі «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» у блоці «Розширене». Відвантаження в кабінеті Bol.com за наступним прогоном змінить статус документа.

Bol.com як канал для каталогу, який ви ведете в Elbuz

Що ввімкнути. Один раз запустіть завантаження з галочкою «Товари» — воно прив'яже товари до оферів. Далі лишіть тільки «Замовлення», інакше прогін каталогу перезаписуватиме ціну й залишок цифрами з Bol.com. Ціни відправляє шаблон вивантаження типу «Bol.com», за потреби з формулою перерахунку в євро.

Що вийде. Прив'язані товари отримуватимуть нову ціну й залишок на кожному вивантаженні, а з галочкою «Публікувати нові товари» Elbuz виставлятиме й нові позиції за EAN.

Що робити, коли Bol.com не віддає чи не приймає дані

Часті запитання

Я не з Нідерландів чи Бельгії — можна підключитися?

Тільки якщо Bol.com запросив вас продавати й підключення йде через сертифікованого партнера. Це вирішується з Bol.com; з робочим акаунтом ключі створюються так само (хто може продавати).

Чому товари з Bol.com прийшли без фото?

Retailer API не віддає посилань на зображення карток. Додайте фото в Elbuz самі або з прайсу постачальника (що переноситься).

Чому після першого запуску немає старих замовлень?

Перший запуск забирає тільки відкриті замовлення. Відвантажені раніше в Elbuz не переносяться (замовлення).

Elbuz передає на Bol.com трек-номер?

Ні. Відвантаження реєструйте в кабінеті Bol.com — наступний прогін переведе замовлення в SHIPPED (замовлення).

Як продавати в Бельгії французькою?

Майданчик один на обидві країни, окремий шаблон не потрібен. Для нових карток вкажіть мову fr-BE у полі «Мова карток» і в полі «Версія API» шаблону вивантаження: fr-BE|1-2.

Товар зник із Bol.com — Elbuz його видалить?

Ні. Позиція лишиться з останньою ціною й залишком, прибирайте її руками (повторний прогін).

Суміжні теми

• Якщо потрібна загальна механіка завантаження — розклад, обрив, службові категорії: огляд завантаження даних.
• Якщо треба зрозуміти, що повторний прогін робить із замовленням менеджера: імпорт замовлень через API.
• Якщо зіставляєте категорії ще й для інших майданчиків: зіставлення категорій з маркетплейсами.
• Якщо продаєте ще й у Німеччині чи Польщі: підключення Kaufland.