API中心

  1. 基本档案
  2. 客商基本档案
返回

客商基本档案查询

接口所在U8C版本:U8 cloud2.7以及更高版本
详细描述:用于客商基本档案查询
API视频讲解API详情补丁列表常见问题参考
接口地址
请求方式
请求参数header
请求参数body
返回类型参数
代码示例
请求参数示例
正确返回示例
错误返回示例
接口地址:http://ip:port/u8cloud/api/uapbd/custdoc/query

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type是请求体数据类型application/json
usercode是用户
password是密码
system是系统参数

请求参数(body):

参数名类型是否数组必填描述默认值
custcode否否客商编码
custname否否客商名称（模糊查询）
custnameis否否客商名称（精确查询-5.0开始支持）
custshortname否否客商简称（模糊查询）
endCreatetime否否结束创建时间
endTs否否结束ts
page_now否否当前页
page_size否否每页条数
pk_areacl否否所属地区
startCreatetime否否起始创建时间
startTs否否起始ts
taxpayer否否纳税人登记号

返回类型参数:

参数名类型是否数组必填描述默认值
cbdocvo客商基本档案
addrs是否客商收发货地址VO
addrnamestring否是发货地址名称
defaddrflagboolean否是是否默认地址
linkmanstring否否联系人
phonestring否否电话
pk_addressstring否否地点(填写编码)
pk_areaclstring否是所属地区(填写编码)
pk_cubasdocstring否否客商档案主键
pk_custaddrstring否否发货地址PK（修改接口传，当status为1或3时必传，2时不传）
statusstring否否修改状态(修改接口传，1:修改，2:新增，3:删除)
banks是否客商银行VO
accaddrstring否否银行地址
accountstring否否银行账户
accountnamestring否否账户名称
defflagboolean否否是否默认
memostring否否备注
pk_accbankstring否否银行账户主键
pk_bankdocstring否否开户银行
pk_banktypestring否否银行类别
pk_corpstring否否公司
pk_cubasdocstring否否客商档案主键
pk_currtypestring否否币种类别
parentvo否否客商基础档案主表VO
accdefaultstring否否默认账户
bp1string否否呼机1
bp2string否否呼机2
bp3string否否呼机3
conaddrstring否否通信地址
createtimestring否否创建时间
creatorstring否否创建人
creditmnystring否否信用额度
custcodestring否否客商编码（5.0开始可以不传客商编码支持自动生成）
custnamestring否是客商名称
custpropint否否客商类型（0 - 外部单位1 - 内部核算单位2 - 内部法人单位3 - 内部渠道成员）
custshortnamestring否是客商简称
def1string否否自定义项1
def10string否否自定义项10
def11string否否自定义项11
def12string否否自定义项12
def13string否否自定义项13
def14string否否自定义项14
def15string否否自定义项15
def16string否否自定义项16
def17string否否自定义项17
def18string否否自定义项18
def19string否否自定义项19
def2string否否自定义项2
def20string否否自定义项20
def3string否否自定义项3
def4string否否自定义项4
def5string否否自定义项5
def6string否否自定义项6
def7string否否自定义项7
def8string否否自定义项8
def9string否否自定义项9
drpnodeflagstring否否是否drp结点
ecotypesincevfivestring否否经济类型
emailstring否否e-mail地址
engnamestring否否外文名称
fax1string否否传真1
fax2string否否传真2
freecustflagstring否否是否散户
isconnflagstring否否所属行业
legalbodystring否否法人
linkman1string否否联系人1
linkman2string否否联系人2
linkman3string否否联系人3
memostring否否备注
mnecodestring否否助记码
mobilephone1string否否手机1
mobilephone2string否否手机2
mobilephone3string否否手机3
modifierstring否否修改人
modifytimestring否否修改时间
phone1string否否电话1
phone2string否否电话2
phone3string否否电话3
pk_areaclstring否是所属地区（填写对应编码）
pk_corpstring否否公司主键（填写对应编码）
pk_corp1string否否对应公司（填写对应编码）
pk_cubasdoc1string否否客商总公司编码
pk_pricegroupstring否否价格分组（填写对应编码）
registerfundstring否否注册资金
saleaddrstring否否营业地址
sealflagstring否否封存标志
taxpayeridstring否否纳税人登记号
tradestring否否所属行业
urlstring否否web网址
zipcodestring否否邮政编码

代码示例:

Java模板示例下载C#模板示例下载

请求参数示例:

复制代码

{"custcode":"","custname":"","custshortname":"","page_now":"","page_size":"","pk_areacl":"","startTs":"2021-08-09 14:32:00","endTs":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "{"allcount":48,"retcount":1,"datas":[{"parentvo":{"pk_corp":"0001","pk_cubasdoc":"000111100000000006JK","custcode":"C1014","custname":"沈阳康贝商贸有限公司","custshortname":"沈阳康贝商贸有限公司","freecustflag":false,"drpnodeflag":false,"isconnflag":false,"custprop":"0","pk_areacl":"000111100000000002DV","areacl_code":"10","areacl_name":"东北","pk_pricegroup":"00011110000000000FGG","pricegroup_code":"01","pricegroup_name":"经销商","creator":"0001111000000000011U","createtime":"2017-09-04 12:53:46","modifier":"000111100000000000VI","modifytime":"2017-09-11 14:41:48"},"ADDR":[],"BANK":[{"pk_custbank":"000111100000000020LV","pk_cubasdoc":"000111100000000006JK","pk_accbank":"000111100000000020LU","defflag":false,"ts":"2017-09-13 15:12:19"}]}]}"
}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
errormsg: "有错误",
stacktrace: "nc.bs.dao.BaseDAO.executeQuery(BaseDAO.java:73);......"
}