Takealot Connector для WooCommerce — оферти, ціни, залишки й продажі Takealot

Takealot Connector for WooCommerce звʼязує магазин з вашим акаунтом продавця на Takealot, маркетплейсі Південно-Африканської Республіки. Плагін створює оферти для товарів, які вже є в каталозі Takealot, і тримає їхню ціну, RRP, leadtime і залишок вашого складу такими, як у магазині. Pro приводить продажі Takealot у WooCommerce як замовлення з комісіями, статусами й списанням залишку.

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

Покупець на Takealot бачить ваш товар на сторінці каталогу Takealot з вашою ціною в рандах, перекресленою RRP під час знижки в магазині і доступністю з вашого складу. Ціна йде цілими рандами з ПДВ, з вашою націнкою. Закінчився товар у магазині або ви вимкнули продаж — залишок на Takealot стає 0, оферта не зникає і повертається в продаж разом із залишком.

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

WooCommerce → Takealot: API-ключ із Seller Portal (API Access), «Check connection» з назвою продавця, діапазоном leadtime-днів і складами акаунта, вибір складу, з якого йде залишок. Далі — націнка у відсотках і фіксована, округлення до найближчого ранда або вгору, RRP, leadtime, кількість для товарів без обліку складу, резерв, курс, якщо магазин працює не в ZAR, і кнопки «Link offers already on Takealot», «Send changes now», «Send all offers again».

У товарі зʼявляється вкладка «Takealot»: продавати чи ні, штрихкод, leadtime, власна ціна й RRP. Варіації мають власний штрихкод і ціну, кожна стає окремою офертою. Там же видно номер оферти, статус на Takealot, залишки на складах Takealot (CPT, JHB, DBN) і текст відмови Takealot, якщо вона була.

У Pro продажі Takealot стають замовленнями WooCommerce: опитування кожні 5 хвилин, щоденне перечитування за 30 днів і миттєво через вебхук із Seller Portal. Одне замовлення Takealot — одне замовлення в магазині, суми як на Takealot з ПДВ у ZAR, залишок списується. Комісії Takealot (success fee, fulfilment, courier collection) видно в замовленні разом із сумою після них. Скасований рядок прибирається і повертає залишок, доставлене замовлення стає «Виконано», повернення записується в нотатки.

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

1. У Seller Portal відкриваєте API Access, генеруєте ключ і вставляєте його в плагін; «Check connection» показує ваш акаунт і склади.
2. Обираєте склад, з якого відправляєте замовлення Takealot (leadtime-сток), і правила ціни: націнку, округлення, RRP.
3. Якщо оферти вже є, «Link offers already on Takealot» звʼязує їх із товарами за SKU або штрихкодом, щоб нічого не задвоїлось.
4. У товарах вмикаєте «Sell on Takealot»; для товару зі штрихкодом із каталогу Takealot плагін створює оферту.
5. Зміни ціни й залишку стають у чергу і йдуть кожні 5 хвилин, лише змінене. У Pro продажі приходять у WooCommerce.

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

• Takealot Marketplace API v1 з заголовком X-API-Key; ключ зберігається зашифрованим.
• Ціна: з ПДВ, акційна під час розпродажу, з націнкою і курсом, цілими рандами. Без курсу ціни не йдуть, а наявні оферти отримують залишок 0.
• Шлеться лише змінене; черга кожні 5 хвилин. Якщо Takealot недоступний або відхилив ключ, прогін зупиняється і черга зберігається.
• Журнал API на 300 записів без ключа.
• Pro: вебхук з адресою із секретним токеном і необовʼязковим підписом HMAC-SHA256; тілу вебхука плагін не довіряє, а перечитує продажі з API. Повтори не обробляються двічі.
• Pro: листи WooCommerce персоналу про замовлення Takealot можна вимкнути. Оновлення Pro приходять з catcode.com.ua.
• Сумісно з HPOS. Інтерфейс англійською (en, en_ZA).

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → Takealot: вставте API-ключ, збережіть, натисніть «Check connection».
3. Оберіть склад і збережіть налаштування.
4. Звʼяжіть наявні оферти, увімкніть продаж у товарах і натисніть «Send changes now».
5. Для Pro: вставте ключ або запустіть 7 днів тріалу в розділі «Licence».

Кнопка «Завантажити безкоштовно» дає безкоштовну версію; така сама піде на wordpress.org. Pro — повний архів, він зʼявляється в кабінеті після покупки або тріалу.