Як підключити сайт Wix: товари й замовлення в Elbuz, ціни й залишки назад на сайт

Що вміє підключення Wix

• Працює з обома версіями каталогу — V1 і V3 визначаються самі.
• Переносить товар у картку — назву, опис, бренд, артикул, ціну зі знижкою, залишок, видимість, категорію й фото.
• Розкладає варіанти — кожен колір чи розмір стає окремою карткою в сім'ї.
• Переносить видимість — схований на сайті товар вимикається в Elbuz.
• Забирає замовлення документом «Замовлення покупця» зі статусами виконання й оплати.
• Повертає на сайт ціни й залишки — тільки у ваші варіанти, решту товару не чіпає.

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

Меню

Довідники → Операції → Завантаження даних

Шаблон

новий шаблон → тип «Wix.com»; один шаблон — один сайт

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

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

Підготувати

API-ключ Wix із правами Wix Stores та eCommerce, ID сайту

1

Поле «API-ключ Wix»

2

Поле «ID сайту (Site ID)»

1. Сюди вставляється API-ключ, створений у кабінеті Wix.
2. Сюди вставляється ID сайту з адресного рядка дашборда Wix.

Як працюють шаблони завантаження загалом — огляд завантаження даних.

Що потрібно від Wix: API-ключ і ID сайту

Як підключити крок за кроком

1. Створіть шаблон типу «Wix.com» і вставте в картку «Підключення» ключ та ID сайту.
2. Натисніть «Перевірити підключення» — у відповіді буде версія каталогу вашого сайту.
3. Позначте, що завантажувати: товари, замовлення чи обидва, і чи тягнути фото.
4. Збережіть шаблон і запустіть завантаження вручну.
5. Звірте кілька карток (ціна, залишок, категорія) і кілька замовлень (склад, сума, покупець) із сайтом — розбіжність краще помітити на десятку карток. Потім поставте шаблон на розклад.

Дві версії каталогу: V1 і V3

У Wix співіснують два покоління каталогу — старе (V1) і нове (V3); сайт працює тільки на одному. Elbuz визначає версію сам при кожному запуску, вам нічого обирати не треба.

Різниця одна: оновлення цін і залишків назад на сайт зроблено для V3. На V1 завантаження в Elbuz працює повністю, а зворотне оновлення — ні, і про це буде прямий запис у журналі.

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

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

Варіанти товару

Якщо у товару є варіанти — розміри, кольори, — Elbuz заводить кожен варіант окремою карткою й збирає їх у сімʼю за назвою основного товару; окремої картки на «головний товар» немає.

• Назва картки — назва товару й значення опцій через тире: «Футболка — Червоний / M».
• Артикул береться з самого варіанта, а вибір покупця (колір, розмір) лягає в характеристики-опції.
• Карток виходить більше, ніж товарів на сайті: журнал так і пише — «товарів, включно з варіантами».

Категорії

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

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

Ціну по черзі пишуть три механізми, порядок завжди однаковий:

1. Завантаження з Wix кладе ціну з сайту.
2. Правила націнки проходять лише по картках, щойно створених цим прогоном, і тільки там, де собівартість більша за нуль. Wix собівартості не передає, тож у новому товарі лишається ціна з сайту. Заповнена собівартість (руками або прайсом постачальника) — правило перекриє ціну Wix. «Фіксована ціна» і «Не оновлювати» виводять товар з-під націнки.
3. Формули полів з позначкою «Застосовувати при завантаженні БК із зовнішніх джерел» — останнє слово: вони накривають і нові, і давно заведені товари під своєю умовою.

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

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

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

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

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

1

Не оновлювати

2

Фіксована ціна

1. Не оновлювати — закриває картку від прогону Wix повністю.
2. Фіксована ціна — закриває від прогону лише ціну та стару ціну.

Товар зник із сайту або схований

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

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

Зняття активності оборотне: картка лишається в каталозі з усіма даними, тільки зникає з вітрини Elbuz. Дві речі варто знати:

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

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

Як приймати замовлення Wix

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

У документ потрапляють:

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

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

Статуси й повторний прогін

Статус документа береться зі статусу виконання через зіставлення (кнопка «Статуси замовлення»), статус оплати — зі свого зіставлення. Не зіставлений статус — перший статус довідника, тобто «як нове».

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

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

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

• Поставили ранішу дату — наступний прогін забере замовлення від неї й оновить заведені документи; дублів не буде.
• Очистили обидва поля — прогін пройде всю історію, але заведені документи не оновить, лише додасть відсутні.

1

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

2

Дата початку завантаження замовлень

3

ID початку завантаження замовлень

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

Як оновлювати ціни й залишки на сайті

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

• Нових товарів на сайті не створює — картки веде сайт. Товари без зв'язку з сайтом пропускаються, їх кількість видно в журналі.
• Нічого не видаляє на сайті — товар, знятий у Elbuz з вивантаження чи видалений, на Wix лишається таким, яким був; прибирайте його в кабінеті Wix.
• Сайт на V1 вивантаження не приймає (про версії).

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

Коли перший запуск звірено, поставте шаблон на розклад. Для замовлень розклад — єдиний шлях, тож частота визначає затримку.

Скільки тягне один прогін

Стелі на кількість товарів чи замовлень немає.

• Дані забираються сторінками по 100 позицій з паузою в секунду між ними; товари пишуться в каталог пачками по 500.
• Одного запиту програма чекає до 120 секунд, на зв'язок — 30.
• На «занадто багато запитів» — до трьох повторів із паузами 3, 6 і 9 секунд; далі прогін зупиняється з рядком «429: retry limit reached».
• Зворотне вивантаження: кожні десять товарів — рядок у журналі й коротка пауза.

Вікно шаблона можна закривати: журнал живе в Центрі операцій. Тривалість вашого каталогу видно в колонці «Витрачено часу» і в «Історії запусків».

Сценарії

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

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

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

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

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

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

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

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

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

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

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

Що вийде: наступний прогін забере замовлення, змінені після цієї дати, і оновить заведені документи (перезабрати замовлення).

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

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

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

Що робити, коли Wix не завантажується

Якщо прогін обірвався

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

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

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

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

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

Чому замовлення з Wix приходять із затримкою?

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

Чому товарів завантажилося більше, ніж є на сайті?

Варіанти стають окремими картками: товар із трьома розмірами дасть три картки, зв'язані в сімʼю. Журнал так і пише — «товарів, включно з варіантами» (варіанти).

Чи створює Elbuz нові товари на сайті Wix?

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

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

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

Замовлення скасували на сайті — чому в Elbuz воно не скасоване?

Ознака скасування Wix у документ не переноситься: Elbuz читає лише статуси виконання й оплати. Закрийте документ руками; повернення грошей видно за статусом оплати.

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

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

Суміжні теми

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