MplusKASSA Integratie

Wat is MplusKASSA?

MplusKASSA is een modulair POS-softwareplatform dat wordt gebruikt in horeca, retail, leisureparken, musea en evenementenlocaties in Nederland, België en Duitsland. Het ondersteunt stationaire kassa's, kiosken, handterminals en QR-bestellingen vanuit één systeem.

Voor attracties en leisurelocaties wordt MplusKASSA het meest gebruikt voor het beheren van:

• Food & beverage outlets (restaurants, kiosken, bars)

• Retail- en merchandisepunten

• On-site upsell-diensten (bijv. kluisverhuur, parkeren, activiteiten-add-ons)

De Convious–MplusKASSA integratie verbindt uw Convious webshop en ticketingopstelling met de MplusKASSA kassa's van uw locatie, waardoor gasten vooraf gekochte F&B- of upsell-vouchers bij aankomst kunnen verzilveren.

Wat de integratie doet

Voucher-verzilvering (Convious → MplusKASSA)

Wanneer een gast een ticketbundel of upsell-product koopt in de Convious webshop — bijvoorbeeld een familieticket met een lunchdeal — injecteert Convious een bijbehorende voucher in MplusKASSA via de API. De voucher is gekoppeld aan dezelfde QR-code die op het ticket van de gast is afgedrukt, zodat personeel deze eenmalig kan scannen bij elke MplusKASSA kassa en de juiste korting of vooraf betaalde item automatisch wordt toegepast.

Voorbeeld: Een gast koopt online een “Family Day”-ticket met vier burgermaaltijden. Convious maakt een voucher aan in MplusKASSA voor vier burgermenu's. Wanneer het gezin bij de restaurantkassa bestelt, scant de medewerker de ticket-QR-code en worden de vier maaltijden direct afgetrokken — geen tweede code, geen handmatige opzoeking.

Voucherregels zijn flexibel en kunnen worden geconfigureerd voor:

• Een specifiek product (bijv. een burgermenu)

• Een productcategorie (bijv. alle warme gerechten)

• Een percentuele korting op het volledige assortiment

• Een vast bedrag korting op het totaalbedrag van het winkelmandje

Kortingen voor seizoenspashouders

De integratie ondersteunt ook scenario's voor ledenvoordelen. Als uw locatie seizoenspassen of lidmaatschappen aanbiedt via Convious, kunt u MplusKASSA voucherregels configureren zodat seizoenspashouders automatisch korting krijgen op aankopen in het park wanneer ze hun pas scannen bij een kassa.

Voorbeeld: Een seizoenspashouder scant zijn Convious pas-QR-code bij de restaurantkassa en ontvangt 10% korting op zijn volledige F&B-bestelling — geen aparte vouchercode of tussenkomst van personeel nodig.

Kortingsregels voor seizoenspashouders volgen dezelfde configuratieopties als standaard vouchers: percentuele korting, vast bedrag korting, of toegang tot een specifiek product of categorie. Werk samen met Convious support tijdens de productmapping-stap om te bepalen welke lidmaatschapstypen welke kortingsregels activeren.

Vereisten

Controleer het volgende voordat u deze integratie activeert:

• Uw locatie is een actieve Convious partner met geconfigureerde ticketing- of lidmaatschapsproducten.

• Uw locatie gebruikt MplusKASSA als uw on-site POS-systeem.

• U heeft een MplusKASSA account met API-toegang ingeschakeld (hiervoor moet u zich registreren als ontwikkelingspartner bij MplusKASSA — neem contact op met uw MplusKASSA accountmanager om dit aan te vragen).

• U heeft een technisch contactpersoon (ontwikkelaar of IT-manager) in uw team die kan helpen met de initiële configuratie en testen.

💡 Opmerking: De MplusKASSA API gebruikt de SOAP-standaard en biedt een WSDL-bestand voor het genereren van method stubs. Convious verzorgt de integratiebouw aan onze kant; uw MplusKASSA omgeving moet zijn ingesteld en toegankelijk zijn voordat de ontwikkeling kan beginnen. Voor de meeste partners duurt het end-to-end proces van kickoff tot go-live ongeveer drie weken.

Hoe te beginnen

Het opzetten van de MplusKASSA integratie omvat een gezamenlijk onboardingproces tussen uw team, Convious en MplusKASSA. De onderstaande tabel geeft een overzicht van de belangrijkste stappen, wie verantwoordelijk is voor elke stap en een realistisch tijdsbestek.

Stap 1: Bevestig de integratiescope

Voordat technisch werk begint, stem af met uw Convious Customer Success Manager over welke functies u wilt activeren:

• Voucher-injectie (vereist voor F&B en upsell-verzilvering)

• Seizoenspas / lidmaatschapskortingen (indien van toepassing)

Convious support zal de overeengekomen scope documenteren en de volgende stappen coördineren met onze product- en engineeringteams.

Stap 2: Registreer uw MplusKASSA omgeving

Uw MplusKASSA accountmanager moet een test (ontwikkel)omgeving inrichten die Convious kan gebruiken tijdens de integratiebouw. Deze testomgeving omvat toegang tot alle MplusKASSA modules en stelt beide teams in staat om de volledige gastreis te verifiëren voordat deze live gaat.

Om dit aan te vragen:

1. Neem contact op met uw MplusKASSA accountmanager en informeer hen dat u een integratie met Convious start.

2. Vraag hen om een ontwikkelomgeving in te richten en de API-credentials en WSDL-endpoint aan uw Convious contactpersoon te verstrekken.

3. Deel die credentials met uw Convious Customer Success Manager zodat ons team kan beginnen met de configuratie.

Stap 3: Map uw producten en voucherregels

Werk samen met uw Convious support om uw Convious ticket- en lidmaatschapsproducten te koppelen aan de bijbehorende items in uw MplusKASSA productcatalogus. Voor elk vouchertype dat u wilt aanbieden, moet u het volgende definiëren:

• Welk Convious product de voucher activeert (bijv. “Familieticket + Lunch”, of een specifiek seizoenspastype)

• Waar de gast recht op heeft met de voucher (bijv. vier burgermenu's, of 10% korting op alle F&B)

• Het kortingstype — ofwel een vast bedrag, een percentuele korting, of een vooraf betaald item uit de MplusKASSA catalogus

• Scope — of de voucher van toepassing is op een specifiek product, een productcategorie, of het volledige F&B-assortiment

⚠️ Belangrijk: Vouchercodes worden in MplusKASSA geïnjecteerd op het moment van aankoop in de Convious webshop. Zorg ervoor dat uw MplusKASSA productcatalogus is afgerond voordat u live gaat, aangezien wijzigingen in itemnamen of ID's na de lancering mogelijk opnieuw mappen vereisen.

Stap 4: Test de end-to-end flow

Voordat u live gaat, moeten beide teams de volledige gastreis in de testomgeving verifiëren:

1. Koop een testticket met een gebundelde voucher via de Convious webshop (testmodus).

2. Controleer of de voucher succesvol is geïnjecteerd in MplusKASSA door deze op te zoeken in de MplusKASSA backoffice.

3. Scan de ticket-QR-code bij een test MplusKASSA kassa en bevestig dat de juiste voucher wordt toegepast.

4. Verifieer de voucherstatus in MplusKASSA na verzilvering (deze moet als verzilverd worden weergegeven).

💡 Opmerking: MplusKASSA slaat geïnjecteerde vouchers lokaal op, dus verzilvering werkt zelfs als er een tijdelijke internetstoring is op de locatie. De kassa hoeft niet terug te bellen naar Convious op het moment van scannen.

Stap 5: Ga live

Zodra het testen is voltooid en beide teams akkoord gaan:

1. Schakel de integratie over van de testomgeving naar uw live MplusKASSA omgeving.

2. Brief uw F&B- en retailpersoneel over hoe de voucher-verzilvering werkt bij de kassa (zie de volgende sectie voor een stapsgewijze handleiding die u met hen kunt delen).

3. Test één echte aankoop vóór uw openingsdag om te bevestigen dat alles end-to-end werkt in productie.

Convious support en het MplusKASSA team blijven beschikbaar voor ondersteuning in het gedeelde Discord kanaal tijdens en na uw go-live.

Voucher-verzilvering: Hoe het werkt voor personeel

Wanneer een gast zijn ticket bij een F&B-kassa presenteert, is het proces eenvoudig:

1. De gast toont zijn Convious ticket-QR-code (gedrukt, e-mail of digitale wallet).

2. De kassamedewerker scant de QR-code met de MplusKASSA scanner.

3. MplusKASSA zoekt automatisch de gekoppelde voucher op en past de korting of vooraf betaalde items toe op de bestelling.

4. De medewerker bevestigt de bestelling en de gast betaalt het resterende saldo (indien van toepassing).

De QR-code op het Convious ticket is dezelfde code die wordt gebruikt voor toegang — gasten hebben geen aparte vouchercode nodig.

Monitoring en probleemoplossing

Voucherstatus controleren

Als een gast meldt dat zijn voucher niet wordt geaccepteerd bij de kassa, kan uw team de voucherstatus opzoeken in MplusKASSA:

1. Open de MplusKASSA backoffice.

2. Navigeer naar de voucherbeheersectie en voer de ticket-QR-code of orderreferentie in.

3. Controleer of de voucher is ontvangen, nog geldig is en nog niet is verzilverd.

Veelvoorkomende redenen waarom een voucher mogelijk niet scant:

• De voucher is niet succesvol geïnjecteerd (controleer de Convious order in de backoffice op fouten)

• De voucher is al verzilverd

• De ticket-QR-code is beschadigd of onleesbaar

Voor voucher-injectiefouten neemt u contact op met uw Convious Customer Success Manager of meldt u het probleem in het gedeelde MplusKASSA Discord kanaal.

Foutmeldingen

MplusKASSA foutmeldingen bij de kassa hebben een prefix om aan te geven welk systeem verantwoordelijk is. Als een fout verwijst naar “Convious” of een order- of ticket-ID bevat, heeft het betrekking op de Convious-kant van de integratie — geef dit door aan uw Convious CSM. Als de fout een generieke MplusKASSA systeemmelding is, neem dan rechtstreeks contact op met MplusKASSA support.

💡 Opmerking: Convious logt alle voucher-injectie-aanroepen, inclusief tijdstempels, orderreferenties en responscodes van MplusKASSA. Als een probleem moet worden onderzocht, kan uw CSM deze logs ophalen om precies te identificeren waar in de flow een probleem is opgetreden.

FAQ

Welke MplusKASSA modules zijn vereist voor de integratie? De voucher-injectiefunctie gebruikt de standaard MplusKASSA SOAP API — er zijn geen extra modules vereist naast een standaard MplusKASSA licentie met API-toegang ingeschakeld.

Kunnen gasten hun voucher bij elke kassa in de locatie gebruiken? Ja. Vouchers worden opgeslagen in de MplusKASSA database en zijn toegankelijk vanaf alle aangesloten kassa's in de locatie. Gasten kunnen verzilveren bij elke MplusKASSA terminal, ongeacht welk verkooppunt ze bezoeken.

Wat gebeurt er als een gast zijn ticket verliest of de QR-code beschadigd is? Convious kan het ticket opnieuw uitgeven vanuit de backoffice. Zodra de nieuwe QR-code is uitgegeven, blijft de gekoppelde voucher in MplusKASSA geldig en is deze toegankelijk via de nieuwe code.

Is deze integratie beschikbaar in Duitsland en België? De integratie werkt overal waar MplusKASSA is geïmplementeerd. MplusKASSA is momenteel actief in Nederland, België en Duitsland. Merk op dat de fiscale compliance-functies van MplusKASSA — zoals TSS-certificering in Duitsland — volledig binnen MplusKASSA worden afgehandeld en niet worden beïnvloed door de Convious integratie.

Ondersteunt Convious gedeeltelijke voucher-verzilvering? Dit hangt af van hoe de voucherregels zijn geconfigureerd in MplusKASSA. Vouchers kunnen worden ingesteld om van toepassing te zijn op een specifiek product, een productcategorie of een korting op winkelmandje-niveau. Gedeeltelijke verzilvering (bijv. twee van vier vooraf betaalde items gebruiken over afzonderlijke bezoeken) is mogelijk als dit dienovereenkomstig is geconfigureerd — bespreek uw specifieke use case met uw Convious CSM tijdens de productmapping-stap.

Hoe lang duurt het om de integratie in te stellen? Voor de meeste locaties duurt het end-to-end proces van initiële kickoff tot go-live ongeveer drie weken: ongeveer een week voor de Convious engineering build, een week voor gezamenlijk testen, en buffertijd voor productmapping en omgevingsinrichting aan de MplusKASSA-kant.