电子面单云打印更新接口

商家更新电子面单号对应的面单信息。

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/cainiao/waybill/update

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
tb_seller_nick	String	淘宝卖家店铺登录账号，非店铺名称	kingdo
request_data	json	要更新的电子面单信息
sign	String	接口签名	如何计算生成见示例代码

二、请求示例代码

Java

@Test
    public void getCaiNiaoWayBillUpdate() throws Exception {

        String tb_seller_nick = Config.TBSellerNick;
        String reqeustData = "{ " +
                "    \"cp_code\": \"POSTB\"," +
                "     \"logistics_services\": \"\"," +
                "     \"object_id\": \"473184714813813\"," +
                "      \"package_info\": { " +
                "             \"items\": [{" +
                "                 \"count\": 1," +
                "                 \"name\": \"赠品：XXXX\"" +
                "             }]," +
                "             \"volume\": 1," +
                "             \"weight\": 1" +
                "         }," +
                "      \"recipient\": {" +
                "            \"address\": {" +
                "                \"city\": \"广州市\"," +
                "                \"detail\": \"凤凰城1121-13号\"," +
                "                \"district\": \"白云区\"," +
                "                \"province\": \"广东省\"" +
                "            }," +
                "            \"mobile\": \"15378197532\"," +
                "            \"name\": \"朱德新\"," +
                "            \"phone\": \"\"," +
                "            \"caid\" : \"\"," +
                "            \"oaid\" : \"\"" +
                "        }," +
                "     \"sender\": { " +
                "         \"mobile\": \"18666072377\"," +
                "         \"name\": \"罗生\"," +
                "         \"phone\": \"\"" +
                "     },  " +
                "     \"template_url\": \"http://cloudprint.cainiao.com/template/standard/304351/5\"," +
                "     \"waybill_code\": \"9883698891776\"" +
                "     " +
                " }";
        //业务参数
        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());
        data.put("request_data", reqeustData);
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        String resp = doHttpRequest(Config.TaoBaoCaiNiaoWayBillUpateUrl, data);
    }

上面requestData的参数说明见文档

三、返回结果

部分数据

{
    "code": 0,
    "message": "ok",
    "data": {
        "print_data": "{\"encryptedData\":\"AES:rU904rj6UH2oqfSUb43+Z5CuoOkTVqESmlQ0tcJbrUAuXZFoV8Alh6XzZ02viDHO8CQZFc6Z7G1O/rHrPwUvRVkYo1TXGvDRpwpXWkkMJT85QR8nbg09+3C1kr+7EpbSdBUraYawlsd7DScjYtZlN9BfU31DO6zFNH7uUFJ5+Pc80gD8JWNuFLQdTeDu8UhROUEfJ24NPftwtZK/uxKW0nQVK2mGsJbHew0nI2LWZTfr75X2HMgqV648rh6ZSVVPMEwGWi1v3yN4snTn6R2NPWKYpnngpESf9boXd0Fxh2O2+bwNswDFbgEVR2xWoQA4okWR7eJaVrqmraPOImCDqfL2v/GYUsIo+2+LsV5fjYzNcj5NMweNe8rzaz4p/z0OspY7GcAtIA1lLCSBY1kcmqbSsmfNtMkNMrIRgiDnSgcPn2yESkbPV8RGo1J45k8FO470bzu1i6QVhSlrW2H0FMqLBiqxndaXUHcRJnuLM3GDR56CToeivn07fIgG6grhvQKtH692GbtAd2L1CeB9eqr96ZgkUCgthLCx93nhgeoyJBu2ONGwxKzO7Vbn3cppC4VWyahUHfJBbKcebgOewvINDD2d89fO/EgDko3zBiBeFZ1lfXGP9WZUiLDOOWI2E1V0KjmNbde3uIq3+1lLz+t/Zv3aoqNsEjnwo8/u9mCCBUFdqvflc4ISo9Dh0s4soMVgBNj3c6MIILIJrIgMdSRyRfjEQ8PH5hIVI+edqSxXEwyHlQ5ueSRhtDzPpbuB1Yn43wctQvDBpz08R8zDEmcbgKQRSzw3UpKPUaMHE2F3rWOjg1dz1DYTOk6Xeaahu96+PAYu8HiGHNEDwft10f6i1MdDPoHXOZKNcvwhXTjHPa6pN4/Cz9+NH18exbHfFWFaantGPtU/p0jsZjwDCdP8hgOexqyUPl/7651shLfAYtyA+31U97JAQ4+vV8YPYiVNLaFqTXOvtxIRWnPQm3B0okW/LfMNXKLKCjc4sUu61zT//NvG1sMZ9vB+zQwlhYL0IE+sqKLVgpM0clTRYU1B9SrUgbwOCwr+SNlIg0lUnVKC6Ky1wM8FV1hQQFUsT6GTzAyzrBEJiBO92j1r1CtkKvh6RrdNCV+aRPLnHHNHlt9PjDnBB4CR5eWXCbeC6zisLXz9xop1DOohq+Tdthxx/AGJ9j7jwkouq4okppkZCN46Cr+vj4cGAtE/vNXSu7PDzk/tNyOLsgUc7UgWs0booiPJ83zJS6bI2NQyi3zddibEm22fP4JGgFRS9R16dNMpGR1SkiCiZvM1PtfWkZZnMLxPjVtRoeCedbva7Wg=\",\"signature\":\"MD:yctbIZLOn35Fa5jYcorZsQ==\",\"templateURL\":\"http://cloudprint.cainiao.com/template/standard/304351\",\"ver\":\"waybill_print_secret_version_1\"}",
        "waybill_code": "9883698891776"
    },
    "trace_id": ""
}

说明： code为0表示成功 非0为失败，失败时message包含错误的详细信息。