修改付款后推送订单规则
修改付款后订单的推送规则
修改付款后订单的推送规则, 根据买家留言进行的内容进行推送。
一、请求参数
请求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 | 同步规则,备注内容表达式 |
关于设置说明
如果未设置整个规则,默认为不推送。 如果“开启状态”是“关闭”则不推送。
如果“开启状态”是“开启”的, 当留言为空时,则推送。
如果“开启状态”是“开启”的,当留言不为空而且与规则匹配时,则推送。
买家留言匹配规则如下:
关键词说明
| 关键词 | 含义 | 备注 |
|---|---|---|
| 买家留言 | 在表达式中,“买家留言”是特定词语,代表买家在下单时填写的留言内容 | 比如:“明天我不在家,放保安处 ” |
| 手机 | 指日常生活中使用的手机号 ,在表达式中,“手机”是特定词语,代表生活中各运营商的手机号, 比如13816338876等手机号 | 在同步规则中要用英文引号引起来,见下面的示例。 |
| 自定义词 | 订单备注可能出现的词,比如礼物、VIP等等 | 在同步规则中要用英文引号引起来,见下面的示例。 |
逻辑表达式
| 逻辑词 | 含义 | 备注 |
|---|---|---|
| 或者 | 只要一个条件满足即可 | |
| 并且 | 两个条件都要满足 |
示例
-
同步卖家备注中包含手机号的订单,比如要匹配 : tb13816129988 特征表达式为:
买家留言 包含 "手机"。 -
同步卖家备注中包含手机并且包含”VIP“二字 特征表达式为:
(买家留言 包含 "手机") 并且 (买家留言 包含 "VIP")注意:多个条件组合的话,注意要有括号
二、请求示例代码
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);
}三、返回结果
{"code":0,"message":"ok","data":"SUCCESS"}说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段为SUCCESS表示更新成功。