Wix — конструктор сайтів, на якому працює чимало невеликих інтернет-магазинів. Якщо ваш магазин зроблено на Wix, каталог і замовлення живуть у кабінеті Wix, і поки продажі йдуть тільки звідти, цього достатньо. Щойно з'являється другий канал — маркетплейс, опт, офлайн-точка — потрібне місце, де все зводиться докупи. Elbuz підключається до сайту Wix напряму й забирає товари та замовлення, а назад повертає ціни й залишки.
Загальний порядок для всіх API-джерел описано в огляді імпорту каталогу через API; спільні правила приймання замовлень — в огляді імпорту замовлень. Тут — особливості Wix.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «Wix.com». Це API-джерело: файл не потрібен. Підключення — два значення в картці «Підключення»: API-ключ Wix і ID сайту. Один шаблон — один сайт.
1
Поле «API-ключ Wix»2
Поле «ID сайту (Site ID)»- Сюди вставляється API-ключ, створений у кабінеті Wix.
- Сюди вставляється ID сайту з адресного рядка дашборда Wix.
Де взяти ключ і ID сайту
| Де | Що зробити |
|---|---|
| Кабінет Wix | Відкрити manage.wix.com → «Налаштування акаунта» → «API-ключі» |
| Там само | Створити ключ із правами Wix Stores та eCommerce і скопіювати його |
| Там само | Взяти ID сайту — це рядок в адресі дашборда відразу після /dashboard/ |
| Elbuz | Вікно завантаження → ваш шаблон «Wix.com» → картка «Підключення» → поля «API-ключ Wix» і «ID сайту» |
Далі натисніть «Перевірити підключення». Elbuz зробить один запит і заразом повідомить версію каталогу вашого сайту — це важлива річ, про неї нижче.
API-ключ Wix видається один раз: скопіюйте його відразу й збережіть у надійному місці. Якщо ключ загубився — створіть новий, старий можна відкликати. Права ключа мають включати Wix Stores та eCommerce, інакше запити каталогу або замовлень повертатимуть відмову доступу.
Як підключити крок за кроком
Створіть шаблон типу «Wix.com» і вставте у картку «Підключення» ключ та ID сайту. Натисніть «Перевірити підключення» — у відповіді буде версія каталогу вашого сайту. Далі позначте, що саме завантажувати: товари, замовлення чи і те, й інше, і чи тягнути фотографії. Збережіть шаблон і запустіть завантаження вручну, не чекаючи розкладу.
Перший запуск варто перевірити очима: відкрийте кілька завантажених товарів і звірте ціну, залишок і категорію з сайтом, а в кількох замовленнях — склад, суму й покупця. Це п'ять хвилин, які економлять години, бо будь-яка розбіжність краще виявляється на десятку карток, ніж на всьому каталозі. Коли результат влаштовує, поставте шаблон на розклад.
Дві версії каталогу: V1 і V3
У Wix співіснують дві покоління каталогу магазину — стара (V1) і нова (V3). Сайт працює тільки на одній з них, і структура даних у них різна. Elbuz визначає версію сам при кожному запуску й читає каталог відповідним способом, тож від вас тут нічого не потрібно. Знати про це варто з однієї причини: оновлення цін і залишків назад на сайт зроблено для каталогу V3. Якщо ваш сайт ще на V1, завантаження в Elbuz працює повністю, а зворотне оновлення — ні; про це буде прямий запис у журналі, а не мовчазний пропуск.
Що приходить у каталог
| Дані Wix | Поле товару в Elbuz |
|---|---|
| назва товару | Назва |
| опис | Опис |
| бренд | Виробник |
| артикул (SKU) | Артикул |
| ціна і знижена ціна | Ціна (продажна) і стара ціна |
| залишок | Кількість |
| видимість товару | Статус |
| колекція / категорія | Категорія |
| зображення | Фотографії (якщо ввімкнено галочку) |
| опції варіанта (колір, розмір…) | Характеристики-опції товару |
Ціна береться так, як її бачить покупець: якщо у Wix задано знижену ціну, продажною стає вона, а повна лягає в «стару ціну» — тобто перекреслений цінник із сайту зберігається й у вас.
Варіанти товару
Якщо у товара на сайті є варіанти — розміри, кольори, — Elbuz розкладає їх у сімʼю товарів: головний товар і його варіанти окремими картками, звʼязаними між собою, а вибір покупця (колір, розмір) стає опцією. Назва варіанта збирається з назви товару й значень опцій, а артикул береться з самого варіанта. Тому число завантажених карток закономірно більше за число товарів на сайті: у журналі Elbuz так і пише — «товарів, включно з варіантами».
Elbuz спершу читає список колекцій (у V3 — категорій) сайту й тільки потім розкладає товари. Якщо список отримати не вдалося (наприклад, ключу бракує прав), товари не губляться: вони потраплять у службову категорію джерела, і ви розкладете їх по своєму дереву вручну. У журналі про це буде окремий рядок.
Замовлення
Замовлення Elbuz читає з єдиного шару eCommerce, тож версія каталогу тут ролі не грає. Перший запуск переносить історію; далі забираються ті замовлення, що змінилися з моменту минулого запуску, — і вже завантажені при цьому оновлюються, а не дублюються.
У документ потрапляють номер замовлення, дати створення й зміни, ім'я та прізвище отримувача, телефон, пошта покупця, адреса доставки з містом, індексом і країною, валюта, спосіб доставки, сума замовлення й позиції з артикулом, ціною та кількістю. Окремо приходять статус виконання і статус оплати — це різні поля, і зіставляються вони різними таблицями у картці «Пов'язані налаштування».
Миттєве сповіщення про нове замовлення Wix віддає лише застосункам зі свого App Market. За підключення API-ключем такої можливості немає, тому замовлення приходять за розкладом, а не в ту ж секунду. Для активного магазину має сенс поставити частіший розклад — кільканадцять разів на день; затримка дорівнює інтервалу між запусками.
Оновлення цін і залишків на сайті
Зворотний напрямок — окремий шаблон вивантаження типу «Wix.com». Тут є важлива особливість, через яку все й зроблено саме так: Wix не вміє оновлювати окремий варіант точково. Тому Elbuz читає товар цілком, підміняє ціни й залишки тільки у ваших варіантів і повертає товар одним викликом. Варіанти, яких немає в Elbuz, і структура товара при цьому лишаються недоторканими — сайт залишається господарем карток.
Нові товари на сайті це вивантаження не створює. Сценарій тут інший: магазин на Wix уже працює, картки веде сайт, а Elbuz відповідає за ціни й наявність. Товари, у яких немає звʼязку з сайтом, просто пропускаються, і їх кількість видно в журналі.
Навіщо зводити Wix в Elbuz
Сайт на Wix зручний, поки канал один. Далі починається знайоме: ціни правляться у двох місцях, залишок «поїхав», замовлення з маркетплейсу живуть окремо від замовлень із сайту. Elbuz бере на себе роль єдиного каталогу — з нього ціни й наявність роз'їжджаються на всі канали, а замовлення з усіх каналів сходяться в одну чергу обробки. Сайт при цьому лишається сайтом: покупець нічого не помічає, змінюється тільки те, звідки беруться цифри.
Часті питання
Де взяти API-ключ Wix і ID сайту?
Ключ створюється в кабінеті Wix: manage.wix.com → «Налаштування акаунта» → «API-ключі», з правами Wix Stores та eCommerce. ID сайту — це рядок в адресі дашборда після /dashboard/. Обидва значення вставляються у картку «Підключення» у шаблоні.
Що таке версія каталогу V1 і V3 і чи треба щось обирати?
Це два покоління каталогу Wix; ваш сайт працює на одному з них. Обирати нічого не потрібно — Elbuz визначає версію сам. Різниця в одному: зворотне оновлення цін і залишків зроблено для V3. Для сайтів на V1 завантаження працює, а вивантаження — ні, і про це пишеться в журнал.
Чому замовлення з Wix приходять із затримкою?
Миттєві сповіщення Wix віддає тільки застосункам зі свого App Market; підключення за API-ключем їх не отримує. Тому Elbuz забирає замовлення за розкладом, і затримка дорівнює інтервалу між запусками. Поставте частіший розклад, якщо замовлення потрібні швидше.
Чому товарів завантажилося більше, ніж є на сайті?
Тому що варіанти стають окремими картками: товар із трьома розмірами дасть три картки, зв'язані в сімʼю, плюс опції з назвами розмірів. У журналі Elbuz так і пише — «товарів, включно з варіантами».
Чи створює Elbuz нові товари на сайті Wix?
Ні. Вивантаження оновлює ціни й залишки наявних товарів, а картками володіє сайт. Товари без звʼязку з сайтом пропускаються, їх кількість видно в журналі.