文档中心 > API类目 > 天猫供应链

qimen.alibaba.dchain.aoxiang.itemmapping.update.callback (创建/更新商货品关联关系结果接口)

○ 接口12的回告接口，必接 ○ 商货关联新建&更新结果同步返回给ISV ○ 代表翱象将商货关联批量处理成功的结果返回给ISV ○ 阿里通过奇门回告ISV结果 ○ 翱象限制，翱象会根据ISV发起的原始请求记录数分批回告，如果ISV发起的创建/更新商货关联关系结果记录有N条，则会拆分成（N/100）次请求分批回告 ○ 调用场景：1、获取创建/更新商货品关联关系结果 ○ 针对结果同步接口异常的数据，需要ISV增加自动重试机制。失败的数据需要重试，最低次数不能低于5次，失败重试请求id不能与bizRequestId相同，否则会被幂等。 ○ QPS要求（日常）：每个ISV至少需要支持每秒200次的访问的，该值和创建/更新商货品关联接口的QPS对应，如果原始异步请求QPS限制增加，该QPS也需要增加。大促会在大促前给出和日常配比，如该接口降级则会通知ISV。

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
bizRequestId	String	必须	xxxxx		业务请求id
results	Results []	必须		最大列表长度：999999	结果列表
└ itemId String 必须 itemId001 商品id └ sellerId String 必须 sellerId001 卖家id └ bizMessage String 可选 SUCCESS 响应信息 └ success Boolean 必须 true true\|false └ bizCode String 可选 200 响应码 └ scItemId String 必须 scItemId001 ERP货品id └ skuId String 可选有SKU情况下必填；无SKU情况下为空有SKU情况下必填；无SKU情况下为空

响应参数

名称	类型	示例值	描述
result	String	1	0=全部接收失败，1=全部接收成功，2=部分接受成功
data	Data []		业务处理结果（如果出现result=2，则会返回错误信息, 一般是ISV一些前置的数据校验）
└ itemId String itemId001 商品id └ errCode String 200 异常码 └ errMsg String SUCCESS 异常信息 └ scItemId String scItemId001 ERP货品id └ skuId String skuId001 有SKU情况下必填；无SKU情况下为空
bizMessage	String	成功	响应信息
success	Boolean	true	true\|false
bizCode	String	200	响应码

请求示例

{"bizRequestId":"xxxxx","results":[{"itemId":"itemId001","sellerId":"sellerId001","bizMessage":"SUCCESS","success":true,"bizCode":"200","scItemId":"scItemId001","skuId":"有SKU情况下必填；无SKU情况下为空"}]}

响应示例

{
    "result":"1",
    "data":[
        {
                "itemId":"itemId001",
                "errCode":"200",
                "errMsg":"SUCCESS",
                "scItemId":"scItemId001",
                "skuId":"skuId001"
        }
    ],
    "bizMessage":"成功",
    "success":true,
    "bizCode":"200"
}

验签示例

{"bizMessage":"Illegal request","success":"false","bizCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案
isp.http-read-timeout

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

天猫供应链