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

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 SmartPos 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 fluxentrants.txt.

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

Fichiers multiples

Les noms des fichiers d'import doivent suivre une syntaxe particulière incluant la date des données proposées. Le champ Libellé du fichier doit expliciter la nomenclature choisie. Ainsi, LibelléJJMMAAAA.EXT, LibelléJJMMAA.EXT, LibelléAAAAMMJJ.EXT ou LibelléAAMMJJ.EXT sont les dénominations retenues où :

• "Libellé" est une chaîne de caractères alphanumériques que je peux personnaliser
• "JJ" correspond au jour, "MM" correspond au mois, "AA" et "AAAA" correspond à l'année, qui peut être indifféremment renseignée sur 2 ou 4 caractères
• "EXT" une chaîne alphanumérique de trois caractères au maximum que je peux personnaliser

Exemple 1 : Le champ Libellé dans la configuration se nomme site1_JJMMAA.txt et les trois fichiers d'import se nomment site1_040520.txt, site1_050520.txt et site1_060520.txt.

Exemple 2 : Le champ Libellé dans la configuration se nomme fluxsiteAAAAMMJJ.001 et les trois fichiers d'import se nomment fluxsite20200504.001, fluxsite20200505.001 et fluxsite20200506.001.

Exemple 3 : Le champ Libellé dans la configuration se nomme AAMMJJ.txt et les trois fichiers d'import se nomment 040520.txt, 050520.txt et 060520.txt.

Format

Texte. Encodage UTF-8.

Séparateur entre deux informations

Le séparateur entre deux informations peut être le point-virgule, la virgule, la barre verticale ou la tabulation.

Description des lignes du fichier

Ordre	Nom du champ	Type	Remarques
01	Numéro du terminal	Numérique
02	Date de la donnée	Date	JJ/MM/AAAA
03	Tranche horaire	Heure	HH:NN (heures, minutes)
04	Chiffre d'affaire	Numérique signé
05	Nombre d'articles	Numérique
06	Nombre de coupons	Numérique
07	Nombre de transactions	Numérique
08	Temps de scanning	Numérique	Exprimé en secondes
09	Temps d'encaissement	Numérique	Exprimé en secondes
10	Temps de fermeture exceptionnelle	Numérique	Exprimé en secondes
11	Temps entre deux clients	Numérique	Exprimé en secondes
12	Temps hors vente	Numérique	Exprimé en secondes

Règles de gestion

• Le fichier peut comporter une ligne d'en-tête, elle sera rejetée sans empêcher l'exécution de
  l’interface.
• Si le filtre par caisse est activé, on sélectionne les lignes en comparant #01 avec la liste des
  caisses référencées dans le paramétrage.
• Le chiffre d'affaires pour une tranche horaire TH est égal à la somme de #04 des lignes pour
  lesquelles #03 est comprise entre TH et TH + 15 minutes.
• Le nombre de clients pour une tranche horaire TH est égal à la somme de #07 des lignes pour
  lesquelles #03 est comprise entre TH et TH + 15 minutes.
• Le nombre d'articles pour une tranche horaire TH est égal à la somme de #05 des lignes pour
  lesquelles #03 est comprise entre TH et TH + 15 minutes.
• Le nombre de caisses ouvertes pour une tranche horaire TH est égal au nombre de lignes ayant
  des valeurs de #01 différentes pour lesquelles :
  
  • #03 est comprise entre TH et TH + 15 minutes.
  • #07 est différent de 0.
    Il est possible de rencontrer pour une même tranche horaire plusieurs lignes avec la même
    valeur de #01. Dans ce cas, on ne compte qu'une seule fois la caisse dans le nombre de caisses
    ouvertes.
• Le nombre d'articles minute pour une tranche horaire est égal à 60 fois Nombre d'articles divisé
  par Temps de scanning (60x#05/#08).
• Le temps d'encaissement moyen est égal au temps d'encaissement divisé par le nombre de
  clients lorsque ce dernier n'est pas nul (#09/07#).
• Le temps inter clients moyen par client est égal au temps inter clients divisé par le nombre de clients lorsque ce dernier n’est pas nul (#11/07#).

Exemple de contenu

100;09/01/2024;07:45;2,99;1;0;1;29;20;0;6;0
100;09/01/2024;08:30;10,78;6;0;1;43;32;0;1877;0
100;09/01/2024;08:45;3,84;4;0;1;122;21;0;75;0
100;09/01/2024;09:00;92,62;23;0;5;419;198;0;1021;0
100;09/01/2024;09:15;43,63;16;0;3;108;155;0;294;0
100;09/01/2024;09:30;21,57;4;0;1;45;48;0;721;0
100;09/01/2024;09:45;37,44;12;0;2;224;77;0;865;0
100;09/01/2024;10:00;52,56;13;0;3;169;99;0;512;0
100;09/01/2024;10:15;54,33;30;0;4;318;231;0;436;0
100;09/01/2024;10:30;6,98;4;0;1;356;19;0;77;0
100;09/01/2024;10:45;17;13;0;3;384;70;0;981;0
100;09/01/2024;11:00;134,36;25;0;5;224;147;0;549;0
100;09/01/2024;11:15;88,97;34;0;5;369;115;0;533;0
100;09/01/2024;11:30;27,9;14;0;5;201;135;0;522;0