Articles

despre acest ghid

rezumat

interfața de programare a aplicațiilor de depunere directă (API) permite aplicației dvs. să gestioneze configurarea directă a depozitelor unui angajat.

ce este nou în acest ghid?

în această secțiune, vom anunța orice revizuiri noi ale API-ului Direct Deposit și ale acestui ghid.

aprilie 2020

următoarele informații au fost revizuite în acest ghid:

  • În capitolul 2 – caz de Utilizare: Recuperând depozitul direct al unui angajat, în secțiunea de răspuns, a fost adăugat un caz de testare cu link-uri GitHub pentru un angajat care are mai multe poziții.
  • în Capitolul 3-caz de Utilizare: actualizarea depozit direct unui angajat, în secțiunea de răspuns, următoarele cazuri de testare au fost adăugate cu link-uri GitHub:
    • adăugat un depozit Direct cu statutul de inactiv.
    • actualizat o stare de depozit Direct de la inactiv la activ.
    • actualizat o stare de depozit Direct de la activ la inactiv.
    • a adăugat un depozit Direct pentru o poziție non primară.
    • actualizat un depozit Direct pentru o poziție non-primar.
    • actualizat cererea și răspunsul pentru mai jos
  • În capitolul 3 – caz de Utilizare: actualizarea depozit direct unui angajat, în secțiunea de răspuns, un depozit Direct a fost adăugat atunci când o sumă de distribuție este gol.
  • în Capitolul 6-Probleme și limitări cunoscute, următoarele probleme și limitări cunoscute au fost eliminate de când s-au făcut îmbunătățiri:
    • US1293781: API dă un răspuns 200 atunci când o înregistrare goală este trecut pentru o sumă de distribuție
    • US1331908: Resursă greșită utilizată în Meta pentru codul opțiunii Prenote
    • US1331919: lipsește validarea pentru câmpul de dată prestabilită personalizat
    • US1221928: activați un depozit direct inactiv

versiunea produsului acceptată și baza de clienți

API-ul de depozit Direct este disponibil pentru clienții ADP Workforce now din Statele Unite (SUA) și Canada cu funcții de salarizare.

Process Overview

Typical B2B Application Integration Flow

Actor

Task Description

1

Payroll Practitioner

Setup Direct Deposit conturi în forța de muncă ADP acum.

2

aplicația dumneavoastră

utilizați API-ul worker management pentru a sincroniza datele angajaților între ADP workforce now și aplicația dvs.

3

salarizare Practitioner

în aplicația dvs., selectați un angajat și inițiați o acțiune pentru a vizualiza depozitele directe.

4

aplicația dumneavoastră

utilizați API-ul de depunere directă pentru a prelua datele de configurare a depozitelor directe pentru angajatul selectat.

5

salarizare Practitioner

în aplicația dvs., vizualizați datele de depunere directă ale unui angajat.

6

salarizare Practitioner

în aplicația dvs., actualizați datele de depozit directe ale unui angajat.

7

aplicația dumneavoastră

utilizați API-ul direct deposit pentru a înlocui datele de configurare direct deposit pentru angajatul selectat.

la procesarea cu succes a salarizării, ADP distribuie automat fonduri din salariul angajatului în contul lor de depozit Direct conform configurației de depozit Direct.

Typical B2C Application Integration Flow

Actor

Task Description

1

User

Login to your application.

2

utilizator

autentificați-vă utilizând acreditarea ADP emisă de angajator și consimțământul pentru a permite aplicației dvs. să recupereze datele de depunere directă gestionate de ADP pentru angajatorul respectiv.

3

aplicația dumneavoastră

utilizați API-ul de depunere directă pentru a prelua datele de configurare a depozitelor directe ale persoanei.

4

User

In your application, view Direct Deposit setup data.

5

User

In your application, update Direct Deposit setup data.

6

aplicația dumneavoastră

utilizați API-ul de depunere directă pentru a înlocui datele de configurare a depozitelor directe pentru utilizator sub angajator.

la procesarea cu succes a salarizării, ADP distribuie automat fonduri din salariul angajatului în contul lor de depozit Direct conform configurației de depozit Direct.

pașii de configurare necesari

în ADP Workforce acum, depozitul Direct este un tip de deducere. API-ul Direct Deposit acceptă toate codurile de depozit directe configurate de clienți. Clienții trebuie să se asigure că codurile utilizate de aplicația dvs. sunt adăugate și configurate în interfața de utilizator ADP Workforce Now (UI) selectând Setup > Tools > tabele de validare > Payroll > deduceri și depozite > depozite.

Postman Collection

Postman vă permite să importați o colecție de API-uri, create de alții, astfel încât să le puteți încerca. Pentru mai multe informații despre Poștaș, consultați efectuarea primului apel API folosind Poștaș.

pentru a descărca colecțiile API pentru API-ul Worker Management din biblioteca ADP GitHub și a le importa în Poștaș, accesați:
Direct Deposit API Collection.

despre Direct Deposit

direct deposit este o caracteristică bancară, care permite angajaților dvs. să aibă întregul salariu sau o parte din salariul lor depus automat într-unul sau mai multe conturi bancare. De exemplu, conturi precum economii, cecuri, piețe monetare, IRAs și altele. Configurarea unei companii controlează câte depozite directe pot fi configurate pentru un angajat. De exemplu, configurarea unei companii ar putea permite angajaților să adauge până la trei depozite directe sau până la 500 de depozite directe.

despre prenotificare

prenotificare (sau prenote) este atunci când o bancă testează noi conturi de depozit directe înainte de efectuarea depozitelor reale. Aceasta este pentru a vă asigura că fondurile sunt depuse în contul corect. Prenote durează de obicei 10 zile. În timpul precote, banca va notifica angajatorul dacă a fost utilizat un număr de rutare nevalid sau un număr de cont. Angajații vor continua să primească un salariu negociabil (live) în timpul notei prealabile. După prenote, depozitele directe se fac automat. Datorită procesului de prenote, modificările aduse unui depozit Direct durează în mod normal unul sau două cicluri de salarizare pentru a fi executate.

când informațiile bancare ale unui angajat sunt actualizate, prenote este repornit, de obicei timp de cinci zile. Angajatul va primi un salariu negociabil în acest timp.
În ADP forței de muncă acum, un client poate configura prenote pentru depozit Direct. După configurare, un utilizator poate selecta pentru a executa prenote folosind una dintre următoarele opțiuni:

  • Company Default – utilizați data de încheiere standard a companiei dvs.
  • no Presote – săriți presote și faceți depunerea directă cât mai curând posibil.
  • Custom – Selectați o dată de încheiere din calendar.

opțiunea prenote este activată numai pentru clienții solicitați. Contactați ADP pentru a activa opțiunea prenote pentru un anumit client.