Shopify integration for sellers: Connect to Marketplacer

Once API access is configured to the Shopify store data, you can set up the integration in the Marketplacer Seller Portal. This includes choosing which Shopify products are eligible for sync. By default, only products from your Shopify Online Store are synced, but you can optionally sync all active products across every sales channel. 

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.

Configure connection settings in 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. Choose what to sync tab displays.
   
6. Choose what to sync and when.
   • Product source: Choose which Shopify products are eligible for sync.
     • Online store (default): Syncs only products published to your Shopify Online Store sales channel. This is the existing behavior. Choose this if your Shopify catalog is primarily managed through the Online Store.
     • All active products: Syncs every active product in your Shopify catalog, regardless of which sales channel it's published to. Choose this if you sell through Point of Sale, B2B, custom apps, or other Shopify sales channels and want those products in Marketplacer. A product tag filter is required when using this option.

   • Include products with product tags: Enter one or more Shopify product tags, one per line. Only products carrying any of these tags will be synced. Tags are case-sensitive in Shopify and must match exactly. This filter is optional when Product source is set to Online store, and required when set to All active products.

     Note: If you have chosen to mark products and variants inactive, any existing products that no longer match your tag filter will be set to inactive in Marketplacer, with stock level set to 0 within 24 hours.
   • Exclude brands (Optional): Enter Shopify Vendor values, one per line. Products with a matching vendor will not be synced. Brand names are not case-sensitive.
   • Products from Shopify to Marketplacer
     • Sync products automatically: Product data is imported to Marketplacer automatically.
     • Sync products manually: You initiate imports via the Imports menu.
   • Images from Shopify to Marketplacer
     • Sync images: Images are synchronized from Shopify to Marketplacer.
     • Don't sync images: Use Marketplacer-specific imagery instead.
   • Invoices from Marketplacer to Shopify
     • Sync invoices: Invoices are synchronized to Shopify, where they appear as orders. The date field allows you to transition manual invoicing to Shopify from a specified date.
     • Don't sync invoices: Manage invoices manually, for example via a CSV export.

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 Client ID	Client ID
   Shopify Client secret	Client secret
   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.
    Tip: If you see a failure notification, double-check the credentials that you entered and try again.
11. Once the connection to the store is established, the app needs to be installed on the store. The next few steps will guide you through this:
    1. Click Connect.
       
    2. You will then be required to login to the Shopify store. A popup similar to below will appear.
       
    3. Click Install to continue and install the app to your store.
       Note: Shopify will list the permissions required. These are mandatory for all apps.
       
    4. You will be taken back to the setup in MConnect. Press Connect to continue.
12. The Setup access scopes tab displays:
    • Marketplacer verifies via an API call to Shopify that all required access scopes are granted. If any are missing, you’ll be notified before continuing. For reference on access scopes, see the list in the Configure Shopify, step 9. 
      Note: that all API scopes have to be granted to be able to complete the account setup. Once the scopes have been verified, select Continue.
      
13. Once the connection is successful, two buttons display:
    • Start Import: You can start the import manually later.
    • Review settings: You can review the settings later. Learn more.
14. 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. Which products are imported depends on your Product source setting: Online store imports products from the Shopify Online Store sales channel, while All active products imports every active product in your Shopify catalog that matches your tag filter. Settings that exclude products based on stock levels or brands also apply.

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.