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

千牛自助锁单功能

更新时间:2018/10/29 访问次数:4234

一、项目背景

大促、活动期间由于客服人力有限导致无法承接很多消费者拍下后立马申请退款的诉求。先开启直联后台订单处理系统(erp)通道通知商家订单处理系统(erp)买家拍错需要冻结不发货的需求,节省大量客服沟通效率,提升订单处理系统(erp)使用效率,降低人力成本。

自助截单异步改造流程

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

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

  • 其中有一个非常常见的错误是缺少路由信息,请检查授权配置页面是否有对应的授权调用信息,没有的话需要增加调用发起方AppKey对应的授权配置
  • 并且验证‘配置奇门’授权里目标URL是否对应自己实现的服务接口地址
  • 自测完成上线后,需要给官方AppKey调用授权,官方AppKey是23647480,这个是平台请求锁单的发起应用方,没有授权的情况下,平台这边也无法调用ERP的接口,平台一调用会出现‘找不到目标路由地址错误信息’
  • 上述操作功能完成后,可以提交商家主账号+AppKey的方式,给到平台,平台给你开通对应商家的自助锁单功能,商家可以开启自动化核单任务,使用自助锁单功能,并且进行全链路线上测试。

 

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

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

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

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. ERP接入前需要添加对应接口权限,需要ERP提供应用开发的AppKey,权限管理员 @易萧(kaidong.rkd) @枫眠(xiaoxing.zxx) @滕越(hk177955) @易昊(xiang.oyx)

http://api.alibaba-inc.com/official/edit?spm=0.0.0.0.1SpfBJ&apiGroupId=14891

  1. 添加权限后,ERP登录奇门配置后台进行接口配置 https://qimen.taobao.com/#/?_k=f503wc ,选择左侧官方服务集成,可以关联官方场景,如下图已经进行了场景关联后的情况。添加关联官方场景,在已经得到授权后可以看到‘自助锁单’奇门官方场景,具体详细操作文档见奇门的对外官方文档://open.taobao.com/doc.htm?docId=106849&docType=1

管理并且配置完可以进行自测操作,测试时ERP开发者必须是已经实现了自助锁单接口HTTP服务功能,自测如下图

如果响应失败,请仔细查看响应处提供的参考文案,如下图,很明显提示了密钥输入错误。请自己核对AppSecret,

其中有一个非常常见的错误是缺少路由信息,请检查授权配置页面是否有对应的授权调用信息,没有的话需要增加调用发起方AppKey对应的授权配置

并且验证‘配置奇门’授权里目标URL是否对应自己实现的服务接口地址

  1. 自测完成上线后,需要给官方AppKey调用授权,官方AppKey是23647480,这个是平台请求锁单的发起应用方,没有授权的情况下,平台这边也无法调用ERP的接口,平台一调用会出现‘找不到目标路由地址错误信息’
  2. 上述操作功能完成后,可以提交商家主账号+AppKey的方式,给到平台,平台给你开通对应商家的自助锁单功能,商家可以开启自动化核单任务,使用自助锁单功能,并且进行全链路线上测试。

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

1、top接口名称:taobao.gearfactory.intercept.order.callback (//open.taobao.com/api.htm?docId=40680&docType=2)ERP接入前需要添加对应接口权限,需要ERP提供应用开发的AppKey,权限管理员 @易萧(kaidong.rkd) @枫眠(xiaoxing.zxx) @滕越(hk177955) @易昊(xiang.oyx)

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列表

 

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:失败

 

 

 

FAQ

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