Get one negotiation response

get

/fscmRestApi/resources/11.13.18.05/draftSupplierNegotiationResponses/{draftSupplierNegotiationResponsesUniqID}

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Draft Supplier Negotiation Responses resource and used to uniquely identify an instance of Draft Supplier Negotiation Responses. The client should not generate the hash key value. Instead, the client should query on the Draft Supplier Negotiation Responses collection resource in order to navigate to a specific instance of Draft Supplier Negotiation Responses 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 : draftSupplierNegotiationResponses-item-response
Type: object
Show Source
  • 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: Buyer
    Read Only: true
    Maximum Length: 240
    Name of the user who created the negotiation.
  • Read Only: true
    Maximum Length: 255
    Email address of the buyer.
  • Title: Buyer ID
    Read Only: true
    Value that uniquely identifies the user who created the negotiation.
  • Title: Close Date
    Read Only: true
    Date when the negotiation stops accepting responses from the supplier.
  • Title: Company
    Read Only: true
    Maximum Length: 240
    Name of the buyer's company.
  • Title: Company ID
    Read Only: true
    Value that uniquely identifies the buyer's company.
  • 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.
  • Read Only: true
    Maximum Length: 1
    Contains one of the following values: true or false. If true, then the draft is locked for editing. If false, then the draft isn't locked for editing. The default value is true.
  • Title: Draft Locked By
    Read Only: true
    Maximum Length: 360
    Name of the supplier who has locked the response by creating the original response.
  • Title: Draft Locked by Contact
    Read Only: true
    Maximum Length: 360
    Name of the supplier contact who has locked the response by creating the original response.
  • Title: Draft Locked by Contact ID
    Read Only: true
    Person ID of the supplier contact who has locked the response by creating the original response.
  • Title: Draft Locked by ID
    Read Only: true
    Person ID of the supplier who has locked the response by creating the original response.
  • Title: Draft Locked Date
    Read Only: true
    Date and time when the draft was locked.
  • Title: Draft Unlocked By
    Read Only: true
    Maximum Length: 360
    Name of the supplier who has unlocked the previous draft response.
  • Title: Draft Unlocked by Contact
    Read Only: true
    Maximum Length: 360
    Name of the supplier contact who has unlocked the previous draft response.
  • Title: Draft Unlocked by Contact ID
    Read Only: true
    Person ID of the supplier contact who has unlocked the previous draft response.
  • Title: Draft Unlocked by ID
    Read Only: true
    Person ID of the supplier who has unlocked the previous draft response.
  • Read Only: true
    Date and time when the draft was unlocked.
  • Read Only: true
    Maximum Length: 20
    Stores two values: Technical and Commercial, required to mark the surrogate response in a two-stage negotiation.
  • 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.
  • Lines
    Title: Lines
    The Response Lines resource captures supplier response information for the negotiation line such as the line price, response quantity, promised delivery date, and note to buyer.
  • Links
  • Title: Method of Response
    Maximum Length: 80
    Indicates other response methods like fax or email used by the supplier. A list of accepted values are identified in the lookup type PON_METHOD_OF_RESPONSE.
  • 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.
  • Read Only: true
    Value that identifies the first response number in a series of revised bids.
  • 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.
  • Read Only: true
    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.
  • 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: Proxy Decrement Amount
    Value by which the response price is reduced automatically during the submission of a proxy bid by the application.
  • Title: Decrement
    Read Only: true
    Maximum Length: 25
    Value by which the response price is reduced automatically during the submission of a proxy bid by the sourcing application. This decrement can be either by a flat amount or a percentage.
  • Title: Reference Number
    Maximum Length: 25
    Identification number used for the supplier's internal tracking.
  • Read Only: true
    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
    Name of the response currency.
  • Title: Response Currency Code
    Read Only: true
    Maximum Length: 15
    Abbreviation that identifies the currency that the response uses.
  • Title: Price Precision
    Read Only: true
    Value that specifies the precision in number of digits after the decimal for the response currency.
  • Title: Response Display Name
    Read Only: true
    Maximum Length: 80
    Indicates the response display name such as bid, quote, and response.
  • Read Only: true
    Maximum Length: 20
    Indicates whether the intent is to revise or copy a response. Values accepted are Copy, Revise, and Null. If Copy, the existing response is copied. If Revise, the existing response is revised. If Null, the original response remains.
  • Title: Response Number
    Read Only: true
    Value that uniquely identifies the response.
  • Read Only: true
    Maximum Length: 255
    Status of the response.
  • Title: Response Type
    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.
  • 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: 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 ID
    Read Only: true
    Value that identifies the contact of the supplier who responds to the negotiation.
  • Title: Supplier ID
    Read Only: true
    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
    Read Only: true
    Value that identifies the supplier site.
  • Title: Surrogate Draft Lock Person
    Read Only: true
    Maximum Length: 240
    Name of the buyer who has locked the draft surrogate response for editing.
  • Title: Surrogate Draft Unlock Person
    Read Only: true
    Maximum Length: 240
    Name of the buyer who has unlocked the draft surrogate response for editing.
  • Title: Surrogate Response Entered by ID
    Read Only: true
    Value that uniquely identifies the buyer user who created the surrogate response.
  • Read Only: true
    Timestamp when the buyer entered the response on behalf of the supplier.
  • 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.
  • Timestamp when the buyer received the surrogate response through other response methods such as fax or email.
  • Title: Surrogate Draft Lock Person ID
    Read Only: true
    Person ID of the buyer who has locked the draft surrogate response for editing.
  • Title: Surrogate Draft Unlock Person ID
    Read Only: true
    Person ID of the buyer who has unlocked the draft surrogate response for editing.
  • Read Only: true
    Maximum Length: 255
    Time remaining for the negotiation to be closed.
  • 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 : 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 captures supplier response information for the negotiation line such as the line price, response quantity, promised delivery date, and note to buyer.
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 : draftSupplierNegotiationResponses-attachments-item-response
Type: object
Show Source
Nested Schema : draftSupplierNegotiationResponses-lines-item-response
Type: object
Show Source
  • 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.
  • 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.
  • 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: Best Response Score
    Read Only: true
    Best response based on multiattribute scoring.
  • Title: Category ID
    Read Only: true
    Value that uniquely identifies the purchasing category for the negotiation line.
  • 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.
  • Read Only: true
    Maximum Length: 64
    User who created the negotiation.
  • Read Only: true
    Date and time when the user created the line.
  • 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.
  • 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.
  • 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.
  • 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
    Read Only: true
    Maximum Length: 25
    Number that identifies the negotiation line.
  • 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: Total Score
    Read Only: true
    Total weighted score of the supplier??????s response to a goods line or a fixed-price service line, based on multiattribute scoring.
  • 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.
  • 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: 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.
  • 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
    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: 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.
  • 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: 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: Supplier
    Read Only: true
    Maximum Length: 360
    Name of the supplier who responds to the negotiation.
  • Title: Supplier ID
    Read Only: true
    Value that uniquely identifies the supplier.
  • Title: Suppliers can modify price breaks
    Read Only: true
    Maximum Length: 1
    Check box that indicates that the price breaks are optional and suppliers can add, delete, or modify price breaks.
  • 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 Name
    Read Only: true
    Maximum Length: 25
    Name of the unit of measure for the item in the negotiation.
  • Title: UOM
    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 : draftSupplierNegotiationResponses-lines-attachments-item-response
Type: object
Show Source
Nested Schema : draftSupplierNegotiationResponses-lines-costFactors-item-response
Type: object
Show Source
  • Title: Cost Factor
    Read Only: true
    Maximum Length: 80
    Name of the cost factor.
  • Title: Cost Factor ID
    Read Only: true
    Value that identifies the cost factor.
  • Read Only: true
    Maximum Length: 64
    Identifies the user who created the row.
  • Read Only: true
    Timestamp of the creation of the row.
  • 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.
  • Read Only: true
    Identifies the user who last updated the row.
  • Read Only: true
    Maximum Length: 64
    Timestamp of the last update of the row.
  • Read Only: true
    Maximum Length: 25
    Number that identifies the negotiation line.
  • Title: Line Cost Factor ID
    Read Only: true
    Value that uniquely identifies the sequence of the cost factor in a negotiation line.
  • Title: Line ID
    Read Only: true
    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.
  • Title: Pricing Basis Code
    Read Only: true
    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 Number
    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 : draftSupplierNegotiationResponses-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 : draftSupplierNegotiationResponses-lines-lineAttributeGroups-lineAttributes-item-response
Type: object
Show Source
  • Title: Attribute ID
    Read Only: true
    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
    Read Only: true
    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
    Read Only: true
    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.
  • 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
    Importance of the line attribute when compared to other line attributes. The application uses this weight when it calculates the line score.
Nested Schema : draftSupplierNegotiationResponses-lines-priceBreaks-item-response
Type: object
Show Source
Nested Schema : draftSupplierNegotiationResponses-lines-priceTiers-item-response
Type: object
Show Source
Nested Schema : draftSupplierNegotiationResponses-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 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.
  • Links
  • 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
    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
    Value that uniquely identifies the section.
Nested Schema : Requirements
Type: array
Title: Requirements
The Requirements resource contains details about the requirements of a supplier negotiation.
Show Source
Nested Schema : draftSupplierNegotiationResponses-sections-requirements-item-response
Type: object
Show Source
  • Attachments
    Title: Attachments
    The Attachments resource manages response attachments in the supplier negotiation response.
  • Title: Comments
    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: 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: 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.
  • Title: Response Number
    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 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.
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 : draftSupplierNegotiationResponses-sections-requirements-attachments-item-response
Type: object
Show Source
Nested Schema : draftSupplierNegotiationResponses-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
    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 requirement response value when there is no scoring applicable. This is applicable for text entry box responses.
  • Title: Response Value Date
    Response value for a requirement where response type is date.
  • Title: Response Value Date Time
    Response value for a requirement where response type is date and time.
  • Title: Response Value Number
    Response value for a requirement where response type is number.
  • Title: Response Value Text
    Maximum Length: 4000
    Response value for a requirement where response type is text.
  • 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 : draftSupplierNegotiationResponses-sections-requirements-responseValues-attachments-item-response
Type: object
Show Source
Back to Top

Examples

This example describes how to get one negotiation response .

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/draftSupplierNegotiationResponses/draftSupplierNegotiationResponsesUniqID"

For example:

curl -u username:password "https://servername/fscmRestApi/resources/version/"draftSupplierNegotiationResponses/188787

Example Response Body

The following example includes the contents of the response body in JSON format:
{
    "ResponseNumber": 188787,
    "ResponseDisplayName": "Quote",
    "ResponseIntent": null,
    "ResponseStatus": "Draft",
    "PreviousResponseNumber": null,
    "OriginalResponseNumber": 188787,
    "AuctionHeaderId": 300100559789922,
    "NegotiationTitle": "Purchasing HVAC System",
    "Negotiation": "40216",
    "CloseDate": "2022-12-31T19:37:00+00:00",
    "TimeRemaining": "266 Days 23 Hours",
    "BuyerId": 100010026863791,
    "Buyer": null,
    "BuyerEmail": "cody.dapolito@oracle.com",
    "CompanyId": 202,
    "Company": "Vision Corporation Enterprise",
    "SupplierId": 299411,
    "Supplier": "CV_SuppB01",
    "SupplierSiteId": -1,
    "SupplierSite": null,
    "SupplierContactId": 299991,
    "SupplierContact": "Jenkins, Mr. Bradford",
    "TwoStageEvaluationFlag": true,
    "NegotiationCurrencyCode": "USD",
    "NegotiationCurrency": "US Dollar",
    "ResponseAmount": 427,
    "ResponseCurrencyCode": "USD",
    "ResponseCurrency": "US Dollar",
    "ResponseCurrencyPricePrecision": 2,
    "ResponseValidUntilDate": "2022-12-31T19:38:00+00:00",
    "ResponseType": "PRIMARY",
    "ReferenceNumber": "2432",
    "NoteToBuyer": "Final response",
    "EvaluationStage": null,
    "PriceDecrement": null,
    "ProxyBidFlag": false,
    "ProxyDecrementType": null,
    "ProxyDecrementAmount": null,
    "PartialResponseFlag": null,
    "SurrogateResponseEnteredById": null,
    "SurrogateResponseReceivedOn": null,
    "SurrogateResponseEntryDate": null,
    "SurrogateResponseFlag": false,
    "SurrogDraftLockPersonId": null,
    "SurrogateDraftLockPerson": null,
    "SurrogDraftUnlockPersonId": null,
    "SurrogateDraftUnlockPerson": null,
    "MethodOfResponse": null,
    "DraftLocked": "Y",
    "DraftLockedById": 299411,
    "DraftLockedBy": "CV_SuppB01",
    "DraftLockedByContactId": 299991,
    "DraftLockedByContact": "Jenkins, Mr. Bradford",
    "DraftLockedDate": "2022-04-08T19:39:29+00:00",
    "DraftUnlockedById": null,
    "DraftUnlockedBy": null,
    "DraftUnlockedByContactId": null,
    "DraftUnlockedByContact": null,
    "DraftUnlockedDate": null,
    "CreatedBy": "CVSUPPB01",
    "CreationDate": "2022-04-08T19:39:29+00:00",
    "LastUpdateDate": "2022-04-08T19:46:17.694+00:00",
    "LastUpdatedBy": "CVSUPPB01",
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188787",
            "name": "draftSupplierNegotiationResponses",
            "kind": "item",
            "properties": {
                "changeIndicator": "..."
            }
        },
        {
            "rel": "canonical",
            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188787",
            "name": "draftSupplierNegotiationResponses",
            "kind": "item"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188787/child/attachments",
            "name": "attachments",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188787/child/lines",
            "name": "lines",
            "kind": "collection"
        },
        {
            "rel": "child",
            "href": "https://servername/fscmRestApi/resources/version/draftSupplierNegotiationResponses/188787/child/sections",
            "name": "sections",
            "kind": "collection"
        }
    ]
}
Back to Top