このガイドについて
概要
Direct Deposit Application Programming Interface(API)を使用すると、アプリケーションは従業員のDirect Depositセットアップを管理できます。
このガイドの新機能は何ですか？このセクションでは、Direct Deposit APIとこのガイドの新しい改訂を発表します。
2020年4月
このガイドでは、次の情報が改訂されました。
- 第2章-ユースケース: 従業員の直接入金を取得すると、応答セクション内で、複数のポジションを持つ従業員のGitHubリンクを含むテストケースが追加されました。
- 第3章-ユースケース:従業員の直接預金の更新では、応答セクション内で、GitHubのリンクで次のテストケースが追加されました。
- ステータスがInactiveの直接預金を追
- 直接入金ステータスを非アクティブからアクティブに更新しました。
- 直接入金ステータスをアクティブから非アクティブに更新しました。
- 非プライマリ位置のための直接預金を追加しました。
- 非一次ポジションの直接預金を更新しました。
- 以下の要求と応答を更新しました
- 第3章-ユースケース：従業員の直接預金の更新では、応答セクション内で、分配金額が空白の場合に直接預金が追
- 第6章-既知の問題と制限では、拡張が行われたため、次の既知の問題と制限が削除されました。
- US1293781:apiは、配布量の空白のレコードが渡されたときに200応答を与えています
- US1331908: Prenoteオプションコードのメタで使用されているリソースが間違っています
- US1331919:カスタムPrenote日付フィールドの検証がありません
- US1221928:非アクティブな直接入金を有効にする
サポートされている製品バージョンと顧客ベース
Direct Deposit APIは、米国(米国)およびカナダのAdp Workforce Nowクライアントで利用できます。
Process Overview
Typical B2B Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
Payroll Practitioner |
Setup Direct Deposit 今ADPの労働力のアカウント。 |
|
2 |
あなたのアプリケーション |
従業員データを同期するには、ワーカー管理APIを使用します。今adpの労働力とあなたのアプリケーションの間。 |
|
3 |
給与プラクティショナー |
直接預金を表示するアクション。 |
|
4 |
あなたのアプリケーション |
直接預金APIを使用して直接預金を取得します選択した従業員の設定データ。 |
|
5 |
給与プラクティショナー |
アプリケーションで、従業員の直接預金データ。 |
|
6 |
給与プラクティショナー |
アプリケーションで、従業員の直接預金データ。 |
|
7 |
あなたのアプリケーション |
直接預金APIを使用して直接預金を置き換選択した従業員の設定データ。 |
給与処理が成功すると、ADPは直接預金設定ごとに従業員の給与から直接預金口座に自動的に資金を配
Typical B2C Application Integration Flow
|
|
Actor |
Task Description |
|---|---|---|
|
1 |
User |
Login to your application. |
|
2 |
ユーザー |
雇用者発行のADP資格情報を使用して認証し、お客様のアプリケーションがその雇用者の個人のadp管理の直接預金データを取得できるようにすることに同意します。 |
|
3 |
あなたのアプリケーション |
直接預金APIを使用して個人を取得しますの直接入金設定データ。 |
|
4 |
User |
In your application, view Direct Deposit setup data. |
|
5 |
User |
In your application, update Direct Deposit setup data. |
|
6 |
あなたのアプリケーション |
直接預金APIを使用して直接預金を置き換雇用主の下にあるユーザーの設定データ。 |
給与処理が成功すると、ADPは直接預金設定ごとに従業員の給与から直接預金口座に自動的に資金を配
必要なセットアップ手順
ADP Workforceでは、直接預金は控除の一種です。 Direct Deposit APIは、クライアントが設定したすべてのDirect Depositコードをサポートします。 クライアントは、セットアップ>>>>>>>>預金。
Postman Collection
Postmanでは、他の人が作成したApiのコレクションをインポートできるので、試してみることができます。 Postmanの詳細については、「Postmanを使用した最初のAPI呼び出しの作成」を参照してください。
ADP GitHubライブラリからWorker Management APIのAPIコレクションをダウンロードし、Postmanにインポートするには、
Direct Deposit API Collectionに移動します。
直接預金について
直接預金は、従業員が給与全体または給与の一部を一つ以上の銀行口座に自動的に入金できるようにする銀行機能で 例えば、このような貯蓄、小切手、金融市場、IRAs、および他のようなアカウント。 会社の設定は、従業員に対して構成できる直接預金の数を制御します。 たとえば、会社の設定では、従業員が最大3つの直接預金または最大500の直接預金を追加できる場合があります。
Prenotificationについて
Prenotification（またはprenote）は、実際の預金が行われる前に銀行が新しい直接預金口座をテストするときです。 これは、資金が正しい口座に入金されていることを確認することです。 Prenoteは通常10日かかります。 Prenoteの間に、銀行は無効なルーティング番号または口座番号が使用された場合、雇用者に通知します。 従業員はprenoteの間に交渉可能な（生きている）給料を受け取り続けます。 Prenoteの後で、直接沈殿物は自動的になされます。 Prenoteプロセスのために、直接預金に加えられた変更は、通常、実行されるために一つまたは二つの給与サイクルを取ります。
従業員の銀行情報が更新されると、prenoteは通常五日間、再起動されます。 従業員はこの時間の間に交渉可能な給料を受け取ります。
ADP Workforce Nowでは、クライアントが直接入金用にprenoteを設定できるようになりました。 設定後、ユーザーは次のいずれかのオプションを使用してprenoteを実行するように選択できます。
- 会社のデフォルト–会社の標準のprenote終了日を使用します。
- 会社のデフォルト-会社の標準のprenote終了日を使用します。
- いいえPrenote–prenoteをスキップし、できるだけ早く直接預金を行います。
- カスタム–カレンダーから終了日を選択します。
prenoteオプションは、要求されたクライアントに対してのみ有効です。 特定のクライアントのprenoteオプションを有効にするには、ADPに連絡してください。
Leave a Reply