API文档

sales_trade_simple_change.php （单笔换货）

¥标准

1.接口说明

1.1 接口描述：获取单笔订单换货

1.2 适用版本：网页版

2.调用场景

2.1 举例说明：自有商城接入ERP、金蝶接入、用友接入、SAP接入等

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/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)]		否

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_simple_change.php'; $trade_info = [ 'trade_id' => "2740612153277939735", 'rec_id' => "2740612153282134039", 'is_suite' =>0, 'num'=> 1, 'spec_list' => [ [ 'spec_id' => '2788722012439183360', 'num' => 10, 'is_suite' => 0 ] ] ]; $c->putApiParam('trade_info', json_encode($trade_info, JSON_UNESCAPED_UNICODE)); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

JSON	{ "code": 0, "message": "", "trade_nos": [ "JY2509150164" ], "trade_ids": [ "2740612153277939735" ] }

JSON	{ "code": 2830, "message": "参数值无效" }

常用工具