代发订单导入接口

新接用户,请使用新的订单导入接口!!!

1. 请求参数

公测请求URL

POST https://fcprint.fw199.com/api/trade/import

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
sign String 接口签名 如何计算生成见示例代码
op String 传入订单来源,1:淘宝,2:拼多多 1=淘宝,2=拼多多,3=抖店打单,4=淘宝代发,5=京东,6=淘宝1688,7=抖店erp,8=快手
seller_nick String 商家账号,非店铺名称 kingdo
request_data String 接口请求json数据
request_data 请求数据示例:
[
    {
        "op": "3",//订单平台类型,必填
        "tid": "4988143698685470042",//订单号,必填
        "logisticsCode": "zhongtong",//快递公司编码(选填,不为空时tradeNo为必填)
        "trackNo": "75545149156682",//快递单号(选填,不为空时logisticsCode为必填)
        "wayBillInfo": "123",//面单信息(op=3时,不用传入)
        "remark": "DD2023030100001",//选填,绑定的外部订单号
    },
    {
        "op": "3",
        "tid": "4988143505411016026",
        "logisticsCode": "zhongtong",
        "trackNo": "75545149272792",
        "wayBillInfo": "123",
        "remark": "DD2023030100003",//选填,绑定的外部订单号
    },
    {
        "op": "3",
        "tid": "4988150673702199035",
        "logisticsCode": "zhongtong",
        "trackNo": "75545153107652",
        "wayBillInfo": "123",
        "remark": "DD2023030100003",//选填,绑定的外部订单号
    }
]

2. 请求示例代码(Java)

    @Test
    public void testImportDoudianTrade() throws Exception {

        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("op", String.valueOf(OpenPlatConstant.DOUDIAN_OMS));//1=淘宝,2=拼多多,3=抖店打单,4=淘宝代发,5=京东,6=淘宝1688,7=抖店erp,8=快手
        data.put("request_data", "[{\"op\":\"3\",\"tid\":\"4988143698685470042\",\"logisticsCode\":\"zhongtong\",\"trackNo\":\"75545149156682\",\"wayBillInfo\":\"123\",\"remark\":\"DD20220111001\"}]");//卖家昵称

        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.testImportTrade,data);
    }

3. 返回结果如下:

3.1 请求成功
{
    "code": 0,
    "message": "ok",
    "data": [
        {
            "code": -1,
            "message": "订单4988751741504363950已发货,不能导入",
            "data": "4988751741504363950"
        },
        {
            "code": 0,
            "message": "订单4988761087337565530导入成功",
            "data": "4988761087337565530"
        },
        {
            "code": 0,
            "message": "订单4988763161814695286导入成功",
            "data": "4988763161814695286"
        },
        {
            "code": 0,
            "message": "订单4988763161814695286更新成功",
            "data": "4988763161814695286"
        }
    ]
}
3.2 请求失败
{"code":-1,"message":"订单详情接口调用失败:签名失败","data":null}

说明: code为0表示成功,非0为失败,message会包含失败原因,data为导入成功的订单号集合。

文档更新时间: 2024-08-16 12:03   作者:admin