informacje o tym przewodniku
podsumowanie
interfejs programowania aplikacji bezpośredniego wpłaty (API) pozwala aplikacji zarządzać konfiguracją bezpośredniego wpłaty pracownika.
Co nowego w tym poradniku?
w tej sekcji ogłosimy wszelkie nowe zmiany w interfejsie API wpłat bezpośrednich i tym przewodniku.
kwiecień 2020
następujące informacje zostały zmienione w tym przewodniku:
- w rozdziale 2-przypadki użycia: Pobierając bezpośredni depozyt pracownika, w sekcji odpowiedzi dodano przypadek testowy z linkami GitHub dla pracownika mającego wiele stanowisk.
- w Rozdziale 3 – Use Case: aktualizacja bezpośredniego depozytu pracownika, w sekcji odpowiedzi dodano następujące przypadki testowe z linkami GitHub:
- Dodano bezpośredni depozyt ze statusem nieaktywny.
- zaktualizował bezpośredni Status depozytu z nieaktywnego na aktywny.
- zaktualizował status bezpośredniego depozytu z aktywnego na nieaktywny.
- Dodano bezpośredni depozyt dla pozycji nie podstawowej.
- aktualizacja bezpośredniego depozytu dla pozycji nie podstawowej.
- zaktualizował żądanie i odpowiedź dla poniższego
- w Rozdziale 3 – Use Case: aktualizacja bezpośredniego depozytu pracownika, w sekcji odpowiedzi dodano bezpośredni depozyt, gdy kwota dystrybucji jest pusta.
- w rozdziale 6-Znane problemy i ograniczenia, następujące znane problemy i ograniczenia zostały usunięte po wprowadzeniu ulepszeń:
- US1293781: API daje odpowiedź 200, gdy przekazywany jest pusty rekord dla ilości dystrybucji
- US1331908: Niewłaściwy zasób użyty w Meta dla kodu opcji Prenote
- US1331919: brak walidacji dla niestandardowego pola daty Prenote
- US1221928: Aktywuj nieaktywny depozyt bezpośredni
obsługiwana wersja produktu i baza klientów
interfejs API depozytów bezpośrednich jest dostępny dla klientów ADP Workforce Now w Stanach Zjednoczonych (USA) i Kanadzie z funkcjami płacowymi.
Process Overview
Typical B2B Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
Payroll Practitioner |
Setup Direct Deposit konta w ADP Workforce. |
|
2 |
Twoja aplikacja |
Użyj interfejsu API zarządzania pracownikami, aby zsynchronizować dane pracowników między programem ADP workforce now a aplikacją. |
|
3 |
pracownik działu płac |
w aplikacji wybierz pracownika i rozpocznij działanie, aby wyświetlić bezpośrednie wpłaty. |
|
4 |
Twoja aplikacja |
Użyj interfejsu API bezpośredniego wpłaty, aby pobrać dane konfiguracji bezpośredniego wpłaty dla wybranego pracownika. |
|
5 |
pracownik działu płac |
w zgłoszeniu wyświetl dane dotyczące wpłat bezpośrednich pracownika. |
|
6 |
pracownik działu płac |
w zgłoszeniu zaktualizuj dane dotyczące wpłat bezpośrednich pracownika. |
|
7 |
Twoja aplikacja |
Użyj interfejsu API wpłat bezpośrednich, aby zastąpić dane konfiguracji wpłat bezpośrednich dla wybranego pracownika. |
Po pomyślnym przetworzeniu listy płac ADP automatycznie rozdziela środki z wynagrodzenia pracownika na jego konto wpłaty bezpośredniej zgodnie z konfiguracją wpłaty bezpośredniej.
Typical B2C Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
User |
Login to your application. |
|
2 |
użytkownik |
uwierzytelnij się, korzystając z poświadczenia ADP wydanego przez pracodawcę i zgody, aby umożliwić aplikacji pobranie danych bezpośredniego depozytu zarządzanego przez ADP danej osoby dla tego pracodawcy. |
|
3 |
Twoja aplikacja |
Użyj interfejsu API bezpośredniego wpłaty, aby pobrać dane konfiguracji bezpośredniego wpłaty. |
|
4 |
User |
In your application, view Direct Deposit setup data. |
|
5 |
User |
In your application, update Direct Deposit setup data. |
|
6 |
Twoja aplikacja |
użyj API wpłat bezpośrednich, aby zastąpić dane konfiguracji wpłat bezpośrednich dla użytkownika pod pracodawcą. |
Po pomyślnym przetworzeniu listy płac ADP automatycznie rozdziela środki z wynagrodzenia pracownika na jego konto wpłaty bezpośredniej zgodnie z konfiguracją wpłaty bezpośredniej.
wymagane kroki konfiguracji
w ADP Workforce teraz depozyt bezpośredni jest rodzajem odliczenia. Interfejs API wpłat bezpośrednich obsługuje wszystkie kody wpłat bezpośrednich skonfigurowane przez klientów. Klienci muszą upewnić się, że kody używane przez Twoją aplikację są dodawane i konfigurowane w interfejsie użytkownika (UI) ADP Workforce Now, wybierając Setup > narzędzia > tabele walidacji > Payroll > potrącenia i lokaty > lokaty.
Postman Collection
Postman pozwala na importowanie kolekcji API stworzonych przez innych, dzięki czemu można je wypróbować. Aby uzyskać więcej informacji na temat Postman, zobacz Tworzenie pierwszego wywołania API przy użyciu Postman.
aby pobrać Kolekcje API dla Worker Management API z biblioteki ADP GitHub i zaimportować je do Postman, przejdź do:
Direct Deposit API Collection.
o wpłacie bezpośredniej
wpłata bezpośrednia to funkcja Bankowa, umożliwiająca Twoim pracownikom automatyczne wpłacanie całości lub części wypłat na jedno lub więcej kont bankowych. Na przykład konta takie jak oszczędności, czeki, rynki pieniężne, IRAs i inne. Konfiguracja firmy kontroluje, ile bezpośrednich depozytów można skonfigurować dla pracownika. Na przykład konfiguracja firmy może pozwolić pracownikom na dodanie do trzech bezpośrednich depozytów lub do 500 bezpośrednich depozytów.
o Prenotification
Prenotification (lub prenote) jest, gdy bank testuje nowe konta depozytowe bezpośrednie przed dokonaniem rzeczywistych depozytów. Ma to na celu upewnienie się, że środki zostaną wpłacone na właściwe konto. Prenote zwykle trwa 10 dni. Podczas prenote bank powiadomi pracodawcę, jeśli użyto nieprawidłowego numeru routingu lub numeru konta. Pracownicy będą nadal otrzymywać negocjowalną (na żywo) wypłatę podczas prenote. Po prenote bezpośrednie wpłaty są dokonywane automatycznie. Ze względu na proces prenote, zmiany dokonane w depozycie bezpośrednim zwykle wymagają jednego lub dwóch cykli płacowych.
gdy dane bankowe pracownika są aktualizowane, prenote jest restartowana, zwykle na pięć dni. Pracownik otrzyma w tym czasie wynagrodzenie do negocjacji.
w ADP Workforce teraz klient może skonfigurować prenote do bezpośredniego wpłaty. Po skonfigurowaniu użytkownik może wybrać, aby wykonać prenote za pomocą jednej z następujących opcji:
- company Default-użyj standardowej daty zakończenia prenoty firmy.
- No Prenote-Pomiń prenote i dokonaj wpłaty jak najszybciej.
- Custom-Wybierz datę zakończenia z kalendarza.
opcja prenote jest włączona tylko dla żądanych klientów. Skontaktuj się z ADP, aby włączyć opcję prenote dla konkretnego klienta.
Leave a Reply