托管oaid方案

本文只适合特殊场景，非蜂巢标准的接入方案。如有疑问请先咨询客服，与客服确认后再使用本文的方法。

本次改造后，订单的oaid是属于订单本身的一部分，类似订单号一样。 对于部分老系统或特殊场景，不方便在系统之间传递oaid的，可由蜂巢托管oaid的方式。

即在通过蜂巢接口获取订单时，通过传入参数hold_oaid指明由蜂巢托管oaid，在电子面单取号时，只需要传入订单号tid,不必传入oaid。方便一些特殊场景的改造。

1. 蜂巢接口<订单详情>

增加入参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());

接口文档：http://doc.fw199.com/docs/h7b/trade-detail

2. 蜂巢接口<批量获取订单详情>

增加入参hold_oaid，如果需要蜂巢代托管订单的oaid，此值传入1, 否则传0，或是不要加入参数hold_oaid

接口文档：http://doc.fw199.com/docs/h7b/tb-trade-batch-detail

3. 蜂巢接口<获取订单列表>

增加入参hold_oaid，如果需要蜂巢代托管订单的oaid，此值传入1, 否则传0，或是不要加入参数hold_oaid

接口文档：http://doc.fw199.com/docs/h7b/tradelist，

4. 蜂巢接口<获取增量订单列表>

增加入参hold_oaid，如果需要蜂巢代托管订单的oaid，此值传入1, 否则传0，或是不要加入参数hold_oaid

接口文档：http://doc.fw199.com/docs/h7b/tb-order-increment-list

5. 蜂巢接口<电子面单取号>

   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，蜂巢开放平台会转处理。 
        }

接口文档：http://doc.fw199.com/docs/h7b/taobao-cainiao-way-bill-get-batch