Skip to main content

Introduction

Overview​

Welcome to the AiFi Third-Party Integration Guide! This guide provides a comprehensive walkthrough of the steps required to implement and integrate third-party vending machines with the AiFi system. Third-party machines refer to any vending machines that communicate with AiFi using a specific protocol. Examples of such machines include:

  • Tobacco vending machines
  • Coffee vending machines
  • Sandwich vending machines

Common scenarios​

info

For clarity and ease of understanding throughout this document, we will use the example of a "coffee machine" to represent third-party machines.

This guide focuses on some common scenarios used in AiFi retail stores. The following two use cases are the most common.

User Scenario 1​

  1. The customer approaches the coffee machine.
  2. The customer selects a coffee option and clicks the START button on the coffee machine’s screen.
  3. The customer waits while the coffee is prepared.
  4. The customer takes the cup of coffee and either leaves the store or continues shopping.

User Scenario 2​

  1. The customer approaches the third-party machine.
  2. The customer selects a coffee option and clicks the START button on the coffee machine’s screen.
  3. While the coffee is being prepared, the customer continues shopping.
  4. The customer returns to the machine, takes the cup of coffee, and either leaves the store or continues shopping.

Assumptions​

  • The system assumes that when the START button on the coffee machine is clicked, the AiFi system identifies the customer associated with the order.
  • The AiFi system assigns the coffee order to the customer whose hand had the highest probability of interacting with the coffee machine screen at the exact moment the order was placed. This interaction is determined using a timestamp provided by the coffee machine.

In this context, the "moment of order" refers to the instant when the START button is pressed on the machine.