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)] |
| 否 |
|
|
|