↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Сайти й CMS

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

    33 хв читанняОновлено

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

    Коли це знадобиться:

    • З'явився другий канал продажу — каталог сайту зводиться в Elbuz поруч із маркетплейсами.
    • Ціни рахуєте в Elbuz — вивантаження записує їх у варіанти на Wix.
    • Замовлення з сайту й маркетплейсів живуть окремо — вони сходяться в одну чергу документів.
    • Товар сховали на сайті — наступний прогін зніме активність картки.

    З чого почати: створіть у кабінеті Wix API-ключ і візьміть ID сайту.

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

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

    ДеЩо зробити
    Кабінет WixВідкрити manage.wix.com → «Налаштування акаунта» → «API-ключі»
    Там самоСтворити ключ із правами Wix Stores та eCommerce і скопіювати його
    Там самоВзяти ID сайту — це рядок в адресі дашборда відразу після /dashboard/
    ElbuzВікно завантаження → ваш шаблон «Wix.com» → картка «Підключення» → поля «API-ключ Wix» і «ID сайту»

    API-ключ Wix видається один раз: скопіюйте його відразу й збережіть у надійному місці. Загубився — створіть новий, старий відкличте. Без прав Wix Stores та eCommerce запити каталогу або замовлень повертатимуть відмову доступу.

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

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

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

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

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

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

    Дані WixПоле товару в Elbuz
    назва товаруНазва
    описОпис
    брендВиробник
    артикул ()Артикул
    ціна і знижена цінаЦіна (продажна) і стара ціна
    залишокКількість
    видимість товаруСтатус
    колекція / категоріяКатегорія
    зображенняФотографії (якщо ввімкнено галочку)
    опції варіанта (колір, розмір…)Характеристики-опції товару

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

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

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

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

    Категорії

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

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

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

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

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

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

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

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

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

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

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

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

    Що сталося на WixЩо буде з карткою в Elbuz
    Товар видалилиЛишається як була: з останньою ціною й залишком, активною, без рядка в журналі. Прибирайте руками
    Товар сховалиНаступний прогін зніме активність; повернули видимість — повернеться й активність
    Прибрали один варіантЙого картка лишається в сімʼї зі старими цифрами
    Сайт на V3 не віддав варіанти товаруТовар пропущено, у журналі червоний рядок із його назвою (що робити)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Сценарії

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Що робити, коли 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 відповідає «занадто багато запитів» і не відпустив після трьох спроб Запустіть пізніше, а розклад зробіть рідшим; після цього рядка прогін зупинено (межі прогону)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Меню
    Довідники → Операції → Завантаження даних
    Шаблон
    новий шаблон → тип «Wix.com»; один шаблон — один сайт
    Право доступу
    вікно «Завантаження даних» у «Правах груп»
    Підготувати
    API-ключ Wix із правами Wix Stores та eCommerce, сайту
    Картка «Підключення» шаблону Wix.com з полями API-ключа та ID сайту
    1Поле «API-ключ Wix»
    2Поле «ID сайту (Site ID)»
    1. Сюди вставляється API-ключ, створений у кабінеті Wix.
    2. Сюди вставляється ID сайту з адресного рядка дашборда Wix.

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

    Суміжні теми

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

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно