Fichier : Export spécifique Teams RH

Objet de l'interface

L’interface permet d’exporter les éléments variables de paie issus de Timesquare vers la solution Teams RH, pour une période donnée. Le principe est de mettre à disposition les informations attendues dans un fichier d’export (pour les compteurs uniquement), 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 libre (libelle.extension) mais une fois défini dans le paramétrage de l’export, il ne doit plus changer.

Séparateur entre deux informations

Si le fichier n'est pas de type Excel, le séparateur entre deux informations est configurable. Il peut être est la barre verticale, le point-virgule, la virgule ou la tabulation. Pour une sortie en XLS, le séparateur est toujours "Tabulation".

Fichier pour les compteurs

Format

Au moment de la configuration, je saisis ".txt" ou ".csv" comme extension dans le libellé de fichier pour avoir un fichier texte et je saisis ".xls" pour avoir un fichier de type Excel. Encodage UTF-8. 

Ligne en-tête

TABLE=PUBLIC.CEVT
SEPARATOR=; (uniquement si on n'a pas un fichier de type Excel)
COLUMNS=MCLI;MMAT;MCONTRAT;MRUB;N;T1;M1;T2;M2;TYPE;DDEB;DFIN;DORIGINE

Description des lignes du fichier

Nom du champ	Type	Format
Mcli	Alphanumérique	Numéro de dossier paramétrable dans la configuration de l'import
Matricule	Alphanumérique
Mcontrat	Alphanumérique	Colonne à laisser vide
Code rubrique	Alphanumérique
N	Numérique	Valeur exportée (avec deux décimales)
T1	Numérique	Colonne à laisser vide
M1	Numérique	Colonne à laisser vide
T2	Numérique	Colonne à laisser vide
TYPE	Alphanumérique	Valeur fixe : "$unit"
Date de début	Date	1er jour du mois de paie en cours de traitement (JJ/MM/AAAA)
Date de fin	Date	Dernier jour du mois de paie en cours de traitement (JJ/MM/AAAA)
Origine	Date	1er jour du mois de la date de début d'exécution (JJ/MM/AAAA)

Règles de gestion

Qu’il y ait des EVP ou non à extraire, le fichier exporté doit contenir une ligne de TOP (TOPPRES) pour chaque matricule traité. Cette ligne de TOP contient les valeurs suivantes :

• "TOPPRES" dans la colonne "Code rubrique"
• "1" dans la colonne "N"
• 1er jour de paie ou du contrat si la ressource est entrée en cours du mois dans les colonnes "Date de début" et "Date de fin" (voir structure des fichiers EVP).

Exemple : HD;0000750;;TOPPRES;1.00;;;;;;01/08/2022;31/08/2022;

Pour la colonne Origin, j'exporte la date de début de l’exécution car la rétroactivité n'est pas gérée.

Exemple de contenu

Exemple de fichier

TABLE=PUBLIC.CEVT
SEPARATOR=;
COLUMNS=MCLI;MMAT;MCONTRAT;MRUB;N;T1;M1;T2;M2;TYPE;DDEB;DFIN;DORIGINE
HD;0000797;;TOPPRES;1.00;;;;;;01/08/2022;31/08/2022;
HD;0000797;;ddd;162.75;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000797;;ccc;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000797;;bbb;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000797;;aaa;164.60;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000750;;TOPPRES;1.00;;;;;;01/08/2022;31/08/2022;
HD;0000750;;ddd;83.20;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000750;;ccc;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000750;;bbb;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000750;;aaa;81.50;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000733;;TOPPRES;1.00;;;;;;01/08/2022;31/08/2022;
HD;0000733;;ddd;162.75;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000733;;ccc;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000733;;bbb;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000733;;aaa;165.35;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000722;;TOPPRES;1.00;;;;;;01/08/2022;31/08/2022;
HD;0000722;;ddd;63.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000722;;ccc;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000722;;bbb;0.00;;;;;$unit;01/08/2022;31/08/2022;16/11/2022
HD;0000722;;aaa;67.33;;;;;$unit;01/08/2022;31/08/2022;16/11/2022

Fichier pour les absences

Format

Les données sont stockées dans un fichier ASCII de type texte.

Ligne en-tête

TABLE= PUBLIC.CABS
SEPARATOR=;
COLUMNS=MCLI;MMAT;MCONTRAT;MMOTIF;TYPE1;TYPE;DDEB;DFIN;NBH

Description des lignes du fichier

Nom du champ	Type	Format	Commentaire
Client	Alphanumérique		Numéro de dossier dans Timesquare
Matricule	Numérique		Matricule du salarié
Numéro de contrat	Numérique		Colonne vide
Motif de l'absence	Alphanumérique		Code absence dans Timesquare
Type de l'absence	Alphanumérique	Longueur max : 16 caractères	Valeur par défaut = « $std »
Périodicité	Alphanumérique	Longueur max : 16 caractères	Absence de type horaire = “$Horaire” Absence de type Jour = “$Jour” Absence de type matin = $demi Absence de type après-midi = $demi2
Date de début	Date		Date de début de l’absence au format AAAA-MM-JJ
Date de fin	Date		Date de fin de l’absence au format AAAA-MM-JJ
Nombre d'heures	NBH		A remplir uniquement si la périodicité = "$horaire$". A ne pas renseigner si la périodicité est différente de "$horaire$". (format : 000.00)

Règles de gestion

• Le fichier comporte une partie En-tête et une partie Détail.
• Les dates sont toujours au format AAAA-MM-JJ (longueur 10).
• Le séparateur de décimales est le point (.)
• Un même code absence ne peut pas avoir une périodicité heure et jour en même temps, il convient dans ce cas d’avoir deux codes absences, un avec une périodicité heure, l’autre jour.
• Pour les absences de types jours, on exporte seulement la date de début et la date de fin.
• Pour les absences de types heures, on exporte la date de début et la date de fin et le nombre d’heure en heures centième avec 2 décimales.
• Pour distinguer les deux fichier, on ajoute le suffixe “_Absences” pour le fichier des absences et “_EVP” pour le fichier des compteurs. Si par exemple je saisis le libellé “Export_ Paie.txt”, alors j'obtiens “Export_Paie_Absences.txt” pour le fichier des absences et “Export_Paie_EVP.txt” pour le fichier des compteurs.
• Pour les absence de type $demi (matin) et $demi2 (après-midi), les absences qui ont une heure de début et une heure de fin avant l’heure de basculement sont exportées avec le type “$demi” et les absences qui ont une heure de début et heure de fin après l’heure de basculement sont exportées avec le type “$demi2”. Pour les absences qui se chevauchent avec l’heure de basculement, on s'appuie sur l’heure de début de l’absence.
• L'ordre standard des colonnes est le suivant : Client, Matricule, Numéro de contrat, Motif de l'absence, Type de l'absence, Périodicité, Date de début, Date de fin, Nombre d'heures
• L'ordre spécifique des colonnes est le suivant : Client, Matricule, Numéro de contrat, Motif de l'absence, Date de début, Date de fin, Type de l'absence, Périodicité, Nombre d'heures

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. 

Exemple de contenu

Exemple de fichier

TABLE=PUBLIC.CABS
SEPARATOR=;
COLUMNS=MCLI;MMAT;MCONTRAT;MMOTIF;TYPE1;TYPE;DDEB;DFIN;NBH
R094;00035;;DELSE;$std;$horaire;2023-01-12;2023-01-12;001.87
R094;00035;;DELSE;$std;$horaire;2023-01-16;2023-01-16;002.50
R094;00035;;AUTNR;$std;$horaire;2023-01-19;2023-01-19;006.50
R094;00035;;CONGP;$std;$jour;2023-01-01;2023-01-07;
R094;00035;;MALAD;$std;$jour;2023-01-20;2023-01-31;
R094;00035;;CONGP;$std;$jour;2023-01-01;2023-01-02;
R094;00035;;EVFAM;$std;$jour;2023-01-21;2023-01-24;
R094;00035;;CONGP;$std;$jour;2023-01-30;2023-01-30;