同步客户厂商资料
建议
建议采用Cust/List分页接口进行资料同步。
| 基本信息
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 同步客户厂商资料 | 获取EFF_DD大于StartTime的客户厂商资料 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/Cust/SyncData?StartTime= | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Cust/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 | CUST | 调用的基础资料名 | CUST:客户厂商 |
| CallOK | string | T | 执行是否成功, 是:"T" 否:"F" | |
| BillData | object | "Data": [], "DataCount": 0 | 基础资料，json格式 | Data里面才是数据信息，DataCount为返回的记录数 |
| ErrorStr | string | 错误信息 |
| 调用范例
Request
无需赋值的字段不需要添加
{
"OneQueryCount":"5000", // 非必须，返回的最大笔数
"UsrNo":"ADMIN" // 非必须，操作员
}
Response
{
"CallID":"CUST", // 调用的基础资料名
"CallOK":"T", // 执行是否成功，是:"T" 否:"F"
"BillData":{ // 基础资料，json格式
"Data": [ // 数据信息
{
"CUS_NO": "KH003", // 客户代号
"IDX2": "", // 中类代号
"CUS_ARE": "HB", // 区域
"MAS_CUS": "", // 归属对象
"OBJ_ID": "1", // 对象别:1 客户，2 厂商，3 客户厂商
"NAME": "国美电器", // 全称
"SNM": "国美电器", // 简称
"NM_ENG": "", // 英文名称
"CHK_MAN": "001", // 审核人员
"EFF_DD": "2015/10/18 9:49:47", // 生效日期
"PAY_DD": "0", // 结账日
"CLS_MTH": "1", // 结帐类别
"CLS_DD": "1", // 起算日
"MM_END": "30", // 间隔天数
"CHK_DD": "30", // 票据到期日
"UNI_NO": "", // 统一编号
"BOS_NM": "", // 负责人
"CNT_JOB1": "", // 联络人 1 职称
"CNT_MAN1": "", // 联络人 1
"CNT_JOB2": "", // 联络人 2 职称
"CNT_MAN2": "", // 联络人 2
"ACC_MAN": "", // 会计
"SAL": "", // 责任业务
"TEL1": "", // 电话 1
"TEL2": "", // 电话 2
"FAX": "", // 传真
"ZIP": "", // 邮政编码
"LIM_NR": "0.00000000", // 信用额度
"LIM_NC": "0.00000000", // 票据信用额度
"RTO_TAX": "0.00000000", // 税率
"CRD_ID": "1", // 信用管制
"INV_ID": "", // 发票类别
"ID1_TAX": "1", // 扣税类别
"CLS1": "", // 结帐方式
"CLS2": "1", // 立帐方式
"STR_DD": "", // 起始往来日期
"END_DD": "", // 截止往来日期
"CUR": "", // 使用币别
"CRD_NR_NC": "", // 需要管制信用
"E_MAIL": "", // 电子邮件
"SEND_MTH": "", // 送货方式
"SEND_WH": "", // 送货仓
"BNK_NAME": "", // 价格代号
"ID_CODE": "", // 银行帐号
"CUS_LEVEL": "1", // 客户等级
"LS_RTO": "0.00000000", // 利息率
"ID2_TAX": "F", // 按外币冲销否
"DEP_NO": "", // 责任部门
"COMPNET": "", // 公司网站
"COMP_DD": "", // 成立时间
"CAPSUM": "0.00000000", // 资本总额
"BUSISUM": "0.00000000", // 营业总额
"SALMS": "0", // 员工数
"BUSINOTE": "", // 营业性质
"WORKITM": "", // 经营项目
"MAIN_PRD": "", // 主要产品
"CHK_CRD": "F", // 信用额度含票据否
"NOTIFY": "", // 到港联络人
"BROKER": "", // 报关行
"VESSEL": "", // 船名
"LOADING_PORT": "", // 装货港/收货地
"DIS_PORT": "", // 卸货港/目的地
"MANU_PLACE": "", // 产地
"BANK_NO": "", // 银行代号
"ACC_NO_AR": "", // 应收帐款科目
"ACC_NO_AP": "", // 应付帐款科目
"ACC_NO_R0": "", // 应收票据科目
"ACC_NO_P0": "", // 应付票据科目
"SO_CRD": "F", // 信用管制含订单否
"FP_NAME": "", // 发票名称
"CHK_FAX": "F",// 信用管制含传真汇款否
"CHK_CUS_IDX": "1", // 信用检测
"CHK_IRP": "F", // 信用管制含预收款否
"ADR1": "", // 发票地址
"ADR2": "", // 公司地址
"CREATE_DD": "2015/10/9 0:00:00", // 创建日期
"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 保持不变。