Product Recipe Customization Guide

New
  • Updated on Jan 12, 2026
  • 7 minute(s) read
Prev Next

Document Review 

This document is intended to introduce the possible options to configure in the product recipe. This document is taking kiosk series 3.5 as an example.

Picture 

 

The product creation includes 4 steps: 

  • Base info: the general product information shown in the customer order menu 

  • Consumable: the possible consumables, dispensing times, and default dispensing parameter values 

  • Recipe: the actual dispensing parameter values per add-on number 

  • Consumable dispense sequence: flexible consumable dispensing sequence can be set to support product taste/outlooking requirements 

Below at the detailed instructions. 

 

Base Info 

For series 3.5: 

  • Primary Cup: please select “12oz hot cup” if hot drink, please select “16oz cold cup” if cold drink 

  • Backup Cup: please leave it blank. 

Field Name 

Value Needed 

Description 

Kiosk Display Name 

Text 

Product name shown in the order menu. 

Product Name 

Text 

Product name used for operation management. 

Product Categories 

Multiple selections 

Belonged product category shown in the order menu. 

Image 

Image 

Product image shown in the order menu. 

Availability 

Single selection 

 

Primary Cup 

Single selection (12oz hot cup / 12oz cold cup / 16oz hot cup / 16oz cold cup) 

The cup type & size used for the product 

Backup Cup(s) 

Single selection 

It is optional. When the kiosk supports using another cup type as backup when one cup type does not work or run out, then this field can be selected with backup cup type. 

Number of Cups 

Numeric 

1 cup by default. 

2 cups are recommended for hot americano coz of high temperature of the drink 

Approx Drink Prep Time (s) 

Numeric 

It is used for estimating and scheduling the cup pickup time. 

Kiosk Type 

Multiple selections 

The kiosk type(s) which support(s) making this product. 

2. Choose Consumables 

The consumables are classified into 3 categories: base ingredient, mandatory ingredient, selectable (add-on) ingredient. 

 

2.1 Base Ingredient 

  1. Only for coffee bean and milk type 

  1. Customer can have options to select coffee bean type and milk type when ordering  

  1. Default base option for customer can be set  

  1. Exclusive between “base ingredient” and “other ingredient > cold brew” 

  2. Picture 

2.2 Other Ingredient > Mandatory 

  1. Consumable type excluded: coffee bean, milk type 

  1. Customer does not have options to pick when ordering 

  1. Different consumable types have different parameters as mandatory as below instructions: powder, the parameter value set will be used as the default value per row in the final permutation table, the actual dispensing value on machine will be the same as permutation table 

Consumable Type 

Example 

Powder 

  • Dispensing times/cycles are required to set 

  • 6 dispensing times at most 

 

 

“Hot Chocolate” product 

Picture 

“Matcha Latte 12oz” product 

Picture 

Syrup 

  • 1 dispensing time/cycle 

  • Dispensing time duration and volume are required to set 

  • Dispensing time duration (s), used for dispensing command device  

  • Dispensing volume (ml), used for inventory number deduction on server 

Picture 

Ice Cube, Cold Water 

  • 1 dispensing time/cycle 

  • They are dispensed from ice maker 

  • Weight (g) is required to set 

 

Picture 

Multiple Water  

  • 1 dispensing time/cycle 

  • They are dispensed from Blusoda Sparkling Dispenser or Marco Sparkling Dispenser 

  • Only one of Multiple Water can be selected for a product 

  • Dispensing time duration(s) and weight(g) are required to set 

  • Dispensing time duration is used for dispensing command device  

  • Dispensing weight (g), used for inventory number deduction on server 

 

 

Picture 

Cold Brew 

  • 1 dispensing time/cycle 

  • They are dispensed from cold brew machine 

  • When configuring a nitro cold brew product, the “cold brew” and “nitro cold brew” should be both selected 

  • The concentration ratio: please leave it as default value 1:0, coz the cold brew consumable needs to be mixed with water before refilling into container, the automatic cold brew mixer will be coming in future 

Picture 

 

2.3 Other Ingredient > Selectable (Add-on) 

  1. Consumable type included: milk type, powder, syrup 

  1. If the consumable is set as “selectable”, the customer will see it as an option for add-ons when ordering 

  1. Customer can add up to 6 add-ons among all kinds of add-ons in one product ordering 

  1. Customer can add up-to to 3 add-ons for each kind of add-on in one product ordering 

  1. There are 3 types of consumables can be set as selectable (add-on)  

milk add-on 

 

Picture 

powder add-on 

 

Picture 

syrup add-on 

 

Picture 

After all consumable info is set, please click “Generate Permutation” button and go next step “Recipe Settings” 

3. Recipe Settings 

Field Name 

Value Needed 

Description 

Eversys Index Weight Required 

Single selection 

Please set it as “Yes” if the product making needs Eversys Cameo/E4M machine and the product total weight validation by robot arm, after selecting it as “Yes”, otherwise please leave it as default “No”.  

There will be a “Everys Index Weight” column in the below permutation table if this field is set as “Yes”. 

RCC Milk Parameters Required 

Single selection 

 

Please set as "Yes" if milk is dispensed from the RCC milk foam machine, otherwise please leave it as default “No”. 

There will be a “Milk Sequence” column and “Add Milk Sequence” button in the below permutation table if this field is set as “Yes”. 

 

NOTE: For series 3.5E Please set “RCC Milk Parameters Required” as “No”. Coz there is no RCC milk module in 3.5E. 

 

Here are 2 settings for the final permutation table: 

 

The permutation table is the final recipe information that the kiosk will follow when dispensing based on the customer order. 

The permutation table rows are decided by base coffee bean type number, base milk type number, and max add-on number. For example, if there are 2 coffee bean types and 2 milk types selected in the base ingredient setting, and there are more than 1 consumable set as “selectable” (that means the possible add-on number will be from 0 to 7 in the customer order), then there will be 28 rows in all by all possible combinations (2*2*7=28). 

The permutation table columns are decided by the 1) base ingredient types and corresponding parameters and 2) mandatory ingredient types and the corresponding parameters. NOTE: Now mandatory powder type parameters are not included in the permutation table yet, instead they are controlled by per consumable edit in “container management > consumable”. 

Here is the instruction for all possible column fields in the final permutation table: 

Field Name 

Value Needed 

Description 

Coffee Bean 

/ 

It is from the base ingredient consumable setting. 

It is one of factors of the permutation table rows. 

Milk Type 

/ 

It is from the base ingredient consumable setting. 

It is one of factors of the permutation table rows. 

Total Complement Count 

/ 

It is from the selectable consumable setting. 

It is one of factors of the permutation table rows. 

If there are no selectable consumables, then no further row splitting in the permutation table. 

If there is 1 selectable consumable, then there are 4 rows split based on the base ingredient combination in the permutation table. That means the customer can choose 0-4 add-ons per product ordering. 

If there is more than 1 selectable consumable, then there are 7 rows split based on the base ingredient combination in the permutation table. That means the customer can choose 0-6 add-ons per product ordering. 

Eversys Index 

Numeric 

It is from base ingredient setting. 

Upon any base ingredient is set, then there will be this column. 

This value is the unique product identifier on the Eversys Cameo/E4M machine. Kiosk quotes he product index/id number from the coffee machine when making customer order. 

Eversys Index Weight (g) 

Numeric 

It is from "Eversys Index Weight Required = Yes”. 

It does not include cup and lid weight. 

It is one of factors for calculating the standard product total weight by kiosk. 

Please make sure this value is updated along with the recipe changes on the coffee machine. 

Coffee bean (g) 

Numeric 

It is from base ingredient setting. 

It is for Eversys Cameo/E4M. The actual base coffee bean quantity per product is set by the coffee machine offline.  

This value is used for server inventory deduction. 

Milk type (g) 

Numeric 

It is from base ingredient setting. 

It is for Eversys Cameo/E4M/milk dispenser. The actual base milk quantity per product is set by the coffee machine offline.  

This value is used for server inventory deduction. 

Mandatory Ingredients  

/ 

It is from the mandatory ingredient consumable setting. 

It shows all mandatory consumables set. 

It is one of factors of the extra columns in the permutation table. 

Ice Cube (g) 

Numeric 

It is used for per ice maker dispensing. 

This value is used for device command and server inventory deduction. 

Cold Water (g) 

Numeric 

It is used for per ice maker dispensing. 

This value is used for device command and server inventory deduction. 

Syrup name(s) 

Numeric 

It is used for per syrup dispenser dispensing. 

This value is used for device command. 

Syrup name(ml) 

Numeric 

It is used for per syrup dispenser dispensing. 

This value is used for server inventory deduction. 

Multiple water name (s) 

Numeric 

It is used for per multiple water dispenser dispensing. 

This value is used for device command. 

Multiple water name (g) 

Numeric 

It is used for per multiple water dispenser dispensing. 

This value is used for server inventory deduction. 

Milk Sequence > Milk quantity (s) 

Numeric 

 

It is from “RCC Milk Parameters Required = Yes”. 

It is used for per RCC milk dispenser dispensing. 

This value is used for device command. 

Up to 3 milk sequences per product. 

Milk Sequence > Milk temperature (°C) 

Numeric (40~65) 

 

It is from “RCC Milk Parameters Required = Yes”. 

It is used for per RCC milk dispenser dispensing. 

This value is used for device command. 

Up to 3 milk sequences per product. 

Milk Sequence > Milk texture (%) 

Numeric (0~100) 

 

It is from “RCC Milk Parameters Required = Yes”. 

It is used for per RCC milk dispenser dispensing. 

This value is used for device command. 

Up to 3 milk sequences per product. 

Sub Product Name (Also Receipt Name) 

Text 

It is used for identifying each possible base ingredient combination. 

It is also shown in the customer order receipt. 

Negative Error Tolerance of Total Weight (g) 

Numeric (Optional) 

 

It is used for product total weight validation if it is turned on the kiosk. 

 

4. Consumable sequence 

The consumable dispensing sequence is supported by series 3.5, not for self-service station series. 

Field Name 

Value Needed 

Description 

Consumable Dispense Sequence Required 

Single selection 

Default value: No. 

Default consumable sequence: Ice Cube -> Cold Water -> Coffee Bean -> Milk Type -> Cold Brew -> Bottled Syrups- > Multiple Water -> Powders. 

The consumable sequence customization is possible only when the robot kiosk uses single order mode without order making in parallel at the same time. 

NOTE: For series 3.5, must use single mode (Profile -> Kiosk Parameters) and must config the sequence. 

Consumable sequence number 

Numeric 

Consumable with smaller number will be dispensed first, larger number later, and identical numbers simultaneously. 

Please ensure that consumables dispensed simultaneously come from the same nozzle. 

Same sequence number, different nozzle, will dispense by default consumable sequence. 

Related articles