Takealot Connector for South Africa
Sync offers, stock, prices and orders, and reconcile your Takealot payouts — directly from Odoo with your own Seller API key (BYOK)
One Takealot store, fully wired into Odoo
This module connects your Odoo database to the Takealot Seller API
(seller-api.takealot.com) using the API key generated in your own
Takealot Seller Portal. Nothing is routed through a third party: the key stays in
your database and requests go straight to the official Takealot endpoint you
configure. Keep your catalogue, availability and pricing aligned with Takealot, pull
marketplace sales into Odoo, and reconcile the net payout Takealot owes you against
what Odoo recorded — all without leaving Odoo.
Offer, stock & price sync
- Pull all seller offers from
/v2/offers(paged) and mirror offer id, TSIN, SKU, status and stock-at-Takealot onto the product. - Push your Odoo sales price to a single offer or in bulk via
PATCH /v2/offers/offer/{id}. - Push on-hand availability as Takealot
leadtime_stock(merchant warehouse & quantity) with a configurable lead-time in days. - Flip an offer between Buyable, Not Buyable and Disabled by Seller from the product form.
- Hourly background sync of price and availability for every flagged product.
Sales import & orders
- Pull marketplace sales from
/v1/salesover a configurable look-back window, de-duplicated by Takealot order-item id. - Each sale line is matched to an Odoo product by SKU, internal reference or barcode.
- Optionally create a draft Odoo
sale.orderper Takealot order, grouping all of its lines. - Returns and cancellations are detected and flagged automatically.
Payout reconciliation
- Compute gross, Takealot fee, effective fee rate and the expected net payout for every sale line.
- Match imported sales against their linked Odoo sale orders and surface quantity and value variances down to the cent.
- A reconciliation wizard rolls a date range up into matched / unmatched / variance counts and a total expected net payout in Rand.
Built for trust
- BYOK: your Takealot Seller API key, your endpoint — no middle-man service.
- Editable base URL and per-resource API version paths for proxy or future-host scenarios.
- Automatic retry with back-off on transient 429/5xx responses and a 30-second per-request timeout.
- Every API call is recorded in a unified log with operation, status, duration and error excerpt.
What the connector touches
| Area | Takealot resource | Direction |
|---|---|---|
| Offer mirror | GET /v2/offers, /v2/offers/count | Takealot → Odoo |
| Price update | PATCH /v2/offers/offer/{id} | Odoo → Takealot |
| Stock availability | leadtime_stock on the offer | Odoo → Takealot |
| Offer status | Buyable / Not Buyable / Disabled | Odoo → Takealot |
| Sales import | GET /v1/sales | Takealot → Odoo |
| Reconciliation | gross, fee, net payout, variance | In Odoo |
Requirements
- Odoo 18.0 or 19.0, Community or Enterprise.
- An active Takealot Seller account with an API key (Seller Portal → API Integration → Seller API).
- The Python
requestslibrary (bundled with Odoo).
Screenshots
Api Log
Reconcile Sales
Takealot Sales
Settings
Update date: 2026-07-02