Oracle Fusion Cloud ProcurementのREST API

購買依頼処理リクエスト・ヘッダーの発行

post

/fscmRestApi/resources/11.13.18.05/requisitionProcessingRequests/{requisitionProcessingRequestsUniqID}/action/processRequest

購買依頼処理リクエストを検証し、下書き購買オーダーまたは未完了の変更オーダーを作成します。

リクエスト

パス・パラメータ

requisitionProcessingRequestsUniqID(required): string

これは、購買依頼処理リクエスト・リソースの複合キーを構成し、購買依頼処理リクエストのインスタンスを一意に識別するために使用される属性のハッシュ・キーです。クライアントはハッシュ・キー値を生成しないでください。かわりに、クライアントは購買依頼処理リクエストの特定のインスタンスにナビゲートしてハッシュ・キーを取得するために、購買依頼処理リクエスト収集リソースを問い合せる必要があります。

ヘッダー・パラメータ

Effective-Of:

このヘッダーは文字列値を受け入れます。この文字列は、セミコロンで区切られた=のリストです。有効日範囲操作の実行に使用されます。受け入れられるパラメータは、RangeMode、RangeSpan、RangeStartDate、RangeEndDate、RangeStartSequenceおよびRangeEndSequenceです。パラメータ値は常に文字列です。 RangeModeに指定できる値は、SET_LOGICAL_START、SET_LOGICAL_END、END_DATE、SET_EFFECTIVE_START、SET_EFFECTIVE_END、REPLACE_CORRECTION、REPLACE_UPDATE、RECONCILE_CORRECTION、CORRECTION、RECONCILE_UPDATE、UPDATE、ZAPおよびDELETE_CHANGESです。 RangeSpanに指定できる値は、PHYSICAL_ROW_END_DATEおよびLOGICAL_ROW_END_DATEです。 RangeStartDateおよびRangeEndDateの値は、yyyy-MM-dd形式の日付の文字列表現である必要があります。 RangeStartSequenceおよびRangeEndSequenceの値は、解析時に正の整数が生成されるように文字列である必要があります。
Metadata-Context:

REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
REST-Framework-Version:

RESTクライアントとサービスの間のプロトコル・バージョン。クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。

サポートされているメディア・タイプ

application/vnd.oracle.adf.action+json

ルート・スキーマ : スキーマ

タイプ: object

ソースを表示

bypassWarningsFlag: boolean

{
    "type":"object",
    "properties":{
        "bypassWarningsFlag":{
            "type":"boolean",
            "nullable":true
        }
    },
    "additionalProperties":false
}

トップに戻る

レスポンス

サポートされているメディア・タイプ

application/json
application/vnd.oracle.adf.actionresult+json

デフォルトのレスポンス

次の表では、このタスクに対するデフォルトのレスポンスについて説明します。

ルート・スキーマ : スキーマ

タイプ: object

ソースを表示

result(required): string

リクエストが成功すると、このアクションは成功を返します。

{
    "required":[
        "result"
    ],
    "type":"object",
    "properties":{
        "result":{
            "type":"string",
            "description":"If the request is successful, then this action returns Success."
        }
    },
    "additionalProperties":false
}

トップに戻る

例

この例では、購買依頼処理リクエストを発行して新しい購買オーダーを作成する方法を説明します。購買オーダーは未完了ステータスで作成されます。

cURLコマンドの例

次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します。

curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.action+json" -d 'request payload' 
"https://servername/fscmRestApi/resources/version/requisitionProcessingRequests/RequestHeaderId"

例1 リクエスト本文

次の例では、リクエスト本文の内容をJSON形式で含めて、不完全な購買オーダーを作成します。 bypassWarningsFlagパラメータが設定されていない場合は、デフォルトでfalseに設定されます。この例では、警告は表示されないため、購買オーダーが正常に作成されます。

cURLコマンドのリクエスト・ペイロードをサンプル・リクエスト本文の内容で置き換えます。リクエスト・ペイロードでは、コマンドが作成するレコードで使用される属性値を指定します。

{
    "name": "processRequest"
}

例1 レスポンス本文

次の例には、レスポンス本文の内容がJSON形式で含まれます:

{
    "result": "The document (Purchase Order) 1005151 was created."
}

例2 リクエスト本文

次の例では、以前に作成した購買依頼処理リクエストから未完了の購買オーダーを作成するためのJSON形式のリクエスト本文の内容が含まれています。この例では、bypassWarningsFlagがfalseに設定されています。つまり、オーダーをプリフィクスWarningで作成する前に、すべての潜在的な警告が表示されます。

{
    "name": "processRequest",
    "parameters": [
        {
            "bypassWarningsFlag": "false"
        }
    ]
}

例2 レスポンス本文

次の例には、レスポンス本文の内容がJSON形式で含まれます:

Warning: Requisition 10504207, Line 6: The source agreement on this requisition line won't be referenced in the resulting order line. The style or currency of the order is different from the agreement.

Warning: Requisition 10504284, Line 1: The resulting order will be in a different currency than the source agreement referenced on this requisition line.

例3 リクエスト本文

次の例では、以前に作成した購買依頼処理リクエストから未完了の購買オーダーを作成するためのJSON形式のリクエスト本文の内容が含まれています。この例では、bypassWarningsFlagがtrueに設定され、不完全な購買オーダーが作成されます。

{
    "name": "processRequest",
    "parameters": [
        {
            "bypassWarningsFlag": "true"
        }
    ]
}

例3 レスポンス本文

次の例には、レスポンス本文の内容がJSON形式で含まれます:

{
    "result": "The document (Purchase Order) 1005152 was created."
}

例4 リクエスト本文

次の例では、以前に作成した購買依頼処理リクエストから未完了の購買オーダーを作成するためのJSON形式のリクエスト本文の内容が含まれています。この例では、リクエストの処理中にエラーが発生したため、下書き購買オーダーは作成されません。 cURLコマンドのリクエスト・ペイロードをサンプル・リクエスト本文の内容で置き換えます。リクエスト・ペイロードでは、コマンドが作成するレコードで使用される属性値を指定します。

{
    "name": "processRequest"
 }

例4 レスポンス本文

次の例には、レスポンス本文の内容がJSON形式で含まれます:

Requisition 10505804, Line 4: You can't add this requisition line to the order. The requisition line is for a supplier configuration and the supplier and the supplier site of the configuration is different from the order's supplier or supplier site.

Requisition 10505804, Line 1: The purchase basis Quantity isn't supported on the document style of the purchase order.

「トップに戻る」