修改订单插旗推送规则
创建或更新淘宝订单插旗备注推送规则,可设置推送插特定旗帜的订单。
一、请求参数
请求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等等 | 在同步规则中要用英文引号引起来,见下面的示例。 |
逻辑表达式
| 逻辑词 | 含义 | 备注 |
|---|---|---|
| 或者 | 只要一个条件满足即可 | |
| 并且 | 两个条件都要满足 |
示例
-
同步卖家备注中包含手机号的订单,比如要匹配 : tb13816129988 特征表达式为:
卖家备注 包含 "手机"。 -
同步卖家备注中包含手机并且包含”VIP“二字 特征表达式为:
(卖家备注 包含 "手机") 并且 (卖家备注 包含 "VIP")注意:多个条件组合的话,注意要有括号
二、请求示例代码
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);
}三、返回结果
{"code":0,"message":"ok","data":"SUCCESS"}说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段为SUCCESS表示更新成功。