Agent parameters

Parameter

Mandatory

Description
Parameter

Mandatory

Description
AllowRetryCreateOrdernoIf true, it will be possible to resend the command to create an order if it has not previously been entered into r_Keeper, i.e. it has not been assigned an Rk-Guid
CashierTimeoutSecnoTime in seconds to wait for confirmation of order creation at the cash register. After this time, the window at the cash register will close and the Agent will know that the order has been ignored.
ConfirmOrderIfIgnoredOnKassnoIf true, the agent will continue to create the order if it was ignored at the cash register (CashierTimeoutSec expired). If false, an error message (about order rejection) will be sent to WhiteServer.
CreateOrdersAsDefferednoIf true (default value), all orders will be created as "postponed" ("drafts").
  • CryptKey
yesAccess key to the r_keeper XML API.
  • CryptKey
required to create an orderAccess key to the XML API of the R-Keeper directory server
CurrencyCodenoThe r_keeper currency code in which online orders will be paid (rubles are used by default).
CustomExtSourcenoIf the value is set, when an order is sent to r_keeper, an "ExtSource" attribute with this value is added to it. Currently, only the value "42" is known for this attribute.
DefaultCashierIdyesThe r_keeper identifier of the cashier on whose behalf the order payment will be made.
DefaultMenuSelectorCodenoThe selector code that (if specified) will be used to build the category tree (and, accordingly, filter dishes)
DefaultStationIdyesThe r_keeper identifier of the checkout where: a window will be shown to confirm the order creation, the order will be created, the order will be paid for.
DefaultTableCodeyesThe r_keeper code of the table for which the order will be created.
GuestTypeIdnoR_keeper ID of the guest type for which the order will be created.
IncludeTariffsToMenunoIf true, categories with dish-tariffs will be returned to the menu.
  • IP
yesIP address at which the Agent can see the r_keeper cash register server.
  • IP
required to create an order

IP address at which the Agent can see the R-Keeper directory server

You can check the connection data to the Directory Server in the Manager station

  • IP
yesIP address of StoreHouse 5 WEB interface.
OrderCategoryCodeyesOrder category r_keeper code.
OrderCategoryCodeCustomerTakernoOptional order category code for pickup — i.e. if pickup.taker = customer
OrderConfirmationHostyesThe name of the node (or its IP address), visible at the R-Keeper cash register, on which the Agent’s website with the order creation confirmation form is deployed.
OrderTypeCodeyesr_keeper code of the order type.
OrderTypeCodeForCustomerTakernoOptional order type code for pickup — i.e. if pickup.taker = customer
  • Password
noStoreHouse 5 WEB interface user password.
  • Port
yesTCP port for connecting to r_keeper XML API.
  • Port
required to create an orderTCP port for connecting to the XML API of the R-Keeper directory server
  • Port
yesStoreHouse 5 WEB interface port.
PriceTypeIdyesThe r_keeper identifier of the price type used when retrieving the menu.
  • RequestTimeoutSec
noResponse time from StoreHouse 5 WEB interface.
TradeGroupIdnoThe r_keeper identifier of the food trade group. If specified, keeps only food items in that trade group on the menu.
UseGetOrderMenuOnly noWhen constructing a menu, use only filtering by the r_Kepeer GetOrderMenu XML method; do not use the previous filtering by price type and trade group.
  • User
yesStoreHouse 5 WEB interface username.
VoidingReasonCodenoThe r_keeper code of the reason for canceling the order (or rather, removing dishes from it).
Connecting to r_keeper via TCP: RKeeper:TcpConnetion
Connecting to StoreHouse 5: StoreHouse5Connection
Connecting to the R-Keeper directory server via TCP: RKeeper:TcpConnetion
Preferences used to create an order: RKeeper:OrderCreationPreferences

Configuration examples

Example of r_keeper connection configuration

{
    "RKeeper": {
        "TcpConnetion": {
            "Port": 2233
        }
    }
}
 
// Example of a complete r_keeper connection configuration
{
    "RKeeper": {
        "TcpConnetion": {
            "IP": "127.0.0.1",
            "Port": 2233,
            "CryptKey": ""
        }
    }
}

Example of a complete configuration

{
  "RKeeper": {
    "OrderCreationPreferences": {
      "PriceTypeId": 1126163,
      "DefaultStationId": 16865,
      "DefaultCashierId": 1000037,
      "DefaultTableCode": 1,
      "OrderCategoryCode": 5,
      "OrderTypeCode": 5,
      "VoidingReasonCode": 1,
      "CashierTimeoutSec": 120,
      "OrderConfirmationHost": "127.0.0.1",
      "ConfirmOrderIfIgnoredOnKass": true
    },
    "TcpConnetion": {
      "IP": "127.0.0.1",
      "Port": 22333,
      "CryptKey": "",
      "ConnectionName": "R-Keeper XML API",
      "ErrorBufferDefaulSize": 1024
    },
    "RefServer": {
      "TcpConnetion": {
        "IP": "127.0.0.1",
        "Port": 5555
      }
    }
  },
  "Crm": {
    "BaseAddress": "http://172.18.5.35:9192",
    "TimeoutSec": 10,
    "ContactTypeId": 2,
    "TerminalType": 10,
    "AddressTypeId": 250
  },
  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://0.0.0.0:1234"
      }
    }
  }
}

Kestrel is a web server that comes with .net. It is used by the agent to create an order confirmation form on the site.

  • By default it is configured on port 5050.
  • The host is specified in the OrderConfirmationHost parameter of the RKeeper.OrderCreationPreferences block.

Other configuration examples

// Example of a complete configuration of connection to the R-Keeper directory server
{
    "RKeeper": {
        "RefServer": {
            "IP": "127.0.0.1",
            "Port": 2222,
            "CryptKey": ""
        }
    }
}
 
// Configuration example
{
    "RKeeper": {
        "TcpConnetion": {
            "IP": "127.0.0.1",
            "Port": 2233,
            "CryptKey": ""
        },
        "OrderCreationPreferences": {
            "DefaultStationID": 15003,
            "DefaultCashierID": 1000003,
            "DefaultTableCode": 107,
            "OrderCategoryCode": 8,
            "OrderTypeCode": 9,
//further - optional parameters:
            "CurrencyCode": 1,
            "PriceTypeID": 3,
            "DefaultMenuSelectorCode": 42,
            "OrderConfirmationHost": "127.0.0.1",
            "CashierTimeoutSec": 20,
            "TradeGroupID": 3,
            "VoidingReasonCode": 1,
            "CustomExtSource": "42",
            "ConfirmOrderIfIgnoredOnKass": true,
            "UseGetOrderMenuOnly": true,
            "CreateOrdersAsDeffered": false,
            "IncludeTariffsToMenu": false,
            "GuestTypeId": 1,
            "AllowRetryCreateOrder": false
            "PickupPreferences": {
                "OrderTypeCodeForCustomerTaker": 42,
                "OrderCategoryCodeCustomerTaker": 42
            }
        }
    },
    "StoreHouse5Connection": {
        "IP": "172.18.2.26",
        "Port": "9797",
        "User": "Admin",
        "RequestTimeoutSec": 10
    }
}