Simphony Transaction Services Gen1

QikServe Integration Requirements

If you are interested in integrating your Oracle Sim2 POS with the QikServe Online Ordering service via STS Gen 1, please follow the steps below to get you set up. There are whitelisting requirements per platform, and then POS configuration fields that we will need. 

Please note you will need to first have Transaction Services enabled on your Oracle services before you can proceed with the integration.  Reach out to your Oracle contact for next steps.

 

Kiosk Whitelisting Requirements

Item

 

Environment

 

Method

 

Value

 

Purpose

 

QikServe Production Servers

Production

TCP/TLS

api.qikserve.net:443

api-us.qikserve.net:443

api1.qikserve.net:443

api2.qikserve.net:443

Access to QikServe Platform (Production)

QikServe Content Endpoint (Legacy)

ALL

TCP/TLS

qikserve.me:443

Legacy content endpoint

QikServe Content Endpoint

ALL

TCP/TLS

content.qikserve.net:443

Access to guest facing menu information, pictures, additional languages etc.

Logging and analytics

Production

TCP/TLSUDP

gateway.qikserve.net[50311-50319]

Gateway for logging and analytics

Local Services

All

TCP

localhost

Access to local PC

Kiosk management system

Production

TCP/TLSUDP

api-us.qikserve.net:443

kioskmanagementchef.qikserve.net:443

www.rubygems.org:443

Kiosk management

Ruby Libraries required for Chef

Kiosk Dependencies/Installers

All

TCP/TLS

qs-kiosk.s3.eu-west-1.amazonaws.com:443

Kiosk Dependencies/Installers

Windows Time Sync

All

UDP

time.windows.com:123

Automatically synchronises PC time

 

Canopy Device management

Item

 

Environment

 

Method

 

Value

 

Purpose

 

Leaf / Canopy

All

HTTPS

https://leaf-distribution.s3.amazonaws.com/

Download the installer packages for the 4 Canopy services

leaf_agent

leaf_services

leaf_sw_updater_aws

leaf_sw_updater_installer

 

Leaf / Canopy

All

HTTPS

https://leaf.gocanopy.io/events/v2/ OR

https://leaf.gocanopy.io/*

Canopy communications

Used by the kiosk to send events to Canopy cloud. e.g. kiosk health; config info; KPI monitoring

Leaf / Canopy

All

HTTPS

https://leaf-swu.gocanopy.io/

Canopy communications

Used to download QikServe managed software packages and updates

AWS / Canopy

All

HTTPS

https://s3.amazonaws.com/leaf-swu.gocanopy.io/*

Canopy resources

Repository for packages

AWS / Canopy

All

HTTPS

https://leaf-uploads.s3.amazonaws.com/

Canopy resources

Upload individual files from kiosk to Canopy, e.g. log files

AWS/ Canopy

All

HTTPS

https://leaf-downloads.s3.amazonaws.com/

Canopy resources

Upload individual files to kiosk from Canopy, e.g. config files

Splashtop

All

HTTPS

api.splashtop.com (Global and EU)

api.splashtop.eu (EU)

relay.splashtop.com
update-g3.splashtop.com / update.splashtop.com / sn.splashtop.com (for endpoints auto-update)

Port 443 needs to be open

Allows temporary remote access to a kiosk

 

Remote Access

Item

 

Environment

 

Method

 

Value

 

Purpose

 

Teamviewer

ALL

TCP/UDP

*.teamviewer.com:5938

Allows remote access to Customer endpoints


Mobile Platform Requirements 

Item

 

Environment

 

Method

 

Value

 

Ports

 

Purpose for Endpoint

 

QikServe EMEA Platform

Production EMEA

TCPHTTPSSOAP

52.48.161.145

POS Port (8080)

Allows connectivity from QikServe’s EMEA cloud to the customer POS

QikServe US Platform

Production (US)

TCPHTTPSSOAP

3.225.44.70

POS Port (8080)

Allows connectivity from QikServe’s US cloud to the customer POS

QikServe QA Platform

QA

TCPHTTPSSOAP

52.200.170.81

POS Port (8080)

Allows connectivity from QikServe’s QA cloud to customer POS

QikServe LOCAL

Developer - Local Environment

TCPHTTPSSOAP

185.100.69.235

POS Port (8080)

Allows connectivity from QikServe’s Developer instances customer POS

 

Optional Whitelist

Item

 

Environment

 

Method

 

Value

 

Purpose for Endpoint

 

Teamviewer

ALL

TCPUDP

*.teamviewer.com:5938

Allows remote access to Customer endpoints

Order Ready Board

Production EMEA

HTTPS

order-ready-board.s3.eu-west-1.amazonaws.com

 

QikserveL2TP VPN

DEV

TCPHTTPSSOAP

185.100.69.235:8080

Allows connectivity from QikServe’s Kiosk to external Api’s.
Currently used to communicate with EPL Coupon API


Transaction Service/POS connection details

  • Simphony POS version=
  • webServiceEndpoint=
  • employeeNumber=
  • revenueCenterId=
  • defaultTender=
  • orderTypes(DINEIN)=
  • orderTypes(TAKE_OUT)=

Once all of the above information is ready to be provided to QikServe, please reach out to your QikServe Customer Success Manager or Implementation Manager.