# 概述
产品费用的销售伙伴API让你以编程方式检索产品的估计费用.然后你可以在你的定价中考虑这些费用.
# Version information
版本 : v0
# Operations
getMyFeesEstimateForSKU
getMyFeesEstimateForASIN
getMyFeesEstimates
<a name="paths">
# 路径
<a name="getmyfeesestimateforsku">
# getMyFeesEstimateForSKU
**POST /products/fees/v0/listings/{SellerSKU}/feesEstimate **
# Description
返回请求正文中指定的卖家SKU在市场上所表示的项目的估计费用.
你可以在销售伙伴设定项目价格之前，代表销售伙伴为项目调用getMyFeesEstimateForSKU.然后销售伙伴可以考虑任何估计费用.每个费用估计请求必须包括一个原始标识符.该标识符包括在费用估计中，以便你可以将费用估计与原始请求联系起来.
**注意：**标识符的值只是一个估计值，实际费用可能会有所不同.在Seller Central (opens new window)中搜索 "费用"，并查阅商店-具体的费用表，以获得最新的信息.
使用计划：
|速率(每秒的请求) |突发|的频率 | ---- | ---- | | 10 | 20 |
x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制（如果有的话）.上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息，见使用计划和速率限制在销售伙伴API (opens new window).
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | Request schema. | GetMyFeesEstimateRequest |
| Path | SellerSKU required | 用于识别给定市场中的物品. SellerSKU由卖方的SellerId限定，这个SellerId包含在你提交的每一个操作中. | string |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimateResponse |
| 400 | Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier. | GetMyFeesEstimateResponse |
| 401 | 请求的授权头格式不正确或不包含有效的标记. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimateResponse |
| 403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
| 404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimateResponse |
| 429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimateResponse |
| 500 | 发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
| 503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
<a name="getmyfeesestimateforasin">
# getMyFeesEstimateForASIN
**POST /products/fees/v0/items/{Asin}/feesEstimate **
# Description
返回在请求正文中指定的市场中由指定的ASIN指示的项目的估计费用.
你可以在销售伙伴设定项目价格之前，代表销售伙伴为项目调用`getMyFeesEstimateForASIN'.然后销售伙伴可以考虑估计费用.每个费用请求必须包括一个原始标识符.这个标识符包括在费用估计中，所以你可以将费用估计与原始请求联系起来.
**注意：**该标识符值只是一个估计值，实际费用可能会有所不同.在Seller Central (opens new window)中搜索 "费用"，并查阅商店-具体的费用表，以获得最新的信息.
使用计划：
| 速率(每秒的请求) | 爆发 |
|---|---|
| 10 | 20 |
x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制（如果有的话）.上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息，见使用计划和速率限制在销售伙伴API (opens new window).
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| Body | body required | Request schema. | GetMyFeesEstimateRequest |
| Path | Asin required | 亚马逊标准识别码(ASIN)的物品. | string |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimateResponse |
| 400 | Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier. | GetMyFeesEstimateResponse |
| 401 | 请求的授权头格式不正确或不包含有效的标记. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimateResponse |
| 403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
| 404 | 指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimateResponse |
| 429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimateResponse |
| 500 | 发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
| 503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识. | GetMyFeesEstimateResponse |
<a name="getmyfeesestimates">
# getMyFeesEstimates
POST /products/fees/v0/feesEstimates
# Description
返回一个产品列表的估计费用.
使用计划：
| Rate (requests per second) | Burst |
|---|---|
| 1 | 1 |
x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制（如果有的话）.上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息，见使用计划和速率限制在销售伙伴API (opens new window).
# Parameters
| Type | Name | Description | Schema |
|---|---|---|---|
| 体 | 体 必须的 | 要求提供产品清单的估计费用. | GetMyFeesEstimatesRequest |
# Responses
| HTTP Code | Description | Schema |
|---|---|---|
| 200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimatesResponse |
| 400 | Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier. | GetMyFeesEstimatesErrorList |
| 401 | 请求的授权头格式不正确或不包含有效的标记. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimatesErrorList |
| 403 | 表示禁止访问该资源.可能的原因包括拒绝访问，未经授权，过期的令牌，或无效的签名. 头 x-amzn-RequestId (string) : Unique request reference identifier. | GetMyFeesEstimatesErrorList |
| 404 | 指定的资源不存在. Headers: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier. | GetMyFeesEstimatesErrorList |
| 429 | 请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimatesErrorList |
| 500 | 发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作._注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimatesErrorList |
| 503 | 服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码，速率限制头已经过时，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符. | GetMyFeesEstimatesErrorList |
<a name="definitions">
# Definitions
<a name="getmyfeesestimaterequest">
# GetMyFeesEstimateRequest
请求模式.
| Name | Schema |
|---|---|
| FeesEstimateRequest optional | FeesEstimateRequest |
<a name="getmyfeesestimatesrequest">
# GetMyFeesEstimatesRequest
要求提供产品清单的估计费用.
类型: < FeesEstimateByIdRequest > 数组
<a name="fesestimatebyidrequest">
# FeesEstimateByIdRequest
一个产品、市场和建议的价格，用于请求估计费用.
| Name | Description | Schema |
|---|---|---|
| FeesEstimateRequest optional | - | FeesEstimateRequest |
| IdType required | 在 "FesEstimateByIdRequest "中使用的产品标识符类型. | IdType |
| IdValue required | 项目标识符. | string |
<a name="fesestimaterequest">
# FeesEstimateRequest
| Name | Description | Schema |
|---|---|---|
| MarketplaceId required | A marketplace identifier. | string |
| IsAmazonFulfilled optional | 为真时，该产品由亚马逊履行. | boolean |
| PriceToEstimateFees required | 费用估算所基于的产品价格. | PriceToEstimateFees |
| Identifier required | 由调用者提供的追踪此请求的唯一标识符. | string |
| OptionalFulfillmentProgram optional | 一个可选的注册程序，当报价由亚马逊履行时，返回估计费用(IAmazonFulfilled被设置为true). | OptionalFulfillmentProgram |
<a name="getmyfeesestimateresponse">
# GetMyFeesEstimateResponse
| Name | Description | Schema |
|---|---|---|
| payload optional | The payload for the operation. | GetMyFeesEstimateResult |
| errors optional | A list of error responses returned when a request is unsuccessful. | ErrorList |
<a name="getmyfeesestimateresult">
# GetMyFeesEstimateResult
响应模式.
| Name | Description | Schema |
|---|---|---|
| FeesEstimateResult optional | The item's estimated fees. | FeesEstimateResult |
<a name="getmyfeesestimatesresponse">
# GetMyFeesEstimatesResponse
一个产品列表的估计费用.
类型< FeesEstimateResult >数组
<a name="point">
# Points
| Name | Schema |
|---|---|
| PointsNumber optional | integer (int32) |
| PointsMonetaryValue optional | MoneyType |
<a name="getmyfeesestimateserrorlist">
# GetMyFeesEstimatesErrorList
当请求不成功时返回的错误响应列表.
| Name | Schema |
|---|---|
| errors required | < Error > array |
<a name="errorlist">
# ErrorList
当请求不成功时返回的错误响应列表.
类型 < Error > 数组
<a name="error">
# Error
| Name | Description | Schema |
|---|---|---|
| code required | 一个错误代码，用于识别所发生的错误类型. | string |
| message required | 一个描述错误情况的信息. | string |
| details optional | 可以帮助呼叫者理解或解决这个问题的额外信息. | string |
<a name="fesestimateresult">
# FeesEstimateResult
一个项目的标识符和项目的估计费用.
| Name | Description | Schema |
|---|---|---|
| Status optional | 收费请求的状态.可能的值成功，客户错误，服务错误. | string |
| 费用估算标识符 可选 | 用于识别费用估算请求的信息. | 费用估算标识符 |
| 费用估算 可选 | 某项费用的估算总额和细节清单. | 费用估算 |
| Error optional | 一个带有类型、代码和消息的错误对象. | FeesEstimateError |
<a name="fesestimateidentifier">
# FeesEstimateIdentifier
一个项目的标识符、市场、请求时间和其他细节，以确定一个估计._的身份
| Name | Description | Schema |
|---|---|---|
| MarketplaceId optional | A marketplace identifier. | string |
| *SellerId optional | The seller identifier. | string |
| IdType optional | 在 "FesEstimateByIdRequest "中使用的产品标识符的类型. | IdType |
| IdValue optional | 项目标识符. | string |
| IsAmazonFulfilled optional | 为真时，该商品由亚马逊履行. | boolean |
| PriceToEstimateFees optional | 费用估算所依据的物品价格. | PriceToEstimateFees |
| SellerInputIdentifier optional | 由调用者提供的用于跟踪此请求的唯一标识符. | string |
| OptionalFulfillmentProgram optional | 一个可选的注册程序，当报价由亚马逊履行时返回估计费用(IAmazonFulfilled被设置为true). | OptionalFulfillmentProgram |
<a name="pricetoestimatefees">
# PriceToEstimateFees
一个项目的价格信息，用于估计费用.
| Name | Description | Schema |
|---|---|---|
| ListingPrice required | The price of the item. | MoneyType |
| Shipping optional | The shipping cost. | MoneyType |
| Points optional | 购买商品时提供的亚马逊积分数量. | Points |
<a name="fesestimate">
# FeesEstimate
一个项目的估计费用总额和一个细节清单.
| Name | Description | Schema |
|---|---|---|
| TimeOfFeesEstimation required | 估计费用的时间.这默认为提出申请的时间. | string (date-time) |
| TotalFeesEstimate optional | 对于一个给定的项目、价格和执行渠道的估计费用总额. | MoneyType |
| FeeDetailList optional | A list of other fees that contribute to a given fee. | FeeDetailList |
<a name="feedetaillist">
# FeeDetailList
对某一费用有贡献的其他费用的列表.
类型< FeeDetail > 数组
<a name="fesestimateerror">
# FeesEstimateError
在此操作中发生了一个意外的错误.
| Name | Description | Schema |
|---|---|---|
| Type required | 一种错误类型，确定接收方或发送方为错误的发起人. | string |
| Code required | 一个错误代码，标识发生错误的类型. | string |
| Message required | 一个描述错误情况的信息. | string |
| Detail required | 可以帮助呼叫者理解或解决这个问题的额外信息. | FeesEstimateErrorDetail |
<a name="fesestimateerrordetail">
# FeesEstimateErrorDetail
可以帮助呼叫者理解或解决这个问题的额外信息.
类型 : <对象>数组
<a name="feedetail">
# FeeDetail
费用的类型，费用的数额，以及其他细节.
| Name | Description | Schema |
|---|---|---|
| FeeType required | 向卖方收取费用的类型. | string |
| FeeAmount required | 对某项费用收取的金额. | MoneyType |
| FeePromotion optional | 对给定费用的促销金额. | MoneyType |
| TaxAmount optional | 给定费用的税额. | MoneyType |
| FinalFee required | 给定费用的最终费用金额. | MoneyType |
| IncludedFeeDetailList optional | 对给定费用有贡献的其他费用清单. | IncludedFeeDetailList |
<a name="includedfeedetaillist">
# IncludedFeeDetailList
对某一费用有贡献的其他费用的列表.
类型< IncludedFeeDetail > 数组
<a name="includedfeedetail">
# IncludedFeeDetail
费用类型、费用金额和其他细节.
| Name | Description | Schema |
|---|---|---|
| FeeType required | 向卖方收取费用的类型. | string |
| *FeeAmount required | 对某项费用收取的金额. | MoneyType |
| FeePromotion optional | 对给定费用的促销金额. | MoneyType |
| TaxAmount optional | 给定费用的税额. | MoneyType |
| FinalFee required | 给定费用的最终费用金额. | MoneyType |
<a name="moneytype">
# MoneyType
| Name | Description | Schema |
|---|---|---|
| CurrencyCode optional | ISO 4217格式的货币代码. | string |
| 金额 可选择 | 货币价值. | 数字 |
<a name="optionalfulfillmentprogram">
# OptionalFulfillmentProgram
一个可选的注册程序，当报价由亚马逊履行时，返回估计费用(IsAmazonFulfilled被设置为true).
类型 : 枚举
| Value | Description |
|---|---|
| FBA_CORE | 返回报价的标准亚马逊履行费.这是默认的. |
| FBA_SNL | Returns the FBA Small and Light (SNL) fees for the offer. The SNL program offers reduced fulfillment costs on qualified items. To check item eligibility for the SNL program, use the getSmallAndLightEligibilityBySellerSKU operation of the FBA Small And Light API. |
| FBA_EFN | Returns the cross-border European Fulfillment Network fees across EU countries for the offer. |
<a name="idtype">
# IdType
在 "FesEstimateByIdRequest "中使用的产品标识符的类型.
类型 : 枚举
| Value | Description |
|---|---|
| ASIN | 一个亚马逊标准识别码(ASIN)的列表项目. |
| SellerSKU | 一个销售伙伴为一个亚马逊清单提供的标识符. |