Takealot Marketplace Connector for OpenCart — offers, prices, stock and Takealot sales

Takealot Marketplace Connector for OpenCart 2.3, 3.x and 4.x connects the shop to your seller account on Takealot, the South African marketplace. The module links your Takealot offers to products and keeps their price, RRP, leadtime and the stock of your warehouse the same as in the shop. Pro brings Takealot sales into OpenCart as orders with fees, cancellations and returns.

What the buyer sees

A buyer on Takealot sees your product on the Takealot catalogue page with your price in rand and availability from your warehouse. The price goes out in whole rand with VAT, with your markup and an exchange rate when the shop does not sell in ZAR. A disabled or deleted product gets stock 0 on Takealot.

What the admin gets

Extensions → Modules → Takealot Marketplace Connector, tabs “Connection”, “Offers”, “Products”, “Sales & orders”, “Licence”, “Log”. “Connection” has the API key from the Seller Portal and “Check connection” with the seller name, VAT registration and leadtime range. “Offers” has automatic sync, the warehouse for the stock, the SKU source and the barcode field (EAN, UPC, ISBN), new offer creation, prices with or without VAT, the VAT rate, the rate to ZAR, markup and rounding.

“Import and link” reads every offer of the account and links it to a product by offer id, SKU, then barcode; an offer that fits more than one product stays unlinked. Products get a Takealot tab: sell or not, offer id, SKU, barcode, leadtime, the price for Takealot and the state on Takealot with Takealot warehouses (CPT, JHB, DBN), plus “Send now” and “Find on Takealot”.

In Pro, Takealot sales become OpenCart orders: a check every 10 minutes, an hourly re-read of recent ones, and at once through the webhook. The lines of one Takealot order go into one order, amounts in ZAR, VAT as a separate line, stock reduced the standard way. Takealot fees and what is left after them are shown in the order panel and history. A cancellation on Takealot sets “Canceled” and returns the stock, a return becomes a note, and when everything came back the status is “Refunded”.

How it works, step by step

1. In the Seller Portal open API Access, generate a key and paste it into the module; “Check connection” shows your account.
2. On the “Offers” tab choose the warehouse, the barcode field and the price rules.
3. “Import and link” links your existing offers to products; products without an offer are listed with the reason.
4. A changed product, a shop order or the hourly check queues the product; the queue goes out every minute (OpenCart 4 cron) or with the cron URL from the “Log” tab.
5. In Pro, Takealot sales come in as OpenCart orders.

Under the hood

• Takealot Marketplace API v1 with the X-API-Key header; the key is stored encrypted (AES-256).
• Up to 25 changes go one offer at a time, more go as a batch with its result read back.
• Only changes are sent; on 429 the module waits as long as Takealot asks.
• API log: 100 entries on screen, 30 days in the database, without the key.
• Pro: a webhook with a key in its address; the body is only a signal, the sales are read again from the API.
• Pro: an option “sales do not take the shop stock” for products Takealot sells from its own warehouses.
• Interface in English. One library for the three builds.

How to install

1. OpenCart 4: Extensions → Installer, upload cc_takealot.ocmod.zip, install. OpenCart 3 and 2.3: Extensions → Extension Installer, upload the archive for your version, then Modifications → Refresh.
2. Extensions → Modules → Takealot Marketplace Connector: install and open it.
3. Paste the API key, press “Check connection”, choose the warehouse and barcode field on the “Offers” tab, save.
4. On the “Products” tab press “Import and link”.
5. For Pro: paste the key or start the 7-day trial on the “Licence” tab.