Yeap

Yeap Paye est une solution de gestion de la paie moderne. Ce logiciel SaaS français de nouvelle génération (PWA responsive) est pensé autour du low‑code et d’une forte ergonomie. Il vise à transformer la gestion de la paie en un processus agile, sécurisé et focalisé sur l’humain.

Envoyer les absences et les compteurs de paie à Yeap

Paramétrer une configuration API Yeap

Ajouter une configuration API Yeap Eléments variables de paie

Configuration / Interfaces / API / Yeap

1. Je clique sur le bouton Nouveau.
2. A partir de la section Identification, je saisis le libellé de la configuration.
3. Je sélectionne la structure à utiliser.
4. Je sélectionne la modèle "Eléments variables de paie".
5. A partir de la section Automatisation, je sélectionne si je souhaite autoriser l'automatisation de cette API. Cette option permet aux équipes techniques Holy-Dis de recenser les API qui doivent être automatisées afin de paramétrer cette automatisation.
6. A partir de la section Spécificités, je saisis le numéro de dossier associé au site.
7. définis l'identifiant de personne à envoyer : le matricule, le matricule paie, l'identifiant, divers 1, divers 2, divers 3 ou divers 4.
8. A partir de la section Filtre des personnes, je clique sur le bouton pour filtrer par contrat. Je sélectionne les contrats que je souhaite traiter.
9. Je clique sur le bouton pour filtrer par groupes. Je sélectionne les groupes que je souhaite traiter.
10. A partir de la section Rubriques à alimenter, je sélectionne dans la liste déroulante les compteurs que je souhaite exporter (je peux saisir les première lettres du compteur pour filtrer la liste) et le type de comptage souhaité (de date à date ou par cycle). Pour chaque élément, je précise le code rubrique associé dans Yeap. Je peux indiquer le pourcentage de pause à déduire pour les compteurs heures (pas les compteurs jours). Ce champ est facultatif. S'il n'y a pas de pause à déduire, je saisis 0. Exemple : Si je saisis 5 dans ce champ. Pour un compteur d'une valeur de 35h, alors la valeur exportée est 95% de ces 35h, c'est-à-dire 31h30.
11. J'enregistre.

Ajouter une configuration API Yeap Absences

Configuration / Interfaces / API / Yeap

1. Je clique sur le bouton Nouveau.
2. A partir de la section Identification, je saisis le libellé de la configuration.
3. Je sélectionne la structure à utiliser.
4. Je sélectionne la modèle "Absences".
5. A partir de la section Automatisation, je sélectionne si je souhaite autoriser l'automatisation de cette API. Cette option permet aux équipes techniques Holy-Dis de recenser les API qui doivent être automatisées afin de paramétrer cette automatisation.
6. A partir de la section Spécificités, je saisis le numéro de dossier associé au site.
7. définis l'identifiant de personne à envoyer : le matricule, le matricule paie, l'identifiant, divers 1, divers 2, divers 3 ou divers 4.
8. A partir de la section Filtre des personnes, je clique sur le bouton pour filtrer par contrat. Je sélectionne les contrats que je souhaite traiter.
9. Je clique sur le bouton pour filtrer par groupes. Je sélectionne les groupes que je souhaite traiter.
10. A partir de la section Absences à alimenter, je sélectionne dans la liste déroulante les absences que je souhaite exporter. Pour chaque absence, je précise le code événement associé dans Yeap.
11. J'enregistre.

Modifier une configuration API Yeap

Configuration / Interfaces / API / Yeap

1. Je clique sur le libellé de la configuration à modifier.
2. Je modifie les informations.
3. J'enregistre.

Supprimer une configuration API Yeap

Configuration / Interfaces / API / Yeap

1. Je sélectionne la configuration à supprimer.
2. Je clique sur le bouton Supprimer. Un message de confirmation s'affiche.
3. J'enregistre.

Déverser des informations dans Yeap

Les informations suivantes sont mises à jour au déclenchement de la configuration API Yeap Eléments variables de paie.

	Champs dans le body request		Obligatoire	Elément dans Timesquare
1	SIREN		Oui	Elément à renseigner dans la configuration
2	Emplois	ID	Non
3		Matricule	Non
4	Individu	ID	Non	IDD dans la BDD
5		Matricule	Oui	Selon le paramétrage (matricule, matricule paie, identifiant, etc.)
6	EVP	Rubrique	Oui	Code rubrique renseigné dans la configuration
7		Libellé	Oui	Libellé du compteur sélectionné
8		Mois	Oui	Le mois de la date de fin de la période renseignée
9		Année	Oui	L’année de la date de fin de la période renseignée
10	Data	Colonne	Non
11		Valeur	Oui	Le nombre d’heures / de jours du compteur
12		Est_valeur_nette	Non
13		Commentaire	Non

Les informations suivantes sont mises à jour au déclenchement de la configuration API Yeap Absences.

	Champs dans le body request		Obligatoire	Elément dans Timesquare
1	SIREN		Oui	Elément à renseigner dans la configuration (numéro de dossier)
2	Période	Mois	Oui	Le mois de la date de fin de la période renseignée
3		Année	Oui	L’année de la date de fin de la période renseignée
4	Identity data request	NIC	Non
5		Matricule individu	Oui	Selon le paramétrage (matricule, matricule paie, identifiant…)
6	Absence data	Type d'absence	Oui	Code de l’absence dans Timesquare
7		Date de début	Oui	Date et heure de début de l’absence
8		Type de début	Non
9		Date de fin	Oui	Date et heure de fin de l’absence
10		Type de fin	Non
11		Nombre de jours de carence	Non
12		Nombre de jours	Non
13		Jours calendaires	Non
14		Jours ouvrés	Non
15		Jours ouvrables	Non
16	Commentaire	Commentaire	Non
17		Note	Non
18	Subrogation	Subrogation active	Non	Par défaut à « False »
19		Est active	Non	Par défaut à « False »
20		Date début	Non
21		Date fin	Non
22		Compte bancaire ID	Non
23		Contact ID	Non
24	Nombre d'heures	Non
25	Répartition	Code	Non
26		Valeur	Non
27		Offset	Non
28	Données contextuelles détail	Code	Non
29		Valeur	Non
30	Indemnisation dérogation	Non	Par défaut à « False »
31	Données contextuelles indemnisation	Code	Non
32		Valeur	Non
33	Ignorer DNS	Non	Par défaut à « False »

Ce déclenchement peut se faire manuellement.

Lancer manuellement une configuration API Yeap

Configuration / Interfaces / API / Yeap

1. Je survole la configuration API Yeap à exécuter.
2. Je clique sur le bouton Exécuter.
3. La pop-in Exécution d'une configuration d'API s'affiche.
4. Je peux modifier :
   • La période sélectionnée pour l'exécution.
   • Les personnes sélectionnées pour l'exécution. Je peux utiliser le champ Recherche sur le prénom, le nom, la structure ainsi que sur le matricule / l'identifiant / le matricule paie (en fonction du paramétrage défini) pour faciliter la sélection.
5. Je valide.

Règles de gestion

Une personne sélectionnée dans l’exécution de la configuration d’api doit avoir le matricule (ou autre, suivant le choix de type d’identifiant effectué dans la configuration de l’api) égal au matricule de la personne dans Yeap. Pour les connaître, il faut exécuter la requête POST Salarie/search en précisant les SIRET (établissements) dans le body. Note : les établissements sont récupérables à travers la requête POST etablissement/search en précisant le SIREN dans le body.

Les rubriques définies dans la configuration doivent exister dans Yeap. Pour les connaître, il faut exécuter la requête GET modelisation/evps/{{siren}}. 

Les codes d’absences doivent exister dans Yeap. Pour les connaître, il faut exécuter la requête GET modelisation/famillestypesAbsence. 

Déroulement de l'exécution de la configuration API Yeap Elément variable de paie

A la validation du paramétrage d’exécution, l’exécution commence. Le déroulement est le suivant :

• Pour chaque personne sélectionnée dans le paramétrage d’exécution
  • Pour chaque compteur paramétré dans la configuration de l’api
    • Récupération de la valeur
      • Si date à date, récupération de la somme des valeurs de compteur sur la période d’exécution
      • Si cycle, récupération de la valeur de cycle existante sur la date de fin de la période d’exécution
  • Intégration des valeurs de chaque compteur dans YEAP. Appel api POST evp/valeurs/individu avec en body la liste des evps de la personne en question

Déroulement de l'exécution de la configuration API Yeap Absences

A la validation du paramétrage d’exécution, l’exécution commence. Le déroulement est le suivant :

• Suppression des absences des personnes concernées par l'exécution sur les mois inclus dans la période d'exécution de l'api. A noter que ce sont seulement les absences paramétrées dans la configuration qui sont supprimées. Pour chaque absence concernée, appel d’api DELETE /absence/{{absenceId}}
• Pour chaque personne concernée par l'exécution de l'api
  • Récupération des absences TSQ (paramétrées dans la config api) sur la période d'exécution
  • Intégration des absences dans YEAP. Appel api POST /absence avec en body la liste des absences de la personne en question

Liste des erreurs qui pourraient être rencontrées :

• Le partenaire Yeap n'existe pas ou n'est pas activé
• Il manque les informations d'API REST du partenaire Yeap (il faut avoir une information d’API pour Yeap, c'est-à-dire une ligne dans la table PARTNER_API_INFO)
• L'URL de type {0} n'existe pas (il faut que l'url de type ACTIVITY_PLANNING soit intégrée dans la table PARTNER_API_URL)
• Trop de requêtes ont été envoyées dans un laps de temps donné
• Erreur lors de la récupération du token d’accès
• Erreur lors de l'appel de l'API REST Yeap qui récupère les établissements par dossier
• Erreur lors de l'appel de l'API REST Yeap qui récupère la liste des salariés par établissement
• Erreur lors de l'appel de l'API REST Yeap qui récupère la liste des rubriques EVPs
• Erreur lors de l'appel de l'API REST Yeap qui récupère les types d'absences par famille
• Erreur lors de l'appel de l'API REST Yeap qui ajoute une valeur aux EVPs d'une période pour un individu
• Erreur lors de l'appel de l'API REST Yeap qui crée des absences
• Erreur lors de l'appel de l'API REST Yeap qui récupère les absences par dossier et par période
• Erreur lors de l'appel de l'API REST Yeap qui supprime l'absence dont l'identifiant est {0}

Vérifier l'activation de la solution

Je peux vérifier si Yeap est activé.

Activer Yeap

Pour activer Yeap, je prends contact avec les équipes Holy-Dis.

Ressources disponibles

• https://yeap.ai/