Product Fees v0 Use Case Guide
How to use the Product Fees API.
API Version: v0
What is the Product Fees API?
The Product Fees API retrieves product fees for multiple products. You can use the getMyFeesEstimates
operation to get product fee estimates for a list of products and marketplaces, and then set prices based on those fee estimates. You must specify your products by ASIN or SKU (not UPC, ISBN, or other identifiers).
You must include an original identifier in each product fees request. This identifier is included in the fees estimate so that you can correlate a fees estimate with an original request.
Important
The estimated fees returned by this API are not guaranteed. Actual fees can vary.
Prerequisites
To successfully complete this tutorial, you must have the following:
- Authorization from the selling partner for whom you are making calls. Refer to Authorizing Selling Partner API Applications for more information.
- The Pricing and Product Listing role assigned to your developer profile.
- The Pricing and Product Listing role selected in the App registration page for your application.
Tutorial 1: Get product fee estimates for a specific SKU
This tutorial demonstrates how to retrieve product fees for a SKU.
Call getMyFeesEstimateForSKU
to retrieve fee estimates for an item
getMyFeesEstimateForSKU
to retrieve fee estimates for an itemYou can call the getMyFeesEstimateForSKU
operation for an item on behalf of a selling partner before the selling partner sets the item's price. This operation accepts a SKU as a path parameter.
Path parameters
Name | Description | Schema |
---|---|---|
SellerSKU |
Used to identify an item in a given marketplace. SellerSKU is qualified by the seller's SellerId , which is included with every operation that you submit.
|
Type: string |
Body parameters
Name | Description | Schema |
---|---|---|
body |
The request body schema for the getMyFeesEstimateForSKU operation. |
Type: GetMyFeesEstimateRequest |
Request example:
POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/listings/UmaS1/feesEstimate
{
"FeesEstimateRequest": {
"MarketplaceId": "ATVPDKIKX0DER",
"IsAmazonFulfilled": false,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
},
"Identifier": "UmaS1"
}
}
Response
A successful response includes the following:
{
"FeesEstimateResult": {
"Status": "Success",
"FeesEstimateIdentifier": {
"MarketplaceId": "ATVPDKIKX0DER",
"IdType": "SellerSKU",
"SellerId": "AXXXXXXXXXXXXX",
"SellerInputIdentifier": "UmaS1",
"IsAmazonFulfilled": false,
"IdValue": "UmaS1",
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
}
},
"FeesEstimate": {
"TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
"TotalFeesEstimate": {
"CurrencyCode": "USD",
"Amount": 3.0
},
"FeeDetailList": [
{
"FeeType": "PerItemFee",
"FeeAmount": {
"CurrencyCode": "USD",
"Amount": 0.0
},
"FinalFee": {
"CurrencyCode": "USD",
"Amount": 0.0
},
"FeePromotion": {
"CurrencyCode": "USD",
"Amount": 0.0
}
}
]
},
"Error": {
"Type": "",
"Code": "",
"Message": "",
"Detail": []
}
}
}
Tutorial 2: Get product fee estimates for a specific ASIN
This tutorial demonstrates how to retrieve product fees for an ASIN.
Call the getMyFeesEstimateForASIN
operation to retrieve fee estimates for an item
getMyFeesEstimateForASIN
operation to retrieve fee estimates for an itemYou can call the getMyFeesEstimateForASIN
operation for an item on behalf of a selling partner before the selling partner sets the item's price. This operation accepts an ASIN as a path parameter.
Path parameters
Name | Description | Schema |
---|---|---|
ASIN |
The Amazon Standard Identification Number (ASIN) of the item. | Type: string |
Body parameters
Name | Description | Schema |
---|---|---|
body |
The request body schema for the getMyFeesEstimateForASIN operation. |
Type: GetMyFeesEstimateRequest |
Request example:
POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/items/UmaS1/feesEstimate
{
"FeesEstimateRequest": {
"MarketplaceId": "ATVPDKIKX0DER",
"IsAmazonFulfilled": false,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
},
"Identifier": "UmaS1"
}
}
Response
A successful response includes the following:
{
"FeesEstimateResult": {
"Status": "Success",
"FeesEstimateIdentifier": {
"MarketplaceId": "ATVPDKIKX0DER",
"IdType": "ASIN",
"SellerId": "AXXXXXXXXXXXXX",
"SellerInputIdentifier": "UmaS1",
"IsAmazonFulfilled": false,
"IdValue": "B00V5DG6IQ",
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
}
},
"FeesEstimate": {
"TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
"TotalFeesEstimate": {
"CurrencyCode": "USD",
"Amount": 3
},
"FeeDetailList": [
{
"FeeType": "PerItemFee",
"FeeAmount": {
"CurrencyCode": "USD",
"Amount": 0
},
"FinalFee": {
"CurrencyCode": "USD",
"Amount": 0
},
"FeePromotion": {
"CurrencyCode": "USD",
"Amount": 0
}
}
]
},
"Error": {
"Type": "",
"Code": "",
"Message": "",
"Detail": []
}
}
}
Tutorial 3: Get product fees for a batched set of up to 20 items
This tutorial demonstrates how to retrieve product fees for a set of up to 20 SKUs or ASINs.
Step 1. Create an array of FeesEstimateByIdRequest
objects
FeesEstimateByIdRequest
objectsThe getMyFeesEstimates
operation allows up to 20 product requests in a single batch. In order to send 20 requests in one API call, you must create an array with up to 20 FeesEstimateByIdRequest
objects.
Example of an array of FeesEstimateByIdRequest
objects:
[
{
"FeesEstimateRequest": {
"MarketplaceId": "ATVPDKIKX0DER",
"IsAmazonFulfilled": false,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
},
"Identifier": "UmaS1"
},
"IdType": "ASIN",
"IdValue": "asin123"
},
{
"FeesEstimateRequest": {
"MarketplaceId": "A1AM78C64UM0Y8",
"IsAmazonFulfilled": true,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "MXN",
"Amount": 0
}
}
},
"Identifier": "UmaS2"
},
"IdType": "SellerSKU",
"IdValue": "sku123"
},
...
]
Step 2. Call the getMyFeesEstimates
operation
getMyFeesEstimates
operationCall the getMyFeesEstimates
operation, passing the following parameters:
Body parameters
Name | Description | Schema |
---|---|---|
FeesEstimateRequest |
A product, marketplace, and proposed price used to request estimated fees. | Type: FeesEstimateRequest |
Request example
POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
{
"FeesEstimateRequest": {
"MarketplaceId": "ATVPDKIKX0DER",
"IsAmazonFulfilled": false,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
},
"Identifier": "UmaS1"
},
"IdType": "ASIN",
"IdValue": "asin123"
},
{
"FeesEstimateRequest": {
"MarketplaceId": "A1AM78C64UM0Y8",
"IsAmazonFulfilled": true,
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "MXN",
"Amount": 0
}
}
},
"Identifier": "UmaS2"
},
"IdType": "SellerSKU",
"IdValue": "sku123"
}
]
Response
A successful response includes the following:
Name | Description | Schema |
---|---|---|
GetMyFeesEstimatesResponse |
Estimated fees for a list of products.
Type: array |
Type: GetMyFeesEstimatesResponse |
Response example:
{
"Status": "Success",
"FeesEstimateIdentifier": {
"MarketplaceId": "ATVPDKIKX0DER",
"IdType": "ASIN",
"SellerId": "AXXXXXXXXXXXXX",
"SellerInputIdentifier": "UmaS1",
"IsAmazonFulfilled": false,
"IdValue": "asin123",
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "USD",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "USD",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "USD",
"Amount": 0
}
}
}
},
"FeesEstimate": {
"TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
"TotalFeesEstimate": {
"CurrencyCode": "USD",
"Amount": 3.0
},
"FeeDetailList": []
},
"Error": {
"Type": "",
"Code": "",
"Message": "",
"Detail": []
}
},
{
"Status": "Success",
"FeesEstimateIdentifier": {
"MarketplaceId": "A1AM78C64UM0Y8",
"IdType": "SellerSKU",
"SellerId": "AXXXXXXXXXXXXX",
"SellerInputIdentifier": "UmaS2",
"IsAmazonFulfilled": false,
"IdValue": "sku123",
"PriceToEstimateFees": {
"ListingPrice": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Shipping": {
"CurrencyCode": "MXN",
"Amount": 10
},
"Points": {
"PointsNumber": 0,
"PointsMonetaryValue": {
"CurrencyCode": "MXN",
"Amount": 0
}
}
}
},
"FeesEstimate": {
"TimeOfFeesEstimation": "Mon Oct 28 18:49:32 UTC 2019",
"TotalFeesEstimate": {
"CurrencyCode": "MXN",
"Amount": 3.0
},
"FeeDetailList": []
},
"Error": {
"Type": "",
"Code": "",
"Message": "",
"Detail": []
}
}
Updated 4 months ago