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




1.     Log into your Shopify store, go to “Apps” & click the link for “Manage private apps”




2. Click “Create a new private app” and enter the following details:


•    Private App Name: “Selazar”


•    Emergency Developer Email: technical.support@selazar.com


Please ensure Selazar is given the correct application permissions (only those that need changes are mentioned):


(a)    Fulfillment services – Read and Write 


(b)    Inventory – Read and Write 


(c)    Locations – Read access 


(d)    Orders, transactions and fulfilments – Read and Write 


(e)    Product, variants and collections – Read and Write



Webhook API version: a. 2021-01


Leave “Storefront API” unchecked as Selazar does not require this functionality, and click "Save"


•  After saving the private app, make note of the API Key, Password and URL for your Shopify store 

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



3.    Connect Selazar to Shopify


Log into your Retailer account on the Selazar platform, click “Integrations” then “Set up integration”.  


Then select "Shopify", and hit "Next".





•  Enter the following details (you’ll find these under the Selazar Private App in Shopify):


            (a)    Store URL – your Shopify store url (eg: https://mystore.myshopify.com


            (b)    Username – API Key noted above 


            (c)    Password – Password noted above


•  Choose whether you would like to connect now. If you choose No, 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 be changed at a later time as well.


•  Click “Validate Credentials”


•  A prompt will appear confirming successful or unsuccessful integration


Common issues include:


        (a)    Incorrect store url - Check the url and try again


        (b)    Incorrect username/password - Check credentials in the Selazar private app in Shopify and try again 


        (c)    Store is already integrated with Selazar - Contact Selazar if this is suspected


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


4.   Flag Existing Products as fulfilled by Selazar


•  Navigate to your Shopify admin portal


•  Navigate to your list of Products


•  For each product (and variant) to be processed by Selazar, click on the product name


•  If the product has variants:


            (a)    Scroll to the list of variants


            (b)    Click “Edit” for the Product Variant to mark for Selazar fulfilment 




(c)    Scroll down to “Inventory” and update the “Inventory managed by” dropdown to “Selazar” 


(d)    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. 


    Please note that inventory levels will only be used when you have this option turned on in the Selazar Portal.



•  If the product does not have variants:


(a)    Scroll down to “Inventory” and update the “Inventory managed by” dropdown to “Selazar” 


(b)    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.


•    Please note that inventory levels will only be used when you have this option turned on in the Selazar Portal.




Please note: All products that are expected to be fulfilled by Selazar MUST exist in the Selazar Platform with the matching SKU. otherwise, they will be treated as out of stock. 


5.    Flag New Products as fulfilled by Selazar


•  Navigate to your Shopify admin portal


•  Navigate to your list of Products


•  Click “Add Product”



•  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.


•    Please note that inventory levels will only be used when you have this option turned on in the Selazar Portal.




Please note: All products (and variants) that are expected to be fulfilled by Selazar MUST exist in the Selazar Platform with the matching SKU. Otherwise, they will be treated as out of stock. 


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


6.    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


•  Select the “More” button towards the bottom right


•  Underneath the “More” button, you will find the following option: “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” whereon there are multiple options


•  Click on the “Fulfil items” button to the right-hand side of the screen



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


COMMON ISSUES

 

If you received an email stating orders failed to sync:


    (a)    These emails provide information about WHY order syncing failed. If you feel the email has been issued in error, please contact us at technical.support@selazar.com 


    (b)    Reasons these emails can be issued:


         (I)    No customer information in the order 


        (ii)    No delivery address in the order 


        (iii)    The SKU does not exist on Selazar 


        (iv)    The item with the specified SKU is out of stock


Orders are not syncing, yet no email is received 


    (a)    Common causes


         (i)    The order contains items that are not fulfilled by Selazar 


        (ii)    The order contains items that were updated to be fulfilled by Selazar after the order was submitted 


        (iii)   There is already an order for your Selazar Retailer account with the matching Shopify order number



Shopify updates are detailed on their website via the Shopify Changelog.  



Hopefully, you were successful in your integration. If you were, congratulations! Should you need more assistance feel free to reach out to us at technical.support@selazar.com


Happy selling!


















Please note, 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.