Guide To Seller Shopify Store Integration

Please follow the instructions below to integrate your Shopify store with Crunchy Mama Box Marketplace. 

To make the product sync features work, create a custom app on your Shopify store.

Step 1: Log in to your Shopify store account and create a custom app from the “apps” section.

Step 2: Click on “create an app” and enter the name of the app.

After entering the name of the app, click on “Create app”.

Step 3: After creating the custom app, configure Admin APIs by clicking on “configure Admin API scopes”.

Next, provide the required permission for the custom app.

Mandatory Permission to create custom app as sales channel:

Here are the required permissions for the custom seller app:

Assigned fulfillment orders (Read and write)
# write_assigned_fulfillment_orders , read_assigned_fulfillment_orders

Fulfillment services (Read and write)
# read_fulfillments, write_fulfillments

Inventory (Read and write)
# read_inventory, write_inventory

Locations (Read Access)
# read_locations

Order Editing (Read and write)
# read_orders, write_orders
Allow this permission if you want to sync the order details with the seller store once edited on the merchant’s store, else don’t allow it.

Orders (Read and write)
# read_orders, write_orders

Products (Read and write)
# read_products, write_product

#write_product_listings, #read_product_listings

Storefront API access scopes:
#unauthenticated_read_product_listings

Note: These permissions are mandatory for Sales Channel Configuration.

After providing the required permission, click on save.

Storefront API access scopes:
#unauthenticated_read_product_listings

Note: These permissions are mandatory for Sales Channel Configuration.

 

Once, the permissions are saved, you will get an option to install the custom app.

Install the app by clicking on the “install app” button.

Step 4: After installing the app, you will get the access token, API key, and secret key.

Copy the access token, API key, and secret key and paste them into the “seller sync app configuration” on your Crunchy Mama Box dashboard.

Crunchy Mama Box Seller Dashboard

After saving the details, you can now start with importing the products.

Using this configuration Sellers can import their products by creating a unique sales channel especially for the Admin Store which is not available on their own online store.

The seller can create a custom app and provide certain permission which you find below that would convert the custom app into a Sales channel that they can select for their product. Please refer to the images below for a better understanding.

Sellers can add Products only for the Admin marketplace which will only be available on the Sales channel created by the Seller and connected via the seller panel.

Note: Once Seller enables this configuration they won’t be able to disable it.

To Add the product Please make sure the Product is added to the sales channel app that the Seller created as shown below otherwise it won’t be imported or synced.

Required Permission for Sales Channel Configuration

#write_product_listings, #read_product_listings

Import Products from Seller’s Shopify Store

Now, by clicking on the Import Products button, the seller can import products from his/her Shopify store to the admin’s Shopify store.

Seller will have three methods to import products:-

Method 1:- Choose a Date Range & import products.

2nd Method:- Import products by comma-separated product IDs.

Method 3:- Import products by product handle.

This way, sellers can import products to the admin’s store.

Thus, all the products imported by the seller will be visible in the “Product Listing” section of his/her seller panel.

Now, the admin can view a new menu added under the Configuration menu of the admin panel i.e. Seller Supported App Configuration.

ORDER CREATION ON SELLER’S STORE

Once an order is placed on the seller’s Shopify store, only product inventory will be managed on the admin end i.e. product quantity gets updated on the admin’s store.

In case any seller’s product (listed on the admin’s store) is not synced with the seller’s store then, both the admin and the seller can sync products manually from the Product Listing section of their respective panels.

Seller End

Third-Party App for Drop Shipping

In case any of your sellers are using a third-party app, Oberlo for drop shipping then, products synced from Oberlo to seller’s Shopify store can easily be synced with the admin’s store at his store’s primary location.

To import products from Oberlo to the seller app, the seller needs to enable the “Third-Party App for Drop Shipping” option from the Configuration menu. Moreover, once enable, import products to the seller app.

Get the list of all imported products in the Products section of the seller app (sync with the admin’s store).

This way, products will update on the admin’s marketplace.

Seller will select the Seller Sync App from the drop-down menu for currency conversion & price rule:

CURRENCY CONVERSION

If the currency of your seller’s store is different from the currency you set on your marketplace, then, the sellers can specify their currency rate with respect to your currency rate.

Accordingly, your seller’s product price calculates once a customer places an order

PRICE RULE

In the price rule menu, the seller can create a price rule to manage the price of the product on your Shopify store. The seller has to set the price rule:

• The seller has to enable or disable the price rule status to configure the settings.
• Select the price rule, either to increase or decrease.
• Select the Price change, either fixed or percentage.
  Enter the amount of how much the sellers want to increase or decrease the price.

Sellers can now map products with their connected Shopify stores. In case a seller wants to map a product with a specific product of his/her Shopify store then, the variant will be mapped automatically.

Now, the seller can map the products from the Product Listing>>Edit product>>Map Product button.

Clicking the Map Product button, the seller can choose whether to map the products manually or auto-map with any specific product with same SKU or Option Name.

On selecting the “Map Product Automatic” option:- The seller needs to choose a product from his/her Shopify store and then, choose the Map Type as “Map with SKUs” or “Map with Option Name”.

On selecting “Map Product Manually” option:-

Once you choose this option, the seller simply needs to select his/her Shopify store product with which you need to map the seller’s marketplace product.click the Submit button.

In case the order created in the app, not synced with the seller’s Shopify store then, the seller can manually create an order on his/her Shopify store.

For this, the seller will visit the seller panel>>Order>>Edit Order>>Click the “Sync Order” button in the More Action menu.

 

SELLER PANEL

The seller can enable the option from the Seller Sync App Configuration menu:

With this option, you can now verify the “Continue Selling Out of Stock” option on Shopify and allow customers to purchase the items accordingly.

 

That’s all about the this feature app.