跳到主要内容

同步员工资料

建议

建议采用Salm/List分页接口进行资料同步。

| 基本信息​

信息值备注
接口名称同步员工资料获取EFF_DD大于StartTime的员工资料
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Salm/SyncData?StartTime=向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Salm/SyncData?StartTime=远程模式向服务器地址发送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注册号

Query​

参数名称是否必须参数值备注
StartTime否StartTime=1604367231StartTime的格式为时间戳，例如1604367231代表2020-11-03 09:33:51，获取EFF_DD大于该时间的数据，可为空，为空时返回所以数据

Body​

参数名称类型是否必须参数值备注其它信息
OneQueryCountstring否5000返回的最大笔数一次请求返回的最多是多少笔记录
UsrNostring否ADMIN操作员账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo

| 返回数据​

参数名称类型参数值备注其它信息
CallIDstringSALM调用的基础资料名SALM:员工
CallOKstringT执行是否成功, 是:"T" 否:"F"
BillDataobject"Data": [],
"DataCount": 0		基础资料,JOSN格式Data里面才是数据信息，DataCount为返回的记录数
ErrorStrstring错误信息

| 调用范例​

BODY JSON​

无需赋值的字段不需要添加

{
    "OneQueryCount":"5000",                 //非必须,返回的最大笔数
    "UsrNo":"ADMIN"                         //非必须,操作员
}

返回的JSON​

{
    "CallID":"SALM",                        //调用的基础资料名
    "CallOK":"T",                           //执行是否成功, 是:"T" 否:"F"
    "BillData":{                            //基础资料,JOSN格式
       "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": ""//自定义字段
            }
        ],
        "DataCount": 1                      //返回的记录数
    },
    "ErrorStr":""                           //错误信息
}

| 备注​

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

StartTime的格式为时间戳，例如1604367231代表2020-11-03 09:33:51，可为空，为空时返回所有数据。

循环调用，第一次调用时 StartTime 设置为空，获取全部资料。调用方需要记录上次获取成功后的最后一 笔 EFF_DD 作为下次调用的 StartTime。若再次调用时返回有数据，返回的数据代表有过变动（新增或编辑）的资料，同时需更新下次调用的 StartTime。若再次调用时无数据返回，则 StartTime 保持不变。

每次返回最大笔数为OneQueryCount，OneQueryCount为空则返回全部，以EFF_DD进行升序。

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

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