跳到主要内容

同步仓库资料

建议

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

| 基本信息​

信息值备注
接口名称同步仓库资料获取EFF_DD大于StartTime的仓库资料
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/Wh/SyncData?StartTime=向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/Wh/SyncData?StartTime=远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数
支持日期2020-12-11自该日期起支持

| 请求参数​

Headers​

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

Query Params​

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

Body​

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

| 返回数据​

参数名称类型是否必须参数值备注其它信息
CallIDstring否MY_WH调用的基础资料名MY_WH:仓库
CallOKstring否T执行是否成功, 是:"T" 否:"F"
BillDataobject否"Data": [],
"DataCount": 0		基础资料，json格式Data里面才是数据信息，DataCount为返回的记录数
ErrorStrstring否错误信息

| 调用范例​

Request​

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

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

Response​

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

| 备注​

  • 必须在Headers里面传入用户登录或账套验证的LoginId。
  • EFF_DD为空未审核数据不返回。
  • 自定义字段与普通字段一样的方式返回，自定义字段区分用户。
  • 每次返回最大笔数为OneQueryCount，OneQueryCount为空则返回全部，以EFF_DD进行升序。
提示

StartTime的格式为时间戳，例如1604367231代表2020-11-03 09:33:51，可为空，为空时返回所有数据。 循环调用:第一次调用时 StartTime 设置为空，获取全部资料。调用方需要记录上次获取成功后的最后一 笔 EFF_DD 作为下次调用的 StartTime。若再次调用时返回有数据，返回的数据代表有过变动（新增或编辑）的资料，同时需更新下次调用的 StartTime。若再次调用时无数据返回，则 StartTime 保持不变。