FBA入站资格认证API v1参考

亚马逊SPAPI

# 概述

通过FBA进货资格API,你可以建立一些应用程序,让卖家在向亚马逊的履约中心发货之前获得商品的资格预览.通过这个API,你可以发现一个商品是否有资格在特定的市场上向亚马逊的履约中心进货.你也可以发现一个商品是否有资格使用制造商的条形码进行FBA库存跟踪.卖家可以使用这些信息来告知他们决定哪些商品要向亚马逊的履约中心发货.

# Version information

版本 : v1

# Operations

getItemEligibilityPreview

# 路径

# getItemEligibilityPreview

GET /fba/inbound/v1/eligibility/itemPreview

# Description

这个操作获取你指定的项目的资格预览.你可以指定你想要的资格预览类型(INBOUND或COMMINGLING).对于INBOUND预览,你可以指定你想确定项目资格的市场.

使用计划:

速率(每秒的请求) 爆发
1 1

更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".

# Parameters

Type Name Description Schema
Query marketplaceIds
optional
您要确定资格的市场的标识符.仅在program=INBOUND.时需要
Max count : 1
< string > array
Query asin
required
你想进行资格预览的物品的ASIN. string
Query program
required
你想要检查资格的程序. enum (Program)

# Responses

HTTP Code Description Schema
200 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetItemEligibilityPreviewResponse

错误状态代码、描述和模式,见错误响应和模式.

# 错误响应和模式

该表包含HTTP状态代码和错误响应的相关信息.

HTTP Code Description Schema
400 Request有缺失或无效的参数,无法解析.
Headers
x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference ID.
GetItemEligibilityPreviewResponse
401 请求的授权头格式不正确或不包含有效的标记.

x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string):唯一的请求参考ID.
GetItemEligibilityPreviewResponse
403 403的原因可能是拒绝访问、未经授权、过期令牌、无效签名或未找到资源.
**头信息
x-amzn-RequestId (string):Unique request reference ID.
GetItemEligibilityPreviewResponse
404 指定的资源不存在.

x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference ID.
GetItemEligibilityPreviewResponse
429 请求的频率超过了允许的范围.

x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考ID.
GetItemEligibilityPreviewResponse
500 遇到了一个意外的情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考ID.
GetItemEligibilityPreviewResponse
503 服务器临时超载或维护.

x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考ID.
GetItemEligibilityPreviewResponse

# Definitions

## 定义

# GetItemEligibilityPreviewResponse

getItemEligibilityPreview操作的响应模式.

Name Description Schema
payload
optional
The payload for the getItemEligibilityPreview operation. ItemEligibilityPreview
errors
optional
在GetItemEligibilityPreview操作中发生了一个意外情况. ErrorList

# ItemEligibilityPreview

响应对象包含ASIN、市场名称(如果需要)、资格项目、资格状态(boolean),以及不合格原因代码列表.

Name Description Schema
asin
required
确定资格的ASIN. string
marketplaceId
optional
确定资格的市场. string
program
required
确定资格的计划. enum (Program
isEligibleForProgram
required
表示该项目是否有资格参加该计划. boolean
ineligibilityReasonList
optional
Potential Ineligibility Reason Codes. < enum (IneligibilityReasonList) > array

# ErrorList

当请求不成功时返回的错误响应列表.

类型 < Error > 数组

# Error

当请求不成功时返回的错误响应.

Name Description Schema
code
required
一个错误代码,用于识别所发生的错误类型. string
message
可选的
以人类可读的形式描述错误情况的信息. string
details
optional
可以帮助呼叫者理解或解决这个问题的额外信息. string

# IneligibilityReasonList

潜在的不符合条件的原因代码.

类型 : 枚举

Value Description
FBA_INB_0004 缺少包装尺寸.该产品缺少必要的信息;需要提供制造商的原始包装尺寸.
FBA_INB_0006 该产品的SKU未知或无法找到.
FBA_INB_0007 产品属于危险品(Hazmat)审查.我们没有足够的信息来确定该产品是什么或带有什么,使我们能够完成危险品审查.直到你提供必要的信息产品将无法销售,您也无法向亚马逊履约中心发送更多的单位. 您需要在产品列表中添加更多的细节,如清晰的标题、要点、描述和图片. 审查过程需要4个工作日.
FBA_INB_0008 危险品下的产品(Hazmat)审查.我们需要详细的电池信息来对产品进行正确分类,在您提供必要的信息之前,产品将无法销售,您也无法向亚马逊履约中心发送更多的单位.下载 "上传危险品文件 "中多语种的电池和电池-电源产品的豁免表安全数据表(SDS)或豁免表 "中下载,并按照说明在同一页面提交. 审查过程需要4个工作日.
FBA_INB_0009 危险品下的产品(Hazmat)审查.我们没有足够的危险品信息对产品进行正确分类,在您提供必要的信息之前,产品将无法销售,您也无法向亚马逊履约中心发送更多的单位.请通过 "上传危险品文件 "提供安全数据表(SDS)安全数据表(SDS)或豁免表 "在卖家中心提供,并确保安全数据表符合所有要求.审查过程需要4个工作日.
FBA_INB_0010 危险品下的产品(Hazmat)审查.危险品信息不匹配,所以产品无法正确分类.在您提供必要的信息之前,产品将无法销售,您也无法向亚马逊履约中心发送更多单位.请通过 "上传危险品文件 "提供合规文件安全数据表(SDS)或豁免表",并确保它符合所有的要求.审查过程需要4个工作日,在审查过程完成之前,产品将一直无法完成.
FBA_INB_0011 危险品下的产品(Hazmat)审查.我们有不完整、不准确或冲突的危险品信息,无法对产品进行正确分类.在您提供必要的信息之前,产品将无法销售,您将无法向亚马逊履约中心发送更多的单位.请通过 "上传危险品文件 "提供合规的文件安全数据表(SDS)或豁免表 "在卖家中心提供,并确保其符合所有要求.审查过程需要4个工作日,在审查过程完成之前,产品将一直无法完成.
FBA_INB_0012 危险品下的产品(Hazmat)审查.我们已经确定在产品详情页内或与该产品的其他报价存在冲突的产品信息(标题、要点、图片或产品描述)直到冲突信息得到纠正产品将无法销售,您将无法向亚马逊履行中心发送更多的单位. 我们需要您确认产品详情页上的信息 审核过程需要4个工作日.
FBA_INB_0013 危险品下的产品(Hazmat)审查.为了完成Hazmat审查过程,需要额外的信息.
FBA_INB_0014 危险品下的产品(Hazmat)审查.该产品已被确定为可能的危险品.审查过程一般需要4-7个工作日,在审查过程完成之前 产品是无法填写的,亚马逊履行中心无法接收,客户也无法订购.关于危险品的更多信息,请参见卖家中心的 "危险品识别指南(hazmat)"帮助页面.
FBA_INB_0015 危险品(Hazmat).该产品被规定为无法填写,不符合亚马逊的销售条件.我们要求你不要在新的货物中发送额外的单位.我们将需要根据亚马逊商业服务协议的条款处理你的危险品库存.如果你有问题或担忧请在本通知发出后的五个工作日内联系卖家支持. 有关危险品的更多信息,请参见卖家中心的 "危险品识别指南(hazmat)"帮助页面.
FBA_INB_0016 危险品(Hazmat).该产品被规定为可履行的危险品(Hazmat).您可能需要加入FBA危险品(Hazmat)计划才能销售您的产品.关于FBA危险品(Hazmat)计划的更多信息,请联系卖家支持. 关于危险品的更多信息,请参见卖家中心的 "危险品识别指南(Hazmat)"帮助页面.
FBA_INB_0017 该产品在目的地市场目录中不存在.在入库前需要提供必要的产品信息.
FBA_INB_0018 产品缺少类别.该产品必须有一个指定的类别才可以发往亚马逊.
FBA_INB_0019 该产品必须有一个标题才可以发送到亚马逊.
FBA_INB_0034 产品不能无贴纸、混装.此产品必须删除.您可以通过为此产品创建一个需要产品标签的新清单来发送新库存.
FBA_INB_0035 有效期-日期/批次-控制的产品需要贴标签.此产品需要贴标签才能在我们的执行中心收到.
FBA_INB_0036 过期-日期或批次-控制的产品需要混装.该产品不混装就不能运往亚马逊.该错误状况不能从这里纠正.该产品必须被移除.
FBA_INB_0037 该产品不符合运往我们履约中心的条件.您没有所有需要的税务文件.如果您已经提交了文件,请等待48小时,以便数据传播.
FBA_INB_0038 父ASIN不能由亚马逊履行.您可以通过创建一个针对子ASIN的列表来发送这个产品.
FBA_INB_0050 目前在目的地国家没有能够接收此产品的履行中心.如果您认为这是一个错误,请从货物中删除此产品或联系卖方支持.
FBA_INB_0051 该产品已被FBA封锁,目前无法发往亚马逊进行履约.
FBA_INB_0053 产品在目的地市场不符合条件.该产品不符合条件是因为所需的运输选项不可用或产品太大或太重.
FBA_INB_0055 由于媒体地区的限制,产品无法填写.该产品的地区代码在这个市场上受到限制.该产品必须被删除.
FBA_INB_0056 产品不符合进货条件.使用过的非-媒体商品不能运往亚马逊.
FBA_INB_0059 未知异常.该产品必须在此时删除.
FBA_INB_0065 产品不能无贴纸、混装.该产品必须被删除.您可以通过为该产品创建一个需要产品标签的新清单来发送新库存.
FBA_INB_0066 未知异常.该产品此时必须被删除.
FBA_INB_0067 产品不符合货运条件.该商品不符合我们全球货运服务的货运条件.该商品必须被删除.
FBA_INB_0068 账户未配置过期-日期或批次-控制的产品.如果您想配置您的账户以处理过期-日期或批次-控制的库存,请联系TAM.一旦配置,您将能够发送此产品.
FBA_INB_0095 该产品的条形码(UPC/EAN/JAN/ISBN)在我们的执行系统中与多个产品相关联.该产品必须被删除.您可以通过为该产品创建一个需要产品标签的新清单来发送新库存.
FBA_INB_0097 完全受监管的危险品.
FBA_INB_0098 商家未被授权将物品送往目的地市场.
FBA_INB_0099 卖家账户之前已经终止.
FBA_INB_0100 您没有必要的税务信息来发送库存到墨西哥的履行中心.
FBA_INB_0103 这是一个过期的-日期/批次-控制的产品,目前无法处理.
FBA_INB_0104 该产品需要制造商的条形码.只有新产品可以存放在我们的履行中心,没有产品标签.
FBA_INB_0197 该产品需要安全和合规文件.没有必要的安全和合规文件,该产品的订单不能由FBA履行.
UNKNOWN_INB_ERROR_CODE Unknown Ineligibility Reason.

# Program

类型 : 枚举

用于定义(s)ItemEligibilityPreview 确定资格的方案.

Value Description
INBOUND Inbound shipment.
COMMINGLING 使用制造商条码进行FBA库存追踪.

用于操作(s)getItemEligibilityPreview 你要检查资格的程序.

Value Description
INBOUND -
COMMINGLING -
Last Updated: 2022/10/16 下午10:27:34