Build a shopping cart app
- Yashika Saini (Unlicensed)
This guide will outline step by step process how you can build a shopping cart app on the Eshopbox platform.
Before you start
This guide assumes that you are familiar with the following steps:
Create an app in the Partner Dashboard. Select the intended audience to be Public while creating an app.
You should authenticate your app using OAuth. Make sure you included following scopes while requesting authorization code:
read:products
write:products
read:product_listings
write:product_listings
read:inventory
read:orders
write:orders
read:returns
write:returns
Step by step guide
Step 1: Set Up
Enable a sales channel in your workspace.
Your app will need the auto-generated sales channel code while creating orders, returns, etc.
Step 2: Triggers
Triggers are events that start (trigger) workflows. These events can be internal events in Eshopbox or your App. You cannot manually start a workflow. Triggers let Apps Script run a function automatically when a certain event occurs.
You are required to create the following triggers in your app.
New Order
Create a New Order trigger, that starts(triggers) the workflow whenever an order is created on your app.
It is a mandatory trigger.
Product Update
Create a Product Update trigger, that starts(triggers) the workflow whenever a product is created or updated in your app.
It is a recommended trigger.
Order Cancelled By Customer
Create an Order Canceled by The Customer trigger, that starts(triggers) the workflow whenever a customer cancels an order in your app.
It is a recommended trigger.
New Return
Create a New Return trigger, that starts(triggers) the workflow whenever a new return is created in your app.
It is a recommended trigger.
Step 3: Actions
An action is an event an Automation workflow performs after it is triggered, actions add or update data to the app.
You are required to create the following actions in your app.
Updated Inventory Count
Create an Updated Inventory Count action that updates the inventory in your app.
It is a recommended action.
Update Order Status
Create an Updated Order Status action that updates the order status in your app.
It is a recommended action.
Update Return Status
Create an Updated Return status action that updates the return status in your app.
It is a recommended action.
Create Manifest
Create a Verify Manifest action in your app that verifies shipments.
It is an optional action.
Step 4: Automation Templates
Automation Template is a pre-configured integration between two apps. They are the fastest way to automate workflow. You are required to create the following automation templates.
Syncing products to Eshopbox
Add a Trigger.
Select your app.
Your app action list will be loaded, choose the Product Update trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Click Continue.
Add a Search Action
The action app will be pre-selected based on your selection of the trigger app, here the trigger app is your app, so the action app will be the Eshopbox app. Based on this, actions from the Eshopbox app will be loaded.
Choose the Find Product action.
Fill in the Name of the Product(SKU) for which event was triggered in the form fields, and click Continue to save them.
Add branching logic to the template with paths
Add a path
Select Paths.
Two paths, A and B, will automatically be created in a single path group (a group of paths on the same level).
Select Path A. This is your first path.
In the Name field, name your first path Create Product.
Click Continue.
Set Path Rules
Field: in the first dropdown menu, select Find Product SKU field.
Rule: in the second dropdown menu, select Does not exist filter.
Test Your Path Rules
In the Filter Setup & Testing section, Eshopbox will test your path rules based on your sample data. A message will inform you if your Zap would or would not have continued down this path based on the sample data.
Click Continue.
Add Path B
Select Path B and name it as Update Product.
Follow the above steps and in the rule dropdown select exist filter.
Add Sub Paths
Select Create Product
Add 3 paths, name Create Base Product, Create Virtual Combo, Create Kit respectively.
Set Path rules, in the field dropdown select Product Update type field, in the rule dropdown select exactly matches filter, in the value menu, enter BASE, VIRTUAL_COMBO, KIT respectively for the three above mentioned paths.
Add Actions
Select Eshopbox App
Choose to Create a Base Product, Create Virtual Combo, Create Kit actions respectively for the three above mentioned paths.
Similarly, select Update Product Path and add sub-paths as explained above.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Tracking inventory updates
Add a Trigger.
Select the Eshopbox app.
From the list of triggers choose Inventory Level Change trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app is the Eshopbox app, so the action app will be your app. Based on this, actions from your app will be loaded.
Choose the Update Inventory Count action.
Map the input fields from the Eshopbox app to the form fields in this action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Submit an order for fulfillment
Add a Trigger.
Select your app.
Your app action list will be loaded, choose New Order trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app your app, so the action app will be the Eshopbox app. Based on this, actions from the Eshopbox app will be loaded.
Choose the Create Order action.
Map the input fields from your app to the form fields in this Eshopbox action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Tracking fulfillment status
Add a Trigger.
Select the Eshopbox app.
From the list of triggers choose Order Status Update trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app is the Eshopbox app, so the action app will be your app. Based on this, actions from your app will be loaded.
Choose the Update Order Status action.
Map the input fields from the Eshopbox app to the form fields in this action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Customer cancellation
Add a Trigger.
Select your app.
Your app action list will be loaded, choose Order Cancelled by Customer trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app your app, so the action app will be the Eshopbox app. Based on this, actions from the Eshopbox app will be loaded.
Choose the Cancel Order action.
Map the input fields from your app to the form fields in this Eshopbox action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Create a return
Add a Trigger.
Select your app.
Your app action list will be loaded, choose New Return trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app your app, so the action app will be the Eshopbox app. Based on this, actions from the Eshopbox app will be loaded.
Choose the Create Return action.
Map the input fields from your app to the form fields in this Eshopbox action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Track return status
Add a Trigger.
Select the Eshopbox app.
From the list of triggers choose Return Status Update trigger.
Eshopbox loads sample data similar to the data the app would send when it’s connected with a live account.
Fill in any form fields, select multi-choice options, and click Continue to save them.
Add an Action.
The action app will be pre-selected based on your selection of the trigger app, here the trigger app is the Eshopbox app, so the action app will be your app. Based on this, actions from your app will be loaded.
Choose the Update Return Status action.
Map the input fields from the Eshopbox app to the form fields in this action app.
For the final step, add Automation Template’s Name and Description.
Click on Save draft if you wish to make few changes later, else click on Submit to submit the automation template for publishing.
Step 5: Turn Your App Into Sales Channel
The sales channel represents where you sell your products. Turning your app into a sales channel will enable you to fulfill orders.
Following are the steps to turn your app into a sales channel:
Choose a portal.
Select an existing portal
Create a new portal:
Portal Type: a shopping cart
Portal Name (unique): This can be the name of the APP.
Portal Logo Url: Logo URL of Portal.
Select the integration model.