K2 Модуль Wix

У K2 ERP це має змогу працювати так:

У Wix Stores товар має змогу мати варіанти.; Типові напрями роботи з каталогом: Wix eCommerce Orders API надає можливість працювати з життєвим циклом замовлення.; Wix підтримує роботу події через webhooks.; Синхронізація товарів надає можливість передавати асортимент із K2 ERP у Wix або отримувати товари з Wix в ERP.; Можливі сценарії синхронізації залишків: Інтеграція РРО в Python

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

компонент Wix має змогу завантажувати або оновлювати клієнтів у K2 ERP.;

Рекомендація: компонент Wix має мати механізм повторної обробки помилок.; # Якщо товару немає, платформа створює нову картку товару.; :contentReference [oaicite:5]{index=5}

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

завдяки наявності Інтеграційний акцент: webhooks бажано використовувати разом із періодичною звіркою.; # У разі повернення формується чек повернення.; Wix відповідає за сайт, вітрину, кошик, оформлення замовлення і клієнтський досвід, а K2 ERP має бути центральною системою для товарів, залишків, цін, документів, складів, оплат, доставок і фіскалізації.; # Tracking number і fulfillment-дані передаються назад у Wix.;РРО

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

У K2 ERP потрібно визначити, як варіанти 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;
журнал запитів і відповідей;
кількість спроб синхронізації.;== Синхронізація цін ==

за email;
за телефоном;
за Wix customer ID;
за комбінацією email і телефону;
створювати нового клієнта, якщо збігу немає;
не дублювати клієнта при повторному замовленні;
окремо обробляти guest checkout, якщо він застосовується.; Wix надає API для інтеграції з бізнес-рішеннями платформи, зокрема eCommerce, Stores, Orders, CRM, Payments та іншими сервісами.;== Основні функціональні можливості ==

Без інтеграції менеджерам доводиться вручну переносити товари, ціни, залишки, клієнтів і замовлення між Wix та ERP.; # Wix надсилає webhook або компонент отримує замовлення за розкладом.; Він надає можливість синхронізувати товари, варіанти товарів, ціни, залишки, отримувати замовлення, передавати fulfillment-статуси, tracking number і забезпечувати зв’язок онлайн-продажів із внутрішнім обліком компанії.; У журналі бажано зберігати:

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

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

K2 ERP є собою головним джерелом товарів;
Wix є собою головним джерелом вітринного опису;
ERP оновлює тільки ціни й залишки;
ERP оновлює повну товарну картку;
фото оновлюються окремо;
частина товарів не експортується в Wix;
тільки товари з ознакою «Публікувати у Wix» потрапляють у магазин;
окремі товари можуть бути приховані або недоступні для продажу.; # ERP перевіряє фінансовий статус.; # Якщо товар існує, платформа оновлює його інформаційні дані.; K2 ERP має змогу виступати головним джерелом товарів, цін, залишків, складів, документів, оплат і фіскалізації, а Wix — зовнішнім каналом продажів і онлайн-вітриною для покупців.; # Статус замовлення оновлюється.; # У журналі обміну зберігається статус і можливі помилки.; Покупець переглядає товари на сайті Wix, додає їх у кошик, оформлює замовлення, вибирає доставку, оплату та отримує підтвердження покупки.;== Обмеження та ризики ==

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

створено замовлення;
оновлено замовлення;
створено товар;
оновлено товар;
створено inventory item;
змінено inventory item;
змінено fulfillment;
змінено оплату;
створено повернення;
оновлено клієнта.; # K2 ERP зберігає Wix product ID, variant ID та inventory item ID.; :contentReference [oaicite:1]{index=1}

Wix product ID;
variant ID;
inventory item ID;
назва;
SKU;
ціна;
залишок;
collections;
media;
статус товару;
варіанти товару.; K2 ERP має бути головною системою для товарів, залишків, цін, документів, оплат, доставок і фіскалізації, а Wix — онлайн-вітриною та джерелом замовлень.;

K2 компонент Wix — це інтеграційний компонент для автоматизації обміну між K2 ERP та Wix Stores.;

Зверніть увагу: конкретні функціональні можливості модуля залежать від доступних Wix API, прав застосунку, тарифу Wix, структури товарів, locations, способів доставки, оплат, податків, валюти та бізнес-логіки K2 ERP.; # Виконується фіскалізація через РРО або ПРРО.; Для інтеграції з K2 ERP істотно знати:

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

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

Inventory Items API надає можливість керувати запасами товарів у Wix Stores.; # Оновлюються ціни.;

Products API надає можливість створювати й керувати товарами магазину, зокрема variants, pricing, media та metadata.; Для якісної інтеграції з Wix в K2 ERP бажано зберігати: У системі K2 ERP компонент Wix має змогу використовуватися як окремий канал продажів.; * K2 ERP є собою головним джерелом цін;

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

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

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

B2C

Для інтеграції K2 ERP із Wix потрібно налаштувати застосунок або інтеграційний доступ із потрібними permissions.; # За потреби чек надсилається покупцю.; Його не можна передавати стороннім особам, зберігати у відкритому коді, публікувати в логах або відправляти в незахищених повідомленнях.; # Створюється ТТН або інший документ доставки.; Wix Stores API застосовується для роботи з каталогом товарів, collections, media та інвентарем магазину.; Webhook пришвидшує реакцію на подію, а регулярна синхронізація користувачі можуть знайти пропущені або некоректно оброблені зміни.; :contentReference [oaicite:6]{index=6}

fulfillment data;
tracking number;
shipping carrier;
tracking URL;
дату відправлення;
часткове виконання;
інформацію про відвантажені позиції.; Якщо API тимчасово недоступне або webhook не обробився, платформа повинна повторити операцію та не втрачати замовлення.; У документації Wix для API та webhooks окремо вказуються permissions, як ілюстрація Read Orders або Read inventory.; # платформа створює замовлення клієнта.; # За потреби виконується фіскалізація.; :contentReference [oaicite:10]{index=10}

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

Джерела

як отримувати refund із Wix;
як створювати документ повернення;
як повертати товар на складський облік;
як обробляти часткове повернення;
як обробляти повернення доставки;
як оновлювати фінансовий статус;
як виконувати фіскалізацію повернення;
як зберігати зв’язок із початковим замовленням.; Це створює ризики: застарілі залишки, неправильні ціни, дублікати замовлень, несвоєчасне актуалізація статусів, помилки під час відвантаження та складність контролю фіскалізації.; # Номер фіскального чека зберігається в ERP.; :contentReference [oaicite:3]{index=3}

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

Для K2 ERP: Wix варто розглядати як зовнішній канал продажів.; # Формується складське відвантаження.; # Менеджер або платформа перевіряє оплату.; з цієї причини для залишків, резервів і відвантаження бажано зберігати Wix product ID, variant ID та inventory item ID.;

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

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

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

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

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

Замовлення надходить із Wix.; # Статус фіскалізації зберігається у замовленні.;Інтеграція з Новою поштою в Python

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

Webhook має змогу повідомляти K2 ERP про такі події:

K2 Модуль Magento

Клієнти

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

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

K2 компонент Wix має змогу забезпечувати такі функціональні можливості:

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

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

Wix eCommerce orders містять payment status, а Orders API надає можливість працювати з order lifecycle і payment cycle.; як ілюстрація, одяг має змогу мати розмір і колір, а кожна комбінація варіантів має змогу мати власний SKU, ціну та залишок.; # платформа зіставляє товари за SKU або variant ID.; У документації Wix зазначено, що inventory item відстежує залишок конкретного product variant у конкретній location, а API надає можливість створювати й керувати inventory items, відстежувати stock levels, змінювати quantities та налаштовувати preorder.; # компонент Wix визначає, чи товар уже існує у Wix.; # Товари резервуються на складі.;== переважні аспекти K2 Модуля Wix == З K2 ERP у Wix можуть передаватися: Під час роботи модуля Wix можуть виникати такі помилки:

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

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

OpenCart K2 компонент Wix потрібен для автоматизації обміну між ERP і Wix.; # Оновлюються залишки.; * підключення одного або кількох Wix-сайтів;

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

K2 компонент Wix автоматизує обмін даними.;== Variants і options == інформаційні дані клієнта можуть включати:

access token;
приватні ключі;
паролі;
повні інформаційні дані платіжних карток;
webhook secrets;
персональні інформаційні дані понад необхідний мінімум;
production connection strings;
внутрішні ключі API;
сертифікати;
конфіденційні фінансові інформаційні дані.; Замовлення містить purchased items, price and tax summaries, shipping and billing information, discounts, payment status і fulfillment status.; # Для товару створюються або оновлюються variants.; # платформа перевіряє SKU, назву, характеристика, ціну, фото, вагу і категорію.; Можливі правила:

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

назва товару;
характеристика;
SKU;
barcode;
ціна;
стара ціна або акційна ціна;
фото;
media;
collections;
variants;
options;
вага;
статус активності;
SEO-поля за потреби;
metadata або custom data за підтримки API.; Журнал обміну потрібен для контролю інтеграції та швидкого пошуку помилок.; У K2 ERP потрібно визначити правила зіставлення клієнтів:

Повернення в Wix можуть бути пов’язані з refund-операціями, поверненням товару, частковим поверненням коштів або скасуванням замовлення.; Для B2C-продажів через Wix має змогу бути потрібна фіскалізація через РРО або ПРРО залежно від країни, способу оплати, юридичної особи та законодавчих вимог.; :contentReference [oaicite:4]{index=4}

Inventory Items API

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

products;
variants;
collections;
media;
prices;
metadata;
inventory items;
availability;
catalog synchronization.; :contentReference [oaicite:2]{index=2}

Загальний характеристика

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

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

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

Wix додатково вводить Catalog V3 для Stores.; * 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-дані за потреби.; * коли Wix зменшує залишок;
чи створюються invoices;
які email-повідомлення надсилаються покупцю;
які конфігурація впливають на order lifecycle;
чи не дублює ERP ті самі дії, які вже виконує Wix.;== Доставка і fulfillment ==

користувач системи створює або оновлює товар у K2 ERP.; У документації Wix зазначено, що Wix Stores Catalog API надає можливість отримувати окремі товари, collections або весь каталог, а додатково створювати товари й додавати до них media.;== Orders Settings API ==

Wix Stores API

Модуль Prom

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

Не плутати: access token або інший ключ доступу до Wix API — це секретний доступ до даних магазину.;== Webhooks == K2 Модуль Shopify

У Wix замовлення містить fulfillment status, а працівники магазину в dashboard можуть відстежувати fulfillment і керувати order lifecycle.; Повноцінна інтеграційні функціональні можливості має охоплювати товари, variants, ціни, залишки, locations, замовлення, клієнтів, оплати, fulfillment, повернення, фіскалізацію та журнал помилок.;

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

Висновок

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

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

Див.; додатково

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

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

Не плутати: K2 компонент Wix — це не без ускладнень імпорт замовлень.; це інтеграційний компонент; додатково реалізовано каталогом.; У документації Wix зазначено, що Catalog V3 має покращити керування product variants, inventory, customization options і store management.;Технічне завдання: інтеграція ПРРО Checkbox для Python З Wix у K2 ERP можуть завантажуватися:

Покупець оформлює замовлення у Wix.;== Products API ==

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

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

Wix eCommerce Orders API

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

Окремо варто відзначити цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, статусами, поверненнями і фіскалізацією виступає ключовою рисою обміну даними між K2 ERP та платформою Wix / Wix Stores.; :contentReference [oaicite:8]{index=8}

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