Thank you for choosing Delivery Solutions! This section is designed to help you get up and running with Delivery Solutions (DS) as quickly as possible.
If you haven’t already, watch our intro walkthrough before you dive into Delivery Solutions.
Delivery Solutions enables retailers access, orchestrate and optimize last mile deliveries for forward deployed inventory. Delivery Solutions unlocks last mile deliveries for retailers using their own e-commerce assets. No matter where the retailer is in their delivery journey, Delivery Solutions has something of value to take them to the next step.
Desktop
Mobile
Our Account Section lets you manage your Profile, Businesses, API Keys and so on.
Now you can login to Delivery Solutions on Desktop, or by using Android or iPhone.
During login, you'll be asked to verify that you are not a robot on your first login attempt. You'll also be asked to complete verification steps if your browser is in private or incognito mode, or if you cleared your browsing history since your last login to DS. You need to wait for all images to load in each verification step before you click Verify.
To learn more take a look at this or review the information below:
If you've logged into your account on the same device before, then your account might already be listed on the login page. In that case you can log in by your credentials, and you won't be prompted again to verify your account
You can reset your login password if you forget it. The steps to reset a password are the same with two-step authentication enabled.
This is how our forgot password page looks like..
Each of your passwords should be unique. Avoid using the same password for more than one account, even if the accounts are related.
Account Profile page shows details added while creating an account. Platform admin can modify these details if required.
It takes basic details about Account such as Name, Contact Name, Email, Phone and Address
This is how our Account Profile page looks like..
Account Profile lets you modify your basic information pertaining to Account such as Name, Contact Name, Email, Address and so on.
To learn more take a look at this or review the information below:
Business profile data can be altered from this interface. For example, Business Name, Contact Details, Email etc. On this interface Business Admin can set below important Configurations for order and notifications.
This is how our Businesses page looks like..
Businesses page lets you add businesses under your account. Typically this module takes details such as Business Name, Email, Logo, Address and so on.
To learn more take a look at this or review the information below:
Business details can be modified under Edit Business Section.
When an Account gets created a default API key gets generated and sent to Account Manager for accessing Delivery Solutions APIs.
In this section user can create multiple API keys for the Account, which he can extend to different systems at their end, for example website or mobile app or separate API key for his digital partner to track the orders getting generated thought them separately.
Please note, Account Manager who is accessing these APIs needs to mention Tenant ID of business at the time of creating store or order under that business.
This is how our API & Services page looks like..
Account Manager can create API Keys under API Key section.
The Attribute Form seeks information for below fields:
Field Name | Description |
---|---|
Key Name | Name of the API Key |
API Key | A unique identification of the API Key It can be alphanumeric. It must start with Character. No Special Characters allowed.(except '_') |
An existing API Key can be edited.
Instead of removing, Businesss can opt to make an API Key Enable or Disable.
You can permanently remove an API Key.
Our Business Section lets you manage your Profile, Brands, Pick Up Location, API Keys and so on.
Profile interface shows business-specific configurations for your Orders and Notifications. For example, Business Name, Business Email, Notifications and so on.
This is how our Profile Section looks like..
Your Business details includes your Business name, registered Business email, phone number and webhook details. If you need to update your Business details, you can access it through edit option on the profile page.
To enter your details or update your current details, head to your Business section on your sidebar and select the Profile section. Once inside, you will be able to edit or fill in your profile details.
This is how your business details looks like..
The Update Profile seeks information for below fields:
Field Name | Description |
---|---|
Business Name | Name of the Business |
Business Email | Registered Email of Business |
Phone | Registered Contact Number of Business |
Webhook URL | URL to be configured in Delivery Solutions to send webhooks to Tenants |
Webhook Secret | Secret Token to secure webhook requests |
Compliance | CCPA and GDPR Compliance can be opted through this option |
Delivery Solutions Orders can be accesses through APIs using unique Order ID. These Order ID can be either External Business's Order ID or Delivery Solutions's own Order ID. Business Setting section lets you enable the External Business Order ID to be used to access Delivery Solutions orders.
This is how your business settings looks like..
If there are any duplicate orders exists in your delivery account prior to enabling Unique External ID. It will not allow you to do so. Please contact Delivery Solutions Support to enable the same for your account.
At Risk Settings section allows you to configure Order At Risk Settings. In this section you can set the limit on Status in minutes before/after which an order will be considered at Risk if remains in same status for long. The At Risk Settings are also available at the Store and Order level. The settings configured at the Business level will automatically inherited by the Stores and each of its Orders unless it is forcefully overridden.
This is how your At Risk Settings Section looks like..
The At Risk section seeks information for below fields:
Field Name | Description |
---|---|
Pickup Start | Pickup Start Time of Delivery in Minutes |
Drop-off End | Drop Off End Time of Delivery in Minutes |
At Risk Settings sections can only be visible in Edit mode.
This section shows the correspondence address details
This is how your Address Section looks like..
The Address section seeks information for below fields:
Field Name | Description |
---|---|
Street | Street Address having Apartment Number and Street Name |
Street1 | Street Name |
City | City Name |
State | State Name |
Zip Code | Area Zip Code |
This section lets you set the priority of the Delivery Assurance. The Delivery Assurance Priority can be either Zips or Polygon.
This is how your Delivery Assurance Section looks like..
The Delivery Assurance section seeks information for below fields:
Field Name | Description |
---|---|
Priority | Zip Code or Polygon can be given as a default priority |
Smart Windows helps to configure the operating hours of Business, Brands and Pick Up Locations. It can be set at Business, Brand and at Pick Up Location level.
Smart Windows API generates Slots for a given day. Based on that, Business, Brand and Pick Up Location operational hours can be set.
Operational Timings can be set for below categories.
There are other categories which is common in all the levels (Business, Brand and Pick Up Location).
Or
Or
This is how our Smart Window page looks like..
Create Timings option is available at each level. As mentioned earlier Timings can be created for different categories. Delivery Solutions allows to create them for a week and same will be repeated by default.
This is how your create timings page looks like..
The Create Timings form seeks information as below:
Field Name | Description |
---|---|
Hours | Category in which timing needs to be created. In case of Curbside Pickup and Delivery, pick and pack time can be set. |
Days | Days for which it needs to be enabled and set. |
A few fields under existing Timings can be updated through Edit option.
Edit Timings page looks just like create Timings page.
Override will let you create exceptional timings which will override the existing timings. Eg. Creating a new override to define the store operational hours during Thanksgiving.
Override timings can be created at all the level i.e Business, Brands and Pick Up Locations.
This is how your create brand page looks like..
The Create Override form seeks information as below:
Field Name | Description |
---|---|
Timing Override Type | This option lets you select the categories like Business, Brands, Stores, Curbside Pickup and Delivery. |
Name | Override Name |
Date | Date for which override needs to be created. |
Tim Slot | A Time Range or 24 hours option. |
Pick and Pack Time | Time taken to pick and pack. |
A few fields under existing Override can be updated through Edit option.
Edit Timings page looks just like Create Override page.
Brands interface shows business-specific configurations for your Orders and Notifications. For example, Brand Name, Brand ID and so on.
Brand Name mainly identifies a brand under business, Brand ID is a unique identification in Delivery Solutions for a particular brand under business. While creating store under any brand “Brand ID” enforces that the store gets created under that brand only. Delivery Solutions allow Business Admin to define brand logo as well which gets printed on label of Packages.
This is how our Brand Section looks like..
Your Brand details includes your Brand name, Brand ID, registered Brand email, phone number and Address details. If you need to update your Business details, you can access it through edit option on the profile page.
To enter your details or update your current details, head to your Business section on your sidebar and select the Brand section. Once inside, you will be able to edit or fill in your Brand details.
This is how your create brand page looks like..
The Create Brand Form seeks information as below:
Field Name | Description |
---|---|
Brand Name | Name of the Brand |
Brand ID | Unique ID of Brand |
Description | A brief description about brand. |
Brand Logo | Logo of a Brand to identify it. |
Address | Address of the Store or Brand Location. |
At Risk Settings section allows you to configure Order At Risk Settings. In this section you can set the limit on Status in minutes before/after which an order will be considered at Risk if remains in same status for long. by default this setting is inherited from Business level. If particular Brand need customised At Risk Settings, you can uncheck "Business Settings (Default)" and can set your priority timings for At Risk Settings here.
This is how your At Risk Settings Section looks like..
The At Risk section seeks information for below fields:
Field Name | Description |
---|---|
Pickup Start | Pickup Start Time of Delivery in Minutes |
Drop-off End | Drop Off End Time of Delivery in Minutes |
At Risk Settings sections can only be visible in Edit mode.
This section shows the correspondence address details
This is how your Address Section looks like..
The Address section seeks information for below fields:
Field Name | Description |
---|---|
Street | Street Address having Apartment Number and Street Name |
Street1 | Street Name |
City | City Name |
State | State Name |
Zip Code | Area Zip Code |
A few fields under existing brand can be updated through Edit option in Brand Page. Please note that brandExternalId once created cannot be updated.
This is how your Edit Brand Section looks like..
The Edit Brand will open the Edit Brand form seeking the same information as of Create Brand.
A brand can be enabled or disabled but cannot be deleted. Since all the stores are required to be under a brand. It is prohibited to delete a brand. Once the brand is disabled, customers cannot place order with stores under that brand.
This is how your Brand Page Section looks like..
A brand can be set as default. This will help orders to use default brand when brandExternalId is not passed in Create Delivery. It will automatically show default brand in the list.
This is how your Brand Page Section looks like..
To manage your pickup location details or update your current store details, head to your Business Section on your left sidebar and select the Pick Up Location section. Once inside, you'll be able to edit or fill in your card details.
This is how our Pick Up Location page looks like..
This interface lets you create a new store. It seeks basic details of the store location.
This is how your Create Store Page looks like..
Store details section takes basic details of the store such as store name, description of the store, store id and so on.
This is how your Store Details Section looks like
The Store Details section seeks information for below fields:
Field Name | Description |
---|---|
Store Name | Name of the store |
Description | A brief description about the store |
Company Store ID | Unique Store ID |
Contact Name | Store Manager/Contact Person Name |
Phone | Phone number of the Store Contact Person |
DSP | Delivery Service Provider of the Store |
Pickup Instructions | Additional information regarding Pickup |
Label | Single or Multiple Store Label options |
At Risk Section allows you to set the minutes for the orders which can possibly at Risk After Pickup or Before Drop-Off. The delay in minutes mentioned in this section will measure how much the delivery of an order is at risk.
This is how your Store Details Section looks like
The At Risk Settings section seeks information for below fields:
Field Name | Description |
---|---|
Profie Settings (Default) | Business can override Business level settings at store level by checking this option |
Pickup Start | An order to be considered at risk after crossing no. of minutes post pickup |
Drop-off End | An order to be considered at risk after crossing no. of minutes before drop-off |
Dispatch Settings section allows you to configure Default Dispatch Settings of an order from this store.
This is how your Store Details Section looks like
The Dispatch Settings section seeks information for below fields:
Field Name | Description |
---|---|
Type |
Business Settings (Immediate): Default settings set in Business section for stores Immediate: Dispatch Order to DSP Immediately Manual: DS stores the order and wait for the manual intervention to release it to DSP Schedule: DS stores the order and releases to DSP as per scheduling |
Time | In case of Scheduled type, DS stores minutes before pickup starts |
This section shows the correspondence address details of the store.
This is how your Address Section looks like
The Address section seeks information for below fields:
Field Name | Description |
---|---|
Street | Street Name or Landmark Details |
Street2 | Street Name |
Apt/Suite | Apartment or Suite Number |
City | City Name |
State | State Name |
Country | Country Name |
Postal Code | Area Zip Code |
Latitude | Latitude Details of the Store |
Longitude | Longitude Details of the Sore |
This section allows you to create multiple departments for a store during the store creation process. You can add as many departments as you want for a store.
This is how your Departments Section looks like
The Departments section seeks information for below fields:
Field Name | Description |
---|---|
Name | Name of the department |
Description | Brief description about the department |
Pickup Instruction | Pickup instructions for the department such as pickup time is between 6 to 7 PM |
In case you wish to create multiple stores, our upload store feature lets you create multiple stores just at one click by uploading list of stores in a CSV/Excel file.
Enable or Disable the store just by clicking the toggle button. The disabled stores will not be reflected in the Service Coverage.
Visit the Service Coverage section under Pick Up Location for more details.
You can edit the existing store from the Pick Up Location Section.
Visit the Create Store section under Pick Up Location in order to understand sections and fields of Store Form.
Pick Up Location Page also provides a variety of filters to narrow down your search for a particular store.
Pick Up Location page has below filters to filter out the stores.
Below are the filters available on the Pick Up Location Page
Field Name | Description |
---|---|
Store ID | Filters the store(s) by Store ID entered in the Input Box |
Store Name | Filters the store(s) by store name entered in the Input Box |
City | Filters the store(s) based on the City selected in DropDown |
State | Filters the store(s) based on the State selected in Drop Down |
Zip Code | Filters the store(s) by Zip Code entered in the Input Box |
DSP | Filters the store(s) based on the DSP selected in the DropDown |
Store Manager | Filters the store(s) based on the Store Manager name entered in the Input Box |
Exclude Inactive Store | Filters the store(s) based on their status as "Enabled" or "Disabled" |
Exact Match | Filters the store(s) which matches exactly with search keywords, if checked. |
All the filters available in the Stores are now merged with Service Coverage filters.
To manage your store boundaries under service coverage, head to your Business Section on your left sidebar and select the Pick Up Location section. Once inside, you'll be able to view the Service Coverage section
Delivery Solution uses the service area feature which is specifically designed for Business Admin who deliver their products to local customers/retailers. It uses coverage map to indicate the the store markers and boundaries of the stores based on the region in order to check whether the delivery services are available in the region or not.
Delivery Solutions has set the service area based on the cities, states and postal code. Store Managers can create the store and their boundary to indicate the services they provide in a particular region.
This is how your Service Coverage Section looks like.
There are two modes of the Service Coverage Map:
Our Service Coverage has been merged with Business Pick Up Location page.
Search the stores available near the address throughour Service Coverage page.
Delivery Solution uses geocoding in order to convert the street address into geographic coordinates like latitude and longitude to place the store markers and their boundaries on the map. If the Lat Long of the address falls under any store boundary coordinates stored in our system. we use reverse geocoding to convert the geographic coordinates into human readable store address in return
Example: Searched with address “1221 North Central Expressway” The results will be shown as below upon finding a store.
Example: Searched with address “1221 North Central Expressway” The results will be shown as below in case stores are not matched
Delivery Solutions allows Business Admins to create their store’s boundaries in order to highlight the region they provide services.
Our draft tool allows you to add geographic boundaries of your store to the map. You can then easily associate your data to the individual borders that are on the map. This lets you compare the serviceable areas of your stores on the map with just a few clicks.
Area Type
Boundary Type
Example: Newly added Polygon store boundary will look as below
Please visit the Area and Boundary Type section for more details
Edit the existing boundaries on the map for your stores.
Once your boundaries have been created, they can be easily edited in real-time right from within your map.
Remove your store’s existing boundaries on the map.
Once your boundaries have been created, they can be easily removed in real-time right from within your map.
There are two ways store related changes on Service Coverage can be saved or published.
Let's have a look at the icons available in Draft mode to Save or Publish Store Boundaries
You can save or publish specific store's boundaries.
There are two ways store related changes on Service Coverage can be saved or published.
Circular boundary around the store can be highlighted with Show Guide toggle button shown below the Service Coverage Map
Boundaries can be given tags
Store boundaries indicates their services in that area. These boundaries can be defined in different shapes on the map.
Boundaries are useful for determining where certain points on your map lie, how far one map point is from other points on your map, and seeing how many points on your map exist within various distance increments. Ultimately Stores can have boundaries as below
Polygon
The Polygon boundaries are the free form boundaries of Pick Up Locations which is used to define coverage area of a store/Pick Up Location
Circles
The Circle Boundary shows the radius circle in miles or kilometers from the Pick Up Location. This type of boundary is drawn around the Pick Up Location/Store marker considering the marker as the center point of the radius.
Zips
Delivery Solutions provides the outline of all the approximately 38,000 ZIP Codes that exist in the United States of America. All you need to enter is Zip Code and our map will automatically highlight the boundaries of the Zips.
Address
The address boundary is a radius circle in miles or kilometers from any specific address in order to quickly determine distances.
Your boundary width, boundary color, fill color, fill opacity, and shapes are now available for your specific needs and preferences.
Store Boundaries on the Map defines whether the store services are available or not in a particular area. These boundaries represents the metrics and ultimately helps Business Admin to understand where in the Map their stores resides and what area they serviceable.
Our boundary legends appears as a box to the right your graph. The box contains small samples of each boundary and fill color on the Map as well as a short description of what each color means.
This is how the boundary legend box looks like.
The legend box shows color coding for..
The outlining of the store boundaries defines the state of the boundaries whether they are published, modified, saved or in draft mode.
Published Boundaries:
The Published store boundaries which are committed ones and will be Live on the map.
In Draft, these boundaries can be visible with blue outlinings..
Modified Boundaries:
The Modified store boundaries can be visible with Red outlinings in the Draft. These boundaries were once Live but now modified in draft and saved. Please note that these store boundaries are not yet published.
Unpublished Boundaries:
The Unpublished store boundaries are the ones that are newly drawn and saved in the draft but yet to be published. Such boundaries can be visible with purple outlinings in the Draft.
Uncommitted Boundaries:
The Uncommitted boundaries are the ones that are newly drawn or modified on the Draft but not yet Saved and Published.
The type of area within the boundaries can be determined by the fill color used in it. The areas can be whitelisted or blacklisted. Similarly, the boundaries changes its fill color based on whether they are currently selected on the Map or not.
In-service area:
The unselected In-service area boundaries will be filled with Green color.
Out-of-service area:
The selected Out-of-service area boundaries will be filled with Grey color.
Zips:
The Zip Code area boundaries will be filled with Strips
Delivery Solutions lets you set the areas as whitelisted or blacklisted within your store boundaries.
There are few areas which are located near the stores but the deliveries are prohibited in those areas. Such areas often called as blacklisted areas where delivery of certain products are prohibited.
Delivery Solutions not only allow Business Admins to draw the boundaries around their stores. But, it also let them define the type of area. This is where the concept of whitelist and blacklist area came into the picture.
In-service areas’ boundary on the maps states that the stores provide services in such areas. These areas are highlighted in Green Color on the map. A Business Admin can draw such boundaries within their serviceable areas to indicate the availability of their services.
Example: Newly added Serviceable(In-service) Polygone store boundary will look as below
Out-of-service areas’ boundary on the maps states that the stores do not provide services in such areas regardless the area falls under the serviceable boundaries of the stores or not. Such areas are highlighted in Grey Color on the map. A Business Admin can draw such boundaries within their serviceable areas to indicate the unavailability of their services.
Example: Newly added Out-of-service Polygone store boundary will look as below
Packages are nothing but the containers in which the items will be delivered to the customer. The measurement of the order packages can be managed in Packages page under deliveries section. You can Create, Edit and Delete the packages based on the requirement.
This is how our API & Services page looks like..
Adding a packages in the Delivery Solutions can be done through few clicks.
This is how Create Package page looks like
The Package Details section seeks information for below fields:
Field Name | Description |
---|---|
Package Type | Type of Package such as Small, Large |
Weight in (LB) | Package Weight in Pounds |
Length (inches) | Package Length in Inches |
Width (inches) | Package Width in Inches |
Height (inches) | Package Height in Inches |
Existing packages can be edited under Packages page
Existing packages can be set as deleted under Packages page
Gathering order related data and analyzing it for making smart decisions is the way to success in any business. Now you can simply predefine and add custom order attribute fields to your checkout page and automatically receive all necessary data. Creating as many additional order attributes as you need enables you with a rich feedback tool. Use such field input types as text field, date, yes/no, dropdown, etc. and quickly process collected data on the backend.
This is how our API & Services page looks like..
Businesss can create order attributes in Order Attribute.
The Attribute Form seeks information for below fields:
Field Name | Description |
---|---|
Name | Name of the Attribute |
Key | A unique identification of the Attribute It can be alphanumeric. It must start with Character. No Special Characters allowed.(except '_') |
Data Type | Type of the Attribute String Boolean Array Number |
An existing order attribute can be edited.
Instead of removing, Businesss can opt to make an attribute inactive or activate.
You can permanently remove an order attribute.
Alerts sections can be helpful in setting up the alerts. It can be set for Business to receive Webhooks, SMS and Email for the set of order statuses.
This is how Alerts Page looks like
There are two sections under this page.
Filters section can be used to filter existing alerts based on some criteria such as Brand, Pick Up Locations, DSP and Order Status.
List section lets you create alerts.
Follow below instructions to create a Notification:Alert Form seeks information for below fields:
Field Name | Description |
---|---|
Assign | Alerts can be set at 2 level and will get inheritted to subsequent layer.
Brand: Select this radio button to enable Alerts to all stores under the brand. Pick Up Location: Select this radio to enable notification to all orders under the pickup location. Assigned All: This toggle remains enabled by default and notifications applies to all store/orders. |
Apply | Status: Order status for which notification is to be sent. DSP: DSP for which notification is to be sent. Assigned All: Enable respective toggle to set notifications for all status/dsp. Send if condition lasts at least: Set Number of minutes after which alerts needs to be triggered. |
Recipients: | Webhook: Set webhook alerts for order statuses. SMS: Set SMS alerts for order statuses. Email: Set Email alerts for order statuses. |
API Keys section under Business lets you create Business API Keys. These keys helps Business Admin to access the orders under their Business. These API Keys are local to the business and cannot be used with other business under same account.
Businesss can create API Keys under API Key section.
The Attribute Form seeks information for below fields:
Field Name | Description |
---|---|
Key Name | Name of the API Key |
API Key | A unique identification of the API Key It can be alphanumeric. It must start with Character. No Special Characters allowed.(except '_') |
An existing API Key can be edited.
Instead of removing, Businesss can opt to make an API Key Enable or Disable.
You can permanently remove an API Key.
Compliance Check page lets you check the Alcohol Compliance in a particular Zip area.
Businesss/Account Admins can check the alcohol compliance between source to destination address with the help of Zip.
The Compliance Check Form seeks information for below fields:
Field Name | Description |
---|---|
Street | Name of the street along with Apartment number |
Street2 | Street2 field can take additional address details. This field is optional. |
City | Name of the City |
State | Name of the State/Province |
Zip | Postal Code of the area |
Auto Retry specifies whether an attempt to be made to access a Page/URL/API Request/Response after its initial failure response. Auto Retry Configuration lets you set the number of attempts to be made during a particular timeframe from the initial failure.
All the Auto Retry attempts of an order are captured in Fetch Logs and considered as a part of Order Lifecycle.
The Auto Retry Configuration Page seeks information for below fields:
Field Name | Description |
---|---|
Retry for | Auto Retry can take place at API or Webhook level. if any error is encountered, Auto retry will automatically hit the URL by followig configuration made on this page |
Events | Event are nothing but possible errors/exceptions faced during a communication between pages/integrations..
|
Total Retries | Number of attempts or try can be set upon receiving any of the above error code |
Choose Alternate DSP | This option lets you switch to second prefferred DSP in absence of first preffered DSP. |
Retry Interval | After every XX(Hrs/Mins/Secs) you want "Auto Retry" to re-connect to the errored URL. |
Delivery Solutions facilitates Single Sign on Authentication. SAML authentication is the process of verifying the user's identity and credentials (password, two-factor authentication, etc.). SAML authorization tells the service provider what access to grant the authenticated user
The Authentication Page seeks information for below fields:
Field Name | Description |
---|---|
Single Sign On Login Message | Message to be displayed once User has been successfully logged in |
SSO Instruction | Specific Instruction before the Login |
Entity ID/Issuer URL | Issuer - The Entity ID—a URL that uniquely identifies your SAML identity provider. SAML assertions sent to Delivery Solutions must match this value exactly in the attribute of SAML assertions. Entity ID - The issuer in SAML requests generated by Delivery Solutions, and is also the expected audience of any inbound SAML Responses. |
Login URL/SSO Endpoint | SAML endpoints and URLs. Communications within a federation take place through endpoints on the servers of the identity provider and service provider partners |
Logout URL/SSO Endpoint | SAML endpoints and URLs. Communications within a federation take place through endpoints on the servers of the identity provider and service provider partners |
Client ID | Client ID is similar as Entity ID. |
Client Secret | Client Secret (OAuth 2.0) is a secret used by the OAuth Client to Authenticate to the Authorization Server. The Client Secret is a secret known only to the OAuth Client and the Authorization Server. Client Secret must be sufficiently random to not be guessable |
Idp Certificate | An identity provider (abbreviated IdP or IDP) is a system entity that creates, maintains, and manages identity information for principals while providing authentication services to relying applications within a federation or distributed network. |
DS Callback URL | A callback URL will be invoked by the API method you're calling after it's done. So if you call. |
DS Login URL | The Delivery Solutions login page URL |
SAML is an XML-based framework for authentication and authorization between two entities: a Service Provider and an Identity Provider. The Service Provider agrees to trust the Identity Provider to authenticate users. In return, the Identity provider generates an authentication assertion, which indicates that a user has been authenticated.
SAML is a standard single sign-on (SSO) format. Authentication information is exchanged through digitally signed XML documents. It's a complex single sign-on (SSO) implementation that enables seamless authentication, mostly between businesses and enterprises.
With SAML, you don't have to worry about typing in authentication credentials or remembering and resetting passwords.
Auth0 is a flexible, drop-in solution to add authentication and authorization services to your applications.Your team and organization can avoid the cost, time, and risk that comes with building your own solution to authenticate and authorize users.
Each time a user tries to authenticate, Auth0 will verify their identity and send the required information back to your app.
Name | Link |
---|---|
Sandbox Portal Link | https://sandbox.portal.deliverysolutions.co |
Sandbox API Link | https://sandbox.api.deliverysolutions.co |
Production Portal Link | https://production.portal.deliverysolutions.co |
Production API Link | https://production.api.deliverysolutions.co |
A. SAML based Single-sign-on B. Manifest C. User Attributes & Claims D. Users & Groups
A. SAML based Single-sign-onOkta enables you to provide Single Sign-On (SSO) access to cloud, on-premise, and mobile applications. You sign into Okta and you can then launch any of your web apps without having to reenter your credentials.
Okta establishes a secure connection with a user's browser and then authenticates the user to Okta-managed apps using one of two SSO integration methods:
1. Okta's Secure Web Authentication (SWA) 2. Federated (supporting SAML or another proprietary federated authentication protocol)
Basic StepsA. Add Attributes for Role B. SAML Integration C. User Assignment D. Configure Idp Certificate in Delivery Solutions
A. Add Attributes for RoleFrom Okta | To Delivery Solutions |
---|---|
Identity Provider Single Sign On Url | Login Url/ SSO Endpoint |
X.509 Certificate | Idp Certificate |
Audience Uri | Entity Id |
From Delivery Solutions | To Okta |
---|---|
DS Callback Url | Single Sign On Url |
Entity Id | Audience Uri |
OpenID Connect is a simple identity layer built on top of the OAuth 2.0 protocol, which allows clients to verify the identity of an end user based on the authentication performed by an authorization server or identity provider (IdP), as well as to obtain basic profile information about the end user in an interoperable and REST-like manner. OpenID Connect specifies a RESTful HTTP API, using JSON as a data format.
OpenID Connect is an increasingly common authentication protocol: when an app prompts you to authenticate using your Facebook or Google+ credentials, the app is probably using OpenID Connect.
OpenID Connect allows a range of clients, including web-based, mobile, and JavaScript clients, to request and receive information about authenticated sessions and end-users.
OneLogin provides a custom connector option that makes it easy to configure your OpenID Connect-enabled app to use OneLogin as the Identity Provider (IdP) in an OpenID Connect flow.
Delivery Solutions supports OpenID authentication with Google's OAuth 2.0 APIs.
Relay settings can be set over here to receive the webhooks.
This is how our Relay page looks like..
Understanding how orders work in DeliverySolutions is an important part of any Business.. After a customer places an order, It appears on the Status page under Deliveries section of Delivery Solutions.
Status Name | Description |
---|---|
REQUEST RECEIVED | Tenant request for placing the Order has been received at DS |
ESTIMATES RECEIVED | DS has received estimates from one or more DSP on order |
ESTIMATES FAILED | DS has not received estimates from any of the DSP on order |
ORDER DISPATCHED | Order has been dispatched to DSP from DS |
ORDER CONFIRMED | DSP has received the order at their end |
ORDER ASSIGNED | DSP has assigned the order to a driver |
PICKUP STARTED | Driver has started moving towards pickup location |
PICKUP EXCEPTION | Driver has reported some exception in pickup |
PICKUP COMPLETED | Driver has picked up the package from Pickup Location |
OUT FOR DELIVERY | Driver has started moving towards delivery location with package |
ORDER DELIVERED | Driver has delivered the package to customer |
ORDER RETURNED | Driver has returned the package to pickup location |
ORDER CANCELLED | Order has been cancelled either by tenant or DSP |
ORDER FAILED | Order has been Failed, and is not with DSP for delivery |
ORDER DELAYED | Driver has reported that he is running late for delivering the order |
ORDER UNASSIGNED | Order has been unassigned from Driver |
ORDER UNDELIVERABLE | Order cannot be delivered,Driver has reported some exception in delivering the order. |
ORDER REDELIVERY | Order is out for re-delivery by Driver |
Place your orders with Delivery Solutions.
There are two ways through which an order can be placed with Delivery Solutions
This is how our Deliveries page looks like..
Locate Create Delivery Page with below steps:
This is how our Create Delivery page looks like..
Store details section takes basic details of the store such as store name, store Timezone, Pickup/Drop off Window details and so on.
This is how your Pickup Details Section looks like
The Pickup Details section seeks information for below fields:
Field Name | Description |
---|---|
Store | List of stores under the selected business |
Store Timezone | Store’s local timezone |
Order ID | Unique Identification Number of Order |
Department | Store’s Department such as Food, Apparel |
ASAP Pickup | Pickup As soon as the order is ready to deliver |
ASAP Drop Off | Deliver the order as soon as it is picked up |
Pickup Time Window Start and End | Timeframe between which an order can be picked up |
Drop-off Time Window Start and End | Timeframe between which an order can be picked up |
Pickup Start and End Time and Drop Off Start and End Time windows will not be applicable if ASAP Pickup and Drop Off is selected respectively
Dispatch Settings section allows you to configure Order Dispatch Settings while placing an order. A dispatch type determines whether an order should be dispatched to DSP or requires to be with Delivery Solutions until manually released or scheduled to release to DSP. The Dispatch Settings are also available at the Store and Order level for overrides. The settings configured at the Business level will be inherited by the Stores and each of its Orders unless overridden.
This is how your Dispatch Settings Section looks like
The Dispatch Settings section seeks information for below fields:
Field Name | Description |
---|---|
Type |
Immediate: Dispatch Order to DSP Immediately Manual: DS stores the order and wait for the manual intervention to release it to DSP Schedule: DS stores the order and releases to DSP as per scheduling |
Time | In case of Scheduled type, DS stores minutes before pickup starts |
Drop Off section takes the details of the delivery address where order needs to be delivered.
This is how your Drop-Off Section looks like
The Drop Off section seeks information for below fields:
Field Name | Description |
---|---|
Contact Name | Name of the customer whose order needs to be delivered |
Phone | Contact Number of the customer |
Street | Street Address having Apartment Number and Street Name |
Street1 | Street Name |
Apartment Number | Apartment Number |
City | City Name |
Postal Code | Zip Code of the Area |
State | Name of the State |
Country | Name of the Country |
Latitude | The Latitude will be automatically generated based on the address |
Longitude | The Longitude will be automatically generated based on the address |
Package Details section contains details about the package such as Package value, Package Size, Quantity and so on. You can add as many packages as you want by clicking Add button in Package Details section
This is how your Package Details Section looks like
The Package Details section seeks information for below fields:
Field Name | Description |
---|---|
Total Package Value | Total Package Value contains the cost of it |
Tip | |
Package Content | The type of content in the package |
Size | The size of the package Small Medium Large |
Quantity | Number of Packages |
Weight (in lbs) | Package Weight in pounds |
Length (in Inches) | Package Length in Inches |
Width (in Inches) | Package Width in Inches |
Height (in Inches) | Package Height in Inches |
Items | Number of items in a Package |
In this section you can mention the Email and Phone number details where order notifications will be sent.
This is how your Notification details Section looks like
The Notification Details section seeks information for below fields:
Field Name | Description |
---|---|
URL | Webhook URL for notifications |
Email Address for notifications | |
SMS | Phone Number for SMS notifications |
Business Admins can also provide details for order attributes while placing an order. These attributes further helps in selecting most suitable DSPs by filtering them using Business Rules.
This is how your Custom Attributes Section looks like
In Order with Estimates, before placing an order with DSPs, You request for the estimates given by all the DSPs. Additionally, based on the cost and time in the estimate you can make a decision which DSP you wish to give order for delivery.
Follow below instructions
Direct place order internally works the same way as that of get estimate and place order, i.e. when order request is received, first DS requests for estimates from all DSPs, on receiving estimates based on rule configured best DSP in terms of estimation gets selected, and instead of giving estimate and DSP details back to tenants, Delivery Solutions places the order directly to that DSP of which estimate was selected as best out of all DSPs..
Follow below instructions
Orders can be scheduled as well. In dispatch settings under Create Delivery page, Businesss can select the schedule option. Whenever an order is placed as schedule, It is mandatory to set the Pickup Start Time and Drop Off End time prior to placing the order.
Follow below instructions
Delivery Solutions allows you to place an order manually where you can save an order with Delivery Solutions and release it to DSPs later on.
Follow below instructions
Customers can place an ASAP order through API as well as Delivery Solution Interface. An ASAP order means Pick up the order right away and Deliver the order as soon as the pickup is done. However, DSP preference and Scenarios will be still considered. The earliest delivery will be selected as per the scenarios set under the orchestrations section.
Please note in this case “Always Honor Delivery Window” check becomes invalid as there is no fix time given by tenants to pickup and delivery.
However, in this case DSP preference and Scenarios still comes into play, and as per the result of those scenarios estimate which will delivery at earliest gets selected.
ASAP Pickup
When an order is set for ASAP Pickup option, It enforces the DSPs that the order should be picked up from the store as soon as it is ready for pick up.
This is how ASAP Pickup option looks like.
Follow below instructions
ASAP Drop Off
When an order is set for ASAP Drop Off option, It enforces the DSPs that the order should be delivered to the customer as soon as it is available to them for delivery.
This is how ASAP DropOff option looks like.
Follow below instructions to create an ASAP Pickup Order:
Exact Delivery Window Rule under Orchestration section will become inapplicable for ASAP orders
Orders which are with Delivery Solutions and yet to be dispatched to DSPs can be managed through Delivery Solutions Interface.
You can view all the orders on Status page under Deliveries section.
You can search your orders based on the filters available on the Status Page.
This is how the list of filters looks like.
The Status page contains below filters.
Field Name | Description |
---|---|
Date |
Filters Stores as per the duration mentioned below
Last 24 Hours Upcoming Tomorrow Today Yesterday Last 7 Months Current Month |
Date Applies to | Above Date Filter will be applied to below date types.
Pickup Date Drop Off Date Created Date Updated Date |
Time Zone | The Timezone the store located in. Local Time (Default - local timezone of the store) Eastern Central Mountain Mountain Standard Pacific |
Address Applies To | Pick Up Location Drop Off Location Pick Up Or Drop Off Location |
City | List of Cities |
State | List of States |
DSP | List of DSPs |
Order ID | Order ID |
Brand | Brand ID |
Store | Store ID - Store Name (list of stores) |
Exclude Order Status | Dropdown to select orders to be exluded by filter |
Customer Name | Name of the customer order belongs to. |
You can edit an existing order from the Deliveries Status page.
Fetch Logs are nothing but the logs being sent to DSPs and Tenants based on the change in the order status.
You can view the Fetch Logs under Status and Create Delivery Page.
This is how fetch logs looks like
The Fetch Logs Tablesection seeks information for below fields:
Field Name | Description |
---|---|
Sr | Serial Number of the logs since |
From | Tenants/DSP/DS name from where the log is sent |
To | Tenants/DSP/DS name to where the log is received |
Type |
The field contains the type of the Logs such as
below API Request API Response Webhook Request Webhook Response |
DS Status | Respective Order Status in Delivery Solution |
DSP Status | Respective Order Status in DSP |
Time | Time when the logs were generated |
Notes | Additional details |
User | User name from where the logs are being sent |
Order Cancellation can take place at any point of time in the order life cycle.
Businesss can export the order placed by them in CSV/XLXS Format.
Select Include Lifecycle Timestamp to include excluded order status
Provider Config page lets you manage and configure the available Delivery Service Providers based on your Business requirement.
DSP configuration mainly seeks API Key. Once DSP is configured, then only It can be assigned to the Store.
This is how Delivery Service Providers Page looks like..
The configuration of DSPs will require details such DSP API key, SMS/Email, webhooks and so on. These details vary depending upon the DSPs.
Once DSP configuration takes place, DSP needs to be added to the store, then and then only the store can send orders to the DSP
The Configuration Form seeks information for below fields:
Field Name | Description |
---|---|
API Key | DSP API Key is mandatory as it authenticates the API requests going to respective DSP from DS. This field is mandatory to map the DSP to store |
Webhooks | notification URL for sending status updates to DSPs. This field is mandatory to map the DSP to store |
SMS/Email | Email/SMS alerts to be sent to the DSPs. This field is mandatory to map the DSP to store |
There are other DSP specific mandatory fields which needs to be configured prior to adding it to the Store.
You can modify the details of existing added DSPs under Configure Delivery Service Provider section.
You can disable the existing added DSPs under Configure Delivery Service Provider section.
You can Configure Delivery Service Provider attributes in this section.
Private Fleet Configuration refers to a concept where Businesss have their own fleet of drivers for deliveries. Delivery Solutions as a platform allows Businesss to create and manage drivers, their delivery zones and shifts to be taken up by drivers. It also helps Businesss to manage, positioned, allocate and track deliveries of these drivers.
It Additionally, Delivery Solutions has a tie-up with Private Fleet which provides a mobile application for drivers to receive delivery details, and allows them to update the progress of the order.
An organizational unit (OU) is a subdivision into which you can place Drivers, Delivery Zones, Drivers Scheduling, and other units. You can create organizational units to mirror your organization's functional or business structure. Each domain can implement its own organizational unit hierarchy..
Similarly, Delivery Solutions allow to create multiple Org Units and Zones where you can create and schedule Drivers' shifts.
Create Organisational Unit as a part of Private Fleet Configuration
This is how Create Organisational Unit Form looks like
The Organisational Unit Form seeks information for below fields:
Field Name | Description |
---|---|
Name | Name of the Organisational Unit |
Description | A brief description about the Organisational Unit location |
Timezone | Timezone in which the OU present |
Update an existing Organisational Units as a part of Private Fleet Configuration
Enable/Disable an existing Organisational Units as a part of Private Fleet Configuration
Create Zones under Organisational Units
This is how Create Delivery Zone Form looks like
The Organisational Unit Form seeks information for below fields:
Field Name | Description |
---|---|
Organisation | Organisational Unit |
Name | Name of the Delsivery Zone |
Description | A brief description about the Delivery Zone |
Update an existing Delivery Zone as a part of Private Fleet Configuration
Enable/Disable an existing Delivery Zone as a part of Private Fleet Configuration
Search an existing Delivery Zone under an Organisational Unit
Manage Delivery Slots schedules under Delivery Zones
Create and modify delivery slots
This is how Scheduling Page looks like
The Organisational Unit Form seeks information for below fields:
Field Name | Description |
---|---|
Organisation | Organisational Unit |
Delivery Zone | Delivery Zone |
Week | Scheduling Week |
Start | Start Time of Delivery Slot |
End | End Time of Delivery Slot |
Capacity | Number of Items |
Import multiple Delivery Slots schedules through csv/Xlxs File
Export multiple Delivery Slots schedules in csv/Xlxs File
Delivery Solutions allows you to manage drivers under Private Fleet configurations
Create a new driver under an organisational unit.
This is how Drivers looks like
The Create Driver Form seeks information for below fields:
Field Name | Description |
---|---|
First Name | First Name of the Driver |
Last Name | Last Name of the Driver |
Driver External ID | Driver’s Unique Identification Card |
Organisation | Driver’s Organisation |
Driver’s Email Address | |
Phone | Driver’s Phone Number |
Notification | SMS/Email Notification based on the checkbox checked in the form |
Password | Driver’s Password |
Status | Driver’s Status as Active if Checkbox is checked in the form |
Edit an existing driver under an organisational unit
Search an existing driver under an organisational unit
Search an existing driver under an organisational unit
Orchestration enables stores to have multiple options of delivery providers. Basically, store admin can compare cost and time estimates of multiple DSPs and can manually choose any one of them for delivery or they could configure set of rules to automatically select the best option for them from available DSPs.
Rules might require additional conditions to be set in order to create criteria/scenarios for DSP/DispatchType/ReleaseType selection. These rules/conditionas can be created using various attributes of orders such as standard, custom, premium, coverage area and combiniation of attributes.
This section focuses on the use of these attribites under orchesrtation
As per the Orchestration, all the orders be it New or Edited has to go through the Orchestration Rule.
Once the suitable DSP is selected for an Order, Rule is supposed to check the Release Order Settings before it dispatches the order to DSP. This section lets you manage those orders whose DSP has been selected but requires further conditions before it is disptached.
One can schedule a dispatch of an order through this section. The scheduled order will stay with Delivery Solutions in "Pending Release" status untill It fulfills certain conditions set in the scenarios.
Please note, Immediate option will immediately dispatch the order to DSP. Once an order is dispatched, It cannot be edited. While "Pending Release" order gives you an advantage to edit an order before it dispatched to DSP
If there are no Release Order Settings scenarios created under this section, Orchestration Rule will automatically follow the Default Release Settings.
Unlike standard attributes there are premium attributes such as Delivery Distance which allows you to orchestrate and select DSP, Dispatch Type and Release Type.
Since this attribute requires additional calculations in order to fetch distance (in Miles) between pikcup and develiery address, opting this feature will incur additional charges.
Below is an example of how this attribute can be used to set conditions under rules.
There are standard orderd attributes of every order which can be used to set business rules.
Order attributes can be defined in Package area while placing an order under Create Delivery section under Deliveries as shown below.
These attributes can be used further in Orchestration to compare them with DSP attributes.
Attribute | Description |
---|---|
For Order Value |
Order value is compared with package value if this attributes is selected as a rule. Locate Package Value in Order:
|
When Order Has Alcohol |
The order contains Alcohol or not is checked with Order Details if this attribute is selected as a rule. Locate Package Content in Order:
|
When Order Has Beer Or Wine |
The order contains Beer/Wine or not is checked with Order Details if this attribute is selected as a rule. Locate Package Content in Order:
|
Number Of Packages |
Based on the number of packages in an order a rule can be set to select a particular DSP. Locate Package Content in Order:
|
Weight Of Packages |
Based on the weight of packages in an order a rule can be set to select a particular DSP. Locate Weight of Packages in Order:
|
Has Tips |
Few DSPs accepts the Tip for delivering an order to a customer. Businesss can set the rule to check whether order contains tip or not. Locate Package Value in Order:
|
Is Apartment |
Few DSPs Locate Package Value in Order:
|
Use Elastic Delivery options to write complex conditions based on number of orders. The Elastic Delivery filters DSPs by applying rules on Number Of Orders, Number of Orders per Zones, Number of Orders per Stores, Number of Units per hour and so on.
Function: Number of Orders
Sample: First five orders in last one hour should go to Private Fleet delivery, and 6th order onwards should go to third party DSP.
Service Coverage Attributes are nothing but the Boundary Attributes of Pick Up Locations such as BoundaryTags. These attributes can be used to orchestrate and select DSP, Dispatch Types and Release Types.
Store Boundary define the coverage of a Pick Up Location. Such Boundaries can be given a tag name.
This is how Store Boundary tags can be used in conditions under Rules.
Custom Order Attributes created in Attributes section under Business section can also be used to orchestrate Dispatch Settings, DSP Selections and Release Settings.
They are available in the same dropdown list where other order attributes are present.
Visit Attribute Page under Deliveries section for more details about Order Attributes.
Attributes and functions have their own data types corresponding operators and values
There are 4 data types of attributes
Data Type | Description | Operator |
---|---|---|
String | Holds values in alphabets | Equal to Not equal to |
Number | Holds Positive Numeric Value |
<: Less Than > : Greater Than = : Equals To |
Boolean | Holds True or False value | is |
Array | Holds Array of values in String or Numeric | Equal to |
Dipsatch Rules are mainly created to orchestrate the orders prior to getting dispatched to DSP for Estimates. Rules can be set to decide whether orders are required to be released for estimates immediately/manually/schedules basis.
A default DSP Rule Package gets created as soon as a new Business gets created, at the same time default dispatch settings is tagged to the rule. If there are no custom rule package created, all Pick Up Locations automatically falls under Default Package Rule. All the orders placed to the Pick Up Locations will use Default Rule Package for Dispatch.
This is how Dispatch Rule page looks like...
There are 3 variants of Dispatch Types as mentioned below.
Dispatch Type | Description |
---|---|
Immediate | Immediate Dispatch type orders will be immediately dispatched to check for estimates/place order with DSPs. |
Manual | Manual Dispatch type orders can be saved in Delivery Solutions. Such type of orders further can be manually placed with DSP, untill then they will stay in Pending Dispatch status. |
Schedule | Scheduled Dispatch Type orders can be scheduled to be release to DSP to seek their estimates. Such orders can be scheduled with certain minutes before/after Pickup Start Time and Dropoff End Time. Time. |
Delivery solutions allow you to create packages and set dispatch rules and dispatch type preferences based on your requirement
Update the existing scenarios by following instructions as below
Delete the existing scenarios by following instructions as below
Delivery solutions allows you to delete existing dispatch rule packages..
Dispatch Rule cannot be deleted if it is assigned to one of the Pick Up Locations. Click on View Assigned Pick Up Locations button as shown below to check assigned locations to the dispatch rule.
It is mandatory to remove all assigned Pick Up Locations to delete the dispatch rule.
Businesss can setup dynamic and complex rules for selecting best DSP from all the estimates received from different DSPs associated with themselves. Such decision is taken care by the Rule Engine based on the predefined rules set by Businesss.
A default DSP Rule Package gets created as soon as a new Business gets created. If there are no custom DSP Rule Package created, all Pick Up Locations automatically falls under Default Package Rule. All the orders placed to the Pick Up Locations will use Default Rule Package for Dispatch.
This is how DSP Rule page looks like...
Delivery solutions allow you to create packages and set business rules and dsp preferences based on your requirement
Delivery solutions allow you to filter DSPs based on their capabilities. Here it generally acts as a hard gate for filtering DSP based on the rule set under this section. All the DSPs not falling under the condition set in the Compliance section will be filtered out first.
This is how Compliance section looks like
Compliance | Description |
---|---|
Max Estimate $ | Businesss can filter DSPs based on their Estimate Amount. The amount in the input box beside the checkbox will set the maximum Estimates Amount from DSPs to be considered for further selection. DSPs which are exceeding the estimated amount provided in the input box will get discarded and only those DSPs will be shortlisted whose estimated amount is less than the amount mentioned in this rule |
Match Delivery Window | Businesss can set a rules to strictly follow Pickup and Drop Off Time window for Order Delivery by checking this checkbox. This rule will check the Order Delivery Time Window with the Delivery Time Estimates given by DSPs. DSPs which are not able to deliver the order as per the Delivery Time Window mentioned in the order will get discarded and only those DSPs will be shortlisted who can deliver the order within the Delivery Time Window |
Package Accept Package Weight | Every DSP has their own Package Weight Limit they deliver. Businesss can set the rule to cross check the Package Weight Limit with DSP’s package weight limit. DSPs which are not able to deliver the order having package weight exceeding their max package weight will be discarded and only those DSPs will be shortlisted who can deliver the order with the package weight mentioned in the order. |
Deliver Alcohol | Few DSPs do not facilitate delivery of alcohol/alcoholic products. Businesss can set the rule to filter the DSPs who do not deliver the alcohol/alcoholic products by checking this checkbox. |
Deliver RX | Few DSPs do not facilitate delivery of medicines and drugs. Businesss can set the rule to filter the DSPs who do not deliver the medicines by checking this checkbox. |
Order of Preference lists down all the configured Delivery Service Provider under a business. In absence of custom rules, this preference will be considered for DSP selection.
DSP Preference comes into the picture if there are no scenarios defined under a default/custom DSP Rule package.
Order of Preference for DSPs can be overridden in custom rule scenarios.
In case scenarios have been defined, It takes first preference over DSP Preference.
This is how custom DSP preference looks like under scenarios.
Update the existing scenarios by following instructions as below
Delete the existing scenarios by following instructions as below
If the condition set in scenario is met. Businesss can define set of actions to select the DSPs.
If the condition mentioned in the scenario is met then DSP will be further selected based on the ETA provided by them. The best suited DSP will have the Estimated delivery time shortest compared to all other DSPs. Otherwise, Businesss can set default action in “else default to” part.
If the condition mentioned in the scenario is met then DSP will be further selected based on the DSPs arranged hereby as per the Business’s preference. Otherwise, Businesss can set default action in “else default to” part.
If the condition mentioned in the scenario is met then DSP will be further selected based on the estimates amount given by them. The best suited DSP will have estimated amount lowest compared to all other DSPs.. Otherwise, Businesss can set default action in“else default to” part.
If the condition mentioned in the scenario is met then DSP will be further selected based on the order of prefernces set in the rule.
Delivery solutions allow you to delete existing packages or remove business rules and dsp preferences based on your requirement.
DSP Rule cannot be deleted if it is assigned to one of the Pick Up Locations. Click on View Assigned Pick Up Locations button as shown below to check assigned locations to the DSP rule.
It is mandatory to remove all assigned Pick Up Locations to delete the DSP rule.
Release Rules are mainly created to orchestrate the orders which has passed the phase of Estimates and are ready to be dispatched to DSP. Release Rules can be set to decide whether orders are required to be placed with DSP immediately/manually/schedules for further processing.
A default DSP Rule Package gets created as soon as a new Business gets created, at the same time default release settings is tagged to the rule. If there are no custom rule package created, all Pick Up Locations automatically falls under Default Package Rule. All the orders placed to the Pick Up Locations will use Default Rule Package for Release.
This is how Release Rule page looks like...
There are 3 variants of Release Types as mentioned below.
Release Type | Description |
---|---|
Immediate | Immediate Release type orders will be dispatched to DSP immediately, Once the order is dispatched to DSP, you cannot modify the order. |
Manual | Manual Release Type orders will sit with Delivery Solutions untill it is manually released to DSP. |
Schedule | Schedule Release Type orders can be scheduled for dispatch to DSP for further processing. Such orders can be scheduled to be dispatch based on their Pickup Start Time and Dropoff End Time. |
Delivery solutions allow you to create packages and set release rules and release type preferences based on your requirement
Update the existing scenarios by following instructions as below
Delete the existing scenarios by following instructions as below
Delivery solutions allows you to delete existing dispatch rule packages..
Release Rule cannot be deleted if it is assigned to one of the Pick Up Locations. Click on View Assigned Pick Up Locations button as shown below to check assigned locations to the dispatch rule.
It is mandatory to remove all assigned Pick Up Locations to delete the dispatch rule.
Assign your rules to Store or Group of Stores.
Any Rule Package designed in the Rules Page under Orchestration further can be assigned to Store or Group of store to enable them to follow the same.
You can assign DSP, Dispatch and Release Rules as below.
this is how the rule assignment looks like whenever you land on the page
Group is nothing but the collection of stores. All the stores under the group by default inherits the business rule package which is assigned to Group.
Instead of creating a group of stores. Businesss can also assign business rules to stores directly.
Double Click on Group Name to Rename the name and hit Enter
Businesss can generate labels to be sticked on the orders before delivery. Our Labeler service generates labels in PDF format based on business's configuration for their labels (logo, elements, etc..). It can be generated by a direct call to our labeler service URL. Currently Labels are required to be generated within 30 seconds as it has a 30 second timeout.
Labels Configuration
Label Preferences can be set at each Business level. Labels can be generated by Delivery Solutions or Delivery Service Provider. Delivery Solutions provide option to opt Both.
Page size can also be set under this section.
This is how Labels Configurations Form looks like
Label FormThe seeks information for below fields:
Field Name | Description |
---|---|
Label Type | Type of the Label to be shown on Label. such as Single Multiple Both Single & Multiple |
Corporate Logo | Upload Business Logo of recommended size 300px * 200px |
Order Number | DS/External Order Number based on the settings set under Profile. |
Customer Name | Customer Name whom order needs to be delivered |
Delivery Instruction | Delivery Instruction for Driver |
Apartment Number | Apartment Number mentioned while placing order |
Barcode | Barcode to be shown as per the type configured |
Delivery Date & Time | Date and Time of Delivery |
DSP Order Number | Order Number generated by DSP |
Phone Number | Contact Number of the Business |
Customer Address | Customer Delivery Address including City, Zip, State |
Package Content | Content in Package as selected in Package Details section while placing order |
Pickup Instructions | Store or Pick Up Locations Instructions for Driver |
Barcode Type | linear pattern for encoding data – black bars and white spaces
Type 39 - Lower Data Density Type 128- Higher Data Density |
Description | Package Description. |
Custom Attributes | Custom Attributes can be printed on Labels. |
Sample Label
This is how Sample Label looks like
Notifications section helps you in setting up SMS or Email notification for Customers.
This is how Communication Page looks like
There are two sections under this page.
Settings section shows the sender name and sender id set for customer notifications.
List section lets you create email and sms notifications.
Label FormThe seeks information for below fields:
Field Name | Description |
---|---|
Assign | Notification can be set at 2 level and will get inheritted to subsequent layer.
Brand: Select this radio button to enable notification to all stores under the brand. Pick Up Location: Select this radio to enable notification to all orders under the pickup location. Assigned All: This toggle remains enabled by default and notifications applies to all store/orders. |
Notification Preference | SMS: Check this checkbox to enable SMS notifications. Email: Check this checkbox to enable Email notifications. |
Apply | Status: Order status for which notification is to be sent. DSP: DSP for which notification is to be sent. Assigned All: Enable respective toggle to set notifications for all status/dsp. |
Email: | Subject:This option is only available for Email. Visual Editor:Visual Editor to design the template for Email. Code:HTML Code to design the template for Email. Preview:To view the preview of the code/visual editor. |
SMS | SMS text to be sent to customer in SMS. |
Fields | Eligible fields to be used in template. Drag and Drop these fields in pallette in order to use them. |
Live tracking feature enables you to provide your customers with real-time driver locations and ETAs which are presented in an aesthetic and fully customized web tracking experience.
Live Tracking page is mainly divided into 3 sections.
Live tracking configuration page allows you to configure the fields to be shown on the Order Tracking page.
This is how Live Tracking Page looks like
Field Name | Description |
---|---|
Pick Tracking | Select the preference of Order Tracking.
Delivery Solutions: Delivery Service Provider: DSP Prefferred: |
Pick Your Theme | Select a theme for the tracking page. |
Color | Customize the color of the page and font to match with your frontend.
Primary Color: Color to be used to show Order Number. Secondary Color: Color to be used to show Estimate Delivery Time Background Color: Background color of the tracking page. |
Live Tracking Map | Customize the markers on the map.
Show Details On Marker: show details about customer address, dsp name etc on marker. Business Marker Logo: Use Business logo as a Store Marker. Provider Marker Logo: Use DSP logo as a Driver Marker. |
Bullet Start Bar | Customize the Order details shown on the top of the page.
Status: Show Order's current status Show Event Time: Show the time of order statuses. Show Estimated Time: Show estimated delivery time. |
Header | Customize the text to be shown on header.
Title: Add Title of the page Eg. XYZ's Order Tracking Alignment: Set alignment of the Title. |
Business Logo | Upload a business logo to show as a Store Marker and on the top of the page.
External Link: An external link of the image. |
Dropoff Details | Select the dropoff fields to be shown on page.
Customer Name: Customer Name associated with the order. Customer Phone: Phone Number associated with the Order. Customer Email: Email Address associated with the order. Customer Address: Delivery Address associated with the order. Delivery Instructions: Delivery Instructions associated with the order. |
Pickup Details | Select the pickup fields to be shown on page.
Store Manager Name: Customer Name associated with the order. Store Phone: Phone Number associated with the Store. Store Email: Email Address associated with the Store. Store Address: Delivery Address associated with the Store. Pickup Instructions: Pickup Instructions associated with the Store. |
Driver Details | Customize the details you would like to show about driver.
Driver Name: Name of the Driver Driver Phone: Phone Number associated with Driver. Vehicle: Vehicle Number of the Driver. Provider: Name of the Provider. |
Order Details | Customize the details you would like to show pertaining to order.
Order Value: Order Amount Order Type: Type of order such as Delivery, Curbside and Pickup. |
Custom Attributes | Customize which order attributes you would like to show |
Footer | Customize the details you would like to show in bottom of the page.
Title: Title can be the business name. Alignment: Set alignment of the Title. Terms & Conditions: Your business's terms and conditions page URL. Privacy Policy: Your business's Privacy Policy's page URL. Copyrigh: Your business's Copyright text or page URL. |
Customize Tracking Page | Customize the details you would like to show for the page.
Favicon: Your business's favicon to be shown on browser. Tab Title: Name to be shown on Browser's tab. Google Analytics Tracking Code: Google Analytics tracking code if any. |
Customer Proximity page allows you to configure the fields to be shown on the customer app. This configuration applies to customers who preferred curbside or in-store pickup.
Field Name | Description |
---|---|
Pick Your Theme | Select a theme for the tracking page. |
Color | Customize the color of the page and font to match with your frontend.
Primary Color: Color to be used to show Order Number. Secondary Color: Color to be used to show Estimate Delivery Time Background Color: Background color of the tracking page. |
Update Your Logo | Upload a business logo to show as a Store Marker and on the top of the page.
External Link: An external link of the image. |
Customization | Allow Call: Customer can call driver.
Pre Authorized URL: dynamic customer tracking URL along with token and order information. Allow ETA Updation: ETAs to be allowed to be updated. |
Feedback Questions | Add feedback questions. |
Define Active Orders | Customize the way active orders should be shown.
Via Status: based on the status of the orders. Via ETA: based on the Customer's ETA. |
Advertisement | Allows you to advertisement in the page.
Advertisement Image: Upload the image of the Advertisement. Click Through URL: URL to be redirected on click of Advertisement Image. |
Customize Tracking Page | Customize the details you would like to show for the page.
Favicon: Your business's favicon to be shown on browser. Tab Title: Name to be shown on Browser's tab. Google Analytics Tracking Code: Google Analytics tracking code if any. |
Custom Domain page allows you to add your business domain in the tracking page URL.
Field Name | Description |
---|---|
Domain | Business Domain |
Our Service Consumptions dashboard shows a high level view of API usage. Service consumption is mostly measured through Delivery Assurance and Labeler API calls.
This is how Service Consumptions dashboard looks like
Service Consumptions uses below filters
Field Name | Description |
---|---|
Service |
List of Services called
|
Date Range | The range of dates between which a particular service is called. |
Time Zone | A specific timezone of the date range. |
Requests |
Type of Requests
|
Create Users, Roles and Permissions under this section
Role is a group of related skills with a level of authority to perform a given task. The higher the Role the higher the level of acces and permissions to the Delivery Solutions Pages and Modules.
Role comprises set of responsibilities such creating a Role/Staff under the role and assign permissions to the same.
Create a new Role and assign privilege to the group in this section.
This is how Add New Role page looks like
Add New Role form seeks information for below fields:
Field Name | Description |
---|---|
Role Name | Unique name of the Group |
Template | Templates are predefined set of access on modules given to a specific role. |
Create a new group and assign privilege to the group in this section.
Businesss can delete the existing Roles
Instead of deleting the group. Make the group inactive in just one click
Businesss can view the permissions set for the group in this section
Delivery solutions allow you to manage Users and their credentials.
Create a new user and set the credentials for the same.
This is how Create New User page looks like
Field Name | Description |
---|---|
Name | Name of the user |
Email Address of the User | |
Password | Alphanumeric 8 Digit password |
Confirm Password | Confirmation of the password |
User Role | Group user will be a part of |
Set as Super Admin | User will be given Admin level access if the toggle button is enabled |
Business Admins can edit the basic details of the user such as Name and Role.
Businesss can delete the existing users.
Instead of deleting the user. Make the user inactive in just one click.
There are various role templates already available in DS which can be utilised by Account Managers.
Below are the role templates created in Delivery Solutions.
Account Manager can handle multiple businesses under this role. This role has the highest level of permissions.
Account Manager has access to all Business APIs. Thus He/She needs to mentioned AccountID (Tenant ID) of business at the time of creating store or order under the business.
Below are the default permissions given to the Account Manager
Billing Processor has a similar level of access as Account Manager. Billing Processor can view and Edit the businesses created by Account Manager
Below are the default permissions given to the Billing Processor
Platform Admin has access to create and manage businesses under this role. Platform Admin can navigate to Account Settings, Businesses, Create Business pages and can modify the appropriate details.
Please note while creating business, Platform Admin can select for which modules he wants to give access to and for which modules he wants to restrict access for that particular business and users. By restricting access to particular modules, business users will not be able to utilize that module in their day to day activity, for example if Private Fleet module is restricted to any particular business, that business will not be able to use their own fleet of drivers to deliver orders through Delivery Solutions.
Below are the default permissions given to the Account Manager
Business Admin can configure all business related modules which local to the business, He/She cannot modify other Business's brand, stores. He/She can also configure Brands, Stores, Automatic retries for failed orders in case of temporarily network failure at DSP
Below are the default permissions given to the Account Manager
Brand Admin has access to all stores, orders falling under the brand. Brand Admin cannot modify or view the orders pertaining to other Brands.
Below are the default permissions given to the Brand Admin
Store manager has access to only Stores pertaining to his account. Store Manager can only view the boundaries of other stores and can edit only stores pertaining to its account.
Below are the default permissions given to the Store Manager
Customer Service manager has the minimum level of access to the modules and pages. Such Role has only access to view the modules and pages
Below are the default permissions given to the Customer Service.
Delivery Solutions allows to generate various reports to summarize a large dataset in visual form. This will help Businesss to clarify the trends, estimate the key values at a glance and permits a visual check of the accuracy and reasonableness of calculations.
All the reports can be generated based on the key filters provided in the filter tab.
This is how the filter tab looks like on all the reports.
Field Name | Description |
---|---|
Date | Date filter allows you to generate reports based on the below criteria: Last 7 Days Current Month Date Range List of Months other than current month |
State | List of States where Store and Order lies. |
DSP | Orders with DSPs which Business has configured for order delivery. |
On Time Delivery Report shows the average delivery time between the DSP and delivery addresses in Percentage. The On Time report presents the data in form of Mean Graph where central value is the average of delivery time.
The Higher the mean central value, the more the order delivery on time. Filters of the report allows you to generate the report based on the month, State and Store and DSP.
Select the DSP name in the Report to remove its data from the graph.
This is how the report looks like.
Order Density Report shows the data for regions where DSPs were able to deliver the order successfully. The density data are plotted on the map with store markers and their respective boundaries where orders were delivered successfully by DSPs
Filters of the report allows you to generate the report based on the month, State and Store and DSP. The available checkboxes above the map can be helpful to omit boundaries and stores upon deselection.
This is how the report looks like.
Market Opportunity Reports shows the addresses from where the order requests came but the location is out of DSP and Store coverage. The data are shown in form of heat diagram having red and orange dots as a markers. Red dots indicates the addresses which are out of Store and DSP coverage. Orange dots indicates the addresses which are in Store boundary but not in DSP coverage area.
Filters of the report allows you to generate the report based on the month, State and Store and DSP. The available checkboxes above the map can be helpful to omit boundaries and stores upon deselection.
This is how the report looks like.
Order Proximity Report shows the average distance between the stores and customer addresses in Miles. The Proximity report presents the data with rectangular bars with heights or lengths proportional to the values that they represent.
The Higher the bar, the higher the amount of distance of delivery addresses from the store. Filters of the report allows you to generate the report based on the month, State and Store and DSP.
This is how the report looks like.
Demand pattern analysis is an emerging area in supply chain management (SCM) that analyzes customer and demand data to better predict demand across multiple time horizons in a demand-driven value network. Similarly Demand Pattern Reports shows number of Orders placed on Daily(hourly),Weekly,Monthly and Quarterly basis.
The Higher the bar, the higher the number of deliveries took place on the mentioned date. Filters of the report allows you to generate the report based on the month, State and Store and DSP.
Select the day in legends in the Report to remove its data from the graph.
This is how the report looks like.
Order Delivery Date can be different from the Order Created Date since Delivery Solutions allow to schedule the orders beforehand.
Two ReportsCreated Date Vs Delivery Date delivery report shows the number of orders delivered on the same day when order was placed with number of orders delivered on the next day. The data is presented with 2 rectangular bars adjacent to each other showing the delivery data.
The Higher the bar, the higher the number of deliveries took place on the mentioned date.Filters of the report allows you to generate the report based on the month, State and Store and DSP. Select the day in legends in the Report to remove its data from the graph.
This is how the reated Date Vs Delivery Date Creport looks like
Created Time Vs Delivery Time delivery report shows the number of orders delivered within how many hours from the time the order was placed. The data is presented with stacked area chart.
The broader the area, the higher the amount of time deliveries took place. The higher the graph, the higher the number of orders. Filters of the report allows you to generate the report based on the month, State and Store and DSP. Select the day in legends in the Report to remove its data from the graph.
This is how the Created Time Vs Delivery Time Creport looks like
Average Order Value Report shows the average order and tip amount of the Orders placed on Daily(hourly),Weekly,Monthly and Quarterly basis.
The Higher the bar, the higher the number of order amount and tips received on the mentioned date. Filters of the report allows you to generate the report based on the month, State and Store and DSP.
Select the day in legends in the Report to remove its data from the graph.
This is how the report looks like.