How do I set up the MplusKASSA connection?

It is possible to link an MplusKASSA system to your i-Reserve environment. For this, a number of settings can be made.

To set this up, go to "Modules" (in configuration mode) and then to "Manage integrations". Here you can click on the select box under "Name" and then select "mpluskassa". There are a number of columns where you can enter settings

Active

This allows you to switch the link on and off.

Authentication

Here you enter your details for the MplusKASSA API. You can find this by logging in to the developers site of MplusKASSA and then clicking on your organization under the heading "Partners". Data for the connection:

• API Url (For example "https://api.mpluskassa.nl")
• Port (For example "50123")
• Identifier ("i-reserve")
• Secret (for example "f12ADXsht4ER")

Configuration

Here you can set the connection between i-Reserve and MplusKASSA as desired. There are a number of settings that we will explain in more detail here

Status at which a table order is created

Here you can select the status at which a table is created. Tables in MplusKASSA are used to transfer the reservations from i-Reserve to MplusKASSA. For example, if you only want to transfer the reservation to MplusKASSA when you have approved it, you can select status "20 - OPEN" in this setting and also select this status when a reservation has been approved. The reservation will then only be transferred to MplusKASSA.

Select terminal

The intention is to select a terminal for the API connection here. Here you choose a cash register from the branch in which you want to use the connection between I-Reserve and MplusKASSA. By selecting one cash register here, all cash registers in that branch can use the connection between I-Reserve and MplusKASSA

Customer field and reservation field

The fields cust_external_id for customers and Reservation External id have been created to store this information. You can also leave the prefix on IRES

Parameters

Here you can adjust the information that is communicated to MplusKASSA. In the left column, you select for which information in MplusKASSA you want to use a custom field in i-Reserve. In the right column, you select which custom field in i-Reserve you want to use for this.

For example, suppose you want to pass on "address2" as a customer's address to MplusKASSA instead of "address1". In that case, select "address" in the left column (this is the address field in MplusKASSA) and "address2" in the right column (this is the 2nd address field in i-Reserve).

Mapping

The mapping ensures that objects in i-Reserve can be linked. There are a number of cases in which this can be used.

Linking products (rooms, etc.)

To link a product, such as a meeting room, you need two lines. The first is of the type "object_id_to_table". In the left column, enter the product ID (found in the first column of the products) and in the right column, enter a table ID. The table IDs can best start at 1 and increase by 1 for each new product you link.

The second rule that needs to be set is of the type "object_id_to_article". This rule will ensure that the product can actually be paid for. To do this, first add an article for this product to MplusKASSA. Then take the "number" of this product and enter it in the right column. In the left column you can enter the product ID again.

Linking options

Another possibility is that when reserving your products you have options that can be selected, such as coffee or tea, which will also be paid for with MplusKASSA. To link this, choose the type "option_id_to_article" and enter the option ID of the desired option in the left column. You can find this at the relevant room, under the view "Extra" and in the column "ID" in the block "Option details". In the right column, enter the "number" of the product in MplusKASSA, which you will find in the list of items.