当前位置： API文档

sales_trade_tags_modify.php（修改订单标签）

¥标准

1.接口说明

1.1 接口描述：修改订单标签
1.2 适用版本：网页版

2.调用场景

2.1 举例说明：财务系统、SAP、线下ERP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/sales_trade_tags_modify.php
正式环境https://openapi.huice.com/openapi/sales_trade_tags_modify.php

   3.2 公共请求参数

名称字段类型必须描述
卖家账号sidString是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString是
时间戳timestampint是北京时间1970-01-01 08:00:00起至现在的总秒数，
10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString是API输入参数签名结果，签名算法介绍文档中心


   3.3 业务请求参数

名称字段描述Y类型是否必须
订单trade_idtrade_ids订单系统id, 多个订单系统id 用英文逗号分割String是
标签idtag_ids标签id,多个标签id 用英文逗号分割String

可选必传

tag_ids和abnormal_ids必传其一

类型typetype =1 :添加，type =2 ,删除string是
异常 idabnormal_ids异常 id 多个用英文逗号分割 string

可选必传

tag_ids和abnormal_ids必传其一



4.响应参数

公共响应参数

名称字段类型长度
必须描述
错误码codeInt11是

状态码,0表示调用成功，其他表示失败

错误信息message

varchar

255是错误描述

业务响应参数

名称字段类型长度必须描述
订单编号trade_nos数组 data[varchar(64)]
否
订单idtrade_ids数组 data[bigint(20)]
否

   5.请求示例


PHP
<?php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = "";
    $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/sales_trade_tags_modify.php';
     
    $c->putApiParam('trade_ids', '2766250315173855241');
    $c->putApiParam('tag_ids', '97');
    $c->putApiParam('type', '1');

	
    $json = $c->wdtOpenApi();
    var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "trade_nos": [
        "JY2511251482"
    ],
    "trade_ids": [
        "2766250315173855241"
    ]
}

   6.2 异常响应示例

JSON
{
    "code": 2830,
    "message": "系统订单Id无效:276625031517385524100"
}



常用工具