Aperçu
Nous sommes ravis d'annoncer un changement qui simplifiera la gestion des numéros d'employés dans notre système. Ce changement entraîne une nouvelle version de plusieurs points de terminaison d'API.
Auparavant, les numéros d'employé étaient limités à 6 chiffres, mais vous aurez bientôt la possibilité d'étendre le numéro d'employé jusqu'à 30 caractères et de configurer le format en fonction de vos besoins.
Vous aurez la possibilité de limiter le nombre de caractères à moins de 30 ou de le limiter à 100 chiffres, par exemple. 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. Ce changement 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 temps des employés par identifiant d'entité juridique | https://apis.paycor.com/v2/employees/{employeeId}/punches | Documentation |
| Obtenir les pointages des employés d'entité juridique par identifiant d'entité juridique | Afficher les pointages des cartes de temps 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 de 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 : les versions 1 de ces points de terminaison resteront entièrement fonctionnelles jusqu'en juillet 2025 au minimum, mais seront complètement abandonnées d'ici la fin de 2025 et ne pourront pas fournir de données pour ce champ si votre organisation passe à un numéro d'employé différent.
0 likes