修改订单备注

可重复调用本接口更新交易备注,本接口同时具有添加备注的功能

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/taobao/order/updatememo

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
tid String 必填, 订单号
flag int 可空, 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0
memo String 可空, 卖家交易备注。最大长度: 1000个字节
reset boolean 不建议使用, 可空, 是否对memo的值置空若为true,则不管传入的memo字段的值是否为空,都将会对已有的memo值清空,慎用;若用false,则会根据memo是否为空来修改memo的值:若memo为空则忽略对已有memo字段的修改,若memo非空,则使用新传入的memo覆盖已有的memo的值
sysid String 可空, 代表不同的应用,具体请咨询客服
sign String 接口签名 如何计算生成见示例代码

2. 请求示例代码(Java)

      /**
     *    修改淘宝订单备注
     * @throws Exception
     */
    @Test
    public void updateMemo() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家
        //业务参数 
        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("tid", "1394872671557565830");
        // 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0
        data.put("flag", "2");
        // 卖家交易备注。最大长度: 1000个字节
        data.put("memo", "这是通过api写的备注"); 
        data.put("reset", "false"); 
         // data.put("sysid", ""); 传什么参数请咨询客服
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoUpdateMemoUrl ,data);

    }

3. 返回结果如下:

{
    "code": 0,
    "message": "ok",
    "data": {
        "request_id": "53n7l1woyrw1",
        "trade": {
            "modified": "2020-12-19 17:42:13",  // 修改时间
            "tid": "1394872671557565830"  // 被修改的订单号(也是传入的订单号)
        }
    }
}

说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。

文档更新时间: 2023-10-18 16:42   作者:admin