INSTRUCTIONS FOR
Integrating your ShopWare 5.x store with Price2Spy
Please follow the simple steps shown below .
Instructions
STEPS IN SHOPWARE 5.X – PART 1
Please login to ShopWare 5.x, and do the following:
- In Shopware back-end click on Configuration
- Go to User administration
- In the User administration do the following:
- In left menu click on List of roles
- Then click button Add role
- Fill in the following fields:
- Name (for example: price2spy-integration-role)
- Description (for example: Role for Price2Spy integration)
- Afterward, click the Update button
- Shopware 5.x will ask for password validation, please enter your password and click OK
STEPS IN SHOPWARE 5.X – PART 2
Under the Users and roles menu on the left click on Edit roles & permissions
- In the Role dropdown menu select the role created in part 1
- Expand the category folder and select read as well as the article folder
- Then click the button Assign the selected privileges for the selected role
- Shopware 5.x will ask for password validation, please enter your password and click OK
STEPS IN SHOPWARE 5.X – PART 3
Under the Users and roles menu on the left click on List of users
- Click the button Add user
- A new User window will popup, please fill in the following:
- In Login section
- User name (for example: price2spy)
- Then select Enabled box under
- Fill in Password (for new user)
- Then Re-enter password
- In API section
- Select Enabled box
- Please copy the API KEY you will also need it further on
- In Main data section
- Fill in Real name
- Fill in Email address
- In the Member of role dropdown menu select the role defined in part 1
- Shopware 5.x will ask for password validation, please enter your password and click OK
STEPS IN PRICE2SPY – PART 1
Once in Price2Spy interface, do the following:
- In the left-side menu click on Integrations.
- In the Integrations submenu, click on Link My Store.
- On the following screen, select SHOPWARE 5.X.
- Click on 'NEXT'.
STEPS IN PRICE2SPY – PART 2
- Fill out the following fields related to your store details:
- Store URL;
- API URL;
- Username;
- API KEY.
- Click on 'NEXT' to go to the next step of the integration process.
STEPS IN PRICE2SPY – PART 3
- In Step 3 of the integration process you choose which categories you want to sync with your Price2Spy account.
- Do this by expanding the dropdown menu by clicking on the down-pointing arrow (as noted in the image).
- Once expanded, select all the categories you want to sync.
- Before clicking on 'NEXT' you may check how many products will be synced with your Price2Spy account by clicking 'CHECK'.
- Click on 'NEXT' to go to the next step of the integration process.
STEPS IN PRICE2SPY – PART 4
- In Step 4 of the integration process you set the following parameters:
- Store execution frequency - decide how frequently (the default value is once per day) and at what time you want store executions to be performed.
- Price check frequency - decide how frequently you want the price checks to be performed (of the products created via Link My Store Operation).
- Email notifications - decide whether you want to receive email notifications about store executions and price checks.
- Click on 'FINISH' to complete the integration process.
Troubleshooting
- Network/Firewall issues - In many cases, we experience that client’s Web server is behind a firewall, which will block our requests. Therefore, please make sure that you have done the following whitelisting changes to your firewall:
- Whitelist specific countries: please white list Serbia and The Netherlands.
- Whitelist user-agent: ReactorNetty.
- Request rates - If your store contains a large number of products, Price2Spy will have to make a large number of requests to your Web server in order to perform the syncing..
- If a large number of requests is problematic for your Web server – please contact support@price2spy.com and we will spread the requests over a longer period of time
- In case you’re not sure where to apply the above firewall changes, please get in touch with your hosting company. If you’re unsure whom to contact, please let us know, we’ll be happy to point you in the right direction.
Basic info
- All product-related columns (product name, SKU, internal ID, custom fields, metadata, brand, supplier, and category) can have up to 250 characters.
- Comment fields support 4GB (4,294,967,295 characters).
- URL is limited to 2,000 characters.
- The following fields can contain 65,535 characters (64 KB): note1, note2, note3, image1Url, image2Url, and image3Url.