修改付款后订单的推送规则

修改付款后订单的推送规则， 根据买家留言进行的内容进行推送。

1.请求参数:

请求URL:

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

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

参数request_data的说明

参数名 类型 说明 示例
is_enable Boolean 是否开启推送
filter_express String 同步规则，备注内容表达式

关于设置说明

  1. 如果未设置整个规则，默认为不推送。 如果“开启状态”是“关闭”则不推送。
  2. 如果“开启状态”是“开启”的， 当留言为空时，则推送。
  3. 如果“开启状态”是“开启”的，当留言不为空而且与规则匹配时，则推送。

买家留言匹配规则如下：

关键词说明

关键词 含义 备注
买家留言 在表达式中，“买家留言”是特定词语，代表买家在下单时填写的留言内容 比如：“明天我不在家，放保安处 ”
手机 指日常生活中使用的手机号 ，在表达式中，“手机”是特定词语，代表生活中各运营商的手机号， 比如13816338876等手机号 在同步规则中要用英文引号引起来，见下面的示例。
自定义词 订单备注可能出现的词，比如礼物、VIP等等 在同步规则中要用英文引号引起来，见下面的示例。

逻辑表达式

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

示例

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

2. 请求示例代码(Java)

   @Test
    public void  updatePaidTradePushExpress() 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 = "{\"is_enable\":true,\"filter_express\":\"买家留言 包含 'vip'\"}";
        data.put("request_data", express);
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.TaoBaoTradeUpdatePaidPushExpressUrl ,data);

    }

3. 返回结果如下：

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

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

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