3rd Party Integration
This outlines the information and the steps that are needed to familiarise oneself with the Doshii interface, prior to and during it's implementation.
The content is targeted at Resellers and swiftpos Venue Administrators who have a sound knowledge of and experience with swiftpos. For further information or assistance, please contact your swiftpos Reseller or swiftpos Support.
Subjects ▼
About ▲ ▼
- Available In?
- What is it?
- What Is Not Supported?
- What Is Required?
- What Is Supported?
- What To Consider?
- When Is It Used?
Available In? ▲ ▼
- swiftpos
- swiftpos V10.72.5+
What Is It? ▲ ▼
The swiftpos Doshii interface facilitates the integration of a Venue's swiftpos with Doshii. Doshii is middleware, that is designed to get a Venue’s customer-facing apps and back-of-house systems talking to each other. That means integrating, a variety of the apps, a Venue relies upon each day, to it's POS software. Doshii gets ordering apps talking to the POS, freeing up time to focus on patrons.
What Is Not Supported? ▲ ▼
- Available Servings are NOT supported.
What Is Required? ▲ ▼
- swiftpos v10.75.3+ for PIP (POS Initiated Payment) Type Integration.
- swiftpos V10.72.5+
- In Back Office:
- A swiftpos Location must be activated with the Submit Orders directly to POS Terminal option selected. Refer to How To Activate a swiftpos Location for more information.
- The Cloud Sync service must be installed and running. This should happen automatically once the Venue has Cloud onboarded. Refer to How To Cloud Onboard A Venue for more information.
- In Touch:
- Start Touch as the Administrator. Confirm this is the case and it is NOT being blocked. This can be done by checking the Window's logs.
- Ensure the Gateway Client Service and the POS API interfaces are listed in the POS Interfaces screen in Touch. These should be added automatically when activated with the Submit Orders directly to POS Terminal option selected.
- The Cloud Sync service must have a status of Running when viewed in the Table Tracking settings for the Table Tracking Master terminal.
- Confirm whether Ports/Firewalls/Whitelist need to be amended.
- In Venue Manager:
- Configure Venue Manager as per the steps outlined HERE.
What Is Supported? ▲ ▼
The Doshii interface supports the following Apps & POS features offered by Doshii:
- Business Intelligence
- In Venue Ordering
- Payments
- Pickup & Delivery
- Rostering
- Venue Management
When Is It Used? ▲ ▼
Any swiftpos Venue wanting to integrate swiftpos with Doshii's assortment of customer-facing apps. For example:
Bump-it, Chewzie, ClevaQ, Consillion, Deputy, DoorDash, DQ, EatClub, GloriaFood, Hey You, Hungry Pay, HungryHungry, Loaded, Local Pegs, LOKE, MUCUDU, me&u, Menulog, Mimu, MOBI, MyTab, Order Up, PayoPeiso, PLNTY, Quantaco Salesline, Restoke, Reva, Ritual, SABA, Skip, Smart Hospitality, Supply’d, Tabin, Tablevibe, TabSquare, TandaTip Sheet, Turnstyle, Uber Eats, Viability, Wageloch, Wayo, Windcave, Wirely, WOWAPPS, Yesterday, YQme, etc.
Integrating with Doshii maybe the bridge that provides less tech hassle, fewer points of failure and more quality time with patrons. Refer to the Doshii website for more information.
How To ▲ ▼
How To Get Started? ▲ ▼
Do as follows:
- Configure For A Data Only Type Integration?
- Configure For An Orders Type Connection?
- Configure For A PAT (Pay at Table) Type Integration?
- Configure For A PIP (POS Initiated Payment) Type Integration?
- Configure Venue Manager?
- Configure When Interfacing With Doshii For:
- How Is It Used In Touch?
How To Configure For A Data Only Type Integration? ▲ ▼
Used to send sales data to Doshii, for:
- Business Intelligence
- Rostering
- Venue Management
To configure, do as follows:
- Ensure the steps outlined in What Is Required above have been addressed.
How To Configure For An Orders Type Connection? ▲ ▼
Used when placing Orders/Sales initiated online via an ordering app or via Touch, for:
- Pickup & Delivery
- In Venue Ordering
To configure, do as follows:
- Ensure the steps outlined in What Is Required above have been addressed.
- In Touch:
- An Orders Master Touch terminal must be configured for the Location.
How To Configure For A PAT (Pay At Table) Type Integration? ▲ ▼
Used when paying for Orders/Sales initiated from an In Venue Table, for:
- Payments
To configure, do as follows:
- Ensure the steps outlined in What Is Required above have been addressed.
- In Touch:
- Table Ranges need to be configured for the Location. Refer to the Table Ranges button for more information.
- Floor Plans need to be configured to ensure Tables are visible to Doshii. The ID of the Floor Plan Layout will need to be noted so that it can be entered when configuring Venue Manager.
- The Allow POS API to Finalise Tables With No Remaining Balance option must be selected to ensure Doshii closes the Table once it has been paid for.
Notes ...
Other than the steps outlined in What Is Required and above, there are NO further setup required at Touch for Pay at Table type integration with Doshii. The Doshii integrated device will search for any open tables.
How To Configure For A PIP (POS Initiated Payment) Type Integration? ▲ ▼
Used when paying for Orders/Sales initiated online via an ordering app or via Touch using the Doshii PIP (#166) POS Key, for:
- Payments
To configure, do as follows:
- Ensure the steps outlined in What Is Required above have been addressed.
- Ensure NetPOS is registered for the MSL Solutions Connection interface. Refer to How To Register A NetPOS Interface for more information.
- Ensure the Doshii PIP (#166) POS Key has been added to the appropriate Keyboard Layout via the Designer. Refer to How To Add A POS Key To A Keyboard Layout for more information.
- The Cloud Sync service must be installed and running for the Table Tracking Master terminal in Touch.
How To Configure Venue Manager? ▲ ▼
To configure Venue Manager for Doshii (refer to How To Access Venue Manager for more information), do as follows:
- Select the Connect menu.
- From the Connect drop down list select the MSL Connect API Permissions option.
- Select the Samford Software option from the Select Integrator drop-down list.
- Ensure the PIPApplications and PIPTransactions permission options are selected.
- From the Select Integrator drop down list select the DoshiiOrderService option.
- Ensure the POS Presets and Ping Server options are selected.
- Still with the Connect menu selected, expand the Doshii menu and select the Reseller option to display the Doshii Reseller Configuration screen.
- Ensure the details are prefilled with the Reseller's details.
- For the initial setup, the Doshii API Key will need to be obtained from Doshii and entered into the Doshii API Key field.
- Ensure the Enable Doshii option is selected.
- Still with the Connect menu selected, expand the Doshii menu and select the Settings option to display the Doshii Integration screen's General tab.
- In the General tab:
- Enter the Doshii Venue ID provided by Doshii into the Doshii Venue ID field.
- Enter the ID of the Floor Plan Layout that will be used by Doshii into the Floor Play ID field.
- If required, select the Enable Stock On Hand option.
- Ensure the ID of the swiftpos Surcharge (NOT the PLU of the Surcharge Product) to be associated with surcharges, is entered into the Surcharge ID field.
- Select the Media Mapping tab:
- Ensure the Doshii Media are mapped as is appropriate to a swiftpos Media by entering the ID of the swiftpos Media opposite the associated Doshii Media.
- In the General tab:
- Ensure all of the above changes are saved.
How To Pay Using Doshii? ▲ ▼
Do as follows:
- In Touch terminal, add Items/Products to a sale.
- Select the Doshii PIP (#166) POS Key. Once selected, the following prompt will be displayed:
- Select the Use button to pay using the whole Subtotal Amount displayed. Otherwise, select the keyboard button to enter a preferred amount. Used when a partial payment is required.
- Select OK to submit the payment.
- If a partial payment was entered finalise the remaining balance using an alternative Media POS key. For example, Cash, EFTPOS, etc.
What To Consider? ▲ ▼
- There are a number of ways Venue's can integrate with Doshii when using the swiftpos Doshii interface. These are:
- Data Only - Used to send sales data to Doshii for:
- Business Intelligence
- Rostering
- Venue Management
- PIP (POS Initiated Payment) - Used when paying for Orders/Sales initiated online via an ordering app or via Touch using the Doshii PIP (#166) POS Key, for:
- Payments
- PAT (Pay At Table) - Used when paying for Orders/Sales initiated from an In Venue Table, for:
- Payments
- Orders - Used when placing Orders/Sales initiated online via an ordering app or via Touch, for:
- Pickup & Delivery
- In Venue Ordering
- Data Only - Used to send sales data to Doshii for:
- Reseller & Support Information
End of article. ▲