Takealot Marketplace Connector для OpenCart — офферы, цены, остатки и продажи Takealot

Takealot Marketplace Connector для OpenCart 2.3, 3.x и 4.x связывает магазин с вашим аккаунтом продавца на Takealot, маркетплейсе Южно-Африканской Республики. Модуль связывает ваши офферы Takealot с товарами и держит их цену, RRP, leadtime и остаток вашего склада такими же, как в магазине. Pro приводит продажи Takealot в OpenCart как заказы с комиссиями, отменами и возвратами.

Что видит покупатель

Покупатель на Takealot видит ваш товар на странице каталога Takealot с вашей ценой в рандах и наличием с вашего склада. Цена уходит целыми рандами с НДС, с вашей наценкой и курсом, если магазин работает не в ZAR. Выключенный или удалённый товар получает на Takealot остаток 0.

Что получает админ

Расширения → Модули → Takealot Marketplace Connector, вкладки «Connection», «Offers», «Products», «Sales & orders», «Licence», «Log». На «Connection» — API-ключ из Seller Portal и «Check connection» с названием продавца, регистрацией НДС и диапазоном leadtime. На «Offers» — автосинхронизация, склад для остатка, источник SKU и поле штрихкода (EAN, UPC, ISBN), создание новых офферов, цены с НДС или без, ставка НДС, курс к ZAR, наценка и округление.

«Import and link» читает все офферы аккаунта и связывает их с товарами по номеру оффера, SKU, затем штрихкоду; оффер, подходящий нескольким товарам, остаётся несвязанным. В товаре есть вкладка Takealot: продавать или нет, номер оффера, SKU, штрихкод, leadtime, цена для Takealot и состояние на Takealot со складами Takealot (CPT, JHB, DBN), кнопки «Send now» и «Find on Takealot».

В Pro продажи Takealot становятся заказами OpenCart: опрос каждые 10 минут, ежечасное перечитывание свежих и сразу через вебхук. Позиции одного заказа Takealot собираются в один заказ, суммы в ZAR, НДС отдельной строкой, склад списывается штатно. Комиссии Takealot и сумма после них видны в панели и истории заказа. Отмена на Takealot ставит статус «Отменён» и возвращает склад, возврат становится заметкой, а когда вернули всё — статус «Возвращён».

Как это работает, шаг за шагом

1. В Seller Portal открываете API Access, генерируете ключ и вставляете его в модуль; «Check connection» показывает ваш аккаунт.
2. На вкладке «Offers» выбираете склад, поле штрихкода и правила цены.
3. «Import and link» связывает ваши существующие офферы с товарами; товары без оффера видны с причиной.
4. Изменение товара, заказ в магазине или ежечасная сверка ставят товар в очередь; очередь уходит каждую минуту (cron OpenCart 4) или по cron-адресу с вкладки «Log».
5. В Pro продажи Takealot приходят как заказы OpenCart.

Что под капотом

• Takealot Marketplace API v1 с заголовком X-API-Key; ключ хранится зашифрованным (AES-256).
• До 25 изменений — по одному офферу, больше — пакетом (batch) с чтением результата.
• Отправляется только изменённое; на 429 модуль ждёт столько, сколько просит Takealot.
• Журнал API: 100 записей на экране, 30 дней в базе, без ключа.
• Pro: вебхук с ключом в адресе; тело только сигнал, продажи перечитываются из API.
• Pro: опция «продажи не списывают склад магазина» для товара, который Takealot продаёт со своих складов.
• Интерфейс на английском. Одна библиотека для трёх сборок.

Как установить

1. OpenCart 4: Расширения → Установщик, загрузите cc_takealot.ocmod.zip, установите. OpenCart 3 и 2.3: Расширения → Установка расширений, загрузите архив своей версии, затем Модификаторы → Обновить.
2. Расширения → Модули → Takealot Marketplace Connector: установите и откройте.
3. Вставьте API-ключ, нажмите «Check connection», на вкладке «Offers» выберите склад и поле штрихкода, сохраните.
4. На вкладке «Products» нажмите «Import and link».
5. Для Pro: вставьте ключ или запустите 7 дней триала на вкладке «Licence».