Fichier : Import spécifique de données de caisse Evolutel

Objet de l'interface

L’interface permet d’importer les données stockées par tranche horaire de type nombre de clients, nombre d’articles, nombre de caisses ouvertes et chiffre d’affaires de manière automatique depuis l’outil Evolutel vers la solution Timesquare.

Le principe est de mettre à disposition les informations attendues dans un fichier de type texte qui sera lu et interprété par l’interface de façon à mettre à jour la base de données.

En savoir plus sur le paramétrage de cet import.

Nom du fichier

Le fichier peut être nommé de deux façons selon que le système tiers le mettant à disposition génère un fichier différent pour chaque jour ou un fichier unique contenant une ou plusieurs journées d’historique.

Fichier unique

Le nom du fichier d'import est libre (libellé + extension) mais une fois défini dans le paramétrage de l’import, il ne doit plus changer.

Exemple 1 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux donnees_magasin.txt.

Exemple 2 : le champ Libellé dans la configuration et le fichier d'import se nomment tous les deux historique_Timesquare.001.

Fichiers multiples

Le nom de fichier peut être variable. L’utilisateur devra alors renseigner l’un des 3 libellés suivants, qui sont les noms de fichier habituellement produits par Evolutel :

• ficWSTC117_AAMMJJ.txt
• ficWLST117_AAMMJJ.txt
• ficWLST317_P_G_NNN_AAMMJJ.txt

Où :

• "AAAA" correspond à l'année
• "MM" correspond au mois
• "JJ" correspond au jour

Dans le dernier nom de fichier :

• "G" représente un code de gestion propre à Evolutel (alphanumérique de taille 1) qui peut varier d’un site à l’autre
• "NNN" représente une liste de critères propre à Evolutel (alphanumérique de taille 3) qui peut varier d’un site à l’autre.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations est le point-virgule.

Import manuel en sFTP

Dans le cas d’un import manuel de fichier, il est nécessaire de passer par la liaison sFTP entre Evolutel et Timesquare.

Description des lignes du fichier

Le fichier comporte des lignes dont le contenu est variable à partir de la troisième colonne de chaque ligne.

Le contenu est identifiable à partir des valeurs présentes dans les deux premières colonnes.

Colonnes communes

Ordre	Nom du champ	Type	Taille	Remarques
#01	Taille de la ligne donnée	Numérique	3	999 Représente le nombre de caractères de la ligne en comptant à partir du 4eme caractères
#02	Type de donnée sur la ligne	Alphanumérique	1	Prend la valeur M, R, J, V ou E

Colonnes suivantes selon la valeur de la colonne #02

• #02 = M pour la première ligne du fichier

Ordre	Nom du champ	Type	Taille	Remarques
#03	Première ligne	Alphanumérique		Peut être ignoré
Exemple de ligne : 007;M;978;

• #02 = R pour ajouter une remarque

Ordre	Nom du champ	Type	Taille	Remarques
#03	Ligne de commentaire	Alphanumérique		Peut être ignoré
Exemple de ligne : 029;R;/*  (clôture du 06/05/21)

• #02 = J pour la date des données à importer

Ordre	Nom du champ	Type	Taille	Remarques
#02	Date de données	Date	6	AAMMJJ
Exemple de ligne : 010;J;210506;

• #02 = V pour les valeurs de données de caisse

Ordre	Nom du champ	Type	Taille	Remarques
#03	Tranche horaire et numéro de caisse	Numérique	7	HHNN999 où HHNN : tranche horaire 999 : numéro de caisse
#04	Nombre d’articles	Numérique signé	11	+/-999999.999
#05	Nombre de clients	Numérique signé	7	+/-999999
#06	Valeur du chiffre d’affaires	Numérique signé	11	+/-999999.999
#07	Date de la donnée	Numérique	6	AAMMJJ
Exemple de ligne : 050;V;0900005;+000028.000;+000003;+0000188.67;210506

• #02 = E pour la dernière ligne du fichier

Ordre	Nom du champ	Type	Taille	Remarques
#03	Ligne de commentaires	Alphanumérique
Exemple de ligne : 046;E;/* Fin consolidation (clôture du 06/05/21);

Règles de gestion

Le choix des données associées est le même que pour l’interface standard caisse.

Le chiffre d’affaires pour une tranche horaire TH est égal à la somme de #06 des lignes dont #02 est égal à TH.

Le nombre de clients pour une tranche horaire TH est égal à la somme de #07 des lignes dont #02 est égal à TH.

Le nombre d’articles pour une tranche horaire TH est égal à la somme de #08 des lignes dont #02 est égal à TH.

Le nombre de caisses ouvertes pour une tranche horaire TH est égal au nombre de lignes ayant des valeurs de #05 différentes pour lesquelles :

• Partie tranche horaire de #03 est égal à TH
• #05 est différent de 0

Il est possible de rencontrer pour une même tranche horaire plusieurs lignes avec la même valeur de #03 dans ce cas, on ne compte qu’une seule fois la caisse dans le nombre de caisses ouvertes.

Si l’option Affecter la valeur à la tranche horaire précédente est activée alors les valeurs normalement affectées à la tranche horaire TH seront affectées à la tranche horaire qui la précède. Exemple : TH-15 dans le cas de données 15 minutes.

Si le filtre par caisse est activé, on sélectionne ou on exclut les lignes en comparant #03 avec les caisses référencées dans le paramétrage.

Exemple de contenu

007;M;978;
029;R;/* (clôture du 06/05/21);
010;J;210506;
050;V;0800002;+000000.000;+000000;+0000000.00;210506;
050;V;0800040;+000000.000;+000000;+0000000.00;210506;
050;V;0815002;+000000.000;+000000;+0000000.00;210506;
050;V;0815004;+000000.000;+000000;+0000000.00;210506;
050;V;0815040;+000000.000;+000000;+0000000.00;210506;
050;V;0830002;+000000.000;+000000;+0000000.00;210506;
050;V;0830004;+000000.000;+000000;+0000000.00;210506;
050;V;0830005;+000000.000;+000000;+0000000.00;210506;
050;V;0830011;+000000.000;+000000;+0000000.00;210506;
050;V;0830012;+000000.000;+000000;+0000000.00;210506;
050;V;0830017;+000000.000;+000000;+0000000.00;210506;
050;V;0830021;+000000.000;+000000;+0000000.00;210506;
050;V;0830040;+000000.000;+000000;+0000000.00;210506;
050;V;0830050;+000000.000;+000000;+0000000.00;210506;
050;V;0845005;+000017.000;+000002;+0000038.39;210506;
050;V;0845009;+000002.000;+000001;+0000003.48;210506;
050;V;0845011;+000012.000;+000002;+0000037.69;210506;
050;V;0845017;+000032.000;+000004;+0000064.97;210506;
050;V;0845021;+000008.000;+000002;+0000018.25;210506;
050;V;2045001;+000000.000;+000000;+0000000.00;210506;
…
050;V;2045007;+000000.000;+000000;+0000000.00;210506;
050;V;2045010;+000000.000;+000000;+0000000.00;210506;
050;V;2045011;+000000.000;+000000;+0000000.00;210506;
050;V;2045040;+000000.000;+000000;+0000000.00;210506;
046;E;/* Fin consolidation (cloture du 06/05/21);