リリース 稼働状況 障害報告

【リリース】2025年8月18日（月）API機能アップデート＆仕様変更

  • 更新

いつもジンジャーをご利用いただきありがとうございます。
2025年8月18日（月）にジンジャーAPIの機能アップデートおよび仕様変更を実施しました。

詳細は以下のとおりです。
※仕様変更の内容はすでに【告知】として広報しています。

目次 機能アップデート 
・勤怠の汎用データのCSVファイルを取得できる機能の新設
・勤怠の入退館・PCログを日単位で登録できる機能の新設
・経費のプロジェクトを更新できる機能の新設
仕様変更
・ワークフローの申請フォームに追加された項目IDのロジックを変更
ジンジャーAPIについて

 

機能アップデート

勤怠の汎用データのCSVファイルを取得できる機能の新設

ジンジャー勤怠をご契約のお客さまのみ使用できます

概要

ジンジャーAPIで取得（GET）できる情報を追加しました。

影響

新たに取得（GET）できるようになった情報とAPIは下記のとおりです。

情報

API
勤怠管理者画面＞データ出力＞出力フォーマット＞汎用データ出力フォーマット
  1. GET /v1/master/kintai-export-formats
勤怠管理者画面＞データ出力＞汎用データ
  1. POST /v1/kintai-exports
勤怠管理者画面＞データ出力＞レポート処理結果一覧
  1. GET /v1/kintai-exports
  2. GET /v1/kintai-exports/{id}

汎用データのCSVを取得する操作方法は下記のとおりです。

  1. GET 勤怠 出力フォーマット で、出力する形式の出力フォーマットIDの一覧を取得
  2. POST 勤怠 エクスポート で、手順1で得られた値をパラメータとして、汎用データの出力を依頼
  3. GET 勤怠 エクスポート で、手順2で依頼した出力のエクスポートIDを取得
  4. GET 勤怠 エクスポート/{id} で、手順3で得られた値をパラメータとして、出力されたファイルを取得

 

勤怠の入退館・PCログを日単位で登録できる機能の新設

ジンジャー勤怠をご契約のお客さまのみ使用できます

概要

ジンジャーAPIで登録（POST）できる情報を追加しました。

影響

新たに操作できるようになった情報とAPIは下記のとおりです。

従業員ごとかつ最大100日分の入退館・PCログデータの登録（POST）はすでに公開済みでしたが、今回の機能アップデートにより、複数の従業員の入退館・PCログデータを日単位で登録できるようになりました。

情報

API
勤怠管理者画面＞データ出力＞入退館・PCログデータの各日の実績 POST /v1/kintai-daily-work-logs

 

経費のプロジェクトを更新できる機能の新設

ジンジャー経費をご契約のお客さまのみ使用できます

概要

ジンジャーAPIで更新（PATCH）できる情報を追加しました。

影響

新たに更新（PATCH）できるようになった情報とAPIは下記のとおりです。

情報

API
プロジェクト＞プロジェクト PATCH /v1/master/projects

 

仕様変更

ワークフローの申請フォームに追加された項目IDのロジックを変更

ジンジャーワークフローをご契約のお客さまのみ使用できます

概要

ワークフローの申請フォームの詳細の取得（GET /v1/employees/*/{id}）で返却される申請フォームに追加された「項目ID」の値が正しく返却されるように変更しました。

影響

対象の情報とAPIは下記のとおりです。

情報

API
従業員画面＞ワークフロー＞申請データ一覧＞カスタム申請 GET /v1/workflow-requests/custom-requests/{id}
従業員画面＞ワークフロー＞申請データ一覧＞入社申請 GET /v1/workflow-requests/onboardings/{id}
従業員画面＞ワークフロー＞申請データ一覧＞退社申請 GET /v1/workflow-requests/offboardings/{id}
従業員画面＞ワークフロー＞申請データ一覧＞扶養変更申請 GET /v1/workflow-requests/dependent-changes/{id}

変更前

申請フォームに追加された項目のID（custom_details.id）として、各項目の並び順を返却していました。

変更後

  • 申請フォームに追加された項目のID（custom_details.id）として、各項目の一意のIDを返却するように変更しました。
  • 申請フォームに追加された項目の表示順（custom_details.display_order）として、各項目の並び順を返却するように変更しました。

 

ジンジャーAPIについて

ジンジャーAPIについての操作や、連携できる項目についてはこちら

ジンジャーAPIを利用するためのジンジャー上での設定についてはこちら

 

以上です。
皆さまのご要望に基づき、新機能開発、機能改善を進めてまいります。
引き続き、よろしくお願いいたします。

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【機能アップデートおよび仕様変更日時】
8月18日（月）12:00~15:00
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

関連記事