Community

コミュニティをご利用の際は 【ガイドライン】を確認・同意いただいた上でご利用ください。

  • 投稿

    アバターhayashi

    従業員銀行情報(/api/v1/employees/{emp_id}/bank_account_rule)取得APIの仕様について

    お世話になっております。
    人事APIの仕様について教えてください。(こちらにお問い合わせしても大丈夫でしょうか?)
    1.従業員銀行情報(/api/v1/employees/{emp_id}/bank_account_rule)取得のとき
     入力パラメータとして year,monthといったものがあります。
     ①これは給与支給月という意味で宜しいでしょうか?
      口座情報はその支給月に実際に当時振り込みされた口座情報であって現在最新の口座情報とは異なる可能性があるでしょうか?
     ②支給月とすると支給実績がないと「該当なし」になるということでしょうか?
     ③一従業員銀行口座を登録できる数は最大3口だと認識してます。3口座登録されてたとして、上記年月で1つの口座しか振込がなかった場合、1つの情報のみしかGETできないでしょうか?

    2.更新された従業員の銀行情報だけ取得できるか?

    やりたいことはfreeeに登録している従業員の口座情報が変更された情報だけGETしたい(関連周辺システムへの連携)のですが、このAPIだけで可能でしょうか?
     イメージはDaily処理で当日UPDATEされた口座情報だけ引き抜きたい・・・

    以上、よろしくお願い致します。

    回答

    freee dev-supportfreee dev-support

    ご質問ありがとうございます。

    > 1.従業員銀行情報(/api/v1/employees/{emp_id}/bank_account_rule)取得のとき
    > 入力パラメータとして year,monthといったものがあります。
    > ①これは給与支給月という意味で宜しいでしょうか?
    > 口座情報はその支給月に実際に当時振り込みされた口座情報であって現在最新の口座情報とは異なる可能性があるでしょうか?
    > ②支給月とすると支給実績がないと「該当なし」になるということでしょうか?

    該当年月の従業員情報に設定されている情報になります。
    Web 画面からだと、
    『ホーム』=>『従業員一覧』=>『従業員詳細』
    ページで選択できる年月のデータが取得されます。

    > ③一従業員銀行口座を登録できる数は最大3口だと認識してます。3口座登録されてたとして、上記年月で1つの口座しか振込がなかった場合、1つの情報のみしかGETできないでしょうか?

    手元で挙動確認したところ常に口座1の情報が取得出来ていると思われます。
    もし口座1以外のデータが取得できた場合、挙動確認を進めてまいります。
    ご指摘ください。

    > 2.更新された従業員の銀行情報だけ取得できるか?

    現状更新されたかどうかの判定は出来かねてしまいます。
    日々 API のレスポンスを取得いただき比較いただく必要がございます。

    ご確認どうぞよろしくお願いいたします。

    アバターhayashi

    ご回答ありがとうございました。

    APIリファレンスで色々試してみます。

    取り急ぎ、以上

    freee dev-supportfreee dev-support

    ご確認ありがとうございます。
    引き続きどうぞよろしくお願いいたします。