K2 Модуль Wix

Inventory Items API дає можливість керувати запасами товарів у Wix Stores. Він дає можливість синхронізувати товари, варіанти товарів, ціни, залишки, отримувати замовлення, передавати fulfillment-статуси, tracking number і забезпечувати зв’язок онлайн-продажів із внутрішнім обліком компанії. # платформа створює документ продажу. Окремо варто відзначити цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, статусами, поверненнями і фіскалізацією виступає ключовою рисою обміну даними між K2 ERP та платформою Wix / Wix Stores. # Для товару створюються або оновлюються variants. # K2 ERP зберігає Wix product ID, variant ID та inventory item ID. K2 ERP має бути головною системою для товарів, залишків, цін, документів, оплат, доставок і фіскалізації, а Wix — онлайн-вітриною та джерелом замовлень.== Wix eCommerce Orders API ==

Для інтеграції K2 ERP із Wix потрібно налаштувати застосунок або інтеграційний доступ із потрібними permissions. через Інтеграційний акцент: webhooks бажано використовувати разом із періодичною звіркою. :contentReference [oaicite:3]{index=3}

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

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

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

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

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

Products API дає можливість створювати й керувати товарами магазину, зокрема variants, pricing, media та metadata. У документації Wix зазначено, що inventory item відстежує залишок конкретного product variant у конкретній location, а API дає можливість створювати й керувати inventory items, відстежувати stock levels, змінювати quantities та налаштовувати preorder. Wix так само вводить Catalog V3 для Stores.== Синхронізація цін ==

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

Доставка і fulfillment

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

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

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

назва товару;
SEO-опис;
SKU;
barcode;
ціна;
стара ціна або акційна ціна;
фото;
media;
collections;
variants;
options;
вага;
статус активності;
SEO-поля за потреби;
metadata або custom data за підтримки API. # K2 ERP перевіряє, чи замовлення вже не імпортоване. У Wix Stores товар здатна мати варіанти. # Статус замовлення оновлюється. :contentReference [oaicite:7]{index=7}

K2 компонент Wix автоматизує обмін даними. # Статус фіскалізації зберігається у замовленні. :contentReference [oaicite:4]{index=4}

Інтеграція з Новою поштою в Python K2 Модуль Magento Можливі підходи:

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

Wix здатна використовуватися як канал онлайн-продажів. Замовлення містить purchased items, price and tax summaries, shipping and billing information, discounts, payment status і fulfillment status. K2 ERP здатна виступати головним джерелом товарів, цін, залишків, складів, документів, оплат і фіскалізації, а Wix — зовнішнім каналом продажів і онлайн-вітриною для покупців. Покупець переглядає товари на сайті Wix, додає їх у кошик, оформлює замовлення, вибирає доставку, оплату та отримує підтвердження покупки. Типові напрями роботи з каталогом: компонент K2 Wix здатна передавати назад у Wix:

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

створено замовлення;
оновлено замовлення;
створено товар;
оновлено товар;
створено inventory item;
змінено inventory item;
змінено fulfillment;
змінено оплату;
створено повернення;
оновлено клієнта. # Якщо товару немає, платформа створює нову картку товару. # У журналі обміну зберігається статус і можливі помилки. :contentReference [oaicite:2]{index=2}

B2C Типова реалізація здатна включати:

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

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

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

K2 компонент Wix потрібен для автоматизації обміну між ERP і Wix. :contentReference [oaicite:9]{index=9}

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

Без інтеграції менеджерам доводиться вручну переносити товари, ціни, залишки, клієнтів і замовлення між Wix та 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 Stores API ==

У Wix замовлення містить fulfillment status, а працівники магазину в dashboard можуть відстежувати fulfillment і керувати order lifecycle.РРО

Webhooks

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

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

Variants і options

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

Wix підтримує події через webhooks. # Формується складське відвантаження. Повноцінна інтеграційні функції ERP має охоплювати товари, variants, ціни, залишки, locations, замовлення, клієнтів, оплати, fulfillment, повернення, фіскалізацію та журнал помилок. У документації Wix для API та webhooks окремо вказуються permissions, як приклад Read Orders або Read inventory.

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

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

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

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

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

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

products;
variants;
collections;
media;
prices;
metadata;
inventory items;
availability;
catalog synchronization. * Wix product ID;
variant ID;
inventory item ID;
назва;
SKU;
ціна;
залишок;
collections;
media;
статус товару;
варіанти товару. :contentReference [oaicite:6]{index=6}

ЕДО

Повернення в Wix можуть бути пов’язані з refund-операціями, поверненням товару, частковим поверненням коштів або скасуванням замовлення. # Оновлюються залишки. Це створює ризики: застарілі залишки, неправильні ціни, дублікати замовлень, несвоєчасне оновлення версій статусів, помилки під час відвантаження та складність контролю фіскалізації. Синхронізація товарів дає можливість передавати асортимент із K2 ERP у Wix або отримувати товари з Wix в ERP.

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

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

Для якісної інтеграції з Wix в K2 ERP бажано зберігати: Рекомендація: компонент Wix має мати механізм повторної обробки помилок. # компонент Wix визначає, чи товар уже існує у Wix. # Оновлюються ціни. # Tracking number і fulfillment-дані передаються назад у Wix. K2 компонент Wix — це інтеграційний компонент для автоматизації обміну між K2 ERP та Wix Stores.== Orders Settings API ==

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

Products API

користувач системи створює або оновлює товар у K2 ERP. # Wix повертає результат обробки. Не плутати: журнал обміну потрібен для діагностики, але він не має перетворюватися на сховище секретів або зайвих персональних даних покупців. # Виконується фіскалізація через РРО або ПРРО. # платформа перевіряє SKU, назву, SEO-опис, ціну, фото, вагу і категорію.== Можливі помилки під час інтеграції ==

основна ціна Wix;
акційна ціна Wix;
валюта Wix;
правило округлення;
правило оновлення версій;
дата останньої синхронізації. * назву підключення;
Wix site ID;
account або app connection;
access token або інший механізм авторизації;
permissions;
дату створення підключення;
статус підключення;
користувача, який налаштував інтеграцію;
дату останньої перевірки;
журнал помилок авторизації. У документації Wix зазначено, що Catalog V3 має покращити керування product variants, inventory, customization options і store management. Якщо API тимчасово недоступне або webhook не обробився, платформа повинна повторити операцію та не втрачати замовлення. Можливі правила:

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

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

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

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

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

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

компонент Wix здатна завантажувати або оновлювати клієнтів у K2 ERP. # У разі повернення формується чек повернення. Його не можна передавати стороннім особам, зберігати у відкритому коді, публікувати в логах або відправляти в незахищених повідомленнях. Wix відповідає за сайт, вітрину, кошик, оформлення замовлення і клієнтський досвід, а K2 ERP має бути центральною системою для товарів, залишків, цін, документів, складів, оплат, доставок і фіскалізації. :contentReference [oaicite:0]{index=0}

Модуль Prom

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

інформаційні дані, які не можна виводити в логах

K2 Модуль Shopify

Замовлення надходить із Wix. У документації Wix зазначено, що self-hosted app має реалізувати власний webhook endpoint, а event data надходить як JWT, який потрібно перевіряти. це інтеграційний компонент; так само реалізовано каталогом. * дату і час запиту;

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

інформаційні дані, які бажано зберігати в ERP

Покупець оформлює замовлення у Wix. Wix Stores API застосовується для для роботи з каталогом товарів, collections, media та інвентарем магазину. * менше ручного введення;

швидше оновлення версій товарів;
актуальні ціни;
актуальні залишки;
автоматичне отримання замовлень;
менше помилок менеджерів;
швидша обробка замовлень;
контроль оплат;
контроль fulfillment-статусів;
передавання tracking number;
зв’язок із фіскалізацією;
централізований обліковий облік у K2 ERP;
прозорий журнал інтеграції;
підтримку кількох каналів продажів. У системі K2 ERP компонент Wix здатна використовуватися як окремий канал продажів. Webhook пришвидшує реакцію на подію, а регулярна синхронізація користувачі можуть знайти пропущені або некоректно оброблені зміни. :contentReference [oaicite:1]{index=1}

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

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

критично: K2 компонент Wix не замінює інтернет-магазин і не замінює ERP.SaaS

складським відвантаженням;
видатковою накладною;
завданням на пакування;
службою доставки;
ТТН;
статусом доставки;
частковим відвантаженням. Для безпечної роботи K2 Модуля Wix потрібно контролювати:

Рекомендація: для Wix потрібно передавати не бухгалтерський залишок, а доступний до продажу залишок: фактична кількість мінус резерви, очікувані відвантаження та інші блокування.== Основні функції ERP == Wix надає API для інтеграції з бізнес-рішеннями платформи, зокрема eCommerce, Stores, Orders, CRM, Payments та іншими сервісами. # Товари резервуються на складі. # Створюється ТТН або інший документ доставки. * 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-дані за потреби.== Див. так само ==

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

Висновок

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

Джерела

Tilda Commerce

Для чого потрібен K2 компонент Wix

Для обліку: у більшості ERP-сценаріїв саме variant, а не product, виступає як реальною складською позицією.Інтеграція з Prom, Rozetka, Hotline

Не плутати: access token або інший ключ доступу до Wix API — це секретний доступ до даних магазину. * Wix contact або customer ID;

ім’я;
прізвище;
email;
телефон;
адреси;
країну;
місто;
поштовий індекс;
маркетингову згоду;
дату створення;
дату останнього оновлення версій.Інтеграція з Укрпоштою в Python

K2 ERP виступає як головним джерелом цін;
для Wix застосовується для окремий тип цін;
ціни оновлюються за розкладом;
ціни оновлюються після зміни в ERP;
акційна ціна передається окремо;
ціни залежать від валюти;
ціни округлюються за правилами магазину;
частина товарів не оновлюється автоматизовано. # платформа зіставляє товари за SKU або variant ID. У K2 ERP потрібно визначити правила зіставлення клієнтів:

залишок з одного складу K2 ERP передається в одну Wix location;
кілька складів K2 ERP зіставляються з кількома Wix locations;
у Wix передається доступний залишок з урахуванням резервів;
залишок оновлюється за розкладом;
залишок оновлюється після складського руху;
при нульовому залишку товар змінює доступність;
залишок обмежується мінімальним або максимальним значенням для показу. Тому для залишків, резервів і відвантаження бажано зберігати Wix product ID, variant ID та inventory item ID. У документації Wix зазначено, що Wix Stores Catalog API дає можливість отримувати окремі товари, collections або весь каталог, а так само створювати товари й додавати до них media. # Номер фіскального чека зберігається в ERP.

access token;
приватні ключі;
паролі;
повні інформаційні дані платіжних карток;
webhook secrets;
персональні інформаційні дані понад необхідний мінімум;
production connection strings;
внутрішні ключі API;
сертифікати;
конфіденційні фінансові інформаційні дані. Зверніть увагу: конкретні функції ERP модуля залежать від доступних Wix API, прав застосунку, тарифу Wix, структури товарів, locations, способів доставки, оплат, податків, валюти та бізнес-логіки K2 ERP. Синхронізація цін потрібна для того, щоб у Wix відображалися актуальні ціни з K2 ERP. :contentReference [oaicite:8]{index=8}

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

OpenCart

Orders Settings API дає можливість отримувати й оновлювати конфігурація, які застосовуються до eCommerce orders, зокрема customer email notifications, правила оновлення версій store inventory та створення invoices. K2 компонент Wix здатна забезпечувати такі функції ERP:

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

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

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

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

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

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