Hoe stel ik de connectie met MplusKASSA in?
Het is mogelijk om een MplusKASSA systeem te koppelen aan jouw i-Reserve omgeving. Hiervoor kan het een en ander ingesteld worden.
Om dit in te stellen gaat je (in configuratiemodus) naar "Modules" en vervolgens naar "Beheren integraties". Hier kan je op de select box onder "Naam" klikken en vervolgens "mpluskassa" selecteren. Er zijn nog een aantal kolommen waar je instellingen in kan vullen
Actief
Hiermee kan je de koppeling uit- en aanzetten.
Authenticatie
Hier vul je je gegevens in voor de MplusKASSA API. Deze kan je vinden door in te loggen op de developers site van MplusKASSA en vervolgens onder het kopje "Partners" op jouw organisatie te klikken.Gegevens voor de koppeling:
- API Url (Bijv. "https://api.mpluskassa.nl")
- Port (Bijv. "50123")
- Identifier ("i-reserve")
- Secret (bijv. "48dAF3klBHK9")
Configuratie
Hier kan je de connectie tussen i-Reserve en MplusKASSA naar wens instellen. Er zijn een aantal instellingen die we hier wat extra toe gaan lichten
Status waarbij een tafel bestelling wordt aangemaakt
Hier kan je de status selecteren waarbij er een tafel wordt aangemaakt. Tafels in MplusKASSA worden gebruikt om de reserveringen uit i-Reserve in MplusKASSA te zetten. Stel je wilt bijvoorbeeld pas de reservering doorzetten naar MplusKASSA wanneer je deze hebt goedgekeurd, dan kan je bijvoorbeeld bij deze instelling status "20 - OPEN" selecteren en ook deze status selecteren wanneer een reservering is goedgekeurd. De reservering wordt dan pas doorgezet naar MplusKASSA.
Selecteer terminal
Het is de bedoeling dat hier een terminal voor de API connectie geselecteerd wordt. Hier kies je een kassa uit het filiaal waarin je de verbinding tussen I-Reserve en MplusKASSA wil gaan gebruiken. Door hier één kassa te selecteren kunnen alle kassa's in dat filiaal gebruik maken van de verbinding tussen I-Reserve en MplusKASSA
Klant veld en reservering veld
Voor het opslaan van deze informatie zijn de velden cust_external_id voor klanten en Reservering External id gemaakt. De prefix kan je ook op IRES laten staan
Parameters
Hier kan je de informatie die naar MplusKASSA wordt gecommuniceerd aanpassen. In de linkerkolom selecteer je voor welke info in MplusKASSA je een aangepast veld in i-Reserve wil gebruiken. In de rechterkolom selecteer je welk aangepast veld in i-Reserve je daarvoor wil gebruiken.
Stel dat je bijvoorbeeld niet "address1" maar "address2" als adres van een klant aan MplusKASSA door wil geven. In dat geval selecteer je in de linkerkolom "address" (dit is het adres veld in MplusKASSA) en in de rechterkolom "address2" (dit is het 2e adres veld in i-Reserve).
| Veld MplusKASSA | Veld i-Reserve | Opmerkingen |
|---|---|---|
| extRelationId | Niet via parameters in te stellen. Geef het veld op bij Configuratie |
|
| name | Functie: Informal name | Standaard: voor + achternaam |
| address | Functie: adres | Standaard: address1 + housenum + housenumext |
| zipcode | cust_postal | |
| city | cust_city | |
| country | country_name | Hier wordt het countryID in i-Res omgezet naar name |
| contact | <leeg> | |
| telephone | cust_tel_mob | |
| mobile | cust_tel_work | |
| cust_email | ||
| relationCode | <leeg> | |
| cardNumber | <leeg> | |
| bankAccountNumber | <leeg> |
Mapping
De mapping zorgt ervoor dat objecten in i-Reserve gekoppeld kunnen worden. Er zijn een aantal gevallen waarin dit gebruikt kan worden.
Koppelen van producten (zalen e.d.)
Om een product, bijvoorbeeld een vergaderzaal, te koppelen heb je twee regels nodig. De eerste is van het type "object_id_to_table". In de linkerkolom vul je hier het product ID in (te vinden in de eerste kolom van de producten) en in de rechterkolom vul je een table ID in. De table IDs kunnen het beste beginnen bij 1 en telkens 1 oplopen bij elke nieuw product die je koppelt.
De tweede regel die ingesteld moet worden is van het type "object_id_to_article". Deze regel gaat er voor zorgen dat er ook echt voor het product betaald kan worden. Hiervoor voeg je eerst een artikel voor dit product toe aan MplusKASSA. Vervolgens neem je het "nummer" van dit product en vul je dit in in de rechterkolom. In de linkerkolom kan je weer het product ID invullen.
Koppelen van opties
Een andere mogelijkheid is dat je bij het reserveren van je producten opties heeft die geselecteerd kunnen worden, zoals koffie of thee, die ook met MplusKASSA betaald gaan worden. Om dit te koppelen kies je het type "option_id_to_article" en vul je in de linkerkolom het optie ID van de gewenste optie in. Deze kan je vinden bij de desbetreffende zaal, onder de weergave "Extra" en in de kolom "ID" in het blok "Optie details". In de rechterkolom vul je het "nummer" van het product in MplusKASSA in, die je vindt in de lijst van artikelen.
Koppelen van prijsregels en/of kortingen
Wanneer je aangepaste prijsregels hanteerd op producten is het belangrijk dat je deze ook verwerkt in MplusKASSA. Hiervoor word het type "manual_to_article" gebruikt. Je selecteerd dit type en vult in de eerste kolom het product ID van het object met aangepaste prijsregels in. Deze kan je wederom vinden in de eerste kolom van de producten. In de tweede kolom vul je het "nummer" in van het product in MplusKASSA met eenzelfde prijsregel.
Zijn er meerdere prijsregels die naar hetzelfde artikel gelinkt moeten worden in MplusKASSA? Hiervoor kan je in de eerste kolom een * invullen. Alle prijsregels die niet een specifieke mapping hebben zoals hierboven beschreven worden dan gemapt naar het artikel in de tweede kolom. Denk hier aan een artikel divers in MplusKASSA die verschillende inhoud kan hebben.
MplusKASSA: hoe mappings werken
Elke mappingregel bestaat uit:
- mappingkey: de bron (i-Reserve id, gebruiker, of optie-naam)
- mappingvalue: de doelwaarde in Mplus (table/article/employee number)
Overzicht mappingtypes
| Mapping type | mappingkey | mappingvalue | Richting | Gebruik |
|---|---|---|---|---|
| object_id_to_table_id | obj_id | Mplus tableNumber | i-Reserve -> Mplus | Koppelt een object aan een tafelnummer. |
| combi_id_to_table_id | com_id | Mplus tableNumber | i-Reserve -> Mplus | Koppelt een combi aan een tafelnummer. |
| user_id_to_employee_id | user_id | Mplus employeeNumber | i-Reserve -> Mplus | Bepaalt onder welke medewerker de order wordt geboekt. |
| object_id_to_article | obj_id | Mplus articleNumber | i-Reserve <-> Mplus | Artikelkoppeling voor objectregels. |
| combi_id_to_article | com_id | Mplus articleNumber | i-Reserve <-> Mplus | Artikelkoppeling voor combiregels. |
| option_name_to_article | Optie ext_name | Mplus articleNumber | i-Reserve <-> Mplus | Aanbevolen voor opties; matcht binnen huidig object/combi op naam. |
| option_id_to_article | Optie ext_id | Mplus articleNumber | i-Reserve <-> Mplus | Legacy optie-mapping op id; wordt als fallback gebruikt. |
| manual_to_article | obj_id of * | Mplus articleNumber | i-Reserve -> Mplus | Koppelt handmatige prijsregels aan een artikel. |
Belangrijk voor opties
- Gebruik bij voorkeur option_name_to_article.
- Bij terug-sync wordt eerst name-based gematcht binnen het huidige object/combi.
- Alleen als er geen name-match is, wordt teruggevallen op option_id_to_article.
Tafels in MplusKASSA zijn een manier om bij te houden welke tafel welke producten besteld heeft en wat de klant aan deze tafel dus af moeten rekenen wanneer die klaar is. Hierdoor is dit ook het ideale systeem voor i-Reserve om door te geven wat er gereserveerd is door de klant. I-Reserve vertelt aan MplusKASSA wat de klant heeft gereserveerd, en MplusKASSA maakt hier een "tafel" van, waardoor er een nieuwe tafel aangemaakt wordt met de producten die de klant gereserveerd heeft. Op de kassa kan vervolgens deze tafel geselecteerd worden om deze producten direct af te kunnen rekenen.
