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'à 10 caractères et configurer le format selon vos besoins.
Vous pouvez, par exemple, limiter le nombre de caractères à moins de 10 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 (10), 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.
Suivez ces étapes pour passer de la version 1 à la version 2 :
1. Accédez au portail des développeurs et connectez-vous.
- Pour savoir comment créer votre compte de portail de développeur, consultez le guide de création de compte de portail de développeur .
2. Cliquez sur API .
3. À l’aide du menu déroulant, sélectionnez Version 2 .
- Exemple de version 1 :
- Exemple de version 2 :
Remarques :
- Tous les points de terminaison ne disposent pas d’une version 2 disponible.
- Si la version 2 d’un point de terminaison n’est pas disponible, vous pouvez utiliser la version 1 à la place.
- 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 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é
- Mise à jour des employés
- Obtenir l'employé par identifiant d'employé
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 points de terminaison de la version 1 ne seront plus pris en charge après juillet 2025. Assurez-vous que toutes les modifications ont été effectuées avant cette date.
394 views 1 likes