修改订单备注
可重复调用本接口更新交易备注,本接口同时具有添加备注的功能
1.请求参数:
请求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 | 接口签名 | 如何计算生成见示例代码 |
2. 请求示例代码(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);
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"request_id": "53n7l1woyrw1",
"trade": {
"modified": "2020-12-19 17:42:13", // 修改时间
"tid": "1394872671557565830" // 被修改的订单号(也是传入的订单号)
}
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。
文档更新时间: 2023-10-18 16:42 作者:admin