Sections and articles

Integration of R_Keeper 7 and Shelter CLOUD

Content: 1. Necessary tools. 2. Configure RK7 Manager. 3. Setting up Farcards. 4. Minimum actions in FD24. 5. Working with the RK7 cash register.

1. Necessary tools.

 To configure it, we will need: - BY R_Keeper 7 Manager (Management Station). - R_Keeper 7 Cash (Cash station). - The hotel's token in the Shelter CLOUD system. To issue a token, you need to contact technical support. - Build Farcards. In the attachment to the article. - Folio closing works ONLY IF THERE IS A CASH DEPOSIT in the client's account in Shelter CLOUD.

2. Configure RK7 Manager.

 Go to the R_Keeper 7 management station. Add the "PDS interface" to the checkout. To do this, go to the "Service" section - "Stations and devices" and select the necessary cash register server from the list. In the devices section, right-click and add "PDS interface". The name of this interface is specified in "farcards.ini" in the parameter: "NetServerName=". More information about this will be provided in the section "Configuring Farcards". The value of the "PDS Server Name" parameter in the "PDS interface" properties must match the value of the "NetServerName" parameter in "farcards.ini".
The information is shown in screenshots 1 and 2.

Screenshot 1.

Screenshot 2.
After that, go to the "Service" section - "Interfaces". And create a new interface. It is necessary to fill in the "Name" field, as well as in the "DLL files" section, to expose the "PDS Interface" to the checkout, which we created earlier. The information is shown in screenshot 3.

Screenshot 3.
Next, we set the currency for closing to a number in the Shelter CLOUD. To do this, go to the "Money" - "Currencies" section. Select the required section (for example, "Payment cards") . Right-click and create a new currency.

Screenshot 4.
The required parameters in the Currency properties will be presented below. Do not forget to save the changes. Important: To create a currency correctly, you must set the value "Total with subtraction" for the "Fiscal type" parameter. The setting of this parameter is available only under the dealer account. If you do not have such an account, it is recommended to contact the organization that services R_Keeper 7.

Screenshot 5.
Creating a discount. To do this, go to the "Money" menu - "Discounts and surcharges". In an existing section or one created by us, we create a new discount.

Screenshot 6.
The discount parameters will be listed below. Fill in the parameters in the "Properties" section, leaving the "Status" parameter deactivated. After that, we create a discount detail in the "Details" section. Only after that we set the "Status" parameter to "Active" and save the changes. See the screenshots below:

Screenshot 7.

Screenshot 8.

Screenshot 9.
Next, we create the "MCR Algorithm". To do this, go to the menu "Tools" - "Device signal processing" - "MCR algorithms". In the workspace, right-click and select "New MCR algorithm".
The algorithm should have the following parameters:

Screenshot 10.

Screenshot 11.
To the "Script" section ("MCR algorithm script editor") insert the following code:  
 function MCR1002154(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
 
begin
  
if ('R'=Copy(Parameter, 1, 1)) or ('r'=Copy(Parameter, 1, 1)) or ('K'=Copy(Parameter, 1, 1)) or ('k'=Copy(Parameter, 1, 1)) then
 
   begin
 
      //delete(Parameter,1,1);
 
      Result:=True;
 
   end
 
  else
 
   begin
 
    Result:=False;
 
   end;
  


 
	 end;

Screenshot 12.
Go to the "Settings" section - "Parameters" - "Station operation parameters" - "Order editing" - "Calculation/Order payment". In the "Payment by payment card" parameter, we set the value to "Ask".                                                                                 
                                                                                                                              
Screenshot 13.
After completing all the above steps, proceed to section 3. Configuring Farcards.

3. Setting up Farcards. 

 Farcards build. In the attachment to the article. The appsettings file is located in the assembly distribution.json". This file should contain the following parameters:: {   "Address": https://cloud.shelter.ru/rk7/                "DefDiscountCode": 16,                                                                    "Token": "A83B883F-B57C-4FC1-87F6-72CE0058305B",      "TimeoutSecs": 30,                                                                            "AllowedPaymentCode": 101                                                           } Let's analyze each parameter separately.: "Address" is the URL of the Shelter CLOUD personal account with the line /rk7/ added at the end. "DefDiscountCode" is the code of the previously created discount from R_Keeper7.

"Token" - Issued on request. Read paragraph 1.
"TimeoutSecs" - Timeout in seconds.
"AllowedPaymentCode" is the code of the previously created currency from R_Keeper7.

Screenshot 14.
You should also pay attention to the farcards.ini file. We write in it the name of the DLL responsible for the work of unloading. The parameters are shown below:
[FarServer] Type = 1 DLL = frontdesk24ExtDll Gate = 1 XMLCP=1251 [LinkDLL] 1 = pds_netk [pds_netk] NetServerName=FD24 ininame=netk.ini DebugMessages=1 ERRORLOG=pds_netk.stk ErrorLogSize=10485760 Timeout=120000 The file "frontdesk24ExtDll.dll " must be located at the root of the folder with Farcards. 

Screenshot 15.
The "NetServerName" parameter must match the name of the PDS interface at the checkout.

Screenshot 16.
After checking all the parameters, we run "Farcards" with the /desktop parameter, or install it as a service using the /install parameter. To do this, you need to create a shortcut "farcards.exe " and in the properties of the shortcut on the "Shortcut" tab, in the "Object" field, specify the required parameter. Information on the screenshot:

Screenshot 17.
After checking the build parameters, launch the "Farcards" application. It is recommended to perform the first launch with the /desktop option to check if there are any errors when connecting the library "frontdesk24ExtDll.dll ". In the future, you can run the application as a service. We check that the library is successfully connected.:
                                                                                                                                                                                                   
Screenshot 18.

4. Minimal actions in the Shelter CLOUD.

We are settling into one of the hotel rooms in Shelter CLOUD. To do this, fill in the minimum list of required fields in the new booking.: - "Number".
- We set up the "Guests have arrived" checkbox.

Screenshot 19.
We will also make a deposit to the client's reservation. Since integration will not work without a deposit, and an error will occur when trying to close an order in R-Keeper7.: "For this currency, the maximum payment is 0.00."
After entering all the data and selecting the room number, click the "Book" button. Now we can make a deposit. In the "Payments" section, specify the amount and type of payment. Click the "Add" button.

Screenshot 20.

5. Working with the cashier.

 We are launching the cash register server (if it is already running, then we need to restart it). It is recommended to do the first launch with the /desktop option to check if the interface is connected and not look for it in the log. 
After launching, open the cash register server application in the tray, select the Interfaces section. The name of our interface should be in the list.:

Screenshot 21.
Launching the yandex. Checkout app. Log in. The integration works through the "Order Creation" and "Quick Receipt" sections.

Screenshot 22.
We can add dishes to the order immediately or later. To authorize the guest and use his deposit as payment, we need to click on the "Keypad code" button and enter his room number in one of the available formats.:
- The Russian letter K (which means Room) + the number of the room in the Shelter CLOUD (if the number in the Shelter CLOUD is specified in the 03 format, then 0 is also taken into account). In other words, if the guest has room number 03, then enter K03.
- English R (which means Room) + the number of the room in the Shelter CLOUD (if the number in the Shelter CLOUD is specified in the 03 format, then 0 is also taken into account). If the guest has room number 04, enter R04.

Screenshot 23.
If everything is set up correctly, we will see the client card.  Here we see the account balance and other data.

Screenshot 24.
There are two ways to close an order, they will be displayed in the screenshots below. The process is identical to closing Shelter2. Method 1: 
The order has been completed. Click the "Code from the keyboard" button.

Screenshot 25.
Enter the guest's room number.

Screenshot 26.
Click the card payment button.

Screenshot 27.
We confirm the payment.

Screenshot 28.
Method 2:
We do not form an order, we press the "Code from the keyboard" button.

Screenshot 29.
We enter the guest's room number and get into the client card. After that, inside the card, click on the "R_K" button in the upper-left corner of the screen.

Screenshot 30.
We see that there is a discount in the order.

Screenshot 31.
We pay for the order in the currency "Closing to the number in FD24".

Screenshot 32.
We confirm the payment.

Screenshot 33.
After that, we see that our purchases were displayed in the guest's booking in Shelter CLOUD.

Screenshot 34.
Let's analyze the refund procedure. To do this, go to the "Closed receipts" section.

Screenshot 35.
The "Closed receipts" section displays 2 receipts that were closed by us earlier.

Screenshot 36.
Select the required one and click "Delete"

Screenshot 37.
Confirming the deletion.

Screenshot 38.
We choose whether to write off products from the kitchen or not.

Screenshot 39.
As we can see, the receipt is successful cancelled.

Screenshot 40.
And in Shelter CLOUD, the accruals in the reservation disappeared.

Screenshot 41.
Integration is set up.
Table of contents