À propos de ce guide
Résumé
L’Interface de programmation des applications de dépôt direct (API) permet à votre application de gérer la configuration du dépôt direct d’un employé.
Quoi de neuf dans ce guide?
Dans cette section, nous annoncerons toute nouvelle révision de l’API de dépôt direct et du présent guide.
Avril 2020
Les informations suivantes ont été révisées dans ce guide :
- Au chapitre 2 – Cas d’utilisation: Récupération du Dépôt direct d’un employé, dans la section Réponse, un cas de test a été ajouté avec des liens GitHub pour un employé ayant plusieurs postes.
- Dans le Chapitre 3 – Cas d’utilisation : Mise à jour du Dépôt Direct d’un employé, dans la section Réponse, les cas de test suivants ont été ajoutés avec des liens GitHub :
- Ajout d’un Dépôt direct avec le statut d’Inactif.
- Mise à jour du statut de Dépôt direct de Inactif à Actif.
- Mise à jour du statut de Dépôt direct de Actif à Inactif.
- Ajout d’un dépôt direct pour une position non principale.
- Mise à jour d’un dépôt direct pour une position non principale.
- Mise à jour de la demande et de la réponse pour le
- Ci-dessous Au Chapitre 3 – Cas d’utilisation : Mise à jour du Dépôt direct d’un employé, dans la section Réponse, un Dépôt direct a été ajouté lorsqu’un montant de distribution est vide.
- Dans le chapitre 6 – Problèmes et limitations connus, les problèmes et limitations connus suivants ont été supprimés depuis les améliorations apportées :
- US1293781 : L’API donne une réponse de 200 lorsqu’un enregistrement vierge est transmis pour un montant de distribution
- US1331908: Mauvaise ressource utilisée dans Meta pour le Code d’option Prénote
- US1331919 : Validation manquante pour le champ de date Prénote personnalisé
- US1221928 : Activer un Dépôt Direct Inactif
Version du produit prise en charge et Base de clients
L’API de dépôt direct est disponible pour les clients d’ADP Workforce Now aux États-Unis (États-Unis) et au Canada avec des fonctions de paie.
Process Overview
Typical B2B Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
Payroll Practitioner |
Setup Direct Deposit comptes dans ADP Workforce Maintenant. |
|
2 |
Votre application |
Utilisez l’API de gestion des employés pour synchroniser les données des employés entre ADP Workforce Now et votre application. |
|
3 |
Praticien de la paie |
Dans dans votre demande, sélectionnez un employé et lancez une action pour afficher les dépôts directs. |
|
4 |
Votre application |
Utilisez l’API de dépôt direct pour récupérer les données de configuration de dépôt direct pour l’employé sélectionné. |
|
5 |
Praticien de la paie |
Dans votre application, consultez les données de dépôt direct d’un employé. |
|
6 |
Praticien de la paie |
Dans votre demande, mettez à jour les données de dépôt direct d’un employé. |
|
7 |
Votre application |
Utilisez l’API de dépôt direct pour remplacer les données de configuration de dépôt direct pour l’employé sélectionné. |
Une fois le traitement de la paie réussi, ADP distribue automatiquement les fonds de la paye de l’employé à son compte de dépôt direct selon la configuration de dépôt direct.
Typical B2C Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
User |
Login to your application. |
|
2 |
Utilisateur |
Authentifier utiliser les informations d’identification et le consentement d’ADP émis par l’employeur pour permettre à votre demande de récupérer les données de dépôt direct gérées par ADP pour cet employeur. |
|
3 |
Votre application |
Utilisez l’API de dépôt direct pour récupérer les données de configuration de dépôt direct de la personne. |
|
4 |
User |
In your application, view Direct Deposit setup data. |
|
5 |
User |
In your application, update Direct Deposit setup data. |
|
6 |
Votre application |
Utilisez l’API de dépôt direct pour remplacer les données de configuration de dépôt direct pour l’utilisateur sous l’employeur. |
Une fois le traitement de la paie réussi, ADP distribue automatiquement les fonds de la paye de l’employé à son compte de dépôt direct selon la configuration de dépôt direct.
Étapes d’installation requises
Dans la main-d’œuvre d’ADP, le dépôt direct est maintenant un type de déduction. L’API de dépôt direct prend en charge tous les codes de dépôt direct configurés par les clients. Les clients doivent s’assurer que les codes utilisés par votre application sont ajoutés et configurés dans l’interface utilisateur (UI) d’ADP Workforce Now en sélectionnant Setup >Outils >Tables de validation >Paie > Déductions et Dépôts > Dépôts.
Postman Collection
Postman vous permet d’importer une collection d’API, créées par d’autres, afin que vous puissiez les essayer. Pour plus d’informations sur Postman, consultez Effectuer votre Premier appel API À l’aide de Postman.
Pour télécharger des collections d’API pour l’API de gestion des travailleurs à partir de la bibliothèque GitHub ADP et les importer dans Postman, accédez à :
Collection d’API de dépôt direct.
À propos du dépôt direct
Le dépôt direct est une fonction bancaire qui permet à vos employés de faire déposer automatiquement la totalité ou une partie de leur chèque de paie sur un ou plusieurs comptes bancaires. Par exemple, des comptes tels que l’épargne, le chèque, les marchés monétaires, les IRA et autres. La configuration d’une entreprise contrôle le nombre de dépôts directs pouvant être configurés pour un employé. Par exemple, la configuration d’une entreprise peut permettre aux employés d’ajouter jusqu’à trois dépôts directs ou jusqu’à 500 Dépôts directs.
À propos de la prénotification
La prénotification (ou prénote) est le moment où une banque teste de nouveaux comptes de dépôt direct avant d’effectuer des dépôts réels. C’est pour s’assurer que les fonds sont déposés dans le bon compte. Prenote prend généralement 10 jours. Au cours de la prénote, la banque informera l’employeur si un numéro d’acheminement ou un numéro de compte non valide a été utilisé. Les employés continueront de recevoir un chèque de paie négociable (en direct) pendant la période prénote. Après la prénote, les dépôts directs sont effectués automatiquement. En raison du processus prénote, les modifications apportées à un dépôt direct prennent normalement un ou deux cycles de paie à exécuter.
Lorsque les informations bancaires d’un employé sont mises à jour, prenote est redémarré, généralement pendant cinq jours. L’employé recevra un chèque de paie négociable pendant cette période.
Dans ADP Workforce Now, un client peut configurer prenote pour le dépôt direct. Une fois configuré, un utilisateur peut choisir d’exécuter la prénote en utilisant l’une des options suivantes :
- Entreprise Par défaut – Utilisez la date de fin de la prénote standard de votre entreprise.
- Pas de Prénote – Sautez la prénote et effectuez le dépôt direct dès que possible.
- Personnalisé – Sélectionnez une date de fin dans le calendrier.
L’option prenote est activée uniquement pour les clients demandés. Contactez ADP pour activer l’option prenote pour un client spécifique.
Leave a Reply