千牛自助锁单功能

更新时间：2019/11/10 访问次数：47314

常见问题

自助锁单流程

ERP对接流程说明：

1、获取奇门场景权限。ERP接入前需要添加对应接口权限，需要ERP提供应用开发的AppKey，点击此处填写信息申请。若无appkey，请参考服务发布流程：点击查看。

2、奇门配置。添加权限后,ERP登录奇门配置后台进行接口配置。

https://qimen.taobao.com/#/?_k=f503wc ,选择左侧官方服务集成，可以关联官方场景，如下图已经进行了场景关联后的情况。添加关联官方场景，在已经得到授权后可以看到‘自助锁单’奇门官方场景，具体详细操作文档见奇门的对外官方文档：

//open.taobao.com/doc.htm?docId=106849&docType=1

以下是ERP对接中非常常见问题请仔细阅读：

其中有一个非常常见的错误是缺少路由信息，请检查授权配置页面是否有对应的授权调用信息，没有的话需要增加调用发起方AppKey对应的授权配置
并且验证‘配置奇门’授权里目标URL是否对应自己实现的服务接口地址
自测完成上线后，需要给官方AppKey调用授权，官方AppKey是23647480，这个是平台请求锁单的发起应用方，没有授权的情况下，平台这边也无法调用ERP的接口，平台一调用会出现‘找不到目标路由地址错误信息。

详细流程步骤如下：

第一步：

第二步：

第三步：

第四步：

第五步：

第六步

第七步

3、商家与ERP绑定。上述操作功能完成后，可以提交商家主账号+AppKey的方式，给到平台，平台给你开通对应商家的自助锁单功能。

4、奇门开发者问题可以提交工单寻求帮助，点此提交

由于双十一订单同步到erp系统有延时改成异步方案

二、自助锁单，奇门官方场景接口

接口名：taobao.qianniu.cloudkefu.order.self.intercept

接口文档：https://open.taobao.com/api.htm?docId=39568&docType=2

API入参

名称	参数类型/SDK类型	是否必须	文档可见	示例值	描述
sellerNick	String	必须	是	苏宁易购官方旗舰店	店铺主账号
buyerNick	String	必须	是	翔_ouyang	买家账号名
bizOrder	BizOrder	必须	是		订单信息
└ tid	String	必须	是	30753531820144197	主订单ID
└ subOrderIds	String	必须	是	30753531820144191,30753531820144192,30753531820144193	子订单列表，逗号分隔
callType	String	必须	是	synchronous	synchronous同步asynchronous异步

示例如：

{

"sellerNick": "苏宁易购官方旗舰店",

"buyerNick": "翔_ouyang",

"bizOrder": {

"tid": "30753531820144197",

"subOrderIds": "30753531820144191,30753531820144192,30753531820144193"

"callType": "synchronous"

}

API出参（注：如果是异步截单方案结果通过下面“截单结果回传接口”回传）

错误码	errorcode	错误描述（发消息给买家）	实际错误（不对外显示）
HAD_SHIPPED	1001	订单已安排发货拦截失败,请联系商家处理	订单已发货拦截失败
HAD_IN_STORE	1002	订单已安排发货拦截失败,请联系商家处理	订单已经入库无法修改，拦截失败
HAD_DISTRIBUTION	1003	订单已安排发货货拦截失败,请联系商家处理	订单已配货无法修改，拦截失败
HAD_PICKED	1004	订单已拣货订单已安排发货	订单已拣货无法修改，拦截失败
HAD_OUT_STORE	1005	订单已安排发货拦截失败,请联系商家处理	订单已出库无法修改，拦截失败
ON_THE_WAY	1006	订单已安排发货拦截失败,请联系商家处理	订单已寄出无法修改，拦截失败
INVENTORY_OCCUPANCY	1007	库存占用拦截失败,请联系商家处理	订单库存占用失败，拦截失败
NO_ORDER_INFO	1008	未获取订单信息拦截失败,请联系商家处理	订单信息获取失败，拦截失败
INFO_EORROR	1100	填写信息有误,请联系商家处理	拦截信息填写错误，拦截失败
RESULT_NULL	1101	处理返回失败,请联系商家处理	处理异常，拦截失败
NO_IN_WHITE_LIST	1102	商家功能过期，请联系商家处理	商家没有开通此功能，拦截失败
UNKNOWN_ERROR	1103	异常情况，请联系商家处理	其他异常情况，拦截失败
QIMEN_INNER_ERROR	1104	连接异常情况，请联系商家处理	奇门平台连接异常，拦截失败
SECURITY_PROBLEM	1105	系统异常情况，请联系商家处理	安全平台处理异常，拦截失败
INTERCEPT_ORDER_TIMEOUT	1106	订单处理超时，请联系商家处理	截单超时

官方实现Sample，仅供参考：

CheckResult checkResult = SpiUtils.checkSign(request, targetAppSecret);

在安全层面，ERP在实现接口的时候必须进行签名校验，校验利用奇门的SpiUtils工具类来实现，并且校验失败必须按如下数据返回：签名失败的errorCode必须是sign-check-failure，errorMsg必须是Illegal request，这个奇门平台要求的返回。

{

"result": {

"success": false,

"errorCode": "sign-check-failure",

"errorMsg": "Illegal request"

}

三、异步的截单结果回传接口

1、top接口名称：taobao.gearfactory.intercept.order.callback （//open.taobao.com/api.htm?docId=40680&docType=2）ERP接入前需要添加对应接口权限，需要ERP提供应用开发的AppKey，点击此处申请，若已填写则等待开通即可。

2、请求参数（与top开发平台文档不符以此为准）

名称	类型	必须	示例值	描述
error_code	String	否，success为false时必传	1001	errorCode如下
success	Boolean	是	false	是否截单成功，true：成功，false：失败
tid	String	是	123456789	主订单id
sub_order_ids	String[]	是	["965456789","98765456789"]	截单的子订单id列表
sellerId	Long	是	false	卖家id

errorCode(与top开发平台文档不符以此为准)如下：

错误码	errorcode	错误描述（发消息给买家）	实际错误（不对外显示）
HAD_SHIPPED	1001	订单已安排发货拦截失败,请联系商家处理	订单已发货拦截失败
HAD_IN_STORE	1002	订单已安排发货拦截失败,请联系商家处理	订单已经入库无法修改，拦截失败
HAD_DISTRIBUTION	1003	订单已安排发货货拦截失败,请联系商家处理	订单已配货无法修改，拦截失败
HAD_PICKED	1004	订单已拣货订单已安排发货	订单已拣货无法修改，拦截失败
HAD_OUT_STORE	1005	订单已安排发货拦截失败,请联系商家处理	订单已出库无法修改，拦截失败
ON_THE_WAY	1006	订单已安排发货拦截失败,请联系商家处理	订单已寄出无法修改，拦截失败
INVENTORY_OCCUPANCY	1007	库存占用拦截失败,请联系商家处理	订单库存占用失败，拦截失败
NO_ORDER_INFO	1008	未获取订单信息拦截失败,请联系商家处理	订单信息获取失败，拦截失败
INFO_EORROR	1100	填写信息有误,请联系商家处理	拦截信息填写错误，拦截失败
RESULT_NULL	1101	处理返回失败,请联系商家处理	处理异常，拦截失败
NO_IN_WHITE_LIST	1102	商家功能过期，请联系商家处理	商家没有开通此功能，拦截失败
UNKNOWN_ERROR	1103	异常情况，请联系商家处理	其他异常情况，拦截失败
QIMEN_INNER_ERROR	1104	连接异常情况，请联系商家处理	奇门平台连接异常，拦截失败
SECURITY_PROBLEM	1105	系统异常情况，请联系商家处理	安全平台处理异常，拦截失败
INTERCEPT_ORDER_TIMEOUT	1106	订单处理超时，请联系商家处理	截单超时

2.回调接口返回参数：

名称	类型	必须	实例值	描述
result
└ error_code	String			错误码："4001":"参数无效", "4002":"截单信息不存在", "4003":"erp截单超时", "4004":"服务不可用", "4005":"需要商家授权"
└ error_msg	String			见error_code
└ success	boolean	必须		成功标识，true：成功，false：失败

ERP自测流程（也是商家开通使用流程）

1、确保ERP已经根据本开发文档开发完成。

2、将所在ERP所涵盖的所有店铺NICK通过附件形式发送至邮箱，包含天猫和淘宝：

ERP_qianniu@service.tmall.com（ERP对接方发，商家不要发，发送是所有商家名单，不单单只是要用锁单的商家名单）邮箱主题改成：ERP名称+appkey+授权商家数量

附件参考群文件：《ERP发送邮箱模板》，邮件主题以及附件名务必改成 ERP名称+appkey +授权商家数形式，不然后续无法进行测试和正式使用。

3、选择其中一家店铺作为测试账号授权开通自助锁单功能。详见：https://kehufuwu.bbs.taobao.com/detail.html?spm=a219a.7386653.0.0.2368669a42AnCC&postId=9315355 【第三阶段，启用功能】该链接可以给到商家宣传使用。

4、使用买家账号购买测试店铺商品进行下单，然后在千牛聊天窗口智能客服插件中发送卡片，具体第三条开通方法中也有介绍。

5、买家操作完卡片后，查看ERP是否有收到请求。

6、重要：测试商品必须是“其他”类目。

详细步骤：

1、商家开通功能,点击开通。

2、使用买家账号购买店铺商品生成订单。

3、使用店小蜜接待触发卡片，点击查看。

4、人工客服接待场景触发卡片，需要下载千牛最新版并开通智能客服插件，详细操作步骤请点击查看。

5、卡片触发操作。

6、使用买家账号操作。

7、看下ERP是否收到请求，然后进行自查。

常见问题

1、ERP不能收到请求怎么办？

a：确认按照开发文档完成奇门配置。

b：确认店铺nick和ERP是否绑定，按开发文档提交邮件后，当天会处理完绑定关系。

c：确认商家开通功能，并下发卡片，消费者选择完意向商品并确认。

以上三点必须全部确认完，再提高appkey、店铺nick、订单号给到小二排查。

2、自动锁单是否都使用异步方案，异步调用超时时间多久？
全部用异步方案，1分钟内需要返回请求。双11期间时间会延长至6小时。

3、锁单是锁主订单还是子订单？

平台会传主订单和子订单明细，ERP需要向商家提供锁主订单或者子订单的选择、批量解锁能力，由商家选择使用。

4、锁单锁多久，订单状态怎么变化？

订单状态不会有任何变化，平台会提示消费者12号进行退款，若消费者12号后没有申请退款，ERP里需要提示商家跟消费者确认退款操作。

5、消费者是否可以取消锁单？

一旦申请确认后，无法线上取消，需要联系客服处理。

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问