Community

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

  • 投稿

    アバターhiroshi

    人事労務API GET work_record_summaries の month の値がひとつ小さい

    こんにちは。
    https://developer.freee.co.jp/docs/hr/reference#/%E5%8B%A4%E6%80%A0%E6%83%85%E5%A0%B1%E3%82%B5%E3%83%9E%E3%83%AA/show ()
    /api/v1/employees/{emp_id}/work_record_summaries/{year}/{month}
    の URL の month の値に 3 を入れないと 2月の情報が取得できないのはなぜでしょうか?

    `

    curl -s -X GET "https://api.freee.co.jp/hr/api/v1/employees/$FREEE_EMP_ID/work_record_summaries/2021/3?company_id=$FREEE_COMPANY_ID" -H "accept: application/json" -H "Authorization: Bearer $FREEE_TOKEN" | jq | head -n5
    {
    "year": 2021,
    "month": 2,
    "start_date": "2021-02-01",
    "end_date": "2021-02-28",

    `

    回答

    アバターLT

    手元の環境で試したところ、「締め日支払い日」の設定で、支払い日の設定が「翌月」となっている締め日支払い日を設定している従業員は、指定した月の1つ前の月の勤怠情報が返ってきました。

    支払い日が「当月」の従業員は、指定した月と同じ月の情報が戻ってきました。

    なので、おそらく、hiroshiさまの確認された従業員の方も、翌月支払いの締め日支払い日を設定しているのではないかと思います。

    アバターhiroshi

    LTさん、返信ありがとうございます。

    > 手元の環境で試したところ、「締め日支払い日」の設定で、支払い日の設定が「翌月」となっている締め日支払い日を設定している従業員は、指定した月の1つ前の月の勤怠情報が返ってきました。

    なるほど。からくりはわかりました。

    ところで、 LTさんは freee の中の人でしょうか?
    https://developer.freee.co.jp/community/users/lt を見ても情報が無くわかりませんでした。

    以下そのつもりで書きますので、もし違いましたら大変失礼なのですが、無視してください。
    また、 freee のどなたかがこれを見たのでしたら参考にしていただけると幸いです。

    支払日設定により勤怠情報サマリのパラメータ month の値の解釈が違うというのは正しい動作なのでしょうか?
    勤怠情報だけに限れば支払日とは無関係に指定した month の勤怠情報を取得できるほうが直感的だと思います。

    もし、支払日設定が影響することが仕様でしたら、直感的にはわかりにくいのでドキュメントに反映されていると助かります。
    ちなみに、支払日設定を取得する方法はありますでしょうか?

    いまのところ、弊社は皆翌月払だと思うので固定で +1 の month を指定することで回避しようと思います。
    もし支払日設定の異なる従業員が存在していたら、 +1 の month で取得した start_date end_date の月の部分と比較して期待する値より大きい場合は +1 しない month で再取得する実装にしようかと思います。

    アバターLT

    hiroshiさん

    >ところで、 LTさんは freee の中の人でしょうか?

    すいません、いちユーザーです。

    今回の件、私も挙動に興味がありましたので、動作確認をして返答させて頂きました。

    中途半端な返信となりまして失礼しました。

    アバターhiroshi

    > すいません、いちユーザーです。
    > 中途半端な返信となりまして失礼しました。

    とんでもないです。ありがとうございます!
    こちらこそ失礼いたしました。
    カラクリがわかってスッキリしました。

    freee dev-supportfreee dev-support

    hiroshiさま

    貴重なご意見ありがとうございます。

    >もし、支払日設定が影響することが仕様でしたら、直感的にはわかりにくいのでドキュメントに反映されていると助かります。
    本件、仕様になりますが、ご指摘の通り直感的には把握しづらい挙動ですので、要望としてフィードバックさせて頂きました。

    >ちなみに、支払日設定を取得する方法はありますでしょうか?
    現状、人事労務freee APIから支払日の設定が当月か翌月かを取得する方法はご用意しておりません。
    ご要望に添えず申し訳ございません。

    引き続きよろしくお願いいたします。

    アバターhiroshi

    >もし、支払日設定が影響することが仕様でしたら、直感的にはわかりにくいのでドキュメントに反映されていると助かります。
    本件、仕様になりますが、ご指摘の通り直感的には把握しづらい挙動ですので、要望としてフィードバックさせて頂きました。

    ありがとうございます。

    >ちなみに、支払日設定を取得する方法はありますでしょうか?
    現状、人事労務freee APIから支払日の設定が当月か翌月かを取得する方法はご用意しておりません。
    ご要望に添えず申し訳ございません。

    わかりました。