| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1685 |
| Technical Name |
mp_za_takealot |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1685 |
| Technical Name |
mp_za_takealot |
| License | OPL-1 |
| Website | https://gencbaris.com/odoo_plugins/ |
| Versions | 18.0 19.0 |
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
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module