Shopify integration for Sellers: Connect and set up

There are two Shopify integration types. This article is for sellers who use Shopify to send product information to Marketplacer, as opposed to Marketplacer users who have Shopify as their e-commerce management tool. 

There are three steps in this process. They do not need to be completed at the same time, but they do form a complete sequence. Once they are completed, follow the two steps detailed below.

Configure, connect, and import

Configure Shopify

Shopify integration for sellers uses Shopify's APIs to access the Shopify store's data. To configure this connection in Shopify, create a custom app through the Shopify Admin dashboard.

The following instructions focus on the steps needed for the integration to work with Marketplacer. We endeavor to keep these instructions consistent with Shopify releases. 

Detailed instructions for adding a custom app are available in the Shopify help center. 

1. In the Shopify Admin Dashboard, select Settings in the left-hand menu. Store details displays.
2. Select Apps and sales channels in the left-hand menu. Apps and sales channels displays.
3. Select Develop apps. App development displays.
4. Select Create an app. If this is your first custom app, a dialog displays prompting you to select Allow custom app development. The Create an app dialog displays.
5. Enter the App name and the App developer. We recommend that you use the store owner as the App developer.
6. Select Create app. App development displays the application name.
7. Select Configure Admin API scopes.
8. To enable the Shopify integration, select the following scopes from the Admin API access scopes page (listed in alphabetical order):
   

   Category	Scopes to Select
   Inventory	write_inventory, read_inventory
   Orders	write_orders, read_orders
   Product Listings	read_product_listings
   Products	read_products
   Locations	read_locations

   💡 Tip: After selecting the scopes, you can filter the view to show only what is selected by clicking Selected at the top.
9. Select Save. App development displays, with the Install app button enabled.
10. Select Install app. A confirmation dialog displays.
11. Select Install. The API Credentials display.
    
12. Select Reveal token once.
    
    Note: You can only view this token in full once. Be sure to make a note of it and protect it like you would a password. Once you have revealed the Admin API access token in full, you will only be able to see the last four digits.
13. Record the API access tokens required by Marketplacer:
    • Admin API Access Token 
    • API Secret Key
    • Store URL: The Shopify Store URL is the URL on the back-end of your Shopify Store. Ensure that you use the Shopify Store Domain (e.g marketplacer.myshopify.com) rather than your public domain (e.g www.marketplacer.com).

This sets up the Shopify side of the integration. You can now set up the Marketplacer side.

Connect to Marketplacer

Once API access is configured to the Shopify store data, you can set up the integration in the Marketplacer seller portal. 

If you start with manual product synchronization, you can enable automatic synchronization later. This lets you ensure the import is working correctly, and refine the integration settings, before making the process automatic.

If you intend to use the same product images in Marketplacer as you do in Shopify, choose Sync images. If you intend to use Marketplacer specific product imaging, choose Don’t sync images.

Invoices can be managed manually, for example via a CSV export. In this case, choose Don’t sync invoices.

If you need to migrate from a manual invoicing system to using the integration, and you have existing manual invoices, choose the Sync invoices option, and use the date field to specify the date to start synchronizing invoices automatically. 

To start with automatic invoicing in Shopify, choose Sync invoices, and do not specify a date.

To connect to Marketplacer

1. Sign in to the seller portal.
2. Go to Extensions > MConnect.
3. Select Go to MConnect. to start the setup wizard. The Select your integration platform tab displays.
4. Select Shopify.
5. Select Set my account type.
   The Choose what to sync tab displays.
   
6. Choose what to sync and when.
   • Products from Shopify to Marketplacer
     • Sync automatically: The import of Product data to Marketplacer will occur automatically.
     • Sync manually: You will need to initiate imports via the Import menu.
   • Images from Shopify to Marketplacer.
     • Sync images: Images are synchronized from Shopify to Marketplacer.
     • Don’t sync images
   • Invoices from Marketplacer to Shopify
     • Sync invoices: Invoices will be synchronized to Shopify, where they will appear as orders.
       The date field allows for the transition of manual invoicing to Shopify on the specified date.
     • Don’t sync invoices
7. Select Continue. The Configure currency conversion tab displays.

   If you need to use currency conversion, set it up now before the initial import. It is possible to set it up subsequently, but it requires a full import to update all product pricing.

   • To set up currency conversion, select the currency to convert from, then select Enable currency conversion.
   • Otherwise select Don’t use currency conversion.
8. The Connect your Shopify account tab displays.
9. Enter the API Secret Key, access token and URL from Shopify.

   Marketplacer Integration Manager	Shopify Admin Dashboard
   Shopify API Secret Key	API Secret Key
   Shopify Admin API Access Token	Admin API access token
   Shopify Store URL	The original Shopify URL assigned to your store when it was created. Found in Shopify Settings > Domains, it includes random letters or numbers (for example, https://xyzp0g-nb.myshopify.com) rather than your custom domain (for example, https://www.marketplacer.com). Ensure you include https://.

   Note: The integration now uses the Shopify API Secret Key instead of the API Key. This change supports the use of Shopify's GraphQL API and enables webhook subscriptions for near real-time updates. New sellers will only see the API Secret Key field. For existing sellers, the API Key field has been removed, and the API Secret Key field will appear blank until filled.
10. Select Submit.
    • If you see a failure notification, double-check the credentials that you entered and try again.
11. The Setup access scopes tab displays:
    • In this step Marketplacer verifies via an API call to Shopify that all required API scopes are granted (see table in Configure Shopify section - Step 8) and you will be informed if any scopes are missing. Please note that all API scopes have to be granted to be able to complete the account setup. Once they have been set up and verified, select Continue.
12. Once the connection is successful, two buttons display:
    • Start Import: You can start the import manually later. Learn more.
    • Review settings: You can review the settings later. Learn more.
13. Select Start Import to start the initial product import from Shopify. 

Initial product import

The initial import fetches the product (advert) details from the Shopify store and loads them into Marketplacer. All products (adverts) in the Shopify Online Store sales channel are imported, unless changes have been made to the settings which exclude products based on stock levels or brands.

If you did not select the import option in the previous step, you can start it manually. Learn more.

You can view the outcome of the import in the Imports menu in the Seller portal. Issues, if any, with the data you imported will be listed there. Correct the errors in Shopify wherever possible, and re-import the data.

Once you have run the initial import, you will see product (advert) details on the Items page.

Next steps

1. Review and publish products (adverts).
2. Review the settings.