API文档

unique_code_status_change.php（修改唯一码状态为已到货）

¥基础 ¥扩展 ¥定制

1.接口说明

1.1 接口描述：将旺店通唯一码状态变更为已到货

1.2 适用版本：网页版

1.3注意事项：需要判断请求唯一码的状态是否是“待拿货”, 不是待拿货的将返回错误结果

2.调用场景

2.1 举例说明：自研商城、SCM、SRM、财务系统、SAP等系统的对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/unique_code_status_change.php
正式环境	https://openapi.huice.com/openapi/unique_code_status_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 业务请求参数

名称	字段	类型	长度	必须	描述
唯一码列表	unique_codes	varchar		否	订单号列表 (传字符串, 英文逗号分割)

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
成功条数	success_count	int
失败条数	fail_count	int
失败列表	fail_list	data[]

4.2 业务响应参数

名称	字段	类型	长度	必须	描述
唯一码	unique_code	varchar	40	是	唯一码
失败信息	fail_msg	varchar		是	仅支持修改“待拿货”状态的唯一码，唯一码状态是xxx，不允许修改！

5.请求示例

PHP

<?php
	require_once("../WdtClient.php");
	$client = new WdtClient;
	$client->sid = '';
	$client->appkey = '';
	$client->appsecret = "";
	$client->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/unique_code_status_change.php';
 
	$client->putApiParam('unique_codes', '0000006273626');  
    
	$response = $client->wdtOpenApi();
	var_dump($response);
?>

6响应示例

6.1 正常响应示例

JSON	{ "code": 0, "message": "", "success_count": 1, "fail_count": 0, "fail_list": [ ] }

6.2 异常响应示例

JSON

{
    "code": 0,
    "message": "",
    "success_count": 1,
    "fail_count": 1,
    "fail_list": [{
        "unique_code": "0000006273626",
        "fail_msg": "仅支持修改“待拿货”状态的唯一码，唯一码状态是已到货，不允许修改！"
    }]
}