Product Fees v0 Use Case Guide

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, 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.

Important: The estimated fees returned by this API are not guaranteed. Actual fees may 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 the Selling Partner API Developer Guide 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 fees estimates for a specific SKU

This tutorial demonstrates how to retrieve product fees for a SKU.

Step 1. Retrieve the fee estimates for an item

You 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 fees estimates for a specific ASIN

This tutorial demonstrates how to retrieve product fees for an ASIN.

Step 1. Retrieve the fee estimates for an item

You 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

The 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

Call 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": []
  }
}