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