Gestion des congés (XML)
- Bertrand Littel
Récupérer la liste des natures d'absences utilisables
L'action pour la récupération des natures d'absences est : NATURESABSENCE
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="NATUREABSENCE"/> | 2 | OUI | ||
| </dem> | 1 | Fermeture demande | OUI |
Ces service web permet de récupérer la liste des natures d'absences utilisables.
Elle correspond à la liste des codes EVT CRM auxquels on a associé un code EV PAIE.
Voir la fiche Ressources humaines / Fichiers / Evènements
Lors de la création des EV de paie, le libellé #DATES# sera remplace automatiquement par "du XX/XX/XXXX au YY/YY/YYYY".
<?xml version="1.0" encoding="UTF-8" ?> <dem> <action dos="998" nom="NATUREABSENCE" user="DEMO"> </action> </dem>
Exemple de réponse
<?xml version="1.0" encording="ISO-8859-1"?> <rep version="1"/> <action dos=998" nom="natureabsence"/> <element code="hcp" libelle="Congés payés" regrcod=""vaidn1="2" validn2="1"validrh="1" excluvalidn1="",nbjvalidmax="999"nbjrelmax="999" comoblig="1" saisiehfl="1"matindeb="2000-01-01T07:00:00" matinfin="2000-01-01T12:00:00"apremdeb="2000-01-01T13:00:00" apremfin="2000-01-01T19:00:00"/> <element code="hcss" lieblle="Congés sans solde" regrcod=""validn1="2" validn2="1"validrh="1" excluvalidn1=""nbjvalidmax="999" nbjrelmax="999" comoblig="1"saisiehfl="1" matindeb="2000-01-01T07:30:00" matinfin="2000-01-01T12:00:00" apremdeb="2000-01-01T13:00:00" apremfin="2000-01-01T19:00:00"/> <element code="hmal" libelle="Absence maladie" regrcod="" validn1="2" </rep>
ou
<?xml version="1.0" encording="ISO-8859-1"?> <rep version="1"/> <action dos=998" nom="natureabsence"/> <rep> <action dos="998" nom="natureabsene"/> <element code="hcp" libelle="Congés payés"/> <element code="hcss" libelle="Congés sans solde"/> <element code="hmal" libelle="Absence maladie"/> <element code)"hmat" libelle="Congés maternité"/> </rep>
Récupérer les soldes des congés des salariés.
L'action pour la récupération des soldes des congés est : SOLDES_CONGES
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="SOLDES_CONGES"/> | 2 | OUI | ||
| </dem> | 1 | Fermeture demande | OUI |
<?xml version="1.0" encoding="UTF-8" ?> <dem> <action dos="998" nom="SOLDES_CONGES" user="DEMO"> </action> </dem>
Exemple de réponse
<?xml version="1.0" encording="ISO-8859-1"?> <rep> <action dos="998" nom="soldes_conges"/> <individu individu="12" date_bul="2013-06-30"> <conges libelle="Cp en cours" acquis="2.080000" pris="0"/> <conges libelle="Cp écoulés" acquis="1.000000" pris="0"/> <conges libelle="Cp reliquat" acquis="0" pris="0"/> <conges libelle="Cumul droit RC" acquis="0" pris="0"/> <conges libelle="RTT acquis" acquis="3.740000" pris="0"/> <conges libelle="Dif" acquis="0" pris="0"/> </individu> <individu individu="13" date_bul="2013-06-30"> <conges libelle="Cp en cours" acquis="2.080000" pris="0"/> <conges libelle="Cp écoulés" acquis="9.000000" pris="0"/> <conges libelle="Cp reliquat" acquis="0" pris="0"/> </individu> </rep>
Création des Evt CRM d'absence
L'action pour la création d'un évènement CRM d'absence est : CREER_ABSENCE
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="CREER_ABSENCE"/> | 2 | OUI | ||
| <evt id="69876" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-15T18:00"/> | 3 | Liste des champs de l'évènement sous la forme nomduchamp = valeur | NON | Au moins les champs obligatoires d'un évènement |
| </action> | 2 | Fermeture action | OUI | |
| </dem> | 1 | Fermeture demande | OUI |
Exemples de champs principaux:
Id | identifiant du workflow agileo à l'origine de la création |
| Individu | Code de l'individu (tiers de l'EVT à créer) |
| Nature | Code de l'évènement |
| Debut | Début de l'évènement |
| Fin | Fin de l'évènement |
Pour créer une note associé à l'action : il faut rajouter une balise <note> sous la balise <evt>
Si l'attribut "numtel" est présent dans la balise <evt> le n° de téléphone est ajouté au libellé de l'EVT créé
<?xml version="1.0" encoding="UTF-8" ?> <dem> <action dos="998" nom="CREER_ABSENCE" user="DEMO"> <evt id="69876" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-15T18:00"/> </action> </dem>
Format de la réponse:
Id | identifiant du workflow agileo à l'origine de la création de l'EVT |
Individu | Code de l'individu (tiers de l'EVT à créé) |
Nature | Code de l'évènement |
Num_evt | N° de l'évènement créé |
Lib | Libellé de l'évènemen |
Exemple de réponse :
<?xml version="1.0" encording="ISO-8859-1"?> <rep> <action dos="998" nom="creer_absence"/> <evt id="158" action="Evènement créé" individu="12" code="hcp" num_evt="1991" libelle="CP du 20/07/2013 au 15/08/2013 - SAUNIER Sylvie" /> </rep>
Modifier un EVT CRM créé
L'action pour la modification d'un évèvement CRM est : MODIFIER_ABSENCE
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="MODIFIER_ABSENCE"/> | 2 | OUI | ||
| <evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-10T18:00"/> | 3 | Liste des champs de l'évènement sous la forme nomduchamp = valeur | NON | Au moins les champs obligatoires d'un évènement |
| </action> | 2 | Fermeture action | OUI | |
| </dem> | 1 | Fermeture demande | OUI |
Si l'évènement est intégré en paie (Partiellement ou totalement), ou si la date de début de l'évènement est >= à la date du jour, seule sa modification par le service RH est autorisé.
Attribut rhfl à 2 (rhfl="2") présent dans la balise <action>
<?xml version="1.0" encoding="UTF-8" ?> <dem> <action dos="998" nom="MODIFIER_ABSENCE"> <evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-10T18:00"/> </action> </dem>
Exemple de réponse :
<?xml version="1.0" encording="ISO-8859-1"?> <rep> <action dos="998" nom="modifier_absence"/> <evt id="158" action="Evèvement modifié" individu="12" code="hcp" num_evt="1191" libelle="CP du 20/07/2013 au 10/08/2013 - SAUNIER Sylvie"/> </rep>
Vérifier un EVT CRM d'absence
Permet de vérifier si un EVT CRM et/ou s'il est modifiable
L'action pour la vérification d'un évènement CRM est : VERIFIER_ABSENCE
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="VERIFIER_ABSENCE"/> | 2 | OUI | ||
| <evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-05T18:00"/> | 3 | Liste des champs de l'évènement sous la forme nomduchamp = valeur | NON | |
| </action> | 2 | Fermeture action | OUI | |
| </dem> | 1 | Fermeture demande | OUI |
<?xml version="1.0" encoding="UTF-8" ?>
<dem>
<action dos="998" nom="VERIFIER_ABSENCE" user="DEMO">
<evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-08-05T18:00"/>
</action>
</dem>
Exemple de vérification d'un EVT CRM intégré en paie jusqu'au 31/07 et date de fin ramenée au 05/08
- Exemple de réponse cas 1: demande debut="2013-07-20T08:00" fin="2013-08-05T18:00"
- Réponse ok : la date modifié 05/08/2013 est postérieure à la date d'intégration en paie (31/07)
<? xml version="1.0" encording="ISO-8858-1"?> <rep> <action dos="998" nom="verifier_absence"/> <evt id="158" action="Vérification ok" individu="12" code="hcp" num_evt="0" libelle="CP du 20-07-2013 ay=u 05-08-2013 - SAUNIER Sylvie"/> </rep>
- Exemple de réponse cas 1: demande de fin ramenée au 30/07 debut="2013-07-20T08:00" fin="2013-07-30T18:00"
- Réponse KO : date de fin antérieure à la date d'intégration en paie
<?xml version="1.0" encording="ISO-8859-1"?> <erreur code="7213" lib="Annulation interdite. Absence intégrée en paie jusqu'au30/07/2013/>
Annuler un EVT CRM
L'action pour l'annulation d'un évènement CRM est : ANNULER_ABSENCE
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="998" nom="ANNULER_ABSENCE"/> | 2 | OUI | ||
| <evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-07-30T18:00"/> | 3 | Liste des champs de l'évènement sous la forme nomduchamp = valeur | NON | Au moins les champs obligatoires d'un évènement |
| </action> | 2 | Fermeture action | OUI | |
| </dem> | 1 | Fermeture demande | OUI |
Si l'évènement est intégré en paie (Partiellement ou totalement), ou si la date de début de l'évènement est >= à la date du jour, seule sa suppression par le service RH est autorisé.
Attribut rhfl à 2 (rhfl="2") présent dans la balise <action>
!!! Attention !!! : il faudra saisir en paie les modifications d'EV PAIE si besoin.
<?xml version="1.0" encoding="UTF-8" ?>
<dem>
<action dos="998" nom="ANNULER_ABSENCE">
<evt id="158" individu="12" nature="hcp" debut="2013-07-20T08:00" fin="2013-07-30T18:00"/>
</action>
</dem>
Exemple de réponse :
<?xml version="1.0" encording="ISO-8859-1"?> <rep> <action dos="998" nom="annuler_absence"/> <evt id="158" action="Evènement annulé" individu="12" code="hcp" num_evt="1191" libelle="CP du 20/07/2013 au 30/07/2013 - SAUNIER Sylvie" /> </rep>
Export Evt INDIVIDU
L'action pour obtenir les évènements : IMPORT_EVT_IND
| Balise | Niveau | Contenu | Obligatoire | Remarques |
|---|---|---|---|---|
| <dem> | 1 | Ouverture demande | OUI | |
| <action dos="1" nom="IMPORT_EVT_IND"/> | 2 | OUI | ||
| <dates debut="2014-01-01T00:00" fin="2014-06-30T00:00"/> | 2 | debut fin | NON | |
| </action> | 2 | Fermeture action | OUI | |
| </dem> | 1 | Fermeture demande | OUI |
Restriction :
- Ne concerne que les codes évènement liés à une rubrique de PAIE
- Ne concerne que les EVT associés à un individu avec contrat valide
- Ne concerne pas les EVT de type annulation
- Ne concerne que les EVT contenus entièrement ou partiellement dans l'intervalle de dates définis
<?xml version="1.0" encoding="UTF-8" ?> <dem> <action dos="998" nom="IMPORT_EVT_IND" user="DEMO"> <dates debut="2014-01-01T00:00" fin="2014-06-30T00:00"/> </action> </dem>
Exemple de réponse :
<?xml version="1.0" encording="ISO-8859-1"?> <rep> <action dos="1" nom="import_evt_ind"/> <evt id="34" nature="hcp" libelle="CP du 27/12/13 AM au 10/01/14" debut="2013-12-27" code_debut="2" fin="2014-01-10" code_fin="2" individu="chk" cle="<Individu>,chk" statut="1"/> <evt id="32" nature="hrtt" libelle="RTT du 24 janvier" debut="2014-01-24" code_debut="1" fin="2014-01-24" code_fin="2" individu="chk" cle="<Individu>chk" statut="1"/> <evt id="38" nature="hcp" libelle="CP du 15 juin AP au 5 juillet MIDI" debut="2014-06-15" code_debut="2" fin="2014-07-05" code_fin="1" individu="chk" cle="<Individu>chk" statut="1"/> </rep>