查询储位资料
【基本信息】
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 查询储位资料 | 分页查询储位资料,默认按PRD_LOC储位代号升序 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/WhLoc/List | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/WhLoc/List | 远程模式向服务器地址发送POST请求,需要ERP注册号注册远程模式,并在Headers添加sn参数 |
| 支持日期 | 2025-09-30 | 自该日期起支持 |
【请求参数】
Headers
| 参数名称 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|
| Content-Type | 是 | application/json | 用于指定数据的传输类型 |
| LoginId | 是 | e835943e-55c2-4bf0-832d-6f4166592941 | 用户登录的LoginId,取用户登录或账套验证接口返回的LoginId |
| sn | 否 | MGR_REST_1001 | 远程模式需添加sn参数,MGR_REST_ERP注册号 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|---|
| CURRENT_PAGE | number | 是 | 1 | 当前页码,表示返回该页数据 |
| PAGE_SIZE | number | 否 | 100 | 每页数据数量,默认【100】,值在【1-1000】中选择,传其它值会取默认值 |
| USR_NO | string | 否 | 用户代号。账套验证的LoginId需添加USR_NO,用户登录的LoginId则无需添加USR_NO | |
| FILTER | object | 否 | 见下方详细说明 | 过滤条件 |
| ORDER_BY | object | 否 | 有值时:{"WH":"DESC","NAME":"ASC"} | 排序条件。按储位资料表WH_LOC中栏位自动匹配,为空时默认按储位代号PRD_LOC升序。 DESC:降序、ASC:升序 |
### FILTER ###
{
"PRD_LOC": "A01", //储位代号,精准匹配,【选传】
"WH": "002", //储位仓库代号,精准匹配,【选传】
"NAME": "A01储位", //储位名称,模糊匹配,【选传】
"STOP_DD_B": "2025-09-30", //停用起始日期,格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss,查找停用日期大于等于该日期的数据,【选传】
"STOP_DD_E": "2025-09-30", //停用截止日期,格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss,查找停用日期小于等于该日期的数据,【选传】
"STOP_MAN": "ADMIN" //停用人,模糊匹配,【选传】
}
【返回数据】
| 参数名称 | 类型 | 参数值 | 备注 |
|---|---|---|---|
| code | number | 0:表示查询成功。 1:表示查询失败。 | |
| message | string | 执行信息 | |
| result | object | 查询到的信息,JSON格式,具体信息参考下面调用范例 |
【调用范例】
请求:
{
// 必填
"CURRENT_PAGE": 1, //当前第几页
// 可选填
"PAGE_SIZE": 100, // 默认每页100,可传1-1000
"USR_NO": "ADMIN", //账套验证的LoginId需添加USR_NO,用户登录的LoginId则无需添加
// 可选填,模糊查询
"FILTER": {
"PRD_LOC": "", // 储位代号,精准匹配
"WH": "", // 仓库代号,精准匹配
"NAME": "", // 储位名称,模糊匹配
"STOP_DD_B": "", // 停用日期-起始 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss格式,查找停用日期大于等于该日期的数据,【选传】
"STOP_DD_E": "", // 停用日期-截止 yyyy-MM-dd、yyyy-MM-dd HH:mm:ss格式,查找停用日期小于等于该日期的数据,【选传】
"STOP_MAN": "" // 停用人,模糊匹配
},
// 排序条件,默认以PRD_LOC升序
"ORDER_BY": {
}
}
返回:
{
"code": 0,
"message": "查询成功。",
"result": {
"total": 35,
"total_page": 35,
"current_total": 1,
"current_page": 1,
"page_size": 1,
"has_pre": false,
"has_next": true,
"data": [
{
"PRD_LOC": "A1-01", //储位代号
"NAME": "A1-01", //储位名称
"WH": "002", //储位仓库
"STOP_DD": "", //停用日期
"STOP_MAN": "" //停用人
}
]
}
}
【备注】
- 必须在Headers里面传入用户登录或账套验证的
LoginId。