Comment s’intégrer à l’API Zelty ?

Zelty est une solution digitale innovante pour la gestion de caisses, la prise de commandes et la gestion des restaurants, conçue dès le départ pour digitaliser les établissements multi-sites. Si votre produit s’adresse au secteur de l’hôtellerie-restauration, l’intégration avec Zelty permet de créer des automatisations puissantes pour vos utilisateurs.

Intégrer votre produit à l’API Zelty vous permet de :

• Automatiser la synchronisation des commandes et la génération de rapports de ventes
• Synchroniser les informations clients et les paiements entre plateformes
• Minimiser la saisie manuelle et réduire les erreurs
• Permettre des analyses en temps réel et le suivi des performances

Ce guide couvre tout ce que vous devez savoir pour configurer votre intégration Zelty, les bonnes pratiques et des cas d’usage concrets soutenus par l’Unified POS API de Chift.

Qu’est-ce que l’API Zelty ?

Zelty propose une API REST basée sur des principes modernes pour servir les restaurants, cafés et services alimentaires à travers l’Europe. L’API est spécialement conçue pour les opérations POS sur iPad et repose sur une architecture microservices et serverless pour garantir fiabilité et évolutivité.

Fondations techniques :

• Architecture RESTful avec réponses en JSON
• Authentification par clé API (basée sur token)
• Backend microservices et serverless
• Couche d’intégration unifiée simplifiant la connectivité

L’API Zelty couvre un large éventail de données opérationnelles pour les restaurants :

• Produits & Catégories : Gestion du menu et suivi des stocks
• Commandes & Lignes de commande : Historique complet des transactions avec détail ligne par ligne
• Clients / Contacts : Données des clients pour fidélisation et CRM
• Paiements : Historique des transactions pour rapprochement et reporting
• Sites : Support multi-sites pour chaînes et franchises
• Clôtures : Synthèses financières de fin de service et de journée
• Rapports de ventes : Données analytiques pour le suivi des performances

Ce qui rend Zelty particulièrement puissant, c’est son focus sur le secteur de l’hôtellerie. Contrairement aux systèmes POS génériques, Zelty comprend les flux spécifiques aux restaurants et expose ces données via des endpoints API clairs et bien structurés.

[[cta_unified_pos]]

Exemples de cas d’usage de Zelty

Synchronisation des commandes

Les plateformes comptables peuvent récupérer les données de commandes et pousser automatiquement les transactions journalières dans les systèmes en aval, tels que les outils comptables ou de reporting financier, éliminant ainsi les exportations manuelles et les rapprochements.

Suivi des niveaux de stock

Les systèmes ERP peuvent désormais suivre les articles du menu et leurs stocks, en marquant les plats comme indisponibles si les ingrédients sont insuffisants. Cela empêche les clients de commander des articles non réalisables et aide à gérer efficacement les stocks.

Suivi par site

Les outils de gestion multi-sites peuvent récupérer les données des magasins pour structurer les ventes par site et surveiller la performance à travers un réseau de restaurants.

Mise en place de l’intégration API Zelty

La mise en place d’une intégration API Zelty nécessite des identifiants fournis par Zelty.

Pour créer une intégration :

• Vous devez obtenir une clé API Zelty
• L’authentification se fait via clé API basée sur token
• Les clés API doivent rester confidentielles et ne doivent jamais être partagées publiquement ou intégrées dans des applications côté client

Une fois authentifiée, votre application peut commencer à consommer les endpoints Zelty pertinents selon votre cas d’usage.

Commencer avec l’intégration API Zelty

Pour débuter :

1. Demandez l’accès à l’API et vos identifiants auprès de Zelty
2. Définissez les données dont vous avez besoin (commandes, produits, paiements, rapports, etc.)
3. Implémentez une authentification sécurisée avec la clé API
4. Construisez la logique de synchronisation des données (en temps réel ou planifiée)
5. Gérez les erreurs, les tentatives de nouvelle exécution et la cohérence des données

Bien que l’API soit conviviale pour les développeurs, gérer la normalisation des données, la maintenance et l’évolutivité sur plusieurs systèmes POS peut rapidement devenir complexe.

Nos recommandations pour l’intégration à Zelty

Voici quelques bonnes pratiques pour assurer une intégration Zelty fiable et sécurisée :

• Sécuriser correctement les clés API
  Stockez les clés API de manière sécurisée, restreignez leur accès et renouvelez-les périodiquement pour réduire les risques de sécurité.
• Respecter les limites de requêtes et implémenter la résilience
  Même si aucune limite officielle n’est documentée, implémentez toujours une logique de retry, des stratégies de backoff et une gestion d’erreurs élégante.
• Utiliser le cache intelligemment
  Mettez en cache les données statiques ou semi-statiques (produits ou catégories) pour réduire les appels API inutiles et améliorer les performances.
• Normaliser le modèle de données dès le départ
  Les données Zelty doivent être mappées sur un modèle interne cohérent pour simplifier les intégrations en aval et l’analyse.

Pourquoi utiliser l’API Unified POS de Chift pour connecter Zelty ?

S’intégrer directement à Zelty n’est qu’une partie du défi. Maintenir plusieurs intégrations POS auprès de différents fournisseurs est coûteux et chronophage.

Avec l’Unified POS API de Chift, vous pouvez :

• Connecter Zelty et d’autres systèmes POS via une seule API
• Accéder à des données POS normalisées et standardisées
• Réduire l’effort de développement et de maintenance
• Déployer plus rapidement sur plusieurs marchés et fournisseurs POS
• Vous concentrer sur votre produit plutôt que sur les complexités spécifiques aux POS

Chift gère la fragmentation technique pour vous.

FAQ sur l’intégration API Zelty

Comment démarrer avec Zelty ?

Pour commencer, vous devez demander l’accès à l’API Zelty et obtenir une clé API. À partir de là, vous pouvez soit créer une intégration directe, soit utiliser l’Unified POS API de Chift pour connecter plus rapidement et à grande échelle.

Quelles sont les limites de requêtes de l’API Zelty ?

Zelty ne documente pas publiquement de limites spécifiques pour l’API.