MplusKASSA Integration

Was ist MplusKASSA?

MplusKASSA ist eine modulare POS-Softwareplattform, die in der Gastronomie, im Einzelhandel, in Freizeitparks, Museen und Veranstaltungsorten in den Niederlanden, Belgien und Deutschland eingesetzt wird. Sie unterstützt stationäre Kassen, Kioske, Handgeräte und QR-Bestellungen aus einem einzigen System.

Für Attraktionen und Freizeiteinrichtungen wird MplusKASSA am häufigsten zur Verwaltung folgender Bereiche eingesetzt:

• Gastronomie-Outlets (Restaurants, Kioske, Bars)

• Einzelhandels- und Merchandise-Verkaufsstellen

• Vor-Ort-Zusatzservices (z. B. Schließfachmiete, Parken, Aktivitäts-Add-ons)

Die Convious–MplusKASSA-Integration verbindet Ihren Convious-Webshop und Ihre Ticketing-Einrichtung mit den MplusKASSA-Kassen Ihrer Einrichtung, sodass Gäste vorab gekaufte Gastronomie- oder Upsell-Gutscheine bei der Ankunft einlösen können.

Was die Integration leistet

Gutscheineinlösung (Convious → MplusKASSA)

Wenn ein Gast im Convious-Webshop ein Ticketpaket oder Upsell-Produkt kauft – zum Beispiel ein Familienticket mit Mittagessen – fügt Convious über die API einen entsprechenden Gutschein in MplusKASSA ein. Der Gutschein ist mit demselben QR-Code verknüpft, der auf dem Ticket des Gastes gedruckt ist, sodass das Personal ihn einmal an jeder MplusKASSA-Kasse scannen kann und der korrekte Rabatt oder das vorausbezahlte Produkt automatisch angewendet wird.

Beispiel: Ein Gast kauft online ein „Familientag“-Ticket, das vier Burger-Menüs enthält. Convious erstellt einen Gutschein in MplusKASSA für vier Burger-Menüs. Wenn die Familie im Restaurant bestellt, scannt der Kellner den Ticket-QR-Code und die vier Menüs werden sofort abgezogen – kein zweiter Code, keine manuelle Suche.

Gutscheinregeln sind flexibel und können so konfiguriert werden, dass sie gelten für:

• Ein bestimmtes Produkt (z. B. ein Burger-Menü)

• Eine Produktkategorie (z. B. alle warmen Speisen)

• Einen prozentualen Rabatt auf das gesamte Sortiment

• Einen Festbetrag-Rabatt auf die Gesamtsumme des Warenkorbs

Rabatte für Saisonkarteninhaber

Die Integration unterstützt auch Mitgliedervorteil-Szenarien. Wenn Ihre Einrichtung Saisonkarten oder Mitgliedschaften über Convious anbietet, können Sie MplusKASSA-Gutscheinregeln so konfigurieren, dass Saisonkarteninhaber automatisch einen Rabatt auf Käufe im Park erhalten, wenn sie ihre Karte an einer Kasse scannen.

Beispiel: Ein Saisonkarteninhaber scannt seinen Convious-Pass-QR-Code an der Restaurantkasse und erhält 10 % Rabatt auf seine gesamte Gastronomie-Bestellung – kein separater Gutscheincode oder Eingreifen des Personals erforderlich.

Rabattregeln für Saisonkarteninhaber folgen denselben Konfigurationsoptionen wie Standard-Gutscheine: prozentualer Rabatt, Festbetrag-Reduzierung oder Zugang zu einem bestimmten Produkt oder einer Kategorie. Arbeiten Sie während des Produktmapping-Schritts mit dem Convious-Support zusammen, um festzulegen, welche Mitgliedschaftstypen welche Rabattregeln auslösen.

Voraussetzungen

Bevor Sie diese Integration aktivieren, bestätigen Sie Folgendes:

• Ihre Einrichtung ist ein aktiver Convious-Partner mit konfigurierten Ticketing- oder Mitgliedschaftsprodukten.

• Ihre Einrichtung nutzt MplusKASSA als Ihr Vor-Ort-POS-System.

• Sie haben ein MplusKASSA-Konto mit aktiviertem API-Zugang (dies erfordert eine Registrierung als Entwicklungspartner bei MplusKASSA – kontaktieren Sie Ihren MplusKASSA-Account-Manager, um dies anzufordern).

• Sie haben einen technischen Ansprechpartner (Entwickler oder IT-Manager) in Ihrem Team, der bei der Erstkonfiguration und beim Testen unterstützen kann.

💡 Hinweis: Die MplusKASSA-API verwendet den SOAP-Standard und stellt eine WSDL-Datei zur Generierung von Methoden-Stubs bereit. Convious übernimmt den Integrationsaufbau auf unserer Seite; Ihre MplusKASSA-Umgebung muss eingerichtet und zugänglich sein, bevor die Entwicklung beginnen kann. Für die meisten Partner dauert der End-to-End-Prozess vom Kickoff bis zum Go-Live etwa drei Wochen.

Wie Sie beginnen

Die Einrichtung der MplusKASSA-Integration umfasst einen gemeinsamen Onboarding-Prozess zwischen Ihrem Team, Convious und MplusKASSA. Die folgende Tabelle fasst die wichtigsten Schritte, die Verantwortlichkeiten und einen realistischen Zeitrahmen zusammen.

Schritt 1: Integrationsumfang bestätigen

Bevor technische Arbeiten beginnen, stimmen Sie sich mit Ihrem Convious Customer Success Manager ab, welche Funktionen Sie aktivieren möchten:

• Gutschein-Injektion (erforderlich für Gastronomie- und Upsell-Einlösung)

• Saisonkarten- / Mitgliedschaftsrabatte (falls zutreffend)

Der Convious-Support dokumentiert den vereinbarten Umfang und koordiniert die nächsten Schritte mit unseren Produkt- und Engineering-Teams.

Schritt 2: Ihre MplusKASSA-Umgebung registrieren

Ihr MplusKASSA-Account-Manager muss eine Test- (Entwicklungs-) Umgebung bereitstellen, die Convious während des Integrationsaufbaus verwenden kann. Diese Testumgebung umfasst Zugriff auf alle MplusKASSA-Module und ermöglicht es beiden Teams, die vollständige Gäste-Journey vor dem Go-Live zu überprüfen.

Um dies anzufordern:

1. Kontaktieren Sie Ihren MplusKASSA-Account-Manager und informieren Sie ihn, dass Sie eine Integration mit Convious starten.

2. Bitten Sie ihn, eine Entwicklungsumgebung einzurichten und die API-Zugangsdaten und den WSDL-Endpunkt an Ihren Convious-Kontakt zu übermitteln.

3. Teilen Sie diese Zugangsdaten mit Ihrem Convious Customer Success Manager, damit unser Team mit der Konfiguration beginnen kann.

Schritt 3: Ihre Produkte und Gutscheinregeln zuordnen

Arbeiten Sie mit Ihrem Convious-Support zusammen, um Ihre Convious-Ticket- und Mitgliedschaftsprodukte den entsprechenden Artikeln in Ihrem MplusKASSA-Produktkatalog zuzuordnen. Für jeden Gutscheintyp, den Sie anbieten möchten, müssen Sie Folgendes definieren:

• Welches Convious-Produkt den Gutschein auslöst (z. B. „Familienticket + Mittagessen“ oder ein bestimmter Saisonkartentyp)

• Wozu der Gutschein den Gast berechtigt (z. B. vier Burger-Menüs oder 10 % Rabatt auf alle Gastronomie)

• Die Rabattart – entweder ein Festbetrag, ein prozentualer Rabatt oder ein vorausbezahlter Artikel aus dem MplusKASSA-Katalog

• Geltungsbereich – ob der Gutschein für ein bestimmtes Produkt, eine Produktkategorie oder das gesamte Gastronomie-Sortiment gilt

⚠️ Wichtig: Gutscheincodes werden zum Zeitpunkt des Kaufs im Convious-Webshop in MplusKASSA eingefügt. Stellen Sie sicher, dass Ihr MplusKASSA-Produktkatalog vor dem Go-Live finalisiert ist, da Änderungen an Artikelnamen oder IDs nach dem Launch eine Neuzuordnung erfordern können.

Schritt 4: End-to-End-Ablauf testen

Vor dem Go-Live müssen beide Teams die vollständige Gäste-Journey in der Testumgebung überprüfen:

1. Kaufen Sie ein Testticket mit einem gebündelten Gutschein über den Convious-Webshop (Testmodus).

2. Überprüfen Sie, dass der Gutschein erfolgreich in MplusKASSA eingefügt wurde, indem Sie ihn im MplusKASSA-Backoffice nachschlagen.

3. Scannen Sie den Ticket-QR-Code an einer Test-MplusKASSA-Kasse und bestätigen Sie, dass der korrekte Gutschein angewendet wird.

4. Überprüfen Sie den Gutscheinstatus in MplusKASSA nach der Einlösung (er sollte als eingelöst angezeigt werden).

💡 Hinweis: MplusKASSA speichert eingefügte Gutscheine lokal, sodass die Einlösung auch bei einem vorübergehenden Internetausfall in der Einrichtung funktioniert. Die Kasse muss zum Zeitpunkt des Scannens nicht zu Convious zurückrufen.

Schritt 5: Go-Live

Sobald die Tests abgeschlossen sind und beide Teams freigegeben haben:

1. Wechseln Sie die Integration von der Testumgebung zu Ihrer Live-MplusKASSA-Umgebung.

2. Weisen Sie Ihr Gastronomie- und Einzelhandelspersonal ein, wie die Gutscheineinlösung an der Kasse funktioniert (siehe nächster Abschnitt für eine Schritt-für-Schritt-Anleitung, die Sie mit ihnen teilen können).

3. Testen Sie einen echten Kauf vor Ihrem Eröffnungstag, um zu bestätigen, dass alles End-to-End in der Produktion funktioniert.

Der Convious-Support und das MplusKASSA-Team stehen während und nach Ihrem Go-Live im gemeinsamen Discord-Kanal für Support zur Verfügung.

Gutscheineinlösung: So funktioniert es für das Personal

Wenn ein Gast sein Ticket an einer Gastronomie-Kasse vorlegt, ist der Ablauf unkompliziert:

1. Der Gast zeigt seinen Convious-Ticket-QR-Code (gedruckt, E-Mail oder digitale Geldbörse).

2. Der Kassenbediener scannt den QR-Code mit dem MplusKASSA-Scanner.

3. MplusKASSA sucht automatisch den verknüpften Gutschein und wendet den Rabatt oder die vorausbezahlten Artikel auf die Bestellung an.

4. Der Bediener bestätigt die Bestellung und der Gast zahlt den verbleibenden Betrag (falls zutreffend).

Der QR-Code auf dem Convious-Ticket ist derselbe Code, der für den Einlass verwendet wird – Gäste benötigen keinen separaten Gutscheincode.

Überwachung und Fehlerbehebung

Gutscheinstatus überprüfen

Wenn ein Gast meldet, dass sein Gutschein an der Kasse nicht akzeptiert wird, kann Ihr Team den Gutscheinstatus in MplusKASSA nachschlagen:

1. Öffnen Sie das MplusKASSA-Backoffice.

2. Navigieren Sie zum Gutscheinverwaltungsbereich und geben Sie den Ticket-QR-Code oder die Bestellreferenz ein.

3. Überprüfen Sie, ob der Gutschein empfangen wurde, noch gültig ist und noch nicht eingelöst wurde.

Häufige Gründe, warum ein Gutschein möglicherweise nicht gescannt wird:

• Der Gutschein wurde nicht erfolgreich eingefügt (überprüfen Sie die Convious-Bestellung im Backoffice auf Fehler)

• Der Gutschein wurde bereits eingelöst

• Der Ticket-QR-Code wurde beschädigt oder ist nicht lesbar

Bei Gutschein-Injektionsfehlern kontaktieren Sie Ihren Convious Customer Success Manager oder melden Sie das Problem im gemeinsamen MplusKASSA Discord-Kanal.

Fehlermeldungen

MplusKASSA-Fehlermeldungen an der Kasse sind mit einem Präfix versehen, um anzuzeigen, welches System verantwortlich ist. Wenn ein Fehler „Convious“ referenziert oder eine Bestell- oder Ticket-ID enthält, bezieht er sich auf die Convious-Seite der Integration – leiten Sie dies an Ihren Convious CSM weiter. Wenn der Fehler eine generische MplusKASSA-Systemmeldung ist, kontaktieren Sie direkt den MplusKASSA-Support.

💡 Hinweis: Convious protokolliert alle Gutschein-Injektionsaufrufe, einschließlich Zeitstempel, Bestellreferenzen und Antwortcodes von MplusKASSA. Wenn ein Problem untersucht werden muss, kann Ihr CSM diese Protokolle abrufen, um genau zu identifizieren, wo im Ablauf ein Problem aufgetreten ist.

FAQ

Welche MplusKASSA-Module sind für die Integration erforderlich? Die Gutschein-Injektionsfunktion verwendet die Standard-MplusKASSA SOAP-API – es sind keine zusätzlichen Module erforderlich, außer einer Standard-MplusKASSA-Lizenz mit aktiviertem API-Zugang.

Können Gäste ihren Gutschein an jeder Kasse in der Einrichtung verwenden? Ja. Gutscheine werden in der MplusKASSA-Datenbank gespeichert und sind von allen verbundenen Kassen in der Einrichtung aus zugänglich. Gäste können an jedem MplusKASSA-Terminal einlösen, unabhängig davon, welchen Outlet sie besuchen.

Was passiert, wenn ein Gast sein Ticket verliert oder der QR-Code beschädigt ist? Convious kann das Ticket aus dem Backoffice neu ausstellen. Sobald der neue QR-Code ausgestellt ist, bleibt der verknüpfte Gutschein in MplusKASSA gültig und ist über den neuen Code zugänglich.

Ist diese Integration in Deutschland und Belgien verfügbar? Die Integration funktioniert überall dort, wo MplusKASSA eingesetzt wird. MplusKASSA ist derzeit in den Niederlanden, Belgien und Deutschland aktiv. Beachten Sie, dass die Fiskal-Compliance-Funktionen von MplusKASSA – wie die TSS-Zertifizierung in Deutschland – vollständig innerhalb von MplusKASSA gehandhabt werden und von der Convious-Integration nicht beeinflusst werden.

Unterstützt Convious die teilweise Gutscheineinlösung? Dies hängt davon ab, wie die Gutscheinregeln in MplusKASSA konfiguriert sind. Gutscheine können so eingerichtet werden, dass sie für ein bestimmtes Produkt, eine Produktkategorie oder einen Rabatt auf Warenkorbebene gelten. Teilweise Einlösung (z. B. Verwendung von zwei von vier vorausbezahlten Artikeln über separate Besuche) ist möglich, wenn entsprechend konfiguriert – besprechen Sie Ihren spezifischen Anwendungsfall mit Ihrem Convious CSM während des Produktmapping-Schritts.

Wie lange dauert die Einrichtung der Integration? Für die meisten Einrichtungen dauert der End-to-End-Prozess vom ersten Kickoff bis zum Go-Live etwa drei Wochen: ungefähr eine Woche für den Convious-Engineering-Build, eine Woche für gemeinsame Tests und Pufferzeit für Produktmapping und Umgebungsbereitstellung auf der MplusKASSA-Seite.