Back to Olo.com

SSOS: Technical Overview


Updated

Background:

SSOS is a Windows-based application for receiving and printing online orders from Olo's platform. It’s an alternative to an integrated solution that’s quick and easy to get in place.

System Requirements:

  • Windows 7 or newer
  • TLS 1.2 enabled
  • .NET 4.5
  • Modest disk, memory, and processor requirements

Key Components:

SSOS consists of two Windows services that maintain connectivity with Olo’s platform, and a tray/WinForms user interface that notifies the user of new orders and prints these orders to a configured Windows printer. The services are running under the Local System account (this can be modified post-installation, if desired), and the UI is running under the user that installed SSOS.

Installation:

SSOS is distributed in a regular MSI package and can be installed manually using the simple wizard, or the installation can be automated using msiexec. The installation process asks where to install the software to (defaulting to c:\Program Files\Olo), and asks for a set of Olo credentials that identifies the restaurant.

Updates:

The reason for having two Windows services is that they are able to monitor as well as update each other. Olo is able to push out updates to SSOS on a location-by-location basis. These updates are automatically downloaded and applied without any manual involvement necessary.

Network Usage:

On startup, the Windows services will establish a connection to Olo’s platform using a two-step process:

  1. Connecting to Olo’s API over port 443 (HTTPS). This step results in a session key that’s used to encrypt subsequent communication.
  2. Connecting to Olo’s API over port 9292 (TCP). This connection is long-running and bidirectional. The data is AES 256 encrypted using the session key from step 1.

Note that all connections are initiated from within the restaurant network, and that no inbound ports must be opened. The computer on which SSOS is installed on must be able to make DNS lookups and make outbound connections to Olo’s API.

Orders are transmitted from Olo’s platform to SSOS using the long-running TCP connection that was established during step 2. If the TCP connection is interrupted, the service automatically reconnects, starting with step 1.

Suggested Hardware:

It is suggested to use a networked Epson TM-88V or equivalent printer to receive orders. This is not a requirement since any windows compatible printer will allow printing of orders through SSOS. Both hardware setups have shown stability. The network capability of the TM-88V allows for comparability to normal printed kitchen chit sizes, as well as mobility of the printer to a different location if desired.

SSOS Flow Diagram:

 

Didn't find what you need?

Submit a request to our Help Team and someone will
get back to you shortly.

Copyright © 2017 Olo. All rights are reserved.