跳到主要内容

查询仓库资料

【基本信息】​

信息值备注
接口名称查询仓库资料分页查询仓库资料，默认按EFF_DD倒序
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Wh/List向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Wh/List远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数

【请求参数】​

Headers

参数名称是否必须参数值备注
Content-Type是application/json用于指定数据的传输类型
LoginId是e835943e-55c2-4bf0-832d-6f4166592941用户登录的LoginId，取用户登录或账套验证接口返回的LoginId
sn否MGR_REST_1001远程模式需添加sn参数，MGR_REST_+ERP注册号

Body

参数名称类型是否必须参数值备注
CURRENT_PAGEint是1当前页码，表示返回该页数据
PAGE_SIZEint否100每页数据数量，默认【100】，值在【1-1000】中选择，传其它值会取默认值
USR_NOstring否用户代号。账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加USR_NO
FILTERobject否见下方详细说明过滤条件
ORDER_BYobject否有值时：{"WH":"DESC","NAME":"ASC"}排序条件。按MY_WH表中栏位自动匹配，为空时按EFF_DD倒序。 DESC：降序、ASC：升序
### FILTER ###
{
    "START_DD": "", //查询EFF_DD大于该时间的数据（可用于同步仓库资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
    "WH_B": "", //起始仓库代号
    "WH_E": "", //截止仓库代号
    "NAME": "", //仓库名称，模糊匹配
    "UP_WH": "" //上层仓库，模糊匹配
}

【返回数据】​

参数名称类型参数值备注
codeint0：表示查询成功。 1：表示查询失败。
messagestring执行信息
resultobject查询到的信息，JSON格式，具体信息参考下面调用范例

【调用范例】​

请求：

{
    "CURRENT_PAGE": 1, //必填，当前第几页
    "PAGE_SIZE": 1, //选填，默认每页100，可传1-1000
    "USR_NO": "ADMIN", //账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加
    "FILTER": {//选填
        "START_DD": "", ////查询EFF_DD大于该时间的数据（可用于同步仓库资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
        "WH_B": "", //起始仓库代号
        "WH_E": "", //截止仓库代号
        "NAME": "", //仓库名称，模糊匹配
        "UP_WH": "" //上层仓库，模糊匹配
    },
    "ORDER_BY": {} //选填，排序条件，按MY_WH表栏位自动匹配，默认以EFF_DD倒序，使用此接口同步最新资料时，需记录第一页第一条数据的EFF_DD
}

返回：

{
    "code":0,
    "message":"查询成功。",
    "result":{
        "total": 99,
        "total_page": 99,
        "current_total": 1,
        "current_page": 1,
        "page_size": 1,
        "has_pre": false,
        "has_next": true,
        "data": [
            {
              "WH": "0000",//库位
              "NAME": "First Stock",//名称
              "ATTRIB": "",//属性
              "DEP": "",//部门代号
              "ADR": "",//地址
              "TEL_NO": "",//电话
              "FAX_NO": "",//传真
              "UP_WH": "",//上层库位
              "CNT_MAN": "",//联系人
              "INVALID": "F",//废品仓否
              "STOP_DD": "",//停用日期
              "OUT_ID": "",//出库规则
              "EFF_DD": "2020-11-16 13:52:19",//有效日期
              "USR": "001",//录入员
              "CHK_MAN": "001",//审核人员
              "CLS_DATE": "2020-11-17 0:00:00",//终审日期
              "MINUS_STK": "",//允许负库存标识(T: 允许,F: 不允许)
              "RECORD_DD": "",//RECORD_DD
              "ZDY": ""//自定义字段
            }
        ]
    }
}

【备注】​

必须在Headers里面传入用户登录或账套验证的LoginId。

使用该接口同步仓库资料的建议

排序条件不用填，第一次调用后，记录第1页第一项数据的EFF_DD，作为下一次调用的FILTER中的START_DD的传值，若下一次调用有数据返回，则表示有仓库数据更新或者新增，通过此方法可获取全部仓库数据。

EFF_DD为空未审核数据不返回。

自定义字段与普通字段一样的方式返回，自定义字段区分用户。