Contents
Shopify is an e-commerce platform that allows users to set up an online store and sell their products. It helps you manage your orders - from inventory to the point of sale to shipping and returns.
Shopify documentation: API Guide, Authentication
Additional reference: Supported Shopify APIs
Auth type (required): Select OAuth 2.0 as the authentication type for this connection. The form changes depending on the selected authentication type. The OAuth 2.0 authentication type requires configuring the connection from the Shopify app store.
- If you are installing the integration app for the first time you MUST ONLY choose the option Use existing connection.
- If you want to create a new connection on the integration app that is already installed, choose Set up new connection.
- Make sure that the Shopify store you have logged in to and the connection you want to create
with the Shopify store is the same. If you have logged in to a different store
and tried creating a connection, the app will automatically create a connection
in the logged-in store. - Be informed that only the integrator.io account owners can configure the Shopify connection, provided the user has all the permissions from Shopify.
Set up an OAuth 2.0 connection
To configure the connection:
-
Click Continue at the Shopify App Store.
-
If you are not logged in to the Shopify app, you will be navigated to the page shown in the screenshot below. Click Login or Add app to log in to Shopify.
-
The login page appears as shown in the following screenshot. Sign in to your Shopify account.
-
Select the required store and you will be navigated to the Celigo - Shopify app.
- The NetSuite SmartConnector name appears on the Shopify listing page.
- Click Add app. The Celigo - Shopify connect page appears.
-
Click Install app. The Celigo sign in page appears if the user is not signed in.
-
Provide the credentials and click Sign in. The Set up connection page appears.
IMPORTANT:
- If you are installing the integration app for the first time you MUST ONLY choose the option Use existing connection.
- Make sure that the Shopify store you have logged in to and the connection you want to create with the Shopify store is the same. If you have logged in to a different store
and tried creating a connection, the app will automatically create a connection
in the logged-in store. - Be informed that only the integrator.io account owners can configure the Shopify connection, provided the user has all the permissions from Shopify.
- Select Use existing connection.
- From the IO integration name dropdown, select Shopify - NetSuite.
-
From the Connection dropdown, select Shopify Connection - Offline | yourstorename.
Important: When the integration app is installed, by default a Shopify connection is created in the backend, and you have to authorize by logging in to the correct store.
- Click Save & authorize. The Install integration: Shopify - NetSuite page appears.
- Click Configure. The Set up connection page appears.
-
Click Save & authorize.
-
[Optional]: Click Update app, if the process instructs you to do so. Once you update the app, if the Shopify connection is not configured successfully, go to the Set up connection page, and click Save & authorize.
- The Shopify Connection status appears as Configured and the new connection is now successfully added to your account.
If you want to create a new connection on the integration app that is already installed, see Set up new connection.
FAQs
Q1: Why am I getting the following errors while setting up OAuth 2.0 connection to Shopify?
-
Error message: {“errors”:[{“code”:“missing_header”,“message”:“An account is shared with you. Please send the Integrator-AShareId in the request header.“}]}
- Resolution: You are not signed in as an integrator.io account owner. Be informed that only the integrator.io account owners can configure the Shopify connection, provided you have all the permissions from Shopify.
-
Error message: Oauth error invalid_request: This app is requesting to be installed and your account doesn't have permission to grant the requested access. You can fix this issue by reinstalling the app as the account owner.
- Resolution: You don't have the right set of permissions in Shopify. Make sure that you either have owner access in Shopify or access to all the permissions needed by the app.
Q2: In what instance should I select the option Set up new connection?
A: You must use this option only when you want to create a new connection on the integration app that is already installed.
Q3: Why do I still see the following screen even after configuring the setup correctly?
A: There is a high chance that you might have selected the option Set up new connection instead of the option Use existing connection. Go to the Use existing connection section and follow the instructions explained.
Comments
13 comments
I've messed this up a few times and the instructions need to be a little clearer when installing a new connection.
Can you make it clear at the top of the help that if you are installing the integration app for the first time you MUST only choose the Use existing connection. It seems optional and if I've never connected this store it makes no sense to chose Use Existing. Put that in bold.
Also - Step 3 below is unintuitive. You have to choose and existing connection to create a new one? Confusin. Can you name that connection in step 3 differently? replace yourstorename with selecttomakenewconnection or something.
Thanks, David Gollom. We have considered your first suggestion and updated the help doc. Regarding the second suggestion, we are in discussions with the product team, we will get back to you once we make the decision. Thanks for the valuable feedback!
Thank for taking my suggestion. I think that'll help others who may have previously worked in IO and are used to how things usually function.
The wizard steps for the IA to set up the shopify connection seems to be buggy, confusing UX, and can leave you blocked, in a loop that goes nowhere. However, It is possible to complete this successfully, I don’t have exact steps, even though i have done it 3 times. (Chrome on mac)
The problem is between steps 6 and 7, and there is a step in between where it asks you for a new or existing connection.
Create a new OAuth 2.0 connection first. Then use that connection as an existing connection. Neither of these steps work. Then try again but select the connection that has a generic name like shopifystore or Shopify Connection or something that does not bear relation to the connections you set up previously. For some reason it then pulled in the credentials from the real connections i created, and shows a new screen in step 7 of the Celigo document link above. If this does not work, keep trying different things, especially if the options seem to make no sense, this was how i resolved it the first time.
Can i please suggest to Celigo that you look closely at this painful bug.
Jolyon Blazey thanks for sharing the feedback. We apologize for the confusion caused, we are in discussion with our product managers to enhance the documentation. We would like to mention that in the Important Notes at the top, it says to choose an existing connection when installing the integration app for the first time.
We understand that having the Set up new connection information in this article is creating confusion, we will remove this information from this article and create another article. Also, we will work on other improvements to simplify this article.
Thanks again!
Thanks so much for clarifying these steps, i will add links in our documentation.
The 'view instructions' link when setting up a new Shopify - NetSuite Tile sends you to a different page. Clicking the link from the quick config takes you to: https://docs.celigo.com/hc/en-us/articles/360038755451 instead of this page.
The page it links out to does not make it clear when 'existing connection' vs 'new connection' should be used like this page clarifies. We have had at least two cases of clients getting confused by this and hitting errors. Can the link be updated to hit this page instead?
Mina Banoub Firstly, thanks for sharing this suggestion with us. We want to inform you that for other users who are not using the integration app and would wish to connect to Shopify, changing the link will direct those users to the integration app document and this might confuse them so we have added a note at the top of this Set up an OAuth 2.0 connection to Shopify document for the integration app users. The note has the doc link that is specific to the integration app. Please see the image below. Let us know if this is fine.
Thanks for posting!
Saikumar Rachamalla, thank you for the quick reply on this one. I think that is a great update to the other documentation that will help to clear up the discrepancy.
Ideally, there would be a separate view instructions link in the UI (one for stating for IA and one for standard connection) to ensure the right document is selected directly from the setup. However, this is a step to help make that difference clear as well.
Best, Mina
Mina Banoub
Sure, I will work with our product managers to get this done. Thanks!
Saikumar Rachamalla
When we are trying to establish a NEW (OR existing as well) Shopify Connection for the IA, will the store name in the locked fields always be yourstorename?
Do we ever have to supply the actual store name while setting up Shopify Connection for IA.
Additionally, does it strictly have to be Celigo Account Owner who should be creating this Connection in Celigo (and logged into Shopify)?
Sujit Desai please see our responses below
Q1: When we are trying to establish a NEW (OR existing as well) Shopify Connection for the IA, will the store name in the locked fields always be yourstorename?
A: Yes, it will always be yourstorename until you successfully create a connection The store name will get updated depending on the store to which the Shopify connection is created after the successful creation of the connection.
Q2: Do we ever have to supply the actual store name while setting up Shopify Connection for IA.
A: No, as the store name is picked depending on the store the user logs into at the time of connection creation.
Q3: Additionally, does it strictly have to be Celigo Account Owner who should be creating this Connection in Celigo (and logged into Shopify)?
A: Yes.
Let us know if this helps.
Thanks and happy posting!
Thanks for all the updates on this page. I just installed a new client today and I got it right on the first try!!
Please sign in to leave a comment.