※ 本記事はfreee勤怠管理Plusについてのヘルプページです。freee人事労務については「freee人事労務のカテゴリー」をご覧ください。
外部連携（API連携サービス、CSV連携）に失敗する場合の確認事項について、説明します。
※直接WebAPIを利用していてエラーが発生する場合は、「WebAPIでエラーが発生する場合の原因と対処方法」のヘルプページをご参照ください。
※直接WebAPIを利用する方法は、「API連携サービス以外に、直接WebAPIを利用する方法」のヘルプページをご参照ください。
API連携サービスとの連携に失敗する場合
API連携サービスとの連携に失敗する場合は、次の事項をご確認ください。
連携設定は完了しているか
「外部サービス連携（WebAPIなど）」から連携したいサービスのヘルプページを確認し、連携設定が完了していることをご確認ください。
WebAPI制限時間帯に連携していないか
以下の制限時間帯ではAPI連携できません。
- 8:30～10:00
- 17:30～18:30
レート制限を超過していないか
freee勤怠管理Plusでは次のレート制限を実施しています。これらのレートを超過した場合は「リクエスト数の上限に達しています」エラーとなります。
リクエストが制限に抵触しないよう、時間帯を分けてリクエストを送る、不要なリクエストを整理するなどをご検討ください。
【連携サービス単位のレート制限】
| 対象エンドポイント | 制限内容 |
|---|---|
| トークンエンドポイント、および日別打刻データ（POST） 以外のすべて ※すべてのAPIリクエストを合算して対象とします。 |
直近5分で1,500リクエスト |
| 日別打刻データ（POST） ※単体制限です。 |
直近5分で2,000リクエスト |
リクエストが集中していないか
短時間において大量のリクエストが集中してサーバーの負荷が高くなっている場合、サービスの可用性を担保するため「Too Many Requests」などのエラーが返されます。時間をおいてリクエストを実施してください。
リクエストは並列で同時に送信しないでください。1件ずつ送信し、目安として1秒ほど送信間隔を空けてください。
従業員連携に失敗する場合
従業員連携に失敗する場合は、次の事項をご確認ください。
本システムと連携サービスで「従業員コード」は一致しているか
多くの連携サービスでは、「従業員コード」によって従業員データをマッチングしています。
「従業員コード」が一致していることをご確認ください。
該当従業員は「入社前」または「退職後」ではないか
連携サービスによっては、入社前 / 退職後 の従業員は連携対象外となります。
本システムで従業員に「入社日」や「退職日」を設定している場合、連携時点で 入社前 / 退職後 ではないことをご確認ください。
※ 入社前 / 退職後 の場合、「入社日」や「退職日」を削除することで連携可能です。
勤怠データ連携に失敗する場合
勤怠データ連携に失敗する場合は、次の事項をご確認ください。
該当従業員は「入社前」または「退職後」ではないか
連携サービスによっては、入社前 / 退職後 の勤怠データは連携対象外となります。
本システムで従業員に「入社日」や「退職日」を設定している場合、連携時点で 入社前 / 退職後 ではないことをご確認ください。
※ 入社前 / 退職後 の場合、「入社日」や「退職日」を削除することで連携可能です。
一部の項目が連携されない場合、該当項目の連携設定を行っているか
一部の項目では、追加の連携設定が必要な場合があります。
「外部サービス連携（WebAPIなど）」のヘルプページを参照し、対象サービスの連携設定をご確認ください。
本システムと連携サービスで「項目数」や「項目順」が一致しているか
CSV連携では、「項目数」と「項目順」が一致していないと連携エラーになることがあります。
連携サービスのCSVレイアウトにあわせて、本システムでCSVレイアウトを作成してください。
連携データに半角スペースや全角スペースが入ってしまっていないか
CSV連携では、不要なスペースが原因で連携エラーになることがあります。
テキストエディタなどで連携データを開き、不要なスペースが入ってしまっていないかご確認ください。