FBA小型和轻型API v1参考

亚马逊SPAPI

# 概述

FBA小而轻的销售伙伴API让您可以帮助卖家管理他们在小而轻计划中的清单.该计划降低了履行小而轻的FBA库存订单的成本.您可以从该计划中注册或删除项目,并检查项目资格和注册状态.您还可以预览卖家在注册该计划时销售的项目所收取的估计计划费用.

# Version information

版本 : v1

# Operations

getSmallAndLightEnrollmentBySellerSKU
putSmallAndLightEnrollmentBySellerSKU
deleteSmallAndLightEnrollmentBySellerSKU
getSmallAndLightEligibilityBySellerSKU
getSmallAndLightFeePreview

# 路径

## Paths

# 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).
佣金 佣金 -推荐费.