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».