Aperçu
Nous sommes ravis d'annoncer une modification visant à simplifier la gestion des numéros d'employés dans notre système. Cette modification entraîne une nouvelle version de plusieurs points de terminaison d'API.
Auparavant, les numéros d'employé étaient limités à 6 chiffres. Vous pourrez bientôt les étendre jusqu'à 30 caractères et configurer le format selon vos besoins.
Vous pouvez, par exemple, limiter le nombre de caractères à moins de 30 ou définir un numéro d'employé entièrement numérique. Par défaut, le numéro d'employé de chaque client Paycor est défini sur 6 chiffres. Pour vous préparer à ce changement, consultez la section « Actions à entreprendre » de cet article. Cette modification est obligatoire, que vous étendiez ou non vos numéros d'employé.
Mesures à prendre
Si vous disposez actuellement d'une intégration entre Paycor et un tiers, examinez les points de terminaison de la version 2 et connectez-vous à vos ressources techniques qui ont créé votre solution d'intégration avec Paycor et ajustez-vous pour commencer à consommer les versions 2 de ces API, si vous les consommez.
Remarques :
- Le numéro d'employé, à partir de la version 2 et de tout point de terminaison d'API publique nouvellement introduit, sera fourni sous forme de chaîne plutôt que sous forme d'entier.
- Si votre système ne peut pas prendre en charge les lettres ou un certain nombre de caractères que Paycor prend désormais en charge (30), sachez que chaque client peut configurer cela lui-même et que par défaut, le numéro d'employé est limité à 6 chiffres.
- Le processus d'activation n'aura pas besoin d'être terminé pour accéder à la version 2 de ces points de terminaison, car les données auxquelles on accède restent les mêmes.
Consultez cette feuille de calcul pour obtenir des détails techniques sur les points de terminaison de l’API publique concernés.
| Nom de l'API publique | Nom d'accès aux données | URL de l'API publique | Lien vers la documentation |
|---|---|---|---|
| Obtenir l'employé par EmployeeID | Afficher les informations sur les employés | https://apis.paycor.com/v2/employees/{employeeId} | Documentation |
| Obtenir les employés par identifiant d'entité juridique | Afficher les employés de l'entité juridique | https://apis.paycor.com/v2/legalentities/{legalEntityId}/employees | Documentation |
| Obtenir les employés par TenantID | Afficher les employés locataires | https://apis.paycor.com/v2/tenants/{tenantId}/employees | Documentation |
| OBTENIR l'identification des données des employés par identifiant d'entité juridique | Afficher les données d'identification des employés de l'entité juridique | https://apis.paycor.com/v2/legalentities/{legalEntityId}/employeesIdentifyingData | Documentation |
| Ajouter les heures et les revenus des employés à Paygrid | Importer les heures et les revenus des employés dans Paygrid | https://apis.paycor.com/v/legalentities/{legalEntityId}/payrollhours | Documentation |
| Importer les heures de paie vers l'employé | Importer les heures de paie vers l'employé | https://apis.paycor.com/v2/employees/{employeeId}/payrollhours | Documentation |
| Obtenir les pointages des cartes de pointage des employés d'une entité juridique par identifiant d'employé | Afficher les pointages des cartes de pointage des employés par identifiant d'entité juridique | https://apis.paycor.com/v2/employees/{employeeId}/punches | Documentation |
| Obtenir les pointages des employés d'une entité juridique par identifiant d'entité juridique | Afficher les pointages des cartes de pointage des employés par identifiant d'entité juridique | https://apis.paycor.com/v2/legalEntities/{legalEntityId}/punches | Documentation |
| Obtenir les accumulations des employés par EmployeeID | Afficher les congés accumulés des employés par identifiant d'employé | https://apis.paycor.com/v2/employees/{employeeId}/timeoffaccruals | Documentation |
| Obtenir les accumulations des employés par identifiant d'entité juridique | Afficher les congés accumulés des employés par identifiant d'entité juridique | https://apis.paycor.com/v2/legalentities/{legalEntityId}/timeoffaccruals | Documentation |
| Créer un employé | Créer un employé | https://apis.paycor.com/v2/employees | Documentation |
| Amener les employés dans l'état d'intégration | Voir les employés intégrés par l'entité juridique | https://apis.paycor.com/v2/legalentities/{legalEntityId}/onboardingemployees | Documentation |
Ces événements pour les employés sont les seuls événements concernés par ce changement :
- Employé créé
- Employé supprimé
- Mises à jour des informations sur les employés
Si vous utilisez des abonnements aux événements, notez que le champ URL de référence de la ressource sera mis à jour pour pointer vers la version 2 de ce point de terminaison. Il n'est pas nécessaire de mettre à jour, de modifier votre accès aux données ou de réactiver l'application, car ces points de terminaison sont rétrocompatibles.
Remarque : la version 1 de ces points de terminaison restera entièrement fonctionnelle jusqu'en juillet 2025 au minimum, mais sera complètement abandonnée d'ici la fin de 2025 et ne pourra pas fournir de données pour ce champ si votre organisation passe à un numéro d'employé différent.
0 likes