同步货品资料
建议
建议采用Prdt/List分页接口进行资料同步。
| 基本信息
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 同步货品资料 | 获取EFF_DD大于StartTime的货品资料 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/Prdt/SyncData?StartTime= | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Prdt/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=1604367231 | StartTime的格式为时间戳，例如1604367231代表2020-11-03 09:33:51，获取EFF_DD大于该时间的数据，可为空，为空时返回所以数据 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 | 其它信息 |
|---|---|---|---|---|---|
| OneQueryCount | string | 否 | 5000 | 返回的最大笔数 | 一次请求返回的最多是多少笔记录 |
| UsrNo | string | 否 | ADMIN | 操作员 | 账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo |
| 返回数据
| 参数名称 | 类型 | 参数值 | 备注 | 其它信息 |
|---|---|---|---|---|
| CallID | string | PRDT | 调用的基础资料名 | PRDT:货品 |
| CallOK | string | T | 执行是否成功, 是:"T" 否:"F" | |
| BillData | object | "Data": [], "DataCount": 0 | 基础资料,JOSN格式 | Data里面才是数据信息，DataCount为返回的记录数 |
| ErrorStr | string | 错误信息 |
| 调用范例
BODY JSON
无需赋值的字段不需要添加
{
"OneQueryCount":"5000", //非必须,返回的最大笔数
"UsrNo":"ADMIN" //非必须,操作员
}
返回的JSON
{
"CallID":"PRDT", //调用的基础资料名
"CallOK":"T", //执行是否成功, 是:"T" 否:"F"
"BillData":{ //基础资料,JOSN格式
"Data": [ //数据信息
{
"PRD_NO": "A001",//货品代号
"SNM": "铁片",//简称
"IDX1": "",//中类代号
"UT": "片",//主单位
"UT1": "",//副单位
"DFU_UT": "1",//计量单位
"NAME": "铁片",//名称
"SPC": "",//规格
"KND": "4",//大类
"PK2_UT": "",//包装(一) 单位
"PK2_QTY": "1.00000000",//包装(一) 数量
"PK3_UT": "",//包装(二) 单位
"PK3_QTY": "1.00000000",//包装(二) 数量
"MRK": "",//品牌
"SUP1": "",//主供应商
"SUP2": "",//次供应商
"REM": "",//摘要
"PAK_UNIT": "",//包装单位
"PAK_EXC": "",//包装换算
"PAK_NW": "",//包装净重
"PAK_WEIGHT_UNIT": "",//包装净重单位
"PAK_GW": "",//包装毛重
"PAK_MEAST": "",//包装大小
"PAK_MEAST_UNIT": "",//包装大小单位
"STOP_ID": "",//停止使用
"NOUSE_DD": "",//货品停用日期
"FORMULA": "",//材积公式
"NAME_ENG": "",//英文名称
"CHK_BAT": "F",//批号管制否
"QTY_LOW": "",//批量
"WH": "",//预设仓库
"CHK_NUM": "F",//序列号管制否
"CHK_TAX": "F",//是农副产品
"VALID_DAYS": "",//有效天数
"DEP": "",//所属部门
"QTY_MIN": "",//安全存量
"QTY_MAX": "",//上限
"PRD_DD": "2020/11/16 0:00:00",//货品创建时间
"LOCK_STOCK_QTY": "F",//库存占用否
"LOCK_PRE_DAYS": "",//库存占用提前期
"CHK_YL": "",//余料管理否
"EFF_DD": "2020/11/16 13:59:44",//生效日期
"USR": "001",//录入员
"CHK_MAN": "001",//审核人
"CLS_DATE": "2020/11/16 0:00:00",//终审日期
"OBJ_TYPE": "",//所属分类
"PRD_CHK": "",//需检验
"CHK_MARK": "",//特征管制
"MARK_NO": "",//特征组
"PRD_ML": "",//倒冲领料
"DO_CODE": "tp",//助记码
"EP_MARK": "",//允许特征栏位为空
"MRK_NAME": "",//品牌名称
"RECORD_DD": "2020/11/16 13:59:44",//RECORD_DD
"UPR": "",//统一定价
"UP_SAL": "",//业务成本
"UPR_LEVEL1": "",//总代理价
"UPR_LEVEL2": "",//一级代理价
"UPR_LEVEL3": "",//二级代理价
"UPR_LEVEL4": "",//经销批发价
"UPR_LEVEL5": "",//一般客户价
"UP_MAX": "",//最高成本价
"UP_MIN": "",//最低售价
"UPR_TP": "",//会员价
"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为空未审核数据不返回。
自定义字段与普通字段一样的方式返回，自定义字段区分用户。