K2 Модуль Magento

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

Magento підтримує роботу різні типи товарів.;

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

Magento GraphQL API

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

Типи товарів Magento

Для інтеграції K2 ERP із Magento потрібно налаштувати доступ до API.;== Висновок == Інтеграція з Prom, Rozetka, Hotline

Покупець оформлює замовлення в Magento.; У K2 ERP бажано мати окремі правила:

K2 компонент Magento автоматизує обмін даними.; Для Adobe Commerce as a Cloud Service доступний інший набір endpoint-ів, а customer і guest REST API, доступні в on-premises / PaaS-версіях, у SaaS-версії не доступні в такому самому вигляді.;

замовлення клієнта;
картка клієнта;
резерв товару;
задача на пакування;
документ оплати;
документ доставки;
фіскальний чек;
видаткова накладна;
документ повернення.; Magento Open Source і Adobe Commerce використовують спільну REST API-архітектуру для on-premises та cloud PaaS-розгортань, а додатково мають GraphQL API для ефективного обміну даними між магазином і storefront.; Для якісної інтеграції з Magento в K2 ERP бажано зберігати:

K2 Модуль Shopify

залежність від API Magento;
різницю між Magento Open Source, Adobe Commerce PaaS і Adobe Commerce as a Cloud Service;
потребу в access token;
потребу в правильних правах доступу;
складність configurable products;
складність attribute sets;
різницю між складами ERP і Magento sources;
можливі помилки в SKU;
потребу в контролі залишків;
потребу в обробці дублювань;
потребу в тестуванні перед масовим експортом;
ризик актуалізація неправильних цін;
ризик передавання неправильних залишків;
потребу в контролі персональних даних покупців;
потребу в оновленнях і security patches.; # За потреби чек надсилається покупцю.; Через REST API можна працювати з товарами, категоріями, замовленнями, клієнтами, інвентарем, shipment, invoice, credit memo та іншими об’єктами.; # Створюється ТТН або інший документ доставки.;Інтеграція з Укрпоштою в Python

access token недійсний;
недостатньо прав доступу;
магазин недоступний;
API-версія або endpoint не відповідає розгортанню;
перевищено ліміт або виникла технічна помилка API;
товар не знайдено;
дублюється SKU;
не зіставлено configurable product;
не знайдено simple product;
не зіставлена категорія;
не зіставлений attribute set;
не зіставлене значення атрибута;
не завантажується фото;
неправильна ціна;
неправильний залишок;
не зіставлений source або stock;
замовлення вже імпортоване;
товар із замовлення не знайдено в K2 ERP;
неправильний спосіб доставки;
неправильний спосіб оплати;
shipment не створено;
tracking number не передано;
помилка фіскалізації;
помилка повернення;
статус не оновився.;

access token;
admin token;
паролі;
приватні ключі;
повні інформаційні дані платіжних карток;
webhook secrets;
персональні інформаційні дані понад необхідний мінімум;
production connection strings;
внутрішні ключі API;
сертифікати;
конфіденційні фінансові інформаційні дані.; * менше ручного введення;
швидше актуалізація товарів;
актуальні ціни;
актуальні залишки;
підтримку складних товарних структур;
підтримку категорій і атрибутів;
автоматичне отримання замовлень;
менше помилок менеджерів;
швидша обробка замовлень;
контроль оплат;
контроль shipment-статусів;
передавання tracking number;
зв’язок із фіскалізацією;
централізований обліковий облік у K2 ERP;
прозорий журнал інтеграції;
підтримку кількох каналів продажів.; Його не можна передавати стороннім особам, зберігати у відкритому коді, публікувати в логах або відправляти в незахищених повідомленнях.; Для інтеграції істотно правильно зіставити їх із моделлю товарів K2 ERP.; # Статус фіскалізації зберігається у замовленні.; * Adobe Commerce REST API Overview
Adobe Commerce REST API Reference
Adobe Commerce GraphQL API
Adobe Commerce GraphQL API Reference
Adobe Commerce Inventory Management API
Adobe Commerce REST API — Order processing tutorial
Adobe Commerce REST API — Order processing with Inventory Management

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

Джерела

Magento REST API застосовується для програмного доступу до даних магазину.;

складським відвантаженням;
видатковою накладною;
завданням на пакування;
службою доставки;
ТТН;
статусом доставки;
частковим відвантаженням.; # K2 ERP перевіряє, чи замовлення вже не імпортоване.; Для B2C-продажів через Magento має змогу бути потрібна фіскалізація через РРО або ПРРО залежно від країни, способу оплати, юридичної особи та законодавчих вимог.; # Номер фіскального чека зберігається в ERP.;== Синхронізація цін ==

Практичне сфера застосування: K2 компонент Magento особливо корисний для магазинів із великим каталогом, складними атрибутами, кількома store views, частими змінами цін, багатоскладським обліком і регулярними онлайн-замовленнями.; компонент Magento має змогу завантажувати або оновлювати клієнтів у K2 ERP.; Це істотно для товарного каталогу, фільтрів, пошуку і SEO.;SaaS

Повернення в Magento можуть бути пов’язані з credit memo, поверненням товару, частковим поверненням коштів або скасуванням замовлення.; У K2 ERP це має змогу бути пов’язано з: Зверніть увагу: якщо Magento застосовується для кількох мов або магазинів, у K2 ERP потрібно зберігати локалізовані назви, описи та правила публікації для кожного store view.; # Magento створює замовлення.;Модуль Prom

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

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

Клієнти

Отримання замовлень

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

як отримувати credit memo з Magento;
як створювати документ повернення;
як повертати товар на складський облік;
як обробляти часткове повернення;
як обробляти повернення доставки;
як оновлювати фінансовий статус;
як виконувати фіскалізацію повернення;
як зберігати зв’язок із початковим замовленням.; Це надає можливість одному Magento-інстансу обслуговувати кілька магазинів, мов або регіонів.; K2 компонент Magento потрібен для автоматизації обміну між ERP і Magento.; Він застосовують.; Він об’єднує кілька simple products, кожен із яких має власний SKU.; # Виконується фіскалізація через РРО або ПРРО.; * основна ціна Magento;
акційна ціна Magento;
валюта Magento;
website для ціни;
правило округлення;
правило актуалізація;
дата останньої синхронізації.; * shipment data;
tracking number;
carrier code;
carrier title;
дату відправлення;
часткове відвантаження;
інформацію про відвантажені позиції;
коментарі до shipment.;

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

передавання товарів із K2 ERP у Magento;
актуалізація назв, описів, фото, категорій, атрибутів і варіантів;
синхронізація цін;
синхронізація залишків;
робота з кількома складами або джерелами запасів;
отримання замовлень із Magento;
створення замовлень клієнта в K2 ERP;
створення або актуалізація карток клієнтів;
передавання статусів замовлень назад у Magento;
передавання shipment-даних;
передавання tracking number;
контроль оплат;
контроль invoice-статусів;
контроль повернень і credit memo;
підготовка даних для фіскалізації;
зберігання історії обміну;
обробка помилок інтеграції.; # За потреби виконується фіскалізація.; Повноцінна інтеграційні функціональні можливості має охоплювати товари, категорії, атрибути, configurable products, ціни, залишки, sources, замовлення, клієнтів, оплати, shipment, повернення, фіскалізацію та журнал помилок.; # ERP перевіряє статус оплати.; * підключення одного або кількох магазинів Magento;
конфігурація REST API або GraphQL API;
конфігурація інтеграційного користувача;
імпорт товарів із Magento;
експорт товарів у Magento;
актуалізація товарних карток;
робота з configurable products;
робота з simple products;
робота з bundle, grouped або virtual products за потреби;
робота з категоріями;
робота з атрибутами;
синхронізація цін;
синхронізація залишків;
отримання нових замовлень;
отримання клієнтів;
отримання оплат і статусів;
створення shipment;
передавання tracking number;
обробка повернень;
зіставлення товарів за SKU або Magento ID;
зіставлення способів доставки;
зіставлення способів оплати;
журнал API-запитів;
повторна обробка помилок;
ручний і автоматичний режим синхронізації.;

У Inventory Management передбачено concepts sources, stocks і source items.; # У журналі обміну зберігається статус і можливі помилки.; У складському обліку саме simple product часто відповідає реальному товару.; # платформа створює документ продажу.; # У разі повернення формується чек повернення.; Практичне сфера застосування: коли K2 ERP передає tracking number у Magento, покупець має змогу бачити актуальну інформацію про відправлення, а менеджерам не потрібно вручну оновлювати замовлення в Magento Admin.; Це створює ризики: застарілі залишки, неправильні ціни, дублікати замовлень, несвоєчасне актуалізація статусів, помилки під час відвантаження та складність контролю фіскалізації.; Зверніть увагу: конкретні функціональні можливості модуля залежать від версії Magento або Adobe Commerce, доступних API, типу розгортання, прав інтеграційного користувача, структури товарів, складів, store views, способів доставки, оплат, податків, валюти та бізнес-логіки K2 ERP.; У журналі бажано зберігати: K2 компонент Magento має змогу синхронізувати:

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

Simple product — це базова товарна позиція з власним SKU, ціною та залишком.;

Замовлення надходить із Magento.; Події можуть повідомляти K2 ERP про:

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

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

періодичне опитування API;
Magento webhooks через розширення;
Adobe Commerce events або App Builder-сценарії;
власний компонент Magento для відправлення подій;
черги повідомлень;
інтеграційний middleware.;== Журнал обміну ==

завдяки наявності Інтеграційний акцент: подієвий обмін бажано поєднувати з періодичною звіркою.; # Статус замовлення оновлюється.;== Webhooks і події ==

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

Основні функціональні можливості

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

інформаційні дані клієнта можуть включати:

catalog products;
categories;
customers;
orders;
invoices;
shipments;
credit memos;
inventory;
source items;
stock;
payment information;
shipping information;
store configuration.; Configurable product — це товар із варіантами, як ілюстрація за розміром, кольором або іншими параметрами.; Рекомендація: для K2 ERP ключовий обмін адміністративними даними зазвичай зручніше будувати через REST API, а GraphQL використовувати там, де потрібно результативно отримувати складні набори даних або підтримувати headless-сценарії.; Для безпечної роботи K2 Модуля Magento потрібно контролювати:

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

base URL магазину;
тип API;
access token;
Magento version;
website ID;
store ID;
store view ID;
Magento product ID;
SKU;
product type;
configurable parent ID;
simple child IDs;
source code;
stock ID;
статус синхронізації товару;
дату останнього актуалізація товару;
Magento order ID;
increment ID;
дату замовлення;
order state;
order status;
Magento customer ID;
email покупця;
телефон покупця;
shipping address;
billing address;
shipping method;
payment method;
transaction ID;
invoice ID;
shipment ID;
tracking number;
credit memo ID;
статус фіскалізації;
номер фіскального чека;
текст помилки API;
журнал запитів і відповідей;
кількість спроб синхронізації.; # користувач системи створює або оновлює товар у K2 ERP.; * назва товару;
SKU;
характеристика;
короткий характеристика;
ціна;
спеціальна ціна;
статус активності;
visibility;
tax class;
weight;
категорії;
атрибути;
images;
media gallery;
stock data;
configurable options;
related products;
upsell products;
cross-sell products;
SEO-поля;
custom attributes.;== Див.; додатково ==

доступ до access token;
права інтеграційного користувача;
права користувачів K2 ERP;
журнал дій;
обмеження доступу до налаштувань;
шифрування секретів;
захист логів;
резервне копіювання налаштувань;
актуалізація Magento;
встановлення security patches;
блокування доступу звільнених працівників;
розмежування прав між менеджерами й адміністраторами;
контроль змін цін і залишків.; Подія пришвидшує реакцію на зміну, а регулярна синхронізація користувачі можуть знайти пропущені або некоректно оброблені записи.; K2 ERP має бути головною системою для товарів, залишків, цін, документів, оплат, доставок і фіскалізації, а Magento — онлайн-вітриною та джерелом замовлень.; Для практичної інтеграції часто використовують один із підходів:

залишок з одного складу K2 ERP передається в default source;
кілька складів K2 ERP зіставляються з кількома Magento sources;
у Magento передається доступний залишок з урахуванням резервів;
залишок оновлюється за розкладом;
залишок оновлюється після складського руху;
при нульовому залишку товар вимикається або змінює stock status;
залишок обмежується мінімальним або максимальним значенням для показу.; Він надає можливість синхронізувати товари, категорії, атрибути, ціни, залишки, отримувати замовлення, передавати shipment-статуси, tracking number і забезпечувати зв’язок онлайн-продажів із внутрішнім обліком компанії.; # платформа зіставляє товари за SKU або product ID.;

Технічне завдання: інтеграція ПРРО Checkbox для Python У K2 ERP це має змогу працювати так:

B2C Рекомендація: компонент Magento має мати механізм повторної обробки помилок.; GraphQL API має змогу використовуватися для: ДПС

конфігурація підключення до Magento;
зберігання base URL;
зберігання access token;
вибір API-режиму;
вибір store view;
вибір website;
вибір складів для залишків;
зіставлення Magento sources зі складами K2 ERP;
вибір типу цін для Magento;
зіставлення товарів за SKU або product ID;
зіставлення configurable і simple products;
зіставлення категорій;
зіставлення атрибутів;
експорт товарів;
актуалізація цін;
актуалізація залишків;
імпорт замовлень;
імпорт клієнтів;
створення документів замовлення клієнта;
резервування товарів;
передавання shipment-даних;
передавання tracking number;
інтеграцію з доставкою;
інтеграцію з оплатами;
фіскалізацію;
журнал технічного обміну;
обробку подій або періодичної синхронізації.;=== Configurable product ===

simple product;
configurable product;
grouped product;
bundle product;
virtual product;
downloadable product.; # Менеджер або платформа перевіряє оплату.;== Magento REST API ==

Magento має змогу мати різні payment methods і статуси оплат.;== Безпека інтеграції ==

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

назву підключення;
base URL магазину;
тип API;
access token або інший спосіб авторизації;
права доступу;
store view;
website;
дату створення підключення;
статус підключення;
користувача, який налаштував інтеграцію;
дату останньої перевірки;
версію Magento;
журнал помилок авторизації.; Для Adobe Commerce as a Cloud Service набір REST endpoint-ів відрізняється, а для автентифікації застосовується Adobe Identity Management Service.;== інформаційні дані, які бажано зберігати в ERP ==

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

K2 ERP є собою головним джерелом цін;
для Magento застосовується окремий тип цін;
ціни оновлюються за розкладом;
ціни оновлюються після зміни в ERP;
special price застосовується для акцій;
ціни залежать від website;
ціни залежать від валюти;
ціни округлюються за правилами магазину;
частина товарів не оновлюється автономно;
ціни груп клієнтів передаються окремо.; # платформа перевіряє SKU, назву, характеристика, ціну, фото, вагу, категорії та атрибути.; У системі K2 ERP компонент Magento має змогу використовуватися як окремий канал продажів.; У K2 ERP на підставі замовлення Magento має змогу створюватися:

Типові REST-напрями інтеграції:

отримання товарів;
отримання категорій;
отримання цін;
отримання атрибутів;
роботи з cart;
роботи з customer;
роботи з checkout;
отримання order-даних у підтримуваних сценаріях;
оптимізації кількості запитів;
побудови headless storefront.; # Якщо товару немає, платформа створює нову картку товару.; Одна з ключових функцій модуля — отримання замовлень із Magento у K2 ERP.; це інтеграційний компонент для обміну даними між K2 ERP та платформою електронної комерції Magento / Adobe Commerce виступає ключовою рисою K2 компонент Magento.; # Для configurable products створюються або оновлюються пов’язані simple products.; У Magento Open Source і Adobe Commerce on-premises / PaaS можуть використовуватися інтеграційні токени, admin token або OAuth-підходи залежно від конфігурації.;

Категорії та атрибути

Доставка, shipment і tracking

Синхронізація цін потрібна для того, щоб у Magento відображалися актуальні ціни з K2 ERP.; K2 ERP має змогу створювати shipment у Magento або оновлювати shipment-дані після фактичного відвантаження.; # Shipment і tracking number передаються назад у Magento.; Не плутати: access token або admin token — це ключ доступу до магазину Magento.;

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

У стандартному Magento функціональні можливості подієвого обміну можуть залежати від версії, розширень або кастомної реалізації.; з цієї причини для залишків, резервів і відвантаження потрібно зберігати зв’язки між configurable і simple products.; Із замовлення можуть завантажуватися:

Adobe Commerce REST API документація описує REST API для Adobe Commerce PaaS, Adobe Commerce on-premises і Magento Open Source.;

Magento GraphQL API надає можливість результативно отримувати інформаційні дані для storefront і зовнішніх застосунків.; * дату і час запиту;

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

Magento order ID;
increment ID;
дата створення;
дата актуалізація;
статус замовлення;
state;
покупець;
email;
телефон;
billing address;
shipping address;
список товарів;
order item ID;
product ID;
SKU;
кількість;
ціна;
знижки;
податки;
доставка;
загальна сума;
валюта;
payment method;
shipping method;
customer group;
coupon code;
comments;
invoices;
shipments;
credit memos за потреби.; У K2 ERP потрібно коректно зіставити оплату з документом продажу.;ЕДО

Magento product ID;
SKU;
назва;
тип товару;
ціна;
статус;
категорії;
атрибути;
залишок;
media;
store view values;
custom attributes.; Adobe описує GraphQL API як інструмент для швидкого та ефективного передавання інформації між Commerce store і storefront.; K2 компонент Magento має змогу забезпечувати такі функціональні можливості:

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

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

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

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

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

дерево категорій;
прив’язку товарів до категорій;
attribute sets;
product attributes;
значення атрибутів;
фільтраційні атрибути;
текстові характеристики;
числові характеристики;
select і multiselect-атрибути;
store view значення.;== Авторизація і доступ ==

Для K2 ERP компонент Magento доцільно реалізовувати як окремий канал продажів із власними налаштуваннями API, типом цін, складами, правилами синхронізації, журналом обміну, обробкою помилок, підтримкою подій або регулярної синхронізації та зв’язком із доставкою, оплатами, поверненнями й фіскалізацією.; # Товари резервуються на складі.; K2 ERP має змогу виступати головним джерелом товарів, цін, залишків, складів, документів, оплат і фіскалізації, а Magento — зовнішнім каналом продажів і вітриною для покупців.; Окремо варто відзначити коли потрібно для автоматизації роботи з товарами, категоріями, цінами, залишками, замовленнями, клієнтами, оплатами, доставкою, поверненнями, статусами і фіскалізацією.; Magento має гнучку систему категорій та атрибутів.; Для багатоскладських сценаріїв істотно правильно зіставити склади K2 ERP з Magento sources або stocks.; # компонент Magento визначає, чи товар уже існує в Magento.; Magento підтримує роботу websites, stores і store views.; Якщо API тимчасово недоступне або замовлення не обробилося з першого разу, платформа повинна повторити операцію та не втрачати замовлення.; # K2 ERP отримує замовлення через API або подію.; # K2 ERP зберігає Magento product ID і зв’язки з товарами.; * створення замовлення;

актуалізація замовлення;
оплату;
скасування;
створення shipment;
створення invoice;
створення credit memo;
актуалізація товару;
зміну залишку;
актуалізація клієнта.; Magento відповідає за онлайн-вітрину, каталог, кошик, оформлення замовлення та клієнтський досвід, а K2 ERP має бути центральною системою для товарів, залишків, цін, документів, складів, оплат, доставок і фіскалізації.; У магазині Magento покупець переглядає каталог, фільтрує товари, додає їх у кошик, оформлює замовлення, вибирає доставку, оплату та отримує підтвердження покупки.; Для обліку: у більшості ERP-сценаріїв реальним складським товаром є собою simple product, а configurable product виконує роль вітринної групи варіантів.; Magento застосовується як канал онлайн-продажів.; Adobe зазначає, що Inventory Management у Magento Open Source і Adobe Commerce замінює старі core API CatalogInventory та ScalableInventory і додає нові API для розширення функціональності.; Через те, що магазин обробляє замовлення, клієнтів і платежі, застарілі версії та вразливі модулі можуть створювати критичні ризики для бізнесу.; * які атрибути ведуться в ERP;
які атрибути імпортуються з Magento;
які атрибути не синхронізуються;
як зіставляти довідники значень;
як оновлювати атрибути без втрати ручних даних у Magento;
хто є собою головним джерелом атрибутів.; Типова реалізація має змогу включати:

Синхронізація товарів надає можливість передавати асортимент із K2 ERP у Magento або отримувати товари з Magento в ERP.;== Оплати ==

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

У Magento shipment відповідає за відвантаження замовлення.;

Для K2 ERP: Magento варто розглядати як зовнішній канал продажів.; # Якщо товар існує, платформа оновлює його інформаційні дані.; * Magento customer ID;

ім’я;
прізвище;
email;
телефон;
адреси;
країну;
місто;
поштовий індекс;
customer group;
website;
store view;
дату створення;
дату останнього актуалізація.; компонент K2 Magento має змогу передавати назад у Magento:

Magento Inventory Management застосовується для обліку запасів.; Без інтеграції менеджерам доводиться вручну переносити товари, категорії, ціни, залишки, клієнтів і замовлення між Magento та ERP.;=== Simple product === Основні задачі модуля:

Повернення і credit memo

істотно: K2 компонент Magento не замінює інтернет-магазин і не замінює ERP.; # Оновлюються ціни.;== переважні аспекти K2 Модуля Magento == OpenCart

РРО

website;
store;
store view;
мову;
валюту;
локалізовані назви;
локалізовані описи;
локалізовані SEO-поля;
різні ціни за website;
різні статуси публікації;
різні категорії за магазином.; # Magento повертає результат обробки.;== Синхронізація залишків ==

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

Не плутати: K2 компонент Magento — це не без ускладнень імпорт замовлень.; Для інтеграції потрібно врахувати: Типові типи товарів:

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

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

Tilda Commerce

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

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

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

Store views, websites і мови

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