跳到主要内容

查询仓库资料

基本信息​

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

请求参数​

Headers

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

Body

参数名称类型是否必须参数值备注
CURRENT_PAGEnumber是1当前页码，表示返回该页数据
PAGE_SIZEnumber否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": "" // 上层仓库，模糊匹配
}

返回数据​

参数名称类型参数值备注
codenumber0：表示查询成功。 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。
  • EFF_DD 为空未审核数据不返回。
  • 自定义字段与普通字段一样的方式返回，自定义字段区分用户。
使用该接口同步仓库资料的建议

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