订单发货

1688大市场订单，卖家自己联系物流发货，支持合并发货，即：多个订单一次发货；支持子订单(orderEntry)级别的发货，不支持按数量发货。

1.请求参数

请求URL:

POST https://kf.fw199.com/gateway/1688/logistices/offlinesend

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
seller_nick	String	1688账号	kingdo
extBody	String	JSON字符串，cpCode 为物流公司code， ; logisticsCpName:物流公司名称， mailNo：运单号；见淘宝菜鸟获取物流公司信息。	{“cpCode”:”SF”,”logisticsCpName”:”顺丰”,”mailNo”:”a123”}
sign	String	接口签名	如何计算生成见示例代码
sendGoods	string	JSON 字符串
isEncryptOrderSend	string	是否下游加密订单取号发货，当卖家是通过下游平台加密取号时传入Y	Y,N

2. 请求示例代码(Java)


    @Test
    public void AlibabaOfflineSend() throws Exception {

        String extBody = "{\"cpCode\":\"YTO\",\"logisticsCpName\":\"圆通快递\",\"mailNo\":\"YT3024020200035\"}";
        String sendGoods =  "[{\"sendGoodEntries\": [{\"amount\": 1,\"sourceEntryId\": \"3596604195571498520\",\"weight\": 0.5}],\"sourceId\": \"3596604195571498520\"}]";
        String tb_seller_nick = Config.alibabaSellerNick;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick", tb_seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("extBody", extBody);
        data.put("sendGoods", sendGoods);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        // 调用服务API
        String response = doHttpRequest(Config.AlibabaOfflineSendUrl, data);

    }

上面请求参数中sendGoods对象的字段说明

名称	类型	是否必须	描述
sourceId	String	是	发货对象id,一般是订单id
sendGoodEntries	message:alibaba.logistics.OpSendGoodEntry[]	是	发货对象明细列表
sourceEntryId	String	是	发货对象明细id，对应子订单Id
amount	Long	是	发货对象实发数量
weight	Double	是	发货对象实发重量，重量单位默认为千克

3. 返回结果如下：

失败的情况：
{"code":0,"message":"ok","data":{"errorCode":"5004","errorMessage":"订单[2106566005818783163]发货失败,订单状态为[已收货]，不是待发货状态。","success":false},"trace_id":""}



成功的情况

{"code":0,"message":"ok","data":{"result":{"logisticsId":"LP00647508543377","sendGoods":[{"sendGoodEntries":[{"amount":1,"sourceEntryId":3596604195571498520,"weight":0.5}],"sourceId":3596604195571498520}]},"success":true},"trace_id":""}

说明： code为0表示成功，非0为失败，message会包含失败原因。业务成功与否的判断见内层的success。

文档更新时间: 2024-05-06 21:13 作者：admin