API中心

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

客商管理档案新增

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南
参数名必填描述默认值
Content-Type请求体数据类型application/json
usercode用户
password密码
trantype翻译类型,按编码为code,不需要翻译为pkcode
system系统参数
uniquekey幂等唯一key

请求参数(body):

全量参数最简参数带客商银行账户客商属性为客商客商属性为供应商
参数名类型是否数组必填描述默认值示例值
billvo
addrsaddrs_insert商收发货地址
addressstring地点(填写编码)
addrnamestring发货地址名称
defaddrflagboolean是否默认地址
drint删除标志
linkmanstring联系人
phonestring电话
pk_addressstring所属地点
pk_areaclstring所属地区(填写编码)
childrenvoCumandocVO_insert客商管理档案
acclimitcontrolboolean于客商总公司账期控制
bpstring呼机
cmnecodestring助记码
cooperateflagboolean是否收付协同
cooperatingdayfromstring合作期限从
cooperatingdaytostring合作期限到
createtimestring创建时间
creatorstring创建人
creditcontrolboolean基于客商总公司信用控制
creditlevelstring信用等级(填写编码)
creditlimitnumint信用期限
creditmnydouble信用额度
creditmoneydouble信用保证金
credlimitflagint是否信用管制
custcodestring客商编码
custflagstring由于客商管理档案在数据库表中存的两条,所以childrenvo如果传的话需要传两条,这两条数据的客商属性字段必须是这些组合(客户0和4,供应商1和空格,客商2和3),不传childrenvo默认是客户0和4
custnamestring客商名称
custstateint客商状态
def1string自定义项1
def10string自定义项10
def11string自定义项11
def12string自定义项12
def13string自定义项13
def14string自定义项14
def15string自定义项15
def16string自定义项16
def17string自定义项17
def18string自定义项18
def19string自定义项19
def2string自定义项20
def20string自定义项20
def21string自定义项21
def22string自定义项22
def23string自定义项23
def24string自定义项24
def25string自定义项25
def26string自定义项26
def27string自定义项27
def28string自定义项28
def29string自定义项29
def3string自定义项3
def30string自定义项30
def4string自定义项4
def5string自定义项5
def6string自定义项6
def7string自定义项7
def8string自定义项8
def9string自定义项9
developdatestring发展日期
diffcurrflagboolean是否允许异币种核
discountratedouble扣率
drint删除标志
freeofacclmtcheckboolean免于帐期检查
freeofcremnycheckboolean免于信用额度检查
frozendatestring冻结时间
frozenflagboolean是否冻结
gradeint等级
innerctldaysstring内控帐期天数
iounitboolean筹投资单位
isagentboolean是否零售加盟店
ispromtesettlementboolean是否催款
linkmanstring联系人
memostring备注
mobilephonestring手机
modifierstring修改人
modifytimestring修改时间
pk_areaclstring地区分类
pk_calbodystring库存组织(填写编码)
pk_corpstring公司(填写编码)
pk_currtype1string默认交易币种(填写编码)
pk_cusmandoc2string开票客商(填写编码)
pk_cusmandoc3string发货客商(填写编码)
pk_defbusitypestring默认业务类型(填写编码)
pk_paytermstring默认收付款协议(填写编码)
pk_pricegroupcorpstring公司价格分组(填写编码)
pk_respdept1string专管部门(填写编码)
pk_resppsn1string专管业务员(填写编码)
pk_salestrustring销售组织(填写编码)
pk_sendtypestring发运方式(填写编码)
pk_settleunitstring结算单位主键(已废弃)
pk_stordoc2string仓库档案(填写编码)
prepaidratioint预收款比例
ratifydatestring批准日期
sealflagstring封存标志
stockpriceratioint存货最低售价比例
testsalemoneydouble新产品试销保证金
custBanks客商开户银行
banks客商银行
accaddrstring银行地址
accountstring银行账号
accountnamestring账户名称
defflagstring是否默认开户银行(Y/N)
memostring备注
pk_accbankstring开户银行
pk_banktypestring银行类别
pk_corpstring公司(填写编码)
pk_cubasdocstring客商档案主键
pk_currtypestring币种(填写编码)
baseBank客商银行基本信息
accopendatestring开户日期
accountstring账号
accountcodestring账户编码
accountnamestring账户名称
bankareastring开户地区
citystring城市
combineaccnumstring联行号
contactpsnstring联系人
custcodestring客户编码
groupidstring集团号
memostring备注
netqueryflagint网银开通状态
orgnumberstring机构号
pk_bankdocstring开户银行
pk_banktypestring银行类别
pk_currtypestring币种
pk_netbankinftpstring网银接口类别
provincestring省份
remcodestring助记码
signflagboolean是否签约
telstring联系电话
unitnamestring单位名称
parentvoCustBasVO_insert客商基本档案
accdefaultstring默认账户
conaddrstring通信地址
correspondunitstring对应结算单位(已废弃)
createtimestring创建时间
creatorstring创建人
creditmnydouble信用额度
custcodestring客商编号
custnamestring客商名称
custpropint客商类型
custprop_namestring客商名称
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
drint删除标志
drpnodeflagboolean是否DRP结点
ecotype_namestring经济类型名称
ecotypesincevfivestring经济类型(填写编码)
emailstringE-mail地址
engnamestring外文名称
fax1string传真1
fax2string传真2
freecustflagboolean是否散户
isconnflagboolean是否渠道成员
legalbodystring法人
linkman1string联系人1
linkman2string联系人2
linkman3string联系人3
loginCorpstring登录公司
memostring备注
mnecodestring助记码
mobilephone1string手机1
mobilephone2string手机2
mobilephone3string手机3
modifierstring修改人
modifytimestring修改时间
phone1string电话1
phone2string电话2
phone3string电话3
pk_areaclstring地区分类(填写编码)
pk_corpstring公司(填写编码)
pk_cubasdoc1string客商总公司编码(填写编码)
pk_pricegroupstring价格分组(填写编码)
registerfunddouble注册资金
saleaddrstring营业地址
sealflag_bstring封存标志
taxpayeridstring纳税人登记号
tradestring所属行业(填写编码)
tsstring时间戳
urlstringWeb网址
zipcodestring邮政编码

返回类型参数:

参数名类型是否数组必填描述默认值
billvo客商管理档案实体_返回
addrs客商基本档案vo_返回
addrnamestring发货地址名称
defaddrflagboolean是否默认地址
linkmanstring联系人
phonestring电话
pk_addressstring地点(填写编码)
pk_areaclstring所属地区(填写编码)
pk_cubasdocstring客商档案主键
pk_custaddrstring发货地址PK(修改接口传,当status为1或3时必传,2时不传)
statusstring修改状态(修改接口传,1:修改,2:新增,3:删除)
childrenvo客商管理档案vo_返回
accawmnystring财务应收/应付
acclimitstring账期(已作废)
acclimitcontrolstring基于客商总公司账期控制
acclmtbegindatestring账期起算日期
balancemnystring可冲减金额
bodycodestring库存组织编码
bodynamestring库存组织名称
bpstring呼机
busawmnystring业务应收/应付
busicodestring默认业务类型编码
businamestring默认业务类型名称
cmnecodestring助记码
cooperateflagstring是否收付协同
cooperatingdayfromstring合作期限从
cooperatingdaytostring合作期限到
corp_codestring公司编码
corp_namestring公司名称
correspsettleunitstring对应结算单位
createtimestring创建时间
creatorstring创建人
creditcontrolstring基于客商总公司信用控制
creditlevelstring信用等级
creditlimitnumstring信用期限
creditmnystring信用额度
creditmoneystring信用保证金
credlimitflagstring是否信用管制
currtypecodestring默认交易币种编码
currtypenamestring默认交易币种名称
custcodestring开票客商编码
custflagstring客商属性
custnamestring开票客商名称
custstatestring客商状态
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
def21string自定义项21
def22string自定义项22
def23string自定义项23
def24string自定义项24
def25string自定义项25
def26string自定义项26
def27string自定义项27
def28string自定义项28
def29string自定义项29
def3string自定义项3
def30string自定义项30
def4string自定义项4
def5string自定义项5
def6string自定义项6
def7string自定义项7
def8string自定义项8
def9string自定义项9
deptcodestring专管部门编码
deptnamestring专管部门名称
developdatestring发展日期
diffcurrflagstring是否允许异币种核销
discountratestring扣率
doccodestring信用等级编码
docnamestring信用等级名称
drstring删除标志
freeofacclmtcheckstring免于帐期检查
freeofcremnycheckstring免于信用额度检查
frozendatestring冻结时间
frozenflagstring是否冻结
gradestring等级
innerctldaysstring内控帐期天数
iounitstring筹投资单位
isagentstring是否零售加盟店
ispromtesettlementstring是否催款
linkmanstring联系人
memostring备注
mobilephonestring手机
modifierstring修改人
modifytimestring修改时间
ordawmnystring订单应收/应付
pk_calbodystring库存组织
pk_corpstring公司主键
pk_cubasdocstring客商档案主键
pk_cumandocstring客商管理档案主键
pk_currtype1string默认交易币种
pk_cusmandoc2string开票客商
pk_cusmandoc3string发货客商
pk_defbusitypestring默认业务类型
pk_paytermstring默认收付款协议
pk_pricegroupcorpstring公司价格分组
pk_respdept1string专管部门
pk_resppsn1string专管业务员
pk_salestrustring销售组织
pk_sendtypestring发运方式主键
pk_settleunitstring结算单位主键(已废弃)
pk_stordoc2string仓库档案主键
prepaidratiostring预收款比例
psncodestring专管业务员编码
psnnamestring专管业务员名称
ratifydatestring批准日期
sealflagstring封存标志
sendnamestring发运方式名称
sendodestring发运方式编码
stockpriceratiostring存货最低售价比例
storcodestring仓库档案编码
stornamestring仓库档案名称
termidstring默认收付款协议编码
termnamestring默认收付款协议名称
testsalemoneystring新产品试销保证金
tsstring时间戳
vsalestrucodestring销售组织编码
vsalestrunamestring销售组织名称
custBanks客商银行聚合vo_返回
banks客商银行vo_返回
accaddrstring银行地址
accountstring银行账户
accountnamestring账户名称
defflagboolean是否默认
memostring备注
pk_accbankstring银行账户主键
pk_bankdocstring开户银行
pk_banktypestring银行类别
pk_corpstring公司
pk_cubasdocstring客商档案主键
pk_currtypestring币种类别
baseBank客商银行基础vo_返回
childrenvo表体
highmny string最高余额
hignmnycontrolschestring最高余额控制方案
ishighmnycontrolstring是否最高余额控制
islowmnycontrolstring是否最低余额控制
istradestring是否用于交易
lowmnystring最低余额
lowmnycontrolschestring最低余额控制方案
pk_bankaccbasstring银行账户基本信息主键
pk_bankaccmngstring银行账户管理信息主键
pk_corpstring公司主键
parentvo表头
accattributestring账户属性
accclassstring账户分类
accopendatestring开户日期
account string账号
accountcodestring账户编码
accountnamestring账户名称
accountpropertystring账户性质
accstatestring账户状态
acctypestring账户类型
accxhdatestring销户日期
arappropstring收付属性
areacodestring地区代码
bankarea string开户地区
citystring城市
combineaccnumstring联行号
concertedmnystring协定金额
contactpsnstring联系人
corrgeneaccountstring对应总账户
createtimestring创建时间
creator string创建人
custcodestring客户编码
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
def21string自定义项21
def22string自定义项22
def23string自定义项23
def24string自定义项24
def25string自定义项25
def26string自定义项26
def27string自定义项27
def28string自定义项28
def29string自定义项29
def3string自定义项3
def30string自定义项30
def31string自定义项31
def32string自定义项32
def33string自定义项33
def34string自定义项34
def35string自定义项35
def36string自定义项36
def37string自定义项37
def38string自定义项38
def39string自定义项39
def4string自定义项4
def40string自定义项40
def41string自定义项41
def42string自定义项42
def43string自定义项43
def44string自定义项44
def45string自定义项45
def5string自定义项5
def6string自定义项6
def7string自定义项7
def8string自定义项8
def9string自定义项9
defrozendate string解冻日期
frozendatestring冻结日期
frozenjefloat冻结金额
fundformstring资金形态
genebranpropstring总分属性
groupaccountstring集团账户
groupidstring集团号
isinneraccstring是否内部账户
ismarginstring保证金账户
mainaccountstring对应银行账号
memostring备注
modifierstring修改人
modifytimestring修改时间
netqueryflaglong网银开通状态
orgnumberstring机构号
ownercorpstring开户公司
pk_bankaccbasstring银行账户基本信息主键
pk_bankdocstring开户银行
pk_banktypestring银行类别
pk_corp string公司主键
pk_currtypestring币种
pk_netbankinftpstring网银接口类别
pk_psnbasdocstring备用金使用人
provincestring省份
qrybalanceitf string查询余额接口
remcodestring助记码
signflagstring是否签约
telstring联系电话
unitnamestring单位名称
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经济类型
emailstringe-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所属行业
urlstringweb网址
zipcodestring邮政编码

请求参数示例:

最简参数带客商银行账户客商属性为客商客商属性为供应商

复制代码

{
    "billvo": [
        {
            "parentvo": {
                "custname": "公司新增客商03",
                "pk_areacl": "99",
                "custcode": "HJX990003",
                "pk_corp": "3401"
            }
        }
    ]
}

正确返回示例:

最简参数带客商银行账户客商属性为客商客商属性为供应商

复制代码

{
    "status": "success",
    "data": "[{\"parentvo\":{\"pk_corp\":\"1015\",\"corp_code\":\"3401\",\"corp_name\":\"hjx建设银行有限公司\",\"pk_cubasdoc\":\"0001A21000000004C0VP\",\"custcode\":\"HJX990003\",\"custname\":\"公司新增客商03\",\"custshortname\":\"公司新增客商03\",\"freecustflag\":false,\"drpnodeflag\":false,\"isconnflag\":false,\"custprop\":\"0\",\"pk_areacl\":\"1015F410000000001PQS\",\"areacl_code\":\"99\",\"areacl_name\":\"韩继向专业客商2\",\"creator\":\"#UAP#\",\"createtime\":\"2023-09-21 20:30:09\"},\"childrenvo\":[{\"acclimitcontrol\":false,\"cooperateflag\":false,\"createtime\":\"2023-09-21 20:30:09\",\"creator\":\"#UAP#\",\"creditcontrol\":false,\"credlimitflag\":\"-1\",\"custflag\":\"0\",\"custstate\":\"0\",\"developdate\":\"2023-09-21\",\"diffcurrflag\":false,\"discountrate\":\"100.00000000\",\"dr\":\"0\",\"freeofacclmtcheck\":false,\"freeofcremnycheck\":false,\"frozenflag\":false,\"iounit\":false,\"isagent\":false,\"ispromtesettlement\":true,\"pk_corp\":\"1015\",\"corp_code\":\"3401\",\"corp_name\":\"hjx建设银行有限公司\",\"pk_cubasdoc\":\"0001A21000000004C0VP\",\"pk_cumandoc\":\"0001A21000000004C0VQ\",\"pk_currtype1\":\"00010000000000000001\",\"currtypecode\":\"CNY\",\"currtypename\":\"人民币\"},{\"cooperateflag\":false,\"createtime\":\"2023-09-21 20:30:09\",\"creator\":\"#UAP#\",\"credlimitflag\":\"-1\",\"custflag\":\"4\",\"custstate\":\"0\",\"diffcurrflag\":false,\"discountrate\":\"100.00000000\",\"dr\":\"0\",\"freeofacclmtcheck\":false,\"freeofcremnycheck\":false,\"frozenflag\":false,\"iounit\":false,\"isagent\":false,\"ispromtesettlement\":true,\"pk_corp\":\"1015\",\"corp_code\":\"3401\",\"corp_name\":\"hjx建设银行有限公司\",\"pk_cubasdoc\":\"0001A21000000004C0VP\",\"pk_cumandoc\":\"0001A21000000004C0VR\"}],\"addrvo\":[],\"custbankvo\":[],\"basebankvo\":[]}]",
    "taskNumber": "202309210238"
}

错误返回示例:

复制代码

{

system- error: "请求头中缺少请求的系统"

}