機械翻訳について
  1. Oracle Fusion Cloud ProcurementのOracle Fusion Cloud ProcurementREST APIのREST API
  2. ユースケース
  3. 外部管理購買依頼の作成

「外部管理購買依頼の作成」

統合アプリケーションでは、以前に交渉した価格またはマスター品目の特定のサプライヤから包括購買契約(BPA)を介して、外部で商品を自動的に調達できます。 統合アプリケーションは、購買依頼リソースをコールして、これらの商品を調達するための外部管理の購買依頼を作成できます。

統合アプリケーションは、POST標準処理を呼び出して未完了ステータスの外部管理購買依頼を作成し、submitRequisitionカスタム処理を呼び出して未完了の購買依頼を発行できます。 外部管理の購買依頼の承認ワークフローはバイパスされます。

ノート:

統合アプリケーション・ユーザー(APPIDと同様)には、購買依頼リソースにアクセスするための職務ロールProcurement REST Service Duty (調達RESTサービス職務)(ORA_PO_PROCUREMENT_REST_SERVICE_DUTY)または集計権限Requisition Management Using REST Service (ORA_POR_USE_REST_SERVICE_MANAGE)が必要です。
これらのシナリオについて簡単に説明します。

  • 外部管理の購買依頼の作成

このシナリオの一般的なプロセス・フローを次に示します:

  1. 統合アプリケーションは、POST操作を使用して購買依頼RESTサービスをコールし、その品目の外部管理購買依頼を作成してから、未完了の購買依頼を発行するためのsubmitRequisitionカスタム処理を実行します。
  2. 品目の包括購買契約に基づいて、自動または手動で購買オーダーが購買依頼から生成されます。

外部管理購買依頼の作成

統合アプリケーションで、リスト価格がUS$1107.86の標準デスクトップ品目を調達するために、外部管理の購買依頼を作成することを考えてみます。 品目の番号はAS54888で、オーダーを履行するサプライヤはCV_SuppA00と識別されています。

この品目を使用して購買依頼を作成するには:

  1. 品目番号を識別します。
  2. オプションで、品目IDを識別します。
  3. このURLでPOST操作を実行し、リクエスト本文に次の詳細を指定します。
    • 外部管理フラグがtrueの転記。
      "ExternallyManagedFlag": true
    • 品目番号で転記します。
      "Item": "AS54888"
    • オプションで、品目IDで転記します。
      "ItemId": 149
  4. さらに、次のことも可能です。
    • 包括購買契約参照を指定できます。
    • 購買依頼ヘッダー、明細および配分に付加フレックスフィールドを追加できます。

URLの例

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

POST

/fscmRestApi/resources/11.13.18.05/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": 300100178696854,
"ExternallyManagedFlag": true,
"Description": "Externally Managed Requisition",
"lines":[
    {
      "LineNumber":1,
      "LineTypeCode": "Goods",
      "ItemId": 149,
      "UOMCode":"Ea",
      "Quantity":1,
      "SupplierId": 230,
      "SupplierSiteId": 5232,
      "RequestedDeliveryDate": "2021-09-03",
      "DestinationTypeCode": "EXPENSE",
      "RequesterId": 300100178696854,
      "DestinationOrganizationId": 204,
      "DeliverToLocationId": 204,
      "distributions":[
      { 
        "DistributionNumber":1,
        "Quantity":1
      }
      ]
    }
 ]
}

レスポンスの例

JSON形式の応答本文の例を次に示します。

{
    "RequisitionHeaderId": 300100546582871,
    "Requisition": "10505911",
    "RequisitioningBUId": 204,
    "RequisitioningBU": "Vision Operations",
    "PreparerId": 300100178696854,
    "Preparer": "SSPUSER05",
    "PreparerEmail": "John.Wick@oracle.com",
    "Description": "Externally Managed Requisition",
    "Justification": null,
    "DocumentStatus": "Incomplete",
    "DocumentStatusCode": "INCOMPLETE",
    "SubmissionDate": null,
    "ApprovedDate": null,
    "FunctionalCurrencyCode": null,
    "SoldToLegalEntityId": null,
    "SoldToLegalEntity": null,
    "FundsStatus": null,
    "FundsStatusCode": null,
    "InterfaceSourceCode": null,
    "InterfaceSourceLineId": null,
    "EmergencyPONumber": null,
    "ModifyingApproverId": null,
    "ModifyingApprover": null,
    "ModifyingApproverEmail": null,
    "OverridingApproverId": null,
    "OverridingApprover": null,
    "OverridingApproverEmail": null,
    "FundsOverrideApproverId": null,
    "FundsOverrideApprover": null,
    "FundsOverrideApproverEmail": null,
    "ApprovedById": null,
    "ApprovedByEmail": null,
    "BudgetaryControlEnabledFlag": null,
    "EmergencyRequisitionFlag": null,
    "ExternallyManagedFlag": true,
    "InternalTransferFlag": false,
    "FundsChkFailWarnFlag": false,
    "CreationDate": "2021-08-20T10:04:09+00:00",
    "LastUpdateDate": "2021-08-20T10:04:09.543+00:00",
    "CreatedBy": "PRC_INTEGRATION_USER",
    "LastUpdatedBy": "PRC_INTEGRATION_USER",
    "ActiveRequisitionFlag": false,
    "SourceApplicationCode": null,
    "RejectedById": null,
    "RejectedByDisplayName": null,
    "RejectedReason": null,
    "lines": [
        {
            "RequisitionHeaderId": 300100546582871,
            "RequisitionLineId": 300100546582872,
            "LineNumber": 1,
            "SmartFormId": null,
            "SmartFormName": null,
            "LineTypeId": 1,
            "LineTypeCode": "Goods",
            "RequisitionLineSource": "REST_INTEGRATION",
            "CategoryId": 91,
            "CategoryName": "Finished Goods_91",
            "ItemDescription": "Standard Desktop",
            "ItemId": 149,
            "Item": "AS54888",
            "ItemRevision": null,
            "Quantity": 1,
            "SecondaryQuantity": null,
            "UnitPrice": 1107.86,
            "CurrencyCode": "USD",
            "Currency": "US Dollar",
            "UOMCode": "Ea",
            "UOM": "Each",
            "SecondaryUOMCode": null,
            "SecondaryUOM": null,
            "ConversionRateType": null,
            "ConversionRateDate": null,
            "ConversionRate": null,
            "Price": 1107.86,
            "LineStatus": "INCOMPLETE",
            "LineStatusDisplayValue": null,
            "Amount": null,
            "CurrencyAmount": null,
            "UrgentFlag": null,
            "NegotiatedByPreparerFlag": null,
            "NegotiationRequiredFlag": null,
            "SourceAgreementTypeCode": null,
            "SourceAgreementType": null,
            "SourceAgreementHeaderId": null,
            "SourceAgreement": null,
            "SourceAgreementLineId": null,
            "SourceAgreementLineNumber": null,
            "UNNumberId": null,
            "UNNumber": null,
            "HazardClassId": null,
            "HazardClass": null,
            "HazardClassCode": null,
            "UNSPSCCode": null,
            "ManufacturerName": null,
            "ManufacturerPartNumber": null,
            "BPAPriceUserOverrideFlag": null,
            "NewSupplierFlag": null,
            "SupplierId": 230,
            "Supplier": "CV_SuppA00",
            "SupplierSiteId": 5232,
            "SupplierSite": "CVSuppA00Site01",
            "SupplierContactId": null,
            "SupplierContact": null,
            "SupplierContactEmail": null,
            "SupplierContactPhone": null,
            "SupplierContactFax": null,
            "SuggestedSupplier": null,
            "SuggestedSupplierSite": null,
            "SuggestedSupplierContact": null,
            "SuggestedSupplierContactPhone": null,
            "SuggestedSupplierContactFax": null,
            "SuggestedSupplierContactEmail": null,
            "SupplierItemNumber": null,
            "RequesterId": 300100178696854,
            "Requester": "SSPUSER05",
            "RequesterEmail": "John.Wick@oracle.com",
            "SuggestedBuyerId": null,
            "SuggestedBuyer": null,
            "SuggestedBuyerEmail": null,
            "ModifiedByBuyerId": null,
            "ModifiedByBuyer": null,
            "AssignedBuyerId": null,
            "AssignedBuyer": null,
            "AssignedBuyerDisplayName": null,
            "AssignedBuyerEmail": null,
            "RequestedDeliveryDate": "2021-09-03",
            "DestinationTypeCode": "EXPENSE",
            "DestinationType": "Expense",
            "DestinationOrganizationId": 204,
            "DestinationOrganizationCode": "V1",
            "DestinationOrganization": "Vision Operations",
            "DestinationSubinventory": null,
            "OneTimeLocationFlag": false,
            "DeliverToLocationId": 204,
            "DeliverToLocationCode": "V1- New York City",
            "DeliverToAddress": "90 Fifth Avenue, New York,NY 10022-3422, New York, United States",
            "FormattedDeliverToAddress": "90 Fifth Avenue<BR>New York,NY 10022-3422<BR>New York<BR>United States",
            "NoteToBuyer": null,
            "NoteToReceiver": null,
            "NoteToSupplier": null,
            "POAutomationFailedReasonCode": null,
            "POAutomationFailedReason": null,
            "POHeaderId": null,
            "POLineId": null,
            "PurchaseOrder": null,
            "POBuyerId": null,
            "BuyerOnPurchaseOrder": null,
            "SupplierOnPurchaseOrder": null,
            "ProcurementBUId": null,
            "ProcurementBU": null,
            "SourceTypeCode": "EXTERNAL",
            "SourceType": null,
            "SourceOrganizationId": null,
            "SourceOrganization": null,
            "SourceSubinventory": null,
            "TransferOrderHeaderId": null,
            "TransferOrder": null,
            "TransferOrderLineId": null,
            "NegotiationHeaderId": null,
            "Negotiation": null,
            "NegotiationLineNumber": null,
            "ResponseNumber": null,
            "ResponseLineNumber": null,
            "OnNegotiationFlag": null,
            "WorkOrderId": null,
            "WorkOrder": null,
            "WorkOrderOperationId": null,
            "WorkOrderOperationSequence": null,
            "WorkOrderProduct": null,
            "WorkOrderSubType": null,
            "BackToBackFlag": null,
            "ConfiguredItemFlag": false,
            "DeliverToCustomerId": null,
            "DeliverToCustomer": null,
            "DeliverToCustomerLocationId": null,
            "RequestedShipDate": null,
            "SalesOrderLineNumber": null,
            "SalesOrder": null,
            "SalesOrderScheduleNumber": null,
            "ShipToCustomerId": null,
            "ShipToCustomer": null,
            "ServiceLevelCode": null,
            "ServiceLevel": null,
            "ModeOfTransportCode": null,
            "ModeOfTransport": null,
            "CarrierId": null,
            "Carrier": null,
            "CreatedBy": "PRC_INTEGRATION_USER",
            "CreationDate": "2021-08-20T10:04:09.079+00:00",
            "LastUpdatedBy": "PRC_INTEGRATION_USER",
            "LastUpdateDate": "2021-08-20T10:04:09.552+00:00",
            "LastSubmittedDate": null,
            "LastApprovalDate": null,
            "OriginalSubmittedDate": null,
            "OriginalApprovalDate": null,
            "CancelDate": null,
            "CancelReason": null,
            "RequisitionLineGroup": "LINES_REQUIRING_ATTENTION",
            "LineImageURL": null,
            "SupplierItemAuxiliaryId": null,
            "DisableAutosourceFlag": false,
            "DeliverToOneTimeAddress": null,
            "LineTypeOrderTypeLookupCode": "QUANTITY",
            "ReturnedByBuyerId": null,
            "ReturnedByBuyerDisplayName": null,
            "ReturnReason": null,
            "distributions": [
                {
                    "RequisitionDistributionId": 300100546582873,
                    "RequisitionLineId": 300100546582872,
                    "Quantity": 1,
                    "DistributionNumber": 1,
                    "ChargeAccountId": null,
                    "ChargeAccount": null,
                    "CurrencyAmount": null,
                    "CurrencyNonrecoverableExclusiveTax": null,
                    "CurrencyRecoverableExclusiveTax": null,
                    "ChartOfAccountId": 101,
                    "UserAccountOverrideFlag": false,
                    "links": [
                        . . . 
                    ]
                }
            ],
            "links": [
                . . . 
            ]
        }
    ],
    "links": [
        . . . 
    ]
}