/How to connect your Imonggo account to Shopify
How to connect your Imonggo account to Shopify 2019-06-21T02:03:02+00:00

How to connect Imonggo to Shopify

Imonggo’s new integration with Shopify lets you sync your inventory between your point-of-sale and your e-commerce website.

With this new Imonggo feature, you can decide what products in Imonggo are available for sale in your Shopify store. You may also send the sales you made on Shopify to your Imonggo account so you have a holistic view of your sales totals across the two services.

Here’s how to set it up:

Activating the e-commerce integration feature

1. First, go to the E-Commerce Integration page in your Imonggo account’s Settings. Don’t know how to get to Settings? Just click the gear icon on the upper right.

2. Add a checkmark beside Sync your order payments and products with Imonggo and click the Save button.

A001 - Imonggo E-Commerce Integration

As you can see above, there are five fields you need to fill up. Click the tabs below to learn how to get these information. Please accomplish the tabs in order.

This one is the easiest to fulfill. To get the Shopify Store Name, just go to your Shopify account and copy the name of your store as it appears in the browser’s address bar. For example, our test store’s name is faster tech, but it appears as faster-tech on our browser’s address bar.

Address Bar of Shopify

Just copy how it appears on the URL (do not include myshopify.com or the rest of the URL) and paste it onto the Shopify Store Name field in Imonggo.

D001 - Blank field Shopify Store Name b

Go to the next tab to get the Shopify Account API Key.

Follow the steps below to get the Shopify Account API Key.

1. Go to the Apps page on your Shopify account.

001 - Click Apps section

2. Click the Manage private apps link near the bottom of the Apps page.

002 - Click Manage private apps

3. In the next page, click the Create a new private app button.

003 - Create a new private app

4. The next page has three sections. The first section is App details. Enter the following:

Private app name: Imonggo

Emergency developer email: support@imonggo.com

004 - App details

5. Then click the Save button on top-right save the initial settings.

save-shopify-app-imonggo

6. Confirm by clicking the I Understand button.

i-understand-create-the-app-shopify-imonggo

7. Then scroll down to the second section, Admin API. It is a bit complicated, so please tread carefully. You have to copy the API key and the Password and paste them into the E-commerce Integration page in your Imonggo account.

a. Copy the API key in Shopify…

B0001- API Key a

b. … and paste it in the Shopify Account API Key field on the Imonggo E-Commerce Integration page.

A001 - Imonggo E-Commerce API Key 1

Go to the next tab to get the Shopify Account API Password.

Please accomplish the last tab first before proceeding with this one.

c. Copy the Password in Shopify…

B0001- API Password

d. … and paste it in the Shopify Account API Password field in Imonggo.

A001 - Imonggo E-Commerce API Password

e. Then click the Save button in Imonggo.

8. Go back to Shopify and scroll down to the Admin API Permissions part of the Admin API section.

C0001 - Admin API Permissions

Copy the Permission types above. In summary:

  • Store content like articles, blogs, comments, pages, and redirects should be on Read access
  • Customer details and customer groups should be on Read and write
  • Orders, transactions and fulfillments should be on Read access
  • Products, variants and collections should be on Read and write

9. Then scroll to the last section of this page, called Storefront API. Leave it unchecked. Then click the Save button at the bottom right.

C0001 - Save Shopify Private App

Go to the next tab to get the Shopify Webhook Token.

The Shopify Webhook Token can be found in Shopify.

  1. First, go to Shopify’s Settings (the button is on the lower-left corner) and click Notifications.

Shopify Settings Notifications

2. First, build your Callback URL. How to do that? Inspect the link below:

[imonggo_account_URL]/api/ecommerce_webhooks/shopify?api_token=[imonggo_account_api_token]

3.  Replace [imonggo_account_URL] with the domain address of your Imonggo account. You should find it in the address bar of your browser, when you’re logged in to your Imonggo account:

Imonggo URL on Address

The [imonggo_account_URL] in this case, is https://baobao.c3.imonggo.com

4. Now, the [imonggo_account_api_token] can be taken in the Home page of your Imonggo account. How can you go to Home? While logged in to your Imonggo account, click the Imonggo logo on the upper right of the screen.

How to go to Home

5. Then once you are in Home, click My Info on the upper right.

Click My Info

6. This should open the Your Information window. Near the bottom of that is the API Token. Highlight it and copy.

Imonggo API Token

In this case, the [imonggo_account_api_token] is 8760e7bebb493438e18b36160892913514ca

7. Thus, we can update the Callback URL above to:

https://baobao.c3.imonggo.com/api/ecommerce_webhooks/shopify?api_token=8760e7bebb493438e18b36160892913514ca

Now that you have your Callback URL, you may now go back to Shopify to create two Webhooks.

8. Go back to the Webhooks section of the Notifications page of Shopify’s Settings. Click the Create webhook button.

W001 - Create webhooks

9. Create the first webhook, which would be for your invoices. Under Event, please choose Order payment. Leave the format as JSON.

S002- Order payment

10. Under URL, paste the Callback URL that you created earlier. Then click the Save Webhook button.

S002 - Paste Callback URL

11. After saving the first webhook, click the Create webhook button again to create the last required webhook.

W001 - Create webhooks 2

12. At the webhook creation dialog, choose Product creation under Event. This should allow you to send your products from Imonggo to Shopify. Leave the Format as JSON again.

S003 - Product creation

13. Then paste the Callback URL again in the URL field. Click Save webhook to save it.

S003 - Paste Callback URL

14. That should do it! Now you have the proper webhooks for you Imonggo account.

Webhooks are saved

15. Then scroll to the bottom to find Webhooks section. Highlight the Token and copy it.

Shopify Webhooks Token

16. Then paste the Token onto the Shopify Webhook Token in Imonggo.

Filled Shopify Token in Imonggo

Now you can move to the last tab, which will allow you to get the Shipping Fee Stock No.

Getting the Shipping Fee Stock No should be easy.

  1. First, create a product in Imonggo that will stand as the Shipping item.

Shipping Product

You may assign the cost and price to be zero, because you may change it on the fly in Shopify. What’s important here is the product’s stock number.

2. Copy the stock number of your Shipping product and paste it onto the Shipping Fee Stock No field in the E-Commerce Integration page in Imonggo’s Settings.

Paste onto Shipping Fee Stock No

3. Then click the Save button to finalize the integration between your Imonggo account and Shopify.

That’s it! You may now use Shopify with Imonggo.

Done with the integration settings above? You should then already be able sell your Imonggo products online through Shopify. Now sure how to start? Click this link to learn more: How to use Imonggo with Shopify