Importer des cartes-cadeaux
Dernière mise à jour : 20 mai 2026, 17 h 10
- Vue d'ensemble de l'importation des cartes-cadeaux
- Formatez votre rapport de responsabilité des cartes-cadeaux pour l'importation
- Meilleures pratiques pour les fichiers CSV
- Importer des fichiers de cartes-cadeaux dans Toast
- Limitations de l'outil d'importation des cartes-cadeaux
- Questions fréquemment posées
Vue d'ensemble de l'importation des cartes-cadeaux
| Les étapes de cet article sont destinées à l'importation de cartes-cadeaux d'une autre plateforme de point de vente (PDV) ou d'un fournisseur de cartes-cadeaux vers Toast Gift Cards. Si vous recherchez des conseils sur les cartes-cadeaux de tiers, consultez les articles suivants : |
Si vous avez des cartes-cadeaux existantes d'un autre PDV (point de vente) ou d'un fournisseur de cartes-cadeaux et que vous passez à Toast Gift Cards, vous devrez importer votre rapport de responsabilité des cartes-cadeaux pour pouvoir les utiliser avec notre système. Pour obtenir votre rapport de responsabilité des cartes-cadeaux, vous devez contacter votre précédent fournisseur de cartes-cadeaux.
Si votre paquet d'intégration comprend l'importation de cartes-cadeaux : suivez les instructions pour préparer et formater vos fichiers CSV, puis envoyez une copie de ces fichiers à votre consultant en intégration et il s'assurera que les fichiers sont importés correctement. Si vous importez ces données vous-même, suivez toutes les étapes de cet article pour garantir un import réussi.
Remarque : Toutes les cartes-cadeaux importées ne seront pas compatibles avec le système de point de vente Toast. Si vous ne pouvez pas glisser vos cartes-cadeaux, vous pourrez saisir manuellement le numéro de carte pour tous les types de cartes importées.
Retour en haut
Formatez votre rapport de responsabilité de carte-cadeau pour l'importation
Il existe deux statuts de cartes-cadeaux différents lors de l'importation :
- Cartes-cadeaux actives : Cartes-cadeaux avec un solde.
- Cartes-cadeaux inactives : Cartes-cadeaux qui n'ont pas été vendues ou qui n'ont pas de valeur chargée.
Les cartes-cadeaux actives et inactives doivent être soumises dans des fichiers séparés. Il ne doit y avoir aucun en-tête dans les colonnes de ces fichiers (Exemple : Solde de la carte-cadeau, Numéro de carte, etc.).
- Vos fichiers de cartes-cadeaux actives doivent inclure :
- Une colonne avec les numéros de carte-cadeau entièrement non masqués
- Une colonne avec les soldes actuels des cartes-cadeaux
- Vos fichiers de cartes-cadeaux inactives doivent inclure :
- Une colonne avec les numéros de carte-cadeau entièrement non masqués
- Une colonne avec les numéros de carte-cadeau entièrement non masqués
Remarque : Un masque complet signifie que le numéro ne doit pas contenir d'astérisques ni de lettres. Il doit s'agir d'une valeur numérique complète.
Exigences de formatage supplémentaires :
- Les soldes doivent être indiqués en dollars, et non en cents.
- Les numéros de carte doivent être indiqués en entier et ne doivent pas apparaître en notation scientifique (par exemple, sous forme d'exposant).
- Tous les zéros initiaux sur vos cartes doivent être inclus dans le numéro de carte indiqué dans vos fichiers.
- Chaque rapport de responsabilité doit contenir au maximum 15 000 lignes. Si vous avez plus de 15 000 cartes-cadeaux en circulation, veuillez diviser les données en plusieurs fichiers.
- Les rapports doivent être soumis au format Excel (.xlsx) ou CSV (.csv). Les fichiers PDF ne sont pas acceptés.
Remarque :Si vous avez à la fois des cartes-cadeauxactivesetinactives, vous devrez d'abord formater et importer vos cartes-cadeaux actives. Différents outils de tableur (par exemple, Excel, Google Sheets) traitent les fichiers CSV différemment. Pour en savoir plus, consultez la sectionMeilleures pratiques pour les fichiers CSVde cet article pour vous assurer que vous formatez correctement votre fichier et évitez toute erreur d'importation.
Pour apprendre à importer des cartes-cadeaux dans Toast, regardez la vidéo suivante ou lisez les étapes énumérées ci-dessous.
Retour en haut
Meilleures pratiques pour l'importation de cartes-cadeaux pour les fichiers CSV
Souvent, lorsque vous recevez votre rapport de responsabilité de carte-cadeau de votre précédent fournisseur de cartes-cadeaux, le fichier sera au format CSV (valeurs séparées par des virgules). Les fichiers CSV peuvent être ouverts à l'aide d'outils de tableur comme Google Sheets ou Excel, mais cela peut parfois entraîner des erreurs telles que l'arrondi automatique des nombres, la suppression des zéros au début d'un nombre ou le raccourcissement (troncation) de certains nombres dans le fichier.
Pour éviter cela, assurez-vous que vousimportez votre fichier CSV dans un tableurau lieu de simplement ouvrir le fichier CSV avec votre outil de tableur.
Si vous utilisez Google Sheets :
- Ouvrez une feuille Google vierge, puis sélectionnez Fichier > Importer.
- Sélectionnez l'onglet Télécharger et choisissez le fichier que vous avez enregistré sur votre ordinateur.
- Une fenêtre contextuelle Importer le fichier apparaîtra.
- Sous Emplacement d'importation, sélectionnez Remplacer la feuille actuelle.
- Pour Type de séparateur, utilisez Virgule.
- Décochez Convertir le texte en nombres, dates et formules.
- Sélectionnez Importer les données pour continuer.
Si vous utilisez Excel, vous pouvez consulter cette documentation d'aide (lien externe) pour des instructions.
Une fois que vous avez importé votre fichier, examinez vos données pour vous assurer qu'aucun des nombres n'a été tronqué (raccourci) et que les données ressemblent à ce que vous attendez. Si vous voyez des zéros manquants, des nombres raccourcis ou arrondis, ou une notation scientifique, ouvrez une nouvelle feuille de calcul et essayez d'importer à nouveau votre fichier CSV en suivant les étapes ci-dessus.
Cartes Actives : Préparer et formater les fichiers CSV
- Importer le fichier CSV du rapport de responsabilité des cartes-cadeaux dans l'outil de feuille de calcul de votre choix (par exemple, Excel, Google Sheets). Consultez la section Meilleures pratiques pour les fichiers CSV pour des conseils sur la façon de le faire correctement et d'éviter les erreurs avec le format de votre fichier.
Remarque : Il est important de suivre ces étapes au lieu de simplement ouvrir un fichier CSV avec Excel ou Google Sheets pour éviter tout changement dans votre fichier (comme la suppression des zéros initiaux) qui pourrait entraîner l'échec de votre importation.
- Assurez-vous que le fichier pour vos cartes actives a exactement deux colonnes (sans en-têtes) répertoriant chacune Numéro de carte et son Solde. Supprimez toutes les autres lignes ou colonnes contenant des données inutiles. Supprimez toute information concernant les cartes inactives.
- Une fois terminé, enregistrez le fichier au format Valeurs séparées par des virgules (.csv) en sélectionnant Fichier>Télécharger. Sélectionnez Valeur séparée par des virgules. Notez que tous les numéros de carte et les soldes doivent être sur un seul onglet, et il ne doit pas y avoir d'informations en double (ou de numéros de carte qui ont été précédemment téléchargés). Sinon, l'importation générera une erreur. Toast recommande de nommer votre fichier comme "[Nom du restaurant] Cartes-cadeaux actives [Date]". Par exemple, Cartes-cadeaux actives de Blurred Limes 22/08/2023.
Cartes inactives : Préparer et formater les fichiers CSV
- Importez le fichier CSV des cartes-cadeaux inactives dans l'outil de tableur de votre choix (par exemple, Excel, Google Sheets). Consultez la section Meilleures pratiques pour les fichiers CSV pour des conseils sur la façon de le faire correctement et d'éviter les erreurs avec le format de votre fichier.
Remarque : Il est important de suivre ces étapes au lieu de simplement ouvrir un fichier CSV avec Excel ou Google Sheets pour éviter tout changement dans votre fichier (comme la suppression des zéros initiaux) qui pourrait entraîner l'échec de votre importation.
- Ce fichier n'aura qu'une seule colonne pour les numéros de carte (colonne A). Assurez-vous de ne pas ajouter de données inactives dans un onglet séparé, mais plutôt de créer un fichier séparé. Supprimez toutes les autres lignes ou colonnes contenant des données inutiles. Supprimez toute information concernant les cartes actives.
- Une fois terminé, enregistrez le fichier au format Valeurs séparées par des virgules (.csv) en sélectionnant Fichier>Télécharger. Sélectionnez Valeur séparée par des virgules. Notez que tous les numéros de carte doivent être sur un seul onglet, sinon l'importation générera une erreur. Toast recommande de nommer votre fichier comme "[Nom du restaurant] Cartes-cadeaux inactives [Date]". Par exemple : Cartes-cadeaux inactives de Blurred Limes 22/08/2023.
Importez les fichiers de cartes-cadeaux dans Toast
Tout d'abord, assurez-vous d'importer les cartes-cadeaux actives dans Toast avant d'importer vos cartes-cadeaux inactives.
- Dans Toast Web, accédez à Finances >Paiements > Cartes-cadeaux > Importer les cartes-cadeaux existantes.
- Pour le paramètre Type de cartes, assurez-vous que Cartes actives - Inclut les identifiants et les soldes en espèces pour toutes les cartes est sélectionné.
- Sélectionnez Choisir un fichier à côté de Télécharger CSV et sélectionnez la première liste CSV que vous avez créée (la liste des cartes actives).
- Entrez une valeur pour le Solde total attendu des cartes actives.
Remarque : Vous pouvez trouver le solde attendu en ouvrant votre feuille de calcul et en utilisant une formule pour calculer la somme de toutes les valeurs dans la colonne contenant les soldes des cartes. En savoir plus sur la fonction somme ici (lien externe). - Sélectionnez Valider en bas de la page afin que le système puisse vérifier les données.
- Après avoir reçu la confirmation que la validation a été effectuée avec succès, vous pouvez sélectionner Soumettre.
- Répétez les étapes ci-dessus pour le fichier de cartes-cadeaux inactives, mais assurez-vous de changer Type de cartes en Cartes inactives - Comprend uniquement les identifiants de cartes. Vous n'aurez pas à entrer une valeur de Solde total attendu puisque le fichier ne devrait contenir qu'une seule colonne avec des numéros de cartes-cadeaux.
Après avoir terminé votre importation de numéros de cartes-cadeaux actives et inactives, un membre de l'équipe Toast devra activer la recherche de cartes-cadeaux importées pour votre restaurant. Cela permettra aux clients d'utiliser votre site de recherche de cartes-cadeaux Toast pour consulter le solde de leur carte-cadeau importée et trouver le numéro de carte-cadeau Toast qui peut être échangé pour des commandes en ligne. Pour plus d'informations, consultez cet article du Centre d'assistance : Trouver des cartes-cadeaux importées via votre site de recherche de cartes-cadeaux Toast.
Limitations de l'outil d'importation de cartes-cadeaux
Veuillez garder à l'esprit que vous ne serez pas en mesure de faire ce qui suit :
- Modifier les valeurs des cartes-cadeaux en masse
- Supprimer des cartes-cadeaux en masse
- Lire d'autres fichiers importés qui ne sont pas au format .csv (délimité par des virgules)
Si vous avez commis une erreur lors de l'importation des cartes-cadeaux (par exemple, si vous avez accidentellement téléchargé toutes les cartes-cadeaux avec un solde de zéro), veuillez contacter le service clientèle pour obtenir de l'aide. Vous ne pouvez pas supprimer ou annuler vous-même une importation de cartes-cadeaux dans Toast Web.
Retour en haut
Questions fréquemment posées
J'ai reçu cette erreur lors de l'importation de mes cartes-cadeaux : Veuillez corriger les lignes suivantes dans le fichier, puis re-téléchargez-le. Comment puis-je le corriger ?
L' erreur de correction des lignes suivantes dans le fichier, puis re-téléchargez-le est généralement due à des informations incorrectes dans votre fichier d'importation de carte-cadeau. Consultez la section Aperçu et Meilleures Pratiques de cet article pour vous assurer que vous avez suivi les directives de formatage appropriées. Une fois que vous avez corrigé votre fichier, réessayez votre importation. Si vous rencontrez toujours des problèmes, contactez le service à la clientèle pour obtenir de l'aide.
J'ai reçu cette erreur lors de l'importation de mes cartes-cadeaux : La carte active n'a pas de solde. Comment puis-je le corriger ?
L' erreur de la carte active n'a pas de solde se produit parce qu'une des cartes actives répertoriées dans votre fichier CSV pour l'importation n'a pas de solde indiqué. Vérifiez le CSV que vous essayez d'importer pour vous assurer que toutes les cartes actives ont un solde associé.
Remarque : Les cartes actives et inactives doivent être importées dans des fichiers séparés.
J'ai reçu cette erreur lors de l'importation de mes cartes-cadeaux : Le solde total attendu doit avoir au maximum deux décimales et ne doit contenir que des valeurs numériques. Comment puis-je le corriger ?
L' erreur de solde total attendu doit avoir au maximum deux décimales et ne doit contenir que des valeurs numériques signifie que le nombre dans le champ Solde Total Attendu dans Toast Web est incorrect. Tout d'abord, confirmez que le nombre est au format numérique approprié et ne contient qu'un montant monétaire correct. Si cela est correct et que vous rencontrez toujours des problèmes, veuillez contacter le service à la clientèle pour obtenir de l'aide.
Que signifie « Toast n'a pas pu confirmer que les numéros de carte-cadeau importés ne sont pas devinables ? Toast ne conseille pas d'activer le paramètre ci-dessous » ?
Si vos numéros de carte-cadeau ont été attribués à votre restaurant dans un format séquentiel et facilement devinable, vous recevrez cette erreur en essayant d'activer la recherche de cartes par numéros importés sur la page de recherche publique de votre site de recherche de cartes-cadeau Toast pour prévenir la fraude. Pour plus d'informations sur ce paramètre, consultez Trouver un solde de carte-cadeau .