FBA小型和轻型API v1参考

sfgoods 亚马逊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).
佣金	佣金 -推荐费.

FBA Inventory API v1 Feed Type Values

Amazon Selling Partner API - spapi.cyou