基础技术
点点送配送商接入流程
更新时间：2017/02/22
访问次数：10648
点点送接入流程
更改记录
| 文件编号 | 版本号 | 修改人 | 修改日期 | 主要修改内容 |
|---|---|---|---|---|
| V1.0 | 慕柒 | 2017.1.19 | 整理配送商接入流程 | |
| V1.1 | 慕柒 | 2017.2.22 | 修改时序图 |
一、文档地址
- top接入文档
- tmc消息文档
- Java代码调用示例
- Sessionkey获取
- 提高安全等级办法
- 接口调用商家授权说明
- API接口url：线上：http://gw.api.taobao.com/router/rest，沙箱：http://gw.api.tbsandbox.com/router/rest
二、需要订阅的TMC消息和API接口
-
TMC消息
- taobao_waimai_OrderDispatch：派单TMC消息
- taobao_waimai_OrderClose:订单关闭TMC通知消息
-
API接口
- taobao.waimai.order.ack:配送商接单
- taobao.waimai.delivery.update:分配配送员，也就是配送商派单成功
- taobao.waimai.delivery.pickup:取件
- taobao.waimai.delivery.confirm:妥投
- taobao.waimai.delivery.location.update:更新配送员位置
- taobao.waimai.delivery.failedorder:点点送运单失败
三、接入流程
- ISV注册淘宝账号和企业支付宝账号，同时在淘宝后台绑定企业支付宝账户
- ISV用淘宝账号登录[点点送](http:// song.dd.taobao.com)提交成为配送商的申请申请
- ISV登录注册淘宝开放平台：提供淘宝会员名(如abc123)和淘宝注册邮箱(如abc123@qq.com)资料给PD，PD会帮忙申请“淘点点标签”并授权
4.ISV创建APPKey:待PD告知ISV已经授权后，ISV登录top控制平台创建淘点点标签的AppKey - ISV申请外卖API基础权限包：授权淘点点标签后，ISV创建的“淘点点”标签的appKey已经包含了api基础的权限包，同时ISV也可以自行申请
6.ISV申请外卖API高级权限包：系统对接的ISV需要开通点点送高级权限包：通知PD将以下资料(淘宝会员名，淘宝注册邮箱和AppKey)发送至至点点送开发组并抄送至点点送产品组、点点送运营组。开通点点送高级权限包并绑定配送商的AppKey。
7.ISV联调测试：PD通知ISV可以部署至聚石塔进行联调 - ISV拿着创建完的Appkey之后,可以去聚石塔部署。ISV注册石聚塔:ISV系统必须部署聚石塔;注册登录聚石塔 http://cloud.taobao.com。 聚石塔文挡：http://cloud.tmall.com/solution/doc.htm?spm=a219b.7675395.0.0.MgkNhO&id=102126。 ISV部署聚石塔&上线:如果应用名称已经部署在聚石塔完成 , Appkey在控制台发布上线申请
- PD发送appKey对应的应用上线的申请，待审核通过后完成上线。
其他
- 运单关闭消息在派单成功后才会发送，配送商系统需要时刻监听该消息
- 步骤4上传配送员位置，配送员位置信息在分配配送员后即可上传，直到妥投成功。
- 运单配送失败可以发生在确认接单后的任何时间，当配送商没有能力(例如没有运力、找不到门店或送货地址等情况)派送运单时，调用该接口，后续接口不需要再调用。
