sales_trade_simple_change.php (单笔换货)
¥标准
1.接口说明
| 1.1 接口描述:获取单笔订单换货 |
| 1.2 适用版本:网页版 |
2.调用场景
| 2.1 举例说明:自有商城接入ERP、金蝶接入、用友接入、SAP接入等 |
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|
| 测试环境 | https://openapitest.huice.com/openapi/sales_trade_simple_change.php |
| 正式环境 | https://openapi.huice.com/openapi/sales_trade_simple_change.php |
3.2 公共请求参数
| 名称 | 字段 | 类型 | 长度
| 必须 | 描述 |
|---|
| 卖家账号 | sid | String |
| 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 |
| 接口账号 | appkey | String |
| 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里
|
| 时间戳 | timestamp | int |
| 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 |
| 签名 | sign | String |
| 是 | API输入参数签名结果,签名算法介绍单击这里
|
| 3.3 业务请求参数 |
|
|
|
|
|
|
|
| 名称 | 字段 | 父级字段 | 描述 | Y类型 | Y枚举 | 是否必须 | 默认值 |
| 订单主信息部分 | trade_info |
| 换货主要信息 参数trade_info举例:{"tradeId":"","src_oid":"","spec_list":[{"":""}]} | Object |
| 是 |
|
| 订单trade_id | trade_id | trade_info |
| bigint(20) |
| 是 |
|
| 订单明细id | rec_id | trade_info | is_suite =0 时,必传:换出商品为普通单品必传 | bigint(20) |
|
|
|
| 平台子单号 | src_oid | trade_info | is_suite=1 时,必传:换出商品为组合装时必传 | string |
|
|
|
| 组合装id | suite_id | trade_info | is_suite=1 时,必传:换出商品为组合装时必传 | bigint(20) |
|
|
|
| 是否为组合装 | is_suite | trade_info |
| int | 0 否 1 是 | 是 |
|
| 原订单被换商品数量 | num | trade_info |
| decimal(19, 4) |
|
|
|
| 换出新商品信息 | spec_list | trade_info |
| Array |
|
|
|
| 换出商品id | spec_id | spec_list | is_suite =0 时,为普通商品ID:spec_id ;is_suite =1 时, 为组合装商品id:suite_id | bigint(20) |
|
|
|
| 换出数量 | num | spec_list |
| decimal(19, 4) |
|
|
|
| 换出商品是否为组合装 | is_suite | spec_list |
| int | 0 否 1 是 | 是 |
|
|
|
|
|
|
|
|
|
| 出参 |
|
| 公共响应参数 |
|
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|
|
| 错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
|
|
| 错误描述 | message | varchar | 255 | 是 | 错误描述 |
|
|
| 业务响应参数 |
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|
|
| 订单编号 | trade_nos | 数组 data[varchar(64)] |
| 否 |
|
|
|
| 订单id | trade_ids | 数组 data[bigint(20)] |
| 否 |
|
|
|