当前位置: API文档
wms.stockout.Sales.searchCancel(已取消出库单查询)
1.接口说明
| 1.1 接口描述:获取已取消的销售出库单 |
1.2 适用版本:客户端 V1.4.7.3及以上版本 |
| 1.3 增量获取: |
| 1.4 时间跨度: |
| 1.5 注意事项:起止时间差最大1小时 |
2.调用场景
2.1举例说明:SAP、线下ERP、SRM、SCM等系统对接 |
3.请求参数说明
3.1 请求地址
| 环境 | HTTP地址 |
|---|---|
| 测试环境 | http://47.92.239.46/openapi |
| 正式环境 | http://wdt.wangdian.cn/openapi |
3.2 公共请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 卖家账号 | sid | String | Y | 卖家账号, 由旺店通分配 | |
| 接口账号 | key | String | Y | 由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里 | |
| 盐 | salt | String | Y | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
| 接口名称 | method | String | Y | 调用的接口名称 | |
| 版本号 | v | String | Y | 1.0 | |
| 秒级时间戳 | timestamp | int | Y | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
| 签名 | sign | String | Y | 签名 | |
| 分页大小 | page_size | int | N | 分页大小,分页查询必传 | |
| 分页编号 | page_no | int | N | 分页编号,分页查询必传,标准接口page_no从0开始 | |
| 是否计算查询结果的总条数 | calc_total | int | N | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
3.3 业务请求参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 查询参数 | params | Map<String, Object> | Y | 查询参数 | |
| 分页 | pager | Pager | Y | 分页 |
params
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 开始时间 | start_time | String | Y | 修改时间 yyyy-MM-dd HH:mm:ss格式 | |
| 结束时间 | end_time | String | Y | 修改时间 yyyy-MM-dd HH:mm:ss格式 |
pager
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
分页大小 | page_size | Int | 4 | Y | 分页大小 |
页号 | page_no | Int | 4 | Y | 从0开始 |
4.响应参数
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
状态码 | status | Int | Y | 返回0为正常 | |
错误信息 | message | String | Y | 无错误信息不返回 | |
单据数据 | data | Map<String, Object> | Y | 出库单相关数据 |
data
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
数据节点 | order_list | List<Map<String, Object>> | Y | 数据节点 | |
| 总数 | total_count | Int | 11 | N | 查询条件总单据数 |
order_list
| 名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
|---|---|---|---|---|---|
| 出库单id | stockout_id | Int | Y | 出库单id | |
| 出库单编号 | stockout_no | String | Y | 出库单编号 | |
| 出库单状态 | status | Byte | Y | 5:已取消 10:待放回 51:缺货 53:wms已接单 54:获取电子面单 60:待分配 61:排队中 63:待补货 65:待处理 70:待发货 73:爆款锁定 75:待拣货 77:拣货中,PDA拣货后 79:已拣货 90:延时发货 110:已完成 | |
| 最后修改时间 | modified | String | Y | 最后修改时间 |
5.请求示例
| [{
"start_time": "2022-07-19 10:42:56",
"end_time": "2022-07-19 11:42:56"
}] |
| <?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")
$params = new stdClass();
$params->start_time = '2022-07-19 10:42:56';
$params->end_time = '2022-07-19 11:42:56';
$pager = new Pager(1, 0, true);
$data = $client->pageCall("wms.stockout.Sales.searchCancel", $pager, $params);?> |
6.响应示例
6.1正常响应示例
| {
"status": 0,
"data": {
"total_count": 2,
"order_list": [{
"stockout_no": "CH202210175",
"modified": "2022-10-17 14:03:36",
"stockout_id": 1630025,
"status": 110
}, {
"stockout_no": "CH202210176",
"modified": "2022-10-17 14:08:38",
"stockout_id": 1630026,
"status": 110
}]
}
} |
6.2异常响应示例
| {
"status": 100,
"message": "起止时间差最大1小时"
} |