查询客户厂商资料
基本信息
| 信息 | 值 | 备注 |
|---|---|---|
| 接口名称 | 查询客户厂商资料 | 分页查询客户厂商资料，默认按 EFF_DD 倒序 |
| 请求状态 | POST | RESTful 方式 |
| 接口路径 | http://localhost:23798/api/Cust/List | 向服务器地址发送 POST 请求 |
| 远程模式 | http://www.linkerplus.com/api/ext_erp/Cust/List | 远程模式向服务器地址发送 POST 请求，需要 ERP 注册号注册远程模式，并在 Headers 添加 sn 参数 |
| 支持日期 | 2023-12-29 | 自该日期起支持 |
请求参数
Headers
| 参数名称 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|
| Content-Type | 是 | application/json | 用于指定数据的传输类型 |
| LoginId | 是 | e835943e-55c2-4bf0-832d-6f4166592941 | 用户登录的 LoginId，取用户登录或账套验证接口返回的 LoginId |
| sn | 否 | MGR_REST_1001 | 远程模式需添加 sn 参数，MGR_REST_ERP注册号 |
Body
| 参数名称 | 类型 | 是否必须 | 参数值 | 备注 |
|---|---|---|---|---|
| CURRENT_PAGE | number | 是 | 1 | 当前页码，表示返回该页数据 |
| PAGE_SIZE | number | 否 | 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": "", // 截止客户/厂商区域
"CUS_OBJ_ID": "", // 客户/厂商类别，"1"：客户 "2"：厂商 "3"：客户/厂商
"NAME": "" // 客户/厂商名称，模糊匹配
}
返回数据
| 参数名称 | 类型 | 参数值 | 备注 |
|---|---|---|---|
| code | number | 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": "", // 截止客户/厂商区域
"CUS_OBJ_ID": "", // 客户/厂商类别，"1"：客户 "2"：厂商 "3"：客户/厂商
"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。 - EFF_DD 为空未审核数据不返回。
- 自定义字段与普通字段一样的方式返回，自定义字段区分用户。
使用该接口同步客户厂商资料的建议
排序条件不用填，第一次调用后，记录第1页第一项数据的 EFF_DD，作为下一次调用的 FILTER 中的 START_DD 的传值，若下一次调用有数据返回，则表示有客户厂商数据更新或者新增，通过此方法可获取全部客户厂商数据。