How do I set up the MplusKASSA connection?
You can connect an MplusKASSA system to your i-Reserve environment. Several settings can be configured for this.
To configure this, go to "Modules" (in configuration mode) and then to "Manage integrations." Here, click the select box under "Name" and then select "mpluskassa." There are several columns where you can enter settings.
Active
This allows you to enable and disable the connection.
Authentication
This is where you enter your credentials for the MplusKASSA API. You can find this by logging in to the MplusKASSA developers' site and then clicking on your organization under "Partners." Information for the connection:
- API Url (e.g., "https://api.mpluskassa.nl")
- Port (e.g., "50123")
- Identifier ("i-reserve")
- Secret (e.g., "48dAF3klBHK9")
Configuration
Here you can configure the connection between i-Reserve and MplusKASSA as desired. There are a few settings we'll 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 reservations from i-Reserve to MplusKASSA. For example, if you only want to transfer a reservation to MplusKASSA after you've approved it, you could select the status "20 - OPEN" in this setting and also select this status after a reservation has been approved. The reservation will then only be transferred to MplusKASSA.
Select terminal
You'll need to select a terminal for the API connection here. Here you'll choose a cash register from the branch where 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 cust_external_id fields for customers and Reservation External ID have been created to store this information. You can also leave the prefix as IRES.
Parameters
Here you can customize the information communicated to MplusKASSA. In the left column, select which MplusKASSA information you want to use a custom field in i-Reserve for. In the right column, select which custom field in i-Reserve you want to use for this.
For example, suppose you want to pass "address2" instead of "address1" as a customer's address to MplusKASSA. 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 second address field in i-Reserve).
| MplusKASSA Field | i-Reserve Field | Comments |
|---|---|---|
| extRelationId | Cannot be set via parameters. Specify the field in Configuration |
|
| name | Function: Informal name | Default: first + last name |
| address | Function: address | Default: address1 + housenum + housenumext |
| zipcode | cust_postal | |
| city | cust_city | |
| country | country_name | Here the countryID in i-Res is converted to name |
| contact | <empty> | |
| telephone | cust_tel_mob | |
| mobile | cust_tel_work | |
| cust_email | ||
| relationCode | <empty> | |
| cardNumber | <empty> | |
| bankAccountNumber | <empty> |
Mapping
The mapping allows objects in i-Reserve to be linked. There are several cases where this can be used.
Linking products (rooms, etc.)
To link a product, for example, a meeting room, you need two lines. The first is of 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. It's best to start the table IDs at 1 and increment by 1 with each new product you link.
The second
Tables in MplusKASSA are a way to keep track of which table has ordered which products and what the customer at this table must therefore pay for when it is ready. This also makes it the ideal system for i-Reserve to pass on what has been reserved by the customer. I-Reserve tells MplusKASSA what the customer has reserved, and MplusKASSA makes a "table" of this, which creates a new table with the products that the customer has reserved. This table can then be selected at the cash register to be able to pay for these products immediately.
