修改淘宝订单插旗备注推送规则

创建或更新淘宝订单插旗备注推送规则,可设置推送插特定旗帜的订单。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/taobao/order/update/pushexpress

参数名 类型 说明 示例
appid String 合作伙伴AppId uwkahf@jfs92
timestamp String 当前时间戳
tb_seller_nick String 淘宝卖家店铺登录账号,非店铺名称 kingdo
request_data json 推送规则
sign String 接口签名 如何计算生成见示例代码

参数request_data的说明

参数名 类型 说明 示例
ordersync_after_seller_change_memo Boolean 是否开启同步
ordersync_seller_flag int 旗帜 1 :红 ,2: 黄 ,3: 绿 ,4: 蓝 ,5: 紫
ordersync_memo_filter_express String 同步规则,备注内容表达式

同步规则如下:

关键词说明

关键词 含义 备注
卖家备注 淘宝订单中的标记信息,在表达式中,“卖家备注”是特定词语,代表订单备注内容 卖家填写的订单备注
手机 指日常生活中使用的手机号 ,在表达式中,“手机”是特定词语,代表生活中各运营商的手机号, 在同步规则中要用英文引号引起来,见下面的示例。
自定义词 订单备注可能出现的词,比如礼物、VIP等等 在同步规则中要用英文引号引起来,见下面的示例。

逻辑表达式

逻辑词 含义 备注
或者 只要一个条件满足即可
并且 两个条件都要满足

示例

  1. 同步卖家备注中包含手机号的订单,比如要匹配 : tb13816129988
    特征表达式为: 卖家备注 包含 "手机"
  1. 同步卖家备注中包含手机并且包含”VIP“二字
    特征表达式为: (卖家备注 包含 "手机") 并且 (卖家备注 包含 "VIP")
    注意:多个条件组合的话,注意要有括号

2. 请求示例代码(Java)

@Test
    public void  updateTradePushExpress() throws Exception {

        String tb_seller_nick = Config.TBSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tb_seller_nick", tb_seller_nick);
        String express = "{\"ordersync_after_seller_change_memo\":true,\"ordersync_memo_filter_express\":\"卖家备注 包含 'VIP'\",\"ordersync_seller_flag\":1}";
        data.put("request_data", express);
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoTradeUpdatePushExpress ,data);

    }

3. 返回结果如下:

{"code":0,"message":"ok","data":"SUCCESS"}

说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段为SUCCESS表示更新成功。

文档更新时间: 2023-03-14 16:27   作者:admin