Get one negotiation detail
get
/fscmRestApi/resources/11.13.18.05/supplierNegotiationPurchasingDocuments/{AuctionHeaderId}/child/purchasingDocuments/{purchasingDocumentsUniqID}
Request
Path Parameters
-
AuctionHeaderId(required): integer(int64)
The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
-
purchasingDocumentsUniqID(required): string
This is the hash key of the attributes which make up the composite key--- ResponseNumber and SequenceNumber ---for the Purchasing Documents resource and used to uniquely identify an instance of Purchasing Documents. The client should not generate the hash key value. Instead, the client should query on the Purchasing Documents collection resource with a filter on the primary key values in order to navigate to a specific instance of Purchasing Documents.
For example: purchasingDocuments?q=ResponseNumber=<value1>;SequenceNumber=<value2>
Query Parameters
-
dependency: string
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> -
expand: string
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).
-
fields: string
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 -
links: string
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 -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
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".
-
REST-Framework-Version: string
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 TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
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".
-
REST-Framework-Version:
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.
Root Schema : supplierNegotiationPurchasingDocuments-purchasingDocuments-item-response
Type:
Show Source
object-
AcknowledgeWithinDays: number
Title:
Acknowledgment Within DaysValue that specifies the deadline by which a supplier must acknowledge the document to the buyer. -
AgreementAmount: number
Title:
Purchasing Document AmountRead Only:trueTotal amount on the purchase agreement. -
agreementBusinessUnitAccesses: array
Business Unit Access for Purchase Agreements
Title:
Business Unit Access for Purchase AgreementsBusiness Unit Access for Purchase Agreements -
AgreementEndDate: string
(date)
Title:
Agreement End DateDate when the purchase agreement expires. -
AgreementStartDate: string
(date)
Title:
Agreement Start DateDate when the purchase agreement goes into effect. -
AuctionHeaderId: integer
(int64)
Value that uniquely identifies a negotiation.
-
AutomaticallyGenerateOrdersFlag: boolean
Title:
Automatically generate ordersMaximum Length:1Value that indicates whether to automatically generate orders for the agreement. -
AutomaticallySubmitForApprovalFlag: boolean
Title:
Automatically submit for approvalMaximum Length:1Value that indicates whether to automatically submit the agreement for approval. -
awardedLines: array
Awarded Lines for Purchase Agreements
Title:
Awarded Lines for Purchase AgreementsDetails about the awarded lines in a purchasing document. -
BilltoBU: string
Title:
Bill-to BURead Only:trueMaximum Length:240Name of the bill-to business unit for an agreement. -
BilltoBUId: integer
(int64)
Unique identifier of the bill-to business unit that vouches for the supplier invoices received for the purchase order.
-
BillToLocation: string
Title:
NameRead Only:trueMaximum Length:60Name of the bill-to location in the business unit access. -
BillToLocationId: integer
(int64)
Unique identifier of the bill-to location in the business unit access.
-
Buyer: string
Title:
NameRead Only:trueMaximum Length:240Name of the user who created the negotiation. -
BuyerId: integer
(int64)
Value that uniquely identifies the user who created the negotiation.
-
CommunicateRepricedOrdersFlag: boolean
Maximum Length:
1Value that finds a negotiation using the supplier site as the primary key. -
ContractId: integer
(int64)
Read Only:
trueUnique identifier that represents a contract. -
ContractType: string
Title:
OutcomeRead Only:trueMaximum Length:25Value that uniquely identifies the contract type for the short-term or long-term purchase. -
DisplayInitiateApprovalFlag: boolean
Read Only:
trueMaximum Length:1Value that indicates whether to display the text Initiate Approval. -
DocumentFiscalClassification: string
Read Only:
trueMaximum Length:1996Value that uniquely identifies the document's fiscal classification. -
ExistingAgreementMatchingLineActionType: string
Maximum Length:
30Indicates if matching lines from an existing purchasing document need to be expired, updated, or added. -
GroupRequisitionsFlag: boolean
Title:
Group requisitionsMaximum Length:1Value that indicates whether to group requisitions for the agreement. -
GroupRequisitionsLinesFlag: boolean
Title:
Group requisition linesMaximum Length:1Value that indicates whether to group requisition lines for the agreement. -
HasPendingChangeOrder: string
Read Only:
trueMaximum Length:1Value that indicates whether a purchasing document has a pending change order. -
InitiateApprovalFlag: boolean
Title:
Initiate ApprovalMaximum Length:1Value that indicates whether to initiate approval for a purchasing document. -
IsSupplierSiteEditableFlag: boolean
Read Only:
trueMaximum Length:1Value that indicates if the supplier site is editable or read-only for a staged purchasing document. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NumberOfAwardedLines: integer
Read Only:
trueNumber of awarded lines in a staged purchasing document. -
PricePrecision: integer
(int32)
Title:
PrecisionRead Only:trueIndicates the accuracy (number of decimal places) with which the price values will be displayed in the award. -
ProcurementBUId: integer
(int64)
Title:
Procurement BURead Only:trueValue that uniquely identifies the procurement business unit that owns the negotiation. -
ProgressPaymentFlag: boolean
Read Only:
trueMaximum Length:1Value that uniquely identifies the procurement business unit that owns the negotiation. -
PurchasingDocumentHeaderId: integer
(int64)
Read Only:
trueValue to uniquely identify a purchasing document. -
PurchasingDocumentNumber: string
Title:
OrderRead Only:trueMaximum Length:30Number that identifies a purchasing document. -
PurchasingDocumentStatus: string
Title:
MeaningRead Only:trueMaximum Length:80Status of the purchasing document. -
PurchasingDocumentStatusCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the status of the purchasing document. -
RelationshipId: integer
(int64)
Read Only:
trueValue to uniquely identify the relationship of the supplier contact. -
RepriceOpenOrdersOnlyFlag: boolean
Maximum Length:
1Value that uniquely identifies the relationship between the supplier contact and the supplier. -
RequiredAcknowledgement: string
Title:
MeaningRead Only:trueMaximum Length:80Acknowledgment required by the application from the supplier. Values include: Document and Schedule when the supplier must acknowledge the header and line of the purchase agreement, Document when the supplier must acknowledge the header of the purchase agreement, or None when the purchase agreement doesn't require acknowledgment. -
RequiredAcknowledgementCode: string
Title:
Required AcknowledgmentMaximum Length:1Abbreviation identifying the acknowledgment required from the supplier for the purchase order. Values include: Y (Document and Schedule), D (Document), and N (None). -
RequisitioningBU: string
Title:
OrganizationRead Only:trueMaximum Length:240Name of the requisitioning business unit. -
RequisitioningBUId: integer
(int64)
Unique identifier of the requisitioning business unit in business unit access.
-
ResponseCurrencyCode: string
Title:
Response CurrencyRead Only:trueMaximum Length:15Abbreviation that identifies the currency that the response uses. -
ResponseNumber: integer
(int64)
Title:
ResponseRead Only:trueUniquely identifies supplier's response for a negotiation. -
SequenceNumber: number
Display sequence of the staged purchasing documents or purchasing documents within a negotiation.
-
SoldtoLeId: integer
(int64)
Unique identifier of the party financially responsible for purchases on a purchase order.
-
SoldToLEName: string
Title:
Legal Entity NameRead Only:trueMaximum Length:240Indicates the party financially responsible for the purchases on a purchase order. -
Supplier: string
Title:
NameRead Only:trueMaximum Length:360Name of the supplier who responds to the negotiation. -
SupplierContact: string
Read Only:
trueMaximum Length:255Name of the supplier contact at the supplier that responds to the negotiation. -
SupplierContactId: integer
(int64)
Value that uniquely identifies the supplier contact.
-
SupplierId: integer
(int64)
Read Only:
trueValue that uniquely identifies the supplier. -
SupplierSite: string
Title:
SiteRead Only:trueMaximum Length:240Name of the supplier site. -
SupplierSiteId: integer
(int64)
Title:
Supplier SiteValue that identifies the supplier site. -
TerritoryShortName: string
Title:
Territory NameRead Only:trueMaximum Length:80Name of the country where the transaction is deemed to have taken place for taxation purposes. -
TotalAgreementAmount: number
Title:
Award AmountRead Only:trueThe total amount of all lines in the purchase agreement. -
TotalAgreementAmountResponseCurrency: number
Read Only:
trueTotal agreement amount of a purchasing document in the response currency. -
TotalAwardAmount: number
Read Only:
trueThe total amount awarded to the supplier response. -
TotalAwardAmountResponseCurrency: number
Read Only:
trueTotal award amount of a purchasing document in the response currency. -
UpdateExistingAgreementFlag: boolean
Read Only:
trueMaximum Length:1Value that indicates whether updating an existing agreement from a sourcing award is enabled. -
UsePurchasingDocumentHeaderId: integer
(int64)
Value that uniquely identifies a purchasing document to which the awarded lines should be added.
-
UseRequestedDateFlag: boolean
Maximum Length:
1Value that indicates whether to group requisition lines by using the requested date for the agreement. -
UseShipToOrganizationAndLocationFlag: boolean
Maximum Length:
1Group requisition lines using ship to organization and location. -
VendorId: integer
(int64)
Read Only:
trueValue that uniquely identifies the supplier.
Nested Schema : Business Unit Access for Purchase Agreements
Type:
arrayTitle:
Business Unit Access for Purchase AgreementsBusiness Unit Access for Purchase Agreements
Show Source
Nested Schema : Awarded Lines for Purchase Agreements
Type:
arrayTitle:
Awarded Lines for Purchase AgreementsDetails about the awarded lines in a purchasing document.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : supplierNegotiationPurchasingDocuments-purchasingDocuments-agreementBusinessUnitAccesses-item-response
Type:
Show Source
object-
AuctionHeaderId: integer
(int64)
Value that uniquely identifies a negotiation.
-
BidNumber: integer
(int64)
Value that uniquely identifies a negotiation response.
-
BilltoBUId: integer
(int64)
Unique identifier of the bill-to business unit that vouches for the supplier invoices received for the purchase order.
-
BillToBUName: string
Title:
Bill-to BUMaximum Length:240Name of the bill-to business unit for an agreement. -
BillToLocationId: integer
(int64)
Unique identifier of the bill-to location in the business unit access.
-
EnabledFlag: boolean
Title:
EnabledMaximum Length:1Value that indicates whether the current organization assignment for the agreement is enabled. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
LocationCode: string
Title:
Bill-to LocationMaximum Length:60Code of the Location. -
OrderedLocallyFlag: boolean
Title:
Order LocallyMaximum Length:1Indicates whether the client's order for items on the agreement should be routed to local supplier sites maintained by the client. -
POSequenceNumber: number
Sequence number of the purchase agreement.
-
PurchasingSiteName: string
Title:
Purchasing SiteRead Only:trueName of the supplier site enabled for purchasing. -
RequisitioningBU: string
Title:
Requisitioning BURead Only:trueName of the requisitioning business unit. -
RequisitioningBUId: integer
(int64)
Title:
Requisitioning BUUnique identifier of the requisitioning business unit in business unit access. -
SequenceNumber: number
Display sequence of the staged purchasing documents or purchasing documents within a negotiation.
-
ShipToLocationId: integer
(int64)
Value that uniquely identifies the location where the supplier ships the item.
-
ShipToLocationName: string
Title:
Ship-to LocationRead Only:trueName of the location where the application ships the negotiated item, or where the provider performs the negotiated service. -
VendorSiteCode: string
Title:
SiteRead Only:trueMaximum Length:240Value that uniquely identifies the supplier site code. -
VendorSiteId: integer
(int64)
Value that uniquely identifies the supplier site.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : supplierNegotiationPurchasingDocuments-purchasingDocuments-awardedLines-item-response
Type:
Show Source
object-
AgreementLineAmount: number
Read Only:
trueValue that finds a negotiation using the supplier site as the primary key. -
AgreementLineAmountResponseCurrency: number
Read Only:
trueValue that finds a negotiation using the supplier site as the primary key. -
AlternateLineDescription: string
Title:
Alternate Line DescriptionRead Only:trueMaximum Length:2500Description of an alternate line. -
AlternateLineFlag: boolean
Read Only:
trueMaximum Length:1Value that indicates if alternate lines are present in the negotiation. -
AuctionHeaderId: integer
(int64)
Value that uniquely identifies a negotiation.
-
CategoryName: string
Read Only:
trueMaximum Length:2400Name of the purchasing category. -
Description: string
Title:
DescriptionMaximum Length:2500Description of the awarded line item. -
ItemId: integer
(int64)
Unique identifier for the item.
-
ItemRevision: string
Title:
RevisionMaximum Length:18Item revision associated to the purchase order line. -
LineNumber: number
Line number in a supplier response.
-
LinePriceResponseCurrency: number
Read Only:
truePrice of the negotiation line item in response currency. -
LineTypeLookupCode: string
Read Only:
trueMaximum Length:25Value that finds a negotiation using the supplier site as the primary key. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
OrderLineAmount: number
Read Only:
trueTotal amount ordered for the purchase order line. -
OrderLineAmountResponseCurrency: number
Read Only:
trueTotal amount ordered for the purchase order line in response currency. -
OrderLineItemNumber: string
Read Only:
trueMaximum Length:255Value that identifies the item number of a purchase order line. -
PricePrecision: integer
(int32)
Title:
PrecisionRead Only:trueIndicates the accuracy (number of decimal places) with which the price values will be displayed in the award. -
PromisedDeliveryDate: string
(date)
Title:
Promised Delivery DateRead Only:trueDate on which the supplier has promised to deliver the goods to the buying organization. -
PromisedShipDate: string
(date)
Title:
Promised Ship DateRead Only:trueDate on which the supplier has promised to ship the goods to the buying organization if the Buyer Managed transportation is checked in negotiation terms. -
Quantity: number
Quantity of the item in the negotiation.
-
Requisition: string
Title:
RequisitionRead Only:trueMaximum Length:64Requisition number that the negotiation line references. -
RequisitioningBUId: integer
(int64)
Read Only:
trueUnique identifier of the requisitioning business unit in business unit access. -
RequisitionLine: string
Read Only:
trueMaximum Length:20Requisition line number that the negotiation line references. -
ResponseCurrencyCode: string
Title:
Response CurrencyRead Only:trueMaximum Length:15Abbreviation that identifies the currency that the response uses. -
ResponseNumber: integer
(int64)
Read Only:
trueUniquely identifies supplier's response for a negotiation. -
SequenceNumber: number
Display sequence of the staged purchasing documents or purchasing documents within a negotiation.
-
StagedDocumentDisplayLineNumber: string
Title:
LineRead Only:trueMaximum Length:25Display line number for a negotiation line in a staged purchasing document. -
SupplierItem: string
Read Only:
trueMaximum Length:150Name of the item in the supplier company. -
UnitOfMeasure: string
Title:
UOM NameRead Only:trueMaximum Length:25Abbreviation that identifies the unit of measure for the item in the negotiation. -
UnitPrice: number
Read Only:
truePrice per unit in negotiation currency.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- agreementBusinessUnitAccesses
-
Parameters:
- AuctionHeaderId:
$request.path.AuctionHeaderId - purchasingDocumentsUniqID:
$request.path.purchasingDocumentsUniqID
Business Unit Access for Purchase Agreements - AuctionHeaderId:
- awardedLines
-
Parameters:
- AuctionHeaderId:
$request.path.AuctionHeaderId - purchasingDocumentsUniqID:
$request.path.purchasingDocumentsUniqID
Details about the awarded lines in a purchasing document. - AuctionHeaderId: