1.0 Overview
Bitsila has streamlined the process for businesses, regardless of their size, to effortlessly integrate with EasyEcom, a powerhouse in the e-commerce realm. Thanks to this collaboration, EasyEcom users can seamlessly connect with the Open Network for Digital Commerce (ONDC) through Bitsila, facilitating a smooth entry into ONDC for selling purposes. This partnership acts as a fluid bridge, granting EasyEcom businesses the capability to expand their online presence with ease.
Within their EasyEcom accounts, users can readily tweak various elements, such as products, product groups, categories, and outlets. As a result of this integration, any adjustments made in the EasyEcom account are promptly synchronized with the Bitsila system. This synchronization, in turn, ensures that the corresponding ONDC listings are promptly updated to reflect the changes.
1.1 Conditions
For you to proceed with the integration, certain conditions must be met.
You must have your EasyEcom account already created. If you still need to, please complete your account creation.
You must have your Bitsila account already created. If you still need to, please complete your account creation.
Once you have created both of these accounts, you can proceed with integrations.
1.2 How does this work?
Bitsila now allows Upstream APIs to integrate with various e-commerce platforms.
The integration with Bitsila and EasyEcom is facilitated by the API endpoints and the master location key. These configurations will transfer data between each other. So, when the user makes any changes to the catalog, inventory, items, locations, etc on their EasyEcom Account, they will automatically reflect on the Bitsila system.
This integration extends to the orders and deliveries too. So, when an order is placed through the Bitsila system, it will reflect in their EasyEcom account.
1.3 Requirements
To enable this seamless integration and proper synchronization between both platforms, the following are required.
Order Push End Point
The Order Push Endpoint is needed to configure the Integration between EasyEcom and Bitsila. This Endpoint is the same for every Account and will not change based on the Account. So, for every EasyEcom endpoint, this will be the Order Push End Point.
https://api.easyecom.io/webhook/v2/createOrder
Order Status Push Endpoint
The Order Push Endpoint is needed to configure the integration between EasyEcom and Bitsila. This endpoint is the same for every account and will not change based on the account. So, for every EasyEcom endpoint, this will be the Order Status Push Endpoint.
https://api.easyecom.io/orders/cancelOrder
Master Location ID
This token is needed to configure the Customer Headers of the Bitsila Account
To obtain this Token, the Client must log in to their EasyEcom Account
On the top-right corner, Click on the Three dots.
Now, they can see a panel like this
Under the Account Name, there will be a 10 10-digit number. That is the Master Location ID
Copy that ID for further use.
Webhook Configuration
Webhooks are another important component in making sure the sync between the two platforms is working.
Without webhooks, the data will not be exchanged between both platforms. The Webhooks for various events need to be shared by the Bitsila team with the Client.
The Client needs to configure them in the EasyEcom Account
For the configuration
Log in to the EasyEcom Account
Click on the Three dots in the top-right corner
Click on Account Settings
You can see the Settings
Click on the Other Settings
Click on the Webhook Settings
In the Webhook Settings screen, now you can see different entry fields
The first entry field is a dropdown, where you need to select the trigger. Which means, an operation that you want to automate.
Select Trigger from the Dropdown
Select Action
Add the Webhook URL given by the Bitsila Team
Note: Usually, we need to configure six triggers for the EasyEcom Integration
Update Inventory
Confirm Order
RTD
Manifested
Cancel Order
Order Tracking
For Update Inventory, the URL will be: https://sys.myenstore.com/api/bitsila/update_inventory.json?_bkc_=00de00256e7b8f501f5ca2d4c4b3fb82
For Confirm Order, RTD, Manifested, Cancel Order Triggers the URL will be: https://sys.myenstore.com/api/bitsila/update_order_status.json?_bkc_=00de00256e7b8f501f5ca2d4c4b3fb82
For Order Tracking, the URL will be https://sys.myenstore.com/api/bitsila/update_rider_status.json?_bkc_=00de00256e7b8f501f5ca2d4c4b3fb82
Add the Token Given by the Bitsila Team
Add the email ID
Keep the Toggle On
Once you finished adding the details for One Webhook, click on the + button beside it to create a new webhook.
In the same way, Configure the remaining Webhooks.
Here is an example of the list of Triggers and webhooks that need to be configured
Once these are all configured, Click on Update Settings to finish the Configuration process
2.0 Integration Process
2.1 Upstream Provider Settings
The first step in the Integration process is to ensure that the upstream provider for the account is set to EasyEcom on the Bitsila System
Navigate to the Accounts Module on the Left-side Panel
Click on Accounts Option
You will be able to see a list of all the Accounts in the Bitsila system
Click on the Account that you are performing the Integration for.
You can find the Account by scrolling down the list or you can use the search bar.
Click on the Edit Button in the Overview Panel
Scroll down to find the Upstream Provider Dropdown under the Details Panel
If the Upstream Provider is not set up to EasyEcomm, Click on the dropdown and select EasyEcom.
2.2 Get the Master Location ID From the Client and Make them Finish the Webhook Configuration
For this step, you need to share an email with the Client with a clear step-by-step guide on how they could find the Master Location ID in their EasyEcom Account
You can find the template along with the guide below. Do not change anything other than the client’s name and send the email.
Email template:
Subject: Request for Master Location ID for Bitsila Integration
Dear [Client’s Name],
I hope this email finds you well. To complete the integration process between your EasyEcom account and Bitsila Account, we require your EasyEcom account’s Master Location ID.
Here is a step-by-step guide to assist you in finishing the process
Step 1: Log in to your EasyEcom Account
Step 2: Click on the Three dots on the top-right corner
You can now see a new panel
Step 3: Under the name of your Account, you can find a 10-digit number. Copy it
By following these steps, you should have successfully obtained the Master Location ID.
Now, you need to Configure the Webhooks
Here are the Configure the Webhooks
Step 1: Click on the Three dots on the top-right
You can Now see a Panel
Step 2: Click on Account Settings
You can now see the Account Settings
Step 3: Click on the Other Settings
You can now see the Other Settings Screen
Step 4: Click on the Webhook Settings
You can now see a few entry fields
The first entry field is the dropdown where you need to select the trigger
Step 5: Select a Trigger in the dropdown
Step 6: Select Action
Step 7: Add the Webhook URL
Here is what the URL for the Update Inventory looks like: https://sys.myenstore.com/api/bitsila/update_order_status.json
Step 8: Add the Token
Step 9: Add the Email
Step 10: Keep the Status Toggle On
One Webhook is now added.
Step 11: Click on the Plus button to add another webhook and follow the same procedure to configure it
Step 12: Configure the remaining webhooks and Click on the Update Settings Button.
The Webhook Configuration is Completed.
Here are the details of Webhooks that you need to configure.
If you encounter any issues or have questions along the way, please don't hesitate to reach out to our support team.
We hope you can finish the Webhook Configuration and send us the Master Location ID details to [email] as soon as possible so that we can complete the Integration.
Best Regards,
[Your Name]
[Your Postiion]
[Contact info]
Once you receive the ID from the customer you can proceed with the next step.
2.3 Configure the Order Push End Point and Order Status Push End Point
Navigate to the Accounts Module on the Left-side Panel
Click on Accounts Option
You will be able to see a list of all the Accounts in the Bitsila system
Click on the Account that you are performing the Integration for.
You can find the Account by scrolling down the list or you can use the search bar.
Click on the Edit Button in the Overview Panel
Scroll down to find the Order Push Endpoint and Order Status Push Endpoint Fields
Enter the Order Push End Point
Enter the Order Status Push End Point
2.4 Configure the Custom Headers
To Configure the Customer Headers, you need to format the Master Location ID as follows
{“master_location_id”:”10-digit code”}
So, using the Master Location ID, the customer header will look like this
{
"email":"tech@zfwhospitality.com",
"password":"Aniket@567",
"master_location_id": "ur7321198096"
}
This should be entered in the Custom Headers field.
In the same Edit Screen where you entered the Order Push and Order Status Push Endpoints, you can find the Custom Headers field at the bottom.
Enter the formatted Customer Headers in that field.
Click on the Update Button at the top-right corner to save the settings and finish the configurations
After the Configuration, ensure that the Client has already created the Locations (Outlets) and Catalog items within the EasyEcom Account. If not, please let them create the locations and outlets in their account.
Location set up in EasyEcom: https://support.easyecom.io/portal/en/kb/articles/step-to-add-child-company#_2
Go to the Masters Module in your EasyEcom Account
Click on the Location Master
Click on Create Location
Enter the Location Details
Click on Save Location
Products set up in EasyEcom:
https://www.youtube.com/watch?v=GSNIb8ESVoI
Go to Masters Module
Click on Product Master
Click on the Create Product Button
Click on the Add a New Product
Enter the Details
Click on Save Product
The client can also import the products through the Upload CSV.
2.5 Set up Initial Catalog
Once the Configuration is finished, we need to set up the Initial Catalog
With this process, the locations and items in the Client’s EasyEcom account will Automatically sync with the newly integrated Bitsila Account.
You do not need to manually add any of the locations and catalog items from the Bitsila side.
To set up this
Navigate to the Accounts Module on the Left-side Panel
Click on Accounts Option
You will be able to see a list of all the Accounts in the Bitsila system
Click on the Account that you are performing the Integration for.
You can find the Account by scrolling down the list or you can use the search bar.
In the Account Overview screen, Click on the Actions Dropdown on the top-right corner
Select Set up Initial Catalog Option
Click on Confirm
2.6 Verification of Catalog Set-up
Once the Initial Catalog setup is done, all the locations and items will be synched with the Bitsila Account from the EasyEcom Account.
You can verify if the Sync has any problems through the following process.
Switch to the Client’s Bitsila Account
Click on Accounts on the System side>> Switch Account>> Enter the Client Account Name>> Select Group User>> Select ID and Click on Switch at the top-right corner.
Checking the Outlets
Navigate to the Business Module on the left-side panel
Click on Outlets
All the outlets that are added to theEasyEcom account should be here
Checking the Items for the Outlet
In the Outlets screen, click on any outlet
Click on Items Tab
You will be able to see all the Items associated with this particular outlet
Checking the items for the Account
Navigate to the Products Module on the left-side panel
Click on Items
Here you can see all the items that are now linked to this account
2.7 Add the Business Category In Business Profile and Item Categories
Once the Items and Outlets are all in sync, you need to add the Business Category.
Go to Business Profile in the top-right corner
Click on Business Profile
You will see the general info tab
Click on the Edit button in the top-right corner
Scroll down to navigate to the Business Category Field
From the dropdown select the Business Category
Now Navigate to the Products Module on the Left-side Panel
Click on Item Categories
All the Categories added by the user in their EasyEcom Account could be seen here
Choose an Item Category
You can see the details of the Item category
Click on the Edit button
Under the Details Panel, you can see the Business Category field
Click on the Dropdown and Select the Business Category
Click on Update
Repeat the Process to other categories
2.8 Configure the C Taxonomy and G Taxonomy
Go back to the System side
Go to Accounts Module
Click on Accounts
You will see the list of all the accounts
Click on the Account that you are integrating
You can find the Account by scrolling through the list or through the search bar
You will see the Account General info
Click on the C Taxonomy Tab
Click on Map Category Button
Select Account Category and Master Category
Click on Create
In the same way
Click on the G taxonomy tab
Click on the Map Category Button
Select Account category and master category from the dropdowns
Click on Create
Now Click on the Actions Dropdown on top-right
Click on Sync Product Catalog to Master
2.9 Configuring for ONDC
Go to ONDC Module on the Left-side Panel
Click on Accounts
You will see the list of all the Accounts
Click on Add to ONDC Button on the top-right Corner
You will see a pop-up screen with entry fields
Enter the Details
Click on Add Button
The Account will be added to the ONDC and you can see it in the list of Accounts
Click on the Account to see the general info of the Account
Click on the Outlets tab
Map the Outlet
Now Click on the Items tab
Click on the Actions Dropdown and select Map all
The account is added to ONDC, and all the products and outlets are synced.
3.0 FAQs
FAQs for EasyEcom and Bitsila Integration Guide
Q: What is the purpose of integrating EasyEcom with Bitsila?
A: This integration streamlines the process for businesses to connect with the Open Network for Digital Commerce (ONDC) through Bitsila, expanding their online presence effortlessly.
Q: How does the integration work?
A: The integration uses API endpoints and the master location key to synchronize changes made in EasyEcom accounts with Bitsila, ensuring prompt updates in the ONDC listings.
Q: What can users modify within their EasyEcom accounts after integration?
A: Users can easily adjust products, product groups, categories, and outlets, with changes promptly reflected in the Bitsila system and ONDC listings.
Q: What are the conditions to proceed with the integration?
A: Users need to have created both EasyEcom and Bitsila accounts before proceeding with the integration.
Q: What are the key requirements for seamless integration?
A: Users need to set up Order Push and Order Status Push Endpoints, obtain the Master Location ID from EasyEcom, and configure custom headers using the obtained Master Location ID.
Q: How do I find the Master Location ID in my EasyEcom account?
A: Log in to your EasyEcom account, click on the three dots in the top-right corner, and under the account name, copy the 10-digit number displayed.
Q: How do I configure Order Push and Order Status Push Endpoints?
A: Navigate to the Edit screen of the relevant account in the Bitsila system, scroll down to find the respective fields, and enter the provided endpoints.
Q: How do I set up the Initial Catalog after configuration?
A: In the Bitsila system, navigate to the Accounts module, select the relevant account, click on Actions, and choose Set up Initial Catalog. Confirm the action to sync locations and items from EasyEcom.
Q: How can I verify if the catalog setup is successful?
A: Switch to the client's Bitsila account, and check outlets and items under the Business and Products modules to ensure synchronization.
Q: How do I configure for ONDC after integration?
A: In the ONDC module, click on Accounts, add the account to ONDC, and map outlets and items. This ensures that products and outlets are synced with ONDC.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article