eMAG Marketplace Connector for OpenCart — eMAG prices, stock and orders in your shop

eMAG Marketplace Connector for OpenCart connects your OpenCart 4, 3 or 2.3 shop to eMAG Marketplace, the largest marketplace in Romania, Bulgaria and Hungary (together with Fashion Days). You sell in your shop and on eMAG — the module keeps eMAG prices and stock in line with OpenCart, and with Pro it brings eMAG orders into your shop and ships them through eMAG’s couriers. Everything goes through the official eMAG Marketplace API: no scraping, no manual exports. Running WooCommerce? See eMAG Marketplace Connector for WooCommerce.

What you need. An eMAG Marketplace seller account with an API user, and your server’s IP address whitelisted for the API in the eMAG account. An honest word on testing: eMAG has no public sandbox — the API answers only whitelisted sellers. The module is built from the official eMAG Marketplace API reference v4.5.2 and tested end to end against a simulation of that API (offers, prices, stock, orders, cancellations, statuses, AWBs, invoices, publishing) on OpenCart 4.1, 4.0.2.3, 3.0.5.0 and 2.3.0.2. It has not run on a live seller account yet — try it on yours with the 7-day Pro trial. The log shows every request and eMAG’s answer, and if eMAG answers differently from its documentation, we fix it quickly.

What your shop gets

• One module, five marketplaces: eMAG Romania, eMAG Bulgaria, eMAG Hungary, Fashion Days Romania and Bulgaria. The same API, your own account and currency (RON, EUR, HUF).
• “Save and check the connection” checks the API user and password and reads the VAT rates of your account. An eMAG error (wrong password, IP not whitelisted) is shown in plain words together with eMAG’s answer.
• The API password is stored encrypted (AES-256 with HMAC), never shown in the form again and never written to the log.

• Offer import: the module reads all your eMAG offers and links them to OpenCart products by part number — the SKU, Model or MPN field of your choice, normalised for spaces and punctuation the way eMAG does it — by EAN, UPC, JAN or ISBN, or by ID. Ambiguous matches are not linked by guess but listed separately.
• Sync: a sale in the shop, a product saved in the admin, a product deleted — and the offer goes into a queue the scheduler sends every minute. Once an hour, a full check of all linked products. Only changes are sent, in batches of up to 50 offers; an offer eMAG refuses is found one by one without holding up the rest.
• Price rules: the price without VAT, the way eMAG takes it (a product with a tax class already has a net OpenCart price, one without has a gross price), % and fixed markup, the shop’s currency rates or a manual rate, the OpenCart special price with the regular price crossed out, and the min–max range eMAG requires.
• Stock: a reserve for your own shop, a quantity for products without stock tracking, handling time.

Every product form gets an eMAG tab: sell or not, offer id (the product id by default), its own VAT rate and handling time, the state on eMAG and a “Send to eMAG now” button. The fields are saved with the regular product save button.

Pro: orders, shipping, publishing

• eMAG orders in OpenCart — instantly through eMAG’s callback URL, and a check every 5 minutes picks up anything missed. Buyer, address or locker, the region by name (Bucharest and its sectors included), products, line VAT, vouchers, the SGR deposit and shipping — the total matches eMAG’s, in RON at the shop’s rate.
• OpenCart’s own order history: every status of an eMAG order is set by the same call as for a storefront order, with all of its events. Your fiscal receipt, Telegram notification, automatic waybill or CRM modules see eMAG orders like any other, and OpenCart itself subtracts and restocks. OpenCart’s confirmation e-mail goes to the shop’s address or the one you choose, as eMAG does not share the buyer’s e-mail.
• Acknowledged on eMAG and one order per eMAG number, even when the callback arrives several times.
• Cancellation both ways: cancelled on eMAG becomes “Canceled” in OpenCart with the stock back; cancelled in OpenCart goes to eMAG with the reason you choose.
• Status back to eMAG: change the status in the regular order history in the admin — at the chosen status the order becomes “prepared” or “finalized” on eMAG.

• AWBs through your eMAG courier accounts right from the order page: sender from your eMAG addresses, the buyer’s locker, cash on delivery for the order total, parcels, envelopes and weight, PDF label A4, A5 or A6, delivery status refreshed hourly and, if you want, “Complete” after delivery.
• Invoice: the link to the invoice PDF goes to the eMAG order with a button in the same box.
• Publishing: find a product on eMAG by EAN and attach your offer, or create a new product — the eMAG category from the OpenCart category map, the brand from the manufacturer, description, images, characteristics from OpenCart attributes (matched by name or mapped), EAN, warranty; the documentation validation status comes back to the product.
• Buy button monitor: your rank, the number of offers and the best price every 6 hours, and an e-mail when you lose first place.

How it works, step by step

1. Connect. Extensions → Modules → eMAG Marketplace Connector → Connection: marketplace, API user and password, “Save and check the connection”.
2. Price rules. “Prices & stock” tab: prices with or without VAT, markup, currency rate, stock reserve, VAT rates per tax class.
3. Link. “Products” tab → “Read offers from eMAG”: eMAG offers are linked to products, unlinked ones are listed in the report.
4. Sync. From then on every sale and every product change goes to eMAG by itself. OpenCart 4 does it with its own scheduler; for OpenCart 3 and 2.3 add the cron URL from the “Log” tab to your host’s cron.
5. Orders (Pro). Enable the import and paste the two callback URLs from the “Orders” tab into the eMAG account — new and cancelled orders reach OpenCart instantly.
6. Shipping (Pro). “AWB” tab: courier accounts and addresses from eMAG, the sender’s phone — and the AWB is issued from the order page.

Under the hood

• Request format per eMAG’s documentation: JSON bodies, saves under the data key, reads with top-level filters; for an unusual gateway the read encoding can be switched with a constant.
• eMAG rate limits (3 requests per second, 12 for orders) are respected by the module, and a 429 is retried.
• OpenCart’s own events: the order rows go into the order tables, and the status goes through model checkout/order (addHistory on OpenCart 4, addOrderHistory on 3.x and 2.3). Admin actions on OpenCart 4 run through a storefront instance, just as OpenCart’s own admin does it; on OpenCart 3 and 2.3 they run on the shop’s storefront at a protected URL, and if the storefront cannot be reached the action runs in the admin and says so.
• No duplicate orders: a database lock per eMAG number and the eMAG number ↔ OpenCart order link; a repeated callback creates no second order and does not move stock.
• The callback is protected by a key: a stranger’s call gets 403 and cannot make the module call eMAG.
• No bricking: when a trial ends, only the Pro features stop; sync keeps running.
• Uninstalling removes the events, cron jobs and permissions; the link tables and a copy of the settings stay, so a reinstall loses nothing.

Installation

1. OpenCart 4: Extensions → Installer → upload cc_emag.ocmod.zip (keep the file name) and click “Install”. OpenCart 3: Extensions → Installer → cc_emag-oc3.ocmod.zip, then Extensions → Modifications → “Refresh”. OpenCart 2.3: upload the contents of the upload/ folder from cc_emag-oc23.ocmod.zip to the shop root (FTP or your host’s file manager) — the 2.3 Installer copies no files without FTP set up.
2. Extensions → Extensions → Modules → eMAG Marketplace Connector → “Install”, then “Edit”.
3. Connection: marketplace, API user and password, “Save and check the connection”.
4. Products: “Read offers from eMAG” — your offers are linked to products.
5. For Pro: paste the licence key from the e-mail after payment or click “Start the 7-day trial” on the “Licence” tab, then the Orders and AWB tabs. On OpenCart 3 and 2.3 add the cron URL from the “Log” tab to your host’s cron.