Get one price agreement for an order
/fscmRestApi/resources/11.13.18.05/buyerPlanningAgreements/buyerPlanningAgreements
Request
-
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 doesn't specify this header in the request the server will pick a default version for the API.
- application/json
object-
AgreementCurrencyCode: string
Read Only:
trueMaximum Length:30Abbreviation??that??identifies??the currency for the purchase agreement. -
AgreementEndDate: string
Read Only:
trueDate when the purcahse agreement expires. -
AgreementHeaderAmount: number
(double)
Read Only:
trueValue that identifies the amount agreed to for the planned or blanket purchase order. -
AgreementHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement. -
AgreementHeaderMinReleaseAmount: number
(double)
Read Only:
trueValue that identifies the minimum amount that can be released against the sum of all the PO line amounts. -
AgreementHeaderReleaseAmount: number
(double)
Read Only:
trueValue that identifies the amount released against this agreement. It's the sum of all the approved standard PO amounts. -
AgreementLineId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement line. -
AgreementNumber: string
Read Only:
trueMaximum Length:30Number that uniquely identifies the purchase agreement. -
AgreementStartDate: string
Read Only:
trueDate when the purcahse agreement goes into effect. -
ConfiguredItemFlag: string
Maximum Length:
1Indicates whether or not the item configured. The values can be Yes or No. If the value is Yes, then item is configured. -
CurrencyCode: string
Read Only:
trueMaximum Length:15Abbreviation??that??identifies??the currency for the order in buyer planning. -
DockDate: string
Date when the material should be on the receiving dock when the order is released.
-
ItemId: integer
(int64)
Value that uniquely identifies the item associated with the order in buyer planning.
-
ItemPrice: number
(double)
Read Only:
truePrice per unit offered for the quantity range. -
ItemRevisionCode: string
Maximum Length:
30Abbreviation that identifies the revision of the item on the purchase agreement. -
LineAgreementAmount: number
(double)
Read Only:
trueValue that identifies the amount agreed to for the planned or blanket purchase order line. -
LineAgreementQuantity: number
(double)
Read Only:
trueValue that identifies the total quanity of the item to be released against this agreement. It's the sum of all the approved standard PO line quantities. -
LineExpiryDate: string
Read Only:
trueDate when the agreement line expires. -
LineMinimumReleaseAmount: number
(double)
Read Only:
trueValue that identifies the minimum amount that can be released against the PO line. -
LineNumber: string
Read Only:
trueMaximum Length:30Number that identifies the purchase agreement line. -
LineReleaseAmount: number
(double)
Read Only:
trueValue that identifies the amount released against this agreement. It's the sum of all the approved standard PO amounts. -
LocationId: integer
(int64)
Value that uniquely identifies the location associated to the order in buyer planning.
-
MappedItemId: integer
(int64)
Value that uniquely identifies the mapped fusion item associated with the order in in buyer planning.
-
MappedOrganizationId: integer
(int64)
Value that uniquely identifies the mapped fusion organization associated with the order in buyer planning.
-
MappedSupplierId: integer
(int64)
Value that uniquely identifies the mapped fusion supplier from where the item is being sourced in buyer planning.
-
OrderQuantity: number
(double)
Value that identifies the order quantity in buyer planning.
-
OrderTotalPrice: number
(double)
Read Only:
trueValue that identifies the total price for order quantity in buyer planning. -
PoDiscount: number
(double)
Read Only:
trueValue that indicates the discount percent or amount of the purchase order line. -
PoDiscountType: string
Read Only:
trueMaximum Length:30Type of discount that indicates whether the discount is based on amount or percent. -
PoHeaderId: integer
(int64)
Value that uniquely identifies the purchase order in buyer planning.
-
PoIsNewPriceApplicable: string
Read Only:
trueMaximum Length:1Indicates whether or not the agreement price is applicable to the order. The values can be Y or N. If the value is Yes, then the agreement price can be applied to the purchase order. -
PoLineId: integer
(int64)
Value that uniquely identifies the purchase order line in buyer planning.
-
PriceBreakTypeCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the type of price break. -
PriceBreakTypeName: string
Read Only:
trueMaximum Length:30Indicates type of price break. -
PurchasingUomCode: string
Read Only:
trueMaximum Length:3Abbreviation that identifies the purchasing unit of measure associated with the purchase agreement. -
SupplierSite: string
Maximum Length:
30Abbreviation that indicates the specific supplier site from where the item is being sourced in buyer planning. -
UomCode: string
Maximum Length:
30Abbreviation that identifies the unit of measure associated to the order in buyer planning.
Response
- application/json
Default Response
-
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 doesn't specify this header in the request the server will pick a default version for the API.
object-
AgreementCurrencyCode: string
Read Only:
trueMaximum Length:30Abbreviation??that??identifies??the currency for the purchase agreement. -
AgreementEndDate: string
Read Only:
trueDate when the purcahse agreement expires. -
AgreementHeaderAmount: number
(double)
Read Only:
trueValue that identifies the amount agreed to for the planned or blanket purchase order. -
AgreementHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement. -
AgreementHeaderMinReleaseAmount: number
(double)
Read Only:
trueValue that identifies the minimum amount that can be released against the sum of all the PO line amounts. -
AgreementHeaderReleaseAmount: number
(double)
Read Only:
trueValue that identifies the amount released against this agreement. It's the sum of all the approved standard PO amounts. -
AgreementLineId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement line. -
AgreementNumber: string
Read Only:
trueMaximum Length:30Number that uniquely identifies the purchase agreement. -
AgreementStartDate: string
Read Only:
trueDate when the purcahse agreement goes into effect. -
ConfiguredItemFlag: string
Maximum Length:
1Indicates whether or not the item configured. The values can be Yes or No. If the value is Yes, then item is configured. -
CurrencyCode: string
Read Only:
trueMaximum Length:15Abbreviation??that??identifies??the currency for the order in buyer planning. -
DockDate: string
Date when the material should be on the receiving dock when the order is released.
-
ItemId: integer
(int64)
Value that uniquely identifies the item associated with the order in buyer planning.
-
ItemPrice: number
(double)
Read Only:
truePrice per unit offered for the quantity range. -
ItemRevisionCode: string
Maximum Length:
30Abbreviation that identifies the revision of the item on the purchase agreement. -
LineAgreementAmount: number
(double)
Read Only:
trueValue that identifies the amount agreed to for the planned or blanket purchase order line. -
LineAgreementQuantity: number
(double)
Read Only:
trueValue that identifies the total quanity of the item to be released against this agreement. It's the sum of all the approved standard PO line quantities. -
LineExpiryDate: string
Read Only:
trueDate when the agreement line expires. -
LineMinimumReleaseAmount: number
(double)
Read Only:
trueValue that identifies the minimum amount that can be released against the PO line. -
LineNumber: string
Read Only:
trueMaximum Length:30Number that identifies the purchase agreement line. -
LineReleaseAmount: number
(double)
Read Only:
trueValue that identifies the amount released against this agreement. It's the sum of all the approved standard PO amounts. -
LocationId: integer
(int64)
Value that uniquely identifies the location associated to the order in buyer planning.
-
MappedItemId: integer
(int64)
Value that uniquely identifies the mapped fusion item associated with the order in in buyer planning.
-
MappedOrganizationId: integer
(int64)
Value that uniquely identifies the mapped fusion organization associated with the order in buyer planning.
-
MappedSupplierId: integer
(int64)
Value that uniquely identifies the mapped fusion supplier from where the item is being sourced in buyer planning.
-
OrderQuantity: number
(double)
Value that identifies the order quantity in buyer planning.
-
OrderTotalPrice: number
(double)
Read Only:
trueValue that identifies the total price for order quantity in buyer planning. -
PoDiscount: number
(double)
Read Only:
trueValue that indicates the discount percent or amount of the purchase order line. -
PoDiscountType: string
Read Only:
trueMaximum Length:30Type of discount that indicates whether the discount is based on amount or percent. -
PoHeaderId: integer
(int64)
Value that uniquely identifies the purchase order in buyer planning.
-
PoIsNewPriceApplicable: string
Read Only:
trueMaximum Length:1Indicates whether or not the agreement price is applicable to the order. The values can be Y or N. If the value is Yes, then the agreement price can be applied to the purchase order. -
PoLineId: integer
(int64)
Value that uniquely identifies the purchase order line in buyer planning.
-
PriceBreakTypeCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the type of price break. -
PriceBreakTypeName: string
Read Only:
trueMaximum Length:30Indicates type of price break. -
PurchasingUomCode: string
Read Only:
trueMaximum Length:3Abbreviation that identifies the purchasing unit of measure associated with the purchase agreement. -
SupplierSite: string
Maximum Length:
30Abbreviation that indicates the specific supplier site from where the item is being sourced in buyer planning. -
UomCode: string
Maximum Length:
30Abbreviation that identifies the unit of measure associated to the order in buyer planning.
object-
EndDate: string
Read Only:
trueDate when the price break expires. -
LocationCode: string
Read Only:
trueMaximum Length:30Abbreviation??that??identifies??the location on a price break. -
LocationId: integer
(int64)
Read Only:
trueValue that uniquely identifies the location associated with the price break. -
MappedOrganizationId: integer
(int64)
Read Only:
trueValue that uniquely identifies the mapped fusion organization associated with the price break. -
OrganizationCode: string
Read Only:
trueMaximum Length:30Abbreviation that identifies the organization associated with the price break. -
Price: number
(double)
Read Only:
trueValue that identifies the break price for blanket purchase orders when a discount percent is applied. -
PriceBreakId: integer
(int64)
Read Only:
trueValue that uniquely identifies the price break. -
PriceDiscount: number
(double)
Read Only:
truePercentage reduction in the line price or the response price that the supplier can offer depending upon certain quantities, or locations in a price break. -
PurchaseAgreemenLineId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement line. -
PurchaseAgreementHeaderId: integer
(int64)
Read Only:
trueValue that uniquely identifies the purchase agreement. -
Quantity: number
(double)
Read Only:
trueQuantity needed to obtain the price break. -
StartDate: string
Read Only:
trueDate when the price break goes into effect.
Examples
This example describes how to get one price agreement for an order using a POST action.
Example cURL Command
Use the following cURL command to submit a request on the REST resource.
curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/buyerPlanningAgreements/buyerPlanningAgreements"
Example Request Body
The following example includes the contents of the request body in JSON format. You replace the request payload in the cURL command with the contents of the Example Request Body. The request payload specifies attribute values that the command will use in the record that it gets.
{
"DockDate":"2024-01-09",
"MappedSupplierId":"300100569163913",
"SupplierSite":"SpringField-S1",
"ItemId":"26563215",
"ItemRevisionCode":null,
"UomCode":"Ea",
"ConfiguredItemFlag":null,
"MappedOrganizationId":"300100569182010",
"OrderQuantity":200,
"MappedLocationId":null,
"PoHeaderId":null,
"PoLineId":null
}
Example Response Body
The following example includes the contents of the response body in JSON format:
{
"MappedSupplierId" : 300100569163913,
"SupplierSite" : "SpringField-S1",
"ItemId" : 26563215,
"MappedItemId" : 300100569156726,
"ItemPrice" : 127.8,
"ItemRevisionCode" : null,
"ConfiguredItemFlag" : null,
"UomCode" : "Ea",
"MappedOrganizationId" : 300100569182010,
"OrderQuantity" : 200,
"DockDate" : "2024-01-09",
"LocationId" : null,
"MappedLocationId" : null,
"CurrencyCode" : "USD",
"PoHeaderId" : null,
"PoLineId" : null,
"AgreementHeaderId" : 605277,
"AgreementLineId" : 584317,
"AgreementNumber" : "1002877",
"AgreementHeaderReleaseAmount" : 0,
"AgreementHeaderAmount" : 0,
"AgreementStartDate" : null,
"AgreementEndDate" : null,
"AgreementHeaderMinReleaseAmount" : 0,
"AgreementCurrencyCode" : "USD",
"LineNumber" : "43",
"LineMinimumReleaseAmount" : 92,
"LineReleaseAmount" : 0,
"LineAgreementQuantity" : 0,
"LineAgreementAmount" : 0,
"LineExpiryDate" : null,
"OrderTotalPrice" : 25560,
"PurchasingUomCode" : "Ea",
"PriceBreakTypeCode" : "NON CUMULATIVE",
"PriceBreakTypeName" : "Noncumulative",
"PoDiscountType" : null,
"PoDiscount" : 0,
"PoIsNewPriceApplicable" : null,
"UOMConversionRate" : 1,
"priceBreaks" : [ {
"PurchaseAgreementHeaderId" : 605277,
"PurchaseAgreemenLineId" : 584317,
"LocationId" : null,
"LocationCode" : null,
"MappedOrganizationId" : null,
"OrganizationCode" : null,
"PriceBreakId" : 531518,
"Quantity" : 40,
"PrimaryUOMQuantity" : 40,
"Price" : 127.8,
"PrimaryUOMPrice" : 127.8,
"PriceDiscount" : 10,
"StartDate" : null,
"EndDate" : null
} ]
}