Імпорт товарів і замовлень із сайту Wix

36 хв

Wix — конструктор сайтів, на якому працює чимало невеликих інтернет-магазинів. Якщо ваш магазин зроблено на Wix, каталог і замовлення живуть у кабінеті Wix, і поки продажі йдуть тільки звідти, цього достатньо. Щойно з'являється другий канал — маркетплейс, опт, офлайн-точка — потрібне місце, де все зводиться докупи. Elbuz підключається до сайту Wix напряму й забирає товари та замовлення, а назад повертає ціни й залишки.

Загальний порядок для всіх API-джерел описано в огляді імпорту каталогу через API; спільні правила приймання замовлень — в огляді імпорту замовлень. Тут — особливості Wix.

Де це у програмі

У вікні завантаження створіть шаблон і оберіть тип «Wix.com». Це API-джерело: файл не потрібен. Підключення — два значення в картці «Підключення»: API-ключ Wix і ID сайту. Один шаблон — один сайт.

Картка «Підключення» шаблону Wix.com з полями API-ключа та ID сайту
1Поле «API-ключ Wix»
2Поле «ID сайту (Site ID)»
  1. Сюди вставляється API-ключ, створений у кабінеті Wix.
  2. Сюди вставляється 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 заводить кожен варіант окремою карткою й збирає їх у сімʼю за назвою основного товару; окремої картки на «головний товар» при цьому не створюється. Назва картки збирається з назви товару й значень опцій через тире («Футболка — Червоний / M»), артикул береться з самого варіанта, а вибір покупця (колір, розмір) лягає в характеристики-опції. Тому число завантажених карток закономірно більше за число товарів на сайті: у журналі Elbuz так і пише — «товарів, включно з варіантами».

Elbuz спершу читає список колекцій (у V3 — категорій) сайту й тільки потім розкладає товари. Якщо список отримати не вдалося (наприклад, ключу бракує прав), товари не губляться: вони потраплять у службову категорію «Товари - wix», і ви розкладете їх по своєму дереву вручну. Категорія створюється вимкненою й без участі у вивантаженнях, а в журналі про це буде окремий рядок.

нітакні, помилка APIтакнітакпомилка APIтакніЗапуск шаблону згалочкою «Товари»API-ключзаповнено?Червоний рядок у журналікаталог без змінСайт повідомивверсію каталогу?Список категорійотримано?Рядок-попередженнятовари підуть у «Товари -wix»Читання сторінки на 100товарівспособом V1 або V3Прогін зупиненозаписані пачки лишаютьсяКоли набралося 500позицій —запис пачки в каталогЄ наступна сторінкаі не натиснуто«Зупинити»?Запис решти позицій«Wix: каталогзавантажено»
Шлях одного прогону каталогу: обірвати його можуть відсутній ключ, помилка API або кнопка «Зупинити», а без категорій товари все одно приїдуть — у службову категорію

Що робить повторний прогін з вашими правками

Кожен наступний запуск перезаписує в уже заведеній картці все, що прийшло з Wix цього разу: назву, опис, бренд, артикул, ціну, стару ціну, кількість і активність. Виправили назву або дописали опис у Elbuz — наступний прогін поверне туди текст із сайту, і жодного попередження при цьому не буде.

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

Чого повторний прогін у вже заведеної картки не чіпає: фотографій (вони додаються тільки новим карткам), характеристик-опцій, місця товару у вашому дереві категорій, адреси сторінки, собівартості й усіх полів, яких у Wix просто немає.

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

нітактакнітакніТовар або варіант із WixУ каталозі є картказ тим самим відбиткомназви?Нова картказ фото, якщо увімкнено«Фото»У картці увімкнено«Не оновлювати»?Картка лишається як булаНазва, опис, бренд,артикул,кількість і активність — ізWixУ картці увімкнено«Фіксована ціна»?Ціна й стара ціналишаються вашіЦіна й стара ціна — із Wix
Два перемикачі картки вирішують, що прогін у ній змінить: «Не оновлювати» закриває картку цілком, «Фіксована ціна» — тільки ціни
Секція «Захист під час імпорту» у картці товару
1Не оновлювати
2Фіксована ціна
  1. Не оновлювати — закриває картку від прогону Wix повністю.
  2. Фіксована ціна — закриває від прогону лише ціну та стару ціну.

Чия ціна лишиться в картці

Ціну в картці по черзі пишуть три механізми, і порядок у них завжди однаковий. Спершу завантаження з Wix кладе ціну з сайту. Потім по щойно створених картках проходять правила націнки базового каталогу. Останніми виконуються формули полів — ті, у яких стоїть позначка «Застосовувати при завантаженні БК із зовнішніх джерел».

Правило націнки рахує ціну від собівартості й спрацьовує тільки там, де собівартість більша за нуль. Wix собівартості не передає, тож у щойно заведеного товара правилу нема від чого рахувати — у картці лишається ціна з сайту. А якщо собівартість заповнена (руками або прайс-листом постачальника), правило націнки відпрацює після завантаження й перекриє ціну Wix.

Друга особливість: правила націнки проходять лише по картках, які створив саме цей прогін. Товари, що вже були в каталозі, після повторного завантаження лишаються з ціною Wix — націнка їх не перераховує. Обидві позначки картки, і «Фіксована ціна», і «Не оновлювати», виводять товар з-під правил націнки.

Формула поля — останнє слово. Вона виконується після завантаження й після націнки та накриває всі товари, що підпадають під її умову, — і нові, і давно заведені. Якщо у вас є формула для ціни з тією позначкою, у картці лишиться її результат, а не цифра з сайту.

Що буде з товаром, який зник із сайту

Тут Wix поводиться так само, як решта прямих підключень: що прийшло — те й оновили. Товар, якого в цьому прогоні не було, лишається в каталозі таким, як був — з останньою відомою ціною й останнім відомим залишком. Він не вимикається, залишок не обнуляється, у журналі про нього не буде ані рядка. Галочки «видаляти те, чого немає в джерелі» у шаблоні Wix немає взагалі. Тому зняті з продажу позиції доводиться прибирати руками.

Зовсім інша річ — сховати товар на сайті. Видимість приїжджає окремим полем і стає активністю картки: наступний прогін зніме з неї активність. Повернули видимість на Wix — прогін так само поверне активність, нічого доробляти не треба. Саме тому ховати товар на сайті надійніше, ніж видаляти: сховане доїде до Elbuz, видалене — ні.

Прибрали на сайті один варіант із товару — його картка в Elbuz лишається в сімʼї зі старими цифрами: у прогоні її просто не було, а чужі картки прогін не чіпає.

І окремий випадок, коли товар є на сайті, але в каталог не приїхав: якщо сайт працює на V3 і не віддав варіанти конкретного товару, Elbuz такий товар пропускає й пише в журнал червоний рядок «Wix: сайт не віддав варіанти товару — товар пропущено, повідомте в підтримку» з назвою товару в дужках. Це не мовчазна втрата: рядок у журналі є, і його варто показати підтримці.

Зняти активність чи видалити картку

Зняття активності — оборотна дія. Картка лишається в каталозі й у сітках, її видно, можна редагувати, усі дані на місці; вона тільки зникає з вітрини Elbuz. Увімкнули назад — усе повернулося.

Але дві речі варто знати заздалегідь. Перша: вивантаження на Wix неактивну картку все одно бере. У вивантаження товар відбирається за прапорцем «Вивантажувати у файл (на сайт)» і за активною категорією, а не за активністю самої картки, — тож ціна й залишок вимкненого товара поїдуть на сайт, якщо ви самі не додали умову за активністю у відбір шаблона вивантаження. Друга: активність цієї картки веде сайт. Увімкнули її руками, а на Wix товар лишився схованим — найближчий прогін знову вимкне картку.

Видалення — операція іншого порядку. Разом із карткою зникає її прив'язка до товара на Wix. Вивантаження після цього перестає такий товар бачити, а наступне завантаження каталогу заведе картку наново — як новий товар, з новою датою додавання й новою адресою сторінки. Ваші правки в ній при цьому не повертаються.

Замовлення

Замовлення Elbuz читає з єдиного шару eCommerce, тож версія каталогу тут ролі не грає. Перший запуск переносить історію; далі забираються ті замовлення, що змінилися з моменту минулого запуску, — і вже завантажені при цьому оновлюються, а не дублюються.

У документ потрапляють номер замовлення, дати створення й зміни, ім'я та прізвище отримувача, телефон, пошта покупця, адреса доставки з містом, індексом і країною, валюта, спосіб доставки, сума замовлення й позиції з артикулом, ціною та кількістю. Окремо приходять статус виконання і статус оплати — це різні поля, і зіставляються вони різними таблицями у картці «Пов'язані налаштування».

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

Статус документа береться зі статусу виконання Wix через зіставлення (кнопка «Статуси замовлення» в секції «Пов'язані налаштування»), статус оплати — окремо, зі свого зіставлення. Якщо статус із Wix не зіставлений, документ лягає з першим статусом довідника — тобто «як нове».

Повторний прогін уже заведений документ не дублює й не переписує наосліп. Ваш статус обробки він міняє тільки тоді, коли статус на боці Wix реально змінився з минулого разу; поки на сайті все як було, документ лишається в тому статусі, у який його поставив менеджер. Статуси оплати й доставки, способи оплати й доставки приймаються з сайту як є. А проведений документ прогін не чіпає взагалі — жодного поля.

такнінітак, режим без датитак, режим з датоютакнітакніЗапуск шаблону згалочкою «Замовлення»Заповнено«Завантаження замовленьпочинаючи з дати»?Замовлення, змінені післядати —нові додаються, заведеніоновлюютьсяУся історія або номерипісля«починаючи з ID» —тільки новіДокумент для цьогозамовлення вже є?Новий документ«Замовлення покупця»непроведенийДокумент не змінюєтьсяДокументпроведений?Статус виконання на Wixзмінився з минулого разу?Статус — зі зіставленняоплата й доставка — ізWixСтатус лишається вашоплата й доставка — ізWix
Без дати — перший прогін або перезабір усієї історії, з датою — звичайні запуски за розкладом, коли дата вже стоїть

Elbuz читає з замовлення Wix два статуси — виконання й оплату. Окреме поле «стан замовлення», яким Wix позначає скасування, у документ не переноситься. Тому замовлення, скасоване в кабінеті Wix, лишиться в Elbuz у тому статусі, у якому було, і закривати його доведеться руками. Повернення грошей видно інакше — за статусом оплати, який Wix у цьому разі змінює.

Позиція замовлення шукає свою картку спершу за ID товара Wix, потім за артикулом і назвою. Для товара з варіантами ID у замовленні вказує на товар, а не на конкретний варіант, а картка варіанта в Elbuz зветься «назва — колір / розмір». Збігу немає ні за ID, ні за назвою — і в документ підставляється нова картка, створена у вимкненій службовій категорії «Товари - wix - назва вашого шаблону». Якщо в замовленнях трапляються такі позиції, звіряйте їх із каталогом: у сімʼї варіантів списання піде повз потрібну картку.

Миттєве сповіщення про нове замовлення Wix віддає лише застосункам зі свого App Market. За підключення API-ключем такої можливості немає, тому замовлення приходять за розкладом, а не в ту ж секунду. Для активного магазину має сенс поставити частіший розклад — кільканадцять разів на день; затримка дорівнює інтервалу між запусками.

Якщо прогін обірвався посеред роботи

Каталог не чекає кінця прогону: товари пишуться в базовий каталог пачками по 500 позицій, щойно набереться пачка. Тому обрив ділить результат надвоє — усе, що встигло дійти пачками, вже оновлене, решта лишилася зі старими даними. Повторний запуск безпечний: товар знаходиться за тим самим відбитком назви, тож прогін просто перезапише ті самі картки й добере ті, до яких не дійшов. Дублів не зʼявиться.

Замовлення поводяться так само ощадливо. Сторінка (до 100 замовлень) зберігається одразу, і відразу ж посувається позначка «завантажувати починаючи з дати». Тому наступний запуск продовжить із того місця, де обірвалось, а не почне історію спочатку. Документ шукається за ідентифікатором замовлення Wix і кодом джерела, тож задвоїти замовлення прогін не може.

Різниця між першим прогоном і наступними — саме в цій позначці. Поки дата порожня (перенесення історії), прогін тільки додає замовлення, яких ще немає, і вже заведені документи не оновлює. Щойно дата зʼявилася, кожен наступний прогін забирає змінені замовлення й оновлює вже заведені документи.

Зупинка не обриває прогін посеред сторінки. Elbuz дочитує поточну сторінку (до 100 товарів або замовлень), записує все вже отримане й наступної сторінки не бере. Для каталогу після цього ще відпрацьовують правила націнки по щойно заведених картках, а в журналі лишається звичайний підсумковий рядок «Wix: каталог завантажено». Наступний запуск продовжить так само, як після обриву.

Межі одного прогону

Стелі на кількість товарів чи замовлень немає: скільки віддасть сайт, стільки й приїде. Дані забираються сторінками по 100 позицій, між сторінками Elbuz витримує паузу в секунду, щоб не впертися в ліміти Wix (вони не опубліковані). Товари складаються в каталог пачками по 500.

Одного запиту програма чекає до 120 секунд, на встановлення зв'язку відводить 30. Якщо Wix відповідає «занадто багато запитів», запит повторюється до трьох разів із паузою, що зростає з кожною спробою — три секунди, шість, девʼять; не допомогло — прогін зупиняється, а в журналі лишається рядок «429: retry limit reached». Зворотне вивантаження йде ще неквапливіше: кожні десять товарів — рядок у журналі й коротка пауза.

Вікно шаблона можна закривати. Журнал прогону живе в Центрі операцій — правій панелі, яка не блокує роботу, — тож стежити за завантаженням можна з будь-якого місця програми, а закриття картки шаблона прогін не перериває. Скільки триває саме ваш каталог, вигадувати не треба: це видно в колонці «Витрачено часу» списку шаблонів і у вікні «Історія запусків».

Якщо завантажили не те

Порядок пошуку й прибирання наслідків спільний для всіх API-підключень і описаний в огляді імпорту каталогу: товари цього шаблона відбираються у вікні «Товари» за колонкою «Джерело: назва», а картки, які у вас уже були і які прогін лише перезаписав, — за колонкою «Дата оновлення» (програма ставить її кожній зміненій картці).

Дві речі специфічні саме для Wix. Перша: видаляючи картки пакетом, ви видаляєте разом із ними й прив'язку до товарів сайту — вивантаження такі товари більше не бачить, а наступне завантаження каталогу заведе їх наново, новими картками.

Друга — замовлення можна перезабрати. У картці шаблона розкрийте блок «Розширене»: там лежать поля «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» і «Завантаження замовлень починаючи з ID». Поставили ранішу дату — наступний прогін забере замовлення від неї наново й оновить уже заведені документи; дублів не буде. Очистили обидва поля — прогін пройде по всій історії, але вже заведені документи при цьому не оновляться, додадуться тільки ті, яких ще немає.

Картка «Повʼязані налаштування» з розкритим блоком «Розширене»
1Статуси замовлення
2Дата початку завантаження замовлень
3ID початку завантаження замовлень
  1. Статуси замовлення — кнопка відкриває зіставлення статусів замовлень Wix.
  2. Завантаження замовлень починаючи з дати (РРРР-ММ-ДД) — нижня межа за датою.
  3. Завантаження замовлень починаючи з ID — нижня межа за номером замовлення.

Оновлення цін і залишків на сайті

Зворотний напрямок — окремий шаблон вивантаження типу «Wix.com». Тут є важлива особливість, через яку все й зроблено саме так: Wix не вміє оновлювати окремий варіант точково. Тому Elbuz читає товар цілком, підміняє ціни й залишки тільки у ваших варіантів і повертає товар одним викликом. Варіанти, яких немає в Elbuz, і структура товара при цьому лишаються недоторканими — сайт залишається господарем карток.

Нові товари на сайті це вивантаження не створює. Сценарій тут інший: магазин на Wix уже працює, картки веде сайт, а Elbuz відповідає за ціни й наявність. Товари, у яких немає звʼязку з сайтом, просто пропускаються, і їх кількість видно в журналі.

Видаляти на сайті вивантаження теж нічого не вміє. Товар, знятий у Elbuz з вивантаження або видалений із каталогу, на Wix лишається таким, яким був востаннє, — прибирати його треба в кабінеті Wix.

ні або помилка APIтакнітакнітакнітакЗапуск шаблонувивантаження «Wix.com»Сайт працюєна каталозі V3?Червоний рядок у журналіна сайті нічого не зміненоТовар має привʼязкудо товару Wix?Пропущено — підсумок«пропущено товарів безпривʼязки»Товар прочитано з сайтуі ваш варіант у ньомузнайдено?Червоний рядок «Wix:помилка вивантаження»далі наступний товарЦіна, стара ціна й залишокваших варіантіврешта варіантів без змінСайт прийняв зміни?Позиції йдуть у підсумок«ціни та залишкионовлено»
Кожен товар вивантаження проходить три перевірки; помилка по одному товару не зупиняє решту, а сайт на V1 не пропускає далі першого ж кроку

Сценарії

Каталог веде сайт, Elbuz зводить його з іншими каналами

Задача: картки й ціни ви правите в кабінеті Wix, а в Elbuz вони потрібні для маркетплейсів і обліку.

Що ввімкнути: у шаблоні завантаження типу «Wix.com», у картці «Вибір даних для завантаження», — галочки «Товари» і «Фото», далі розклад.

Що вийде: кожен прогін приносить у картки назву, опис, бренд, артикул, ціну, кількість і активність із сайту. Фото дістаються тільки новим карткам: заведеній картці нові знімки із сайту не додаються. Товар, видалений на Wix, у каталозі лишиться з останніми цифрами — знімати його з продажу краще, ховаючи на сайті: тоді наступний прогін зніме активність картки.

Ціни й наявність веде Elbuz, сайт їх лише показує

Задача: ціни рахуються в Elbuz (від закупівлі, за правилами), а на Wix мають з'являтися готові цифри.

Що ввімкнути: один раз завантажте каталог із галочкою «Товари», щоб картки отримали привʼязку до товарів сайту. Далі або зніміть у шаблоні завантаження галочку «Товари», лишивши «Замовлення», або ввімкніть у картках «Фіксована ціна». Ціни на сайт відправляє окремий шаблон вивантаження типу «Wix.com».

Що вийде: вивантаження записує ціну, стару ціну й залишок у ті варіанти на Wix, з якими картки повʼязані; решта варіантів товару лишається як була. Чого не буде: нових товарів на сайті не з'явиться, картки без привʼязки пропускаються, а сайт на каталозі V1 вивантаження не приймає. Якщо лишити «Товари» без фіксованої ціни, наступне завантаження поверне в картки ціни із сайту.

Замовлення із сайту — в одну чергу з іншими каналами

Задача: менеджер обробляє замовлення Wix у Elbuz разом із замовленнями маркетплейсів.

Що ввімкнути: галочку «Замовлення», зіставлення кнопкою «Статуси замовлення» у «Повʼязаних налаштуваннях» і розклад.

Що вийде: кожне замовлення стає непроведеним документом «Замовлення покупця», повторний прогін його не дублює. Статус, який поставив менеджер, прогін змінює лише тоді, коли статус виконання на Wix змінився з минулого разу. Чого не буде: залишок у каталозі від завантаженого замовлення не рухається, а проведений документ прогін не чіпає.

Перезабрати замовлення за період

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

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

Що вийде: наступний прогін забере замовлення, змінені після цієї дати, і оновить уже заведені документи — дублів не буде, бо документ шукається за ідентифікатором замовлення Wix. Чого не буде: якщо очистити і дату, і «починаючи з ID», прогін пройде всю історію, але вже заведені документи не оновить — лише додасть відсутні.

Закрити окремі картки від сайту

Задача: для кількох товарів у Elbuz стоїть своя ціна або своя назва, і сайт не повинен їх перезаписувати.

Що ввімкнути: у картці товару, секція «Захист під час імпорту»: «Фіксована ціна» — якщо берегти треба тільки ціну, «Не оновлювати» — якщо всю картку.

Що вийде: з «Фіксованою ціною» ціна й стара ціна лишаються вашими, а назва, опис, кількість і активність оновлюються із сайту. З «Не оновлювати» прогін не змінює в картці нічого — ні ціни, ні залишку, ні активності, тож і сховану на Wix позицію доведеться вимикати руками.

Розбір частих проблем

Що пише журнал і що з цим робити
Що ви бачитеЧому такЩо зробити
«Wix: вкажіть API-ключ і ID сайту» У шаблоні немає ключа Вставте ключ і ID сайту в картку «Підключення» (де їх узяти)
«Wix: помилка API —» і текст відмови від сайту Ключ недійсний, відкликаний або йому бракує прав Wix Stores та eCommerce; рідше — сайт тимчасово недоступний Натисніть «Перевірити підключення». За потреби створіть у кабінеті Wix новий ключ із потрібними правами
«Wix: не вдалося отримати список категорій — товари потраплять у категорію джерела» Список колекцій не прийшов — найчастіше ключу бракує прав Товари не губляться: розкладіть їх із категорії «Товари - wix» по своєму дереву або виправте права ключа й запустіть ще раз
«Wix: сайт не віддав варіанти товару — товар пропущено, повідомте в підтримку» Сайт на V3 не повернув варіанти саме цього товару У каталог він не приїхав зовсім. Назва товару стоїть у тому ж рядку журналу — передайте її в підтримку
«Wix: сайт працює на старій версії каталогу (V1) — вивантаження підтримує V3» Зворотне оновлення зроблено для нового каталогу (про версії) Завантаження з сайту при цьому працює повністю; про вивантаження для V1 напишіть у підтримку
«Wix: пропущено товарів без прив'язки до сайту» У цих товарів немає звʼязку з карткою на Wix: їх завели не із сайту Спершу виконайте завантаження каталогу з Wix — звʼязок ставиться саме там (докладніше)
«429: retry limit reached» Wix відповідає «занадто багато запитів» і не відпустив після трьох спроб Запустіть пізніше, а розклад зробіть рідшим; після цього рядка прогін зупинено (межі прогону)

Навіщо зводити 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?

Ні. Вивантаження оновлює ціни й залишки наявних товарів, а картками володіє сайт. Товари без звʼязку з сайтом пропускаються, їх кількість видно в журналі.

Чи затре повторний прогін мої правки в картці?

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

Що буде з товаром, який я прибрав із сайту Wix?

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

Чи змінює завантажене замовлення залишок у каталозі?

Ні. Замовлення лягає документом «Замовлення покупця» і лягає непроведеним, а резерв під замовленням зʼявляється тільки після проведення документа — і лише при увімкненому складському обліку. До того моменту ні залишок, ні вільна кількість не рухаються.

Чи була стаття корисною?