Connecter Zelty à XPRIO

Zelty se connecte directement à XPRIO avec une clé API que Zelty vous remet. Comptez quelques jours pour recevoir la clé, puis une demi-heure pour tout régler. Ce guide suppose que vous avez lu le principe général. Connecter ma caisse (POS) à XPRIO

Ce qu’il faut savoir

La clé est gratuite et se demande à Zelty. XPRIO ne prend aucune commission sur la connexion.
Ouverture établissement par établissement. Tant que la carte Zelty affiche « Bientôt », cliquez sur Nous vous préviendrons : nous ouvrons la connexion pour votre compte et vous écrivons dès que c’est prêt.
Zelty n’affiche une commande qu’une fois réglée. Une commande payée en ligne arrive réglée par la méthode « XPRIO ». Une commande à payer sur place arrive réglée par votre méthode « Espèces » ou par « XPRIO », avec le moyen de paiement en note : vous encaissez le client sans la ressaisir.
Chaque article doit être lié. Zelty refuse les lignes libres : un article non lié bloque l’envoi de la commande, avec un message clair. La commande XPRIO, elle, reste prise et visible dans Live.
Pas d’environnement de test : la commande de test arrive sur votre vraie caisse, marquée test.

Étape 1 : demander votre clé API

Ouvrez le formulaire zelty.fr/forms/api.
Indiquez votre enseigne et vos restaurants tels qu’ils sont nommés dans votre back-office Zelty, et votre email de connexion.
Choisissez le partenaire Autre et décrivez l’usage : « XPRIO, commandes en ligne ».
Zelty envoie les clés le mardi et le jeudi. La clé n’est visible que 5 minutes après réception : copiez-la tout de suite et gardez-la en lieu sûr.

Étape 2 : préparer votre back-office Zelty

Deux réglages, à faire une seule fois :

Configuration › Méthodes de paiement : créez une méthode nommée XPRIO. Elle sert à marquer réglées les commandes payées en ligne. Si une méthode Espèces existe déjà, XPRIO l’utilise pour les commandes payées en espèces.
Votre carte : créez un produit Frais de livraison à prix libre. XPRIO y met le montant des frais de chaque livraison.

Étape 3 : connecter Zelty dans XPRIO

Menu Configuration App, Caisse (POS), choisissez l’établissement, puis Connecter sur la carte Zelty.
Collez la clé dans Clé API Zelty et cliquez sur Enregistrer et tester.
Choisissez le restaurant Zelty de cet établissement, puis Activer.

XPRIO lit alors votre carte Zelty : plats, menus, options et ruptures.

Étape 4 : les articles

Suivez la boîte Étape suivante de la carte : import des plats Zelty dans XPRIO si votre carte n’y est pas encore, ou correspondance. La liaison se fait sur la référence (SKU) de chaque plat : mettez-la en PLU de votre produit XPRIO et tout se lie seul. Correspondance des articles entre XPRIO et ma caisse

Deux particularités Zelty :

les menus Zelty n’ont pas de référence : liez chaque formule XPRIO à son menu Zelty à la main, sur l’écran de correspondance ;
Zelty ne reçoit pas de carte par API : si votre caisse est vide, le bouton vous donne un fichier d’import à charger dans votre back-office Zelty, puis la synchronisation lie tout.

Étape 5 : commande de test

Envoyer une commande de test crée sur votre caisse une commande marquée test. Si elle s’imprime là où vous l’attendez, vos vraies commandes suivront le même chemin.

Au quotidien

Chaque commande part avec ses plats, options, menus et leurs choix, les frais de livraison et la note du client. Une remise XPRIO apparaît dans Zelty comme une remise sur le total.
Clôture dans les deux sens : une commande terminée dans XPRIO est clôturée dans Zelty, et une commande clôturée sur la caisse passe terminée dans XPRIO en quelques minutes. Une commande programmée pour un autre jour se clôture dans Zelty le jour prévu.
Annulation : Zelty ne permet pas d’annuler une commande depuis XPRIO. Quand vous annulez dans XPRIO, un message vous rappelle de l’annuler aussi sur la caisse : faites-le tout de suite, pour qu’elle ne parte pas en cuisine.
Remboursement partiel : il est fait dans XPRIO et se saisit sur la caisse. La carte vous indique le montant.
Ruptures de Zelty vers XPRIO : un plat ou une option épuisé sur Zelty devient indisponible dans XPRIO. L’inverse n’existe pas : Zelty ne permet pas de poser une rupture de l’extérieur. Une rupture posée dans Live reste dans XPRIO.

Questions fréquentes

J’ai perdu ma clé. Elle n’est plus affichée après 5 minutes : refaites une demande sur le formulaire Zelty.

Une commande n’est pas partie : « article non lié ». Ouvrez l’écran de correspondance, liez l’article indiqué, puis cliquez sur Réessayer dans les derniers envois de la carte.

Les frais de livraison ne passent pas. Vérifiez que le produit Frais de livraison existe dans votre carte Zelty, à prix libre, puis cliquez sur Resynchroniser le catalogue.

Comment me déconnecter ? Bouton Déconnecter sur la carte. Les liens d’articles sont supprimés côté XPRIO ; rien n’est supprimé dans Zelty.