Fichier : Export spécifique des durées hebdomadaires annualisées

Objet de l'interface

L’interface permet d’extraire les durées hebdomadaires annualisées depuis Timesquare de manière à mettre à disposition les informations attendues dans un fichier de type texte qui pourra être lu et interprété par une solution logicielle tierce. Cet export peut être réalisé à la demande ou de manière automatique.

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

Nom du fichier

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

Exemple : dha.txt.

Format

Texte. Encodage ANSI. Un caractère LF est présent en bout de ligne. La dernière ligne du fichier est une ligne vide. Il ne doit pas y avoir de ligne d’en-tête.

Séparateur entre deux informations

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

Description des lignes du fichier

#	Information exportée	Donnée tierce	Commentaire
01	Identifiant personne concernée	Matricule principal	A choisir parmi matricule, matricule paie, ou identifiant
02	Date du 1er jour de la semaine concernée	Date d'effet	Au format AAAAMMJJ
03	Champ technique obligatoire	Code régularisation	Constante = 7999
04	DHA calculée ou saisie issue de Timesquare	Valeur de la régularisation	Exprimé en heures et minutes HHMM
05	Champ technique obligatoire	Commentaire	Vide
06	Champ technique obligatoire	Type régularisation	Constante = 9999 (issue d'une interface)
...
49	Champ technique obligatoire		Vide
50	Champ technique obligatoire		Vide

Règles de gestion

Il est possible de définir la période d'export ainsi que d'exporter uniquement les DHA qui ont été modifiées depuis une période paramétrée dans l'export.

Les valeurs de durées hebdomadaires annualisées peuvent provenir d'un calcul d'annualisation, d'une saisie manuelle individuelle ou par lot depuis l'écran des résultats d'annualisation ou depuis l'import des durées hebdomadaires annualisées.

Au moment de l'export, la date d'export est enregistrée.

La colonne 2 correspond à la date du premier jour de la semaine pour laquelle on envoie une DHA. Dans le cas du premier jour de la période d'annualisation, il s'agit du premier jour de cette période et pas forcément le premier jour de la semaine. Exemple : Pour envoyer la première semaine de 2025, on envoie le 01/01/2025, bien qu'il s'agisse d'un mercredi.

Concernant le filtrage des dates, on exporte toutes les semaines qui ont un point commun avec la période d'export. Exemple : si je lance l'export le 05/06/2024
J-5 à J+10 --> 31/05/2024 au 15/06/2024 --> Semaines 22, 23 et 24
J-5 à J+12 --> 31/05/2024 au 17/06/2024 --> Semaines 22, 23, 24 et 25
J-7 à J+12 --> 29/05/2024 au 17/06/2024 --> Semaines 22, 23, 24 et 25

Cas des semaines partielles

Le partage des DHA envoie deux lignes en cas de semaine partielle.

CAS 1 : Au passage d’une période d’annualisation à une autre, par exemple un premier calcul d’annualisation du 01/01/2024 au 31/12/2024 et un autre du 01/01/2025 au 31/12/2025. La semaine du 30/12/2024  au 05/01/2025 est partiellement comprise dans le premier calcul (pour le 30 et le 31/12/2024) et partiellement comprise dans le 2ème calcul d’annualisation (du 01 au 05/01/2025).

Il existe 2 DHA pour la même semaine :

• Pour la période du 30/12/2024 au 31/12/2024, on a une DHA de 10h.
• Pour la période du 01/01/2025 au 05/01/2025, on a une DHA de 25h.

On renvoie deux lignes :

BRZ01;20241230;7999;1000;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

BRZ01;20250101;7999;2500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 2 : Lorsque la personne change de structure en milieu de semaine pendant une période d’annualisation et que l’ancienne structure et la nouvelle ne sont pas comprises dans le même calcul (changement de magasin par exemple).

Il existe 2 DHA pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 dans la structure A, on a une DHA de 10h
• Pour la période du 16/10/2024 au 20/10/2024 dans la structure B, on a une DHA de 25h

On renvoie une ligne pour la structure A  et une ligne pour la structure B :

BRZ01;20241014;7999;1000;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

BRZ01;20241016;7999;2500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 3 : Lorsque la personne change de structure en milieu de semaine pendant une période d’annualisation et que l’ancienne structure et la nouvelle sont dans le même calcul.

Il existe deux affectations pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 dans la structure A sans rupture
• Pour la période du 16/10/2024 au 20/10/2024 dans la structure B

On renvoie une seule ligne pour les deux structures A et B :

BRZ01;20241014;7999;3500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 4 A : Lorsque la personne change de contrat en milieu de semaine pendant une période d’annualisation sans changer de structure.

Il existe deux affectations de contrat pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 avec un contrat AA avec rupture
• Pour la période du 16/10/2024 au 20/10/2024 avec un contrat BB

On renvoie une seule ligne pour les deux contrats AA et BB :

BRZ01;20241014;7999;1000;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

BRZ01;20241016;7999;2500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 4 B : Lorsque la personne change de contrat en milieu de semaine pendant une période d’annualisation sans changer de structure.

Il existe deux affectations de contrat pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 avec un contrat AA sans rupture
• Pour la période du 16/10/2024 au 20/10/2024 avec un contrat BB

On renvoie une seule ligne pour les deux contrats AA et BB :

BRZ01;20241014;7999;3500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 5 : Lorsque la personne change de contrat en milieu de semaine pendant une période d’annualisation et change également de structure en restant dans le même calcul d’annualisation.

Il existe deux affectations de contrat (et structure) pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 avec un contrat AA dans la structure A sans rupture
• Pour la période du 16/10/2024 au 20/10/2024 avec un contrat BB dans la structure B

On renvoie une seule ligne pour les deux contrats AA et BB et les deux structures A et B :

BRZ01;20241014;7999;3500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

CAS 6 : Lorsque la personne change de contrat en milieu de semaine pendant une période d’annualisation et change également de structure en changeant de calcul d’annualisation.

Il existe deux affectations de contrat (et structure) pour la même semaine :

• Pour la période du 14/10/2024 au 15/10/2024 dans la structure A avec le contrat AA, on a une DHA de 10h
• Pour la période du 16/10/2024 au 20/10/2024 dans la structure B avec le contrat BB, on a une DHA de 25h

On renvoie une ligne pour la structure A  avec le contrat AA et une ligne pour la structure B avec le contrat BB :

BRZ01;20241014;7999;1000;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

BRZ01;20241016;7999;2500;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

Exemple de contenu

4001;20240115;7999;3145;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240122;7999;3945;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240129;7999;3330;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240205;7999;4015;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240212;7999;2915;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240219;7999;3800;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240226;7999;3515;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240304;7999;3845;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240311;7999;3830;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240318;7999;3300;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240325;7999;4030;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240401;7999;3315;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240408;7999;3345;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240415;7999;3445;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240422;7999;3300;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240429;7999;3300;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240506;7999;3300;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
4001;20240513;7999;3300;;9999;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;