编辑商家订单备注信息

编辑商家订单备注信息

1.请求参数:

POST https://kf.fw199.com/gateway/pdd/order/noteupdate"

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
seller_nick String 拼多多卖家账号,非店铺名称 kingdo
order_sn String 必填,订单号
note String 必填,订单备注
tag String 非必填,备注标记:1-红色,2-黄色,3-绿色,4-蓝色,5-紫色,tag与tag_name关联,都入参或都不入参
tag_name String 非必填,标记名称;长度最大为3个字符,tag与tag_name关联,都入参或都不入参
sign String 接口签名 如何计算生成见示例代码

2. 请求示例代码(Java)

   /**
     * 拼多多批量订单解密
     * @throws Exception
     */
    @Test
    public void pddOrderNoteUpdate() throws Exception {

        String result ="";
        String seller_nick = Config.PddSellerNick ; // 拼多多卖家账号
        CloseableHttpClient httpclient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost( Config.PddOrderNoteUpdateUrl );
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());

        // 必填,订单号
       data.put("order_sn", "210324-137383117442221");
       // 必填,订单备注
       data.put("note", "我是通过API接口进来的说明哈"); 
       // 非必填    ,备注标记:1-红色,2-黄色,3-绿色,4-蓝色,5-紫色,tag与tag_name关联,都入参或都不入参
       data.put("tag", "2");
       // 非必填,标记名称;长度最大为3个字符,tag与tag_name关联,都入参或都不入参
       data.put("tag_name", "黄色"); 
        // 参数签名
        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,
    "message": "ok",
    "data": {
        "error_code": 1000000, // 错误码
        "request_id": "16189153887002808",  
        "success": true// 是否请求成功 
        "error_msg": ""   // 只有  success为false才有此字段。可以获取错误的原因。
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 业务层面是否成功见 success字段是否为true。如果为false的话,可以获取error_msg字段

文档更新时间: 2023-03-14 17:00   作者:admin