查询客户厂商资料
【基本信息】
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 查询客户厂商资料 | 分页查询客户厂商资料，默认按EFF_DD倒序 |
| 请求状态 | POST | RESTful方式 |
| 接口路径 | http://localhost:23798/api/Cust/List | 向服务器地址发送POST请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Cust/List | 远程模式向服务器地址发送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注册号 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|---|
| CURRENT_PAGE | int | 是 | 1 | 当前页码，表示返回该页数据 |
| PAGE_SIZE | int | 否 | 100 | 每页数据数量，默认【100】，值在【1-1000】中选择，传其它值会取默认值 |
| USR_NO | string | 否 | 用户代号。账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加USR_NO | |
| FILTER | object | 否 | 见下方详细说明 | 过滤条件 |
| ORDER_BY | object | 否 | 有值时：{"CUS_NO":"DESC","NAME":"ASC"} | 排序条件。按CUST表中栏位自动匹配，为空时按EFF_DD倒序。 DESC：降序、ASC：升序 |
### FILTER ###
{
"START_DD": "", //查询EFF_DD大于该时间的数据（可用于同步客户厂商资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
"CUS_NO_B": "", // 起始客户/厂商代号
"CUS_NO_E": "", // 截止客户/厂商代号
"CUS_AREA_B": "", // 起始客户/厂商区域
"CUS_AREA_E": "", // 截止客户/厂商区域
"NAME": "" // 客户/厂商名称，模糊匹配
}
【返回数据】
| 参数名称 | 类型 | 参数值 | 备注 |
|---|---|---|---|
| code | int | 0：表示查询成功。 1：表示查询失败。 | |
| message | string | 执行信息 | |
| result | object | 查询到的信息，JSON格式，具体信息参考下面调用范例 |
【调用范例】
请求：
{
"CURRENT_PAGE": 1, //必填，当前第几页
"PAGE_SIZE": 1, //选填，默认每页100，可传1-1000
"USR_NO": "ADMIN", //账套验证的LoginId需添加USR_NO，用户登录的LoginId则无需添加
"FILTER": {//选填
"START_DD": "", //查询EFF_DD大于该时间的数据（可用于同步客户厂商资料数据），格式为yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
"CUS_NO_B": "", // 起始客户/厂商代号
"CUS_NO_E": "", // 截止客户/厂商代号
"CUS_AREA_B": "", // 起始客户/厂商区域
"CUS_AREA_E": "", // 截止客户/厂商区域
"NAME": "" // 客户/厂商名称，模糊匹配
},
"ORDER_BY": {} //选填，排序条件，按CUST表栏位自动匹配，默认以EFF_DD倒序，使用此接口同步最新资料时，需记录第一页第一条数据的EFF_DD
}
返回：
{
"code":0,
"message":"查询成功。",
"result":{
"total": 50,
"total_page": 50,
"current_total": 1,
"current_page": 1,
"page_size": 1,
"has_pre": false,
"has_next": true,
"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-09 0:00:00",//创建日期
"ZDY": ""//自定义字段
}
]
}
}
【备注】
必须在Headers里面传入用户登录或账套验证的LoginId。
使用该接口同步客户厂商资料的建议
排序条件不用填，第一次调用后，记录第1页第一项数据的EFF_DD，作为下一次调用的FILTER中的START_DD的传值，若下一次调用有数据返回，则表示有客户厂商数据更新或者新增，通过此方法可获取全部客户厂商数据。
EFF_DD为空未审核数据不返回。
自定义字段与普通字段一样的方式返回，自定义字段区分用户。