Get one negotiation

get

/fscmRestApi/resources/11.13.18.05/supplierNegotiations/{supplierNegotiationsUniqID}

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Supplier Negotiations resource and used to uniquely identify an instance of Supplier Negotiations. The client should not generate the hash key value. Instead, the client should query on the Supplier Negotiations collection resource in order to navigate to a specific instance of Supplier Negotiations to get the hash key.
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • This header accepts a string value. The string is a semi-colon separated list of =. It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers.
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : supplierNegotiations-item-response
Type: object
Show Source
  • Abstracts
    Title: Abstracts
    The Abstracts resource manages details about the summary or abstract of a negotiation for posting to a public platform.
  • Title: Agreement Amount
    Total amount on the purchase agreement. If you are renegotiating the agreement, then the application defaults the value for this attribute from the agreement. As an option, if the NegotiationType is RFQ (request for quotation) or Auction, and if the value of Outcome is Blanket Purchase Agreement or Contract Purchase Agreement, then you can specify a value for AgreementAmount. If AgreementAmount does not apply, then it is empty.
  • Title: Agreement End Date
    Date when the purchase agreement expires. If you are renegotiating the agreement, then the application defaults the value for this attribute from the agreement. As an option, if the NegotiationType is RFQ (request for quotation) or Auction, and if the value of Outcome is Blanket Purchase Agreement or Contract Purchase Agreement, then you can specify a value for AgreementEndDate. If AgreementEndDate does not apply, then it is empty.
  • Title: Agreement Start Date
    Date when the purchase agreement goes into effect. As an option, if the NegotiationType is RFQ (request for quotation) or Auction, and if the value of Outcome is Blanket Purchase Agreement or Contract Purchase Agreement, then you can specify a value for AgreementStartDate. If AgreementStartDate does not apply, then it is empty.
  • Title: Contract Source
    Read Only: true
    Indicates the duration in number of months for which data needs to be extracted for creation of an artificial intelligence model to provide supplier recommendations.
  • Title: Allow Alternate Lines
    Maximum Length: 30
    Contains one of the following values: true or false. If true, then allow the supplier to create an alternate response line for each negotiation line. If false, then do not allow. If the negotiation is of type RFI (request for information), and if lines are not enabled for the negotiation style, then the default value for AllowAlternateLinesFlag is empty. Otherwise, the default value is true.
  • Title: Display Rule Allow Multiple Responses to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether they can submit more than one response during each negotiation round. If false, then do not allow. The default value is true.
  • Title: Allow multiple responses
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then allow the supplier to submit more than one response during each negotiation round. If false, then do not allow. The default value is true for auction and false for RFQ (request for quotation) or RFI (request for information).
  • Title: Allow responses in other currencies
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to submit a response in a currency other than the negotiation currency. If false, then do not allow. The default value is false.
  • Title: Display Rule Allow Response Revision to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether they can revise the response during each negotiation round. If false, then do not allow. The default value is true.
  • Title: Allow response revision
    Maximum Length: 30
    Contains one of the following values: true or false. If true, then allow the supplier to revise their active replies during each negotiation round. If false, then do not allow. The default value is true for auction and false for RFQ (request for quotation) or RFI (request for information).
  • Title: Allow suppliers to negotiate retainage
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to enter retainage attributes. If false, then do not allow. The default value is false.
  • Title: Amendment Description
    Maximum Length: 4000
    Description of the change in the document when someone amends the negotiation.
  • Title: Approval Amount
    Amount on negotiation that you can use when routing an approval. If the application creates the negotiation from an expiring agreement, then the default value is the agreement amount. If the application creates the negotiation when it processes requisition lines, then the default value is the total requisition amount. The user can update the approval amount in negotiation.
  • Attachments
    Title: Attachments
    The Attachments resource manages details about attachments for supplier negotiation.
  • Read Only: true
    Value that uniquely identifies the negotiation.
  • Title: Lines to Autoextend
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then extend all lines of the negotiation instead of extending only the lines that include a winning response. If false, then extend only the lines that include a winning response. The default value is true.
  • Title: Length of Extension in Minutes
    Number of minutes the application extends the negotiation when the negotiation meets the extension criteria.
  • Title: Allow autoextend
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow automatic extension on the close date according to settings defined in the negotiation. If false, then do not allow. The default value is false. AutoExtendFlag applies only for auction.
  • Title: Start Time of Extensions
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then extend the close date of the negotiation from the current close date. If false, then extend the receiving time from the response that starts the negotiation. The default value is true.
  • Title: Lowest Triggering Response Rank
    Lowest rank of response that can start an extension of the negotiation.
  • Title: Triggering Period in Minutes
    Time period that occurs before the negotiation close date where the response can start an extension.
  • Title: Number of Extensions
    Number of times the application can extend the negotiation.
  • Title: Award Date
    Date when the application awards the negotiation.
  • Title: Buyer
    Maximum Length: 240
    Name of the person who created the negotiation.
  • Value that uniquely identifies the person who created the negotiation.
  • Title: Buyer managed transportation
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the buying company is responsible for arranging transportation. If false, then buying company is not responsible for arranging transportation. The default value is false.
  • Title: Carrier
    Read Only: true
    Maximum Length: 360
    Display name of the company that transports the item from one point to another point through land, sea, or air.
  • Value that uniquely identifies the name of the company that transports the item from one point to another point through land, sea, or air.
  • Title: Close Date
    Date when the negotiation stops accepting replies from the supplier.
  • Collaboration Team Members
    Title: Collaboration Team Members
    The Collaboration Team Members resource manages details about collaboration team members for each supplier negotiation and the tasks these members perform. For example, John Brown from engineering reviews item specifications, or Richard Smith from legal reviews terms and conditions.
  • Title: Commercial Stage Scoring Status
    Read Only: true
    Maximum Length: 80
    Status of scoring in the commercial stage of a two stage RFQ (request for quotation). Values include Open, Closed, or Not Started.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the status of scoring in the commercial stage of a two stage RFQ (request for quotation). Values include Open, Closed, or Not started.
  • Title: Commercial Stage Unlocked By
    Read Only: true
    Maximum Length: 240
    User who unlocked the commercial stage of the two stage RFQ (request for quotation).
  • Title: Commercial Stage Unlocked Date
    Read Only: true
    Date and time when the user unlocked the commercial stage of the two stage RFQ (request for quotation).
  • Title: Commercial Stage Unsealed By
    Read Only: true
    Maximum Length: 240
    User who unsealed the commercial stage of the two stage RFQ (request for quotation).
  • Title: Commercial Stage Unsealed Date
    Read Only: true
    Date and time when the user unsealed the commercial stage of the two stage RFQ (request for quotation).
  • Title: Contract Source
    Read Only: true
    Maximum Length: 80
    Indicates whether the application authors the contract from the contract terms template or from an attached document.
  • Title: Contract Terms Layout
    Maximum Length: 240
    Layout from Oracle Business Intelligence Publisher that the application uses to create the PDF (Portable Document Format) file for the negotiation.
  • Read Only: true
    Maximum Length: 240
    Contract terms template with standard contract terms defined in the contracts library. It contains clauses and deliverables that the application applies to the negotiation.
  • Read Only: true
    Value that uniquely identifies the contract terms template.
  • Title: Conversion Date
    Date when the application used the conversion rate to convert each response from some other currency to the negotiation currency.
  • Title: Conversion Rate Type
    Read Only: true
    Maximum Length: 30
    Display name that indicates the type of conversion rate that the application uses to convert the response currency to the negotiation currency. Values include Corporate or User.
  • Title: Conversion Rate Type Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the type of conversion rate that the application uses to convert the response currency to the negotiation currency.
  • Text that describes the negotiation cover page.
  • Read Only: true
    Maximum Length: 64
    User who created the supplier negotiation.
  • Read Only: true
    Date and time when the user created the supplier negotiation.
  • Title: Negotiation Currency
    Maximum Length: 80
    Name of the negotiation currency.
  • Title: Negotiation Currency Code
    Maximum Length: 15
    Abbreviation that identifies the currency that the negotiation uses.
  • Number of days after the open date when the negotiation will close.
  • Title: Default Maximum Score
    Default value of the maximum score for each negotiation requirement.
  • Internal Flexfields
    Title: Internal Flexfields
    The Internal Flexfields resource contains details about the header of each internal supplier negotiation.
  • Title: Display best price to suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then display the best price to the supplier during a blind negotiation. If false, then do not display. The default value is false. If the response visibility is Blind, then DisplayBestPriceBlindFlag applies to auction or RFQ (request for quotation).
  • Title: Display rates to suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the currency exchange rate that the negotiation uses. If false, then do not allow. The default value is false.
  • Title: Display Requirement Scoring Criteria to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the requirement scoring criteria. If false, then do not allow. The default value is false. If the negotiation style enables requirements, then DisplayRequirementScoresFlag is applied.
  • Title: Display Line Attribute Scoring Criteria to Suppliers
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then allow the supplier to view the line attribute scoring criteria. If false, then do not allow. The default value is false. If the user sets Multiattribute Scoring to Ranking Method, then DisplayScoresToSuppliersFlag is visible.
  • Title: Enable weights
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the application to include weight when calculating the requirement score. If false, then do not allow. If the negotiation style enables requirements, then the default value for EnableRequirementWeightsFlag is empty, else the default value is true.
  • Read Only: true
    Contains one of the following values: true or false. If true, then the overall ranking method is composite scoring. If false, then the overall ranking method is Response amount only. The default value is false.
  • Title: Enable team scoring
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then enable team scoring for requirements. If false, then do not enable. The default value is false.
  • Title: Enforce supplier's previous round price as start price for this round
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then use the price that the supplier submits in the previous round of negotiations as the start price for the current round. If false, then do not use this price. The default value is false.
  • Title: First Line Close Date
    Date when the first line of the negotiation closes when the application enables staggered closing.
  • Title: FOB
    Read Only: true
    Maximum Length: 80
    Point or location where the ownership of the items and services and the cost of damage or loss transfers from the supplier to the buyer. A list of accepted values is defined in the lookup type FOB.
  • Title: FOB Code
    Maximum Length: 30
    Abbreviation that identifies the point or location where the ownership of the items and services and the cost of damage or loss transfers from the supplier to the buyer. A list of accepted values is defined in the lookup type FOB.
  • Title: Freight Terms
    Read Only: true
    Maximum Length: 80
    Name of the terms that determine whether the buyer or supplier pays freight charges for items and services. A list of accepted values is defined in the lookup type FREIGHT TYPE.
  • Title: Freight Terms Code
    Maximum Length: 30
    Abbreviation that identifies the name of the terms that determine whether the buyer or supplier pays freight charges for items and services. A list of accepted values is defined in the lookup type FREIGHT TYPE.
  • Text that describes the negotiation.
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the application enabled large negotiations. If false, then it did not. The default value is false.
  • Read Only: true
    Date and time when the user most recently updated the negotiation.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the negotiation.
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then line level decrement is enabled in the negotiation. If false, then line level decrement is not enabled in the negotiation. If Line level price decrement is enabled in the negotiation style for an Auction, RankingMethod is Price only, AllowResponseRevision is true and RevisedResponseLinePriceRule is Lower than previous price or Lower than best price, then the default value is true. Otherwise, the default value is false.
  • Lines
    Title: Lines
    The Lines resource manages details about products and services that the application sources in a supplier negotiation. For example, catering services or laptop computers.
  • Text that describes instructions for the negotiation line.
  • Links
  • Title: Minimum Release Amount
    Minimum amount in any purchase order line that the application can release for the purchase agreement line.
  • Title: Mode of Transport
    Read Only: true
    Maximum Length: 80
    Transportation mode that the application uses to transport the item. A list of accepted values is defined in the lookup type WSH_MODE_OF_TRANSPORT.
  • Maximum Length: 30
    Abbreviation that identifies the transportation mode that the application uses to transport the item. A list of accepted values is defined in the lookup type WSH_MODE_OF_TRANSPORT.
  • Title: Negotiation
    Read Only: true
    Maximum Length: 240
    Number that uniquely identifies the negotiation.
  • Negotiation Lifecycle Activities
    Title: Negotiation Lifecycle Activities
    The Negotiation Lifecycle Activities resource gets the details about sourcing activities performed in a negotiation.
  • Title: Negotiation Layout
    Maximum Length: 240
    Layout that the application uses in Oracle Business Intelligence Publisher to create the negotiation in PDF (Portable Document Format).
  • Negotiation Recommended Suppliers
    Title: Negotiation Recommended Suppliers
    The Negotiation Recommended Suppliers resource manages details about supplier recommendations for a negotiation.
  • Read Only: true
    Maximum Length: 255
    Status of the negotiation. A list of accepted values is defined in the lookup type PON_AUCTION_STATUS.
  • Title: Negotiation Style
    Maximum Length: 80
    Name of the negotiation style.
  • Title: Negotiation Style ID
    Value that uniquely identifies the negotiation style.
  • Title: Title
    Maximum Length: 80
    Text that describes the purpose of the negotiation.
  • Title: Negotiation Type
    Maximum Length: 50
    Type of the negotiation. Values include Auction, RFQ, or RFI.
  • Title: Negotiation Type ID
    Value that uniquely identifies the type of negotiation.
  • Maximum Length: 1000
    Note for the approver when submitting the document for approval.
  • Title: Open Date
    Date when the negotiation starts accepting replies from suppliers.
  • Title: Open immediately
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow suppliers to respond immediately after the application publishes the negotiation. If false, then do not allow. The default value is false.
  • Title: Outcome
    Maximum Length: 240
    Display name of the purchasing document that the application creates at the end of the negotiation process. Use page Manage Document Styles in the Setup and Maintenance work area to examine and update the values that you can use for this attribute.
  • Title: Overall Ranking Method
    Maximum Length: 80
    Method that the application uses to calculate the overall ranking for supplier response . Values include Response amount only or Composite scoring. A list of accepted values is defined in the lookup type ORA_PON_OVERALL_RANKING_METHOD.
  • Title: Overall Ranking Method Code
    Maximum Length: 30
    Abbreviation that identifies the method that the application uses to calculate the overall ranking for supplier response. Values include Response amount only or Composite scoring. A list of accepted values is defined in the lookup type ORA_PON_OVERALL_RANKING_METHOD.
  • Title: Payment Terms
    Maximum Length: 50
    Name of the payment terms that the supplier applies when making the sale according to the due date and discount date that paying the invoice requires.
  • Title: Payment Terms ID
    Value that uniquely identifies the name of the payment terms that the supplier applies when making the sale according to the due date and discount date that paying the invoice requires.
  • Title: Purchasing Document Type
    Read Only: true
    Maximum Length: 80
    Document type of the purchasing document.
  • Title: Purchasing Document Type Code
    Maximum Length: 25
    Abbreviation that uniquely identifies the document type of the purchasing document.
  • Title: Purchasing Document Style
    Read Only: true
    Maximum Length: 240
    Name of the purchasing document style.
  • Title: Purchasing Document Style ID
    Value that uniquely identifies the purchasing document style.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then prebid is enabled in the negotiation. If false, then prebid is not enabled in the negotiation. If prebid is enabled in the negotiation style for an Auction or RFQ, and PreviewDate is set or PreviewImmediatelyFlag is true, and ResponseVisibility is Open or Blind, then the default value is true. Otherwise, the default value is false.
  • Title: Preview Date
    Date when suppliers can view the negotiation but not yet respond to the negotiation.
  • Title: Preview immediately
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow suppliers to view the negotiation immediately after the application publishes it but before the application allows suppliers to respond to the negotiation. If false, then do not allow. The default value is false.
  • Title: Price Precision
    Number of decimal places that the application displays for each price attribute in the response.
  • Title: Price Tiers
    Maximum Length: 80
    Price tier type that the negotiation uses. Values include None, Price Break, or Quantity. A list of accepted values is defined in the lookup type PON_PRICE_BREAK_OPTIONS.
  • Title: Price Tiers Code
    Maximum Length: 30
    Abbreviation that identifies the price tier type that the negotiation uses. Values include None, Price Break, or Quantity. A list of accepted values is defined in the lookup type PON_PRICE_BREAK_OPTIONS.
  • Title: Procurement BU
    Maximum Length: 240
    Name of the procurement business unit that owns the negotiation.
  • Title: Procurement BU ID
    Value that uniquely identifies the procurement business unit that owns the negotiation.
  • Title: Rank Indicator
    Maximum Length: 80
    Indicator that the application uses to rank replies from suppliers during the negotiation. Values include Best; 1,2,3; or No. No specifies to not display any indicator. A list of accepted values is defined in the lookup type PON_RANK_INDICATOR_CODE.
  • Title: Rank Indicator Code
    Maximum Length: 25
    Abbreviation that identifies the indicator that the application uses to rank replies from suppliers during the negotiation. Values include Best; 1,2,3; or No. No specifies to not display any indicator. A list of accepted values is defined in the lookup type PON_RANK_INDICATOR_CODE.
  • Title: Ranking Method
    Maximum Length: 80
    Method that the application uses to rank supplier replies during the negotiation. Values include Price or Multiattribute. A list of accepted values is defined in the lookup type PON_BID_RANKING_CODE.
  • Title: Ranking Method Code
    Maximum Length: 25
    Abbreviation that identifies the method that the application uses to rank supplier replies during the negotiation. Values include Price or Multiattribute. A list of accepted values is defined in the lookup type PON_BID_RANKING_CODE.
  • Title: Display Rule Require Full Quantity to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether the negotiation requires the response to match the quantity that the negotiation requests. If false, then do not allow. The default value is true.
  • Title: Require full quantity
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then the response must match the quantity that the negotiation requests. If false, then allow the response to include a quantity that does not meet the quantity that the negotiation requests. If the outcome is Standard Purchase Order, then the default value is true, else the default value is false.
  • Text that describes how to respond to each negotiation requirement.
  • Title: Requisitioning BU
    Maximum Length: 240
    Name of the requisition business unit that the application uses to set default values for each negotiation line.
  • Title: Requisitioning BU ID
    Value that uniquely identifies the requisition business unit.
  • Title: Display Rule Respond on All Lines to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether the negotiation requires them to respond to all lines. If false, then do not allow. The default value is true.
  • Title: Allow suppliers to select lines on which to respond
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then allow the supplier to respond to all lines in the negotiation. If false, then do not allow. The default value is true for an auction; or false for RFQ (request for quotation), or RFI (request for information).
  • Response Currencies
    Title: Response Currencies
    The Response Currencies resource manages details about response currencies in each supplier negotiation, including conversion rates to the negotiation currency.
  • Title: Response Layout
    Maximum Length: 240
    Layout that the application uses in Oracle Business Intelligence Publisher to create the negotiation response in PDF (Portable Document Format).
  • Title: Response Revision Decrement Type
    Maximum Length: 80
    Display the minimum price reduction of each revised response as an amount or a percent. Values include Amount or Percentage. A list of accepted values is defined in the lookup type PON_DECREMENT_TYPE.
  • Title: Response Revision Decrement Type Code
    Maximum Length: 25
    Abbreviation that uniquely the minimum price reduction of each revised response as an amount or a percent. Values include Amount or Percentage. A list of accepted values is defined in the lookup type PON_DECREMENT_TYPE.
  • Title: Response Revision Decrement Value
    Minimum amount or percentage of reduction of the line price in each revised response. If line level price decrement is enabled in the negotiation style for an auction, then this is the default value applied to new lines.
  • Title: Response Visibility
    Maximum Length: 80
    Specify when the supplier can view details from competing responses. Values include Open, Sealed, or Blind. A list of accepted values is defined in the lookup type PON_BID_VISIBILITY_CODE.
  • Title: Response Visibility Code
    Maximum Length: 25
    Abbreviation that specifies when the supplier can view details from competing responses. Values include Open, Sealed, or Blind. A list of accepted values is defined in the lookup type PON_BID_VISIBILITY_CODE.
  • Title: Display Rule Restrict to Invited Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether the negotiation restricts access to invited suppliers. If false, then do not allow. The default value is true.
  • Title: Restrict to invited suppliers
    Maximum Length: 25
    Contains one of the following values: true or false. If true, then allow only invited suppliers to access the negotiation. If false, then allow any supplier to access the negotiation. The default value is false for auction; or true for RFQ (request for quotation), or RFI (request for information).
  • Title: Revised Response Line Price Rule
    Maximum Length: 80
    Specifies how the revised response must modify its price. Values include No Restriction, Lower Than Previous Price, or Lower Than Best Price. A list of accepted values is defined in the lookup type PON_REVISED_LINE_PRICE. The default value is No Restriction.
  • Title: Revised Response Line Price Rule Code
    Maximum Length: 15
    Abbreviation that specifies how the revised response must modify its price. Values include No Restriction, Lower Than Previous Price, or Lower Than Best Price. A list of accepted values is defined in the lookup type PON_REVISED_LINE_PRICE. The default value is No Restriction.
  • Title: Scoring Status
    Read Only: true
    Maximum Length: 80
    Status of scoring in the negotiation. Values include Open, Closed, or Not Started.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the status of scoring in the negotiation. Values include Open, Closed, or Not started.
  • Scoring Teams
    Title: Scoring Teams
    The Scoring Teams resource manages details about teams that evaluate and score each requirement.
  • Sections
    Title: Sections
    The Sections resource manages details about the sections of a supplier negotiation requirement. For example, commercial requirements, manufacturing capabilities, or technical requirements.
  • Title: Service Level
    Read Only: true
    Maximum Length: 80
    Priority to use when determining how quickly to ship the item. A list of accepted values is defined in the lookup type WSH_SERVICE_LEVELS.
  • Maximum Length: 30
    Abbreviation that identifies the priority to use when determining how quickly to ship the item. A list of accepted values is defined in the lookup type WSH_SERVICE_LEVELS.
  • Value that indicates the method of shipping. This value is a combination of the concatenated values of carrier, mode of transport, and service level.
  • Title: Source Agreement
    Maximum Length: 30
    Agreement that the negotiators are using to renegotiate the current negotiation.
  • Title: Allow staggered closing
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow lines to use staggered close dates in the negotiation. If false, then do not allow. The default value is false.
  • Title: Interval in Minutes
    Time interval between two negotiation lines in a staggered closing.
  • Supplier Flexfields
    Title: Supplier Flexfields
    The Supplier Flexfields resource contains details about the header of each internal supplier negotiation.
  • Suppliers
    Title: Suppliers
    The Suppliers resource manages details about suppliers that submit a response for a negotiation.
  • Title: Synopsis
    Maximum Length: 4000
    Text that summaries the negotiation.
  • Title: Technical Stage Scoring Status
    Read Only: true
    Maximum Length: 80
    Status of scoring in the technical stage of a two stage RFQ (request for quotation). Values include Open, Closed, or Not Started.
  • Read Only: true
    Maximum Length: 30
    Abbreviation that identifies the status of scoring in the technical stage of a two stage RFQ (request for quotation). Values include Open, Closed, or Not started.
  • Title: Technical Stage Unlocked By
    Read Only: true
    Maximum Length: 240
    User who unlocked the technical stage of the two stage RFQ (request for quotation).
  • Read Only: true
    Date and time when the user unlocked the technical stage of the two stage RFQ (request for quotation).
  • Title: Technical Stage Unsealed By
    Read Only: true
    Maximum Length: 240
    User who unsealed the technical stage of the two stage RFQ (request for quotation).
  • Read Only: true
    Date and time when the user unsealed the technical stage of the two stage RFQ (request for quotation).
  • Text that describes how to negotiate terms.
  • Title: Two stage evaluation
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the application enabled two stage evaluation for the negotiation. If false, then not enabled. The default value is false.
  • Title: Display Rule View Notes and Attachments to Suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view whether the negotiation allows them to view contract terms, notes, and attachments that other suppliers submitted. If false, then do not allow. The default value is true.
  • Title: Allow supplier to see other supplier's notes and attachments
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view contract terms, notes, and attachments that other suppliers submitted. If false, then do not allow. The default value is true.
Nested Schema : Abstracts
Type: array
Title: Abstracts
The Abstracts resource manages details about the summary or abstract of a negotiation for posting to a public platform.
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages details about attachments for supplier negotiation.
Show Source
Nested Schema : Collaboration Team Members
Type: array
Title: Collaboration Team Members
The Collaboration Team Members resource manages details about collaboration team members for each supplier negotiation and the tasks these members perform. For example, John Brown from engineering reviews item specifications, or Richard Smith from legal reviews terms and conditions.
Show Source
Nested Schema : Internal Flexfields
Type: array
Title: Internal Flexfields
The Internal Flexfields resource contains details about the header of each internal supplier negotiation.
Show Source
Nested Schema : Lines
Type: array
Title: Lines
The Lines resource manages details about products and services that the application sources in a supplier negotiation. For example, catering services or laptop computers.
Show Source
Nested Schema : Negotiation Lifecycle Activities
Type: array
Title: Negotiation Lifecycle Activities
The Negotiation Lifecycle Activities resource gets the details about sourcing activities performed in a negotiation.
Show Source
Nested Schema : Negotiation Recommended Suppliers
Type: array
Title: Negotiation Recommended Suppliers
The Negotiation Recommended Suppliers resource manages details about supplier recommendations for a negotiation.
Show Source
Nested Schema : Response Currencies
Type: array
Title: Response Currencies
The Response Currencies resource manages details about response currencies in each supplier negotiation, including conversion rates to the negotiation currency.
Show Source
Nested Schema : Scoring Teams
Type: array
Title: Scoring Teams
The Scoring Teams resource manages details about teams that evaluate and score each requirement.
Show Source
Nested Schema : Sections
Type: array
Title: Sections
The Sections resource manages details about the sections of a supplier negotiation requirement. For example, commercial requirements, manufacturing capabilities, or technical requirements.
Show Source
Nested Schema : Supplier Flexfields
Type: array
Title: Supplier Flexfields
The Supplier Flexfields resource contains details about the header of each internal supplier negotiation.
Show Source
Nested Schema : Suppliers
Type: array
Title: Suppliers
The Suppliers resource manages details about suppliers that submit a response for a negotiation.
Show Source
Nested Schema : supplierNegotiations-abstracts-item-response
Type: object
Show Source
  • Title: Meaning
    Read Only: true
    Maximum Length: 80
    Status of the negotiation abstract. Values include Posted or Not Posted. A list of accepted values is defined in the lookup type ORA_PON_ABS_STATUS.
  • Maximum Length: 30
    Value that indicates the negotiation lifecycle event when the abstract is posted automatically. Valid values are on preview date, on open date, or on negotiation publish. A list of accepted values is defined in the lookup type ORA_PON_ABS_POST_METHOD.
  • Date when the application posts the PDF (Portable Document Format) file for the award notice on the negotiation abstract.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then the PDF (Portable Document Format) file for the award notice is available on the negotiation abstract. If false, then not available. The default value is false.
  • Read Only: true
    Text that the buyer enters. The application includes this text when it publishes the PDF (Portable Document Format) file for the award notice.
  • Read Only: true
    Maximum Length: 64
    User who created the abstract.
  • Read Only: true
    Date and time when the user created the abstract.
  • Flexfields for Abstracts
    Title: Flexfields for Abstracts
    The Flexfields for Abstracts resource contains details about abstracts.
  • Title: Include negotiation attachments to supplier
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then all the supplier category attachments are displayed in the negotiation abstract. If false, then the supplier category attachments are not displayed in the negotiation abstract. The default value is false.
  • Title: Include negotiation PDF
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the supplier can download the negotiation in PDF (Portable Document Format) from the abstract window. If false, then supplier cannot perform this download. The default value is false.
  • Read Only: true
    Date and time when the user most recently updated the abstract.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the abstract.
  • Links
  • Title: Automatically post abstract
    Maximum Length: 1
    Contains one of the following values: true or false. If true, abstract is posted automatically to company???s external website. If false, abstract needs to be posted manually from the application. The default value is false.
  • Title: Name
    Read Only: true
    Maximum Length: 240
    User who posted the negotiation abstract.
  • Title: Posting Date
    Date when the user posted the negotiation abstract.
  • Title: Meaning
    Read Only: true
    Maximum Length: 80
    Indicates whether the user posted the negotiation abstract manually or the application posted it automatically. A list of accepted values is defined in the lookup type ORA_PON_ABS_POST_METHOD.
  • Date when the application posts the response tabulation for the negotiation abstract in PDF (Portable Document Format).
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then the response tabulation in PDF (Portable Document Format) is available on the negotiation abstract. If false, then not available. The default value is false.
Nested Schema : Flexfields for Abstracts
Type: array
Title: Flexfields for Abstracts
The Flexfields for Abstracts resource contains details about abstracts.
Show Source
Nested Schema : supplierNegotiations-abstracts-DFF-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-collaborationTeamMembers-item-response
Type: object
Show Source
  • Title: Access
    Maximum Length: 80
    Access for each collaboration team member. Values include Full or View Only. A list of accepted values is defined in the lookup type PON_NEG_COLLAB_TEAM_ACCESS.
  • Title: Access Code
    Maximum Length: 30
    Abbreviation that identifies the access for each collaboration team member. Values include FULL or VIEW_ONLY. A list of accepted values is defined in the lookup type PON_NEG_COLLAB_TEAM_ACCESS.
  • Read Only: true
    Maximum Length: 64
    User who created the team member.
  • Read Only: true
    Date and time when the user created the team member.
  • Title: Last Notified Date
    Read Only: true
    Date and time when the application most recently notified the collaboration team member about the collaboration team task.
  • Read Only: true
    Date and time when the user most recently updated the team member.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the team member.
  • Links
  • Value that uniquely identifies the collaboration team that the application added to the negotiation.
  • Title: Price Visibility
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the team member can view price details on the response document when evaluating each response. If false, then cannot view. The default value is true.
  • Read Only: true
    Name of the scoring team that a collaboration team member is assigned to.
  • Title: Supplier Messages
    Maximum Length: 80
    Access to message suppliers for each collaboration team member. Values include No access, Receive only, or Send and receive. A list of accepted values is defined in the lookup type ORA_PON_COLLAB_TEAM_SUPP_MSG.
  • Title: Supplier Messages Code
    Maximum Length: 30
    Abbreviation that identifies the access to message suppliers for each collaboration team member. Values include ORA_NO_ACCESS, ORA_RECEIVE_ONLY, or ORA_SEND_AND_RECEIVE. A list of accepted values is defined in the lookup type ORA_PON_COLLAB_TEAM_SUPP_MSG.
  • Read Only: true
    Date when the collaboration team member finishes the assigned task.
  • Title: Task
    Maximum Length: 4000
    Name of the task that the application assigned to the collaboration team member.
  • Title: Target Date
    Date when the application expects the collaboration team member to finishes the assigned task.
  • Title: Team Member
    Maximum Length: 240
    Name of the collaboration team member that the application added to the negotiation.
  • Read Only: true
    Value that uniquely identifies each team member.
Nested Schema : supplierNegotiations-DFF-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-lines-item-response
Type: object
Show Source
  • Title: Allow Alternate Lines
    Maximum Length: 30
    Contains one of the following values: true or false. If true, then allow the supplier to create an alternate response line for each negotiation line. If false, then do not allow. If Allow Alternate Lines is not enabled, then the default value for AllowAlternateLinesFlag is empty. Otherwise, the default value is true. The value for AllowAlternateLinesFlag is empty for a group or lot line.
  • Attachments
    Title: Attachments
    The Attachments resource manages details about attachments for a negotiation line.
  • Read Only: true
    Value that uniquely identifies the negotiation.
  • Value that identifies the purchasing category for the negotiation line.
  • Maximum Length: 2400
    Name of the purchasing category for the negotiation line.
  • External Cost Factors
    Title: External Cost Factors
    The Cost Factors resource manages details about the cost factors for a negotiation line. For example, freight, setup charges, or switching costs.
  • Read Only: true
    Maximum Length: 64
    User who created the line.
  • Read Only: true
    Date and time when the user created the line.
  • Title: Current Price
    Price that the procurement organization pays for the item or service.
  • Flexfields
    Title: Flexfields
    The Flexfields resource contains details about negotiation lines.
  • Title: Display target price
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the target price. If false, then do not allow. If the negotiation is a RFI (request for information), or if the application does not enable Allow Price and enable Quantity, then the default value for DisplayTargetPriceFlag is empty. If the line resides in a group, then the default value is empty, else the default value is false.
  • Title: Display Line Target Price
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the unit target price. If false, then do not allow. If the line resides in a group, then the default value is empty, else the default value is false.
  • Title: Estimated Quantity
    Estimated quantity of the item in the negotiation.
  • Title: Estimated Total Amount
    Estimated total amount of the service in the negotiation.
  • Title: Type
    Maximum Length: 80
    Type of negotiation line, such as line, group, group line, lot, or lot line. A list of accepted values is defined in the lookup type Negotiation Line Type.
  • Maximum Length: 25
    Abbreviation that identifies the type of negotiation line, such as line, group, group line, lot, or lot line. A list of accepted values is defined in the lookup type Negotiation Line Type.
  • Title: Item
    Maximum Length: 300
    Name of the inventory item.
  • Value that identifies the inventory item.
  • Title: Revision
    Maximum Length: 18
    Revision of the inventory item on the negotiation line.
  • Read Only: true
    Date and time when the user most recently updated the line.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the line.
  • Title: Line
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Attribute Groups
    Title: Attribute Groups
    The Attribute Groups resource manages details about groups of attributes on the supplier negotiation line.
  • Title: Close Date
    Date and time when the negotiation line closes in a staggered closing or in a negotiation that can extend.
  • Title: Description
    Maximum Length: 2500
    Description of the negotiation line.
  • Read Only: true
    Value that uniquely identifies the negotiation line.
  • Title: Line Type
    Maximum Length: 30
    Name of the line type that indicates whether the line is for items or services. A list of accepted values is defined in the lookup type ORDER TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, and the Manage Purchasing Line Types task.
  • Title: Line Type ID
    Value that identifies the line type that indicates whether the line is for items or services.
  • Links
  • Title: Maximum Retainage Amount
    Maximum amount of retainage that can be withheld on a line.
  • Title: Minimum Release Amount
    Minimum amount in any purchase order line that the application can release for the purchase agreement line.
  • Negotiation Line Recommended Suppliers
    Title: Negotiation Line Recommended Suppliers
    The Negotiation Line Recommended Suppliers resource manages details about supplier recommendations for a negotiation line.
  • Title: Note to Suppliers
    Maximum Length: 4000
    Note for the negotiation line for the supplier.
  • Title: Parent Line
    Maximum Length: 25
    Number that identifies an existing group or lot as a parent line in a negotiation. It is the value stored in the Line attribute. Group Line can be added as a child of Group, and Lot Line can be added as a child of Lot.
  • Sequence number of the parent line to which a child line is added. Group Line can be added as a child of Group, and Lot Line can be added as child of Lot.
  • Maximum Length: 255
    Contains one of the following values: true or false. If true, then allow each RFI (request for information) line to include price and quantity. If false, then do not allow. If the line resides in a group, then the default value is empty, else the default value is true.
  • Price Breaks
    Title: Price Breaks
    The Price Breaks resource manages details about price breaks for a negotiation line to solicit pricing from suppliers according to location, volume, or date.
  • Title: Price Break Type
    Maximum Length: 80
    Type of price break. It specifies whether the application calculates the price break according to a single purchase order or across all purchase orders for the agreement. A list of accepted values is defined in the lookup type PON_PRICE_BREAK_TYPE.
  • Title: Price Break Type Code
    Maximum Length: 25
    Abbreviation that identifies the type of price break. It specifies whether the application calculates the price break according to a single purchase order or across all purchase orders for the agreement. Valid values are CUMULATIVE and NON-CUMULATIVE. A list of accepted values is defined in the lookup type PON_PRICE_BREAK_TYPE.
  • Price Tiers
    Title: Price Tiers
    The Price Tiers resource manages details about tiers according to quantity for a negotiation line to solicit tiered pricing from each supplier.
  • Title: Quantity
    Quantity of the item in the negotiation.
  • Title: Requested Delivery Date
    Date when the application requests to deliver the item that the negotiation line references.
  • Title: Requested Ship Date
    Date when the application requests to ship the item that the negotiation line references.
  • Title: Requisition
    Read Only: true
    Maximum Length: 64
    Requisition number that the negotiation line references.
  • Title: Requisitioning BU
    Maximum Length: 240
    Name of the requisition business unit that is a client of the procurement business unit.
  • Value that uniquely identifies the requisition business unit that is a client of the procurement business unit.
  • Title: Requisition Line
    Read Only: true
    Maximum Length: 255
    Requisition line number that the negotiation line references.
  • Title: Decrement
    Minimum amount or percentage of reduction of the line price in each revised response.
  • Title: Retainage Rate
    Percentage of the amount requested that will be withheld before releasing payments to the contractor.
  • Number that specifies the order in which lines are added to a negotiation using web service.
  • Title: Location
    Maximum Length: 60
    Name of the location where the application ships the negotiated item, or where the provider performs the negotiated service.
  • Title: Ship-to Location ID
    Value that uniquely identifies the location where the supplier ships the item.
  • Title: Source Agreement
    Read Only: true
    Maximum Length: 30
    Purchase agreement that the negotiators are renegotiating.
  • Title: Source Agreement Line
    Read Only: true
    Maximum Length: 20
    Agreement line that the negotiation line references.
  • Title: Start Price
    Highest price that the application allows the supplier to enter in response to a negotiation line.
  • Title: Suppliers can modify price breaks
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to modify price breaks that the procurement organization set up. If false, then do not allow. If the application does not enable price breaks, then the default value is empty. If the line resides in a group, then the value empty, else the default value is true.
  • Title: Target Price
    Price that the procurement organization prefers pay for the negotiation line.
  • Title: Line Target Price
    Price that the procurement organization prefers to pay for the negotiation line, not including cost factors.
  • Title: UOM
    Maximum Length: 25
    Name of the unit of measure for the item in the negotiation.
  • Title: UOM Code
    Maximum Length: 3
    Abbreviation that identifies the unit of measure for the item in the negotiation.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages details about attachments for a negotiation line.
Show Source
Nested Schema : External Cost Factors
Type: array
Title: External Cost Factors
The Cost Factors resource manages details about the cost factors for a negotiation line. For example, freight, setup charges, or switching costs.
Show Source
Nested Schema : Flexfields
Type: array
Title: Flexfields
The Flexfields resource contains details about negotiation lines.
Show Source
Nested Schema : Attribute Groups
Type: array
Title: Attribute Groups
The Attribute Groups resource manages details about groups of attributes on the supplier negotiation line.
Show Source
Nested Schema : Negotiation Line Recommended Suppliers
Type: array
Title: Negotiation Line Recommended Suppliers
The Negotiation Line Recommended Suppliers resource manages details about supplier recommendations for a negotiation line.
Show Source
Nested Schema : Price Breaks
Type: array
Title: Price Breaks
The Price Breaks resource manages details about price breaks for a negotiation line to solicit pricing from suppliers according to location, volume, or date.
Show Source
Nested Schema : Price Tiers
Type: array
Title: Price Tiers
The Price Tiers resource manages details about tiers according to quantity for a negotiation line to solicit tiered pricing from each supplier.
Show Source
Nested Schema : supplierNegotiations-lines-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-lines-costFactors-item-response
Type: object
Show Source
  • Read Only: true
    Value that uniquely identifies the negotiation.
  • Title: Cost Factor
    Maximum Length: 80
    Name of the cost factor.
  • Title: Cost Factor ID
    Value that identifies the cost factor.
  • Title: Description
    Read Only: true
    Maximum Length: 240
    Description of the cost factor.
  • Title: Display Target
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the value for the cost factor target. If false, then do not allow. The default value is false.
  • Read Only: true
    Number that identifies the negotiation line.
  • Read Only: true
    Value that uniquely identifies the sequence of the cost factor within a negotiation line.
  • Read Only: true
    Description of the negotiation line.
  • Title: Line ID
    Read Only: true
    Value that uniquely identifies the negotiation line.
  • Links
  • Title: Pricing Basis
    Maximum Length: 80
    Basis that the application uses to calculate the cost factor. A list of accepted values is defined in the lookup type PON_PRICING_BASIS.
  • Title: Pricing Basis Code
    Maximum Length: 30
    Abbreviation that identifies the basis that the application uses to calculate the cost factor. A list of accepted values is defined in the lookup type PON_PRICING_BASIS.
  • Title: Target Value
    Target value of the cost factor.
Nested Schema : supplierNegotiations-lines-DFF-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-lines-lineAttributeGroups-item-response
Type: object
Show Source
Nested Schema : Line Attributes
Type: array
Title: Line Attributes
The Line Attributes resource manages details about attributes on the supplier negotiation line.
Show Source
Nested Schema : supplierNegotiations-lines-lineAttributeGroups-lineAttributes-item-response
Type: object
Show Source
  • Response Values
    Title: Response Values
    The Response Values resource manages details about score values for an acceptable response when scoring a line attribute.
  • Read Only: true
    Value that identifies the attribute.
  • Title: Attribute
    Maximum Length: 4000
    Description of the attribute.
  • Read Only: true
    Value that uniquely identifies the negotiation.
  • Read Only: true
    Maximum Length: 64
    User who created the line attribute.
  • Read Only: true
    Date and time when the user created the line attribute.
  • Title: Display Target
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to view the value for the attribute target. If false, then do not allow. The default value is false.
  • Read Only: true
    Value that identifies the attribute group.
  • Read Only: true
    Name of the attribute group.
  • Read Only: true
    Date and time when the user most recently updated the line attribute.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the line attribute.
  • Read Only: true
    Number that identifies the negotiation line.
  • Read Only: true
    Description of the negotiation line.
  • Read Only: true
    Value that uniquely identifies the negotiation line.
  • Links
  • Title: Response
    Maximum Length: 80
    Specifies whether the response for the line attribute is required. Values include required, optional, or not needed. A list of accepted values is defined in the lookup type PON_ATTRIBUTE_RESPONSE_TYPE.
  • Title: Response Type Code
    Maximum Length: 30
    Abbreviation that identifies whether the response for the line attribute is required. Valid values are REQUIRED, OPTIONAL, and DISPLAY_ONLY. A list of accepted values is defined in the lookup type PON_ATTRIBUTE_RESPONSE_TYPE.
  • Title: Target Date Value
    Target value of the attribute. This value is applicable for dates.
  • Title: Target Number Value
    Target value for the attribute. This value is applicable for numbers.
  • Title: Target Text Value
    Maximum Length: 4000
    Target text or URL (Uniform Resource Locator) values of the attribute.
  • Title: Value Type
    Maximum Length: 80
    Display name of the data type for the attribute response. For example, text, number, date, or URL (Uniform Resource Locator). A list of accepted values is defined in the lookup type Attribute Value Type.
  • Title: Value Type Code
    Maximum Length: 3
    Abbreviation that identifies the type of value for the attribute response. Valid values are TXT, NUM, DAT, and URL. A list of accepted values is defined in the lookup type PON_AUCTION_ATTRIBUTE_TYPE.
  • Title: Weight
    Importance of the line attribute when compared to other line attributes. The application uses this weight when it calculates the line score.
Nested Schema : Response Values
Type: array
Title: Response Values
The Response Values resource manages details about score values for an acceptable response when scoring a line attribute.
Show Source
Nested Schema : supplierNegotiations-lines-lineAttributeGroups-lineAttributes-acceptableResponseScoreValues-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-lines-negotiationLineRecommendedSuppliers-item-response
Type: object
Show Source
  • Score assigned to a recommended supplier by the artificial-intelligence model. A supplier with close matching transactions, and frequent purchasing and sourcing transactions is assigned a higher score.
  • Value that uniquely identifies the negotiation.
  • Number that identifies the negotiation line.
  • Value that uniquely identifies the recommended supplier for a negotiation line.
  • Links
  • Value that identifies the supplier company that the application invited to respond to the negotiation.
  • Title: Name
    Read Only: true
    Maximum Length: 360
    Name of the supplier company that the application invited to respond to the negotiation.
  • Indicates the total count of transactions for a scenario that match with a new negotiation line for a supplier. For example, supplier scenario 1 captures the number of matching purchase order lines.
  • Indicates the total count of transactions for a scenario that match with a new negotiation line for a supplier. For example, supplier scenario 2 captures the number of matching purchase agreement lines.
  • Indicates the total count of transactions for a scenario that match with a new negotiation line for a supplier. For example, supplier scenario 3 captures the number of matching negotiation award lines.
  • Indicates the total count of transactions for a scenario that match with a new negotiation line for a supplier. For example, supplier scenario 4 captures the number of matching supplier response lines.
  • Indicates the total count of transactions for a scenario that match with a new negotiation line for a supplier. For example, supplier scenario 5 captures the number of matching negotiation invitation lines.
  • Value that identifies the supplier site.
  • Title: Site
    Read Only: true
    Maximum Length: 240
    Name of the supplier site.
Nested Schema : supplierNegotiations-lines-priceBreaks-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-lines-priceTiers-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-negotiationActivities-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-negotiationRecommendedSuppliers-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-responseCurrencies-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-scoringTeams-item-response
Type: object
Show Source
Nested Schema : Scoring Team Members
Type: array
Title: Scoring Team Members
The Scoring Team Members resource manages details about the members in each scoring team.
Show Source
Nested Schema : supplierNegotiations-scoringTeams-scoringTeamMembers-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-sections-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 64
    User who created the section.
  • Read Only: true
    Date and time when the user created the section.
  • Title: Evaluation Stage
    Maximum Length: 80
    Name of the evaluation stage in a two stage RFQ (request for quotation). Values include Technical or Commercial. A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
  • Title: Evaluation Stage Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the name of the evaluation stage in a two stage RFQ (request for quotation). A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
  • Read Only: true
    Date and time when the user most recently updated the section.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the section.
  • Links
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the pricing section is added. If false, then the pricing section is not added. This is applicable only when if the Overall Ranking Method is Composite Scoring. The default value is false.
  • Requirements
    Title: Requirements
    The Requirements resource manages details about the requirements of a supplier negotiation.
  • Title: Scoring Team
    Maximum Length: 80
    Name of the scoring team.
  • Title: Scoring Team ID
    Value that uniquely identifies a scoring team.
  • Title: Section
    Maximum Length: 240
    Name of the requirement section.
  • Read Only: true
    Maximum Length: 80
    Display number of the section. If the negotiation contains more than one section, then the application uses a display sequence to identify each section, such as 10, 20, 30, and so on.
  • Read Only: true
    Value that uniquely identifies the section.
  • Importance of the section when compared to other sections. The application uses this weight when it calculates the over all score of requirement score.
Nested Schema : Requirements
Type: array
Title: Requirements
The Requirements resource manages details about the requirements of a supplier negotiation.
Show Source
Nested Schema : supplierNegotiations-sections-requirements-item-response
Type: object
Show Source
  • Acceptable Response Values
    Title: Acceptable Response Values
    The Acceptable Response Values resource manages details about the scoring criteria of each negotiation requirement.
  • Title: Allow comments from suppliers
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the supplier to provide comments to each requirement. If false, then do not allow. The default value is false.
  • Attachments
    Title: Attachments
    The Attachments resource manages details about attachments for a requirement.
  • Title: Attachments from Suppliers
    Maximum Length: 80
    Requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.
  • Title: Attachments from Suppliers Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.
  • Read Only: true
    Maximum Length: 64
    User who created the requirement.
  • Read Only: true
    Date and time when the user created the requirement.
  • Title: Display target
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then display the target value to the supplier. If false, then do not display. The default value is false.
  • Title: Hint
    Maximum Length: 1000
    Text that the application displays to the supplier to help respond to the requirements.
  • Title: Knockout Score
    Lowest requirement score that the response can receive and remain part of the shortlist.
  • Read Only: true
    Date and time when the user most recently updated the requirement.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the requirement.
  • Title: Level
    Maximum Length: 80
    Supplier level for the requirement. Values include Supplier or Supplier site. A list of accepted values is defined in the lookup type PON_SUPPLIER_LEVEL.
  • Title: Level Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the supplier level for the requirement. Values include Supplier or Supplier site. A list of accepted values is defined in the lookup type PON_SUPPLIER_LEVEL.
  • Links
  • Title: Maximum Score
    Highest possible score for the requirement response.
  • Read Only: true
    Maximum Length: 10
    Type of requirement. If the requirement is the parent of any other requirement, then ParentType contains SECTION. If not, then ParentType contains SCORE.
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the response amount requirement is added to the pricing section. If false, then no requirement is added. This is applicable only when if the Overall Ranking Method is Composite Scoring. The default value is false.
  • Read Only: true
    Value that uniquely identifies the requirement for a question.
  • Title: Revision
    Read Only: true
    Revision number of a predefined question that the application adds to the supplier qualification.
  • Title: Requirement
    Maximum Length: 80
    Name of the requirement.
  • Read Only: true
    Value that uniquely identifies the requirement.
  • Read Only: true
    Level of the requirement. For example, 1, 2, 3, and so on.
  • Read Only: true
    Maximum Length: 80
    Value that uniquely identifies the sequence for the requirement.
  • Title: Requirement Text
    Text that describes the requirement.
  • Title: Requirement Type
    Maximum Length: 80
    Type of response that the negotiation requires. Values include Text Entry Box, Multiple Choice with Multiple Selections, or Multiple Choice with Single Selection. A list of accepted values is defined in the lookup type PON_REQUIREMENT_TYPE.
  • Title: Requirement Type Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the type of response that the negotiation requires. Values include Text Entry Box, Multiple Choice with Multiple Selections, or Multiple Choice with Single Selection. A list of accepted values is defined in the lookup type PON_REQUIREMENT_TYPE.
  • Title: Response Type
    Maximum Length: 80
    Specifies whether the response for the requirement is required. Values include Required, Optional, Display Only, or Internal. A list of accepted values is defined in the lookup type PON_HDR_ATTR_RESPONSE_TYPE.
  • Title: Response Type Code
    Maximum Length: 30
    Abbreviation that specifies whether the response for the requirement is required. Values include Required, Optional, Display Only, or Internal. A list of accepted values is defined in the lookup type PON_HDR_ATTR_RESPONSE_TYPE.
  • Read Only: true
    Value that uniquely identifies the score.
  • Title: Scoring
    Maximum Length: 80
    Method that the application uses to score each requirement response. Values include Automatic, Manual, or None. A list of accepted values is defined in the lookup type PON_SCORING_TYPE.
  • Title: Scoring Method Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the method that the application uses to score each requirement response. Values include Automatic, Manual, or None. A list of accepted values is defined in the lookup type PON_SCORING_TYPE.
  • Title: Section
    Read Only: true
    Name of the requirement section.
  • Read Only: true
    Value that uniquely identifies the section.
  • Title: Target Date Time Value
    Value that the user entered. This value is applicable for date and time.
  • Title: Target Date Value
    Value that the user entered in the attribute. This value is applicable for dates.
  • Title: Target Number Value
    Value that the user entered in the attribute. This value is applicable for numbers.
  • Title: Target Text Value
    Maximum Length: 4000
    Target text or URL (Uniform Resource Locator) values of the requirement.
  • Title: Value Type
    Maximum Length: 80
    Type of value for the requirement. Values include Single Line Text, Multiple Line Text, Number, Date, Date and Time, or URL (Uniform Resource Locator). A list of accepted values is defined in the lookup type PON_REQ_RESPONSE_TYPE.
  • Title: Value Type Code
    Maximum Length: 30
    Abbreviation that identifies the type of value for the requirement. A list of accepted values is defined in the lookup type PON_REQ_RESPONSE_TYPE.
  • Title: Weight
    Importance of the requirement when compared to other requirements. The application uses this weight when it calculates the requirement score.
Nested Schema : Acceptable Response Values
Type: array
Title: Acceptable Response Values
The Acceptable Response Values resource manages details about the scoring criteria of each negotiation requirement.
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages details about attachments for a requirement.
Show Source
Nested Schema : supplierNegotiations-sections-requirements-acceptableResponseScoreValues-item-response
Type: object
Show Source
  • Title: Attachments from Suppliers
    Maximum Length: 80
    Requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.
  • Title: Attachments from Suppliers Code
    Maximum Length: 30
    Abbreviation that uniquely identifies the requirement for each supplier attachment. Values include Not Allowed, Optional, or Required. A list of accepted values is defined in the lookup type PON_REQ_ALLOW_ATTACHMENT.
  • Read Only: true
    Maximum Length: 64
    User who created the acceptable response score value.
  • Read Only: true
    Date and time when the user created the acceptable response score value.
  • Title: Date from Range
    Start date in the range of values. Applies for date attributes.
  • Title: Date Time from Range
    Start date and time in the range of values. Applies for date and time attributes.
  • Title: Date Time to Range
    End date and time in the range of values. Applies for date and time attributes.
  • Title: Date to Range
    End Date in the range of values. Applies for date attributes.
  • Read Only: true
    Date and time when the user most recently updated the acceptable response score value.
  • Read Only: true
    Maximum Length: 64
    User who most recently updated the acceptable response score value.
  • Links
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then allow the application to assign a score to each supplier who does not respond to an optional requirement. If false, then do not allow. The default value is false.
  • Title: Number from Range
    Lowest number in a range of values. Applies for number attributes.
  • Title: Number to Range
    Highest number in a range of values. Applies for number attributes.
  • Read Only: true
    Value that uniquely identifies the requirement.
  • Title: Score
    Score that the application assigns to each attribute response.
  • Read Only: true
    Maximum Length: 80
    Value that uniquely identifies the score display. The application sets this value for each requirement that uses Multiple Choice With Single Selection or Multiple Choice With Multiple Selections. It also sets this value for each response that replies to a number, date, or date time requirement.
  • Read Only: true
    Value that uniquely identifies the score.
  • Title: Section
    Read Only: true
    Name of the requirement section.
  • Read Only: true
    Value that uniquely identifies the section.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then set the value that the application is willing to accept as the target response value for the requirement. If false, then do not set. The default value is false.
  • Title: Text Response Value
    Maximum Length: 1000
    Value that the user entered. This value is applicable for text values.
Nested Schema : supplierNegotiations-sections-requirements-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-supplierDFF-item-response
Type: object
Show Source
Nested Schema : supplierNegotiations-suppliers-item-response
Type: object
Show Source
Nested Schema : Access Restrictions
Type: array
Title: Access Restrictions
The Access Restrictions resource manages details about negotiation lines where supplier access is restricted.
Show Source
Nested Schema : supplierNegotiations-suppliers-supplierLineAccessRestrictions-item-response
Type: object
Show Source
Back to Top

Examples

This example describes how to get one negotiation.

Example cURL Command

Use the following cURL command to submit a request on the REST resource:

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

For example, the following command gets one negotiation where the auction header identifier is 300100152357495:

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

Example Response Body

The following shows an example of the response body in JSON format.

{
    "AuctionHeaderId": 300100152357495,
    "AgreementAmount": 50000000,
    "AgreementEndDate": "2018-08-24",
    "AgreementStartDate": "2018-07-13",
    "AllowAlternateLinesFlag": true,
    "AllowMultipleResponsesDisplayFlag": true,
    "AllowMultipleResponsesFlag": true,
    "AllowOtherResponseCurrencyFlag": true,
    "AllowResponseRevisionFlag": true,
    "AllowResponseRevisionDisplayFlag": true,
    "ApprovalAmount": null,
    "AutoExtendAllLinesFlag": null,
    "AutoExtendDuration": null,
    "AutoExtendFlag": false,
    "AutoExtendFromCloseDateFlag": null,
    "AutoExtendMinimumTriggerRank": null,
    "AutoExtensionsNumber": null,
    "AutoExtendTriggerPeriod": null,
    "AwardByDate": "2018-10-26T11:21:00+00:00",
    "BuyerManagedTransportationFlag": true,
    "CarrierId": 12519,
    "CloseDate": "2018-09-01T10:46:00+00:00",
    "ConversionRateTypeCode": "Corporate",
    "CurrencyCode": "USD",
    "DaysAfterOpenDate": null,
    "DefaultMaximumRequirementScore": 5,
    "DisplayBestPriceBlindFlag": true,
    "DisplayRatesToSuppliersFlag": true,
    "DisplayRequirementScoresFlag": true,
    "DisplayScoresToSuppliersFlag": true,
    "NegotiationTypeId": 5,
    "EnableRequirementWeightsFlag": true,
    "FOBCode": "Origin",
    "FirstLineCloseDate": null,
    "FreightTermsCode": "Due",
    "MinimumReleaseAmount": 300000,
    "ModeOfTransportCode": null,
    "NegotiationTitle": "Get laptops",
    "PricePrecision": 2,
    "OpenDate": null,
    "OpenImmediatelyFlag": true,
    "PaymentTermsId": 10003,
    "BuyerId": 100010026863783,
    "PreviewDate": null,
    "PreviewImmediatelyFlag": true,
    "PriceTiersCode": "PRICE_BREAKS",
    "ProcurementBUId": 204,
    "RankIndicatorCode": "NUMBERING",
    "RankingMethodCode": "MULTI_ATTRIBUTE_SCORING",
    "ConversionRateDate": "2018-06-29",
    "RequireFullQuantityDisplayFlag": false,
    "RequireFullQuantityFlag": false,
    "RequisitioningBUId": null,
    "RespondOnAllLinesFlag": true,
    "RespondOnAllLinesDisplayFlag": true,
    "ResponseVisibilityCode": "SEALED_BIDDING",
    "RestrictToInvitedSuppliersFlag": false,
    "RestrictToInvitedSuppliersDisplayFlag": true,
    "StaggeredClosingFlag": false,
    "StaggeredClosingInterval": null,
    "NegotiationStyleId": 300100129355264,
    "TwoStageEvaluationFlag": false,
    "AmendmentDescription": null,
    "Carrier": "Airborne",
    "Currency": "US Dollar",
    "PaymentTerms": "45 Net (terms date + 45)",
    "Buyer": "Clare Smith",
    "ProcurementBU": "Vision Corporation",
    "RequisitioningBU": null,
    "NegotiationStyle": "A1_REST_Style",
    "ConversionRateType": "Corporate",
    "FOB": "Origin",
    "FreightTerms": "Due",
    "Outcome": "Blanket Purchase Agreement",
    "NegotiationType": "RFQ",
    "ModeOfTransport": null,
    "Synopsis": "Procure Laptops for Big Computers",
    "PriceTiers": "Price breaks",
    "RankingMethod": "Multiattribute scoring",
    "ResponseVisibility": "Blind",
    "CoverPageText": "This negotiation is being created with the intent to procure some laptops for official use.",
    "GeneralIntroductionText": "Our firm, Big Computers, needs around 50 laptops for our newly joined employees.",
    "LinesInstructionText": null,
    "TermsInstructionText": "Terms and Conditions:We do not have any major terms apart from the mandatory Quality checks. We expect the delivery to be prompt and the products to be well-functioning.",
    "RequirementInstructionText": null,
    "RankIndicator": "1,2,3...",
    "Negotiation": "39226",
    "NegotiationLayoutName": "Negotiation Layout",
    "ResponseLayoutName": "Response Layout",
    "NoteToNegotiationApprovers": null,
    "ResponseRevisionDecrementValue": null,
    "ServiceLevelCode": null,
    "ViewNotesAndAttachmentsFlag": false,
    "ViewNotesAndAttachmentsDisplayFlag": false,
    "NegotiationStatus": "Draft",
    "ResponseRevisionDecrementTypeCode": null,
    "RevisedResponseLinePriceRuleCode": null,
    "RevisedResponseLinePriceRule": null,
    "ResponseRevisionDecrementType": null,
    "ServiceLevel": null,
    "PODoctypeCode": "BLANKET",
    "POStyleId": 1,
    "POStyle": "Standard Style",
    "ContractSource": "Terms Template",
    "PODoctype": "Blanket purchase agreement",
    "ContractTermsLayout": "ContractTermsProcurement",
    "ContractTermsTemplate": "ZSPM_TempDel1_ONE",
    "ContractTermsTemplateId": 300100003406406,
    "EnableTeamScoringFlag": true,
    "SourceAgreement": null,
    "EnforcePreviousRoundPriceAsStartPriceFlag": false,
    "TechnicalStageUnlockedDate": null,
    "TechnicalStageUnsealedDate": null,
    "CommercialStageUnlockedDate": null,
    "CommercialStageUnsealedDate": null,
    "TechnicalStageUnlockedBy": null,
    "TechnicalStageUnsealedBy": null,
    "CommercialStageUnlockedBy": null,
    "CommercialStageUnsealedBy": null,
    "CreatedBy": "CVBUYER01",
    "CreationDate": "2018-06-28T10:46:13+00:00",
    "LastUpdateDate": "2018-06-28T11:45:41.477+00:00",
    "LastUpdatedBy": "CVBUYER01",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495",
            "name": "supplierNegotiations",
            "kind": "item",
            "properties": {
                "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000002C78"
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495",
            "name": "supplierNegotiations",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/sections",
            "name": "sections",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/abstracts",
            "name": "abstracts",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/DFF",
            "name": "DFF",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/responseCurrencies",
            "name": "responseCurrencies",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/lines",
            "name": "lines",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/attachments",
            "name": "attachments",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/scoringTeams",
            "name": "scoringTeams",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/suppliers",
            "name": "suppliers",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/supplierDFF",
            "name": "supplierDFF",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiations/300100152357495/child/collaborationTeamMembers",
            "name": "collaborationTeamMembers",
            "kind": "collection"
        }
    ]
}
Back to Top