How to integrate Shopify with the Selazar Fulfilment App v1.0

 

If you are a new customer, integrating for the first time we advise you to connect using the version 2 integration steps, this is most up to date integration available. 

If you are unsure on what connection is best for you please contact customer.service@selazar.com for guidance.

Integrating Selazar into your Shopify store will allow for a seamless fulfilment experience.


On this page

How to integrate Shopify with Selazar

Create Selazar custom app on Shopify

Connect Selazar to Shopify

Common issues


How to integrate Shopify with Selazar



Congrats! You're ready to connect your Shopify store to Selazar. Use the following steps to get integrated. Let's get started!

Create Custom App on Shopify

Log into your Shopify store, go to Apps > App and sales channel settings > Develop Apps, Allow custom app development, then Allow custom app development again.


Click Create an App and enter the following details:

•    App Name: Selazar

•    Emergency Developer Email: You can choose from the drop-down, any email can be used here.

create-an-app


Go to Configuration > Admin API Integration > Configure to ensure Selazar is given the required application permissions (points a to j below):

config-admin-api
(a)    Orders – Read and Write 

(b)    Customers - Read and Write

(c)    Fulfilment services - Read and Write

(d)    Inventory – Read and Write 

(e)    Locations – Read

(f)     Products – Read and Write 

(g)    Shipping - Read and Write

(h)    Store content - Read

(i)     Third-party fulfilment orders - Read and Write

(j)     Merchant-managed fulfilment orders - Read and Write

Webhook API version: 2023-01

Save the changes you have made

config-saved

Each admin API access scope must be chosen to create a successful integration.


Under API Credentials navigate to Access Tokens > Install app > Install

access-tokens

After installing the app, record the Access Token and URL for your Shopify store as you can only view this once.

            (e.g. https://mystore.myshopify.com)

admin-api-access-token

Connect Selazar to Shopify

Log into your Retailer account on the Selazar platform, click Integrations > Shopify > Next.
Selazar_Integrations

•  Enter the following details (you’ll find these under the Selazar App in Shopify):
            (a)  Store URL
– your Shopify store URL (e.g: https://mystore.myshopify.com ) 
            (b)  Username – Please enter in your own email address
            (c)  Password – Password will be your access token you saved previously

  • Choose whether you would like to connect now. If 'no' is selected, then the integration details will be saved, but the store will not be connected. You can connect at a later time.
  • Choose whether you want the Shopify store to use inventory levels from Selazar. This can also be changed at a later time.
  • Click Validate Credentials
    A prompt will appear confirming whether the integration has been successful or unsuccessful

Once Selazar is integrated you will need to specify in your Shopify store which products (and variants) are to be fulfilled by Selazar



Flag Existing Products as fulfilled by Selazar



  • Navigate to Shopify admin > Products
  • For each product (and variant) to be processed by Selazar, click on the product name
  • If the product has variants:
    • Scroll to the list of variants
      Click Edit for the Product Variant to mark for Selazar fulfilment
  • If the product does not have variants:
    • Scroll down to Inventory and update the Inventory managed by dropdown to Selazar
    • If you would like Selazar inventory levels of this product used, then click Track Quantity. You should notice that you will not be able to edit the quantity.
  • Scroll down to Inventory and update the Inventory managed by dropdown to Selazar
  • If you would like Selazar inventory levels of this variant used, then click Track Quantity. You should notice that you will not be able to edit the quantity.

Inventory levels will only be used when you have this option turned on in the Selazar Portal.


All products that are expected to be fulfilled by Selazar must exist in the Selazar Platform with the matching SKU (case sensitive, 'SkuCode' is not the same as 'SKUCode'). Otherwise, they will be treated as out of stock. 

Duplicated SKUs are not support by Selazar.


Flag New Products as fulfilled by Selazar

•  Navigate to Shopify admin portal > Products > Add your productsadd-product-shopify

•  Complete all information as normal
•  Scroll down to Inventory and update the Inventory managed by dropdown to Selazar
•  If you would like Selazar inventory levels of this variant used, then click “Track Quantity”. You         will notice that you will not be able to edit the quantity.

Inventory levels will only be used when you have this option turned on in the Selazar Portal.

 

All products that are expected to be fulfilled by Selazar must exist in the Selazar Platform with the matching SKU (case sensitive, 'SkuCode' is not the same as 'SKUCode'). Otherwise, they will be treated as out of stock. 


Flag Historic Orders as fulfilled by Selazar

If for any reason you need to fulfil an order yourself, but it has already been entered into the Selazar platform, you can manually update the order status to ensure that a duplicate is not dispatched.

•  Navigate to Orders list on Shopify
•  Select the order you wish to fulfil > more > Mark as fulfilled

•  A popup will confirm that your order has now been marked as fulfilled
•  You will be led to another page titled Fulfilment where there are multiple options
•  Click on Fulfil items

•  Once completed, you will see a message reading, “Line items have been fulfilled.” 


Congratulations! You should now be set up and your orders should sync straight to Selazar with tracking information coming automatically back to Shopify. 

See our FAQ's which contains answers to our most common integration questions


Selazar is not responsible for any issues caused by or for the rectification of any issues arising as a result of user-installed updates to the Shopify platform and does not provide/is not associated with any information provided on the Shopify changelog.