1. REST API for Oracle Fusion Cloud ProcurementREST API for Oracle Fusion Cloud Procurement
  2. Use Cases
  3. Create a Negotiation Response

Create a Negotiation Response

You can use the Draft Supplier Negotiations Responses resource to create a supplier response in draft status. You can get the response and update response values such as response prices for lines, promised date or answers to requirements.

You can also revise or copy a supplier response. Upon revising or copying a response, all source response details, including the attached documents, are also copied to the new response.

You can use the Create Negotiation Response user-defined action to create the draft response. Then use PATCH standard action to update response values for response header, lines and requirements. You can also use POST, PATCH and DELETE actions to add, update or delete response attachments, or add or delete price tiers or price breaks.

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

  1. Create, copy, or revise a response.

  2. GET the draft response.

  3. Update with response values such as line response prices, promised date, requirement answers, and supplier comments.

  4. Add response attachments to header, line, or requirements.

  5. Update a response to external cost factors.

  6. Update a response for line attributes.

  7. Add price tiers or price breaks

  8. Validate a draft response.

  9. Submit a draft response.

Additionally you can do these:

  • Create a surrogate response.

  • Record an acceptance for negotiation terms and conditions.

  • Record an acknowledgment for a negotiation amendment.

You cannot create an alternate line.

Create a Draft Response

Let's consider that Steve Johnson has published an RFQ for procuring laptops for the current financial year. Steve invites two suppliers to participate in the negotiation, Super Computers and Techno Enterprises. Steve has added negotiation terms and conditions which the participating suppliers have accepted. Now a draft response is created for Super Computers using the Create Negotiation Response user-defined action.

Example Request

Here's an example of the request body in JSON format:
{     
   "parameters": {

  	 "AuctionHeaderId"300100546799787",
         "Negotiation": "40124",
         "ProcurementBU":"Vision Scotland",
         "ProcurementBUId":"15567",
         "Supplier": "Super Computers",
         "SupplierId":"12737",      
         "SupplierContact":"Harley, Kims",
         "SupplierContactId":"299954",
         "SupplierSite":"Edinburg",
         "SupplierSiteId": "5058",
         "TermsAcceptedFlag": true,
               "ResponseCurrency":"USD"
           
}

Example Response

{
        "Response": "188755"
    }

Update Response Header and Lines

Steve now provides response values for the negotiation such as Reference Number and Note to Buyer, and updates response prices, response quantity, promised delivery date and note to buyer for all lines using PATCH standard action.

Example URL

Use this resource URL format.

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

Example Request

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

{
    "parts": [
        {
            "id": "part0",
            "path": "/draftSupplierNegotiationResponses/188755",
            "operation": "update",
            "payload": {
                "ReferenceNumber": "778644",
                "NoteToBuyer": "Final response"
            }
        },
        {
            "id": "part1",
            "path": "/draftSupplierNegotiationResponses/188755/child/lines/1",
            "operation": "update",
            "payload": {
                "ResponsePrice": 1250,
                "ResponseQuantity": 50,
                "PromisedDeliveryDate": "2023-05-31"
                 
            }
        },
        {
            "id": "part2",
            "path": "/draftSupplierNegotiationResponses/188755/child/lines/2",
            "operation": "update",
            "payload": {
                "ResponsePrice": 1100,
                "ResponseQuantity": 50,
                "PromisedDeliveryDate": "2023-05-31"
             
            }
        }
     
]
}

Example Response

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

{
    "parts": [
        {
            "id": "part0",
            "path": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755",
            "operation": "update",
            "payload": {
                "ResponseNumber": 188755,
                "ResponseDisplayName": "Quote",
                "ResponseIntent": "NONE",
                "ResponseStatus": "Draft",
                "PreviousResponseNumber": null,
                "OriginalResponseNumber": 188755,
                "AuctionHeaderId": 300100546799787,
                "NegotiationTitle": "Super Computers Ordering",
                "Negotiation": "40124",
                "CloseDate": "2022-12-31T17:53:00+00:00",
                "TimeRemaining": "58 Days 23 Hours",
                "BuyerId": 100010026863791,
                "Buyer": "Cody Dapolito",
                "BuyerEmail": "sendmail-test-discard@oracle.com",
                "CompanyId": 202,
                "Company": "Vision Corporation Enterprise",
                "SupplierId": 12737,
                "Supplier": "Super Computers",
                "SupplierSiteId": 5058,
                "SupplierSite": "Edinburg",
                "SupplierContactId": 299954,
                "SupplierContact": "Harley, Kims",
                "TwoStageEvaluationFlag": false,
                "NegotiationCurrencyCode": "USD",
                "NegotiationCurrency": "US Dollar",
                "ResponseAmount": 117500.00,
                "ResponseCurrencyCode": "USD",
                "ResponseCurrency": "US Dollar",
                "ResponseCurrencyPricePrecision": 2,
                "ResponseValidUntilDate": null,
                "ResponseTypeCode": "PRIMARY",
                "ResponseType": "Primary",
                "ReferenceNumber": "778644",
                "NoteToBuyer": "Final response",
                "EvaluationStage": null,
                "PriceDecrement": null,
                "ProxyBidFlag": false,
                "ProxyDecrementType": null,
                "ProxyDecrementAmount": null,
                "PartialResponseFlag": null,
                "SurrogateResponseEnteredById": null,
                "SurrogateResponseReceivedOn": null,
                "SurrogateResponseEntryDate": null,
                "SurrogateResponseFlag": false,
                "SurrogDraftLockPersonId": null,
                "SurrogateDraftLockPerson": null,
                "SurrogDraftUnlockPersonId": null,
                "SurrogateDraftUnlockPerson": null,
                "MethodOfResponseCode": null,
                "MethodOfResponse": null,
                "DraftLocked": "Y",
                 ...
                "@context": {
                    "key": "188755",
                    "headers": {
                        "ETag": ...
                    },
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755",
                            "name": "draftSupplierNegotiationResponses",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755",
                            "name": "draftSupplierNegotiationResponses",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/attachments",
                            "name": "attachments",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines",
                            "name": "lines",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/sections",
                            "name": "sections",
                            "kind": "collection"
                        }
                    ]
                }
            }
        },
        {
            "id": "part1",
            "path": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1",
            "operation": "update",
            "payload": {
                "ResponseNumber": 188755,
                "AuctionHeaderId": 300100546799787,
                "LineId": 1,
                "Line": "1",
                "LineTypeId": 1,
                "LineType": "Goods",
                "GroupTypeCode": "LINE",
                "GroupType": "Line",
                "ItemId": null,
                "Item": null,
                "ItemRevision": null,
                "LineDescription": "Laptop X800",
                "AlternateLineNumber": 1,
                "AlternateLineDescription": null,
                "SupplierId":"12737",
                "Supplier": "Super Computers",
                "SupplierSiteId": 5058,
                "SupplierSite": "Edinburg",
                "CategoryId": 1,
                "CategoryName": "Miscellaneous_1",
                "StartPrice": null,
                "TargetPrice": null,
                "ResponsePrice": 1250,
                "BestResponsePrice": null,
                "BestResponseScore": null,
                "LineAttributeScore": null,
                "ProxyDecrement": null,
                "ProxyMinimum": null,
                "TargetQuantity": 50,
                "ResponseQuantity": 50,
                "ResponseEstimatedQuantity": null,
                "UOMCode": "Ea",
                "UOM": "Each",
                "LineCloseDate": "2022-12-31T17:53:00+00:00",
                "LineTargetPrice": null,
                "LinePrice": null,
                "LineAmount": 62500.00,
                "PricingBasisCode": null,
                "PricingBasis": null,
                "TargetMinimumReleaseAmount": null,
                "ResponseMinimumReleaseAmount": null,
                "EstimatedTotalAmount": null,
                "ShipToLocationId": 204,
                "ShipToLocation": "V1- New York City",
                "RequestedDeliveryDate": null,
                "RequestedShipDate": null,
                "PromisedDeliveryDate": "2023-05-31",
                "PromisedShipDate": null,
                "NoteToBuyer": "Final response",
                "NoteToSupplier": null,
                "SuppliersCanModifyPriceBreaksFlag": null,
                "PriceBreakTypeCode": null,
                "PriceBreakType": null,
                "CreatedBy": "PONSupplier06",
                "CreationDate": "2022-11-02T17:54:38+00:00",
                "LastUpdatedBy": "PONSupplier06",
                "LastUpdateDate": "2022-11-02T18:14:55.250+00:00",
                "@context": {
                    "key": "1",
                    "headers": {
                        "ETag": ...
                    },
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755",
                            "name": "draftSupplierNegotiationResponses",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1/child/attachments",
                            "name": "attachments",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1/child/costFactors",
                            "name": "costFactors",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1/child/lineAttributeGroups",
                            "name": "lineAttributeGroups",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1/child/priceBreaks",
                            "name": "priceBreaks",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/1/child/priceTiers",
                            "name": "priceTiers",
                            "kind": "collection"
                        }
                    ]
                }
            }
        },
        {
            "id": "part2",
            "path": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2",
            "operation": "update",
            "payload": {
                "ResponseNumber": 188755,
                "AuctionHeaderId": 300100546799787,
                "LineId": 2,
                "Line": "2",
                "LineTypeId": 1,
                "LineType": "Goods",
                "GroupTypeCode": "LINE",
                "GroupType": "Line",
                "ItemId": null,
                "Item": null,
                "ItemRevision": null,
                "LineDescription": "Laptop X400",
                "AlternateLineNumber": 1,
                "AlternateLineDescription": null,
                "SupplierId": 12737,
                "Supplier": "Super Computers",
                "SupplierSiteId": 5058,
                "SupplierSite": "Edinburg",
                "CategoryId": 1,
                "CategoryName": "Miscellaneous_1",
                "StartPrice": null,
                "TargetPrice": null,
                "ResponsePrice": 1100,
                "BestResponsePrice": null,
                "BestResponseScore": null,
                "LineAttributeScore": null,
                "ProxyDecrement": null,
                "ProxyMinimum": null,
                "TargetQuantity": 50,
                "ResponseQuantity": 50,
                "ResponseEstimatedQuantity": null,
                "UOMCode": "Ea",
                "UOM": "Each",
                "LineCloseDate": "2022-12-31T17:53:00+00:00",
                "LineTargetPrice": null,
                "LinePrice": null,
                "LineAmount": 55000.00,
                "PricingBasisCode": null,
                "PricingBasis": null,
                "TargetMinimumReleaseAmount": null,
                "ResponseMinimumReleaseAmount": null,
                "EstimatedTotalAmount": null,
                "ShipToLocationId": 204,
                "ShipToLocation": "V1- New York City",
                "RequestedDeliveryDate": null,
                "RequestedShipDate": null,
                "PromisedDeliveryDate": "2023-05-31",
                "PromisedShipDate": null,
                "NoteToBuyer": "Final response",
                "NoteToSupplier": null,
                "SuppliersCanModifyPriceBreaksFlag": null,
                "PriceBreakTypeCode": null,
                "PriceBreakType": null,
                "CreatedBy": "PONSupplier06",
                "CreationDate": "2022-11-02T17:54:38+00:00",
                "LastUpdatedBy": "PONSupplier06",
                "LastUpdateDate": "2022-11-02T18:14:55.262+00:00",
                "@context": {
                    "key": "2",
                    "headers": {
                        "ETag": ...
                    },
                    "links": [
                        {
                            "rel": "self",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "canonical",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2",
                            "name": "lines",
                            "kind": "item"
                        },
                        {
                            "rel": "parent",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755",
                            "name": "draftSupplierNegotiationResponses",
                            "kind": "item"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2/child/attachments",
                            "name": "attachments",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2/child/costFactors",
                            "name": "costFactors",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2/child/lineAttributeGroups",
                            "name": "lineAttributeGroups",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2/child/priceBreaks",
                            "name": "priceBreaks",
                            "kind": "collection"
                        },
                        {
                            "rel": "child",
                            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188755/child/lines/2/child/priceTiers",
                            "name": "priceTiers",
                            "kind": "collection"
                        }
                    ]
                }
            }
        }
    ]
}

Validate a Draft Response

Super Computers can now verify if there are any errors in the response values updated in the draft response using the Validate user-defined action.

Example Request

Here's an example of the request body in JSON format:
{
   "parameters": {
        
                "Response": "188755",
                "ResponseAction": "Validate"                
  }
    }

Example Response

Here's an example of the response body in JSON format:
{
    "result": {
        "Response": "188755",
        "ResponseStatus": "Draft",
        "Negotiation": "40124",
        "NegotiationTitle": "Laptop Procurement FY23",
        "ProcurementBU": "Vision Operations",
        "Message": "Response was validated without errors"
    }
}

Submit a Draft Response

After successfully validating the response, Super Computers can submit the draft response for the negotiation using the Submit user-define action. The response status changes from Draft to Active.

Example Request

Here's an example of the request body in JSON format:
{
   "parameters": {
        
                "Response": "188755",
                "ResponseAction": "Submit"                
  }
    }

Example Response

Here's an example of the response body in JSON format:
{
    "result": {
        "Response": "188755",
        "ResponseStatus": "Active",
        "Negotiation": "40124",
        "NegotiationTitle": "Laptop Procurement FY23",
        "ProcurementBU": "Vision Operations",
        "Message": "Response submitted successfully"
    }
}

Create a Surrogate Response

The negotiation owner received an offline response from supplier Techno Enterprises. Now the user-defined action Create Negotiation Response is used to create a surrogate response on behalf of supplier company and supplier contact Peter Mckinsenly.

Example Request

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

{       "AuctionHeaderId":"300100546799787",
         "Negotiation": "40124",
         "ProcurementBU":"Vision Scotland",
         "ProcurementBUId":"15567",
         "Buyer": "Kinley, Adam",
         "BuyerId": "66152",
         "Supplier": "Techno Enterprises",
         "SupplierId":"12737",      
         "SupplierContact":"Mckinsenly, Peter",
          "SupplierContactId":"292354",
          "SupplierSite":"Edinburg",
          "SupplierSiteId": "5058"
           
}

Example Response

Here's an example of the response body in JSON format:
{
        "Response": "188759"
    }

Revise a Response

The RFQ for procuring laptops allows the suppliers to revise their responses and Super Computers wants to revise their submitted response. A new draft response will be created with all the response prices and attachments copied into the new draft response.

You can also copy a response by using ResponseIntent as Copy.

Example Request

Here's an example of the request body in JSON format:
{       "AuctionHeaderId":"300100546799787",
         "Negotiation": "40124",
         "ProcurementBU":"Vision Scotland",
         "ProcurementBUId":"15567",
         "Supplier": "Super Computers",
         "SupplierId":"12737",      
         "SupplierContact":"Harley, Kims",
          "SupplierContactId":"299954",
          "SupplierSite":"Edinburg",
          "SupplierSiteId": "5058",
        "ResponseIntent": "Revise",
        "SourceResponse": "188755"
           
}

Example Response

Here's an example of the response body in JSON format:
{
        "Response": "188755"
    }