U8C API中心

API中心

基本档案
客商基本档案

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

客商基本档案修改

接口所在U8C版本:U8 cloud3.0以及更高版本

详细描述: 5.0sp开始支持：请求头header增加传参“apiRepeatCheck=Y”，来控制当名称重复时允许保存。

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/uapbd/custdoc/update

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数修改开户银行新增开户银行删除开户银行修改账户性质和开户地区修改客商收发货地址

参数名	类型	是否数组	必填	描述	默认值
cbdocvo		是	是
addrs		是	否	修改_客商收发货地址VO
addrname	string	否	是	发货地址名称
defaddrflag	boolean	否	是	是否默认地址
linkman	string	否	否	联系人
phone	string	否	否	电话
pk_address	string	否	否	地点(填写编码)
pk_areacl	string	否	是	所属地区(填写编码)
pk_cubasdoc	string	否	否	客商档案主键
pk_custaddr	string	否	否	发货地址PK（修改接口传，当status为1或3时必传，2时不传）
status	string	否	否	修改状态(修改接口传，1:修改，2:新增，3:删除)
banks		是	否	客商基本档案表体客商银行
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		否	否	修改_客商基本档案表头VO
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	否	否	邮政编码

返回类型参数:

参数名	类型	是否数组	必填	描述
cbdocvo
addrs		是	否	客商收发货地址VO
addrname	string	否	是	发货地址名称
defaddrflag	boolean	否	是	是否默认地址
linkman	string	否	否	联系人
phone	string	否	否	电话
pk_address	string	否	否	地点(填写编码)
pk_areacl	string	否	是	所属地区(填写编码)
pk_cubasdoc	string	否	否	客商档案主键
pk_custaddr	string	否	否	发货地址PK（修改接口传，当status为1或3时必传，2时不传）
status	string	否	否	修改状态(修改接口传，1:修改，2:新增，3:删除)
banks		是	否	客商银行VO
accaddr	string	否	否	银行地址
account	string	否	否	银行账户
accountname	string	否	否	账户名称
defflag	boolean	否	否	是否默认
memo	string	否	否	备注
pk_accbank	string	否	否	银行账户主键
pk_bankdoc	string	否	否	开户银行
pk_banktype	string	否	否	银行类别
pk_corp	string	否	否	公司
pk_cubasdoc	string	否	否	客商档案主键
pk_currtype	string	否	否	币种类别
parentvo		否	否	客商基础档案主表VO
accdefault	string	否	否	默认账户
bp1	string	否	否	呼机1
bp2	string	否	否	呼机2
bp3	string	否	否	呼机3
conaddr	string	否	否	通信地址
createtime	string	否	否	创建时间
creator	string	否	否	创建人
creditmny	string	否	否	信用额度
custcode	string	否	否	客商编码（5.0开始可以不传客商编码支持自动生成）
custname	string	否	是	客商名称
custprop	int	否	否	客商类型（0 - 外部单位1 - 内部核算单位2 - 内部法人单位3 - 内部渠道成员）
custshortname	string	否	是	客商简称
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	否	否	自定义项2
def20	string	否	否	自定义项20
def3	string	否	否	自定义项3
def4	string	否	否	自定义项4
def5	string	否	否	自定义项5
def6	string	否	否	自定义项6
def7	string	否	否	自定义项7
def8	string	否	否	自定义项8
def9	string	否	否	自定义项9
drpnodeflag	string	否	否	是否drp结点
ecotypesincevfive	string	否	否	经济类型
email	string	否	否	e-mail地址
engname	string	否	否	外文名称
fax1	string	否	否	传真1
fax2	string	否	否	传真2
freecustflag	string	否	否	是否散户
isconnflag	string	否	否	所属行业
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	否	否	修改人
modifytime	string	否	否	修改时间
phone1	string	否	否	电话1
phone2	string	否	否	电话2
phone3	string	否	否	电话3
pk_areacl	string	否	是	所属地区（填写对应编码）
pk_corp	string	否	否	公司主键（填写对应编码）
pk_corp1	string	否	否	对应公司（填写对应编码）
pk_cubasdoc1	string	否	否	客商总公司编码
pk_pricegroup	string	否	否	价格分组（填写对应编码）
registerfund	string	否	否	注册资金
saleaddr	string	否	否	营业地址
sealflag	string	否	否	封存标志
taxpayerid	string	否	否	纳税人登记号
trade	string	否	否	所属行业
url	string	否	否	web网址
zipcode	string	否	否	邮政编码

代码示例:

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

请求参数示例:

修改开户银行新增开户银行删除开户银行修改账户性质和开户地区修改客商收发货地址

复制代码

{
	"cbdocvo": [{
		"parentvo": {
			"pk_cubasdoc": "0001F410000000044TTM"
		},
		"banks": [{
			"pk_custbank": "0001F410000000044TTQ",
			"accname": "0204",
			"status": 1
		}]
	}]
}

正确返回示例:

修改开户银行新增开户银行删除开户银行修改账户性质和开户地区修改客商收发货地址

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_cubasdoc\":\"0001F410000000044TTM\"},\"ADDR\":[],\"BANK\":[{\"pk_custbank\":\"0001F410000000044TTQ\",\"pk_cubasdoc\":\"0001F410000000044TTM\",\"pk_accbank\":\"0001F410000000044TTP\",\"defflag\":false,\"ts\":\"2023-09-01 11:09:21\"}]}]","taskNumber":"202309010009"}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
"errormsg": "客商编码不能重复",
  "stacktrace": 
"nc.vo.pub.BusinessException: 客商编码不能重复\r\nu8c.bs.bd.custdoc.bp.CustdocAPIUpdateBP.checkCustCodeNameUnique(CustdocAPIUpdateBP.java:179)\r\nu8c.bs.bd.custdoc.bp.CustdocAPIUpdateBP.validator(CustdocAPIUpdateBP.java:49)\r\nu8c.bs.bd.custdoc.bp.CustdocAPIUpdateBP.update(CustdocAPIUpdateBP.java:76)\r\nu8c.impl.bd.custdoc.action.CustdocAPIUpdateAction.save(CustdocAPIUpdateAction.java:16)\r\nu8c.impl.bd.custdoc.action.CustdocAPIUpdateAction.save(CustdocAPIUpdateAction.java:1)\r\nu8c.bs.action.save.AbstractBatchSaveAction.doAction(AbstractBatchSaveAction.java:54)\r\nu8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:79)\r\nu8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:29)\r\nsun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)\r\nsun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:606)\r\nnc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22)\r\nnc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44)\r\nnc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61)\r\nsun.reflect.GeneratedMethodAccessor40.invoke(Unknown Source)\r\nsun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)\r\njava.lang.reflect.Method.invoke(Method.java:606)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56)\r\nnc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34)\r\ncom.sun.proxy.$Proxy11.delegate(Unknown Source)\r\nnc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32)\r\ncom.sun.proxy.$Proxy21.invoke(Unknown Source)\r\nu8c.server.APIController.forWard(APIController.java:100)\r\nu8c.server.APIServletForJSON.doAction(APIServletForJSON.java:23)\r\nnc.bs.framework.server.api.InvokerAPIServlet.doAction(InvokerAPIServlet.java:157)\r\nnc.bs.framework.server.api.InvokerAPIServlet.doPost(InvokerAPIServlet.java:76)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:641)\r\njavax.servlet.http.HttpServlet.service(HttpServlet.java:722)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\norg.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\nnc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34)\r\norg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241)\r\norg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208)\r\norg.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:218)\r\norg.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110)\r\norg.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506)\r\norg.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169)\r\norg.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103)\r\norg.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116)\r\norg.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:683)\r\norg.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445)\r\norg.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115)\r\norg.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637)\r\norg.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:316)\r\njava.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)\r\njava.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)\r\norg.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61)\r\njava.lang.Thread.run(Thread.java:745)\r\n"
}