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.