# 概述
FBA小而轻的销售伙伴API让您可以帮助卖家管理他们在小而轻计划中的清单.该计划降低了履行小而轻的FBA库存订单的成本.您可以从该计划中注册或删除项目,并检查项目资格和注册状态.您还可以预览卖家在注册该计划时销售的项目所收取的估计计划费用.
# Version information
版本 : v1
# Operations
getSmallAndLightEnrollmentBySellerSKU
putSmallAndLightEnrollmentBySellerSKU
deleteSmallAndLightEnrollmentBySellerSKU
getSmallAndLightEligibilityBySellerSKU
getSmallAndLightFeePreview
# 路径
# getSmallAndLightEnrollmentBySellerSKU
GET /fba/smallAndLight/v1/enrollments/{sellerSKU}
# Description
返回指定市场中指定卖家SKU所指示的项目的小型和轻型注册状态.
使用计划:
Rate (requests per second) | Burst |
---|---|
2 | 10 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | sellerSKU required | 标识物品的卖方SKU. | string |
Query | marketplaceIds required | 检索注册状态的市场. 注意:只接受一个市场. 最大计数 : 1 | < string > array |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | SmallAndLightEnrollment |
错误状态代码、描述和模式,见错误响应和模式.
# putSmallAndLightEnrollmentBySellerSKU
PUT /fba/smallAndLight/v1/enrollments/{sellerSKU}
# Description
将指定的卖方SKU所指示的物品纳入指定市场的小型和轻型计划.如果该物品不符合条件,则返回不符合条件的原因.
使用计划:
速率(每秒的请求) | 突发 |
---|---|
2 | 5 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | sellerSKU required | 标识物品的卖方SKU. | string |
Query | marketplaceIds required | 注册物品的市场.注意:只接受一个市场. Max count : 1 | < string > array |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | SmallAndLightEnrollment |
关于错误状态代码、描述和模式,见错误响应和模式.
# deleteSmallAndLightEnrollmentBySellerSKU
delete /fba/smallAndLight/v1/enrollments/{sellerSKU}
# Description
将指定的卖家SKU所指示的物品从指定的市场中的小型和轻型项目中移除.如果该物品不符合取消注册的条件,将返回不符合条件的原因.
使用计划:
速率(每秒的请求) | 突发 |
---|---|
2 | 5 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | sellerSKU required | 标识物品的卖方SKU. | string |
Query | marketplaceIds required | 从小型和轻型项目中移除物品的市场.注意:只接受单一市场. 最大计数 : 1 | < string > array |
# Responses
HTTP Code | Description | Schema |
---|---|---|
204 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) x-amzn-RequestId (string) : 独特的请求参考标识符. | No Content |
错误状态代码、描述和模式,见错误响应和模式.
# getSmallAndLightEligibilityBySellerSKU
GET /fba/smallAndLight/v1/eligibilities/{sellerSKU}
# Description
返回指定市场中指定卖方SKU所指示的物品的小而轻项目资格状态.如果该物品不符合资格,则返回不符合资格的原因.
使用计划:
速率(每秒的请求) | 突发 |
---|---|
2 | 10 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema |
---|---|---|---|
Path | sellerSKU required | 标识物品的卖方SKU. | string |
Query | marketplaceIds required | 检索资格状态的市场.注意:只接受一个市场. Max count : 1 | <字符串>数组 |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | SmallAndLightEligibility |
错误状态代码、描述和模式,见错误响应和模式.
# getSmallAndLightFeePreview
POST /fba/smallAndLight/v1/feePreviews
# Description
返回指定项目的小型和轻型费用估计.你必须包括一个marketplaceId参数,以检索在该市场销售的项目的适当费用估计.响应中的项目排序将反映请求中的项目顺序.重复的ASIN/价格组合被删除.
使用计划:
速率(每秒的请求) | 突发 |
---|---|
1 | 3 |
更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".
# Parameters
Type | Name | Description | Schema |
---|---|---|---|
体 | 体 必填 | 提交检索费用估算的项目的请求模式. | SmallAndLightFeePreviewRequest |
# Responses
HTTP Code | Description | Schema |
---|---|---|
200 | Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier. | SmallAndLightFeePreviews |
错误状态代码、描述和模式,见错误反应和模式.
# 错误响应和模式
该表包含HTTP状态代码和错误响应的相关信息.
HTTP Code | Description | Schema |
---|---|---|
400 | Request有缺失或无效的参数,无法解析. Headers x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
401 | 请求的授权头格式不正确或不包含有效的令牌. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码,速率限制头已经过时,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
403 | 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. **头信息 x-amzn-RequestId (string):Unique request reference identifier. | ErrorList |
404 | 指定的资源不存在. 头信息 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
413 | 请求的大小超过了可接受的最大大小. **头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
415 | 请求的有效载荷是不支持的格式. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
429 | 请求的频率超过了允许的范围. 标题 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已经过时,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
500 | 发生了一个意外情况,使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)对于这个操作._注意 _对于这个状态代码,速率限制头已被废弃,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
503 | 服务器的临时超载或维护. 头信息 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作._注意 _对于这个状态代码,速率限制头已经过时,不再返回. x-amzn-RequestId (string):唯一的请求参考标识符. | ErrorList |
# Definitions
# MarketplaceId
一个市场的标识符.
类型:字符串
# SellerSKU
识别给定市场中的物品. SellerSKU 由卖家的SellerId限定,它包括在你提交的每个操作中.
类型:字符串
# Error
当请求不成功时返回的错误响应.
Name | Description | Schema |
---|---|---|
code required | 一个错误代码,用于识别所发生的错误类型. | string |
message required | 一个以人类可读的形式描述错误情况的信息. | string |
details optional | 可以帮助呼叫者理解或解决这个问题的额外信息. | string |
# ErrorList
当一个请求不成功时返回的错误响应列表.
Name | Schema |
---|---|
errors optional | < Error > array |
# SmallAndLightEnrollmentStatus
该项目的小型和轻型注册状态.
类型 : 枚举
Value | Description |
---|---|
ENROLLED | 小型和轻型的注册状态是已注册. |
NOT_ENROLLED | 小型和轻型的注册状态为未注册. |
# SmallAndLightEligibilityStatus
该物品的小型和轻型资格状态.
类型 : 枚举
Value | Description |
---|---|
ELIGIBLE | 小型和轻型资格状态是合格的. |
NOT_ELIGIBLE | 小而轻的资格状态是不合格的. |
# SmallAndLightEnrollment
指定卖家SKU.所表示的物品的小而轻的注册状态
Name | Description | Schema |
---|---|---|
marketplaceId required | A marketplace identifier. | MarketplaceId |
sellerSKU required | 在给定的市场中识别一个物品. SellerSKU由卖家的SellerId限定,它包括在您提交的每个操作中. | SellerSKU |
status required | 物品的小型和轻型注册状态. | SmallAndLightEnrollmentStatus |
# SmallAndLightEligibility
指定卖家SKU.所表示的物品的小而轻资格状态
Name | Description | Schema |
---|---|---|
marketplaceId required | A marketplace identifier. | MarketplaceId |
sellerSKU required | 在给定的市场中识别一个物品. SellerSKU由卖家的SellerId限定,它包括在您提交的每个操作中. | SellerSKU |
status required | 物品的小型和轻型资格状态. | SmallAndLightEligibilityStatus |
# SmallAndLightFeePreviewRequest
用于提交检索费用估算的项目的请求模式.
Name | Description | Schema |
---|---|---|
marketplaceId required | A marketplace identifier. | MarketplaceId |
items required | A list of items for which to retrieve fee estimates (limit: 25). | < Item> array |
# SmallAndLightFeePreviews
Name | Description | Schema |
---|---|---|
data optional | 所请求的项目的费用估计列表.费用估计的顺序将遵循与请求中的项目相同的顺序,并删除重复的部分. | < FeePreview >数组 |
# Item
一个要出售的物品.
Name | Description | Schema |
---|---|---|
asin required | 亚马逊标准识别码(ASIN)用于识别该商品的值. | string |
price required | 卖家计划对该物品收取的价格. | MoneyType |
# FeePreview
某一特定项目的费用估计.
Name | Description | Schema |
---|---|---|
asin optional | 亚马逊标准识别码(ASIN)用于识别该商品的数值. | string |
price optional | 卖家计划对该商品收取的价格. | MoneyType |
feeBreakdown optional | A list of the Small and Light fees for the item. | < FeeLineItem> array |
totalFees optional | 如果该物品参加了小型和轻型项目,所收取的总费用. | MoneyType |
errors optional | 在getSmallAndLightFeePreview操作中发生了一个或多个意外的错误. | < Error> array |
# FeeLineItem
一个特定费用的详细情况.
Name | Description | Schema |
---|---|---|
feeType required | 向卖方收取的费用类型. | enum (FeeType) |
feeCharge required | 向卖方收取特定费用类型的金额. | MoneyType |
# MoneyType
Name | Description | Schema |
---|---|---|
currencyCode optional | ISO4217格式的货币代码. | string |
amount optional | 货币价值. | number |
# FeeType
向卖方收取的费用的类型.
类型 : 枚举
Value | Description |
---|---|
FBAWeightBasedFee | FBA重量费-基础费用(重量处理). |
FBAPerOrderFulfillmentFee | FBA每个订单的履行费用(订单处理). |
FBAPerUnitFulfillmentFee | FBA履行费用(Pick & Pack). |
佣金 | 佣金 -推荐费. |