1. REST API for Oracle Fusion Cloud Procurement
  2. Tasks
  3. Supplier Negotiation Responses

Get all negotiation responses

get

/fscmRestApi/resources/11.13.18.05/supplierNegotiationResponses

Request

Query Parameters
  • This query parameter is used to fetch resources which are effective dated as of the specified start date. The value of this query parameter is a string having a date in yyyy-MM-dd format
  • 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
  • Used as a predefined finder to search the collection.

    Format ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables

    • PrimaryKey Finds the negotiation response according to the primary key.
      Finder Variables
      • ResponseNumber; integer; Value that uniquely identifies the negotiation response in a line.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • 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
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AuctionHeaderId; integer; A unique ID assigned to each negotiation.
    • AwardCompleteDate; string; Date when the negotiation award process is complete.
    • AwardStatus; string; Value that identifies whether the response was awarded or rejected.
    • Buyer; string; Name of the user who created the negotiation.
    • CloseDate; string; Date when the negotiation stops accepting responses from the supplier.
    • CompositeScore; string; Sum of the weighted requirement score, and the relative pricing score that's calculated based on the total response amount provided by the supplier. The higher the composite score, the better the overall rank.
    • CreatedBy; string; Identifies the user who created the row.
    • CreationDate; string; Timestamp of the creation of the row.
    • CurrencyConversionRate; number; Rate at which the price or amount is converted from the response currency to the negotiation currency. The conversion rate is effective from the date set in the negotiation terms and is either user-defined or derived per the conversion type.
    • CurrentEvaluationStage; string; Name of the evaluation stage in a two stage RFQ. Values include Technical or Commercial. A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
    • DisqualificationReason; string; Reason the buyer disqualified the supplier's response.
    • EvaluationStage; string; Stores two values: Technical and Commercial, required to mark the surrogate response in a two-stage negotiation.
    • LinesTrailing; string; Number of lines in which the supplier hasn't bid the lowest price in a response.
    • LinesWinning; string; Number of lines in which the supplier has bid the lowest price in a response.
    • LowestResponseAmount; string; Lowest response amount bid by any supplier in a negotiation.
    • MethodOfResponse; string; Title for the method of response LOV. Valid values are E-Mail, Fax, Print, and Other. A list of accepted values is defined in the lookup type PON_METHOD_OF_RESPONSE.
    • MethodOfResponseCode; string; Abbreviation that identifies the method of response used by the supplier to communicate the response to the buyer.
    • Negotiation; string; Number that uniquely identifies the negotiation.
    • NegotiationCurrency; string; Name of the negotiation currency.
    • NegotiationCurrencyCode; string; Abbreviation that identifies the currency that the negotiation uses.
    • NegotiationTitle; string; Title of the negotiation as defined by the category manager.
    • NoteToBuyer; string; Note to negotiation owner.
    • OriginalResponseNumber; integer; Value that identifies the first response number in a series of revised bids.
    • OverallRank; string; Rank of the supplier responses based on the lowest total amount. The lower the transformed amount, then the higher the overall rank.
    • OverallRankComposite; string; Rank calculated based on the composite score of a supplier. The higher the composite score, then the higher the overall rank.
    • OverriddenScore; number; New score for a given quote or score that replaces the system-computed average score.
    • PartialResponseFlag; boolean; Contains one of the following values: true or false. If true, then the supplier has submitted a partial response. A partial response means the supplier hasn't bid on all lines or is offering a lesser quantity than asked for in the negotiation line.
    • PrebidFlag; boolean; Contains one of the following values: true or false. If true, then prebidding is enabled, allowing suppliers to preview and submit bids before negotiation opens. If false, then the prebid isn't allowed.
    • PreviousResponseNumber; integer; Value that identifies the previous response number from where the values of the response are defaulted.
    • PriceDecrement; number; Minimum bid price reduction required in a revised bid.
    • ProxyBidFlag; boolean; Contains one of the following values: true or false. If true, then the proxy bid is allowed. If false, then the proxy bid isn't allowed. The default value is false.
    • PurchasingDocument; string; Value that identifies the agreements or purchase orders that were created as an outcome of the negotiation process.
    • ReferenceNumber; string; Identification number used for the supplier's internal tracking.
    • RequirementScore; number; Value calculated by summing the scores associated with a supplier's responses to requirements specified in the negotiation.
    • ResponseAmount; string; Total amount calculated for all line items that the supplier offered a price for when responding to a negotiation.
    • ResponseCurrency; string; Abbreviation that identifies the currency that the response uses.
    • ResponseCurrencyCode; string; Abbreviation that identifies the currency that the response uses.
    • ResponseCurrencyPricePrecision; number; Value that specifies the precision in number of digits after the decimal for the response currency.
    • ResponseNumber; integer; Value that uniquely identifies the response.
    • ResponseStatus; string; Status of the response.
    • ResponseStatusCode; string; Abbreviation that identifies the status of the response.
    • ResponseType; string; Specifies the type of the response as primary or alternate. The list of values is listed in the lookup table TYPE_OF_RESPONSE.
    • ResponseTypeCode; string; Abbreviation that identifies the type of response as primary or alternate. The list of values is listed in the lookup table TYPE_OF_RESPONSE.
    • ResponseValidUntilDate; string; Date on which the response expires.
    • SavingsInAmount; number; Value that identifies the amount of savings generated by awarding the lines to one or more supplier responses.
    • SavingsInPercent; string; Value that identifies the savings percentage that's generated from the awarded supplier responses to the negotiation.
    • ScoreOverriddenBy; string; User who last overrode the score for a given quote or bid.
    • ScoreOverriddenDate; string; Date when the score was last overridden for a given quote or bid.
    • ScoreOverriddenFlag; boolean; Contains one of the following values: true or false. If true, then the buyer has overridden the score. If false, then the score isn't overridden.
    • ScoreOverridePersonId; integer; Value that identifies the user who's able to override the score for a given quote or bid.
    • ScoreOverrideReason; string; Reason why the initial scores were overridden.
    • ScoringStatus; string; Value that indicates whether scoring for a given negotiation response has started. Acceptable values are as follows: not started, in progress, or completed.
    • ShortlistFlag; boolean; Value that indicates whether the corresponding bid has been shortlisted.
    • ShortlistStatus; string; Status that indicates if the supplier was included or excluded from the shortlist.
    • ShortlistStatusUpdatedBy; string; User who updated the short list status.
    • ShortlistStatusUpdatedById; integer; Value that indicates the user who updated the short list status.
    • Supplier; string; Name of the supplier who responds to the negotiation.
    • SupplierContact; string; Name of the supplier contact at the supplier that responds to the negotiation.
    • SupplierContactId; integer; Value that identifies the contact of the supplier who responds to the negotiation.
    • SupplierId; integer; Value that identifies the supplier who responds to the negotiation.
    • SupplierSite; string; Name of the supplier site.
    • SupplierSiteId; integer; Value that identifies the supplier site.
    • SurrogateResponseCreationDate; string; Timestamp when the buyer entered the response on behalf of the supplier.
    • SurrogateResponseEnteredBy; string; Name of the buyer who entered the surrogate response.
    • SurrogateResponseEnteredById; integer; Value that uniquely identifies the buyer user who created the surrogate response.
    • SurrogateResponseFlag; boolean; Contains one of the following values: true or false. If true, then the buyer enters a response on behalf of the supplier. If false, then the response is entered by the supplier.
    • SurrogateResponseReceivedOn; string; Timestamp when the buyer received the surrogate response through other response methods such as fax or email.
    • TechnicalShortlistFlag; boolean; Indicates whether the corresponding bid has been shortlisted or not during the technical evaluation.
    • TimeZone; string; Indicates the time zone used by default for a company or customer.
    • TotalAgreementAmount; integer; The total amount of all lines in the purchase agreement.
    • TotalAwardAmount; integer; The total amount awarded to the supplier response.
    • TwoStageEvaluationFlag; boolean; Contains one of the following values: true or false. If true, then the application is enabled for a two-stage evaluation for the negotiation. If false, then it's not enabled. The default value is false.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
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 : supplierNegotiationResponses
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : supplierNegotiationResponses-item-response
Type: object
Show Source
  • Supplier Negotiation Response Lines
    Title: Supplier Negotiation Response Lines
    Response lines in a supplier negotiation response. These are the lines that the supplier has access to and has the shared response price for each of them. The lines capture details such as response price, response quantity, or total amount. You must have the necessary roles and privileges to use this REST resource. For additional details, refer to the Job Roles and Privileges, and Status Codes topics.
  • Attachments
    Title: Attachments
    The Attachments resource manages response attachments in the supplier negotiation response.
  • Title: Auction Header ID
    Read Only: true
    A unique ID assigned to each negotiation.
  • Title: Award Complete Date
    Read Only: true
    Date when the negotiation award process is complete.
  • Title: Award Status
    Read Only: true
    Maximum Length: 25
    Value that identifies whether the response was awarded or rejected.
  • Title: Buyer
    Read Only: true
    Maximum Length: 240
    Name of the user who created the negotiation.
  • Title: Close Date
    Read Only: true
    Date when the negotiation stops accepting responses from the supplier.
  • Title: Composite Score
    Read Only: true
    Maximum Length: 255
    Sum of the weighted requirement score, and the relative pricing score that's calculated based on the total response amount provided by the supplier. The higher the composite score, the better the overall rank.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Title: Creation Date
    Read Only: true
    Timestamp of the creation of the row.
  • Title: Currency Conversion Rate
    Rate at which the price or amount is converted from the response currency to the negotiation currency. The conversion rate is effective from the date set in the negotiation terms and is either user-defined or derived per the conversion type.
  • Read Only: true
    Maximum Length: 255
    Name of the evaluation stage in a two stage RFQ. Values include Technical or Commercial. A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
  • Title: Disqualification Reason
    Maximum Length: 240
    Reason the buyer disqualified the supplier's response.
  • Title: Evaluation Stage
    Read Only: true
    Maximum Length: 20
    Stores two values: Technical and Commercial, required to mark the surrogate response in a two-stage negotiation.
  • Lines
    Title: Lines
    The Response Lines resource allows suppliers to view the response line price value. The line price along with quantity or estimated quantity and external cost factors, if applicable, are used to calculate the line response price, line response amount, and the response amount.
  • Title: Trailing Lines
    Read Only: true
    Maximum Length: 255
    Number of lines in which the supplier hasn't bid the lowest price in a response.
  • Title: Winning Lines
    Read Only: true
    Maximum Length: 255
    Number of lines in which the supplier has bid the lowest price in a response.
  • Links
  • Title: Lowest Response Amount
    Read Only: true
    Maximum Length: 255
    Lowest response amount bid by any supplier in a negotiation.
  • Title: Method of Response
    Maximum Length: 80
    Title for the method of response LOV. Valid values are E-Mail, Fax, Print, and Other. A list of accepted values is defined in the lookup type PON_METHOD_OF_RESPONSE.
  • Title: Method of Response Code
    Maximum Length: 30
    Abbreviation that identifies the method of response used by the supplier to communicate the response to the buyer.
  • Title: Negotiation
    Read Only: true
    Maximum Length: 240
    Number that uniquely identifies the negotiation.
  • Title: Negotiation Currency
    Read Only: true
    Maximum Length: 80
    Name of the negotiation currency.
  • Title: Negotiation Currency Code
    Read Only: true
    Maximum Length: 15
    Abbreviation that identifies the currency that the negotiation uses.
  • Title: Title
    Read Only: true
    Maximum Length: 80
    Title of the negotiation as defined by the category manager.
  • Title: Note to Buyer
    Maximum Length: 4000
    Note to negotiation owner.
  • Title: Original Response Number
    Value that identifies the first response number in a series of revised bids.
  • Title: Overall Rank
    Read Only: true
    Maximum Length: 255
    Rank of the supplier responses based on the lowest total amount. The lower the transformed amount, then the higher the overall rank.
  • Title: Overall Rank Composite
    Read Only: true
    Maximum Length: 255
    Rank calculated based on the composite score of a supplier. The higher the composite score, then the higher the overall rank.
  • Title: Overridden Score
    New score for a given quote or score that replaces the system-computed average score.
  • Title: Partial Response
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the supplier has submitted a partial response. A partial response means the supplier hasn't bid on all lines or is offering a lesser quantity than asked for in the negotiation line.
  • Title: Prebid
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then prebidding is enabled, allowing suppliers to preview and submit bids before negotiation opens. If false, then the prebid isn't allowed.
  • Title: Previous Response Number
    Value that identifies the previous response number from where the values of the response are defaulted.
  • Title: Proxy Decrement
    Read Only: true
    Minimum bid price reduction required in a revised bid.
  • Title: Proxy Bid
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the proxy bid is allowed. If false, then the proxy bid isn't allowed. The default value is false.
  • Title: Purchasing Document
    Read Only: true
    Maximum Length: 255
    Value that identifies the agreements or purchase orders that were created as an outcome of the negotiation process.
  • Title: Reference Number
    Maximum Length: 25
    Identification number used for the supplier's internal tracking.
  • Title: Score
    Read Only: true
    Value calculated by summing the scores associated with a supplier's responses to requirements specified in the negotiation.
  • Title: Response Amount
    Read Only: true
    Maximum Length: 255
    Total amount calculated for all line items that the supplier offered a price for when responding to a negotiation.
  • Title: Response Currency
    Read Only: true
    Maximum Length: 80
    Abbreviation that identifies the currency that the response uses.
  • Title: Response Currency Code
    Maximum Length: 15
    Abbreviation that identifies the currency that the response uses.
  • Title: Price Precision
    Value that specifies the precision in number of digits after the decimal for the response currency.
  • Title: Time of Response
    Read Only: true
    Date on which the response was published.
  • Response Lines Rank Summaries
    Title: Response Lines Rank Summaries
    A summary of the line level ranks in a negotiation response.
  • Title: Response Number
    Value that uniquely identifies the response.
  • Response Line Prices
    Title: Response Line Prices
    The prices against best price for each line item in a negotiation response.
  • Title: Response Status
    Read Only: true
    Maximum Length: 255
    Status of the response.
  • Read Only: true
    Maximum Length: 25
    Abbreviation that identifies the status of the response.
  • Title: Response Type
    Read Only: true
    Maximum Length: 80
    Specifies the type of the response as primary or alternate. The list of values is listed in the lookup table TYPE_OF_RESPONSE.
  • Title: Response Type Code
    Maximum Length: 25
    Abbreviation that identifies the type of response as primary or alternate. The list of values is listed in the lookup table TYPE_OF_RESPONSE.
  • Title: Response Valid Until
    Date on which the response expires.
  • Title: Savings
    Read Only: true
    Value that identifies the amount of savings generated by awarding the lines to one or more supplier responses.
  • Title: Savings Percent
    Read Only: true
    Maximum Length: 255
    Value that identifies the savings percentage that's generated from the awarded supplier responses to the negotiation.
  • Title: Score Overridden By
    Read Only: true
    Maximum Length: 240
    User who last overrode the score for a given quote or bid.
  • Title: Score Overridden Date
    Date when the score was last overridden for a given quote or bid.
  • Title: Score Overridden
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the buyer has overridden the score. If false, then the score isn't overridden.
  • Title: Score Override Person ID
    Value that identifies the user who's able to override the score for a given quote or bid.
  • Title: Override Reason
    Maximum Length: 4000
    Reason why the initial scores were overridden.
  • Title: Scoring Status
    Read Only: true
    Maximum Length: 80
    Value that indicates whether scoring for a given negotiation response has started. Acceptable values are as follows: not started, in progress, or completed.
  • Sections
    Title: Sections
    The Sections resource contains details of the sections of a supplier negotiation requirement. For example, commercial requirements, manufacturing capabilities, or technical requirements.
  • Title: Shortlist
    Maximum Length: 1
    Value that indicates whether the corresponding bid has been shortlisted.
  • Title: Shortlist Status
    Read Only: true
    Maximum Length: 255
    Status that indicates if the supplier was included or excluded from the shortlist.
  • Title: Shortlist Status Updated By
    Read Only: true
    Maximum Length: 240
    User who updated the short list status.
  • Read Only: true
    Maximum Length: 255
    Display name of the user who updated the shortlist status.
  • Title: Shortlist Status Updated By ID
    Read Only: true
    Value that indicates the user who updated the short list status.
  • Title: Supplier
    Read Only: true
    Maximum Length: 360
    Name of the supplier who responds to the negotiation.
  • Title: Supplier Contact
    Read Only: true
    Maximum Length: 360
    Name of the supplier contact at the supplier that responds to the negotiation.
  • Title: Supplier Contact
    Read Only: true
    Maximum Length: 255
    Display name of the supplier contact at the supplier site who responds to the negotiation.
  • Title: Supplier Contact ID
    Value that identifies the contact of the supplier who responds to the negotiation.
  • Title: Supplier ID
    Value that identifies the supplier who responds to the negotiation.
  • Title: Supplier Site
    Read Only: true
    Maximum Length: 240
    Name of the supplier site.
  • Title: Supplier Site ID
    Value that identifies the supplier site.
  • Title: Surrogate Response Creation Date
    Timestamp when the buyer entered the response on behalf of the supplier.
  • Title: Surrogate Response Entered By
    Read Only: true
    Maximum Length: 240
    Name of the buyer who entered the surrogate response.
  • Title: Name
    Read Only: true
    Maximum Length: 240
    Display name of the buyer who entered the surrogate response.
  • Title: Surrogate Response Entered by ID
    Read Only: true
    Value that uniquely identifies the buyer user who created the surrogate response.
  • Title: Surrogate Response
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the buyer enters a response on behalf of the supplier. If false, then the response is entered by the supplier.
  • Title: Surrogate Response Received On
    Timestamp when the buyer received the surrogate response through other response methods such as fax or email.
  • Title: Technical Shortlist
    Maximum Length: 1
    Indicates whether the corresponding bid has been shortlisted or not during the technical evaluation.
  • Read Only: true
    Maximum Length: 255
    Indicates the time zone used by default for a company or customer.
  • Title: Total Agreement Amount
    Read Only: true
    The total amount of all lines in the purchase agreement.
  • Title: Total Award Amount
    Read Only: true
    The total amount awarded to the supplier response.
  • Title: Two stage evaluation
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the application is enabled for a two-stage evaluation for the negotiation. If false, then it's not enabled. The default value is false.
Nested Schema : Supplier Negotiation Response Lines
Type: array
Title: Supplier Negotiation Response Lines
Response lines in a supplier negotiation response. These are the lines that the supplier has access to and has the shared response price for each of them. The lines capture details such as response price, response quantity, or total amount. You must have the necessary roles and privileges to use this REST resource. For additional details, refer to the Job Roles and Privileges, and Status Codes topics.
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages response attachments in the supplier negotiation response.
Show Source
Nested Schema : Lines
Type: array
Title: Lines
The Response Lines resource allows suppliers to view the response line price value. The line price along with quantity or estimated quantity and external cost factors, if applicable, are used to calculate the line response price, line response amount, and the response amount.
Show Source
Nested Schema : Response Lines Rank Summaries
Type: array
Title: Response Lines Rank Summaries
A summary of the line level ranks in a negotiation response.
Show Source
Nested Schema : Response Line Prices
Type: array
Title: Response Line Prices
The prices against best price for each line item in a negotiation response.
Show Source
Nested Schema : Sections
Type: array
Title: Sections
The Sections resource contains details of the sections of a supplier negotiation requirement. For example, commercial requirements, manufacturing capabilities, or technical requirements.
Show Source
Nested Schema : supplierNegotiationResponses-allLines-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the line is an alternate line. If false, then the line is a regular negotiation line. The default value is false.
  • Title: Alternate Line
    Read Only: true
    Alternate line number offered by the supplier as an alternative to negotiation lines by the buyer.
  • Title: Auction Header ID
    Read Only: true
    Value that uniquely identifies a negotiation.
  • Title: Best Response Price
    Read Only: true
    Best price quoted for the line item among all supplier responses.
  • Title: Category ID
    Read Only: true
    Value that uniquely identifies the purchasing category for the negotiation line.
  • Title: Category Name
    Read Only: true
    Maximum Length: 250
    The purchasing category for the negotiation line.
  • Title: Estimated Quantity
    Read Only: true
    Estimated quantity for the negotiation line on the blanket purchase agreement.
  • Title: Estimated Total Amount
    Read Only: true
    Total amount that the buyer estimates to pay for a fixed price type line item in the negotiation.
  • Title: Group Type Code
    Read Only: true
    Maximum Length: 25
    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 PON_GROUP_TYPE.
  • Title: Item
    Read Only: true
    Maximum Length: 300
    Name of an inventory item.
  • Title: Item ID
    Read Only: true
    Value that uniquely identifies the inventory item.
  • Title: Revision
    Read Only: true
    Maximum Length: 18
    Revision of the inventory item on the negotiation line.
  • Title: Line
    Read Only: true
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Title: Line Amount
    Read Only: true
    Amount calculated for a line as price times quantity in a bid submitted to a seller auction.
  • Title: Close Date
    Read Only: true
    Date and time when the negotiation line closes in a staggered closing or in a negotiation that can extend.
  • Title: Description
    Read Only: true
    Maximum Length: 2500
    Description of the line item.
  • Read Only: true
    Number that identifies the negotiation line.
  • Title: Line ID
    Read Only: true
    Value that identifies the negotiation line.
  • Title: Line Price
    Read Only: true
    Price of the corresponding line item that will be mentioned on the purchasing document. This is displayed in the transactional currency of the purchasing document.
  • Read Only: true
    Maximum Length: 255
    Current status of the line item in terms of response price.
  • Links
  • Title: Location
    Read Only: true
    Maximum Length: 60
    Name of the location to which the line item can be shipped.
  • Title: Manufacturer
    Read Only: true
    Maximum Length: 360
    Name of the manufacturer.
  • Title: Manufacturer Part Number
    Read Only: true
    Maximum Length: 150
    Number associated with the primary manufacturer part.
  • Title: New Supplier Item
    Read Only: true
    Maximum Length: 150
    Note that the supplier enters for the buyer when responding to the negotiation.
  • Title: Note to Buyer
    Read Only: true
    Maximum Length: 4000
    Note that the supplier enters for the buyer when responding to the negotiation.
  • Title: Price Break Type Code
    Read Only: true
    Maximum Length: 25
    Value 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 NONCUMULATIVE. A list of accepted values is defined in the lookup type PON_PRICE_BREAK_TYPE.
  • Title: Promised Delivery Date
    Read Only: true
    Date on which the supplier has promised to deliver the goods to the buying organization.
  • Title: Promised Ship Date
    Read Only: true
    Date on which the supplier has promised to ship the goods to the buying organization if the Buyer Managed transportation is checked in negotiation terms.
  • Title: Proxy Decrement
    Read Only: true
    The minimum price defined by the supplier, below which the response price won't be reduced automatically in a proxy response from the system.
  • Title: Decrement
    Read Only: true
    Value that identifies the minimum price limit by the supplier below which the response price won't be reduced automatically in a proxy response from the application.
  • Read Only: true
    Maximum Length: 255
    Value that identifies the rank of the bidder's response compared to other competing responses for a particular line.
  • Title: Requested Delivery Date
    Read Only: true
    Date by which delivery of goods is requested from suppliers.
  • Title: Requested Ship Date
    Read Only: true
    Date by which shipping of goods is requested from suppliers.
  • Title: Response Minimum Release Amount
    Read Only: true
    Minimum release amount that the supplier quotes when responding to a negotiation with an agreement outcome.
  • Title: Response Number
    Read Only: true
    Value that identifies the supplier response.
  • Title: Response Price
    Read Only: true
    Price quoted by the supplier for a line item in the negotiation.
  • Supplier Negotiation Response Lines
    Title: Supplier Negotiation Response Lines
    Supplier's response price for a line item in a negotiation response over a specified period is retrieved.
  • Title: Response Quantity
    Read Only: true
    Quantity proposed by the supplier for the negotiation line.
  • Title: Start Price
    Read Only: true
    Highest price that the buyer allows the supplier to enter in response to a negotiation line.
  • Title: Supplier Item
    Read Only: true
    Maximum Length: 150
    Name of the item in the supplier company.
  • Title: Target Minimum Release Amount
    Read Only: true
    Minimum release amount the buyer wishes to receive in response to a negotiation line when responding to a negotiation with an agreement outcome.
  • Title: Target Price
    Read Only: true
    Price that the procurement organization prefers to pay for the cost factor.
  • Title: Target Quantity
    Read Only: true
    Quantity proposed by the procurement organization for the negotiation line.
  • Title: Trailing By
    Read Only: true
    Value that indicates the percentage by which the line item is trailing in pricing.
  • Title: UOM
    Read Only: true
    Maximum Length: 25
    Name of the unit of measure for the item in the negotiation.
  • Title: UOM Code
    Read Only: true
    Maximum Length: 3
    Value that identifies the unit of measure for the item in the negotiation.
Nested Schema : Supplier Negotiation Response Lines
Type: array
Title: Supplier Negotiation Response Lines
Supplier's response price for a line item in a negotiation response over a specified period is retrieved.
Show Source
Nested Schema : supplierNegotiationResponses-allLines-responsePricesByTime-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-lines-item-response
Type: object
Show Source
  • Title: Active Responses
    Read Only: true
    Number of active responses to a negotiation.
  • Title: Agreement Quantity
    Read Only: true
    Value that identifies the quantity that was agreed to when awarding to a supplier and the output is an agreement.
  • Title: Allow Alternate Lines
    Read Only: true
    Maximum Length: 30
    Value that indicates whether allow control alternate lines is enabled or not.
  • Title: Alternate Line Description
    Read Only: true
    Maximum Length: 2500
    Description of the alternate line item that the supplier is offering to provide in response to a negotiation line.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then the line is an alternate line. If false, then the line is a regular negotiation line. The default value is false.
  • Title: Alternate Line
    Read Only: true
    Alternate line number offered by the supplier as an alternative to negotiation lines by the buyer.
  • Attachments
    Title: Attachments
    The Attachments resource manages response attachments in the supplier negotiation response.
  • Read Only: true
    Value that uniquely identifies the number of attachments included in the abstract.
  • Title: Auction Header ID
    Read Only: true
    Value that uniquely identifies a negotiation.
  • Title: Award Quantity
    Value that identifies the quantity that was awarded to the response line when the output is a purchase order.
  • Title: Award Reason
    Read Only: true
    Maximum Length: 4000
    Reason entered by the buyer for fully or partially awarding the negotiation to a supplier.
  • Title: Award Status
    Read Only: true
    Maximum Length: 255
    Value that identifies whether the response was awarded or rejected.
  • Read Only: true
    Best price quoted for the line item among all supplier responses.
  • Title: Category ID
    Read Only: true
    Value that uniquely identifies the purchasing category for the negotiation line.
  • Title: Category Name
    Read Only: true
    Maximum Length: 2400
    The purchasing category for the negotiation line.
  • Cost Factors
    Title: Cost Factors
    The Cost Factors resource captures supplier responses to external cost factors for a negotiation line. The external cost factor response values, along with the unit line price, are used to calculate the response price for the negotiation line.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    User who created the negotiation.
  • Title: Creation Date
    Read Only: true
    Date and time when the user created the line.
  • Title: Estimated Total Amount
    Read Only: true
    Total amount that the buyer estimates to pay for a fixed price type line item in the negotiation.
  • Title: Group Type
    Read Only: true
    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 PON_GROUP_TYPE.
  • Title: Group Type Code
    Read Only: true
    Maximum Length: 25
    Value 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 PON_GROUP_TYPE.
  • Title: Item
    Read Only: true
    Maximum Length: 300
    Name of an inventory item.
  • Title: Item ID
    Read Only: true
    Value that uniquely identifies the inventory item.
  • Title: Revision
    Read Only: true
    Maximum Length: 18
    Revision of the inventory item on the negotiation line.
  • Title: Last Update Date
    Read Only: true
    Date and time when the user most recently updated the line.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    User who most recently updated the line.
  • Title: Line
    Read Only: true
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Title: Line Amount
    Read Only: true
    Amount calculated for a line as price times quantity in a bid submitted to a seller auction.
  • Line Attribute Groups
    Title: Line Attribute Groups
    The Attribute Groups resource contains details about groups of attributes on the supplier negotiation line.
  • Title: Close Date
    Read Only: true
    Date and time when the negotiation line closes in a staggered closing or in a negotiation that can extend.
  • Title: Description
    Read Only: true
    Maximum Length: 2500
    Description of the line item.
  • Read Only: true
    Number that identifies the negotiation line.
  • Title: Line ID
    Read Only: true
    Value that identifies the negotiation line.
  • Title: Line Price
    Price of the corresponding line item that will be mentioned on the purchasing document. This is displayed in the transactional currency of the purchasing document.
  • Title: Line Target Price
    Read Only: true
    Value that the buyer wants to receive from supplier responses for the line.
  • Title: Line Type
    Read Only: true
    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 code ORDER_TYPE_LOOKUP_CODE with values Fixed Price and Quantity. 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
    Read Only: true
    Value that identifies the line type that indicates whether the line is for items or services.
  • Links
  • Title: Name
    Read Only: true
    Maximum Length: 360
    Name of the manufacturer.
  • Title: Trading Partner Item
    Read Only: true
    Maximum Length: 150
    Number associated with the primary manufacturer part.
  • Title: Note to Buyer
    Maximum Length: 4000
    Note that the supplier enters for the buyer when responding to the negotiation.
  • Title: Note to Suppliers
    Read Only: true
    Maximum Length: 4000
    Note that the buyer enters for the supplier when responding to the negotiation.
  • Read Only: true
    Value that indicates if the response is for only part of the required negotiation quantity.
  • Price Breaks
    Title: Price Breaks
    The Price Breaks resource captures a supplier's price breaks for the line based on location, quantity, or date.
  • Title: Price Break Type
    Read Only: true
    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
    Read Only: true
    Maximum Length: 25
    Value 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 NONCUMULATIVE. 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: Pricing Basis
    Maximum Length: 30
    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: Promised Delivery Date
    Date on which the supplier has promised to deliver the goods to the buying organization.
  • Title: Promised Ship Date
    Date on which the supplier has promised to ship the goods to the buying organization if the Buyer Managed transportation is checked in negotiation terms.
  • Title: Proxy Decrement
    Read Only: true
    The minimum price defined by the supplier, below which the response price won't be reduced automatically in a proxy response from the system.
  • Title: Decrement
    Value that identifies the minimum price limit by the supplier below which the response price won't be reduced automatically in a proxy response from the application.
  • Title: Rank
    Read Only: true
    Maximum Length: 255
    Value that identifies the rank of the bidder's response compared to other competing responses for a particular line.
  • Title: Requested Delivery Date
    Read Only: true
    Date by which delivery of goods is requested from suppliers.
  • Title: Requested Ship Date
    Read Only: true
    Date by which shipping of goods is requested from suppliers.
  • Title: Estimated Quantity
    Read Only: true
    Estimated quantity for the negotiation line on the blanket purchase agreement.
  • Title: Response Minimum Release Amount
    Minimum release amount that the supplier quotes when responding to a negotiation with an agreement outcome.
  • Title: Response Number
    Read Only: true
    Value that identifies the supplier response.
  • Title: Response Price
    Price quoted by the supplier for a line item in the negotiation.
  • Title: Response Quantity
    Quantity proposed by the supplier for the negotiation line.
  • Title: Score
    Value that identifies the score assigned to a supplier's response for a line group, attribute group, or line attribute.
  • Title: Location
    Read Only: true
    Maximum Length: 60
    Name of the location to which the line item can be shipped.
  • Title: Ship-to Location ID
    Read Only: true
    Value that uniquely identifies the location to which the line item can be shipped.
  • Title: Start Price
    Read Only: true
    Highest price that the buyer allows the supplier to enter in response to a negotiation line.
  • Title: Trading Partner Item
    Read Only: true
    Maximum Length: 150
    Name of the item in the supplier company.
  • Title: Target Minimum Release Amount
    Read Only: true
    Minimum release amount the buyer wishes to receive in response to a negotiation line when responding to a negotiation with an agreement outcome.
  • Title: Target Price
    Read Only: true
    Price that the procurement organization prefers to pay for the cost factor.
  • Title: Target Quantity
    Read Only: true
    Quantity proposed by the procurement organization for the negotiation line.
  • Title: UOM
    Read Only: true
    Maximum Length: 25
    Name of the unit of measure for the item in the negotiation.
  • Title: UOM Code
    Read Only: true
    Maximum Length: 3
    Value that identifies the unit of measure for the item in the negotiation.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages response attachments in the supplier negotiation response.
Show Source
Nested Schema : Cost Factors
Type: array
Title: Cost Factors
The Cost Factors resource captures supplier responses to external cost factors for a negotiation line. The external cost factor response values, along with the unit line price, are used to calculate the response price for the negotiation line.
Show Source
Nested Schema : Line Attribute Groups
Type: array
Title: Line Attribute Groups
The Attribute Groups resource contains details about groups of attributes on the supplier negotiation line.
Show Source
Nested Schema : Price Breaks
Type: array
Title: Price Breaks
The Price Breaks resource captures a supplier's price breaks for the line based on location, quantity, 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 : supplierNegotiationResponses-lines-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-lines-costFactors-item-response
Type: object
Show Source
  • Title: Cost Factor
    Read Only: true
    Maximum Length: 80
    Name of the cost factor.
  • Value that identifies the cost factor.
  • Title: Description
    Read Only: true
    Maximum Length: 240
    Description of the cost factor.
  • Title: Display Target
    Read Only: true
    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 don't allow it. The default value is false.
  • Maximum Length: 25
    Number that identifies the negotiation line.
  • Value that uniquely identifies the sequence of the cost factor in a negotiation line.
  • Value that identifies the negotiation line.
  • Links
  • Title: Pricing Basis
    Read Only: true
    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.
  • 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: Response
    Read Only: true
    Value that uniquely identifies the response.
  • Title: Response Value
    Supplier's response to the cost factor.
  • Title: Target Value
    Read Only: true
    Target value of the cost factor.
Nested Schema : supplierNegotiationResponses-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 : supplierNegotiationResponses-lines-lineAttributeGroups-lineAttributes-item-response
Type: object
Show Source
  • Title: Attribute ID
    Value that identifies the attribute.
  • Title: Attribute
    Read Only: true
    Maximum Length: 4000
    Description of the attribute.
  • Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Read Only: true
    Timestamp of the creation of the row.
  • Title: Group ID
    Read Only: true
    Value that uniquely identifies the line attribute groups.
  • Title: Group Name
    Read Only: true
    Maximum Length: 240
    Name of the attribute group.
  • Read Only: true
    Timestamp of the last update of the row.
  • Read Only: true
    Maximum Length: 64
    Identifies the user who last updated the row.
  • Title: Line
    Read Only: true
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Title: Description
    Read Only: true
    Maximum Length: 2500
    Description of the line item.
  • Title: Line ID
    Value that identifies the negotiation line.
  • Links
  • Title: Response Date Value
    Response value of the line attribute. This value is a date.
  • Title: Response Number
    Identification number used for the supplier's internal tracking.
  • Title: Response Number Value
    Response value of the line attribute. This value is a number data type.
  • Title: Response Text Value
    Maximum Length: 4000
    Response value for the line attribute. This value is a text data type.
  • Title: Response Type
    Read Only: true
    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
    Read Only: true
    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: Score
    Value that identifies the score assigned to a supplier's response for a line group, attribute group, or line attribute.
  • Title: Supplier
    Read Only: true
    Maximum Length: 255
    Name of the supplier who responds to the negotiation.
  • Title: Supplier ID
    Read Only: true
    Value that uniquely identifies the supplier.
  • Title: Target Date Value
    Read Only: true
    Target value of the attribute. This value is applicable for dates.
  • Title: Target Number Value
    Read Only: true
    Target value for the attribute. This value is applicable for numbers.
  • Title: Target Text Value
    Read Only: true
    Maximum Length: 4000
    Target text or URL values of the attribute.
  • Title: Value Type
    Read Only: true
    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
    Read Only: true
    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
    Read Only: true
    Value that identifies the preference given by the buyer to a particular attribute group.
  • Title: Weighted Score
    Value of an attribute's response by calculating its score relative to its weight. The weighted score is calculated by multiplying its score by its weight, divided by 100.
Nested Schema : supplierNegotiationResponses-lines-priceBreaks-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-lines-priceTiers-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-responseLinesRankSummary-item-response
Type: object
Show Source
  • Read Only: true
    Total number of lines in a negotiation response.
  • Links
  • Read Only: true
    Value that identifies the rank of the bidder's response compared to other competing responses for a particular line.
Nested Schema : supplierNegotiationResponses-responsePricesByLines-item-response
Type: object
Show Source
  • Read Only: true
    Best price quoted for the line item among all supplier responses.
  • Read Only: true
    Maximum Length: 29
    Number that identifies the negotiation line.
  • Links
  • Read Only: true
    Price quoted by the supplier for a line item in the negotiation.
  • Read Only: true
    Percentage by which the supplier user's response price is less than the best response price in the negotiation.
Nested Schema : supplierNegotiationResponses-sections-item-response
Type: object
Show Source
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Title: Creation Date
    Read Only: true
    Timestamp of the creation of the row.
  • Title: Evaluation Stage
    Read Only: true
    Maximum Length: 80
    Name of the evaluation stage in a two stage RFQ. Values include Technical or Commercial. A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
  • Title: Evaluation Stage Code
    Read Only: true
    Maximum Length: 30
    Abbreviation that uniquely identifies the name of the evaluation stage in a two stage RFQ. A list of accepted values is defined in the lookup type PON_TWO_PART_TYPE.
  • Title: Last Updated By
    Read Only: true
    Date and time when the user most recently updated the line.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    User who most recently updated the line.
  • Links
  • Title: Maximum Score
    Read Only: true
    Value that identifies the upper limit in rating a supplier's response to a section.
  • Title: Pricing Section
    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 isn't 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 contains details about the requirements of a supplier negotiation.
  • Title: Response Number
    Read Only: true
    Value that uniquely identifies the response.
  • Title: Section
    Read Only: true
    Maximum Length: 240
    Name of the requirement section.
  • Title: Section Display Number
    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.
  • Title: Section ID
    Read Only: true
    Value that uniquely identifies the section.
  • Title: Section Score
    Read Only: true
    Value that identifies the response for a corresponding section response when the scoring is either manual or automatic.
  • Title: Section Weight
    Read Only: true
    Value that identifies the preference given by the buyer to a particular section.
  • Title: Section Weighted Score
    Read Only: true
    Value that was evaluated for a section response by considering the score with respect to its weight.
Nested Schema : Requirements
Type: array
Title: Requirements
The Requirements resource contains details about the requirements of a supplier negotiation.
Show Source
Nested Schema : supplierNegotiationResponses-sections-requirements-item-response
Type: object
Show Source
  • Attachments
    Title: Attachments
    The Attachments resource manages response attachments in the supplier negotiation response.
  • Read Only: true
    Value that uniquely identifies the number of attachments included in the abstract.
  • Title: Comments
    Read Only: true
    Maximum Length: 1000
    Comments entered on a requirement response by the supplier.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Title: Creation Date
    Read Only: true
    Timestamp of the creation of the row.
  • Title: Hint
    Read Only: true
    Maximum Length: 1000
    Text that the application displays to the supplier to help respond to the requirements.
  • Title: Internal Note
    Read Only: true
    Maximum Length: 4000
    Internal note that's entered by the buyer for each supplier.
  • Title: Last Update Date
    Read Only: true
    Date and time when the user most recently updated the requirement.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    User who most recently updated the requirement.
  • Title: Level
    Read Only: true
    Maximum Length: 80
    Supplier level for the requirement. Values include Supplier and Supplier Site. A list of accepted values is defined in the lookup type PON_SUPPLIER_LEVEL.
  • Title: Level Code
    Read Only: true
    Maximum Length: 30
    Abbreviation that uniquely identifies the supplier level for the requirement. Values include Supplier and Supplier Site. A list of accepted values is defined in the lookup type PON_SUPPLIER_LEVEL.
  • Links
  • Title: Maximum Score
    Read Only: true
    Value indicating the upper limit in rating a supplier's response to a requirement.
  • Title: Parent Type
    Read Only: true
    Maximum Length: 10
    Type of requirement parent. If the section is the parent of any other requirement, then the ParentType is SECTION. If not, then the ParentType is SCORE.
  • Title: Question ID
    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
    Read Only: true
    Maximum Length: 80
    Name of the requirement.
  • Title: Requirement ID
    Read Only: true
    Value that uniquely identifies the requirement.
  • Title: Requirement Level
    Read Only: true
    The level at which the requirement is located in the requirement hierarchy. For example, 1, 2, 3, and so on. Level 1 requirement has a section as a parent. Level 2 onward represents the branching requirements with an acceptable response score as a parent.
  • Title: Requirement Number
    Read Only: true
    Maximum Length: 80
    Value that uniquely identifies the sequence for the requirement.
  • Title: Requirement Text
    Read Only: true
    Text that describes the requirement.
  • Title: Requirement Type
    Read Only: true
    Maximum Length: 80
    Type of response that the negotiation requires. Values include Text Entry Box, Multiple Choice with Multiple Selections, and Multiple Choice with Single Selection. A list of accepted values is defined in the lookup type PON_REQUIREMENT_TYPE.
  • Title: Requirement Type Code
    Read Only: true
    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, and Multiple Choice with Single Selection. A list of accepted values is defined in the lookup type PON_REQUIREMENT_TYPE.
  • Read Only: true
    Value that uniquely identifies the response.
  • Title: Response Type
    Read Only: true
    Maximum Length: 80
    Specifies whether a response is required for the requirement. Values include Required, Optional, Display Only, and Internal. A list of accepted values is defined in the lookup type PON_HDR_ATTR_RESPONSE_TYPE.
  • Title: Response Type Code
    Read Only: true
    Maximum Length: 30
    Abbreviation that specifies whether a response for the requirement is required. Values include Required, Optional, Display Only, and Internal. A list of accepted values is defined in the lookup type PON_HDR_ATTR_RESPONSE_TYPE.
  • Response Values
    Title: Response Values
    The Response Values resource manages details about the requirement responses of a supplier negotiation.
  • Title: Score
    Read Only: true
    Value that identifies the response for a corresponding requirement response when the scoring is either manual or automatic.
  • Title: Score ID
    Read Only: true
    Value that uniquely identifies the score.
  • Title: Section
    Read Only: true
    Maximum Length: 240
    Name of the requirement section.
  • Title: Section ID
    Read Only: true
    Value that uniquely identifies the section.
  • Title: Target Date Time Value
    Read Only: true
    Value that the user entered. This value is applicable for date and time.
  • Title: Target Date Value
    Read Only: true
    Value that the user entered in the attribute. This value is applicable for dates.
  • Title: Target Number Value
    Read Only: true
    Value that the user entered in the attribute. This value is applicable for numbers.
  • Title: Target Text Value
    Read Only: true
    Maximum Length: 4000
    Target text or URL (Uniform Resource Locator) values of the requirement.
  • Title: Value Type
    Read Only: true
    Maximum Length: 80
    Type of value for the requirement. Values include Single Line Text, Multiple Line Text, Number, Date, Date and Time, and URL (Uniform Resource Locator). A list of accepted values is defined in the lookup type PON_REQ_RESPONSE_TYPE.
  • Title: Value Type Code
    Read Only: true
    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
    Read Only: true
    Value that identifies the preference given by the buyer to a particular requirement.
  • Title: Weighted Score
    Read Only: true
    Value evaluated for a requirement's response by considering score with respect to its weight.
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages response attachments in the supplier negotiation response.
Show Source
Nested Schema : Response Values
Type: array
Title: Response Values
The Response Values resource manages details about the requirement responses of a supplier negotiation.
Show Source
Nested Schema : supplierNegotiationResponses-sections-requirements-attachments-item-response
Type: object
Show Source
Nested Schema : supplierNegotiationResponses-sections-requirements-responseValues-item-response
Type: object
Show Source
  • Attachments
    Title: Attachments
    The Attachments resource manages response attachments in the supplier negotiation response.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Title: Creation Date
    Read Only: true
    Timestamp of the creation of the row.
  • Title: Is Selected
    Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the response value is selected in multiple choice single select or multiple choice multiple select requirements. If false, then the response isn't selected.
  • Title: Last Update Date
    Read Only: true
    Date and time when the user most recently updated the response value.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    User who most recently updated the response value.
  • Links
  • Title: Question ID
    Read Only: true
    Value that uniquely identifies the requirement for a question.
  • Title: Requirement
    Read Only: true
    Maximum Length: 80
    Name of the requirement.
  • Title: Requirement ID
    Read Only: true
    Value that uniquely identifies the requirement.
  • Title: Requirement Level
    Read Only: true
    The level at which the requirement is located in the requirement hierarchy. For example, 1, 2, 3, and so on. Level 1 requirement has a section as a parent. Level 2 onward represents the branching requirements with an acceptable response score as a parent.
  • Title: Requirement Number
    Read Only: true
    Maximum Length: 80
    Value that uniquely identifies the sequence for the requirement.
  • Title: Requirement Value ID
    Read Only: true
    Value that uniquely identifies the response value.
  • Title: Response Number
    Read Only: true
    Value that uniquely identifies the response.
  • Title: Response Value Date
    Read Only: true
    Response value for a requirement where response type is date.
  • Title: Response Value Date Time
    Read Only: true
    Response value for a requirement where response type is date and time.
  • Title: Response Value Number
    Read Only: true
    Response value for a requirement where response type is number.
  • Title: Response Value Text
    Read Only: true
    Maximum Length: 4000
    Response value for a requirement where response type is text.
  • Title: Score
    Read Only: true
    Number that indicates the rating given to a response value for either a multiple choice with a single selection requirement or a multiple choice with multiple selections requirement that uses automatic scoring. The higher the number the better the response.
  • Title: Score Display Number
    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.
  • Title: Score ID
    Read Only: true
    Value that uniquely identifies the response. This value is applicable for Multiple Choice With Single Selection or Multiple Choice With Multiple Selections response values.
  • Title: Section
    Read Only: true
    Maximum Length: 240
    Name of the requirement section.
  • Title: Section ID
    Read Only: true
    Value that uniquely identifies the section.
  • Title: Target Date Time Value
    Read Only: true
    Target value set by the category manager. This value is applicable for date and time.
  • Title: Target Date Value
    Read Only: true
    Target value set by the category manager. This value is applicable for dates.
  • Title: Target Number Value
    Read Only: true
    Target value set by the category manager. This value is applicable for numbers.
  • Title: Target Text Value
    Read Only: true
    Maximum Length: 4000
    Target value set by the category manager. This value is applicable for text or URL (Uniform Resource Locator).
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages response attachments in the supplier negotiation response.
Show Source
Nested Schema : supplierNegotiationResponses-sections-requirements-responseValues-attachments-item-response
Type: object
Show Source
Links
DisqualifyResponse
Disqualifies a supplier's response to the negotiation.
Back to Top

Examples

This example describes how to get all negotiation responses that the login user can access.

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/supplierNegotiationResponses"

For example:

curl -u username:password "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses?q= NegotiationTitle = Laptop"

Example Response Body

The following example includes the contents of the response body in JSON format:
{
    "items": [
        {
            "ResponseNumber": 175326,
            "AuctionHeaderId": 300100580993746,
            "NegotiationTitle": "Laptop",
            "Negotiation": "40755",
            "CloseDate": "2023-04-16T19:01:13+00:00",
            "AwardCompleteDate": "2023-04-16T19:02:12+00:00",
            "PurchasingDocument": null,
            "ResponseStatus": "Rejected",
            "OverallRank": "2",
            "OverallRankComposite": null,
            "ShortlistStatus": "Included",
            "ResponseAmount": "2846.65",
            "TotalAgreementAmount": null,
            "TotalAwardAmount": 2817.50,
            "SavingsInAmount": 107182.50,
            "SavingsInPercent": "97.44",
            "AwardStatus": "COMPLETED",
            "RequirementScore": 50.00,
            "CompositeScore": null,
            "OverriddenScore": null,
            "ScoringStatus": null,
            "ScoreOverriddenFlag": null,
            "ScoreOverriddenBy": null,
            "ScoreOverridePersonId": null,
            "ScoreOverrideReason": null,
            "ScoreOverriddenDate": null,
            "ResponseType": "Primary",
            "ResponseTypeCode": "PRIMARY",
            "MethodOfResponse": "E-Mail",
            "MethodOfResponseCode": "EMAIL",
            "DisqualificationReason": null,
            "EvaluationStage": null,
            "PrebidFlag": false,
            "Buyer": "Clare Furey",
            "PreviousResponseNumber": null,
            "OriginalResponseNumber": 175326,
            "NegotiationCurrency": "US Dollar",
            "NegotiationCurrencyCode": "USD",
            "NoteToBuyer": "All details are final",
            "PriceDecrement": null,
            "ResponseCurrency": "Euro",
            "ResponseCurrencyCode": "EUR",
            "ResponseCurrencyPricePrecision": 2,
            "ResponseValidUntilDate": "2023-06-30T00:11:00+00:00",
            "Supplier": "Advanced Networks",
            "SupplierId": 300100036697920,
            "SupplierContact": "Bib Carl",
            "SupplierContactId": 300100039080137,
            "SupplierSite": null,
            "SupplierSiteId": -1,
            "SurrogateResponseEnteredById": 300100037432586,
            "SurrogateResponseEnteredBy": "Clare Furey",
            "SurrogateResponseFlag": true,
            "SurrogateResponseCreationDate": "2023-04-16T18:04:09+00:00",
            "SurrogateResponseReceivedOn": "2023-04-16T17:43:00+00:00",
            "ReferenceNumber": "23456",
            "ProxyBidFlag": false,
            "PartialResponseFlag": false,
            "CreatedBy": "Clare Furey",
            "CreationDate": "2023-04-16T17:43:20+00:00",
            "TwoStageEvaluationFlag": false,
            "TechnicalShortlistFlag": null,
            "ShortlistFlag": true,
            "ShortlistStatusUpdatedBy": null,
            "ShortlistStatusUpdatedById": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175326",
                    "name": "supplierNegotiationResponses",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": "...
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175326",
                    "name": "supplierNegotiationResponses",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175326/child/attachments",
                    "name": "attachments",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175326/child/lines",
                    "name": "lines",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175326/child/sections",
                    "name": "sections",
                    "kind": "collection"
                }
            ]
        },
        {
            "ResponseNumber": 175327,
            "AuctionHeaderId": 300100580993746,
            "NegotiationTitle": "Laptop",
            "Negotiation": "40755",
            "CloseDate": "2023-04-16T19:01:13+00:00",
            "AwardCompleteDate": "2023-04-16T19:02:12+00:00",
            "PurchasingDocument": "1007132",
            "ResponseStatus": "Awarded",
            "OverallRank": "1",
            "OverallRankComposite": null,
            "ShortlistStatus": "Included",
            "ResponseAmount": "2817.50",
            "TotalAgreementAmount": null,
            "TotalAwardAmount": 2817.50,
            "SavingsInAmount": 107182.50,
            "SavingsInPercent": "97.44",
            "AwardStatus": "COMPLETED",
            "RequirementScore": 60.00,
            "CompositeScore": null,
            "OverriddenScore": null,
            "ScoringStatus": null,
            "ScoreOverriddenFlag": null,
            "ScoreOverriddenBy": null,
            "ScoreOverridePersonId": null,
            "ScoreOverrideReason": null,
            "ScoreOverriddenDate": null,
            "ResponseType": "Primary",
            "ResponseTypeCode": "PRIMARY",
            "MethodOfResponse": null,
            "MethodOfResponseCode": null,
            "DisqualificationReason": null,
            "EvaluationStage": null,
            "PrebidFlag": false,
            "Buyer": "Clare Furey",
            "PreviousResponseNumber": null,
            "OriginalResponseNumber": 175327,
            "NegotiationCurrency": "US Dollar",
            "NegotiationCurrencyCode": "USD",
            "NoteToBuyer": "No notes for the buyer",
            "PriceDecrement": null,
            "ResponseCurrency": "US Dollar",
            "ResponseCurrencyCode": "USD",
            "ResponseCurrencyPricePrecision": 2,
            "ResponseValidUntilDate": "2023-06-30T00:11:00+00:00",
            "Supplier": "CA Networks",
            "SupplierId": 300100036697924,
            "SupplierContact": "Barnes Cherry",
            "SupplierContactId": 300100039080145,
            "SupplierSite": null,
            "SupplierSiteId": -1,
            "SurrogateResponseEnteredById": null,
            "SurrogateResponseEnteredBy": null,
            "SurrogateResponseFlag": false,
            "SurrogateResponseCreationDate": null,
            "SurrogateResponseReceivedOn": null,
            "ReferenceNumber": "3456",
            "ProxyBidFlag": false,
            "PartialResponseFlag": false,
            "CreatedBy": "CA Networks",
            "CreationDate": "2023-04-16T18:18:45+00:00",
            "TwoStageEvaluationFlag": false,
            "TechnicalShortlistFlag": null,
            "ShortlistFlag": true,
            "ShortlistStatusUpdatedBy": null,
            "ShortlistStatusUpdatedById": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175327",
                    "name": "supplierNegotiationResponses",
                    "kind": "item",
                    "properties": {
                        "changeIndicator": . . . 
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175327",
                    "name": "supplierNegotiationResponses",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175327/child/attachments",
                    "name": "attachments",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175327/child/lines",
                    "name": "lines",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175327/child/sections",
                    "name": "sections",
                    "kind": "collection"
                }
            ]
        },
        {
            "ResponseNumber": 175328,
            "AuctionHeaderId": 300100580993746,
            "NegotiationTitle": "Laptop",
            "Negotiation": "40755",
            "CloseDate": "2023-04-16T19:01:13+00:00",
            "AwardCompleteDate": "2023-04-16T19:02:12+00:00",
            "PurchasingDocument": null,
            "ResponseStatus": "Rejected",
            "OverallRank": "3",
            "OverallRankComposite": null,
            "ShortlistStatus": "Included",
            "ResponseAmount": "3831.17",
            "TotalAgreementAmount": null,
            "TotalAwardAmount": 2817.50,
            "SavingsInAmount": 107182.50,
            "SavingsInPercent": "97.44",
            "AwardStatus": "COMPLETED",
            "RequirementScore": 60.00,
            "CompositeScore": null,
            "OverriddenScore": null,
            "ScoringStatus": null,
            "ScoreOverriddenFlag": null,
            "ScoreOverriddenBy": null,
            "ScoreOverridePersonId": null,
            "ScoreOverrideReason": null,
            "ScoreOverriddenDate": null,
            "ResponseType": "Primary",
            "ResponseTypeCode": "PRIMARY",
            "MethodOfResponse": "E-Mail",
            "MethodOfResponseCode": "EMAIL",
            "DisqualificationReason": null,
            "EvaluationStage": null,
            "PrebidFlag": false,
            "Buyer": "Clare Furey",
            "PreviousResponseNumber": null,
            "OriginalResponseNumber": 175328,
            "NegotiationCurrency": "US Dollar",
            "NegotiationCurrencyCode": "USD",
            "NoteToBuyer": "note to buyer",
            "PriceDecrement": null,
            "ResponseCurrency": "Pound Sterling",
            "ResponseCurrencyCode": "GBP",
            "ResponseCurrencyPricePrecision": 2,
            "ResponseValidUntilDate": null,
            "Supplier": "Legacy Networks",
            "SupplierId": 300100036697928,
            "SupplierContact": "Timothy Burke",
            "SupplierContactId": 300100039080153,
            "SupplierSite": null,
            "SupplierSiteId": -1,
            "SurrogateResponseEnteredById": 300100037432586,
            "SurrogateResponseEnteredBy": "Clare Furey",
            "SurrogateResponseFlag": true,
            "SurrogateResponseCreationDate": "2023-04-16T18:59:41+00:00",
            "SurrogateResponseReceivedOn": "2023-04-16T18:24:00+00:00",
            "ReferenceNumber": "3456",
            "ProxyBidFlag": false,
            "PartialResponseFlag": false,
            "CreatedBy": "Clare Furey",
            "CreationDate": "2023-04-16T18:24:29+00:00",
            "TwoStageEvaluationFlag": false,
            "TechnicalShortlistFlag": null,
            "ShortlistFlag": true,
            "ShortlistStatusUpdatedBy": null,
            "ShortlistStatusUpdatedById": null,
            "links": [
                {
                    "rel": "self",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175328",
                    "name": "supplierNegotiationResponses",
                    "kind": "item",
                    "properties": {
. . . 
                    }
                },
                {
                    "rel": "canonical",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175328",
                    "name": "supplierNegotiationResponses",
                    "kind": "item"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175328/child/attachments",
                    "name": "attachments",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175328/child/lines",
                    "name": "lines",
                    "kind": "collection"
                },
                {
                    "rel": "child",
                    "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses/175328/child/sections",
                    "name": "sections",
                    "kind": "collection"
                }
            ]
        }
    ],
    "count": 3,
    "hasMore": false,
    "limit": 25,
    "offset": 0,
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/supplierNegotiationResponses",
            "name": "supplierNegotiationResponses",
            "kind": "collection"
        }
    ]
}
Back to Top