1. REST API for Oracle Fusion Cloud ProcurementREST API for Oracle Fusion Cloud Procurement
  2. Use Cases
  3. Create Draft Supplier Negotiations

Create Draft Supplier Negotiations

You can use the Supplier Negotiations REST resource to create supplier negotiations in draft status. You can create the entire negotiation with all levels of resources in a single call. Alternatively, you can make multiple calls to independently create resources at each level. For example, you may create the negotiation header, requirements, line, supplier, collaboration team member, line attribute, price tier, price break, supplier access restriction, and DFF all at once, or independently with multiple calls.

You can use the POST and PATCH standard actions to create and update Auction, RFQ, and RFI with lots, groups and lines of goods and services.

Additionally,

  • You can add collaboration team members and descriptive flexfields to a negotiation.
  • You can add sections, requirements, and acceptable values to a negotiation.
  • You can add attributes, price breaks or quantity based price-tiers, and descriptive flexfields to negotiation lines.
  • You can invite suppliers and restrict their access to one or more negotiation lines.

Some features, such as scoring teams, multicurrency response, abstracts, enabling approvals, and staggered closing auction are currently not supported.

Here's a typical application processing flow for the scenarios:

  1. You can create a negotiation in draft status
  2. You can query the negotiation
  3. You can update the close date

Create a Draft Supplier Negotiation

Let's consider that Erica Miller is creating an auction with line, lot, and lot lines of office furniture. Erica adds descriptive flexfields and collaboration team members, and invites two suppliers to participate in the negotiation.

Example URL

Use this resource URL format.

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"

Example Request

Here's an example of the request body in JSON format.

{
	"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
		}
	]
}

Example Response

Here's an example of the response body in JSON format.

{
   "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": []
	}

Get the Draft Negotiation

In this scenario, Erica queries the newly created draft negotiation to review its details.

Example URL

Use this resource URL format.

GET

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiations/AuctionHeaderId"

Example Response

Here's an example of the response body in JSON format.

{
"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": [
	{
	...
	}
]
}

Update the Negotiation Title and Close Date

In this scenario, Erica updates the negotiation title and extends the close date of the negotiation.

Example URL

Use this resource URL format.

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"

Example Request

Here's an example of the request body in JSON format.

	{
		"NegotiationTitle": "Office Equipment",
		"CloseDate": "2021-01-27"
	}

Example Response

Here's an example of the response body in JSON format.

{
"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": [
	{
	...
	}
]
}