PcComponentes Marketplace Connector (Mirakl)
Edition: CS-Cart & Multi-Vendor · Latest version: 1.0.0 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view
Connects CS-Cart and Multi-Vendor to the PcComponentes marketplace, which runs on the Mirakl marketplace platform: offers created by EAN, price and stock sent as imports, orders accepted and imported, tracking and returns, with your own seller API key.
What it does
Section titled “What it does”- Maps CS-Cart categories and products to offers on the marketplace (offers are matched to the marketplace catalogue by EAN) and creates them with an offer import (Mirakl OF01).
- Reads the result of every import (OF02 and the error report OF03) and shows the marketplace’s reason on the product that was rejected.
- Sends stock (stock import STO01) and price (price import PRI01) when they change.
- Accepts new orders (OR21, an option), imports them into CS-Cart without duplicates with buyer, delivery and billing address and prices as sold, and sends your carrier and tracking number (OR23) and the shipment confirmation (OR24).
- Cancels order lines you cannot deliver (OR33) with a reason taken from the marketplace, and accepts return requests (RT21).
- The API key is stored encrypted; test and live mode are separate; a “Test connection” button reads your shop (A01) and checks the currency of the market.
- A job queue with automatic retries (5 minutes, 15 minutes, 1 hour, 3 hours, 12 hours), a log with filters and CSV export.
- Multi-Vendor: marketplace owner mode (one seller account for the whole marketplace) or one seller account per vendor in the vendor panel.
Markets in the operator file: Spain and Portugal (one connection per country). Prices are in EUR. PcComponentes admits approved sellers and matches offers to its catalogue by EAN (EAN is assumed; see docs/conformance.md).
Built on the Mirakl engine
Section titled “Built on the Mirakl engine”PcComponentes is one of many marketplaces that run on Mirakl. This add-on contains a generic Mirakl driver (Drivers\Mirakl) and one operator file (Drivers\Mirakl\Operators\PcComponentes.php) with everything that is specific to PcComponentes. Other Mirakl marketplaces are separate Kavio Labs products that reuse the engine with their own operator file. See Developer notes and the conformance table that lists every Mirakl API operation used and how it was checked.
Compatibility
Section titled “Compatibility”- CS-Cart and Multi-Vendor 4.17.2 to 4.21.x.
- PHP 7.4 to 8.3, depending on your CS-Cart version.
- The queue needs a cron job (a command line or a secret web address; see Configuration).
What this version does not do
Section titled “What this version does not do”- It does not create products that are missing in the marketplace catalogue (the Mirakl product import P41 is not used): an EAN the marketplace does not know is reported back as rejected.
- Offer prices are plain prices: no volume, channel or scheduled prices (the Mirakl price import replaces all prices of an offer).
- Refunds, incidents and customer messages are handled in the marketplace back office.
Next steps
Section titled “Next steps”PcComponentes is a trademark of its owner (PcComponentes / Spain) and Mirakl is a trademark of Mirakl; they are named here only to say what this add-on connects to. This add-on is not affiliated with or endorsed by PcComponentes or Mirakl.