Aperçu des exports de données Toast

Dans cet article :

• Aperçu des exports de données
• Configurer les exports
• Étapes pour créer une connexion SSH et se connecter à SFTP via Cyberduck et Terminal
  • Accès aux fournisseurs tiers
  • Accéder aux fichiers via Cyberduck
  • Accéder aux fichiers via le Terminal
• Sécurité des exports de données
• Données manquantes/incomplètes

Aperçu des exports de données

Certains restaurants peuvent avoir des systèmes tiers qui ont besoin d'importer des données de Toast régulièrement. Pour soutenir cela, Toast vous permet de configurer des exports automatisés nocturnes pour les types de données suivants :

• Ventes/Finances
  • Détails de la commande
  • Détails de paiement
  • Détails de la sélection des articles
  • Détails de la sélection des modificateurs
  • Détails de la cuisine
  • Gestion de la trésorerie
  • Mélange de produits (Tous les articles)
• Travail/Employé
  • Entrées d’heures
• Comptabilité
  • Comptabilité
• Configuration
  • Menu

Ce sont les mêmes fichiers d'exportation qui peuvent être téléchargés manuellement à partir des rapports en ligne sur Toast Web (le back-end de votre restaurant).

Les exportations sont généralement générées dans l'heure suivant l'heure de clôture configurée de chaque restaurant. Par défaut, l'heure de clôture d'un restaurant est 4 h 00, heure locale. Chaque fichier d'exportation contiendra les données pertinentes pour le jour ouvrable précédent.

Cette fonctionnalité exporte les rapports d'une journée par emplacement à la fois, et non des données agrégées pour une plage de dates. Les données sont conservées pendant sept jours avant d'être supprimées.

Si votre emplacement fait partie d'un groupe multi-emplacements au sein de Toast, les identifiants de connexion fournis par Toast donneront accès aux données exportées de tous les emplacements du groupe. Chaque emplacement aura son propre dossier numéroté. Vous pouvez télécharger un rapport de vos Mappages de Numéros de Restaurant ici après vous être connecté à Toast Web.

Retour vers le haut

Configurer les Exportations

Vous devez contacter le Service à la Clientèle de Toast pour obtenir l'accès à l'exportation des données. Seuls les utilisateurs ayant la permission 8.3 Configuration d'Exportation des Données peuvent modifier la configuration de l'exportation des données pour votre groupe de restaurants. Une fois qu'un utilisateur a reçu cette permission, la page de configuration des Exportations de Données sera visible via Rapports > Paramètres > Exportations de Données.

Si le groupe de votre restaurant n'a pas encore été configuré pour les exportations, vous verrez le message d'avertissement suivant sur cette page :

Une fois que vous avez contacté le Service à la Clientèle de Toast et qu'ils ont configuré votre accès, vous pourrez activer et configurer les différents types de données exportables. Vous pouvez choisir le nom et l'ordre des colonnes que vous souhaitez exporter. Cet ordre et cette sélection resteront cohérents même si les colonnes de rapport par défaut sur le web changent avec les nouvelles versions de Toast.

Comme indiqué dans l'image ci-dessus, si votre restaurant fait partie d'un groupe de restaurants, la configuration d'exportation s'appliquera à tous les restaurants de ce groupe.

Retour vers le haut

Créer une clé SSH et recevoir votre exportation de données

Les étapes pour créer une clé SSH (Secure Shell) publique et ajouter la clé dans Toast Web sont décrites dans notre guide de la plateforme. Vous devrez contacter le service à la clientèle de Toast pour une exportation manuelle des données. Les exportations de données ne sont pas accessibles en libre-service pour le moment.

Retour vers le haut

Accès des fournisseurs tiers pour les exportations de données

1. Les fournisseurs tiers (partenaires des restaurants) devront suivre le processus ci-dessus et générer leurs propres clés SSH.
2. Le fournisseur tiers partagera ensuite sa clé SSH publique avec le contact utilisateur du restaurant.
3. L'utilisateur du restaurant ajoutera ensuite la clé SSH du fournisseur tiers dans le back-end de Toast sur la page des clés SSH (voir les images ci-dessus).
4. Lorsque les étapes ci-dessus sont complètes, le fournisseur tiers pourra accéder aux exportations de données en utilisant le nom d'utilisateur SFTP du client, l'URL du serveur et la clé SSH du tiers.

Retour vers le haut

Accéder aux fichiers d'exportation de données via Cyberduck

1. Créez une clé SSH pour l'emplacement et ajoutez-la à votre compte Toast. Référez-vous à Créer des clés SSH et ajouter à Toast Web.
2. Une fois la clé ajoutée, vous pouvez accéder à l'emplacement via Cyberduck.
   1. Si vous n'avez pas téléchargé Cyberduck, utilisez ce lien pour le télécharger sur votre ordinateur.
3. Ensuite, ouvrez Cyberduck et sélectionnez l'option Ouvrir une connexion .
   
    
   
   
4. Copiez l'URL du serveur de la page clé SSH sur le compte Toast Web. Collez ceci dans le champ du serveur dans Cyberduck.
   
    
   
   
5. Réglez le menu déroulant supérieur sur Protocole de transfert de fichiers SFTP.
   1. Collez l'utilisateur Exportation de données depuis la page Configuration du restaurant dans le champ Nom d'utilisateur, et laissez le champ mot de passe vide.
   2. Sélectionnez le fichier SSH privé sur votre appareil pour établir la connexion.
      
      
      
      
6. Sélectionnez le Bouton de connexion, puis sélectionnez Autoriser pour Empreinte digitale inconnue.
   
   
   
   
7. Cyberduck ouvrira le Bucket S3. Dans cette fenêtre contextuelle, vous verrez des dossiers contenant les Informations sur l'exportation de données.
   
   
   

Lorsque vous avez terminé votre travail avec l'exportation de données, retirez votre clé SSH du compte des emplacements via la page des clés SSH.

Retour vers le haut

Accéder aux fichiers d'exportation de données via le terminal

Pour accéder aux fichiers via le terminal, veuillez suivre ces étapes :

1. Naviguez vers Terminal sur votre Mac en sélectionnant simultanément Commande et la barre d'espace, puis recherchez Terminal. La fenêtre suivante devrait apparaître sur votre écran.
   
    
   
   
2. Ensuite, tapez la commande ssh-keygen et sélectionnez Entrée sur votre clavier pour commencer le processus de génération des clés SSH. 
   
3. Sélectionnez Entrée sur votre clavier pour enregistrer le fichier dans votre utilisateurs/.ssh/id_rsa dossier.
   1. Remarque : Vous n'avez pas besoin d'entrer d'informations pour la phrase de passe et pouvez simplement sélectionner Entrée deux fois pour passer.
      
      
      
      
4. Tapez la commande cat .ssh/id_rsa.pub et sélectionnez Entrée à nouveau pour créer votre clé ssh-rsa.
   
    
   
   
5. Surlignez et copiez la clé SSH ci-dessous, en commençant par ssh-rsa jusqu'à la droite avant que votre nom commence sur l'écran.
   1. Remarque : N'incluez PAS d'espace devant votre nom. Par exemple, dans la capture d'écran ci-dessus, vous devez mettre en surbrillance et copier ce qui suit :
      
      ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQCW38C1+EtwqrQhYMNg+Btl1EqVjzCPx3nnko7+hv/DrZeHcGnokluCA6jACn8UviRYxfFDictXwr70DAvP1y59jG7LjbRZL5pteWvJKG4t8CfR3LZkc4TUT6OALAcY5XRLh7/2Sf1PWG8miemOhXJX/2YD4cR6EvBR23w/CHiX7fAcpE/61TtBi4BZ8uB1ucQvCN9dRbp42VBWwXGSMMmwqGr2larvKeEIWw+ROYTKH0FNlS7k7377LZ12gG21cYu9PNhX9vnyiN2N5Zcfdpj5ecfGs69QHORv3zz1ZzxQY0pczOdQzT8j+QKyWhCC4OABz/12kjeJGtgHG2djxBe9hSjwnOtbuCU7wegHpZ8Ajs9MKBL2J+96v0FMbU675Ky70aQE7KgHpxYAQTXp7Qnw3e22enPI9v7Oe5R+N5U9l0abIOSd7n5vPmVCS2J0apIgVUVHrrDemgq7qiR7xD6Ll6LWV9e4e094GSKtvCA70EvvzUcCkbtcrgZC7OYwGL0=
      
      
6. Dans Toast Web, accédez à Rapports > Paramètres > Clés SSH.
7. SélectionnezAjouter une nouvelle clé.
   
    
   
   
8. Copiez et collez votre clé SSH, puis sélectionnez Ajouter la clé.
9. Une fois ajoutée, la configuration est terminée.
   
    
   
   

Retour vers le haut

Sécurité des exports de données

Le contenu du dossier de votre groupe de restaurants ne peut être consulté que par les utilisateurs ayant généré leur clé SSH et dont les clés publiques sont ajoutées à Toast Web, suivant le processus ci-dessus. Vous ne pouvez pas voir les données d'autres groupes de restaurants et vice versa. 

Si votre clé publique est compromise, l'accès de cette clé peut être révoqué en sélectionnant l'icône Supprimer à côté de la liste des clés publiques et en générant une nouvelle clé à ajouter à Toast Web.

Retour vers le haut

<3>Données manquantes/incomplètes

Une fois les exports de données traités, les données dans l'export resteront les mêmes que celles du moment/jour où elles ont été exportées. Toute modification apportée aux ventes/rapports d'un jour précédent dans Toast après l'exportation des fichiers ne sera pas reflétée dans l'exportation des données, car elle ne met pas automatiquement à jour les données.

Dates de vente avec des données modifiées ne peuvent pas être récentes par rapport à l'exportation des données. Les rapports dans Toast Web devront être exportés manuellement afin d'exporter des rapports avec des informations modifiées ou altérées.

Alternativement, un Partenaire de Rapport peut être utilisé pour permettre aux mises à jour d'être récupérées à nouveau selon les besoins par la plateforme des Partenaires. Veuillez naviguer vers Mes Intégrations sur votre compte Toast Web pour voir une liste des Intégrations de Rapport actuellement disponibles.

Retour vers le haut