同步货品资料
建议
建议采用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参数 |
| 支持日期 | 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=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 | 基础资料，json格式 | Data里面才是数据信息，DataCount为返回的记录数 |
| ErrorStr | string | 错误信息 |
| 调用范例
Request
无需赋值的字段不需要添加
{
"OneQueryCount":"5000", // 非必须，返回的最大笔数
"UsrNo":"ADMIN" // 非必须，操作员
}
Response
{
"CallID":"PRDT", // 调用的基础资料名
"CallOK":"T", // 执行是否成功, 是:"T" 否:"F"
"BillData":{ // 基础资料，json格式
"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。 - EFF_DD为空未审核数据不返回。
- 自定义字段与普通字段一样的方式返回，自定义字段区分用户。
- 每次返回最大笔数为OneQueryCount，OneQueryCount为空则返回全部，以EFF_DD进行升序。
提示
StartTime的格式为时间戳，例如1604367231代表2020-11-03 09:33:51，可为空，为空时返回所有数据。
循环调用：第一次调用时 StartTime 设置为空，获取全部资料。调用方需要记录上次获取成功后的最后一 笔 EFF_DD 作为下次调用的 StartTime。若再次调用时返回有数据，返回的数据代表有过变动（新增或编辑）的资料，同时需更新下次调用的 StartTime。若再次调用时无数据返回，则 StartTime 保持不变。