下書きサプライヤ・ネゴシエーションの作成
サプライヤ・ネゴシエーションRESTリソースを使用して、ドラフト・ステータスのサプライヤ・ネゴシエーションを作成できます。 単一のコールで、すべてのレベルのリソースを使用してネゴシエーション全体を作成できます。 または、複数のコールを実行して、各レベルでリソースを個別に作成できます。 たとえば、ネゴシエーション・ヘッダー、要件、明細、サプライヤ、コラボレーション・チーム・メンバー、明細属性、価格階層、価格分岐、サプライヤ・アクセス制限およびDFFを一度に作成することも、複数のコールと独立して作成することもできます。
POSTおよびPATCH標準処理を使用して、ロット、グループおよび商品およびサービス・ラインを含むオークション、見積依頼および情報依頼を作成および更新できます。
さらに、
- コラボレーション・チーム・メンバーおよび付加フレックスフィールドをネゴシエーションに追加できます。
- セクションと要件、受理可能な値をネゴシエーションに追加できます。
- 属性や価格分岐、数量ベースの価格階層、付加フレックスフィールドをネゴシエーション明細に追加できます。
- サプライヤを参加依頼し、そのアクセスを1つ以上のネゴシエーション明細に制限できます。
スコアリング・チーム、複数通貨レスポンス、抽象、原価ファクタ、承認の有効化、交互決算オークションなどの一部の機能は現在サポートされていません。
シナリオの一般的なアプリケーション処理フローを次に示します:
- 下書きステータスのネゴシエーションを作成できます
- ネゴシエーションを問い合せることができます
- クローズ日は更新できます
下書きサプライヤ・ネゴシエーションの作成
Erica Millerが、ライン、ロットおよびロット・ライン・オブ・オフィス家具を備えたオークションを作成しているとします。 Ericaは、付加フレックスフィールドとコラボレーション・チームのメンバーを追加し、2つのサプライヤにネゴシエーションへの参加を依頼します。
URLの例
このリソースURL形式を使用します。
POST
curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/supplierNegotiations"
リクエストの例
JSON形式のリクエスト本文の例を次に示します。
{
"ProcurementBU": "Vision Operations",
"ProcurementBUId": 204000,
"BuyerId": 100010026863783,
"Buyer": "Jones,Clare",
"NegotiationType": "Auction",
"NegotiationStyle": "A1_REST_Style",
"NegotiationTitle": "Office Supplies",
"Outcome": "Purchase Order",
"CurrencyCode": "USD",
"PriceTiers": "Quantity based",
"RankIndicator": "Best or trailing",
"RankingMethod": "Multiattribute scoring",
"AllowAlternateLinesFlag": true,
"OpenImmediatelyFlag": true,
"PreviewImmediatelyFlag": true,
"CloseDate": "2020-12-27",
"RestrictToInvitedSuppliersFlag": true,
"RestrictToInvitedSuppliersDisplayFlag": false,
"ViewNotesAndAttachmentsFlag": true,
"ViewNotesAndAttachmentsDisplayFlag": false,
"RespondOnAllLinesFlag": true,
"RespondOnAllLinesDisplayFlag": false,
"RequireFullQuantityFlag": false,
"RequireFullQuantityDisplayFlag": false,
"AllowMultipleResponsesFlag": true,
"AllowMultipleResponsesDisplayFlag": false,
"AllowResponseRevisionFlag": true,
"AllowResponseRevisionDisplayFlag": false,
"ResponseVisibility": "Open",
"NegotiationLayoutName": "Negotiation Layout",
"ResponseLayoutName": "Response Layout",
"ContractTermsLayout": "ContractTermsProcurement",
"BuyerManagedTransportationFlag": false,
"DisplayScoresToSuppliersFlag": true,
"ShippingMethod": "Airborne-Parcel-2nd day air",
"PricePrecision": 2,
"RequisitioningBUId": 204,
"DFF": [
{
"RequistionNumber": "30",
"RequistionNumberId": "12377665"
}
],
"supplierDFF": [
{
"supplierType": null,
"noOfBranches": null,
"newOrExist": null
}
],
"collaborationTeamMembers": [
{
"AccessCode": "FULL",
"PriceVisibilityFlag": true,
"Access": "Full",
"TeamMember": "Smith,Cody",
"TaskName": "Review Specifications",
"TaskTargetDate": "2020-12-27"
}
],
"suppliers": [
{
"Supplier": "Big Computers",
"SupplierSite": "Los Angeles",
"SupplierContact": "Brown, Timothy"
},
{
"Supplier": "Green Corp.",
"SupplierSite": "San Francisco",
"SupplierContact": "Johnson, Carl"
}
],
"lines": [
{
"SequenceNumber": 1,
"LineType": "Goods",
"LineDescription": "Chair",
"ItemId": 300100121356766,
"ItemRevision": "A",
"UOM": "Each",
"CategoryId": 1,
"GroupTypeCode": "LINE",
"TargetPrice": 100,
"Quantity": 100,
"CurrentPrice": "120",
"StartPrice": "119",
"NoteToSuppliers": "Note to supplier",
"ShipToLocation": "Swiss HQ",
"RequestedDeliveryDate": "2021-04-05",
"RequisitioningBUId": 204,
"DisplayTargetPriceFlag": true
},
{
"SequenceNumber": 2,
"GroupType": "Lot",
"LineType": "Goods",
"CategoryId": 1,
"LineDescription": "Ergonomic Desks",
"Quantity": 100,
"CurrentPrice": 300,
"StartPrice": 280,
"TargetPrice": 250,
"ShipToLocation": "SN_Service_EFF",
"RequisitioningBUId": 204
},
{
"SequenceNumber": 3,
"ParentSequenceNumber": 2,
"GroupType": "Lot line",
"LineType": "Goods",
"CategoryId": 1,
"LineDescription": "Automatic Desks",
"ShipToLocation": "SN_Service_EFF",
"Quantity": 100,
"CurrentPrice": 350,
"StartPrice": 320,
"TargetPrice": 300,
"DisplayTargetPriceFlag": true,
"RequisitioningBUId": 204
},
{
"SequenceNumber": 4,
"ParentSequenceNumber": 2,
"GroupType": "Lot line",
"LineType": "Goods",
"CategoryId": 1,
"LineDescription": "Manual Desks",
"ShipToLocation": "SN_Service_EFF",
"Quantity": 100,
"CurrentPrice": 250,
"StartPrice": 220,
"TargetPrice": 200,
"DisplayTargetPriceFlag": true,
"RequisitioningBUId": 204
}
]
}
レスポンスの例
JSON形式のレスポンス本文の例を次に示します。
{
"AuctionHeaderId": 300100194904041,
"AgreementAmount": null,
.
.
.
"CommercialStageScoringStatus": null,
"TechnicalStageScoringStatus": null,
"DFF": {<NO CHANGES>},
"lines": {<NO CHANGES>},
"suppliers": {<NO CHANGES>},
"supplierDFF": {<NO CHANGES>},
"collaborationTeamMembers": {
"items": [
{
"TeamMemberId": 300100194904043,
"AccessCode": "FULL",
"PriceVisibilityFlag": true,
"SupplierMessagesCode": "ORA_SEND_AND_RECEIVE",
"SupplierMessages": "Send and receive",
"TaskTargetDate": "2020-12-27",
"TaskName": "Review Specifications",
"LastNotifiedDate": null,
"Access": "Full",
"TeamMember": "Smith,Cody",
"PersonId": 100010026863791,
"TaskCompletionDate": null,
"CreatedBy": "CLARE.JONES",
"CreationDate": "2020-05-20T19:20:09.642+00:00",
"LastUpdateDate": "2020-05-20T19:20:10.488+00:00",
"LastUpdatedBy": "CLARE.JONES",
"links": []
}
],
"count": 2,
"hasMore": false,
"limit": 10,
"offset": 0,
"links": []
},
"links": []
}
下書きネゴシエーションの取得
このシナリオでは、Ericaは新しく作成された下書きネゴシエーションを問い合せて詳細をレビューします。
URLの例
このリソースURL形式を使用します。
GET
curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiations/AuctionHeaderId"
レスポンスの例
JSON形式のレスポンス本文の例を次に示します。
{
"items": [
{
"AuctionHeaderId": 300100194904041,
"AgreementAmount": null,
"AgreementEndDate": null,
"AgreementStartDate": null,
"AllowAlternateLinesFlag": true,
"AllowMultipleResponsesDisplayFlag": false,
"AllowMultipleResponsesFlag": true,
"AllowOtherResponseCurrencyFlag": false,
"AllowResponseRevisionFlag": true,
"AllowResponseRevisionDisplayFlag": false,
"ApprovalAmount": null,
"AutoExtendAllLinesFlag": null,
"AutoExtendDuration": null,
"AutoExtendFlag": false,
"AutoExtendFromCloseDateFlag": null,
"AutoExtendMinimumTriggerRank": null,
"AutoExtensionsNumber": null,
"AutoExtendTriggerPeriod": null,
"AwardByDate": null,
"BuyerManagedTransportationFlag": false,
"CarrierId": 12519,
"CloseDate": "2020-12-27T00:00:00+00:00",
"ConversionRateTypeCode": null,
"CurrencyCode": "USD",
"DaysAfterOpenDate": null,
"DefaultMaximumRequirementScore": 5,
"DisplayBestPriceBlindFlag": false,
"DisplayRatesToSuppliersFlag": false,
"DisplayRequirementScoresFlag": false,
"DisplayScoresToSuppliersFlag": true,
"NegotiationTypeId": 1,
"EnableRequirementWeightsFlag": true,
"FOBCode": null,
"FirstLineCloseDate": null,
"FreightTermsCode": null,
"MinimumReleaseAmount": null,
"ModeOfTransportCode": "PARCEL",
"NegotiationTitle": "Office Supplies",
"PricePrecision": 2,
"OpenDate": null,
"OpenImmediatelyFlag": true,
"PaymentTermsId": null,
"BuyerId": 100010026863783,
"PreviewDate": null,
"PreviewImmediatelyFlag": true,
"PriceTiersCode": "QUANTITY_BASED",
"ProcurementBUId": 204,
"RankIndicatorCode": "WIN_LOSE",
"RankingMethodCode": "MULTI_ATTRIBUTE_SCORING",
"ConversionRateDate": null,
"RequireFullQuantityDisplayFlag": false,
"RequireFullQuantityFlag": false,
"RequisitioningBUId": 204,
"RespondOnAllLinesFlag": true,
"RespondOnAllLinesDisplayFlag": false,
"ResponseVisibilityCode": "OPEN_BIDDING",
"RestrictToInvitedSuppliersFlag": true,
"RestrictToInvitedSuppliersDisplayFlag": false,
"StaggeredClosingFlag": false,
"StaggeredClosingInterval": null,
"NegotiationStyleId": 300100129355264,
"TwoStageEvaluationFlag": false,
"AmendmentDescription": null,
"Carrier": "Airborne",
"Currency": "US Dollar",
"PaymentTerms": null,
"Buyer": "Jones,Clare",
"ProcurementBU": "Vision Operations",
"RequisitioningBU": "Vision Operations",
"NegotiationStyle": "A1_REST_Style",
"ConversionRateType": null,
"FOB": null,
"FreightTerms": null,
"ShippingMethod": "Airborne-Parcel-2nd day air",
"Outcome": "Purchase Order",
"NegotiationType": "Auction",
"ModeOfTransport": "Parcel",
"Synopsis": null,
"PriceTiers": "Quantity based",
"RankingMethod": "Multiattribute scoring",
"ResponseVisibility": "Open",
"CoverPageText": null,
"GeneralIntroductionText": null,
"LinesInstructionText": null,
"TermsInstructionText": null,
"RequirementInstructionText": null,
"RankIndicator": "Best or trailing",
"Negotiation": "39985",
"NegotiationLayoutName": "Negotiation Layout",
"ResponseLayoutName": "Response Layout",
"NoteToNegotiationApprovers": null,
"ResponseRevisionDecrementValue": null,
"ServiceLevelCode": "2DA",
"ViewNotesAndAttachmentsFlag": true,
"ViewNotesAndAttachmentsDisplayFlag": false,
"NegotiationStatus": "Draft",
"ResponseRevisionDecrementTypeCode": "AMOUNT",
"RevisedResponseLinePriceRuleCode": null,
"RevisedResponseLinePriceRule": "No restriction",
"ResponseRevisionDecrementType": "Amount",
"ServiceLevel": "2nd day air",
"PODoctypeCode": "STANDARD",
"POStyleId": 1,
"POStyle": "Standard Style",
"ContractSource": null,
"PODoctype": "Standard purchase order",
"ContractTermsLayout": "ContractTermsProcurement",
"ContractTermsTemplate": null,
"ContractTermsTemplateId": null,
"EnableTeamScoringFlag": false,
"SourceAgreement": null,
"EnforcePreviousRoundPriceAsStartPriceFlag": null,
"TechnicalStageUnlockedDate": null,
"TechnicalStageUnsealedDate": null,
"CommercialStageUnlockedDate": null,
"CommercialStageUnsealedDate": null,
"CreatedBy": "CLARE.JONES",
"CreationDate": "2020-05-20T19:20:09+00:00",
"LastUpdateDate": "2020-05-20T19:20:10.464+00:00",
"LastUpdatedBy": "CLARE.JONES",
"CommercialStageUnsealedBy": null,
"CommercialStageUnlockedBy": null,
"TechnicalStageUnsealedBy": null,
"TechnicalStageUnlockedBy": null,
"TechnicalStageScoringStatusCode": null,
"ScoringStatusCode": null,
"CommercialStageScoringStatusCode": null,
"ScoringStatus": null,
"CommercialStageScoringStatus": null,
"TechnicalStageScoringStatus": null,
"links": [
{
...
}
]
}
],
"count": 1,
"hasMore": false,
"limit": 10,
"offset": 0,
"links": [
{
...
}
]
}
ネゴシエーション・タイトルおよびクローズ日の更新
このシナリオでは、Ericaはネゴシエーション・タイトルを更新し、ネゴシエーションのクローズ日を延長します。
URLの例
このリソースURL形式を使用します。
PATCH
curl -X PATCH -u "username:password" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/supplierNegotiations/AuctionHeaderId"
リクエストの例
JSON形式のリクエスト本文の例を次に示します。
{
"NegotiationTitle": "Office Equipment",
"CloseDate": "2021-01-27"
}
レスポンスの例
JSON形式のレスポンス本文の例を次に示します。
{
"AuctionHeaderId": 300100194904041,
"AgreementAmount": null,
"AgreementEndDate": null,
"AgreementStartDate": null,
"AllowAlternateLinesFlag": true,
"AllowMultipleResponsesDisplayFlag": false,
"AllowMultipleResponsesFlag": true,
"AllowOtherResponseCurrencyFlag": false,
"AllowResponseRevisionFlag": true,
"AllowResponseRevisionDisplayFlag": false,
"ApprovalAmount": null,
"AutoExtendAllLinesFlag": null,
"AutoExtendDuration": null,
"AutoExtendFlag": false,
"AutoExtendFromCloseDateFlag": null,
"AutoExtendMinimumTriggerRank": null,
"AutoExtensionsNumber": null,
"AutoExtendTriggerPeriod": null,
"AwardByDate": null,
"BuyerManagedTransportationFlag": false,
"CarrierId": 12519,
"CloseDate": "2021-01-27T00:00:00+00:00",
"ConversionRateTypeCode": null,
"CurrencyCode": "USD",
"DaysAfterOpenDate": null,
"DefaultMaximumRequirementScore": 5,
"DisplayBestPriceBlindFlag": false,
"DisplayRatesToSuppliersFlag": false,
"DisplayRequirementScoresFlag": false,
"DisplayScoresToSuppliersFlag": true,
"NegotiationTypeId": 1,
"EnableRequirementWeightsFlag": true,
"FOBCode": null,
"FirstLineCloseDate": null,
"FreightTermsCode": null,
"MinimumReleaseAmount": null,
"ModeOfTransportCode": "PARCEL",
"NegotiationTitle": "Office Equipment",
"PricePrecision": 2,
"OpenDate": null,
"OpenImmediatelyFlag": true,
"PaymentTermsId": null,
"BuyerId": 100010026863783,
"PreviewDate": null,
"PreviewImmediatelyFlag": true,
"PriceTiersCode": "QUANTITY_BASED",
"ProcurementBUId": 204,
"RankIndicatorCode": "WIN_LOSE",
"RankingMethodCode": "MULTI_ATTRIBUTE_SCORING",
"ConversionRateDate": null,
"RequireFullQuantityDisplayFlag": false,
"RequireFullQuantityFlag": false,
"RequisitioningBUId": 204,
"RespondOnAllLinesFlag": true,
"RespondOnAllLinesDisplayFlag": false,
"ResponseVisibilityCode": "OPEN_BIDDING",
"RestrictToInvitedSuppliersFlag": true,
"RestrictToInvitedSuppliersDisplayFlag": false,
"StaggeredClosingFlag": false,
"StaggeredClosingInterval": null,
"NegotiationStyleId": 300100129355264,
"TwoStageEvaluationFlag": false,
"AmendmentDescription": null,
"Carrier": "Airborne",
"Currency": "US Dollar",
"PaymentTerms": null,
"Buyer": "Jones,Clare",
"ProcurementBU": "Vision Operations",
"RequisitioningBU": "Vision Operations",
"NegotiationStyle": "A1_REST_Style",
"ConversionRateType": null,
"FOB": null,
"FreightTerms": null,
"ShippingMethod": "Airborne-Parcel-2nd day air",
"Outcome": "Purchase Order",
"NegotiationType": "Auction",
"ModeOfTransport": "Parcel",
"Synopsis": null,
"PriceTiers": "Quantity based",
"RankingMethod": "Multiattribute scoring",
"ResponseVisibility": "Open",
"CoverPageText": null,
"GeneralIntroductionText": null,
"LinesInstructionText": null,
"TermsInstructionText": null,
"RequirementInstructionText": null,
"RankIndicator": "Best or trailing",
"Negotiation": "39985",
"NegotiationLayoutName": "Negotiation Layout",
"ResponseLayoutName": "Response Layout",
"NoteToNegotiationApprovers": null,
"ResponseRevisionDecrementValue": null,
"ServiceLevelCode": "2DA",
"ViewNotesAndAttachmentsFlag": true,
"ViewNotesAndAttachmentsDisplayFlag": false,
"NegotiationStatus": "Draft",
"ResponseRevisionDecrementTypeCode": "AMOUNT",
"RevisedResponseLinePriceRuleCode": null,
"RevisedResponseLinePriceRule": "No restriction",
"ResponseRevisionDecrementType": "Amount",
"ServiceLevel": "2nd day air",
"PODoctypeCode": "STANDARD",
"POStyleId": 1,
"POStyle": "Standard Style",
"ContractSource": null,
"PODoctype": "Standard purchase order",
"ContractTermsLayout": "ContractTermsProcurement",
"ContractTermsTemplate": null,
"ContractTermsTemplateId": null,
"EnableTeamScoringFlag": false,
"SourceAgreement": null,
"EnforcePreviousRoundPriceAsStartPriceFlag": null,
"TechnicalStageUnlockedDate": null,
"TechnicalStageUnsealedDate": null,
"CommercialStageUnlockedDate": null,
"CommercialStageUnsealedDate": null,
"CreatedBy": "CLARE.JONES",
"CreationDate": "2020-05-20T19:20:09+00:00",
"LastUpdateDate": "2020-05-20T19:39:25.025+00:00",
"LastUpdatedBy": "CLARE.JONES",
"CommercialStageUnsealedBy": null,
"CommercialStageUnlockedBy": null,
"TechnicalStageUnsealedBy": null,
"TechnicalStageUnlockedBy": null,
"TechnicalStageScoringStatusCode": null,
"ScoringStatusCode": null,
"CommercialStageScoringStatusCode": null,
"ScoringStatus": null,
"CommercialStageScoringStatus": null,
"TechnicalStageScoringStatus": null,
"links": [
{
...
}
]
}