Zonal (Aztec)

Zonal (Aztec) est l’une des intégrations POS les plus complètes disponibles sur storekit. Elle offre la synchronisation complète du menu, l’injection automatique de commande avec validation du panier, la synchronisation du plan de salle pour le sur place et la prise en charge des plats, tailles et modificateurs imbriqués.

​

Prérequis

Avant de connecter Zonal, assurez-vous d’avoir :

• Zonal Aztec POS avec accès à l’API iOrder
• iOrder Brand Token de votre responsable de compte Zonal
• iOrder User Device Identifier
• Accès admin à votre tableau de bord storekit

​

Configuration de la connexion

​

Étape 1 : Saisir les identifiants Zonal

1. Allez dans Paramètres de la boutique > Intégrations dans votre tableau de bord storekit
2. Trouvez Zonal et cliquez sur Connecter
3. Saisissez vos identifiants iOrder :
   • Brand Token — Votre token d’authentification de marque iOrder
   • User Device Identifier — Votre identifiant d’appareil unique
   • Bundle Identifier (optionnel) — ID de bundle personnalisé si fourni
4. Cliquez sur Connecter

storekit vérifie les identifiants avec l’endpoint authCheck de Zonal avant l’enregistrement.

​

Étape 2 : Sélectionner votre établissement

Après authentification :

1. storekit récupère les établissements disponibles depuis votre compte Zonal
2. Sélectionnez l’établissement (site) qui correspond à cette boutique storekit
3. Le Site ID de l’établissement est enregistré pour tous les appels API futurs

​

Étape 3 : Synchroniser votre menu

Une fois connecté, importez votre menu depuis Zonal :

1. Allez dans Menu dans votre tableau de bord
2. Cliquez sur Synchroniser le menu
3. storekit récupère les menus de toutes les zones de vente
4. Les catégories et produits sont importés avec la structure complète de modificateurs

​

Synchronisation du menu

​

Ce qui est synchronisé

​

Types de synchronisation

Synchronisation complète : Importe la structure complète du menu incluant catégories, produits, modificateurs et images. À utiliser après des modifications significatives du menu. Synchronisation allégée : Met à jour uniquement les prix et la disponibilité sans réimporter la structure complète. Beaucoup plus rapide — idéale pour les changements de prix fréquents ou les mises à jour de stock.

​

Options de synchronisation

​

Restrictions par zone de vente

Les menus Zonal sont organisés par zones de vente. Pendant la synchronisation, storekit :

1. Récupère les menus de toutes les zones de vente
2. Fusionne les menus identiques entre les zones
3. Crée des restrictions de zone au niveau de la catégorie

Cela signifie que les produits peuvent être disponibles dans certaines zones mais pas dans d’autres (par ex. menus différents pour bar vs restaurant).

​

Portions (tailles)

Lorsqu’un produit a plusieurs portions dans Zonal, storekit crée un groupe de modificateurs « Taille » :

• Le prix de base du produit est fixé à 0 £
• Chaque portion devient un modificateur avec son prix
• Les clients doivent sélectionner une taille pour ajouter l’article

​

Injection de commande

Lorsqu’un client passe une commande, storekit l’envoie à Zonal via la méthode placePaidOrder.

​

Flux de commande

1. Validation du panier — storekit appelle checkBasket pour valider les articles
2. Paiement traité — Le client paie via storekit
3. Commande envoyée — Commande envoyée à Zonal avec l’ID de panier
4. Confirmation — Zonal renvoie un ID de reçu, la commande est marquée acceptée

​

Types de service

​

Envoi des précommandes

Pour les précommandes, storekit calcule l’heure d’envoi optimale :

• Commandes du jour : Envoyées immédiatement
• Commandes futures : Envoyées à 6h le jour de la commande

Cela empêche les commandes d’encombrer votre file d’attente POS des jours à l’avance.

​

Ce que reçoit Zonal

Chaque commande inclut :

• Nom, email, téléphone du client
• Tous les articles avec IDs d’ingrédients, IDs d’enregistrement d’affichage et type de portion
• Modificateurs en tant que lignes de choix avec structure imbriquée
• Attributions de plats (si configurées)
• Modificateurs de retrait (pour les articles par défaut retirés)
• Lignes de remise (pourcentage ou montant fixe)
• Montant du pourboire
• Adresse de livraison (pour les commandes de livraison)
• Créneau horaire (pour retrait/livraison)
• Code de retrait (8 caractères)
• Notes de commande personnalisées (via produit de note de commande)

​

Notes de commande

Zonal n’accepte les notes clients qu’en tant que ligne d’article, donc un Order Note Product ID doit être configuré avant que les notes puissent apparaître sur les tickets Zonal. Allez dans Boutiques → [votre boutique] → Paramètres → Intégrations → Zonal et définissez Order Note Product ID sur l’ID de produit Zonal que votre responsable de compte Zonal fournit pour les notes de commande. storekit ajoute alors une ligne d’article utilisant ce produit avec la note formatée attachée. Les notes sont mises en majuscules et débarrassées des caractères que Zonal ne peut pas afficher, et sont tronquées à 840 caractères. Utilisez Order Note Template pour contrôler comment la note est composée. Deux paramètres storekit doivent également autoriser la note :

• Boutiques → [votre boutique] → Paramètres → Opérations → Notes de commande doit être Optionnel ou Obligatoire (pas Masqué), sinon les clients n’ont jamais de champ de note
• Si vous utilisez le regroupement de commandes, Include order notes doit être activé, sinon les notes sont retirées de la commande fusionnée avant qu’elle ne soit envoyée à Zonal — voir Notes clients sur les tickets regroupés

Le produit utilisé pour les notes de commande est exclu de la synchronisation du menu, il n’apparaît donc jamais sur votre menu storekit.

​

Validation du panier et remises

L’intégration Zonal valide les commandes au checkout à l’aide de l’API checkBasket.

​

Fonctionnement

1. Le client passe au checkout
2. storekit envoie le panier à Zonal avec tous les articles et modificateurs
3. Zonal valide la disponibilité et calcule les éventuelles remises
4. Le montant de la remise est renvoyé et appliqué au total de la commande
5. L’ID de panier est stocké et utilisé lors du placement de la commande

​

Configuration des remises

​

Mise en pause automatique en cas d’erreur

Si checkBasket renvoie une erreur de rupture de stock (code -216), storekit :

1. Identifie l’article indisponible
2. Le met en pause pendant 6 heures
3. Vide le cache du menu
4. Renvoie les informations de l’article au client

​

Synchronisation du plan de salle

Synchronisez la disposition de vos tables depuis Zonal pour la commande sur place :

1. Allez dans Boutiques → [votre boutique] → Paramètres → Intégrations → Zonal
2. Cliquez sur Sync tables
3. Les zones (zones de vente) et tables sont importées

​

Ce qui est synchronisé

• Zones de vente en tant que zones d’établissement
• Groupes de tables au sein des zones
• Tables individuelles avec numéros et noms
• Capacité des tables

Les modifications dans Zonal se synchronisent automatiquement — les nouvelles tables sont ajoutées, les tables supprimées sont archivées.

​

Paramètres d’intégration

​

IDs de zone de vente pour retrait et livraison

Par défaut, storekit utilise l’ID de zone de vente 1 pour les commandes de retrait et de livraison. Si votre configuration Zonal nécessite une zone de vente spécifique pour ces méthodes de traitement, configurez-les à l’aide des paramètres d’ID de zone de vente pour le traitement :

​

Tester votre intégration

​

Liste de vérification avant lancement

1. Synchronisation du menu
   • Catégories importées de toutes les zones de vente
   • Les produits ont les bons prix (y compris les variantes de portion)
   • Les modificateurs apparaissent correctement
   • Les modificateurs imbriqués fonctionnent
   • Les images s’affichent
2. Flux de commande
   • Le panier est validé avec succès
   • La commande apparaît dans le POS Zonal
   • Les articles, modificateurs et plats sont corrects
   • Le code de retrait/créneau horaire apparaît
3. Remises (si configurées)
   • Appliquez un code de remise
   • Vérifiez que le montant correspond au calcul Zonal
4. Plan de salle (si utilisation sur place)
   • Tables synchronisées correctement
   • Les commandes sont routées vers les bonnes tables

​

Dépannage

​

Échec de connexion

• Vérifiez que le Brand Token et le User Device Identifier sont corrects
• Vérifiez que les identifiants n’ont pas expiré
• Contactez le support Zonal pour confirmer l’accès à l’API iOrder

​

Le menu ne se synchronise pas

• Assurez-vous que les menus sont publiés dans Zonal
• Vérifiez que les produits sont assignés à des groupes d’affichage
• Vérifiez que les zones de vente sont configurées
• Consultez les erreurs de synchronisation dans le tableau de bord

​

Commandes échouées

• « Missing basket ID » : La validation du panier peut avoir échoué — vérifiez la disponibilité des articles
• Erreur -238 : Panier expiré — storekit réessaiera avec un nouveau panier
• Erreur -216 : Article en rupture de stock — l’article est automatiquement mis en pause

​

Les modificateurs n’apparaissent pas

• Vérifiez que les groupes de choix sont configurés sur les produits
• Vérifiez que les modificateurs ont des suppléments de prix (ou activez « Import Choices With No Price »)
• Resynchronisez le menu après les modifications Zonal

​

Les notes de commande n’apparaissent pas

• Vérifiez que Order Note Product ID est défini dans les paramètres d’intégration Zonal — sans lui, aucune ligne de note n’est envoyée
• Vérifiez que Notes de commande sous Opérations est Optionnel ou Obligatoire, pas Masqué
• Si le regroupement de commandes est activé, vérifiez que Include order notes est activé
• Confirmez que l’ID de produit de note est valide dans Zonal — Zonal rejette la ligne de commande si le produit n’existe pas

​

Prix erronés

• Vérifiez la configuration des portions dans Zonal
• Vérifiez que la bonne portion est définie par défaut
• Pour les produits multi-portions, vérifiez les prix de modificateurs de taille

Pour toute assistance supplémentaire, contactez le support.

​

Fonctionnalités prises en charge