システム連携コネクタを作成する際、エラーが発生することがあります。システム連携コネクタはDX Suite Agent App と連携先システムのAPIが関連する機能であるため、エラーの発生源がどこであるかを切り分けることが重要です。
本ページではシステム連携コネクタにかかわるエラーと、確認すべき事項を解説します。
DX Suite Agent App でエラーが発生した場合でも、連携先システムに起因する場合、サポート対象外となります。連携先システムの事象につきましては、各システムの管理元へご確認いただきますようお願いいたします。
コネクタ作成中のエラー
設定値に関するエラー
システム連携コネクタ作成時に、入力したデータやアップロードしたファイルが原因で発生する事象です。エラーメッセージの内容に従って入力内容を確認ください。
コネクタ作成中に発生するエラーの表示例。※発生個所・内容により表示形式は異なります。
| エラーメッセージ | 発生画面/フォーム |
| 連携名称を入力してください | 連携名称 |
| 連携名称は2文字以上で入力してください | 連携名称 |
| 連携名称は50文字以内で入力してください | 連携名称 |
| エンドポイントURLを入力してください | エンドポイントURL |
| エンドポイントURLはhttps://またはhttp://で始まる必要があります | エンドポイントURL |
| エンドポイントURLの形式が正しくありません | エンドポイントURL |
| JSONマッピングを入力してください | JSONマッピング |
| JSON形式が正しくありません: {error} | JSONマッピング |
| APIキーのヘッダー名を入力してください | APIキー認証 |
| APIキーを入力してください | APIキー認証 |
| Client IDを入力してください | OAuth2認証 |
| Authorization URLを入力してください | OAuth2認証 |
| Token URLを入力してください | OAuth2認証 |
| ブラウザ認証を完了してください | OAuth2認証 |
| 最低1つのワークフローを選択してください | ワークフロー選択 |
| OpenAPI仕様書をアップロードしてください | OpenAPI仕様書 |
OAuth 2.0認証のエラー
OAuth 2認証フローのいずれかで発生するエラーです。システム連携コネクタの設定、および連携先システムのOAuth認証基盤の設定をご確認ください。
| エラーメッセージ | 原因 |
| トークン取得失敗: 401 {"error":"invalid_client"} | Client IDが間違っている |
| トークン取得失敗: 400 {"error":"invalid_grant","error_description":"authorization code has expired"} | 認証コードの有効期限切れ |
| トークン取得失敗: 400 {"error":"invalid_request","error_description":"code_verifier is missing"} | 検証失敗 |
| トークンリフレッシュ失敗: 401 {"error":"invalid_grant","error_description":"refresh token has expired"} | リフレッシュトークンの有効期限切れ |
| トークンリフレッシュ失敗: 400 {"error":"invalid_client"} | Client ID/Secretの変更 |
| トークンリフレッシュ失敗: 401 {"error":"unauthorized"} | 認証設定が外部サービス側で無効化された |
| 認証エラー: access_denied | ユーザーが外部サービス上で認証を拒否した |
| 認証エラー: {error_description} | 外部サービスが返したエラー内容 |
| 認証コードが取得できませんでした | コールバックに認証コードが含まれていなかった |
| ユーザーが認証をキャンセルしました | 認証ウィンドウを閉じた |
| 認証がタイムアウトしました（5分） | 認証画面を5分以上放置した |
| リフレッシュトークンが指定されていません | リフレッシュトークンが取得できていない |
| リフレッシュトークンまたはトークンエンドポイントが設定されていません | 設定不備 |
| OAuth 2.0認証の有効期限が切れています。再認証が必要です。 | リフレッシュ失敗後のフォールバックメッセージ |
| ファイル処理中にエラーが発生しました。アップロードしたOpenAPI仕様書のファイルを見直して再度アップロードしてください。 | OpenAPI仕様書のパース失敗 |
連携実行時のエラー
連携テスト実行時、またはデータ連携での利用時に発生します。連携先システムのAPIを呼び出した際にHTTPのエラーレスポンスが返却された場合に発生します。エラーメッセージの内容を確認し、対処を検討ください。
連携テスト時のエラー表示例
データ連携利用時のエラー表示例。"データ連携エラー"のアイコンにマウスオーバーすると、エラーメッセージを確認できます。
外部API実行エラー
連携先システムのAPIを実行する際に発生するエラーです。システム連携コネクタの設定内容の不備の他、連携先システムの問題の場合もあります。
| エラーメッセージ | 原因 |
| 400 Bad Request | JSONマッピングの構造が後続APIの仕様と合っていない・必須フィールドの不足 など |
| 401 Unauthorized | APIキーの入力ミス、OAuth2のClient ID/Secret設定ミス |
| 403 Forbidden | アクセストークンの権限不足（スコープ設定の見直しが必要） |
| 404 Not Found | エンドポイントURLの入力ミス |
| 422 Unprocessable Entity | 送信データの値が不正（存在しないIDの参照、型の不一致など） |
| 500 Internal Server Error | 連携先システムで予期せぬトラブルが発生している |
DX Suite 起因のエラー
OCR処理に問題がある場合、読み取りに失敗し、結果として連携先システムへのAPI実行が失敗します。
DX Suite またはDX Suite ヘルプセンターのお知らせ欄を確認し、DX Suite に問題が発生していないか確認ください。
特に問題ない場合、しばらくお待ちいただいて再度実行ください。解決しない場合は問い合わせフォームよりお問い合わせください。
| エラーメッセージ | 原因 |
| 検証用ユニットの登録に失敗しました | DX SuiteへのOCRユニット登録失敗 |
| OCR処理がタイムアウトしました（10分） | OCR処理が10分以内に完了しなかった |
| ステータス取得失敗 - {error} | OCRステータスポーリング中のエラー |
| データ取得に{N}回失敗しました: {error} | OCR結果データの取得リトライが全て失敗 |
| OCR結果にデータが含まれていません | OCR処理は完了したがデータが空だった |
DX Suite Agent App の挙動にかかわるエラー
保存・削除処理のエラー
データ自動連携、またはシステム連携コネクタを保存・削除するときに発生するエラーです。ネットワーク接続に問題がないかを確認してください。または、しばらく時間をおいてリトライすることで改善する場合があります。改善しない場合は、DX Suite Agent App の再起動をお試しください。
| エラーメッセージ | 原因 |
| 保存に失敗しました: {error} | 設定の保存に失敗 |
| 保存中にエラーが発生しました | 設定の保存に失敗 |
| 削除に失敗しました: {error} | 設定の削除に失敗 |
| 削除中にエラーが発生しました | 設定の削除に失敗 |
| 認証情報の暗号化に失敗しました | OAuth2 認証情報の保存に失敗 |
| 認証情報の保存に失敗しました: {error} | OAuth2 認証情報の保存に失敗 |
お問い合わせについて
上記に記載のないエラーや、対処を試しても解決できない場合は、下記の情報を添えて、問い合わせフォームよりお問い合わせください。
・エラーメッセージの内容
・エラー発生日時を含むログファイル
・システム連携コネクタ作成時に使用したワークフローの設定ファイル（XML）
・エラー発生時に連携した帳票ファイル