若品牌商使用第三方软件服务商或自研的系统进行门店发货业务,则需要对接速店通系统的取号、打印、发货接口。速店通的详细业务介绍,参看:速店通业务说明
对接的基本流程:
1)阅读技术对接文档,熟悉对接的整体链路;
2)确定对接技术方案;
3)接口开发,调试接口;
4)联调,商家总部拿几个线上订单进行接口测试(前期可以用商家自己的淘宝小号下单进行测试);
5)1-2个门店上线系统验收(包括系统验收,打印机验收,和业务链路熟悉);
6)逐量部署到各个门店。
对接速店通,前提条件是货物从门店发货,不论是淘系订单还是非淘系订单都需要商家先在全渠道中心发布门店信息,门店信息是速店通的基础条件。
创建门店的方式有两种:
2)通过奇门接口来创建介绍,注:奇门接口的调用方式和TOP接口略有不同
请务必确认门店有货可发货再取号,取号后再频繁地取消取号,会导致取消取号受到限制,参见电子面单平台对于取消取号的限制要求:点这里查看
1)商家需要先获取电子面单号,具体接口请参看全渠道门店物流速店通取号接口:taobao.omniorder.store.getconsignmailcode(接口有更新,信息见3))。该接口需传入门店ID、订单信息和收发件人基本信息。
说明:
2)关于入参的要求:
3)接口更新:
目前已有接口:taobao.omniorder.store.sdtconsign(通知菜鸟裹裹发货)
目前返回信息:
{
"omniorder_store_sdtconsign_response":{
"err_code":"123", // 0 代表正常,否则异常
"message":"xx错误"
}
}
新增data字段,包含运力信息(包裹 id、商家 id、物流订单号、小件员姓名、小件员电话、接单网点以及接单 cp 等信息)
{"omniorder_store_sdtconsign_response":{
"err_code":"123", // 0 代表正常,否则异常
"message":"xx错误",
"data":{
"packageId":0, // 包裹id
"sellerId":0,//商家id
"lpCodeList":"1111",//物流订单号list,目前只有一个值
"deliveryUserName":"",//接单小件员姓名
"deliveryUserPhone":"",// 接单小件员电话
"dotName":"",//接单网点
"companyName":""//接单cp
}
}
}
电子面单打印需要使用菜鸟云打印组件,如果之前有过对接菜鸟电子面单,这部分可以直接复用,如果没有对接过,那么可以参看菜鸟云打印的说明文档:菜鸟云打印参考文档
若已对接其他自有打印工具,可按照速店通面单模板创建打印模板,自行打印面单。
说明:
1)菜鸟云打印组件是完整的菜鸟电子面单对接方案,对于速店通场景,许多接口不是必须的。下面整理正常流程需要对接的接口:
门店备好货,获取到了面单号,就可以调用速店通发货接口(走速店通发货的淘系订单不再需要使用taobao.logistics.online/offline.send接口发货了),接口调用后,该笔订单(淘系)状态会变为已发货,且平台会通知快递小哥上门揽货,一般快递公司都是下午到门店揽件。接口:taobao.omniorder.store.sdtconsign
请务必确认门店有货可发货再取号,取号后再频繁地取消取号,会导致取消取号受到限制,参见电子面单平台对于取消取号的限制要求:点这里查看
原有top接口:taobao.omniorder.store.sdtcancel(通知速店通取消发货)
内部逻辑增加对菜鸟运力单取消的支持,商家可以直接使用该接口,入参出参不做变更。
入参:package_id
出参:
{ "omniorder_store_sdtcancel_response":{ "result":{
"err_msg":"error", // 0 代表正常,否则异常
"err_code":"123" } } }
用户根据淘宝交易号查询物流流转信息,如2010-8-10 15:23:00到达杭州集散地。 此接口的返回信息都由物流公司提供。接口:taobao.logistics.trace.search
A:这里给出trades字段的入参demo,这里是一个主订单,两个子订单申请面单号,入参trades={"trades":[{"main_order_id":"293626****846879","sub_orders":[{"items":[{"item_id":"34928***35371","name":"短袖T恤","count":"1","amount":295}],"sub_order_id":"293626*****4846879"},{"items":[{"item_id":"34928***35371","name":"短袖T恤","count":"1","amount":295}],"sub_order_id":"293626*****4846879"}]}]}