修改订单备注(插旗)
可重复调用本接口更新交易备注,本接口同时具有添加备注的功能
一、请求参数
请求URL:
| 参数名 | 类型 | 说明 | 示例 |
|---|---|---|---|
| appid | String | 合作伙伴AppId | uwkahf@jfs92 |
| timestamp | String | 当前时间戳 | |
| tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
| tid | String | 必填, 订单号 | |
| flag | int | 可空, 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0 | |
| memo | String | 可空, 卖家交易备注。最大长度: 1000个字节 | |
| reset | boolean | 不建议使用, 可空, 是否对memo的值置空若为true,则不管传入的memo字段的值是否为空,都将会对已有的memo值清空,慎用;若用false,则会根据memo是否为空来修改memo的值:若memo为空则忽略对已有memo字段的修改,若memo非空,则使用新传入的memo覆盖已有的memo的值 | |
| sysid | String | 可空, 代表不同的应用,具体请咨询客服 | |
| sign | String | 接口签名 | 如何计算生成见示例代码 |
二、请求示例代码
Java
/** * 修改淘宝订单备注 * @throws Exception */ @Test public void updateMemo() throws Exception {
String tb_seller_nick = Config.TBSellerNick ; //要查询支付宝的淘宝商家 //业务参数 Map<String, String> data = new HashMap<String, String>(); data.put("appid", Config.AppId); data.put("tb_seller_nick", tb_seller_nick); Long timestamp = System.currentTimeMillis() / 1000; data.put("timestamp", timestamp.toString()); // 订单号 data.put("tid", "1394872671557565830"); // 卖家交易备注旗帜,可选值为:0(灰色), 1(红色), 2(黄色), 3(绿色), 4(蓝色), 5(粉红色),默认值为0 data.put("flag", "2"); // 卖家交易备注。最大长度: 1000个字节 data.put("memo", "这是通过api写的备注"); data.put("reset", "false"); // data.put("sysid", ""); 传什么参数请咨询客服 // 签名 data.put("sign", Utils.Sign(data,Config.AppSecret)); // 调用服务API doHttpRequest(Config.TaoBaoUpdateMemoUrl ,data);
}三、返回结果
{ "code": 0, "message": "ok", "data": { "request_id": "53n7l1woyrw1", "trade": { "modified": "2020-12-19 17:42:13", // 修改时间 "tid": "1394872671557565830" // 被修改的订单号(也是传入的订单号) } }}说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。