【拆单发货场景说明】

若一笔交易包含众多子订单，那么可能会遇到某些子订单需要单独发货的情况。系统对此情况有应对之策，并能依据不同的配送方式实施相应的处理。

类型0：普通发货（老链路，需整单发货）。

[{
        "sender_id": 0,  
        "feature": "",
        "tid": "1915261095690565830",
        "sub_tid": "",
        "consign_pkgs": [{
            "out_sid": "773075543162399",
            "company_code": "STO"
        }],
        "cancel_id": 0
    },
    {
        "sender_id": 0,
        "feature": "",
        "tid": "1914231385728565830",
        "sub_tid": "",
        "consign_pkgs": [{
            "out_sid": "773075543162332",
            "company_code": "STO"
        }],
        "cancel_id": 0
    }
] 

类型1在常规配送的新路径模式下，客户可以对子订单实施分批次的发货、单件商品的发货，亦或是在ERP系统之外进行赠品的发货处理。在此操作流程中，务必将子订单的编号准确无误地输入到指定的集合里。

类型2：将“部分发”状态修改为“全部发”。

   /**
     * 批量发货新接口
     * @throws Exception
     */
    @Test
    public void logisticesCompanyV2OffineBatchSend() throws Exception {
        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数

        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
       // data.put("sysid", "100");// 不同的sysid代表不同的应用，请联系客服
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());  
              String jsonItems ="[" +
                 "    {" +
                 "     \"sender_id\":0," +
                 "     \"feature\":\"\"," +
                 "     \"tid\":\"1915261095690565830\"," +
                 "     \"sub_tid\":\"\"," +
                 "     \"consign_pkgs\": [" +
                 "         {\"out_sid\":\"773075543162399\",\"company_code\":\"STO\" }" +
                 "     ]," +
                 "     \"cancel_id\":0" +
                 "}," +
                 "{" +
                 "    \"sender_id\":0," +
                 "    \"feature\":\"\"," +
                 "    \"tid\":\"1914231385728565830\"," +
                 "    \"sub_tid\":\"\"," +
                 "    \"consign_pkgs\": [" +
                 "        {\"out_sid\":\"773075543162332\",\"company_code\":\"STO\" }" +
                 "    ]," +
                 "    \"cancel_id\":0" +
                 "} " +
                 "]";
        data.put("items",jsonItems );
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret)); 
        // 调用服务API
        doHttpRequest(Config.LogisticesV2OfflineSendUrl,data);
    }

类型3：补发场景。

系统输出的代码code=0揭示了发货请求已获系统确认，同时tid字段负责核实订单是否已顺利发出。若发货未能实现，msg字段将详细列出失败的具体原因，诸如配送范围之外或物流公司不支持等情况。

{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "tid": "1394614838090565830",
            "is_success": true,
            "msg": ""
        },
        {
            "tid": "1394382349229565830",
            "is_success": false,
            "msg": "运单号不符合规则或已经被使用"
        }
    ]
}

【虚拟发货与物流判断】

无需物流订单操作必须通过选用虚拟配送的接口（诸如：...send）实施，严禁采用实体物流的接口进行。是否应选用虚拟配送，可依据订单详情接口（例如：...get）中相应的字段信息进行判定。

A: 造成错误的原因是因为 卖家设置的发货人信息出现错误了。让卖家在淘宝或者天猫的后台  检查下卖家填写的发货信息   进入【卖家中心】—【物流管理】—【物流工具】—【地址库】中编辑下卖家发货信息

时效保障订单若订单为一口价类型，货物配送需通过线下途径完成。若选择线上发货，系统将自动阻止操作，并显示提示信息，内容为“揽收/派送区域出现异常”。

【物流范围与高风险单号】

在使用在线发货服务（如...send接口）时，若您遇到CD01#错误提示，这通常表明物流服务商暂时无法完成发货方或收货方的地址揽收或派送任务。在此状况下，请您特别注意：

1. 家装订单必须使用家装领域特有的接口，例如.wlb...等，而普通的物流接口通常不具备相应的处理功能。

2. 物流公司编码需严格匹配，例如：

百世物流的线下发货标识码有HTKY，它象征着汇通，还有BSKY，代表着快运。一旦传输BEST，系统便会遭遇异常状况。

若物流公司未被纳入合作名单，需提交空白编码，即不填写任何信息，同时需将此信息归入“其他”类别。

高风险单号处理一旦系统发现物流订单编号存在较大安全隐患，我们推荐您转而使用菜鸟网络的电子面单来获取号码并执行发货流程，此举有助于降低未来可能遭遇的拦截困扰。

【子订单分批发货规则】

系统不支持主订单下多子订单同时发货，需按子订单分批调用接口。常见问题：

错误原因在您提交订单并完成配送环节后，顾客需要保持耐心，等候物流公司提供关于货物被接收的详细信息。一旦系统接收到这些信息，便会自动将订单状态调整为“已发货”。在此等待过程中，若您频繁进行查询，可能会造成数据不一致的情况。

解决方案：

1. 单次调用仅处理一个子订单。

2. 若返回失败，可间隔毫秒级时间后重试。

【异常处理建议】

1. 地址超区：在线发货前，优先调用查询接口确认物流覆盖范围。

2. 编码错误：核对物流公司官方编码，避免使用简称或别名。

3. 家装/大件订单：直接使用对应专用接口，勿混用标准物流流程。