跳到主要内容

查询员工资料

基本信息​

信息值备注
接口名称查询员工资料分页查询员工资料，默认按 EFF_DD 倒序
请求状态POSTRESTful 方式
接口路径http://localhost:23798/api/Salm/List向服务器地址发送 POST 请求
远程模式http://www.linkerplus.com/api/ext_erp/Salm/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否有值时：{"SAL_NO":"DESC","NAME":"ASC"}排序条件。按 SALM 表中栏位自动匹配，为空时按 EFF_DD 倒序。 DESC：降序、ASC：升序
### FILTER ###
{
    "START_DD": "", // 查询EFF_DD大于该时间的数据（可用于同步员工资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
    "SAL_NO_B": "", // 起始员工代号
    "SAL_NO_E": "", // 截止员工代号
    "NAME": "", // 员工名称，模糊匹配
    "DEP": "" // 员工部门代号，模糊匹配
}

返回数据​

参数名称类型参数值备注
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
        "SAL_NO_B": "", // 起始员工代号
        "SAL_NO_E": "", // 截止员工代号
        "NAME": "", // 员工名称，模糊匹配
        "DEP": "" // 员工部门代号，模糊匹配
    },
    "ORDER_BY": {} // 选填，排序条件，按SALM表栏位自动匹配，默认以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": [
            {
              "SAL_NO": "002", // 员工代号
              "NAME": "002", // 员工名称
              "SEX": "", // 性别
              "CON_ADR": "", // 联络地址
              "TEL1": "", // 电话号码
              "TEL2": "", // 手机号码
              "DEP": "", // 部门代号
              "DUT_IN_D": "", // 到职日
              "DUT_OT_D": "", // 离职日
              "HOM_ADR": "", // 家庭住址
              "REM": "", // 备注
              "UP_SAL_NO": "", // 上级业务
              "E_MAIL": "", // 电子邮件
              "ENG_NAME": "dfgdf", // 英文名称
              "EFF_DD": "2020/12/2 15:28:14", // 生效日期
              "ZDY": ""// 自定义字段
            }
        ]
    }
}

备注​

  • 必须在 Headers 里面传入用户登录或账套验证的LoginId。
  • EFF_DD 为空未审核数据不返回。
  • 自定义字段与普通字段一样的方式返回，自定义字段区分用户。
使用该接口同步员工资料的建议

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