Online Ordering

OneTap API

The Appropo + OneTap API is a Windows service that acts as middleware between your OneTap POS and Appropo. It is required for integrations such as Xero.

Download

Latest version: 2025.10.21-1dda3b34

.NET Core Hosting Bundle is required before installing.

OS OneTap Download
64 bit Windows 17.02+ appropo-x64.zip
32 bit Windows 17.02+ appropo-x86.zip

Install

  1. Add IIS to Windows
  2. Install the .NET Core Hosting Bundle
  3. Download the Appropo zip and extract into C:\Appropo\
  4. Edit C:\Appropo\appropo-x64\appropo-x64\appsettings.json — set the database connection string, OneTap IDs, and a unique API key
  5. Open IIS Manager, right-click the Sites folder and select Add Website
  6. Set the site name to appropo-api and the physical path to C:\Appropo\appropo-x64\appropo-x64
  7. Set the binding to port 81 and click OK
  8. In Application Pools, select the site’s pool → Edit Application Pool → set .NET CLR version to No Managed Code
  9. Open http://localhost:81 — you should see the API documentation
  10. Open port 81 on your router and forward it to this computer’s IP

Update

  1. Copy config: C:\Appropo\appsettings.json to a safe location
  2. Stop the IIS site
  3. Download the new zip and extract into C:\Appropo\
  4. Replace the old folder with the new one
  5. Restore config to C:\Appropo\appropo-x64\appropo-x64\appsettings.json
  6. Start the IIS site
  7. Open http://localhost:81 to confirm the API is running

Changelog

2025.10.21

  • OrderModLine ordering fix

2025.03.18

  • EatinSectionId override

2024.09.15

  • Added TenderLine type and provider overrides for Online Orders
  • TENLINETYP added

2024.05.03

  • Bugfix build

2024.04.16

  • ONLINE ORDER 24.01 support

2023.06.09

  • ONLINE ORDER ETA label changes rolled back

2023.04.19

  • ONLINE ORDER Redeem Points 2 - Free Item
  • Merged <22.01 and >=22.02 builds

2023.03.19

  • EATIN spend limit

2023.02.21

  • EATIN uses “Eat In” section instead of Phone Order sections
  • EATIN can put orders onto existing table tabs
  • ITEMGROUPS added
  • CASHUP — add optional types to some fields

2022.11.21

  • OneTap 22.01 compatible build

2022.08.03

  • CASHUP include invoice line with non-zero actual amounts
  • CASHUP include super items and remove from food sales