Kaufland Marketplace Connector для OpenCart 2.3, 3.x і 4.x — оферти, ціни, замовлення

Kaufland Marketplace Connector для OpenCart продає товари магазину на вітринах Kaufland Global Marketplace через Seller API: Німеччина, Австрія, Чехія, Словаччина, Польща й інші, відкриті для вашого акаунта. Модуль звʼязує наявні оферти, створює нові за EAN і тримає ціну й залишок на кожній вітрині. Pro приводить замовлення Kaufland в OpenCart і передає назад відправлення, скасування, рахунок і дані товару.

Що бачить покупець

Покупець на Kaufland бачить ваш товар за EAN з ціною у валюті вітрини (EUR, CZK, PLN): ціна брутто з ПДВ вітрини, ваша націнка, акційна ціна OpenCart. Вимкнений товар стає на утримання з кількістю 0.

Що отримує адмін

Розширення → Модулі → Kaufland Marketplace Connector: ключі, перемикач Playground, перевірка зʼєднання показує вітрини, ставки ПДВ, склади й групи доставки. Для кожної вітрини окремо: продавати чи ні, націнка у відсотках і фіксована, група доставки, склад. Імпорт наявних оферт звʼязує їх за id_offer або EAN.

У Pro замовлення Kaufland приходять push-сповіщенням і опитуванням кожні 4–5 хвилин. На сторінці замовлення є панель: позиції з офертами, «Перечитати з Kaufland», відправлення з перевізником і трек-номером, скасування з причиною, завантаження рахунку PDF. Статуси «Відправлено» і «Скасовано» в OpenCart теж ідуть у Kaufland.

Як це працює, крок за кроком

1. У Seller Portal (Settings → API) генеруєте Client Key і Secret Key, вставляєте в модуль і перевіряєте зʼєднання.
2. Вмикаєте вітрини, задаєте націнку, групу доставки й склад, заповнюєте EAN у товарах.
3. Імпорт звʼязує наявні оферти; нові можна створювати за EAN.
4. Зміни ціни й залишку йдуть у чергу і пакетами до 150 оферт; помилки 5xx і 429 лишаються в черзі.
5. У Pro замовлення приходять в OpenCart, а відправлення й скасування повертаються в Kaufland.

Що під капотом

• Кожен запит підписується HMAC; ключі зберігаються зашифрованими.
• Ціна рахується в центах у валюті вітрини: курс магазину або ручний EUR/CZK/PLN, ставка ПДВ вітрини за класом податку.
• Видалений товар знімає оферту, оферта з 404 створюється знову.
• Замовлення не задвоюються (блокування і звʼязка з номером Kaufland); замовлення FBK не імпортуються.
• Pro надсилає дані товару мовою кожної вітрини: назва, опис, фото, виробник, категорія й атрибути за вашою мапою.
• Журнал API: 100 записів за 30 днів.

Як встановити

1. Розширення → Інсталятор: завантажте архів під свою версію, не змінюючи назву файлу.
2. OpenCart 3.x і 2.3: Розширення → Модифікації → «Оновити».
3. Розширення → Модулі → Kaufland Marketplace Connector → встановити → редагувати.
4. Вставте ключі, перевірте зʼєднання, увімкніть вітрини й запустіть імпорт оферт.
5. Для Pro: вставте ключ або запустіть 7 днів тріалу на вкладці Licence.