U8C API中心

API中心

基本档案
客商基本档案

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

客商基本档案新增

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

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

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

参数名	必填	描述	默认值
Content-Type	是	请求体数据类型	application/json
usercode	是	用户
password	是	密码
apirepeatcheck	否	控制名称重复是否允许保存（V5.0sp开始支持）	传Y/N
trantype	是	翻译方式	code
system	是	系统参数
uniquekey	否	幂等唯一key

请求参数(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		是	否	客商基本档案表体客商银行VO-3.1版本支持
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	否	否	邮政编码

返回类型参数:

参数名	类型	是否数组	必填	描述
cbdocvos
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_areacl": "88",
			"custcode": "HJX880003",
			"custshortname": "test-客商基本档案新增",
			"custname": "test-客商基本档案新增"
		}
	}]
}

正确返回示例:

最简参数客商名称重复客商编码自动生成

复制代码

{"status":"success","data":"[{\"parentvo\":{\"pk_corp\":\"0001\",\"pk_cubasdoc\":\"0001F410000000044TT3\",\"custcode\":\"HJX880003\",\"custname\":\"test-客商基本档案新增\",\"custshortname\":\"test-客商基本档案新增\",\"freecustflag\":false,\"drpnodeflag\":false,\"isconnflag\":false,\"custprop\":\"0\",\"pk_areacl\":\"0001F410000000044TG3\",\"areacl_code\":\"88\",\"areacl_name\":\"韩继向专用客商\",\"creator\":\"#UAP#\",\"createtime\":\"2023-09-01 10:39:09\"},\"ADDR\":[],\"BANK\":[]}]","taskNumber":"202309010006"}

错误返回示例:

复制代码

{
status: "falied",
errorcode: "-32000",
errormsg: "[{"errormsg":"[客商编码] custcode :1200 和数据库重复! [客商名称]custname:用友1 和已有数据重复! 对应公司与下列内部客商的对应公司重复：公司编码: 0001,客商编码: 1200"}]",
stacktrace: "u8c.bs.bd.custdoc.pub.validate.AbstrarctExtAggBdBatchInsertValidator.executeUniqueFieldsValidate(AbstrarctExtAggBdBatchInsertValidator.java:237);u8c.bs.bd.custdoc.pub.validate.AbstrarctExtAggBdBatchInsertValidator.validate(AbstrarctExtAggBdBatchInsertValidator.java:45);u8c.bs.bd.custdoc.pub.bp.AbstractGeneralBatchInsertBp.beforeHandles(AbstractGeneralBatchInsertBp.java:117);u8c.bs.bd.custdoc.pub.bp.AbstractGeneralBatchInsertBp.batchInsertProcess(AbstractGeneralBatchInsertBp.java:74);u8c.impl.bd.custdoc.action.CustdocAPIBatchInsertAction.save(CustdocAPIBatchInsertAction.java:24);u8c.impl.bd.custdoc.action.CustdocAPIBatchInsertAction.save(CustdocAPIBatchInsertAction.java:8);u8c.bs.action.save.AbstractBatchSaveAction.doAction(AbstractBatchSaveAction.java:38);u8c.bs.invoke.bp.JSONInvokeBP.invoke(JSONInvokeBP.java:60);u8c.impl.invoke.json.InvokeWithJSonImpl.invoke(InvokeWithJSonImpl.java:25);sun.reflect.GeneratedMethodAccessor390.invoke(Unknown Source);sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43);java.lang.reflect.Method.invoke(Method.java:606);nc.bs.framework.ejb.CMTProxyImpl.delegate(CMTProxyImpl.java:22);nc.itf.framework.ejb.CMTProxyEjbBean.delegate(CMTProxyEjbBean.java:44);nc.itf.framework.ejb.CMTProxy_Local.delegate(CMTProxy_Local.java:61);sun.reflect.GeneratedMethodAccessor37.invoke(Unknown Source);sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43);java.lang.reflect.Method.invoke(Method.java:606);nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:56);nc.bs.framework.ejb.AbstractEJBServiceHandler.invoke(AbstractEJBServiceHandler.java:34);com.sun.proxy.$Proxy11.delegate(Unknown Source);nc.bs.framework.ejb.CMTEJBServiceHandler.invoke(CMTEJBServiceHandler.java:32);com.sun.proxy.$Proxy31.invoke(Unknown Source);u8c.server.APIServletForJSON.doAction(APIServletForJSON.java:117);nc.bs.framework.server.api.InvokerAPIServlet.doAction(InvokerAPIServlet.java:130);nc.bs.framework.server.api.InvokerAPIServlet.doPost(InvokerAPIServlet.java:65);javax.servlet.http.HttpServlet.service(HttpServlet.java:650);javax.servlet.http.HttpServlet.service(HttpServlet.java:731);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:303);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:52);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);nc.bs.framework.server.LoggerServletFilter.doFilter(LoggerServletFilter.java:34);org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:241);org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:208);org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:218);org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:110);org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:506);org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:169);org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:103);org.apache.catalina.valves.RemoteIpValve.invoke(RemoteIpValve.java:683);org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:116);org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:445);org.apache.coyote.http11.AbstractHttp11Processor.process(AbstractHttp11Processor.java:1115);org.apache.coyote.AbstractProtocol$AbstractConnectionHandler.process(AbstractProtocol.java:637);org.apache.tomcat.util.net.JIoEndpoint$SocketProcessor.run(JIoEndpoint.java:316);java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145);java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615);org.apache.tomcat.util.threads.TaskThread$WrappingRunnable.run(TaskThread.java:61);java.lang.Thread.run(Thread.java:745);"
}