NorthStar 3rd Party Delivery enhances NorthStar Order Entry by extending our ability to integrate to 3rd party web ordering/delivery providers such as Uber Eats, Door Dash, PostMates, Grub Hub etc..
ECM Setup:
Navigate to the Sites and Groups section of ECM. Edit the site to enable N3PD.
Prerequisites:
- In "Integrations" tab > "Web Ordering API" tab > "API Settings" tab:
- Enable Web Ordering - Required. Select to enable (default: not selected). This setting will enable the site to receive online orders.
- Web Ordering Menu - Required. A value must be provided to this setting due to the current coded behaviors for NSOE. This setting will not supply the menu to 3rd Party Platforms enabled through N3PD.
- Web Ordering Alternate Payment Options - Required. A value must be provided to this setting due to the current coded behaviors for NSOE. This setting will not dictate the payment options for 3rd Party Platforms through N3PD.
- Web Ordering Areas - Required. A value must be provided to this setting due to the current coded behaviors for NSOE. This setting will not dictate the area for 3rd Party Platforms through N3PD.
- Web Ordering Tax Type - Required. The tax type must be configured, so that a tax value can be provided to NSOE if one is not provided from the 3rd Party Platform.
- Enable Account Level Feature Toggle "Media Sharing". Once enabled, deploy the site to trigger ECM to send the media data to 3rd Party Platforms.
- Note: Processing times vary with each platform, and some require approvals internally within their hosted systems - which can result in a delay for media items to show online through their end user portals.
- Then register the site's webhook to N3PD on behalf of the 3rd Party Delivery Platforms. The webhook is required in order to send menu data to the configured 3rd Party Platforms.
- Follow this doc to register the webhook: /wiki/spaces/PRODUCTTEAM/pages/2826469401
N3PD Settings:
- Enable N3PD platform - Select to enable (default: not selected)
- Share menu item media with delivery platforms - Enabling this setting will allow ECM to send media data to configured third party platforms. This setting requires the Account Level Feature Toggle "Media Sharing" to be enabled. Once enabled, deploy the site to trigger ECM to send the media data to 3rd Party Platforms.
- Note: Processing times vary with each platform, and some require approvals internally within their hosted systems - which can result in a delay for media items to show online through their end user portals.
- API key - Required field
- Default area - Required. Choose from dropdown list of areas from Web Ordering Areas selected above.
- Default payment option - Required. Choose from dropdown list from Web Ordering Alternate Payment Options selected above.
- Delivery fee menu item - Required. Choose from dropdown list of menu items for delivery fee. List
- Note: Drop-down list will be all menu items with "Open Value Non-Revenue" item type.
- Note: Drop-down list will be all menu items with "Open Value Non-Revenue" item type.
- Name - Pre-populated list of 3rd-party delivery platforms. Column is sortable.
- Area - Select area for each delivery platform from dropdown list of Web Ordering AreasAreas
- Payment option - Select payment option from dropdown list of Web Ordering Alternate Payment Options Options
...
- Web Ordering Tax Type - The tax type we will use for chowly since we use whatever tax Chowly sends us.
Menu(s) setup
...
The Delivery Platforms: DoorDash, Grub Hub, PostMates, and Uber Eats are available as an override to the default settings. The area configured to each platform will provide the area day part menu to the 3rd Party Provider.
Info title Delivery Platform Note In NSOE Server versions 4.9.1, 4.9.2, 4.9.3 and earlier versions of 4.9.4 the Delivery Platforms will need to be configured for the 4 available options. Otherwise, errors will be thrown due to a coding constraint in older versions of NSOE Server, which will prevent orders to come through to the POS.
Menu(s) setup:
- Confirm and configure the area to be used as the default and/or the additional "Delivery Platforms".
- The menu provided to each 3rd Party platform will be dictated by the "Menu" within the "Area Day Part Menu" configured to the "Area".
- All the same rules apply for day parts that normally apply for
- the POS (the days set up for day parts and the date range set up for day parts will still apply for the day part sent to
- 3rd Party Platforms)
- Separate doc on day parts here: Day Parts
- Seperate Separate doc on Area Day Part Menus: Area Day Part Menus (Edit an Area)
Deploy to the site once all settings have been set up and configured.
Note: The Chowly team will require a webhook from us in order to get this set up on their end. Here is the webhook to provide them - https://[WOAPI URL]/api/chowly/[siteid]
- It will then need to be registered so that the menu is sent to Chowly: /wiki/spaces/PRODUCTTEAM/pages/2826469401
Find the site id after navigating to Sites and Groups on ECM.
...
Find the WOAPI URL by editing a site → Integration tab → Web ordering API tab:
For Chowly Default Area and Default Payment Options, the API Settings must be checked for Web Ordering API > "Enable Web Ordering" and a default/available options must be selected for Web Ordering Areas and Web Ordering Alternate Payment Options:
Chowly Tab
- Enable Chowly platform - Select this to enable third party delivery.
- Send menu image to third party - Set media is sent to third party.
- Feature needs to be selected to access sending media to third parties.
- Feature needs to be selected to access sending media to third parties.
- API Key - Provided by Chowly.
- Default Area - Area in NorthStar that will be default for orders to be sent to.
- Default Payment option - Default payment type set for third party orders.
- Delivery fee menu item - Normally open value non revenue. (Differs per clientele)
- Delivery platform - Required assignments for areas and payment option.
- Note: The hours of operation for 3rd Party Delivery are controlled in area day parts menu for the area set up for that provider. DoorDash will buffer 20 minutes from the day parts end time.
Deploy the site once all settings have been set up and configured.
After the above is completed and the site deploy is sent, it is now on the 3rd Party Side, DoorDash, UberEats, GrubHub etc., to receive the info and process it. Processing times will vary depending on their resource availability. The fastest is within 1 minute and the longest seen up to 24 hours.