U8C API中心

API中心

基本档案
客商管理档案

指导视频
对接方案模板
工具
游客

客商管理档案查询

接口所在U8C版本:U8 cloud2.7以及更高版本

详细描述:用于客商管理档案查询

API视频讲解API详情补丁列表常见问题参考

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/uapbd/custmandoc/query

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

参数名	是否数组	必填	描述
custcode	否	否	客商编码
custname	否	否	客商名称（模糊查询）
custnameis	否	否	客商名称（精确查询-5.0sp开始支持）
custshortname	否	否	客商简称（模糊查询）
endTs	否	否	结束时间
page_now	否	否	当前页
page_size	否	否	每页条数
pk_areacl	否	否	所属地区
startTs	否	否	开始时间
taxpayer	否	否	纳税人登记号
unitcode	否	是	公司

返回类型参数:

参数名	类型	是否数组	必填	描述	默认值
datas				客商管理信息
addrvo		是	否	地址信息
address	string	否	否	地点
addrname	string	否	是	发货地址名称
areaclname	string	否	是	所属地区
defaddrflag	boolean	否	否	是否默认地址
linkman	string	否	否	联系人
phone	string	否	否	电话
basebankvo		否	否
banks		否	否	客商银行
accaddr	string	否	否	银行地址
account	string	否	否	银行账号
accountname	string	否	否	账户名称
defflag	string	否	是	是否默认开户银行（Y/N）
memo	string	否	否	备注
pk_accbank	string	否	否	开户银行
pk_banktype	string	否	否	银行类别
pk_corp	string	否	否	公司（填写编码）
pk_cubasdoc	string	否	否	客商档案主键
pk_currtype	string	否	否	币种（填写编码）
baseBank		否	否	客商银行基本信息
accopendate	string	否	否	开户日期
account	string	否	是	账号
accountcode	string	否	是	账户编码
accountname	string	否	是	账户名称
bankarea	string	否	否	开户地区
city	string	否	否	城市
combineaccnum	string	否	否	联行号
contactpsn	string	否	否	联系人
custcode	string	否	否	客户编码
groupid	string	否	否	集团号
memo	string	否	否	备注
netqueryflag	int	否	否	网银开通状态
orgnumber	string	否	否	机构号
pk_bankdoc	string	否	是	开户银行
pk_banktype	string	否	是	银行类别
pk_currtype	string	否	是	币种
pk_netbankinftp	string	否	否	网银接口类别
province	string	否	否	省份
remcode	string	否	否	助记码
signflag	boolean	否	否	是否签约
tel	string	否	否	联系电话
unitname	string	否	否	单位名称
childrenvo	CumandocVO_insert	是	否	客商管理档案
acclimitcontrol	boolean	否	否	于客商总公司账期控制
bp	string	否	否	呼机
cmnecode	string	否	否	助记码
cooperateflag	boolean	否	否	是否收付协同
cooperatingdayfrom	string	否	否	合作期限从
cooperatingdayto	string	否	否	合作期限到
createtime	string	否	否	创建时间
creator	string	否	否	创建人
creditcontrol	boolean	否	否	基于客商总公司信用控制
creditlevel	string	否	否	信用等级(填写编码)
creditlimitnum	int	否	否	信用期限
creditmny	double	否	否	信用额度
creditmoney	double	否	否	信用保证金
credlimitflag	int	否	否	是否信用管制
custcode	string	否	否	客商编码
custflag	string	否	否	由于客商管理档案在数据库表中存的两条，所以childrenvo如果传的话需要传两条，这两条数据的客商属性字段必须是这些组合（客户0和4，供应商1和空格，客商2和3），不传childrenvo默认是客户0和4
custname	string	否	否	客商名称
custstate	int	否	否	客商状态
def1	string	否	否	自定义项1
def10	string	否	否	自定义项10
def11	string	否	否	自定义项11
def12	string	否	否	自定义项12
def13	string	否	否	自定义项13
def14	string	否	否	自定义项14
def15	string	否	否	自定义项15
def16	string	否	否	自定义项16
def17	string	否	否	自定义项17
def18	string	否	否	自定义项18
def19	string	否	否	自定义项19
def2	string	否	否	自定义项20
def20	string	否	否	自定义项20
def21	string	否	否	自定义项21
def22	string	否	否	自定义项22
def23	string	否	否	自定义项23
def24	string	否	否	自定义项24
def25	string	否	否	自定义项25
def26	string	否	否	自定义项26
def27	string	否	否	自定义项27
def28	string	否	否	自定义项28
def29	string	否	否	自定义项29
def3	string	否	否	自定义项3
def30	string	否	否	自定义项30
def4	string	否	否	自定义项4
def5	string	否	否	自定义项5
def6	string	否	否	自定义项6
def7	string	否	否	自定义项7
def8	string	否	否	自定义项8
def9	string	否	否	自定义项9
developdate	string	否	否	发展日期
diffcurrflag	boolean	否	否	是否允许异币种核
discountrate	double	否	否	扣率
dr	int	否	否	删除标志
freeofacclmtcheck	boolean	否	否	免于帐期检查
freeofcremnycheck	boolean	否	否	免于信用额度检查
frozendate	string	否	否	冻结时间
frozenflag	boolean	否	否	是否冻结
grade	int	否	否	等级
innerctldays	string	否	否	内控帐期天数
iounit	boolean	否	否	筹投资单位
isagent	boolean	否	否	是否零售加盟店
ispromtesettlement	boolean	否	否	是否催款
linkman	string	否	否	联系人
memo	string	否	否	备注
mobilephone	string	否	否	手机
modifier	string	否	否	修改人
modifytime	string	否	否	修改时间
pk_areacl	string	否	否	地区分类
pk_calbody	string	否	否	库存组织(填写编码)
pk_corp	string	否	否	公司(填写编码)
pk_currtype1	string	否	否	默认交易币种(填写编码)
pk_cusmandoc2	string	否	否	开票客商(填写编码)
pk_cusmandoc3	string	否	否	发货客商(填写编码)
pk_defbusitype	string	否	否	默认业务类型(填写编码)
pk_payterm	string	否	否	默认收付款协议(填写编码)
pk_pricegroupcorp	string	否	否	公司价格分组(填写编码)
pk_respdept1	string	否	否	专管部门(填写编码)
pk_resppsn1	string	否	否	专管业务员(填写编码)
pk_salestru	string	否	否	销售组织(填写编码)
pk_sendtype	string	否	否	发运方式(填写编码)
pk_settleunit	string	否	否	结算单位主键(已废弃)
pk_stordoc2	string	否	否	仓库档案(填写编码)
prepaidratio	int	否	否	预收款比例
ratifydate	string	否	否	批准日期
sealflag	string	否	否	封存标志
stockpriceratio	int	否	否	存货最低售价比例
testsalemoney	double	否	否	新产品试销保证金
custbankvo		是	否	客商银行
accname	string	否	否	银行名称（此处也传开户银行编码）	这里传开户银行编码的作用是把省份、城市和联行号自动带过来
accopendate	string	否	否	开户日期（5.0sp开始支持）
account	string	否	是	银行账户
accountname	string	否	否	账户名称
accountproperty	string	否	否	账户性质（5.0sp开始支持）
bankarea	string	否	否	开户地区（5.0sp开始支持）
banktypename	string	否	是	银行类别(填写编码)
city	string	否	否	城市（5.1sp开始支持）
defflag	string	否	是	是否默认
memo	string	否	否	备注
pk_accbank	string	否	否	银行账户主键
pk_bankdoc	string	否	否	开户银行编码（5.0sp开始支持）
pk_corp	string	否	否	公司(填写编码)
pk_cubasdoc	string	否	否	客商档案主键
pk_currtype	string	否	否	币种(填写编码)
pk_custbank	string	否	否	银行主键（修改接口传，当status=1或3时必传，status=2时不传,客商基本档案银行信息修改3.6及上版本支持）
province	string	否	否	省份（5.1sp开始支持）
status	string	否	否	修改状态(修改接口传，1修改，2新增，3删除)
ts	string	否	否	时间戳
unitname	string	否	否	单位名称（5.0sp开始支持）
parentvo		否	否	客商基本档案
bp1	string	否	否	呼机1
bp2	string	否	否	呼机2
bp3	string	否	否	呼机3
conaddr	string	否	否	通信地址
creator	string	否	是	创建人
custcode	string	否	否	客商编码（5.0开始可以不传客商编码支持自动生成）
custname	string	否	是	客商名称
custprop	string	否	是	客商类型(0 - 外部单位,1 - 内部核算单位,2 - 内部法人单位,3 - 内部渠道成员)
custshortname	string	否	是	客商简称
def1	string	否	否	自定义1
def2	string	否	否	自定义2
def3	string	否	否	自定义3
def4	string	否	否	自定义4
def5	string	否	否	自定义5
drpnodeflag	boolean	否	否	是否drp节点
ecotypesincevfive	string	否	否	经济类型(填写编码)
email	string	否	否	e-mail地址
engname	string	否	否	外文名称
fax1	string	否	否	传真1
fax2	string	否	否	传真2
freecustflag	boolean	否	否	是否散户
isconnflag	boolean	否	否	是否渠道成员
legalbody	string	否	否	法人
linkman1	string	否	否	联系人1
linkman2	string	否	否	联系人2
linkman3	string	否	否	联系人3
memo	string	否	否	备注
mnecode	string	否	否	助记码
mobilephone1	string	否	否	手机1
mobilephone2	string	否	否	手机2
mobilephone3	string	否	否	手机3
modifier	string	否	否	修改人（不传默认是UAP）
phone1	string	否	否	电话1
phone2	string	否	否	电话2
phone3	string	否	否	电话3
pk_areacl	string	否	是	所属地区(填写编码)
pk_corp1	string	否	否	对应公司(填写编码)
pk_cubasdoc	string	否	否	客商基本档案主键(修改时必填,新增时禁止传入)
pk_cubasdoc1	string	否	否	客商总公司编码(填写编码)
pk_pricegroup	string	否	否	价格分组(填写编码)
registerfund	string	否	否	注册资金
taxpayerid	string	否	否	纳税人登记号
trade	string	否	否	所属行业(填写编码)
url	string	否	否	web网址
zipcode	string	否	否	邮政编码

代码示例:

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

请求参数示例:

复制代码

{"page_size":"10","unitcode":"1000","page_now":"1","custcode":"CU0022","startTs":"2021-08-09 14:32:00","endTs":"2021-08-10 14:32:00"}

正确返回示例:

复制代码

 "data": "{\"allcount\":1,\"retcount\":1,\"datas\":[{\"parentvo\":{\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"pk_cubasdoc\":\"1001ZZ10000000006WGN\",\"custcode\":\"CU0022\",\"custname\":\"测试22\",\"custshortname\":\"测试22\",\"freecustflag\":false,\"drpnodeflag\":false,\"isconnflag\":false,\"custprop\":\"0\",\"pk_areacl\":\"000111100000000002DV\",\"areacl_code\":\"10\",\"areacl_name\":\"东北\",\"creator\":\"0001131000000000904C\",\"createtime\":\"2018-10-25 14:31:33\"},\"childrenvo\":[{\"acclimitcontrol\":false,\"cooperateflag\":false,\"createtime\":\"2018-10-25 14:31:33\",\"creator\":\"0001131000000000904C\",\"creditcontrol\":false,\"credlimitflag\":\"-1\",\"custflag\":\"0\",\"custstate\":\"0\",\"developdate\":\"2018-10-25\",\"diffcurrflag\":false,\"discountrate\":100,\"dr\":\"0\",\"freeofacclmtcheck\":false,\"freeofcremnycheck\":false,\"frozenflag\":false,\"iounit\":false,\"isagent\":false,\"ispromtesettlement\":true,\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"pk_cubasdoc\":\"1001ZZ10000000006WGN\",\"pk_cumandoc\":\"1001ZZ10000000006WGO\",\"pk_currtype1\":\"00010000000000000001\",\"currtypecode\":\"CNY\",\"currtypename\":\"人民币\",\"pk_cusmandoc2\":\"1001ZZ10000000006WGO\",\"pk_cusmandoc3\":\"1001ZZ10000000006WGO\",\"stockpriceratio\":\"100\"},{\"cooperateflag\":false,\"createtime\":\"2018-10-25 14:31:33\",\"creator\":\"0001131000000000904C\",\"credlimitflag\":\"-1\",\"custflag\":\"4\",\"custstate\":\"0\",\"diffcurrflag\":false,\"discountrate\":100,\"dr\":\"0\",\"freeofacclmtcheck\":false,\"freeofcremnycheck\":false,\"frozenflag\":false,\"iounit\":false,\"isagent\":false,\"ispromtesettlement\":true,\"pk_corp\":\"1001\",\"corp_code\":\"1000\",\"corp_name\":\"天海总公司\",\"pk_cubasdoc\":\"1001ZZ10000000006WGN\",\"pk_cumandoc\":\"1001ZZ10000000006WGP\",\"pk_cusmandoc2\":\"1001ZZ10000000006WGP\",\"pk_cusmandoc3\":\"1001ZZ10000000006WGP\"}]}]}"

错误返回示例:

复制代码

"无法绑定由多个部分组成的标识符 \"bd_cubasdoc.custcode\"。