在线订单发货处理(支持货到付款)

用户调用该接口可实现在线订单发货(支持货到付款) ,支持物流跟踪。
修改淘宝订单状态为卖家已发货,传入物流公司信息,订单备注等 。

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/logistices/onlinesend

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
tid long 淘宝订单号码 3231214234141421
sign String 接口签名 如何计算生成见示例代码
company_code string 快递公司代码 .如”POST”就代表中国邮政,”ZJS”就代表宅急送.
out_sid string 快递单号,具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入;
flag string 废弃,请使用《修改订单备注(插旗)》,卖家交易备注旗帜, 可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),说明:如果不想加旗帜,则传空串””
memo string 废弃,请使用《修改订单备注(插旗)》,卖家交易备注。最大长度: 1000个字节 ,说明:如果不想加旗帜,则传空串””

2. 请求示例代码(Java)

  @Test
    public void logisticesCompanyOnineSend() throws Exception {

        String result ="";
        String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家
        CloseableHttpClient httpclient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost( Config.LogisticesOnlineSendUrl );
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("tb_seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());


        // 淘宝交易ID,必须
        data.put("tid", "1148987073290565830");
       //  物流公司代码.如"POST"就代表中国邮政,"ZJS"就代表宅急送 ,通过接口 "查询物流公司列表"   获取。
        data.put("company_code","SF");
        // 运单号.具体一个物流公司的真实运单号码。淘宝官方物流会校验,请谨慎传入;
        data.put("out_sid","SF1191992347148");
        // 卖家交易备注旗帜,   可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),说明:如果不想加旗帜,则传空串""
        data.put("flag","1");
        // 卖家交易备注。最大长度: 1000个字节  ,说明:如果不想加旗帜,则传空串""
        data.put("memo","效果不错");
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret)); 
        List<BasicNameValuePair> params = new ArrayList<BasicNameValuePair>();
        for (Map.Entry<String, String> entry : data.entrySet()) {
            params.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
        }
        //发起POST请求
        try {
            httpPost.setEntity(new UrlEncodedFormEntity(params, "UTF-8"));
            HttpResponse httpResponse = httpclient.execute(httpPost);
            if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
                result =  EntityUtils.toString(httpResponse.getEntity());
            } else {
                result =  ("doPost Error Response: " + httpResponse.getStatusLine().toString());
            }
        } catch (Exception e) {
            e.printStackTrace();

        }

        System.out.println(result);

    }

3. 返回结果如下:

 {"code":0,"data":true,"message":"success","tid":"1148987073290565830"}

说明: code为0表示成功,非0为失败,tid为本次发货的订单号, message会包含失败原因。失败时一定要注意,可能商户授权过期,或是参数有误。

文档更新时间: 2023-07-09 23:43   作者:admin