• 最終編集日時: 31 May 2021

候補者確定API

サードパーティアプリケーションを介して候補者のオンボーディングアクティビティの一部またはすべてを管理する顧客は、CCW候補者確認APIを使用して、候補者を派遣労働者として一度に1人ずつ確認するプロセスを自動化できます。

CCW候補者確認APIは、サードパーティアプリケーションを介して候補者のオンボーディングアクティビティの一部またはすべてを管理し、候補者を派遣労働者( CW )として一度に1人ずつ確認するプロセスを自動化したい顧客向けに設計されています。APIは、要求で他のデータが渡されずに、単一の候補を確認する要求を処理できます。

CCW候補者検索APIを組み合わせて使用すると、確認に必要な基準を満たす候補者を見つけることができます。候補者確認APIは、各候補者を1つずつ確認することができます。

CCW候補者確認APIにアクセスするための基本URLは次のとおりです。https<instance> :// api/candidates<id> // confirm

CCW APIによって認証される方法については、CCW APIの概要を参照してください。リクエストには次の要素を含める必要があります。

ヘッダーを要求

要求ヘッダーが認証に必要です。詳細については、CCWのAPI OverviewドキュメントのRequest Headersセクションを参照してください。

例の要求

CCW候補者確認APIは、1人の候補者をCWとして確認するためのPUTメソッドによってサポートされています。これは、その候補者の一意のIDのみをAPIリクエストに渡し、明示的なリクエストボディは必要ありません。以下の例では、「12345」は候補者検索API要求から取得された一意のIDです。

/api/candidates/12345/confirmを入れる

ホスト: <CCW FQDN>

権限付与:ベアラー <token>

Accept: "application/json"

相関ID :Z 098 Jth 56 Nkio 343 YY 1 vXt

回答の例

以下は正解の例です。要求された応募者IDは検証され、確認されます。CCWは、HTTP 200応答コードと候補者IDを含む応答を送信することにより、確認が成功したことを示します。

{

    "id ":" 12345 "

}

次の例では、確認要求が失敗しました。該当するエラーメッセージとともに、HTTPエラーコードが返されます。

{   

 "error_code ":"文字列",

 "ERROR_SUMMARY ":"文字列",

 "error_causes ": [      

  {   

    "error_sub_code ":"文字列", 

    "ERROR_SUB_CODE_DESC ":"文字列",

  }

 ]

}

エラーコード

確認API要求が失敗すると、応答に次のいずれかのエラーコードが含まれます。

HTTPステータスコード エラーコード エラーサブコード エラーメッセージ
400 E 4000000 E 4000001 間違った要求です。1つ以上の必須HTTPヘッダーが見つかりません
400 E 4000000 E 4000006 開始日を過去の日付に設定できません
400 E 4000000 E 4000007 無効な開始日
400 E 4000000 E 4000008 終了日を開始日よりも後にしてください
400 E 4000000 E 4000009 契約期間がのサービス期間要件を超えています <configured number of days/weeks/months/years> <days/weeks/months/years>
400 E 4000000 E 4000010 無効なアカウント <account>
400 E 4000000 E 4000012 このCCW IDを持つ候補者または労働者が既に存在します
400 E 4000000 E 4000013 開始日は未来の日付にすることはできません
400 E 4000000 E 4000019 タスクの注文が無効です。キャンセルされているか、無効であるか、見つかりません
400 E 4000000 E 4000020 仕事のパッケージは有効ではありません。キャンセルされているか、無効であるか、見つかりません
400 E 4000000 E 4000023 応募者が確認基準を満たしていなかった
400 E 4000000 E 4000024 応募者はすでに確認済みです
400 E 4000000 E 4000025 OTペイレートはペイレート以上にしてください
400 E 4000000 E 4000026 DTペイレートはOTペイレート以上にしてください
400 E 4000000 E 4000027 サプライヤーOT請求レートはサプライヤー請求レート以上にする必要があります
400 E 4000000 E 4000028 サプライヤーDT請求率はサプライヤーOT請求率以上にする必要があります
400 E 4000000 E 4000029 最終OT請求レートは最終請求レート以上にする必要があります
400 E 4000000 E 4000030 最終DT請求率は最終OT請求率以上にする必要があります
400 E 4000000 E 4000031 請求レートは支払レート以上にしてください
400 E 4000000 E 4000032 最終請求レートはサプライヤー請求レート以上にする必要があります
400 E 4000000 E 4000033 サプライヤーのOT請求レートは、OT支払レート以上にする必要があります
400 E 4000000 E 4000034 最終OT請求レートはサプライヤーOT請求レート以上にする必要があります
400 E 4000000 E 4000035 サプライヤーのDT請求レートはDT支払レート以上にする必要があります
400 E 4000000 E 4000036 最終DT請求レートはサプライヤーDT請求レート以上にする必要があります
400 E 4000000 E 4000037 サプライヤー請求レートは最終請求レートと同じである必要があります
400 E 4000000 E 4000038 申請が閉じられているため申請を完了できません
400 E 4000000 E 4000039 申請がキャンセルされたため申請を完了できません
401 E 4010000 E 4010001 認証に失敗しました。コンシューマーアプリに関連付けられている資格情報を確認する
401 E 4010000 E 4010002 認証に失敗しました。アクセストークンが無効または期限切れです
403 E 4030000 E 4030001 アクセス権がありません。そのユーザーはアクションを実行する権限を持っていません
403 E 4030000 E 4030002 アクセス権がありません。範囲が無効です
403 E 4030000 E 4030003 アクセス権がありません。APIユーザーが無効です。ユーザーがアクティブで、APIユーザーとして設定されていることを確認します。
404 E 4040000 E 4040001 見つかりません
405 E 4050000 E 4050001 メソッドがサポートされていません。サービスは要求されたHTTPメソッドをサポートしていません
500 E 5000000 E 5000001 システムまたはアプリケーションのエラーが発生しました。Coupa CW管理者にお問い合わせください

 

関連アイテム


候補者検索API

31 May 2021

CCWの候補者検索APIを使用すると、顧客はCCWの申請書に提出された候補者に関するデータを取得できます。

CCW APIの概要

31 May 2021

CCWのREST APIを使用すると、顧客とパートナーは新しいアプリケーションを構築し、新しい方法でCCWと統合して、派遣労働力の管理に関する能力を向上させることができます。

APIエクスプローラー

31 May 2021

CCWのREST APIエクスプローラーは、ユーザーがCCW APIをテストして探索できるインタラクティブなツールです。

CoupaでのXMLとJSONの違い

16 December 2016