K2 Модуль Wix

K2 Модуль Wix — це інтеграційний модуль для обміну даними між K2 ERP та платформою Wix / Wix Stores. Він використовується для автоматизації роботи з товарами, каталогом, цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, статусами, поверненнями та фіскалізацією.

Wix надає API для інтеграції з бізнес-рішеннями платформи, зокрема eCommerce, Stores, Orders, CRM, Payments та іншими сервісами. У документації Wix зазначено, що Orders API дозволяє керувати життєвим циклом замовлення, переглядати, оновлювати та скасовувати замовлення, а саме замовлення містить товари, ціни, податки, доставку, оплату та fulfillment-статуси. :contentReference[oaicite:0]{index=0}

Важливо: K2 Модуль Wix не замінює інтернет-магазин і не замінює ERP. Wix відповідає за сайт, вітрину, кошик, оформлення замовлення і клієнтський досвід, а K2 ERP має бути центральною системою для товарів, залишків, цін, документів, складів, оплат, доставок і фіскалізації.

Загальний опис

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

Без інтеграції менеджерам доводиться вручну переносити товари, ціни, залишки, клієнтів і замовлення між Wix та ERP. Це створює ризики: застарілі залишки, неправильні ціни, дублікати замовлень, несвоєчасне оновлення статусів, помилки під час відвантаження та складність контролю фіскалізації.

K2 Модуль Wix автоматизує обмін даними. K2 ERP може виступати головним джерелом товарів, цін, залишків, складів, документів, оплат і фіскалізації, а Wix — зовнішнім каналом продажів і онлайн-вітриною для покупців.

Зверніть увагу: конкретні можливості модуля залежать від доступних Wix API, прав застосунку, тарифу Wix, структури товарів, locations, способів доставки, оплат, податків, валюти та бізнес-логіки K2 ERP.

Для чого потрібен K2 Модуль Wix

K2 Модуль Wix потрібен для автоматизації обміну між ERP і Wix.

Основні задачі модуля:

передавання товарів із K2 ERP у Wix;
оновлення назв, описів, фото, варіантів і характеристик;
синхронізація цін;
синхронізація залишків;
робота з кількома локаціями або складами;
отримання замовлень із Wix;
створення замовлень клієнта в K2 ERP;
створення або оновлення карток клієнтів;
передавання статусів замовлень назад у Wix;
передавання fulfillment-даних;
передавання tracking number;
контроль оплат;
контроль повернень;
підготовка даних для фіскалізації;
зберігання історії обміну;
обробка помилок інтеграції.

Основні можливості

K2 Модуль Wix може забезпечувати такі можливості:

підключення одного або кількох Wix-сайтів;
налаштування доступу до Wix API;
імпорт товарів із Wix;
експорт товарів у Wix;
оновлення товарних карток;
робота з product variants;
робота з collections;
синхронізація цін;
синхронізація залишків;
отримання нових замовлень;
отримання клієнтів;
отримання оплат і фінансових статусів;
отримання fulfillment-статусів;
передавання fulfillment-даних;
передавання tracking number;
обробка повернень;
робота з webhooks;
зіставлення товарів за SKU або Wix ID;
зіставлення способів доставки;
зіставлення способів оплати;
журнал API-запитів;
повторна обробка помилок;
ручний і автоматичний режим синхронізації.

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

Wix Stores API

Wix Stores API використовується для роботи з каталогом товарів, collections, media та інвентарем магазину. У документації Wix зазначено, що Wix Stores Catalog API дозволяє отримувати окремі товари, collections або весь каталог, а також створювати товари й додавати до них media. :contentReference[oaicite:1]{index=1}

Wix також вводить Catalog V3 для Stores. У документації Wix зазначено, що Catalog V3 має покращити керування product variants, inventory, customization options і store management. :contentReference[oaicite:2]{index=2}

Типові напрями роботи з каталогом:

products;
variants;
collections;
media;
prices;
metadata;
inventory items;
availability;
catalog synchronization.

Products API

Products API дозволяє створювати й керувати товарами магазину, зокрема variants, pricing, media та metadata. :contentReference[oaicite:3]{index=3}

З K2 ERP у Wix можуть передаватися:

назва товару;
опис;
SKU;
barcode;
ціна;
стара ціна або акційна ціна;
фото;
media;
collections;
variants;
options;
вага;
статус активності;
SEO-поля за потреби;
metadata або custom data за підтримки API.

З Wix у K2 ERP можуть завантажуватися:

Wix product ID;
variant ID;
inventory item ID;
назва;
SKU;
ціна;
залишок;
collections;
media;
статус товару;
варіанти товару.

Inventory Items API

Inventory Items API дозволяє керувати запасами товарів у Wix Stores. У документації Wix зазначено, що inventory item відстежує залишок конкретного product variant у конкретній location, а API дозволяє створювати й керувати inventory items, відстежувати stock levels, змінювати quantities та налаштовувати preorder. :contentReference[oaicite:4]{index=4}

Можливі сценарії синхронізації залишків:

залишок з одного складу K2 ERP передається в одну Wix location;
кілька складів K2 ERP зіставляються з кількома Wix locations;
у Wix передається доступний залишок з урахуванням резервів;
залишок оновлюється за розкладом;
залишок оновлюється після складського руху;
при нульовому залишку товар змінює доступність;
залишок обмежується мінімальним або максимальним значенням для показу.

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

Wix eCommerce Orders API

Wix eCommerce Orders API дозволяє працювати з життєвим циклом замовлення. Замовлення містить purchased items, price and tax summaries, shipping and billing information, discounts, payment status і fulfillment status. :contentReference[oaicite:5]{index=5}

Із замовлення можуть завантажуватися:

Wix order ID;
номер замовлення;
дата створення;
дата оновлення;
покупець;
email;
телефон;
billing address;
shipping address;
список товарів;
product ID;
variant ID;
SKU;
кількість;
ціна;
знижки;
податки;
доставка;
загальна сума;
валюта;
payment status;
fulfillment status;
payment method;
shipping method;
note;
applied discounts;
refund-дані за потреби.

У K2 ERP на підставі замовлення Wix може створюватися:

замовлення клієнта;
картка клієнта;
резерв товару;
завдання на пакування;
документ оплати;
документ доставки;
фіскальний чек;
видаткова накладна;
документ повернення.

Orders Settings API

Orders Settings API дозволяє отримувати й оновлювати налаштування, які застосовуються до eCommerce orders, зокрема customer email notifications, правила оновлення store inventory та створення invoices. :contentReference[oaicite:6]{index=6}

Для інтеграції з K2 ERP важливо знати:

коли Wix зменшує залишок;
чи створюються invoices;
які email-повідомлення надсилаються покупцю;
які налаштування впливають на order lifecycle;
чи не дублює ERP ті самі дії, які вже виконує Wix.

Webhooks

Wix підтримує події через webhooks. У документації Wix зазначено, що self-hosted app має реалізувати власний webhook endpoint, а event data надходить як JWT, який потрібно перевіряти. :contentReference[oaicite:7]{index=7}

Webhook може повідомляти K2 ERP про такі події:

створено замовлення;
оновлено замовлення;
створено товар;
оновлено товар;
створено inventory item;
змінено inventory item;
змінено fulfillment;
змінено оплату;
створено повернення;
оновлено клієнта.

Інтеграційний акцент: webhooks бажано використовувати разом із періодичною звіркою. Webhook пришвидшує реакцію на подію, а регулярна синхронізація допомагає знайти пропущені або некоректно оброблені зміни.

Авторизація і доступ

Для інтеграції K2 ERP із Wix потрібно налаштувати застосунок або інтеграційний доступ із потрібними permissions. У документації Wix для API та webhooks окремо вказуються permissions, наприклад Read Orders або Read inventory. :contentReference[oaicite:8]{index=8}

У модулі Wix бажано зберігати:

назву підключення;
Wix site ID;
account або app connection;
access token або інший механізм авторизації;
permissions;
дату створення підключення;
статус підключення;
користувача, який налаштував інтеграцію;
дату останньої перевірки;
журнал помилок авторизації.

Не плутати: access token або інший ключ доступу до Wix API — це секретний доступ до даних магазину. Його не можна передавати стороннім особам, зберігати у відкритому коді, публікувати в логах або відправляти в незахищених повідомленнях.

Синхронізація товарів

Синхронізація товарів дозволяє передавати асортимент із K2 ERP у Wix або отримувати товари з Wix в ERP.

Можливі правила:

K2 ERP є головним джерелом товарів;
Wix є головним джерелом вітринного опису;
ERP оновлює тільки ціни й залишки;
ERP оновлює повну товарну картку;
фото оновлюються окремо;
частина товарів не експортується в Wix;
тільки товари з ознакою «Публікувати у Wix» потрапляють у магазин;
окремі товари можуть бути приховані або недоступні для продажу.

Variants і options

У Wix Stores товар може мати варіанти. Наприклад, одяг може мати розмір і колір, а кожна комбінація варіантів може мати власний SKU, ціну та залишок.

У K2 ERP потрібно визначити, як варіанти Wix зіставляються з товарами ERP.

Можливі підходи:

кожен Wix variant відповідає окремому товару K2 ERP;
один товар K2 ERP має характеристики, які експортуються як Wix options;
Wix product використовується як група, а variants — як окремі складські позиції;
зіставлення виконується за SKU;
зіставлення виконується за Wix variant ID;
зіставлення виконується вручну через таблицю відповідності.

Для обліку: у більшості ERP-сценаріїв саме variant, а не product, є реальною складською позицією. Тому для залишків, резервів і відвантаження бажано зберігати Wix product ID, variant ID та inventory item ID.

Синхронізація цін

Синхронізація цін потрібна для того, щоб у Wix відображалися актуальні ціни з K2 ERP.

Можливі сценарії:

K2 ERP є головним джерелом цін;
для Wix використовується окремий тип цін;
ціни оновлюються за розкладом;
ціни оновлюються після зміни в ERP;
акційна ціна передається окремо;
ціни залежать від валюти;
ціни округлюються за правилами магазину;
частина товарів не оновлюється автоматично.

У K2 ERP бажано мати окремі правила:

основна ціна Wix;
акційна ціна Wix;
валюта Wix;
правило округлення;
правило оновлення;
дата останньої синхронізації.

Клієнти

Модуль Wix може завантажувати або оновлювати клієнтів у K2 ERP.

Дані клієнта можуть включати:

Wix contact або customer ID;
ім’я;
прізвище;
email;
телефон;
адреси;
країну;
місто;
поштовий індекс;
маркетингову згоду;
дату створення;
дату останнього оновлення.

У K2 ERP потрібно визначити правила зіставлення клієнтів:

за email;
за телефоном;
за Wix customer ID;
за комбінацією email і телефону;
створювати нового клієнта, якщо збігу немає;
не дублювати клієнта при повторному замовленні;
окремо обробляти guest checkout, якщо він використовується.

Оплати

Wix eCommerce orders містять payment status, а Orders API дозволяє працювати з order lifecycle і payment cycle. :contentReference[oaicite:9]{index=9}

В ERP бажано зберігати:

спосіб оплати;
payment status;
суму замовлення;
суму оплати;
валюту;
комісію за потреби;
дату оплати;
transaction ID за наявності;
статус повернення коштів;
зв’язок із касовим, банківським або платіжним документом.

Доставка і fulfillment

У Wix замовлення містить fulfillment status, а працівники магазину в dashboard можуть відстежувати fulfillment і керувати order lifecycle. :contentReference[oaicite:10]{index=10}

Модуль K2 Wix може передавати назад у Wix:

fulfillment data;
tracking number;
shipping carrier;
tracking URL;
дату відправлення;
часткове виконання;
інформацію про відвантажені позиції.

У K2 ERP це може бути пов’язано з:

складським відвантаженням;
видатковою накладною;
завданням на пакування;
службою доставки;
ТТН;
статусом доставки;
частковим відвантаженням.

Практичне застосування: коли K2 ERP передає tracking number у Wix, покупець може бачити актуальну інформацію про відправлення, а менеджерам не потрібно вручну оновлювати замовлення у Wix Dashboard.

Повернення і refunds

Повернення в Wix можуть бути пов’язані з refund-операціями, поверненням товару, частковим поверненням коштів або скасуванням замовлення.

У K2 ERP потрібно визначити правила:

як отримувати refund із Wix;
як створювати документ повернення;
як повертати товар на склад;
як обробляти часткове повернення;
як обробляти повернення доставки;
як оновлювати фінансовий статус;
як виконувати фіскалізацію повернення;
як зберігати зв’язок із початковим замовленням.

Фіскалізація замовлень Wix

Для B2C-продажів через Wix може бути потрібна фіскалізація через РРО або ПРРО залежно від країни, способу оплати, юридичної особи та законодавчих вимог.

У K2 ERP це може працювати так:

Замовлення надходить із Wix.
ERP перевіряє фінансовий статус.
Система створює документ продажу.
Виконується фіскалізація через РРО або ПРРО.
Номер фіскального чека зберігається в ERP.
За потреби чек надсилається покупцю.
Статус фіскалізації зберігається у замовленні.
У разі повернення формується чек повернення.

Використання модуля Wix у K2 ERP

У системі K2 ERP модуль Wix може використовуватися як окремий канал продажів.

Типова реалізація може включати:

налаштування підключення до Wix;
зберігання site ID;
зберігання access token або іншого механізму доступу;
вибір API-режиму;
вибір складів для залишків;
зіставлення Wix locations зі складами K2 ERP;
вибір типу цін для Wix;
зіставлення товарів за SKU, product ID або variant ID;
експорт товарів;
оновлення цін;
оновлення залишків;
імпорт замовлень;
імпорт клієнтів;
створення документів замовлення клієнта;
резервування товарів;
передавання fulfillment-даних;
передавання tracking number;
інтеграцію з доставкою;
інтеграцію з оплатами;
фіскалізацію;
журнал технічного обміну;
обробку webhooks.

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

Типовий сценарій синхронізації товарів

Типовий сценарій експорту товарів із K2 ERP у Wix може виглядати так:

Користувач створює або оновлює товар у K2 ERP.
Система перевіряє SKU, назву, опис, ціну, фото, вагу і категорію.
Модуль Wix визначає, чи товар уже існує у Wix.
Якщо товар існує, система оновлює його дані.
Якщо товару немає, система створює нову картку товару.
Для товару створюються або оновлюються variants.
Оновлюються ціни.
Оновлюються залишки.
Wix повертає результат обробки.
K2 ERP зберігає Wix product ID, variant ID та inventory item ID.
У журналі обміну зберігається статус і можливі помилки.

Типовий сценарій обробки замовлення

Типовий сценарій обробки замовлення Wix у K2 ERP може виглядати так:

Покупець оформлює замовлення у Wix.
Wix надсилає webhook або модуль отримує замовлення за розкладом.
K2 ERP перевіряє, чи замовлення вже не імпортоване.
Система створює замовлення клієнта.
Система зіставляє товари за SKU або variant ID.
Товари резервуються на складі.
Менеджер або система перевіряє оплату.
Формується складське відвантаження.
Створюється ТТН або інший документ доставки.
За потреби виконується фіскалізація.
Tracking number і fulfillment-дані передаються назад у Wix.
Статус замовлення оновлюється.

Дані, які бажано зберігати в ERP

Для якісної інтеграції з Wix в K2 ERP бажано зберігати:

Wix site ID;
назву сайту;
access token або інший механізм доступу;
permissions;
Wix product ID;
Wix variant ID;
inventory item ID;
Wix location ID;
SKU;
статус синхронізації товару;
дату останнього оновлення товару;
Wix order ID;
номер замовлення;
дату замовлення;
payment status;
fulfillment status;
Wix customer ID;
email покупця;
телефон покупця;
shipping address;
billing address;
спосіб доставки;
спосіб оплати;
transaction ID за наявності;
tracking number;
fulfillment ID;
refund ID;
статус фіскалізації;
номер фіскального чека;
текст помилки API;
журнал запитів і відповідей;
кількість спроб синхронізації.

Журнал обміну

Журнал обміну потрібен для контролю інтеграції та швидкого пошуку помилок.

У журналі бажано зберігати:

дату і час запиту;
напрям обміну;
тип операції;
об’єкт обміну;
Wix ID;
ідентифікатор K2 ERP;
endpoint або operation;
статус операції;
текст помилки;
технічну відповідь API;
користувача або сервіс, який запустив обмін;
кількість повторних спроб;
результат повторної обробки.

Можливі помилки під час інтеграції

Під час роботи модуля Wix можуть виникати такі помилки:

access token недійсний;
недостатньо permissions;
сайт недоступний;
API тимчасово недоступне;
товар не знайдено;
дублюється SKU;
не зіставлено variant;
не знайдено inventory item;
не зіставлена Wix location;
не завантажується фото;
неправильна ціна;
неправильний залишок;
замовлення вже імпортоване;
товар із замовлення не знайдено в K2 ERP;
неправильний спосіб доставки;
неправильний спосіб оплати;
fulfillment не створено;
tracking number не передано;
webhook не пройшов перевірку;
помилка фіскалізації;
помилка повернення;
статус не оновився.

Рекомендація: модуль Wix має мати механізм повторної обробки помилок. Якщо API тимчасово недоступне або webhook не обробився, система повинна повторити операцію та не втрачати замовлення.

Безпека інтеграції

Для безпечної роботи K2 Модуля Wix потрібно контролювати:

доступ до access token;
permissions;
права користувачів;
журнал дій;
обмеження доступу до налаштувань;
шифрування секретів;
захист логів;
перевірку webhook JWT;
резервне копіювання налаштувань;
блокування доступу звільнених працівників;
розмежування прав між менеджерами й адміністраторами;
контроль змін цін і залишків.

Дані, які не можна виводити в логах

У логах інтеграції не варто виводити:

access token;
приватні ключі;
паролі;
повні дані платіжних карток;
webhook secrets;
персональні дані понад необхідний мінімум;
production connection strings;
внутрішні ключі API;
сертифікати;
конфіденційні фінансові дані.

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

Переваги K2 Модуля Wix

До основних переваг модуля можна віднести:

менше ручного введення;
швидше оновлення товарів;
актуальні ціни;
актуальні залишки;
автоматичне отримання замовлень;
менше помилок менеджерів;
швидша обробка замовлень;
контроль оплат;
контроль fulfillment-статусів;
передавання tracking number;
зв’язок із фіскалізацією;
централізований облік у K2 ERP;
прозорий журнал інтеграції;
підтримку кількох каналів продажів.

Обмеження та ризики

Під час впровадження модуля Wix потрібно враховувати:

залежність від Wix API;
потребу в правильних permissions;
особливості Catalog V3;
потребу в правильному зіставленні товарів;
різницю між product і variant;
різницю між складами ERP і Wix locations;
можливі помилки в SKU;
потребу в контролі залишків;
потребу в обробці дублювань;
потребу в тестуванні перед масовим експортом;
ризик оновлення неправильних цін;
ризик передавання неправильних залишків;
потребу в контролі персональних даних покупців.

Не плутати: K2 Модуль Wix — це не просто імпорт замовлень. Повноцінна інтеграція має охоплювати товари, variants, ціни, залишки, locations, замовлення, клієнтів, оплати, fulfillment, повернення, фіскалізацію та журнал помилок.

Висновок

K2 Модуль Wix — це інтеграційний компонент для автоматизації обміну між K2 ERP та Wix Stores. Він дозволяє синхронізувати товари, варіанти товарів, ціни, залишки, отримувати замовлення, передавати fulfillment-статуси, tracking number і забезпечувати зв’язок онлайн-продажів із внутрішнім обліком компанії.

Для K2 ERP модуль Wix доцільно реалізовувати як окремий канал продажів із власними налаштуваннями API, типом цін, складами, правилами синхронізації, журналом обміну, обробкою помилок, підтримкою webhooks і зв’язком із доставкою, оплатами, поверненнями та фіскалізацією.

Джерела

Див. також

Інтеграція з Prom, Rozetka, Hotline

Інтеграція з Новою поштою в Python

Інтеграція з Укрпоштою в Python

РРО

Інтеграція РРО в Python

Технічне завдання: інтеграція ПРРО Checkbox для Python

ДПС

ЕДО