产品费用API v0参考

亚马逊SPAPI

# 概述

产品费用的销售伙伴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 一个销售伙伴为一个亚马逊清单提供的标识符.
Last Updated: 2022/10/17 下午9:17:02