Oracle Fusion Cloud ProcurementのREST API

「ユーザーによる購買依頼の管理」

以前は、Integratorのみが購買依頼リソースに対してREST処理を実行できました。これで、購買依頼の管理権限を持つユーザーPOR_MANAGE_REQUISITION_PRIV(すぐに調達依頼者ロールに割り当てられている)は、リソースに対して処理を実行できます。ただし、このようなユーザーは、データ・セキュリティ・ポリシーによって制限されます(データ・セキュリティ・ポリシーによって、アクセス可能なデータが決まります)。

従業員のメアリー・ブラウンが事務用品をオーダーする必要があるとします。 Mary Brownにはプライマリ作業割当があり、Vision Operationsという購買依頼発行ビジネス・ユニットが関連付けられています(BU IDは204)。また、作業割当レコードに経費勘定があります。

購買依頼の作成

これには、購買依頼リソースに対するPOST処理の実行が含まれます。

URLの例

次のリソースURL形式を使用します:

fscmRestApi/resources/version/purchaseRequisitions

cURLコマンド

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

リクエストの例

JSON形式のリクエスト本文の例を次に示します:

{
    "RequisitioningBUId": 204,
    "PreparerId": 100100004256726, 
    "ExternallyManagedFlag": false,
    "Description" : "Office Supplies",
    "lines": [{
            "LineNumber": 1,
            "LineTypeCode": "Goods",
            "CategoryName": "Paper",
            "ItemDescription": "Notebook - 100 Pages",
            "UOM": "Each",
            "Quantity": 1,
            "Price": 4.99,
            "CurrencyCode": "USD",
            "DestinationTypeCode": "EXPENSE",
            "DestinationOrganizationId": 204,
            "RequesterId": 100100004256726,
            "DeliverToLocationId": 204,
            "RequestedDeliveryDate": "2021-09-15",
            "distributions":[{ 
                "DistributionNumber":1,
                "CurrencyAmount": 4.99,
   "Quantity": 1
            }]
        }]
}

ノート:

PreparerIdは、RESTコールを行うユーザーのpersonIdと一致する必要があります。
コールを行う個人は、購買依頼が作成されている購買依頼発行ビジネス・ユニットにアクセスできる必要があります。
コールを行うユーザーは、作成している明細のタイプに必要な権限を持っている必要があります。たとえば、ペイロードの搬送先事業所がユーザーのHRレコードにあるものと異なる場合、その個人には、HRレコードにあるものとは異なる搬送先事業所を持つ購買依頼明細を作成する権限が必要です。

購買依頼明細の更新

Mary Brownはリクエストされた搬送日を変更する必要があるとします。

これには、特定の購買依頼明細に対するPATCHリクエストの実行が含まれます。

サンプルURL

次のリソースURL形式を使用します:

fscmRestApi/resources/version/purchaseRequisitions/purchaseRequisitionsUniqID/child/lines/linesUniqID

cURLコマンド

curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload'  "https://servername/fscmRestApi/resources/version/purchaseRequisitions/purchaseRequisitionsUniqID/child/lines/linesUniqID"

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します:

"RequestedDeliveryDate": "2021-08-15",
            
}

ノート:

購買依頼のPreparerIdは、RESTコールを行う個人のpersonIdと一致する必要があります。つまり、自分が所有している購買依頼のみを更新できます。

コールを行う個人は、購買依頼が作成された購買依頼発行ビジネス・ユニットにアクセスできる必要があります。つまり、たとえば、購買依頼をBU Aで作成したが、そのBUにアクセスできなくなった場合、PATCHは実行できません。

購買依頼の表示

Mary Brownは、承認のために購買依頼を発行する前に、正しい情報を入力したことを確認します。

これには、特定の購買依頼に対するGETリクエストの実行が含まれます。

サンプルURL

次のリソースURL形式を使用します:

fscmRestApi/resources/version/purchaseRequisitions/purchaseRequisitionsUniqID

cURLコマンド

curl -u username:password "https://servername/fscmRestApi/resources/version/purchaseRequisitions/purchaseRequisitionsUniqID"

ノート:

購買依頼のPreparerIdは、RESTコールを行う個人のpersonIdと一致する必要があります。つまり、自分が所有している購買依頼のみを表示できます。 webアプリケーションとは異なり、購買依頼を所有していないかぎり、いずれかの明細で依頼者としてリストされている購買依頼は表示できません。

webアプリケーションとは異なり、購買依頼の表示、すべて権限(POR_VIEW_REQUISITIONS_ALL)では、REST APIを介してコールを行うときに、他のユーザーが作成した購買依頼を表示できません。

購買依頼の発行

Mary Brownが購買依頼を作成および更新したため、この購買依頼は承認のために発行します。承認のために発行すると、税金が計算され、借方勘定が生成されます。この借方勘定は、HRレコードの費用勘定に設定されます。

これには、購買依頼リソースに対するPOST処理の実行が含まれます。

サンプルURL

次のリソースURL形式を使用します:

/fscmRestApi/resources/version/purchaseRequisitions/purchaseRequisitionsUniqID

cURLコマンド

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

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します:

{
    "name":"submitRequisition",
    "parameters":[]
}

ノート:

購買依頼のPreparerIdは、RESTコールを行う個人のpersonIdと一致する必要があります。つまり、自分が所有している購買依頼のみを発行できます。

コールを行う個人は、購買依頼が作成された購買依頼発行ビジネス・ユニットにアクセスできる必要があります。つまり、たとえば、購買依頼をBU Aで作成し、そのBUにアクセスできなくなった場合、その購買依頼を発行できません。