Integration setup in Shopify
Log in to the Shopify backend, to create a new API integration. Go to Settings > Apps & sales channels > Develop apps > Create an app.
Next, add the App and do the following.
- Add an app name, such as Tinx.
- Add a developer's contact details (someone to contact in case you need help).
- Go to Configuration > Admin API integration > Click on Configure.
- Under Admin API access scopes, check all the scopes that the Tinx app will need (default is all). Click Save.
- Head to the API credentials tab > click Install App > Install.
- Once the app is installed, a unique Admin API access token is generated. Save this to Notepad or something similar, as this can only be revealed once! This token will start with shpat.
- Finally, under the bottom section 'API key and secret key', copy the API key as well.
Tinx Sales Channel
Open Business Central, go to the Shopify Sales Channel.
Using the Basic Auth as Authorization Type, fill in the API key as the Username and the Admin API access token for the Password.
The Website field needs to be filled in with a URL. Note, this is not the default URL of Shopify backend, or the URL seen in Shopify under the store logo!
The URL should be something like this, where the highlighted area is your unique URL: https://123g45-67.myshopify.com.
In other words, the URL starts with https://, then your unique site, then .myshopify.com (not the first dot).
Once that is done, you can go to any of the message, e.g. the order message, and try to download data to check the connection. If you get a Processed response (seen in the Synchronisation Ledger Entries), you've succesfully connected both systems!
API documentation
Shopify delivers a REST Admin API for integrating software. 2 types of API are available:
- REST API https://help.shopify.com/en/api/reference
- GraphQL https://shopify.dev/docs/api/admin-graphql
The functional areas below are supported by the Tinx Connector:
- Customers
- Inventory
- Metafield
- Orders
- Products