Fichier : Export spécifique paie Pilote

Objet de l'interface

L’interface permet d’exporter les données de la répartition des heures travaillées par section issus de Timesquare vers la solution Pilote, pour une période donnée. Le principe est de mettre à disposition les informations attendues dans un fichier d’export, 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 export.

Nom du fichier

Le nom du fichier est fixe (PGTaammjj.txt) mais une fois défini dans le paramétrage de l’export, il ne doit plus changer.

Le nom du fichier exporté est composé d’une partie fixe "PGT", un horodatage qui correspond à la
date de l’exécution de l’export sous format "aammjj" ainsi que l’extension du fichier ".txt".

Selon la période de l’export renseignée (mensuelle ou hebdomadaire), j'obtiens deux fichiers différents, un fichier "PS3" pour une période mensuelle et "PS4" pour une période hebdomadaire.

Format

Fichier Excel de type XLSX.

Description des lignes du fichier

Structure des lignes de début et de fin

La première ligne et la dernière ligne commencent respectivement par "P01" et "P02" et sont utilisées
pour contrôler l’intégralité du fichier.

Structure de la ligne de début

N°	Nom du champ	Descriptif	Format/longueur	Exemple	Remarques
1	Clé	P01PS4001GTS	A (12)	P01PS4001GTS P01PS3001GTS	Une partie fixe avec PS4 (hebdomadaire) ou bien PS3 (mensuelle).
2	Code région	Nationale = 1 Nord-Ouest = 2 Ouest = 3 Sud = 5 Est = 6	NE (1)	5 pour "SUD"	Selon le paramétrage
3	Code société		NE (4)	1234	Selon le paramétrage
4	"EUR"		(3)		Une partie fixe
5	Date de l'exécution	C'est la date de l’exécution de l’export	AAAA/MM/JJ (10)	2024/05/23	Export exécuté le 23/05/2024
6	Heure de l'exécution	L'heure de l’exécution de l’export	HHNNSS (6)	140600	Export exécuté à 14h06
7	"PF0PMP"		(8)		Une partie fixe (avec 2 blancs au milieu)

Structure de la ligne de fin

N°	Nom du champ	Descriptif	Format/longueur	Exemple	Remarques
1	Clé	P02PS4001GTS	A (12)	P02PS4001GTS P02PS3001GTS	Une partie fixe avec PS4 (hebdomadaire) ou bien PS3 (mensuelle).
2	Code région	Nationale = 1 Nord-Ouest = 2 Ouest = 3 Sud = 5 Est = 6	NE (1)	5 pour Sud	Selon le paramétrage
3	Code société		NE (4)	1234	Selon le paramétrage
4	"EUR"		(3)		Une partie fixe
5	Date de l'exécution	C'est la date de l’exécution de l’export	AAAA/MM/JJ (10)	2024/05/23	Export exécuté le 23/05/2024
6	Heure de l'exécution	L'heure de l’exécution de l’export	HHNNSS (6)	140600	Export exécuté à 14h06
7	"PF0PMP"		(8)		Une partie fixe (avec 2 blancs au milieu)
8	Nombre de lignes	C'est le nombre de lignes du fichier	NE (7)	"0000002" pour 2 lignes	Hors lignes de début et ligne de fin avec des zéros à gauche

Fichier PS3 pour une période mensuelle

Ce fichier sert à exporter la répartition des heures travaillées mensuelles.

N°	Nom du champ	Descriptif	Format/longueur	Exemple	Remarques
1	IDMSG	Identifiant du message	A (3)	PS3	Valeur fixe
2	ANNEE	Année (AAAA)	NE (4)	2024	L'année de la période
3	MOI	Mois (MM)	NE (2)	12 pour décembre	Le mois de la période de l'export
4	REG	Code de la région : Nationale = 1 Nord-Ouest = 2 Ouest = 3 Sud = 5 Est = 6	NE (1)	5 pour Sud
5	PDV	Numéro du point de vente	NE (4)	1234	C'est le code société dans le paramétrage
6	Variables ventilées : 5 zéros (valeur fixe)
7	MLE	Matricule salarié	A (5)	00450	Selon le paramétrage
8	NUM_AFFEC	Numéro d’affectation	NE (2)	01	Valeur fixe
9	NCL	ID unique de la nomenclature nationale	NE (8)	00007773	Si ce n'est pas connu, alors 8 blancs
10	NCL1	Niveau 1 de la nomenclature	NE (2)	01 : ELDPH	Code de la tâche Niveau 1
11	NCL2	Niveau 2 de la nomenclature	NE (2)	05 : Epicerie	Code de la tâche Niveau 2
12	NCL3	Niveau 3 de la nomenclature	NE (2)	02 : Grignotages	Code de la tâche Niveau 3
13	NCL4	Niveau 4 de la nomenclature	NE (2)	10 : Biscuits sucrés	Code de la tâche Niveau 4
14	HRS_R	Nombre d'heures réalisées	NNNN.NN (7)	0005.00 pour 5 heures	En heure centièmes

Fichier PS4 pour une période hebdomadaire

Ce fichier sert à exporter la répartition des heures travaillées hebdomadaires.

N°	Nom du champ	Descriptif	Format/longueur	Exemple	Remarques
1	IDMSG	Identifiant du message	A (3)	PS3	Valeur fixe
2	DAT	Date de début de la semaine (le lundi)	AAAA/MM/JJ (10) (4)	2024/05/20
3	REG	Code de la région : Nationale = 1 Nord-Ouest = 2 Ouest = 3 Sud = 5 Est = 6	NE (1)	5 pour Sud	Selon le paramétrage
4	PDV	Numéro du point de vente	NE (4)	1234	C'est le code société dans le paramétrage
5	Variables ventilées : 5 zéros (valeur fixe)
6	MLE	Matricule salarié	A (5)	00450	Selon le paramétrage
7	NUM_AFFEC	Numéro d’affectation	NE (2)	01	Valeur fixe
8	NCL	ID unique de la nomenclature nationale	NE (8)	00007773	Si ce n'est pas connu, alors 8 blancs
9	NCL1	Niveau 1 de la nomenclature	NE (2)	01 : ELDPH	Code de la tâche Niveau 1
10	NCL2	Niveau 2 de la nomenclature	NE (2)	05 : Epicerie	Code de la tâche Niveau 2
11	NCL3	Niveau 3 de la nomenclature	NE (2)	02 : Grignotages	Code de la tâche Niveau 3
12	NCL4	Niveau 4 de la nomenclature	NE (2)	10 : Biscuits sucrés	Code de la tâche Niveau 4
13	HRS_R	Nombre d'heures réalisées	NNNN.NN (7)	0005.00 pour 5 heures	En heure centièmes

Règles de gestion

Chaque couple salarié / nomenclature (code externe de la tâche Timesquare) doit être unique pour un mois. En d’autres termes, il ne doit pas y avoir une même nomenclature rattachée au même salarié sur plusieurs lignes. Cette règle est applicable pour les fichiers "PS4" et "PS3".

Si plusieurs tâches ont le même code, alors toutes les heures travaillées pour le même salarié sont exportées dans la même ligne. Il est nécessaire de s’assurer de l’unicité des codes des tâches.

Les codes des tâches à utiliser sont à choisir dans la configuration de l’export. Pour les codes externes des tâches, il est nécessaire de les activer pour les clients concernés.

Les heures travaillées sont exportées en heures centièmes.

Les heures exportées sont récupérées des plannings réalisés de la période sélectionnée au moment du lancement de l’exécution.

Si une absence présente dans l'export est supprimée après la création de l'export, elle est également supprimée de l'export. Si l'absence supprimée est la dernière de la configuration, elle n'est pas supprimée et un message d'erreur s'affiche au moment de l'exécution de l'export. 

L’export intègre toutes les tâches de la structure sélectionnée ainsi que celles héritées d’une structure mère.

Exemple de contenu

Fichier PS3

P01PS3001GTS54321EUR2003/11/28141259PF0PM P
PS320020150434 0000100 060500000144.67
PS320020150434 0000400 990500000142.66
PS320020150434 0000900 010500000132.76
PS320020150434 0001700 091500000077.28
PS320020150434 0001700 990200000006.99
PS320020150434 0001700 990500000004.66
PS320020150434 0002200 026000000053.49
PS320020150434 0002200 025500000013.84
PS320020150434 0002200 025000000026.48
P02PS3001GTS54321EUR2003/11/28142028PF0PM P0002870

Fichier PS4 

P01PS4001GTS54321EUR2012/12/11141259PF0PM  P
PS42012120350434     0000100        060500000144.67
PS42012120350434     0000400        990500000142.66
PS42012120350434     0000900        010500000132.76
PS42012120350434     0001700        091500000077.28
PS42012120350434     0001700        990200000006.99
PS42012120350434     0001700        990500000004.66
PS42012120350434     0002200        026000000053.49
PS42012120350434     0002200        025500000013.84
PS42012120350434     0002200        025000000026.48
P02PS4001GTS54321EUR2012/12/11142028PF0PM  P0002870