Handbuch i-Reserve - Wie stelle ich die Verbindung mit MplusKASSA ein?

Home Entwickler Integrationen MplusKASSA

Documentatie

difficulty level:

Configuratie - Beheren Integraties - MplusKASSA

Es ist möglich, ein MplusKASSA-System mit Ihrer i-Reserve Umgebung zu verbinden. Hierfür können verschiedene Einstellungen vorgenommen werden.

Um dies einzustellen, gehen Sie (im Konfigurationsmodus) zu "Module" und anschließend zu "Integrationen verwalten". Hier können Sie auf die Auswahlbox unter "Name" klicken und dann "mpluskassa" auswählen. Es gibt noch einige Spalten, in denen Sie Einstellungen vornehmen können

Aktiv

Hiermit können Sie die Verbindung aus- und einschalten.

Authentifizierung

Hier geben Sie Ihre Daten für die MplusKASSA API ein. Diese finden Sie, indem Sie sich auf der Developer-Site von MplusKASSA anmelden und anschließend unter der Überschrift "Partners" auf Ihre Organisation klicken. Daten für die Verbindung:

API Url (z. B. "https://api.mpluskassa.nl")
Port (z. B. "50123")
Identifier ("i-reserve")
Secret (z. B. "48dAF3klBHK9")

Konfiguration

Hier können Sie die Verbindung zwischen i-Reserve und MplusKASSA nach Wunsch einstellen. Es gibt einige Einstellungen, die wir hier näher erläutern

Status, bei dem eine Tisch-Bestellung erstellt wird

Hier können Sie den Status auswählen, bei dem ein Tisch erstellt wird. Tische in MplusKASSA werden verwendet, um die Reservierungen aus i-Reserve in MplusKASSA zu übertragen. Angenommen, Sie möchten die Reservierung beispielsweise erst dann an MplusKASSA weiterleiten, wenn Sie diese genehmigt haben, dann können Sie bei dieser Einstellung beispielsweise den Status "20 - OPEN" auswählen und diesen Status auch dann auswählen, wenn eine Reservierung genehmigt wurde. Die Reservierung wird dann erst an MplusKASSA weitergeleitet.

Terminal auswählen

Es ist vorgesehen, dass hier ein Terminal für die API-Verbindung ausgewählt wird. Hier wählen Sie eine Kasse aus der Filiale aus, in der Sie die Verbindung zwischen i-Reserve und MplusKASSA verwenden möchten. Indem Sie hier eine Kasse auswählen, können alle Kassen in dieser Filiale die Verbindung zwischen i-Reserve und MplusKASSA nutzen

Kundenfeld und Reservierungsfeld

Zum Speichern dieser Informationen wurden die Felder cust_external_id für Kunden und Reservering External id erstellt. Das Präfix können Sie auch auf IRES belassen

Parameter

Hier können Sie die Informationen anpassen, die an MplusKASSA übermittelt werden. In der linken Spalte wählen Sie aus, für welche Info in MplusKASSA Sie ein angepasstes Feld in i-Reserve verwenden möchten. In der rechten Spalte wählen Sie aus, welches angepasste Feld in i-Reserve Sie dafür verwenden möchten.

Angenommen, Sie möchten beispielsweise nicht "address1", sondern "address2" als Adresse eines Kunden an MplusKASSA übergeben. In diesem Fall wählen Sie in der linken Spalte "address" (das ist das Adressfeld in MplusKASSA) und in der rechten Spalte "address2" (das ist das 2. Adressfeld in i-Reserve).

Feld MplusKASSA	Feld i-Reserve	Anmerkungen
extRelationId		Nicht über Parameter einstellbar. Geben Sie das Feld bei der Konfiguration an
name	Funktion: Informal name	Standard: Vor- + Nachname
address	Funktion: Adresse	Standard: address1 + housenum + housenumext
zipcode	cust_postal
city	cust_city
country	country_name	Hier wird die countryID in i-Res in name umgewandelt
contact	<leer>
telephone	cust_tel_mob
mobile	cust_tel_work
email	cust_email
relationCode	<leer>
cardNumber	<leer>
bankAccountNumber	<leer>

Mapping

Das Mapping sorgt dafür, dass Objekte in i-Reserve verbunden werden können. Es gibt einige Fälle, in denen dies verwendet werden kann.

Verbinden von Produkten (Sälen o. Ä.)

Um ein Produkt, beispielsweise einen Besprechungsraum, zu verbinden, benötigen Sie zwei Zeilen. Die erste ist vom Typ "object_id_to_table". In der linken Spalte geben Sie hier die Produkt-ID ein (zu finden in der ersten Spalte der Produkte) und in der rechten Spalte geben Sie eine table ID ein. Die table IDs beginnen am besten bei 1 und erhöhen sich bei jedem neuen Produkt, das Sie verbinden, jeweils um 1.

Die zweite Zeile, die eingestellt werden muss, ist vom Typ "object_id_to_article". Diese Zeile sorgt dafür, dass für das Produkt auch tatsächlich bezahlt werden kann. Hierfür fügen Sie zunächst einen Artikel für dieses Produkt in MplusKASSA hinzu. Anschließend nehmen Sie die "Nummer" dieses Produkts und geben diese in der rechten Spalte ein. In der linken Spalte können Sie wieder die Produkt-ID eingeben.

Verbinden von Optionen

Eine andere Möglichkeit ist, dass Sie beim Reservieren Ihrer Produkte Optionen haben, die ausgewählt werden können, wie Kaffee oder Tee, die ebenfalls mit MplusKASSA bezahlt werden. Um dies zu verbinden, wählen Sie den Typ "option_id_to_article" und geben in der linken Spalte die Options-ID der gewünschten Option ein. Diese finden Sie beim betreffenden Saal, unter der Ansicht "Extra" und in der Spalte "ID" im Block "Optionsdetails". In der rechten Spalte geben Sie die "Nummer" des Produkts in MplusKASSA ein, die Sie in der Artikelliste finden.

Verbinden von Preisregeln und/oder Rabatten

Wenn Sie angepasste Preisregeln für Produkte verwenden, ist es wichtig, dass Sie diese auch in MplusKASSA berücksichtigen. Hierfür wird der Typ "manual_to_article" verwendet. Sie wählen diesen Typ und geben in der ersten Spalte die Produkt-ID des Objekts mit angepassten Preisregeln ein. Diese finden Sie wiederum in der ersten Spalte der Produkte. In der zweiten Spalte geben Sie die "Nummer" des Produkts in MplusKASSA mit derselben Preisregel ein.

Gibt es mehrere Preisregeln, die in MplusKASSA mit demselben Artikel verknüpft werden müssen? Hierfür können Sie in der ersten Spalte ein * eingeben. Alle Preisregeln, die keine spezifische Zuordnung haben, wie oben beschrieben, werden dann dem Artikel in der zweiten Spalte zugeordnet. Denken Sie hierbei an einen Artikel "Diverses" in MplusKASSA, der unterschiedlichen Inhalt haben kann.

MplusKASSA: wie Mappings funktionieren

Jede Mapping-Zeile besteht aus:

mappingkey: die Quelle (i-Reserve id, Benutzer oder Options-Name)
mappingvalue: der Zielwert in Mplus (table/article/employee number)

Übersicht der Mapping-Typen

Mapping-Typ	mappingkey	mappingvalue	Richtung	Verwendung
object_id_to_table_id	obj_id	Mplus tableNumber	i-Reserve -> Mplus	Verbindet ein Objekt mit einer Tischnummer.
combi_id_to_table_id	com_id	Mplus tableNumber	i-Reserve -> Mplus	Verbindet eine Combi mit einer Tischnummer.
user_id_to_employee_id	user_id	Mplus employeeNumber	i-Reserve -> Mplus	Bestimmt, unter welchem Mitarbeiter die Bestellung gebucht wird.
object_id_to_article	obj_id	Mplus articleNumber	i-Reserve <-> Mplus	Artikelverknüpfung für Objektzeilen.
combi_id_to_article	com_id	Mplus articleNumber	i-Reserve <-> Mplus	Artikelverknüpfung für Combi-Zeilen.
option_name_to_article	Option ext_name	Mplus articleNumber	i-Reserve <-> Mplus	Empfohlen für Optionen; matcht innerhalb des aktuellen Objekts/Combi anhand des Namens.
option_id_to_article	Option ext_id	Mplus articleNumber	i-Reserve <-> Mplus	Legacy-Options-Mapping anhand der id; wird als Fallback verwendet.
manual_to_article	obj_id oder *	Mplus articleNumber	i-Reserve -> Mplus	Verbindet manuelle Preisregeln mit einem Artikel.

Wichtig für Optionen

Verwenden Sie vorzugsweise option_name_to_article.
Bei der Rück-Synchronisation wird zuerst name-based innerhalb des aktuellen Objekts/Combi gematcht.
Nur wenn es keinen name-match gibt, wird auf option_id_to_article zurückgegriffen.

Tische in MplusKASSA sind eine Möglichkeit, um festzuhalten, welcher Tisch welche Produkte bestellt hat und was der Kunde an diesem Tisch also abrechnen muss, wenn er fertig ist. Dadurch ist dies auch das ideale System für i-Reserve, um weiterzugeben, was vom Kunden reserviert wurde. i-Reserve teilt MplusKASSA mit, was der Kunde reserviert hat, und MplusKASSA macht daraus einen "Tisch", wodurch ein neuer Tisch mit den Produkten angelegt wird, die der Kunde reserviert hat. An der Kasse kann anschließend dieser Tisch ausgewählt werden, um diese Produkte direkt abrechnen zu können.