Intégration MplusKASSA

Qu'est-ce que MplusKASSA ?

MplusKASSA est une plateforme logicielle de point de vente modulaire utilisée dans l'hôtellerie, la vente au détail, les parcs de loisirs, les musées et les sites événementiels aux Pays-Bas, en Belgique et en Allemagne. Elle prend en charge les caisses fixes, les kiosques, les terminaux portables et les commandes par QR à partir d'un seul système.

Pour les attractions et les sites de loisirs, MplusKASSA est le plus souvent utilisé pour gérer :

• Les points de restauration (restaurants, kiosques, bars)

• Les points de vente au détail et de marchandises

• Les services de vente incitative sur site (par exemple, location de casiers, parking, activités supplémentaires)

L'intégration Convious–MplusKASSA connecte votre boutique en ligne Convious et votre configuration de billetterie avec les caisses MplusKASSA de votre site, permettant aux visiteurs d'échanger des bons de restauration ou de vente incitative pré-achetés à leur arrivée.

Ce que fait l'intégration

Échange de bons (Convious → MplusKASSA)

Lorsqu'un visiteur achète un forfait de billets ou un produit de vente incitative dans la boutique en ligne Convious — par exemple, un billet familial qui comprend un repas — Convious injecte un bon correspondant dans MplusKASSA via l'API. Le bon est lié au même code QR imprimé sur le billet du visiteur, de sorte que le personnel peut le scanner une fois à n'importe quelle caisse MplusKASSA et la réduction ou l'article prépayé correct est automatiquement appliqué.

Exemple : Un visiteur achète un billet “Journée en famille” en ligne qui comprend quatre menus burger. Convious crée un bon dans MplusKASSA pour quatre menus burger. Lorsque la famille commande à la caisse du restaurant, le serveur scanne le code QR du billet et les quatre repas sont instantanément déduits — pas de deuxième code, pas de recherche manuelle.

Les règles de bons sont flexibles et peuvent être configurées pour s'appliquer à :

• Un produit spécifique (par exemple, un menu burger)

• Une catégorie de produits (par exemple, tous les plats chauds)

• Une réduction en pourcentage sur l'ensemble de l'assortiment

• Une réduction d'un montant fixe sur le total du panier

Réductions pour les détenteurs d'abonnements

L'intégration prend également en charge les scénarios d'avantages membres. Si votre site propose des abonnements ou des adhésions via Convious, vous pouvez configurer des règles de bons MplusKASSA afin que les détenteurs d'abonnements reçoivent automatiquement une réduction sur les achats dans le parc lorsqu'ils scannent leur pass à n'importe quelle caisse.

Exemple : Un détenteur d'abonnement scanne son code QR de pass Convious à la caisse du restaurant et reçoit une réduction de 10 % sur l'ensemble de sa commande de restauration — sans code de bon séparé ni intervention du personnel.

Les règles de réduction pour les détenteurs d'abonnements suivent les mêmes options de configuration que les bons standard : réduction en pourcentage, réduction d'un montant fixe ou accès à un produit ou une catégorie spécifique. Travaillez avec le support Convious lors de l'étape de mappage des produits pour définir quels types d'adhésion déclenchent quelles règles de réduction.

Prérequis

Avant d'activer cette intégration, confirmez les éléments suivants :

• Votre site est un partenaire Convious actif avec des produits de billetterie ou d'adhésion configurés.

• Votre site utilise MplusKASSA comme système de point de vente sur site.

• Vous disposez d'un compte MplusKASSA avec accès API activé (cela nécessite de s'inscrire en tant que partenaire de développement auprès de MplusKASSA — contactez votre gestionnaire de compte MplusKASSA pour en faire la demande).

• Vous disposez d'un contact technique (développeur ou responsable informatique) dans votre équipe qui peut aider à la configuration initiale et aux tests.

💡 Remarque : L'API MplusKASSA utilise la norme SOAP et fournit un fichier WSDL pour générer des stubs de méthode. Convious gère la construction de l'intégration de notre côté ; votre environnement MplusKASSA doit être configuré et accessible avant que le développement puisse commencer. Pour la plupart des partenaires, le processus de bout en bout du lancement à la mise en service prend environ trois semaines.

Comment commencer

La mise en place de l'intégration MplusKASSA implique un processus d'intégration conjoint entre votre équipe, Convious et MplusKASSA. Le tableau ci-dessous résume les étapes clés, qui en est responsable et un calendrier réaliste.

Étape 1 : Confirmer le périmètre de l'intégration

Avant tout travail technique, alignez-vous avec votre Customer Success Manager Convious sur les fonctionnalités que vous souhaitez activer :

• Injection de bons (requis pour l'échange de restauration et de vente incitative)

• Réductions pour abonnements / adhésions (le cas échéant)

Le support Convious documentera le périmètre convenu et coordonnera les prochaines étapes avec nos équipes produit et ingénierie.

Étape 2 : Enregistrer votre environnement MplusKASSA

Votre gestionnaire de compte MplusKASSA doit provisionner un environnement de test (développement) que Convious peut utiliser pendant la construction de l'intégration. Cet environnement de test comprend l'accès à tous les modules MplusKASSA et permet aux deux équipes de vérifier le parcours complet du visiteur avant la mise en service.

Pour en faire la demande :

1. Contactez votre gestionnaire de compte MplusKASSA et informez-le que vous démarrez une intégration avec Convious.

2. Demandez-lui de configurer un environnement de développement et de fournir les identifiants API et le point de terminaison WSDL à votre contact Convious.

3. Partagez ces identifiants avec votre Customer Success Manager Convious afin que notre équipe puisse commencer la configuration.

Étape 3 : Mapper vos produits et règles de bons

Travaillez avec votre support Convious pour mapper vos produits de billets et d'adhésion Convious aux articles correspondants dans votre catalogue de produits MplusKASSA. Pour chaque type de bon que vous souhaitez proposer, vous devrez définir :

• Quel produit Convious déclenche le bon (par exemple, “Billet Famille + Déjeuner”, ou un type d'abonnement spécifique)

• Ce à quoi le bon donne droit au visiteur (par exemple, quatre menus burger, ou une réduction de 10 % sur toute la restauration)

• Le type de réduction — soit un montant fixe, une réduction en pourcentage, ou un article prépayé du catalogue MplusKASSA

• Portée — si le bon s'applique à un produit spécifique, une catégorie de produits, ou l'ensemble de l'assortiment de restauration

⚠️ Important : Les codes de bons sont injectés dans MplusKASSA au moment de l'achat dans la boutique en ligne Convious. Assurez-vous que votre catalogue de produits MplusKASSA est finalisé avant la mise en service, car les modifications des noms ou des ID d'articles après le lancement peuvent nécessiter un nouveau mappage.

Étape 4 : Tester le flux de bout en bout

Avant la mise en service, les deux équipes doivent vérifier le parcours complet du visiteur dans l'environnement de test :

1. Achetez un billet de test avec un bon groupé via la boutique en ligne Convious (mode test).

2. Vérifiez que le bon a été injecté avec succès dans MplusKASSA en le recherchant dans le back office MplusKASSA.

3. Scannez le code QR du billet à une caisse de test MplusKASSA et confirmez que le bon correct est appliqué.

4. Vérifiez le statut du bon dans MplusKASSA après l'échange (il devrait apparaître comme échangé).

💡 Remarque : MplusKASSA stocke les bons injectés localement, de sorte que l'échange fonctionne même en cas de panne Internet temporaire sur le site. La caisse n'a pas besoin de rappeler Convious au moment du scan.

Étape 5 : Mise en service

Une fois les tests terminés et les deux équipes ayant validé :

1. Basculez l'intégration de l'environnement de test vers votre environnement MplusKASSA en production.

2. Briefez votre personnel de restauration et de vente au détail sur le fonctionnement de l'échange de bons à la caisse (voir la section suivante pour un guide étape par étape que vous pouvez partager avec eux).

3. Testez un achat réel avant votre jour d'ouverture pour confirmer que tout fonctionne de bout en bout en production.

Le support Convious et l'équipe MplusKASSA resteront disponibles pour le support dans le canal Discord partagé pendant et après votre mise en service.

Échange de bons : Comment cela fonctionne pour le personnel

Lorsqu'un visiteur présente son billet à une caisse de restauration, le processus est simple :

1. Le visiteur montre son code QR de billet Convious (imprimé, par e-mail ou portefeuille numérique).

2. L'opérateur de caisse scanne le code QR à l'aide du scanner MplusKASSA.

3. MplusKASSA recherche automatiquement le bon lié et applique la réduction ou les articles prépayés à la commande.

4. L'opérateur confirme la commande et le visiteur paie le solde restant (le cas échéant).

Le code QR sur le billet Convious est le même code utilisé pour l'entrée — les visiteurs n'ont pas besoin d'un code de bon séparé.

Surveillance et dépannage

Vérification du statut du bon

Si un visiteur signale que son bon n'est pas accepté à la caisse, votre équipe peut rechercher le statut du bon dans MplusKASSA :

1. Ouvrez le back office MplusKASSA.

2. Naviguez vers la section de gestion des bons et entrez le code QR du billet ou la référence de commande.

3. Vérifiez si le bon a été reçu, est toujours valide et n'a pas déjà été échangé.

Raisons courantes pour lesquelles un bon peut ne pas scanner :

• Le bon n'a pas été injecté avec succès (vérifiez la commande Convious dans le back office pour les erreurs)

• Le bon a déjà été échangé

• Le code QR du billet a été endommagé ou est illisible

Pour les erreurs d'injection de bons, contactez votre Customer Success Manager Convious ou signalez le problème dans le canal Discord partagé MplusKASSA.

Messages d'erreur

Les messages d'erreur MplusKASSA à la caisse sont préfixés pour indiquer quel système est responsable. Si une erreur fait référence à “Convious” ou contient un ID de commande ou de billet, elle concerne le côté Convious de l'intégration — transmettez-la à votre CSM Convious. Si l'erreur est un message système MplusKASSA générique, contactez directement le support MplusKASSA.

💡 Remarque : Convious enregistre tous les appels d'injection de bons, y compris les horodatages, les références de commande et les codes de réponse de MplusKASSA. Si un problème nécessite une enquête, votre CSM peut extraire ces journaux pour identifier exactement où dans le flux un problème s'est produit.

FAQ

Quels modules MplusKASSA sont requis pour l'intégration ? La fonctionnalité d'injection de bons utilise l'API SOAP standard de MplusKASSA — aucun module supplémentaire n'est requis au-delà d'une licence MplusKASSA standard avec accès API activé.

Les visiteurs peuvent-ils utiliser leur bon à n'importe quelle caisse du site ? Oui. Les bons sont stockés dans la base de données MplusKASSA et sont accessibles depuis toutes les caisses connectées du site. Les visiteurs peuvent échanger à n'importe quel terminal MplusKASSA, quel que soit le point de vente qu'ils visitent.

Que se passe-t-il si un visiteur perd son billet ou si le code QR est endommagé ? Convious peut réémettre le billet depuis le back office. Une fois le nouveau code QR émis, le bon lié dans MplusKASSA reste valide et sera accessible via le nouveau code.

Cette intégration est-elle disponible en Allemagne et en Belgique ? L'intégration fonctionne partout où MplusKASSA est déployé. MplusKASSA est actuellement actif aux Pays-Bas, en Belgique et en Allemagne. Notez que les fonctionnalités de conformité fiscale de MplusKASSA — telles que la certification TSS en Allemagne — sont entièrement gérées dans MplusKASSA et ne sont pas affectées par l'intégration Convious.

Convious prend-il en charge l'échange partiel de bons ? Cela dépend de la façon dont les règles de bons sont configurées dans MplusKASSA. Les bons peuvent être configurés pour s'appliquer à un produit spécifique, une catégorie de produits ou une réduction au niveau du panier. L'échange partiel (par exemple, utiliser deux des quatre articles prépayés lors de visites séparées) est possible s'il est configuré en conséquence — discutez de votre cas d'utilisation spécifique avec votre CSM Convious lors de l'étape de mappage des produits.

Combien de temps faut-il pour configurer l'intégration ? Pour la plupart des sites, le processus de bout en bout du lancement initial à la mise en service prend environ trois semaines : environ une semaine pour la construction de l'ingénierie Convious, une semaine pour les tests conjoints et un temps tampon pour le mappage des produits et le provisionnement de l'environnement du côté MplusKASSA.