Importation des produits en promotion depuis un fichier CSV/FTPS

L'importation des produits en promotion depuis un fichier CSV/FTPS permet l'importation automatique des produits en promotion dans Quant depuis un serveur FTPS. Grâce à cette importation, des actions peuvent être créées dans Quant lorsque des produits sont prévus pour être remisés. Vous pouvez utiliser cette option, par exemple, si vous utilisez l'impression d’étiquettes d'étagères depuis Quant. Les magasins peuvent alors imprimer les étiquettes modifiées avant le début de la vente des produits en promotion. L'importation d'actions peut également être utilisée pour les commandes automatiques, lorsqu'on s'attend à une augmentation de la demande pour les produits remisés pendant une action planifiée.

1.  Préparation du fichier pour l'importation

Tout d'abord, il est nécessaire de créer un fichier Excel contenant des informations sur chaque produit concerné par l'action. Le fichier doit inclure l'ID principal du produit, le nom de l'action, le type d'action, la date de début de l'action, la date de fin de l'action et le ou les magasins où l'action a lieu. Chaque ligne représente un produit promotionnel dans un ou plusieurs magasins spécifiques et chaque colonne représente une caractéristique spécifique de la promotion/action. Une fois le fichier prêt, il doit être exporté et enregistré au format CSV.

Fichier Excel avec les données des actions

2. Example de configuration d'importation

L'explication ci-dessous utilise les noms d'attributs du fichier présenté ci-dessus.

Attributs obligatoire:

  • ID produit : l'ID primaire du produit auquel l'action est liée.
  • Nom : nom spécifique de l'action (par exemple, Prospectus 09/2023).
  • Type d'action : un type d'action pouvant être réutilisé. Si le type d'action n'est pas encore créé dans Quant, il faut le créer manuellement avant de commencer l'importation.
  • Magasin : un ou plusieurs IDs de magasins concernés par l'action. Pour plusieurs magasins, les IDs doivent être séparés par un séparateur de liste.

Attributs optionnels :

  • Date de publication des étiquettes d'étagère: date à laquelle une nouvelle étiquette doit apparaître dans la section Étiquettes étagères préparées du magasin.

Si plusieurs produits ont le même nom d'action, même type d'action, mêmes magasins, mêmes dates de début et de fin, une seule action sera créée dans Quant. Sinon, par exemple en cas de différences dans les magasins ou les dates, plusieurs actions seront créées avec le même nom, mais les nombres de magasins ou les dates différents.

Exemple de configuration

3. Téléchargement du fichier sur le serveur FTPS

Téléchargez le fichier à importer dans le dossier approprié, par exemple actions sur le serveur FTPS.

4. Paramétrage de la tâche automatique

Dans la section Tâches automatiques, créez une nouvelle tâche Importer des produits en promotion depuis un fichier CSV.

Importer des produits en promotions depuis un fichier CSV

Avant de lancer l'importation, vous devez modifier les attributs suivants dans l'onglet Paramètres :

  • Cochez l'attribut Activé pour activer la tâche.
  • Renseignez les Extensions de fichiers.
  • Définissez correctement le Format du fichier CSV pour qu'il corresponde à votre fichier importé, notamment le jeu de caractères et les délimiteurs.
  • Dans la ligne Mappage des attributs des produits en promotion importables depuis CSV, assignez les attributs de Quant correspondants à toutes les colonnes que vous souhaitez importer.
  • Nous recommandons également de renseigner les e-mails pour les notifications, où vous pouvez saisir une ou plusieurs adresses e-mail auxquelles seront envoyés des e-mails relatifs aux statuts d’erreur.

Remplissez la ligne Adresse (serveur principal) avec « ftp.extech.eu », ainsi que votre Nom d'utilisateur (serveur principal) et Mot de passe(serveur principal) pour le serveur FTPS.

Indiquez dans le champ Chemin serveur (serveur principal) le nom du dossier où se trouve le fichier sur votre FTP.

Paramètres de tâches automatiques

  • Attributs

Vous trouverez ci-dessous une liste des autres attributs configurables pour une tâche automatique :

 Attribut 
 Description 
 Type 
Activé
Indique si la tâche automatique est active et si les données peuvent être transférées.
oui/non
Titre 
Nom personnalisé de la tâche automatique.
texte
Description 
Description personnalisée de la tâche automatique.
texte formaté
Fréquence
Fréquence à laquelle les fichiers doivent être importés depuis le FTPS.
    temps
Notes
Notes.
long text
Emails pour les notifications 

Une ou plusieurs adresses e-mail pour recevoir les messages d'erreur.

liste de chaînes
Extension de fichier
Extensions possibles que le fichier importé peut contenir.
texte formaté
Modèle de nom de fichier 
Filtrage des fichiers à importer selon une expression. Pas nécessaire si un seul fichier dans le dossier.
texte
Extraire les fichiers ZIP 
A cocher si vous importez un fichier compressé.
oui/non
Avertir si aucun fichier à importer depuis
Date après laquelle une absence d'import génère une alerte.
sélection de la date
Chaînes de valeur vides
Valeurs à ignorer ou traiter comme chaînes vides.
texte formaté
Séparateur de colonnes 
Délimiteur de colonnes utilisé dans le fichier CSV.
sélection
Échappement
A cocher si le fichier utilise les caractères d'échappement.
oui/non

Caractère d'échappement

Caractère utilisé pour l'échappement.
texte formaté
Ignorer le caractère d'échappement  
A cocher pour ignorer le caractère d'échappement.
oui/non
Mappage des attributs des produits en promotion importables depuis CSV
Attributs de Quant associés aux colonnes à importer.
texte formaté
Jeu de caractères
Jeu de caractères utilisé dans le fichier CSV.
sélection
Nombre de lignes d'en-tête
Nombre de lignes servant d'en-tête.
nombre
Séparateur décimal 
Symbole utilisé comme séparateur decimal.
sélection
Valeur de chaîne pour VRAI
Valeur représentant « VRAI », par exemple 1.
texte
Unité de mesure 
Unité utilisé comme cm, mm etc.
sélection
Séparateur des éléments de liste
Délimiteur utilisé dans les listes.
sélection
Format de date
Format des dates, ex. 31.12.19.
sélection
Hôte du serveur principal
Par défaut "ftp.extech.eu", sauf si vous utilisez votre propre serveur.
texte
Port du serveur principal
Standard 21.
texte
Nom d'utilisateur (serveur principal)
Identifiant d'accès au serveur FTPS.
texte
Mot de passe (serveur principal)
Mot de passe d'accès au serveur FTPS.
texte
Type de client FTP (serveur principal) 
Type de client FTP utilisé.
sélection
SSL implicite (serveur principal)
A cocher si vous utilisez SSL par défaut. Sinon, le SSL explicite est utilisé:
oui/non
FTP simple (serveur principal)
A cocher pour utiliser le FTP sans chiffrement.
oui/non
Ne pas modifier les fichiers sources (serveur principal)
A cocher pour laisser le fichier sur le FTPS après importation.
oui/non
Chemin du serveur (serveur principal)
Nom du dossier où se trouve le fichier prix, ex. actions
texte

Tous les magasins pour la liste des magasins vide

A cocher si vous souhaitez que l'action soit appliquée à tous les magasins si aucun magasin n'est renseigné.

oui/non

5. Lancement de la tâche automatique

Une fois tous les paramètres nécessaires configurés, vous pouvez lancer immédiatement l'importation via le bouton Lancer ou attendre que l'importation s'exécute automatiquement selon la fréquence définie. Une fois la tâche automatique réussie, un message apparaîtra en haut à droite pour confirmer l'importation. Vous pouvez ensuite verifier dans la section Actions, si les actions ont bien été importées.

Lancement de la tâche automatique
Actions dans les magasins individuels
Actions dans tous les magasins

Si l'importation a échoué, vous trouverez plus de détails sur les raisons de l'échec dans le Journal d'exécution.

6. Journal d'exécution

Dans l'onglet Journal d'exécution, vous pouvez consulter un récapitulatif de chaque exécution de la tâche automatique, avec les statistiques, erreurs et avertissements.

En sélectionnant une ligne, vous pouvez afficher ses détails avec le bouton Afficher les éléments.

Journal d'exécution

Si une tâche se termine avec une erreur ou un avertissement, vous pouvez consulter le message d'erreur ou d'avertissement correspondant via les boutons Afficher les erreurs et Afficher les avertissements.

Afficher les erreurs et les avertissements