om den här guiden
sammanfattning
Direct Deposit Application Programming Interface (API) låter din applikation hantera en anställds inställning för direktinsättning.
Vad är nytt i den här guiden?
i det här avsnittet kommer vi att meddela eventuella nya revideringar av Direct Deposit API och den här guiden.
April 2020
följande information reviderades i denna guide:
- I Kapitel 2 – användningsfall: Hämtning av en anställds direkta insättning, inom Svarssektionen, tillsattes ett testfall med GitHub-länkar för en anställd som hade flera positioner.
- I Kapitel 3 – användningsfall: uppdatering av en anställds direkta insättning, inom Svarssektionen, lades följande testfall till med GitHub-länkar:
- lade till en direkt insättning med status inaktiv.
- uppdaterade en direkt Insättningsstatus från inaktiv till aktiv.
- uppdaterade en direkt Insättningsstatus från aktiv till inaktiv.
- lade till en direkt insättning för en icke primär position.
- uppdaterade en direkt insättning för en icke-primär position.
- uppdaterad begäran och svar för nedan
- I Kapitel 3 – användningsfall: uppdatering av en anställds direkta insättning, inom Svarssektionen, tillsattes en direkt insättning när ett distributionsbelopp är tomt.
- I Kapitel 6-Kända problem och begränsningar togs följande kända problem och begränsningar bort sedan förbättringar gjordes:
- US1293781: API ger ett 200-Svar När en tom post skickas för ett distributionsbelopp
- US1331908: Fel resurs som används i Meta för Prenote Alternativkod
- US1331919: saknas validering för anpassat Prenote datumfält
- US1221928: aktivera en inaktiv direkt insättning
Produktversion och kundbas
API för direkt insättning är tillgängligt för ADP Workforce Now-kunder i USA (USA) och Kanada med lönefunktioner.
Process Overview
Typical B2B Application Integration Flow
|
|
Actor |
Task Description |
|
|---|---|---|---|
|
1 |
Payroll Practitioner |
Setup Direct Deposit konton i ADP Workforce nu. |
|
|
2 |
din ansökan |
din ansökan |
använd API för arbetarhantering för att synkronisera medarbetardata mellan ADP workforce Now och din applikation. |
|
3 |
Löneutövare |
i din ansökan väljer du en anställd och initierar en åtgärd för att se direkta insättningar. |
|
|
4 |
din ansökan |
använd direct deposit API för att hämta direktinsättnings installationsdata för den valda medarbetaren. |
|
|
5 |
Löneutövare |
i din ansökan, se en anställds direkta insättningsdata. |
|
|
6 |
Löneutövare |
uppdatera en anställds direkta insättningsdata i din ansökan. |
|
|
7 |
din ansökan |
använd direct deposit API för att ersätta direct deposit setup-data för den valda medarbetaren. |
vid framgångsrik lönebehandling distribuerar ADP automatiskt medel från arbetstagarens lön till sitt direkta insättningskonto per konfigurationen för direktinsättning.
Typical B2C Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
User |
Login to your application. |
|
2 |
användare |
autentisera med hjälp av den arbetsgivarutfärdade ADP-behörigheten och Samtycket för att låta din ansökan hämta individens ADP-hanterade direkta insättningsdata för den arbetsgivaren. |
|
3 |
din ansökan |
använd API: et för direkt insättning för att hämta individens installationsdata för direkt insättning. |
|
4 |
User |
In your application, view Direct Deposit setup data. |
|
5 |
User |
In your application, update Direct Deposit setup data. |
|
6 |
din ansökan |
använd direct deposit API för att ersätta direct deposit setup-data för användaren under arbetsgivaren. |
vid framgångsrik lönebehandling distribuerar ADP automatiskt medel från arbetstagarens lön till sitt direkta insättningskonto per konfigurationen för direktinsättning.
nödvändiga installationssteg
i ADP Workforce nu är den direkta insättningen en typ av avdrag. Direct Deposit API stöder alla direkta insättningskoder konfigurerade av kunder. Klienter måste se till att koderna som används av din ansökan läggs till och konfigureras i ADP Workforce Now användargränssnitt (UI) genom att välja Setup > verktyg > Valideringstabeller > lön > avdrag och insättningar > insättningar.
Postman Collection
Postman låter dig importera en samling API: er, skapade av andra, så att du kan prova dem. Mer information om Postman finns i Gör ditt första API-samtal med Postman.
för att ladda ner API-samlingar för Worker Management API från ADP GitHub-biblioteket och importera dem till Postman, gå till:
direct Deposit API Collection.
om direkt insättning
direkt insättning är en bankfunktion som gör det möjligt för dina anställda att få sina hela lönecheckar eller en del av sina lönecheckar insatta automatiskt på ett eller flera bankkonton. Till exempel konton som besparingar, kontroll, penningmarknader, IRA och andra. Ett företags inställning styr hur många direkta insättningar som kan konfigureras för en anställd. Till exempel kan ett företags inställning tillåta anställda att lägga till upp till tre direkta insättningar eller upp till 500 direkta insättningar.
om Prenotifiering
Prenotifiering (eller prenote) är när en bank testar nya direkta inlåningskonton innan faktiska insättningar görs. Detta är för att se till att pengarna sätts in på rätt konto. Prenote tar vanligtvis 10 dagar. Under prenote kommer banken att meddela arbetsgivaren om ett ogiltigt routningsnummer eller kontonummer användes. De anställda kommer att fortsätta att få en förhandlingsbar (live) lönecheck under prenote. Efter prenote görs direkta insättningar automatiskt. På grund av prenote-processen tar ändringar som görs i en direkt insättning normalt en eller två lönecykler som ska utföras.
När en anställds bankinformation uppdateras startas prenote om, vanligtvis i fem dagar. Arbetstagaren kommer att få en förhandlingsbar lönecheck under denna tid.
i ADP Workforce nu kan en klient konfigurera prenote för direkt insättning. Efter konfigureringen kan en användare välja att köra prenote med ett av följande alternativ:
- företagsstandard – använd företagets standard prenote slutdatum.
- No Prenote-hoppa över prenote och gör den direkta insättningen så snart som möjligt.
- Anpassad-Välj ett slutdatum från kalendern.
prenote-alternativet är endast aktiverat för de begärda klienterna. Kontakta ADP för att aktivera prenote-alternativet för en specifik klient.
Leave a Reply