Get line allocation summary data for a single line
get
/fscmRestApi/resources/11.13.18.05/supplierNegotiationPurchasingDocuments/{AuctionHeaderId}/child/lineAllocationsSummary/{lineAllocationsSummaryUniqID}
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=
-
lineAllocationsSummaryUniqID(required): string
This is the hash key of the attributes which make up the composite key--- AuctionHeaderId and LineNumber ---for the Line Allocations Summary resource and used to uniquely identify an instance of Line Allocations Summary. The client should not generate the hash key value. Instead, the client should query on the Line Allocations Summary collection resource with a filter on the primary key values in order to navigate to a specific instance of Line Allocations Summary.
For example: lineAllocationsSummary?q=AuctionHeaderId=<value1>;LineNumber=<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-lineAllocationsSummary-item-response
Type:
Show Source
object-
AllocatedAwardQuantity: number
Title:
Allocated Award QuantityRead Only:trueAward quantity allocated to requisition demand. -
AlternateLinesPresentFlag: boolean
Read Only:
trueMaximum Length:1Contains one of the following values: true or false. If true, then the line has an alternate line. If false, then the line doesn't have an alternate line. The default value is false. -
AuctionHeaderId: integer
Read Only:
trueValue that uniquely identifies a negotiation. -
AwardedLine: number
Read Only:
trueGet one negotiation detail -
awardedLineResponses: array
Awarded Line Supplier Responses
Title:
Awarded Line Supplier ResponsesDetails of the supplier responses awarded for a negotiation line. -
AwardQuantity: number
Title:
Award QuantityRead Only:trueTotal quantity of line items awarded in a supplier negotiation. -
BuyerManagedTransportationFlag: boolean
Read Only:
trueMaximum Length:1Value that indicates whether the buying company is responsible for arranging transportation. -
Category: string
Read Only:
trueMaximum Length:250Name of the purchasing category. -
Item: string
Read Only:
trueMaximum Length:300Name of an inventory item. -
ItemDescription: string
Read Only:
trueMaximum Length:2500Item description associated to the purchase order line. -
lineAllocationsByResponse: array
Line Allocations by Supplier Response
Title:
Line Allocations by Supplier ResponseSummary of the award quantity allocation for a negotiation line by responses. -
LineNumber: number
Read Only:
trueIdentifier of the negotiation response line. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NegotiationQuantity: number
Title:
Negotiation QuantityRead Only:trueIdentifies the quantity of the line items. -
OrderTypeLookupCode: string
Read Only:
trueMaximum Length:25Abbreviation that identifies the line type basis. Values include QUANTITY, FIXED PRICE. -
PartiallyAllocatedAwardedLinesFlag: boolean
Read Only:
trueMaximum Length:1Indicates whether an awarded line is partially allocated. -
PODoctypeCode: string
Read Only:
trueMaximum Length:25Abbreviation that identifies the type of purchasing document. Values include: STANDARD, BLANKET, or CONTRACT. -
Requisition: string
Read Only:
trueMaximum Length:64Requisition number that the negotiation line references. -
RequisitionBusinessUnit: string
Read Only:
trueMaximum Length:240Name of the requisition purchasing unit that the application uses to set default values for each negotiation line. -
RequisitionLine: string
Read Only:
trueMaximum Length:25Requisition line number that the negotiation line references. -
RequisitionQuantity: number
Title:
Requisition QuantityRead Only:trueQuantity of the requisition line items. -
ResponseNumber: string
Read Only:
trueMaximum Length:25Unique identifier of the supplier response in a supplier negotiation. -
Supplier: string
Read Only:
trueMaximum Length:360Name of the supplier company that the application invited to response to the negotiation. -
UnallocatedAwardedLinesFlag: boolean
Read Only:
trueMaximum Length:1Indicates whether an awarded line is unallocated. -
UnallocatedAwardQuantity: number
Title:
Unallocated Award QuantityRead Only:truePortion of the awarded quantity that hasn't been allocated to any requisition line. -
UnfulfilledRequisitionQuantity: number
Title:
Unfulfilled Requisition QuantityRead Only:trueUnfulfilled Requisition Quantity -
UnitOfMeasure: string
Read Only:
trueMaximum Length:25Measurement unit for a line item in a supplier negotiation.
Nested Schema : Awarded Line Supplier Responses
Type:
arrayTitle:
Awarded Line Supplier ResponsesDetails of the supplier responses awarded for a negotiation line.
Show Source
Nested Schema : Line Allocations by Supplier Response
Type:
arrayTitle:
Line Allocations by Supplier ResponseSummary of the award quantity allocation for a negotiation line by responses.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : supplierNegotiationPurchasingDocuments-lineAllocationsSummary-awardedLineResponses-item-response
Type:
Show Source
object-
AuctionHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies a negotiation. -
AuctionLineNumber: number
Read Only:
trueValue that identifies the line number of the negotiation line. For an alternate line, the value refers to the line number of the original negotiation line for which the alternate was created. -
LineNumber: number
Read Only:
trueIdentifier of the negotiation response line. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ResponseNumber: integer
(int64)
Read Only:
trueUnique identifier of the supplier response in a supplier negotiation. -
Supplier: string
Read Only:
trueMaximum Length:360Name of the supplier company that the application invited to response to the negotiation. -
Suppliersite: string
Read Only:
trueMaximum Length:240Name of 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-lineAllocationsSummary-lineAllocationsByResponse-item-response
Type:
Show Source
object-
AllocatedAwardQuantity: number
Title:
Allocated Award QuantityAward quantity allocated to requisition demand. -
AlternateLineDescription: string
Title:
Alternate Line DescriptionRead Only:trueMaximum Length:2500Description of the alternate line item that the supplier is offering to provide in response to a negotiation line. -
AlternateLineFlag: boolean
Read Only:
trueMaximum Length:1Contains one of the following values: true or false. If true, the alternate lines are displayed. If false, the alternate lines aren't displayed. -
AuctionHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies a negotiation. -
AvailableAwardQuantity: number
Title:
Available Award QuantityRead Only:trueAward quantity that isn't yet allocated to requisition demand. -
AwardQuantity: number
Title:
Award Quantity per ResponseRead Only:trueTotal quantity of line items awarded in a supplier negotiation. -
BidLineNumber: number
Title:
LineRead Only:trueBid line item number. -
BidNumber: integer
(int64)
Title:
ResponseRead Only:trueValue that uniquely identifies a negotiation response. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
NegotiationDisplayLineNumber: string
Title:
Alternate LineRead Only:trueMaximum Length:25Value that identifies the line number of the negotiation line. For an alternate line, the value refers to the line number of the original negotiation line for which the alternate was created. -
PartyName: string
Title:
SupplierRead Only:trueMaximum Length:360Name of the supplier company that the application invited in response to the negotiation. -
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. -
RequestedDeliveryDate: string
(date)
Title:
Requested Delivery DateRead Only:trueDate when the application requests to deliver the item that the negotiation line references. -
RequestedShipDate: string
(date)
Title:
Requested Ship DateRead Only:trueDate when the application requests to ship the item that the negotiation line references. -
RequisitionHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies a requisition. -
RequisitionLineId: integer
(int64)
Read Only:
trueGet one negotiation detail -
RequisitionLineNumber: number
Title:
Requisition LineRead Only:trueRequisition line number that the negotiation line references. -
RequisitionNumber: string
Title:
RequisitionRead Only:trueMaximum Length:64Requisition number that the negotiation line references. -
RequisitionQuantity: number
Title:
Requisition Line QuantityRead Only:trueQuantity of the requisition line items. -
SupplierContact: string
Title:
Supplier ContactRead Only:trueMaximum Length:255Name of the supplier's employee who represents the supplier in communication with the buying organization. -
SupplierSiteCode: string
Title:
Supplier SiteRead Only:trueMaximum Length:240Unique identifier of the supplier site. -
UnitOfMeasure: string
Title:
UOMRead Only:trueMaximum Length:25Abbreviation that identifies the unit of measure for the item in the negotiation. -
UnitOfMeasureCode: string
Title:
UOMRead Only:trueMaximum Length:3Code for the unit of measure for the item in the negotiation.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ResetAllocations
-
Parameters:
- AuctionHeaderId:
$request.path.AuctionHeaderId - lineAllocationsSummaryUniqID:
$request.path.lineAllocationsSummaryUniqID
Resets the awarded line allocation to system defaults. - AuctionHeaderId:
- awardedLineResponses
-
Parameters:
- AuctionHeaderId:
$request.path.AuctionHeaderId - lineAllocationsSummaryUniqID:
$request.path.lineAllocationsSummaryUniqID
Details of the supplier responses awarded for a negotiation line. - AuctionHeaderId:
- lineAllocationsByResponse
-
Parameters:
- AuctionHeaderId:
$request.path.AuctionHeaderId - lineAllocationsSummaryUniqID:
$request.path.lineAllocationsSummaryUniqID
Summary of the award quantity allocation for a negotiation line by responses. - AuctionHeaderId: