MplusKASSA.

Markdown

Met de MplusKASSA-koppeling geef je cadeaubonnen uit, verzilver je ze en bekijk je het saldo, direct vanaf de kassa. Elke transactie staat meteen in je Gifty-dashboard. De koppeling is ook geschikt voor bedrijven met meerdere vestigingen en franchises.

Eerst stel je de koppeling in. Daarna lees je hoe uitgeven, verzilveren en saldo bekijken op de kassa werken.

Vanaf MplusKASSA 59.3.4 Sommige functies werken alleen op een recente versie van MplusKASSA. Dat zie je aan een label zoals dit. Oudere kassa's blijven gewoon werken, met minder functies.

Installatie

Voor de koppeling heb je een paar gegevens uit het Gifty-dashboard nodig. Daarna stel je in MplusKASSA een betaalwijze, een artikel, een webhook en een knop in.

Voorbereiding

Licentie
Bestel de licentie Q3300 – Webhooks in de dealerportal van MplusKASSA, of vraag je dealer om dat te doen.
API-key
Maak in het Gifty-dashboard onder Developers een API-key aan. Kies een herkenbare naam, bijvoorbeeld Kassa frontdesk. Die naam zie je terug in je transactieoverzicht.
Vestigings-ID (optioneel)
Wil je zien in welke vestiging een cadeaubon is verzilverd? Kopieer dan het vestigings-ID van de pagina Inleveradressen. Het begint altijd met lc_.
Endpoint-URL
Vul je API-key en vestigings-ID in de URL hieronder in. Heb je geen vestigings-ID, laat dat deel dan weg.

HTTP

https://mpluskassa.pos.gifty.nl/[API-KEY]/[VESTIGING-ID]

Heb je geen toegang tot het Gifty-dashboard, of wil je testcadeaubonnen? Vraag ze op via gifty.nl/contact.

Configuratie

Open het Beheer vanuit het hoofdmenu van de kassa. Daar stel je alle onderdelen hieronder in.

Betaalwijze

Met de betaalwijze Gifty Gift Card reken je een bon af met een cadeaubon.

Ga naar Financieel > Betaalwijzen
Klik op Wijzigen en daarna op Betaalwijze toevoegen
Vul de nieuwe regel in volgens de tabel en vink het selectievakje aan het begin van de regel aan
Sla de wijzigingen op

Veld	Waarde
Omschrijving	Gifty Gift Card
Knoptekst	Gifty Gift Card
Korting toestaan	✅
Kastelling toestaan	✅

Voor je administratie kun je ook de rekening kiezen waarop Gifty je uitbetaalt.

Artikel

Een uitgegeven cadeaubon staat als artikel op de bon. Zo klopt je administratie en reken je de btw op het juiste moment af.

Ga naar Artikelen
Klik op Nieuw
Vul de gegevens in volgens de tabel
Sla de wijzigingen op

Veld	Waarde
Omschrijving	Gifty Gift Card
Barcode	GIFTY-GIFT-CARD
BTW-code	0%. Je rekent de btw af wanneer de cadeaubon wordt verzilverd.
Omzetgroep	Een omzetgroep die past bij je administratie, bijvoorbeeld een nieuwe groep Cadeaubonnen
Voorraadartikel	Niet aanvinken

Webhook

Ga naar Instellingen > Webhooks en voeg een nieuwe applicatie toe. Vul de velden in volgens de tabel.

Veld	Waarde
Application Name	Gifty
Company Name	Gifty B.V.
Subscription ID	gifty
Secret Token	Klik op Genereer
Endpoint URL	De endpoint-URL uit de voorbereiding

Zet daarna de gebeurtenissen uit de tabel aan en sla de wijzigingen op.

Enabled	Event	Blocking	Polling	Cancel Auth	Extra instellingen
✅	scanCode	✅			Code Type QRCODE, RFID en BARCODE Pattern: `^(.gifty\.[a-z]{2}\/)?([A-Z0-9]{16})(\/.)?$`
✅	addSessionLine	✅		✅	Artikelfilter Gifty Gift Card
✅	updateSessionLine	✅		✅	Artikelfilter Gifty Gift Card
✅	cancelSession
✅	completeSession
✅	startExternalPayment	✅			Betaalwijze Gifty Gift Card
✅	pollExternalPayment	✅	✅
✅	requestCancelExternalPayment	✅
✅	cancelExternalPayment	✅
✅	customAction	✅
Optioneel	mergeSession				Zie Tafels samenvoegen

De webhook in het Beheer. In recente versies van MplusKASSA ziet dit scherm er anders uit.

Artikelfilter

Met het artikelfilter stuurt de kassa alleen bonregels met een cadeaubon naar Gifty. Zonder filter gaat elke bonregel langs Gifty en wacht de kassa daar telkens op. Kies daarom bij het artikelfilter het artikel Gifty Gift Card.

Het filter geldt voor addSessionLine, updateSessionLine en removeSessionLine. Herstart de kassa na het opslaan: het filter werkt pas daarna.

Tafels samenvoegen (optioneel)

Vanaf MplusKASSA 60.9.5 Op oudere versies niet beschikbaar.

Voeg je tafels samen terwijl er op een van de tafels al met een cadeaubon is betaald? Zet dan ook de gebeurtenis mergeSession aan. De betaling met de cadeaubon gaat dan mee naar de samengevoegde tafel.

Knoppen op de kassa

Met de knop Cadeaubon uitgeven geef je een cadeaubon uit zonder hem eerst te scannen, en bekijk je het saldo. De knop is niet verplicht, maar we raden hem wel aan. Een aparte saldoknop is optioneel.

Ga naar Kassa > Schermindeling en open het scherm waar de knop moet komen, bijvoorbeeld het Invoerscherm.

Kies een lege tegel
Kies de functie Webhook customAction
Open de opties van de functie en vul de velden in volgens de tabel
Sla de wijzigingen op. Zie je de knop daarna niet op de kassa, herstart de kassa dan

De schermindeling met de tegel (1), de functie (2) en de opties (3)

Veld	Uitgifteknop	Saldoknop (optioneel)
Knoptekst	Cadeaubon uitgeven	Saldo
CustomActionId	`GIFTY_ISSUE`	`GIFTY_BALANCE`
Webhook Application	Gifty	Gifty
Aanroepen bij opstarten	Nee	Nee

De knoptekst mag je zelf kiezen. Zonder saldoknop bekijk je het saldo door de uitgifteknop lang in te drukken, zie Saldo bekijken.

Restsaldo op de bon

Vanaf MplusKASSA 61 Op oudere versies staat het restsaldo niet op de bon.

Na een betaling met een cadeaubon print de kassa het resterende saldo onderaan de bon. Daarvoor moet het veld Webhook bonvoet tekst in de lay-out van je kassabon staan.

Het veld in de lay-out bepaalt waar het restsaldo op de bon komt

Ga naar Instellingen > Print lay-outs toewijzen en kijk welke lay-out je kassa gebruikt
Open die lay-out bij Instellingen > Print lay-outs
Staat Webhook bonvoet tekst er nog niet in? Zoek het veld op, sleep het naar de onderkant van de bon en sla op

Op de bon staat per cadeaubon één regel, zoals Gifty cadeaubon ...L9S4, restsaldo € 7,50. Van de code zie je alleen de laatste vier tekens. Het veld Webhook bonvoet code heb je hiervoor niet nodig.

Een A4-lay-out heeft dit veld standaard niet. Reken na het instellen één bon af met een cadeaubon en controleer of de regel op de geprinte bon staat.

Versies van MplusKASSA

De koppeling ziet zelf welke versie van MplusKASSA er draait en gebruikt alleen wat die versie ondersteunt. Daarvoor hoef je niets in te stellen.

Functie	Vanaf MplusKASSA	Op oudere versies
Bedrag kiezen bij het uitgeven	59.3.4	Vaste bedragknoppen
Saldo bekijken met de uitgifteknop	59.3.4	Gebruik een saldoknop
Foutscherm bij het afrekenen	59.3.4	De melding staat in de scanvraag
Tafels samenvoegen	60.9.5	Niet beschikbaar
Restsaldo op de bon	61	Geen restsaldo op de bon

Gifty werkt de koppeling zelf bij. Daarvoor hoef je niets te installeren.

Testen

De koppeling is klaar. Test hem met een testcadeaubon: geef de cadeaubon uit, bekijk het saldo en reken er een bon mee af. In de volgende hoofdstukken lees je hoe dat werkt.

Uitgeven

Je geeft een cadeaubon op twee manieren uit: door hem direct te scannen, of met de knop Cadeaubon uitgeven. De cadeaubon komt als regel op de bon en wordt opgewaardeerd zodra de bon is afgerekend.

Direct scannen

Scan de QR-code van de cadeaubon
Kies een bedrag of vul zelf een bedrag in
Druk op Op de bon zetten en reken de bon af

Na het scannen kies je een bedrag (1) of vul je zelf een bedrag in (2)

Vul je een bedrag in en kies je ook een snelkeuze, dan telt het ingevulde bedrag.

Vanaf MplusKASSA 59.3.4 Op oudere versies kies je uit vaste bedragen, zoals in de video.

Direct scannen op MplusKASSA ouder dan 59.3.4

Met de knop

Typ het bedrag op het numpad, bijvoorbeeld 25,00
Druk op Cadeaubon uitgeven
Controleer het bedrag in de scanvraag en scan de cadeaubon
Reken de bon af

Het numpad rekent in centen. 25,00 en 2500 zijn € 25,00, maar 25 is € 0,25.

Typ je vooraf geen bedrag, dan kies je het na het scannen, net als bij direct scannen.

Uitgeven met de knop

Goed om te weten

Koos je een verkeerd bedrag? Verwijder de regel van de bon en scan de cadeaubon opnieuw. Tot het afrekenen is er niets opgewaardeerd.
Annuleer je het bedragscherm, de scanvraag of de bon, dan gebeurt er niets met de cadeaubon.
Je kunt meerdere cadeaubonnen op één bon zetten. Dezelfde cadeaubon kan er maar één keer op.
Een cadeaubon die al is opgewaardeerd, kun je niet nog een keer uitgeven. De kassa toont dan het saldo.

Verzilveren

Een cadeaubon verzilver je op het afrekenscherm. Je betaalt de hele bon met een cadeaubon, of een deel ervan.

Ga naar het afrekenscherm
Druk op Gifty Gift Card. De kassa vult het openstaande bedrag in
Druk op Afrekenen
Scan de cadeaubon zodra de kassa daarom vraagt

Kies de betaalwijze Gifty Gift Card (1) en reken af (2)

Is er genoeg saldo, dan is de bon direct afgerond.

Afrekenen met alleen een cadeaubon

Een deel betalen met de cadeaubon

Wil je een deel van de bon met de cadeaubon betalen? Pas dan het bedrag bij Gifty Gift Card aan en vul de rest in bij een andere betaalwijze, zoals pin of contant.

Weet je het saldo niet? Scan de cadeaubon dan eerst op het afrekenscherm. Het saldo verschijnt onder het totaal.

Heeft de cadeaubon te weinig saldo voor het ingevulde bedrag, dan zie je hoeveel er al is voldaan, bijvoorbeeld € 1,00 van € 2,95 voldaan. Scan dan nog een cadeaubon voor de rest.

Afrekenen met een cadeaubon en een restbedrag

Annuleren

Druk je bij de scanvraag op Annuleren, dan ga je terug naar het afrekenscherm. Er wordt niets afgeschreven, ook niet van een cadeaubon die je daarvoor al had gescand.

Als afrekenen niet lukt

Vanaf MplusKASSA 59.3.4 Op oudere versies staat de melding in de scanvraag.

Kan de cadeaubon niet worden gebruikt, dan zie je op de kassa wat er aan de hand is. Met Opnieuw scannen probeer je het nog een keer. Met Andere betaalwijze ga je terug naar het afrekenscherm.

Geef de referentie tussen haakjes door als je Gifty of je dealer belt

Wat de meldingen betekenen, staat bij Problemen oplossen.

Restsaldo op de bon

Vanaf MplusKASSA 61 Op oudere versies staat het restsaldo niet op de bon.

Na het betalen staat het resterende saldo onderaan de bon, bijvoorbeeld Gifty cadeaubon ...L9S4, restsaldo € 7,50. Is de cadeaubon leeg, dan staat er restsaldo € 0,00. Zie je de regel niet, controleer dan de bon-lay-out bij de installatie.

Saldo bekijken

Je bekijkt het saldo van een cadeaubon op drie manieren. Er wordt daarbij niets afgeschreven.

Manier	Wat je doet	Wat je ziet
Direct scannen	Scan de cadeaubon op het kassascherm of het afrekenscherm	Een regel onder het totaal met het saldo en de vervaldatum
Uitgifteknop Vanaf MplusKASSA 59.3.4	Houd Cadeaubon uitgeven lang ingedrukt en scan de cadeaubon	Een melding met het saldo en de geldigheid
Saldoknop	Druk op Saldo en scan de cadeaubon	Dezelfde melding

Met een knop

De melding na het scannen. Rechtsonder staat de saldoknop

De melding sluit vanzelf na tien seconden. Is de cadeaubon nog niet opgewaardeerd of niet meer bruikbaar, dan staat dat in de melding. Aan de bon verandert niets.

Direct scannen

Het saldo en de vervaldatum onder het totaal

De regel kan bij de bon blijven staan terwijl je verder werkt. Dat betekent niet dat de cadeaubon wordt afgeschreven: betalen doe je op het afrekenscherm met de betaalwijze Gifty Gift Card.

Scan je een cadeaubon die nog niet is opgewaardeerd, dan vraagt de kassa om een bedrag om hem uit te geven. Druk op Annuleer als je dat niet wilt.

Problemen oplossen

Hieronder staan de meldingen die je op de kassa kunt zien, en bekende problemen in MplusKASSA zelf.

Meldingen op de kassa

Melding	Wat het betekent	Wat je doet
Gifty is tijdelijk niet bereikbaar	Gifty is even niet bereikbaar of te druk	Probeer het zo opnieuw of reken anders af. Blijft het zo, geef dan de referentie door aan Gifty
Deze cadeaubon kan niet worden gebruikt	Gifty weigert de afboeking van deze cadeaubon	Gebruik een andere cadeaubon of betaalwijze. Verwacht je dit niet, geef dan de referentie door
De cadeaubon heeft geen saldo	De cadeaubon is leeg	Gebruik een andere cadeaubon of betaalwijze
Cadeaubon niet gevonden	Gifty kent de code niet, of de code is verkeerd gescand	Scan de cadeaubon opnieuw
Een cadeaubon kan eenmalig worden toegevoegd	Deze cadeaubon staat al op de bon	Scan een andere cadeaubon
De Gifty-koppeling is niet goed ingesteld	De API-key in de endpoint-URL is ongeldig of heeft geen toegang	Controleer de endpoint-URL bij Instellingen > Webhooks
Geen resultaat gevonden voor de gescande code	De kassa herkent de code niet. Bij een storing van Gifty zie je bij direct scannen dezelfde melding	Scan opnieuw. Blijft het zo, probeer het later nog eens of bekijk het saldo met de knop

Bij een melding van Gifty staat tussen haakjes een referentie, bijvoorbeeld ref 325295ea. Geef die door als je Gifty of je dealer belt, en maak een foto van het scherm. Daarmee vinden we snel wat er misging.

In het Beheer staat een webhook-logboek. Daarin zie je per verzoek de status en het antwoord.

Bekende problemen in MplusKASSA

In sommige versies van MplusKASSA zitten problemen die de koppeling raken. Werk de kassa bij als je zo'n versie gebruikt.

Versie	Wat er gebeurt	Oplossing
59.6.8	Externe betalingen worden direct geannuleerd	Werk bij naar 59.6.11 of nieuwer
Ouder dan 61.2.3	Na een update naar versie 60 of hoger kunnen betaalwijzen voor externe betalingen uitgeschakeld zijn	Werk bij naar 61.2.3 of nieuwer
Ouder dan 62.1.24, of versie 66 ouder dan 66.1.4	Na het scannen van een cadeaubon kan de kassa vastlopen met de melding Integer overflow zodra de bon verandert	Werk bij naar 62.1.24, 66.1.4 of nieuwer
Ouder dan 60.9.5	De kassa verstuurt mergeSession niet	Werk bij naar 60.9.5 of nieuwer