The Mall Partner API Connector for OpenCart 3 fully automates publishing your catalog to the Mall group marketplaces. You map OpenCart categories, manufacturers and product attributes into Mall's taxonomy once, and the extension does everything else - creating products, calculating prices (margin + tiered rules + VAT per market), updating stock, syncing variants and assigning brands. Each Mall country has its own Client ID, language, VAT rate and supplier name, so a single OpenCart store can supply an unlimited number of Mall marketplaces.
Advanced features include a title blacklist (blocking products with specific words), product-level overrides (custom category, brand, margin, price or forced disabling), multi-country sync logs with extensive filtering, an interactive preview in Test Tools (see the exact JSON payload before sending it), verification of "leaf" category types, matching of existing Mall products via EAN and background sync via cron jobs with a secure static token. Safe to uninstall - no data is lost.
The Mall Partner API Connector is a production-ready OpenCart 3 or 4 extension that connects your store to the Mall Partner API v2 (mpapi.mallgroup.com).
- Multi-country support - sync the same OpenCart catalog with any number of Mall marketplaces (SI, HR, CZ, SK, HU, PL, AT, DE). Each country has its own API credentials, language, VAT rate, supplier name and mappings.
- Smart price calculation - Opencart price × margin % + tiered adjustments + VAT per market = final gross price. Margin overrides at category, subcategory and product level. A manual net price completely bypasses the calculation. Automatic handling of sale/promo prices.
- Full product sync - title, descriptions (HTML preserved with `<br>`/`<p>`/`<ul>` etc.), images, brand, leaf category, parameters (via attribute mappings), variants, package size rules (weight → smallbox/bigbox), TARIC codes for HR.
- Stock automation - bulk stock + activity status updates. Stock is capped at 20 in line with Mall marketplace rules.
- Title blacklist - block all products whose title contains a specific word. Already synced copies are automatically removed from Mall on the next sync.
- Brand name removal - if a product title starts with the brand name (e.g. "Meta Quest 3s" with brand "META"), the brand is automatically removed to avoid duplication in Mall listings.
- Interactive Test Tools - before sending, view the exact JSON payload, price breakdown and variants for each product. Blacklist detection is shown immediately.
- Matching existing Mall products - link OpenCart products via EAN to products already on Mall, so migration does not require re-uploading.
- Find orphans - the "Show Mall Products Not in OC" function displays products on Mall that have no matching OC product, enabling cleanup.
- Cron jobs - ready-made cron commands with your server URL + a secure token. Scheduling by job (availability, products, categories, brands, activation, cleanup) or run everything with `job=all`. All jobs automatically iterate over all active countries.
- Comprehensive sync log - every event recorded with country, action, status, error code, message and timestamp. Full filtering + pagination + automatic cleanup.
- Safe install / uninstall - settings are automatically backed up and restored. Uninstalling does not delete tables; only "Purge All Data" does (with the required PURGE confirmation).
- Companion extension included - Attribute Value Helper adds predefined attribute values + warnings for required attributes per category, keeping OC attribute values clean and directly improving the quality of parameter sync with Mall.
Admin interface: Clearly organized tabs - General settings, Markets, Sync, Category mapping, Brand mapping, Attribute mapping, Tiered margins, Test Tools, Sync log, Cron jobs. It also adds a Mall Partner tab to every product and category edit page.
Quick feature summary:
- ✅ Multi-country support — SI, HR, CZ, SK, HU, PL, AT, DE
- ✅ Automatic price calculation with margin + tiered rules + VAT per market
- ✅ Full product, variant and availability sync
- ✅ Title blacklist with automatic removal of blocked products
- ✅ Leaf category verification — prevents "Unknown category id" errors
- ✅ Per-product overrides (category, brand, margin, price, forced disabling)
- ✅ Matching existing Mall products via EAN
- ✅ Cron jobs with secure token-based authentication
- ✅ Comprehensive sync log with filtering and pagination
- ✅ Test Tools — preview the JSON payload before sending
- ✅ PHP 8+ · OpenCart 3 and 4 · Safe install/uninstall
- ✅ Attribute Value Helper companion extension included
