The ASPOS connector is set up using Connect's onboarding wizard, which includes the following steps:
- Step 1 – Selecting the connector
- Step 2 – Preset
- Step 3 – Authentication
- Step 4 – Connector
- Step 5 – Products
- Step 6 – Orders
- Step 7 – Contacts
- Step 8 – Billing Information
- Step 9 – Summary
- Step 10 – Confirmation
- Step 11 – First import and activation
To onboard the connector, keep the following credentials for the POS at hand:
- API Key
- API Secret
- Shop URL
Furthermore, you will need Rabbit MQ credentials and so-callled 'queue names'. These credentials and queue names correspond to data and queues in ASPOS and can be retrieved through your ASPOS account manager. You will need the following credentials and names:
- RabbitMQ URL
- RabbitMQ Username
- RabbitMQ Password
- Contact creation queue
- Contact update queue
- Contact deletion queue
- Product creation queue
- Product update queue
- Order queue
Please note
Make sure that you have gathered all credentials before onboarding the connector, because you will not be able to complete the setup otherwise.
Step 1 - Selecting the connector
When logging into Connect, click the New connector button on the dashboard. This will open the onboarding wizard.
Select the ASPOS connector from the list of available connectors. If you want to move to a different tab in Connect at any time during the onboarding process, you can save the connector as a draft. When ASPOS is selected, click Next.
Step 2 – Preset
Currently, no presets exist for ASPOS. This means that you can only do a manual configuration. Select this option, and click Next.
Step 3 – Authentication
Fill in the ASPOS API key, API secret and Shop URL and and click Next.
If credentials for the POS are not correct, one of the following error messages will occur:
| Message | Solution |
|---|---|
| We can't connect with the given URL. Check if all inputs have been filled in correctly. | Recheck the API key or secret. |
| We can't connect with the connector. Check if all inputs have been filled in correctly. | Recheck the Shop URL. |
| An unknown issue has occurred. | Contact Connect support. |
Step 4 – Connector
This step is designed to allow you to customize the name of the connector. This personalized name will be displayed directly beneath the connector's logo in the dashboard. Furthermore, you will need to fill out the RabbitMQ credentials and queue names here. If these are not available to you, please check with your ASPOS account manager. Fill the fields, and click Next.
Step 5 – Products
This section allows you to choose whether you would like to import products lfrom ASPOS into Spotler Connect. Enabling this setting will allow Spotler Connect to import ASPOS products, in order to correctly import order data. We recommend leaving this setting enabled. If you disable this setting, many if not all order imports will fail. Click Next.
Step 6 – Orders
Next, you decide whether to import order data from ASPOS into Spotler Connect. When enabled, this setting ensures that your POS orders are imported to Connect and can be synchronised with other connectors. We recommend enabling this setting. Click Next.
Step 7 – Contacts
The contacts section provides the options to import contact data to Connect, and to export contact data from Connect to ASPOS. We recommend enabling both settings. Click next.
Step 8 – Billing information
To continue, fill out any remaining billing information. If all information has been filled out previously, this step may automatically be skipped. Click Next.
Step 9 – Summary
A summary of the selected information for the integration will be shown. The blue underlined text is clickable and represents a configuration. Any configuration options that still need to be completed will appear as questions or placeholders on this screen, and must be configured before proceeding to the next step. Once completed, click Next.
Step 10 – Confirmation
This is the final step before the connector is activated. Once Next is clicked, the connector will be created. This means that everything is ready in order for ASPOS to export data to Connect. Click Next to activate the connector.
Step 11 – First data sync
The connector is ready to receive data. New data will immediately be synched as per the configuration. If you would like to impot historical data too, it's important to contact your ASPOS account manager in order to start the initial data export from ASPOS.