跳转到内容
返回官网

修改付款后推送订单规则

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

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

一、请求参数

请求URL:

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

参数名类型说明示例
appidString合作伙伴AppIduwkahf@jfs92
timestampString当前时间戳
tb_seller_nickString淘宝卖家店铺登录账号,非店铺名称kingdo
request_datajson推送规则
signString接口签名如何计算生成见示例代码

参数request_data的说明

参数名类型说明示例
is_enableBoolean是否开启推送
filter_expressString同步规则,备注内容表达式

关于设置说明

  • 如果未设置整个规则,默认为不推送。 如果“开启状态”是“关闭”则不推送。

  • 如果“开启状态”是“开启”的, 当留言为空时,则推送。

  • 如果“开启状态”是“开启”的,当留言不为空而且与规则匹配时,则推送。

买家留言匹配规则如下:

关键词说明

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

逻辑表达式

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

示例

  1. 同步卖家备注中包含手机号的订单,比如要匹配 : tb13816129988 特征表达式为: 买家留言 包含 "手机"

  2. 同步卖家备注中包含手机并且包含”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表示更新成功。