
- Install the WISEPIM app from the CCV Shop App Store. The quickest route, and it sets up your WISEPIM account for you.
- Generate API keys yourself and paste them into WISEPIM. Use this to connect a store to a WISEPIM account you already have.
You need admin access to your CCV Shop store, either to install the app or to generate API keys.
Install the app from the CCV Shop App Store
Install WISEPIM from the CCV Shop App Store and the connection is made for you.1
Find WISEPIM in the CCV Shop App Store
Open the App Store in your CCV Shop admin and search for WISEPIM.
2
Install the app
Install it and approve the access CCV Shop asks about. Finish within 30 minutes: CCV Shop does not allow an installation to take longer.
3
Continue in WISEPIM
WISEPIM shows Your CCV Shop is connected. What happens next depends on your account, see the table below.
If the installation fails, WISEPIM shows We couldn’t complete the installation with the reason. The common ones: the installation took longer than 30 minutes, CCV Shop did not give the app the permission it needs, or CCV Shop did not accept the connection. Start the installation again from the App Store. If it keeps failing, contact support@wisepim.com.
Generate API keys in CCV Shop


1
Open the API settings
Log in to your CCV Shop admin panel. Go to Settings, then API & Webhooks, then open the API Keys tab.
2
Create a new key
Click Generate new API key and fill in the details:
- Description: a name you recognize, such as
WISEPIM Integration - Permissions: read and write for all resources, including webshops, products, categories, attributes, media and orders
3
Save and copy your credentials
Click Save. CCV Shop gives you a public key and a private key. Copy both and keep them somewhere safe. You enter them in WISEPIM next.
Add the keys to WISEPIM
1
Open the CCV Shop integration
Log in to WISEPIM. Go to Settings > Integrations and select CCV Shop.
2
Enter your credentials
- API Key: the public key
- API Secret: the private key that belongs to it
- API URL: your store address, such as
https://your-store.nl - Storefront URL (optional): only if your public storefront differs from the API URL
3
Test and save
Click Test Integration, then Save. Saving tests the connection again.
Run more than one CCV Shop store? Add each as its own connection profile with its own API keys. Imports and exports look up existing products per profile, so products from one shop are never matched against another, and each shop keeps track of its own photo gallery.
When the connection test fails
CCV Shop answers every login problem the same way, so WISEPIM names CCV’s own error code and the fix:
An error without a code usually means a wrong store address. Check the API URL and test again.
How exports are verified
After every write, WISEPIM reads the product back from CCV Shop per language. If CCV silently ignored a Dutch or German value, the product is marked failed and stays eligible for the next export instead of hiding behind a green task. When every field you asked to export is controlled by CCV’s multishop settings, the task reports that CCV Shop controls every requested field and no product data was updated, and retries later.- Translated URLs. A translated product or category gets its own URL alias, built from the translated name once the read-back confirms the text. Only a blank alias, or one that still equals the primary-language alias, is replaced. An alias you set yourself is kept, and an alias CCV refuses is logged as a warning without failing the export.
- Categories. A product export only links products to categories that already exist in CCV Shop. It never creates them, and a category it cannot match, or matches more than once, is skipped. A category export writes the name, description, page title, meta description, meta keywords and the show-on-website setting, but no images. Category updates are read back too, so a change CCV did not store fails the export.
- Discounts. WISEPIM sends the discount with every price: your active special price, or
0when there is none, so an old promotion does not linger. Turn off discount syncing in the connection’s field mapping if you manage promotions in CCV Shop. When a promotion kept that way exceeds the new price, the price update is blocked with a message instead of selling below zero. - Properties. When two attributes map to the same CCV property, the last one wins and the property is written once.
How images sync
On export, your CCV Shop gallery is made to match your WISEPIM gallery, in the order you set in WISEPIM. The first image becomes the main product photo.- Each photo goes out once, however many times it is linked to the product.
- A photo deleted in the CCV admin is restored on the next export. If CCV still holds fewer photos after one retry, WISEPIM stops re-sending until the gallery changes and reports the shortfall, such as
2/3. - Extra photos added in CCV beyond your WISEPIM gallery are removed on the next export.
- Images without a file extension are uploaded unchanged.
- A product exported to two CCV shops has its gallery tracked per shop.
How imports work
- Imports respect CCV Shop’s rate limit and wait as CCV asks. After 5 waits in a row on the same page, the import gives up on that page.
- Products that are only configurable through attribute values import and re-import correctly.
- A re-import unlinks images that came only from the previous CCV gallery. It never deletes them.
- The Category Import automation node, with CCV Shop as the source, imports parents before children and no longer adds copies at the root on each run. One bad row no longer stops the whole batch, and a category moved to the root gets its own tree. A row whose CCV id is linked to two WISEPIM categories fails with a message to merge them before importing.
Keep your API keys safe
Treat your API keys like passwords. Anyone with them can access your store data.- Never share your keys or post them publicly.
- Never commit keys to version control.
- Store keys in environment variables where you can.
- Rotate your keys regularly.
- Grant only the permissions the integration needs.
Related
Importing Products
Pull products from CCV Shop into WISEPIM.
Enriching Products with AI
Improve product content with AI.
Exporting Products
Send products back to CCV Shop.

