Product Fees v0 Use Case Guide

AmazonSPAPI

# 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, etc).

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.

This operation allows up to 20 product requests in a single batch.

Important: The estimated fees returned by this API are not guaranteed. Actual fees may vary.

# Tutorial: Get product fees estimates by ASINs or SKUs

This tutorial demonstrates how to retrieve product fees for a set of SKUs.

# Prerequisites

To successfully complete this tutorial, you must have the following:

# Step 1. Call the getMyFeesEstimates operation

  1. Call the getMyFeesEstimate operation, passing the following parameters:

Body parameters

Name Description Schema
FeesEstimateRequest A product, marketplace, and proposed price used to request estimated fees. Type: FeesEstimateRequest
  1. Pass an array with up to 20 FeesEstimateRequest objects.

Request example

POST https://sellingpartnerapi-na.amazon.com/products/fees/v0/feesEstimate
[
  {
    "FeesEstimateRequest": {
      "MarketplaceId": "ATVPDKIKX0DER",
      "IsAmazonFulfilled": false,
      "PriceToEstimateFees": {
        "ListingPrice": {
          "CurrencyCode": "USD",
          "Amount": 12
        },
        "Shipping": {
          "CurrencyCode": "USD",
          "Amount": 2
        }
      },
      "Identifier": "SCSID1"
    },
    "IdType": "SellerSKU",
    "IdValue": "ZZZZZZZ"
  }
]
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

Response

Response properties:

Name Description
GetMyFeesEstimatesResponse Estimated fees for a list of products.
Type: array

# GetMyFeesEstimateResponse

Name Description Schema
Status The status of the fee request. Possible values: Success, ClientError, ServiceError string
FeesEstimateIdentifier Information used to identify a fees estimate request. FeesEstimateIdentifier

Response example:

{
  "Status": "Success",
  "FeesEstimateIdentifier": {
    "MarketplaceId": "ATVPDKIKX0DER",
    "IdType": "ASIN",
    "SellerId": "AXXXXXXXXXXXXX",
    "SellerInputIdentifier": "SCSID1",
    "IsAmazonFulfilled": false,
    "IdValue": "asin123",
    "PriceToEstimateFees": {
      "ListingPrice": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Shipping": {
        "CurrencyCode": "USD",
        "Amount": 10
      },
      "Points": {
        "PointsNumber": 0,
        "PointsMonetaryValue": {
          "CurrencyCode": "USD",
          "Amount": 0
        }
      }
    }
  }
}  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Step 2. Call the FeesEstimateRequest operation

Call the feesEstimateRequest operation, passing the following parameters:

Name Description Required
MarketplaceId A marketplace identifier.
Type: string
Yes
IsAmazonFulfilled When true, the offer is fulfilled by Amazon.
Type: boolean
No
PriceToEstimateFees The product price that the fee estimate is based on.
Type: PriceToEstimateFees
Yes
Identifier A unique identifier provided by the caller to track this request.
Type: string
Yes
IdType The type of product identifier used in a FeesEstimateByIdRequest.
Type: enum (ASIN or Seller SKU)
Yes
IdValue The item identifier.
Type: string
Yes

# PriceToEstimateFees

Name Description Required
ListingPrice The price of the item.
Type: string
Yes
Shipping The shipping cost.
Type: boolean
No
Points The number of Amazon Points offered with the purchase of an item.
Type: points
Yes

# FeesEstimateIdentifier

Name Description Required
MarketplaceId A marketplace identifier.
Type: string
Yes
IsAmazonFulfilled When true, the offer is fulfilled by Amazon.
Type: boolean
No
SellerId The seller identifier.
Type: string
No
SellerInputIdentifier A unique identifier provided by the caller to track this request.
Type: string
No
PriceToEstimateFees The product price that the fee estimate is based on.
Type: PriceToEstimateFees
Yes
Identifier A unique identifier provided by the caller to track this request.
Type: string
Yes
IdType The type of product identifier used in a FeesEstimateByIdRequest.
Type: enum (ASIN or Seller SKU)
Yes
IdValue The item identifier.
Type: string
Yes

# Fees Estimate

Name Description Required
TimeOfFeesEstimation The time at which the fees were estimated. This defaults to the time the request is made.
string (date-time)
Yes
TotalFeesEstimate Total estimated fees for a given item, price, and fulfillment channel.
Type: MoneyType
No
FeeDetailList A list of other fees that contribute to a given fee.
Type: FeeDetailList
No

# Points

Name Schema Required
PointsNumber Integer (int32) No
PointsMonetaryValue MoneyType No

# MoneyType

Name Schema Required
CurrencyCode Integer (int32) No
Amount MoneyType No
Last Updated: 10/11/2022, 9:45:34 PM