托管oaid方案
本文只适合特殊场景,非蜂巢标准的接入方案。如有疑问请先咨询客服,与客服确认后再使用本文的方法。
本次改造后,订单的oaid是属于订单本身的一部分,类似订单号一样。 对于部分老系统或特殊场景,不方便在系统之间传递oaid的,可由蜂巢托管oaid的方式。
即在通过蜂巢接口获取订单时,通过传入参数hold_oaid指明由蜂巢托管oaid,在电子面单取号时,只需要传入订单号tid,不必传入oaid。方便一些特殊场景的改造。
一、蜂巢接口
增加入参hold_oaid,如果需要蜂巢代托管订单的oaid,此值传入1, 否则传0,或是不要加入参数hold_oaid,代码片段如下:
String tb_seller_nick = Config.TBSellerNick; //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("hold_oaid", "1"); // 指明由蜂巢代托管oaid data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString());接口文档:trade-detail
二、蜂巢接口
增加入参hold_oaid,如果需要蜂巢代托管订单的oaid,此值传入1, 否则传0,或是不要加入参数hold_oaid
-
蜂巢接口
增加入参hold_oaid,如果需要蜂巢代托管订单的oaid,此值传入1, 否则传0,或是不要加入参数hold_oaid
接口文档:/docs/open-platform/tradelist/,
四、蜂巢接口
增加入参hold_oaid,如果需要蜂巢代托管订单的oaid,此值传入1, 否则传0,或是不要加入参数hold_oaid
-
蜂巢接口
oaid代托管模式,前提条件:是在取号之前,订单是通过本文上面4个订单相关接口获取的订单。 如果条件满足的话,电子面单取号时,可以不传入oaid,
具体的操作方法:
传入参数hold_oaid=1,如下代码片段:
String tb_seller_nick = Config.TBSellerNick; //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("hold_oaid", "1"); // 指明由蜂巢代托管oaid data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString());同时确保request_data业务参数中recipient下面的tid有值传入,蜂巢根据此订单号tid组装oaid的值
"recipient": { // 必填, 收件人信息 "address": { // 必填, 地址 "city": "杭州市", // 可填,城市 "detail": "", // 详细地址, 可传明文,或按原订单中值传入 "district": "桐庐县",// 可填,区 "province": "浙江省", // 必填,省 "town": "横村镇" // 可填,街道 }, "mobile": "13357035578", // 手机号码,可传明文,或按原订单中值传入 "name": "洪勇强", // 姓名 ,可传明文,或按原订单中值传入 "phone": "057123222233" // 可填,固定电话, "oaid": "", // 留空 "tid" : "371834183481243" // 有效的订单号
}, "template_url": "http:\/\/cloudprint.cainiao.com\/template\/standard\/256771\/9", // 必填, 云打印标准模板URL(组装云打印结果使用,值格式http://cloudprint.cainiao.com/template/standard/${模板ID}) "user_id": 0 // 必填, 请传固定传0,蜂巢开放平台会转处理。 }