Installation and setup

Requirements

• CS-Cart and Multi-Vendor 4.17.2 or later.
• Administrator access to the store’s admin panel.
• A seller account on the PcComponentes marketplace with API access. The seller account, its Mirakl address and the API key are issued by the marketplace; apply through the marketplace’s seller pages. If you cannot see an API key section in your seller back office, ask the marketplace’s seller support to enable API access.
• A cron job on your server (see step 5 below).

Install the add-on

1. Download the kv_pccomponentes-<version>.zip package from your Kavio Labs or CS-Cart Marketplace account.
2. In the admin panel, open Add-ons > Manage add-ons.
3. Click the gear button and choose Manual installation, then upload the archive.
4. Find PcComponentes Marketplace Connector (Mirakl) in the list and make sure its status is Active.
5. Enter your license key under Settings > License (Kavio Labs downloads) and click Check now.

Connect the marketplace

1. Open Orders > PcComponentes (the add-on page) and the Connection tab.
2. In the Test block enter the API URL of your seller account (the Mirakl address from your seller back office, for example https://your-marketplace.mirakl.net, https only, without /api) and the API key (created in the seller back office under your user settings, API key). A Mirakl API key belongs to one environment, so the test and the live block have their own URL and key.
3. Choose your Market. It sets the currency of prices; the Connection page marks markets that were only announced.
4. Optional fields: Shop ID (only when your user belongs to several shops), Channel code (import only the orders of one sales channel), Offer condition code (the code of “New”; empty = read from the marketplace) and Accept new orders automatically (see Usage).
5. Save and click Test connection: a green message shows your shop name, its currency and its channels. A warning appears when the shop currency differs from the market’s.
6. Switch to Live mode only after a successful test and enter the live URL and key; test again.
7. Add the cron job from the settings page (Cron section), every minute is fine. Overlapping runs are prevented.

Multi-Vendor

By default the marketplace owner connects one account for all vendors (Marketplace owner mode on). Switch it off to let each vendor connect their own seller account in the vendor panel (Connection tab).

Update

1. Upload the new package the same way. Your settings, credentials and data are kept.
2. The add-on adds missing tables and settings by itself on the first request after the update.

See CHANGELOG for what changed in each version.

Uninstall

Open Add-ons > Manage add-ons, click the add-on’s gear button and choose Uninstall. This removes the add-on’s settings, language variables and database tables, including the stored credentials.