Merchant Pro Integration
Overview
Section titled “Overview”The Merchant Pro integration connects MicroPIM to your Merchant Pro store using the Merchant Pro REST API. MicroPIM syncs products, variants, stock, pricing, categories, brands, and images in both directions — pulling the existing catalog from Merchant Pro and pushing updates back. Merchant Pro is a SaaS e-commerce platform popular with Romanian merchants.
Prerequisites
Section titled “Prerequisites”- An active Merchant Pro store with API access enabled
- Admin access to the Merchant Pro back office
- An active MicroPIM account
What you’ll need
Section titled “What you’ll need”| Field | Where to find it |
|---|---|
| Store URL | Your Merchant Pro store URL, e.g. https://your-store.merchantpro.ro |
| Utilizator API | The API username shown after creating an API user in Merchant Pro |
| Parola API | The API password shown once after creating the API user |
Create an API user in Merchant Pro
Section titled “Create an API user in Merchant Pro”Before connecting MicroPIM you need to create a dedicated API user (or generate API credentials) in the Merchant Pro admin panel.
-
Log in to the Merchant Pro admin panel and click Setari (Settings) in the bottom-left sidebar.
-
In the Settings page, scroll down and click API si webhook-uri.
-
On the Utilizatori API tab, click + Adauga API user in the top-right corner.
-
In the dialog, enter a Denumire interna (e.g.
micropim_api_key) and enable the following permissions:- Permisiuni catalog → Read & Write
- Website
Then click Salveaza.
-
The new user appears in the list. Copy the Utilizator API and the Parola API values — you will need them in MicroPIM.
Keep the Parola API safe — it is shown only once after creation. If you lose it, delete the API user and create a new one in Merchant Pro.
Connect MicroPIM to Merchant Pro
Section titled “Connect MicroPIM to Merchant Pro”- In MicroPIM, go to Integrations → Add Integration
- Select Merchant Pro from the platform list
- Paste your Merchant Pro store URL into Store URL
- Enter the Utilizator API value into API User
- Paste the Parola API value into API Password
- Click Test Connection to verify the credentials
- Click Save to create the integration
What syncs
Section titled “What syncs”| Data | Direction | Notes |
|---|---|---|
| Products | MicroPIM → Merchant Pro | Title, description, SKU, brand, attributes |
| Variants | MicroPIM → Merchant Pro | Variant combinations and SKUs |
| Stock | MicroPIM → Merchant Pro | Quantity per SKU |
| Pricing | MicroPIM → Merchant Pro | Base price and promotional price |
| Categories | MicroPIM → Merchant Pro | Category tree mapping |
| Images | MicroPIM → Merchant Pro | Main image and gallery |
How MicroPIM pulls data from Merchant Pro
Section titled “How MicroPIM pulls data from Merchant Pro”MicroPIM reads your existing Merchant Pro catalog on an ongoing basis. This keeps MicroPIM in sync with changes made directly in Merchant Pro.
What the pull covers:
- Product names, descriptions, and SKUs already in Merchant Pro
- Existing category tree (used for mapping categories in MicroPIM)
- Current prices and stock levels
- New products added directly in Merchant Pro since the last pull
How to trigger a pull:
- On demand — go to Integrations → Merchant Pro → Import from store and click Pull catalog
- On a schedule — configure a pull interval under Integrations → Merchant Pro → Automation
Pulled products are matched to existing MicroPIM products by SKU. New SKUs found in Merchant Pro are imported as new products in MicroPIM.
How MicroPIM pushes data to Merchant Pro
Section titled “How MicroPIM pushes data to Merchant Pro”MicroPIM sends updated product data to Merchant Pro via the REST API. This is the primary direction for keeping your store up to date after you manage products in MicroPIM.
What the push covers:
- Product title, description, brand, and attributes
- Variant combinations and their SKUs
- Stock quantity per SKU
- Base price and promotional price
- Main image and gallery images
- Category assignments
How to trigger a push:
- On demand — go to Integrations → Merchant Pro → Sync and click Push to store
- On a schedule — configure under Integrations → Merchant Pro → Automation
- Automatic — enable real-time push to send changes immediately when a product is updated in MicroPIM
Products are matched by SKU on push. If a SKU exists in Merchant Pro it is updated; if not, a new product is created.
Field mapping
Section titled “Field mapping”Default mapping covers Merchant Pro’s standard product fields. To map custom attributes (such as technical specifications or product tags) go to Integrations → Merchant Pro → Field Mapping.
Troubleshooting
Section titled “Troubleshooting”401 Unauthorized — the Utilizator API or Parola API is incorrect. Delete the API user in Merchant Pro, create a new one, and update the integration in MicroPIM.
403 Forbidden — the API user does not have the required permissions. Edit the API user in Merchant Pro and enable read/write for Products, Stock, Categories, and Prices.
404 Not Found — check that the Store URL is correct and has no trailing slash.
Stock not updating — confirm the product exists in Merchant Pro with a matching SKU. Merchant Pro matches by SKU on update.
Products not creating — verify the API user has write permission on Products.
Images not appearing — images are uploaded by URL. Ensure the image URLs in MicroPIM are publicly accessible.
Romanian characters appearing incorrectly — MicroPIM sends UTF-8. Verify your Merchant Pro store’s character encoding is set to UTF-8.
Can I connect multiple Merchant Pro stores? Yes — add one Merchant Pro integration per store.
How often does sync run? On-demand or on a schedule you configure under Automation. You can also enable real-time push for immediate sync on product save.
Can I roll back a sync? Syncs are not reversible, but every change is recorded in the Audit Log.
What happens if a product exists in Merchant Pro but not in MicroPIM? On pull, MicroPIM imports it as a new product. You can then manage it centrally in MicroPIM.