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