Extended properties are used to store any information that an administrator wants to save with a given element. Most commonly, extended properties serve as comments or attributes needed for integration with external systems (e.g., for r_k Delivery or r_k Kiosk PRO).

Settings for interaction with external systems through extended properties are configured separately for each system.

Additionally, extended properties are used for report generation. For example, the Payroll by Roles report uses extended properties of employee roles such as: hourly rate, shift rate, revenue share.

Property groups can be of two types:

1. Properties for orders— used when creating orders
2. Properties for references— used when creating directory elements

You can use existing (preset) element properties or create custom properties.

Preset Extended Property Groups

• Properties for orders 
  Preset properties in this group belong to the r_k Delivery module:
  Delivery version
  Order source
  Machine number
  Electronic queue number
  Delivery operator
  PrintACheck (Print receipt)
  Email
  SBP QR code (FPS QR code )
  Phone
  Read-only
  Fiscal order number
  Delivery expeditor
  
  • Correction Receipt Subgroup
    Preset properties in this group relate to Correction Receipt.
    GUID of corrected receipt
    FD number of corrected receipt
    Product return
    Correction date
    Prescription number
    Prescription
    Include in reports
• Properties for kiosk
  Properties in this preset group are created during installation and setup of self-service kiosks.
• Properties for references
  HTTP Delivery server address
  Proteins
  Head organization
  Fats
  TIN
  Calories
  Currency code (OKV)
  Nutritional value (PFC)
  Health record book
  Currency symbol
  Surplus subaccount
  Surplus account
  Shortage account
  Carbohydrates

• • IR: Parameters Subgroup
    Preset properties in this group are used in Interactive Reports.
    Revenue share
    Restaurant area
    Hourly rate
    Shift rate
    The preset properties "Revenue share", "Hourly rate", and "Shift rate" appear in the "Extended Properties" block in the "Employees" directory under employee role properties. This information is required for the "Payroll by Roles" report.
    The preset property "Restaurant area" is filled in the "Cash Stations and Devices" directory under restaurant properties in the "Extended Properties" block. This information is used for generating IO reports "Revenue per sq.m." and "Operating profit per sq.m." (under the "KPI Metrics" report subgroup).

Extended Property Type Properties:

Restrictions

• Allow modification after precheck (guest bill) — flag determining whether the property can be modified after printing a precheck.

Basic

• Type list — defines which element types will contain these properties
• Required — when enabled, the element cannot be saved without filling this property
• Comment — user comment displayed in the object inspector tooltip
• Property type — select from preset directory of extended property types
• System name — for internal use and integration with other systems

  System name must be alphanumeric in English encoding. First character must be a letter.

• Show on form — when enabled, property appears on POS under User properties button (only for Properties for orders)
• Show on search form — when enabled, property appears on receipt/order search form (only for Properties for orders)
• System type — determines stored file types
• String mask — input mask in string format. Requires values to be entered according to the specified mask.

   

Main

• Identifier — internal system element number
• Name — displayed as property name in object properties

Creating Extended Property with "Properties for orders" Type

To create a new extended property:

1. Select Properties for orders group and add New Extended Property Type in the Extended Property Types tab.
   
   

2. Specify Name and System name for the new property.

   System name must be alphanumeric in English encoding. First character must be a letter.

3. Configure other properties as described above.

Done. Depending on settings, this property can now be filled for orders and used in order searches.

Creating Extended Property with "Properties for references" Type

To create a new extended property:

1. Select a Properties for references group and add New Extended Property Type in the Extended Property Types tab.
   

2. Specify Name and System name for the new property.

   System name must be alphanumeric in English encoding. First character must be a letter.

3. To select elements where the property will appear, open the Type List section.
   
   Use the Add Item context menu
   
   From the directory, select all elements where the new extended property should appear
   
4. Configure other parameters if needed.

Done. The new extended property will now appear for selected items.