Oracle Fusion Cloud ProcurementのREST API

1つの購買オーダーを承認のために再発行

post

/fscmRestApi/resources/11.13.18.05/purchaseOrders/{purchaseOrdersUniqID}/action/submit

購買オーダーまたは変更オーダーを承認のために再送信します。通常、購買オーダーは承認プロセスを経て、問題なく実装されます。オーダー処理中に(たとえば、発行チェック中に)予期しないエラーが発生した場合は、オーダーを再発行する必要があります。 REST APIを使用して、承認待ちステータスの購買オーダーを再発行できます。承認保留ステータスのオーダーは、再発行される前に自動的に取り下げられます。承認ワークフローをバイパスするには、bypassApprovalsFlag属性をTrueに設定します。

リクエスト

パス・パラメータ

purchaseOrdersUniqID(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

ソースを表示

bypassApprovalsFlag: boolean

次のいずれかの値が含まれます: 正誤問題。 Trueの場合、承認ワークフローをバイパスします。 Falseの場合は、省略しないでください。デフォルト値は「False」です。

{
    "type":"object",
    "properties":{
        "bypassApprovalsFlag":{
            "type":"boolean",
            "description":"Contains one of the following values: True or False. If True, then bypass the approval workflow. If False, then do not bypass. The default value is False.",
            "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 a value of Success."
        }
    },
    "additionalProperties":false
}

トップに戻る

例

この例では、1つの購買オーダーを承認のために再発行する方法について説明します。

cURLコマンドの例

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

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

たとえば、次のコマンドは、承認のために1つの購買オーダーを発行します。POHeaderIdは100000019476400です:

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

リクエスト本文の例

次の例には、JSON形式のリクエスト本文のコンテンツが含まれます。 cURLコマンドの「リクエスト・ペイロード」は、リクエスト本文の例の内容に置き換えます。リクエスト・ペイロードでは、コマンドが作成するレコードで使用される属性値を指定します。 bypassApprovalsFlagをtrueに設定すると、再送信時に手動承認は必要ありません。

{
  "name": "submit",
  "parameters": [
    {
      "bypassApprovalsFlag": "false"
    }
  ]
}

レスポンス本文の例

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

{
    "result": "Success"
}

「トップに戻る」