当前位置： API文档

pick_status_ack.php（分拣单状态回传）

¥标准

1.接口说明

1.1 接口描述：分拣设备回传分拣单状态处理
1.2 适应版本：网页版

2.调用场景

2.1 分拣设备

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

https://openapi.ali.huice.cc/openapi/pick_status_ack.php

正式环境

https://openapi.huice.com/openapi/pick_status_ack.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 业务请求参数

名称字段类型长度
必须描述

分拣单号

pick_no



是

分拣单号

分拣单状态

status



是

35.分货中 40.分拣完成

分拣完成是否直接发货

pick_finished_send



否

 0：否 ，1：是。默认是0

（当该参数回传1，且分拣单状态回传40分拣完成时，同时触发系统订单发货）

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint40是状态码:0表示成功,其他表示失败
错误原因messagevarchar255是错误原因

失败的错误列表

errors_list

data

data[]

否

处理失败的错误列表

errors_list

名称字段类型长度
必须描述

错误的系统单号

trade_no

int40是错误的系统单号
错误原因

error

varchar255是错误原因

5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient;
    //sid appkey appsecret 需要换成自己的
    $c->sid ='haijun';
    $c->appkey ='';
    $c->appsecret ="";
    //测试环境地址
    //上线时需要换成线上的
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/pick_status_ack.php';
	
	$c->putApiParam('pick_finished_send', "1");
		$c->putApiParam('status', "40");
			$c->putApiParam('pick_no', "PB260204000003");
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "",
    "send_fail_list": null
}

   6.2 异常响应示例

JSON
{
    "code": 0,
    "message": "",
    "send_fail_list": [
        {
            "trade_no": "JY2601080728",
            "error": "发货异常:订单已其他系统发货"
        }
    ]
}






常用工具