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 — полный архив, он появляется в кабинете после покупки или триала.