注意:以下文档只适用于TOP接口,请谨慎使用!

千牛自助锁单功能

更新时间:2019/10/15 访问次数:18269

 自助锁单流程

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是否有收到请求。

详细步骤:

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

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

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

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

5、卡片触发操作。

6、使用买家账号操作。

 

 

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

 

 

常见问题

1ERP不能收到请求怎么办?

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

b:确认店铺nickERP是否绑定,按开发文档提交邮件后,当天会处理完绑定关系。

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

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

 

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

 

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

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

 

4、锁单锁多久,订单状态怎么变化?

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

 

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

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

FAQ

关于此文档暂时还没有FAQ
返回
顶部