チェック対象とする取引先名をRoboRoboコンプライアンスチェックへ登録し、チェックを実施、指定のURLに結果を送付。

upsert動作

取引先名（customerName）と関連ワード（relativeWord）の組み合わせで一意性を判定する。

• 一致する取引先が 存在しない 場合: 新規登録する
• 一致する取引先が 存在する 場合: リクエストで明示的に指定された他フィールド（entityType / isExecuteWorldCheck と関連項目 / 法人番号 / 企業URL / 取引先管理番号 / フォルダ 等）のうち、現状と異なる値がある項目のみ更新する。リクエストで指定されていないフィールドは更新対象外（null 上書きは行わない）。 ※既存取引先のフィールドを編集する目的にも利用できる（チェック実行と取引先メタ情報の更新を1リクエストで完結）。

取引先登録・チェックAPIでresponseTargetのurlを指定した場合、指定のURLにチェック結果を送付
結果の返却先URLへの送付はステータスコード：4xx、5xxの場合リトライ（最大10回）
※responseTargetのtokenを指定した場合、BearerTokenに指定のtokenを付与

絞り込み条件を指定し、取引先の一覧を返却

コンプライアンスチェック実行済みの取引先を指定し、最新のチェック実行結果の詳細を返却

コンプライアンスチェック実行済みの取引先、実行IDを指定し、チェック実行結果の詳細を返却

SPN実行履歴IDを指定し、SPN検索結果の実データ（JSON配列）を取得する ※SPN検索契約有のAPIキーのみ利用可 ※SPN結果のPDF（SPN報告書 / SPN個社別報告書）が必要な場合は、チェック結果ファイル作成リクエストAPI（POST /v2/check-result-file/create-request）で作成をリクエストし、ファイル取得API（POST /v2/file/get）でダウンロードURLを取得する

官報破産者情報検索の実行履歴IDを指定し、検索結果（JSON）を取得する。 ※官報破産者情報検索契約有のAPIキーのみ利用可

取引先ID・チェック実行IDを指定し、AIレポートのステータスとPDFダウンロードURLを返却（※AIレポート契約有の場合のみ）。 PDFはチャットでレポート内容が更新されるたびに同一URL上のファイルが上書き再生成されるため、常に最新版が取得される。

World-Check国籍リストを返却

World-Check国リストを返却

World-Check識別番号種別リストを返却

World-Check候補一覧を返却

World-Check詳細を返却

AI与信実行で受け付けた実行の結果を取得する。 AI与信実行履歴ID（取引先登録・チェック実行APIのレスポンスや callback の aiCreditResult.executionHistoryId）を指定して、AI与信レポート作成の進捗・結果を能動的に取得できる。 AI与信契約が必要。

取引先登録・チェック実行APIで aiCreditResponseTarget.url を指定した場合、AI与信レポートの作成完了時に指定のURLへ結果を送付する。 結果の返却先URLへの送付はステータスコード：4xx、5xxの場合リトライ（最大10回） ※aiCreditResponseTargetのtokenを指定した場合、BearerTokenに指定のtokenを付与

AI与信のスコア計算に利用される閾値設定（自己資本比率・資本金など）を取得する。

AI与信のスコア計算に利用される閾値設定（自己資本比率・資本金など）を更新する。

コンプライアンスチェック実行済みの取引先に対し、取引判断（取引承認/取引否認/取引保留）とコメントを更新する。

コメントへのファイル添付について

コメントにファイルを添付する場合は、本APIのリクエストで fileName / fileExtension / fileSize を指定する。 レスポンスで返却される s3UploadUrl（アップロード用の署名付きURL）に対してファイル本体を直接 PUT することで、添付が完了する（2ステップ）。

① 本APIでファイルのメタ情報を送信し、s3UploadUrl を取得する

PUT /v2/check-decision
Authorization: Bearer {アクセストークン}
Content-Type: application/json

{
  "customerId": 100000,
  "checkDecisionChoice": 1,
  "comment": "反社チェック結果を確認済み",
  "fileName": "証跡資料",
  "fileExtension": "pdf",
  "fileSize": 102400
}

レスポンス:

{
  "checkDecisionList": [
    { "customerId": 100000, "customerName": "株式会社〇〇〇" }
  ],
  "checkDecisionChoice": 1,
  "s3UploadUrl": "https://compliance-files-production.s3.ap-northeast-1.amazonaws.com/check-decision/900000/1a2b3c4d.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=xxxxx"
}

② 取得した s3UploadUrl へファイル本体を直接 PUT する

curl -X PUT "https://compliance-files-production.s3.ap-northeast-1.amazonaws.com/check-decision/900000/1a2b3c4d.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=xxxxx" \
  -H "Content-Type: application/pdf" \
  --data-binary @./証跡資料.pdf

※ s3UploadUrl は署名付きURLのため、Authorization ヘッダーは付与しないこと（付与すると認証エラーになる） ※ Content-Type にはアップロードするファイルのMIMEタイプを指定する ※ 添付したファイルは ファイル取得API（POST /v2/file/get）で取得できる

取引判断を取得して返却

コンプライアンスチェック実行結果から記事を指定し、当該記事のPDFダウンロード用URLを生成して返却

チェック結果に関するファイル（SPN報告書 / SPN個社別報告書 / 調査レポート）の作成をリクエストする。 ファイルの生成は非同期で行われるため、本APIでは受付完了とファイルID（fileId）のみを返却する。 生成完了後、ファイル取得API（POST /v2/file/get）に fileId を指定してダウンロードURLを取得する。 ※生成されるファイルはいずれもZIP形式。 ※対象は checkExecutionIds（チェック実行IDのリスト）または folderId（フォルダ単位）のいずれか一方で指定する。