Guides
Start typing to search…

Connecting a Shopify store to the Marketplace via Fuse

Credentials Required from Platform

Here is the information needed to provide to the UC Support / Project team so that the store may be connected to the Marketplace.

  • Client ID
  • Secret Key
  • Shopify URL

Shopify Products Inbound

Shopify Products Inbound standard connector is a generic connector used to fetch product data from the Shopify API, here below are listed things needed to connect to that API.

To grant Fuse access to a Shopify store, you will need to create a private Shopify App and generate a key. This will then need to be provided to your Ultra Commerce Support or Project Manager.

Create a private Shopify App

  1. Navigate to the Shopify App creation page: https://dev.shopify.com/dashboard/

  2. Select Create app from the top right of the page.

  3. From Start from Dev Dashboard, add the App Name and select Create.

  4. Populate your app details (specific details are listed below, other options if not mentioned can be left as is).

    URLs

    Webhooks API Version

    • Ensure you have the latest API version selected. This will typically be selected by default, however it may be a good idea to verify just in case.

    Access

    • Scopes: Click on Select scopes on the right of scopes to select scopes.

      A pop up will appear where you can select the following APIs.

      In cases where only fetching products is needed, the following permissions are required:

      • Products: read_products
      • Inventory: read_inventory
      • Locations: read_locations

      In cases where orders are need to be sent to Shopify, that requires order write access:

      • Order editing: write_order_edits and read_order_edits
      • Orders: write_orders and read_orders

      Select Done when all required APIs are selected.

      The Scopes will then appear with your selected APIs


  5. Scroll to the bottom and select Release to save a version of the app.

    A pop up will appear allowing you to name and add a description to your version (optional). Select Release at the bottom of the pop up.

    Your version will be saved and you will be taken to the Versions page.

  6. You will now need to install the app to your Shopify store. Navigate to the Shopify Dev Dashboard from the top left of the page.


  7. This will take you to the home page. Select your newly created app.

  8. Find the Install section, and select Install app.

  9. This will take you to the Shopify Store admin, and directly to allow you to install the app. Select Install from the bottom right.

Obtaining details

You can obtain the details from the Dev Dashboard(https://dev.shopify.com/dashboard/) under App > Settings:

The UC team needs the following to set this up:

  • Client ID (previously API Key)
  • Secret Key (Admin API Access Token)
  • Shopify URL (The Shopify Domain URL can be obtained from the Shopify store settings under Domain. You can navigate to Preview domain if the domain is a Shopify domain, where you can then copy the URL.)

Once the 3 items are provided, the UC team will then advise you once your Shopify store is connected to the Marketplace.

Orders synced to Shopify

Order View

Orders from the Marketplace will appear as usual. They will include:

  1. Product Information as part of the order
  2. Shipping Details
  3. Customer Information
  4. Additional Notes from the Marketplace.

In the Notes section, they will see Order ID, and Customer Phone Numbers. The Order ID here will be different from the Order ID that is used in their Shopify, as this references the Order ID from the Marketplace.

👍

NOTE

The SKU for their products will be reverted back to their original form (rather than the Marketplace SKU which includes the Vendor prefix). This is to ensure there are no confusions about the product.

Fulfilling Orders

With the fulfilment sync, shipping items from Shopify will be the same as the standard out the box implementation.

When you have fulfilled the order, the shipment will be synced with the Marketplace and mark the items as shipped in the order, as well as trigger an email to the customer (the Shipment Tracking will also be sent to the customer as part of the email).

What happens next?

Ultra Commerce will connect your store via our integrator application and Fuse, and begin to sync products to the Marketplace. The UC team will then advise when this has been connected, and you can map the data when ready.

Updated about 1 month ago