U8C API中心

API中心

基本档案
公司目录

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

公司档案新增

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

详细描述:用于公司档案新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数最简示例有上级公司

参数名	类型	是否数组	必填	描述	默认值
billvo		是	是	请求参数
begindate	string	否	否	业务开始日期
briefintro	string	否	否	简介
busibegindate	string	否	否	HR业务开始日期
busienddate	string	否	否	HR业务结束日期
chargedeptcode	string	否	否	上级主管部门编码
chargedeptname	string	否	否	上级主管部门名称
citycounty	string	否	否	市县
corptype	string	否	否	单位类型
countryarea	string	否	否	国家地区
createdate	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
ecotype	string	否	否	经济类型
email1	string	否	否	电子邮件1
email2	string	否	否	电子邮件2
email3	string	否	否	电子邮件3
enddate	string	否	否	业务终止日期
fathercorp	string	否	否	上级公司主键
fax1	string	否	否	传真1
fax2	string	否	否	传真2
foreignname	string	否	否	外文名称
holdflag	string	否	否	是否控股
idnumber	string	否	否	法人身份证号码
industry	string	否	否	所属行业
innercode	string	否	否	编码级次
ishasaccount	string	否	否	是否已建帐
isseal	string	否	否	是否封存
isuseretail	string	否	否	是否用于零售
isworkingunit	string	否	否	是否经营单位
legalbodycode	string	否	否	法人代表
linkman1	string	否	否	联系人1
linkman2	string	否	否	联系人2
linkman3	string	否	否	联系人3
maxinnercode	string	否	否	内部编码下级最大值
memo	string	否	否	备注
ownersharerate	string	否	否	所有权份额
phone1	string	否	否	电话1
phone2	string	否	否	电话2
phone3	string	否	否	电话3
pk_corp	string	否	否	公司主键
pk_corpkind	string	否	否	公司类别
pk_currency	string	否	否	货币种类主键
postaddr	string	否	否	通讯地址
province	string	否	否	省-自治区
regcapital	string	否	否	注册资本
region	string	否	否	行政区划
saleaddr	string	否	否	营业地址
sealeddate	string	否	否	封存日期
showorder	string	否	否	显示顺序
taxcode	string	否	否	纳税人登记号
taxpayertype	string	否	否	纳税人类型
tenant_no	string	否	否	商户号
unitcode	string	否	否	公司编码
unitdistinction	string	否	否	单位级别
unitname	string	否	否	公司名称
unitshortname	string	否	否	公司简称
url	string	否	否	Web网址
zipcode	string	否	否	邮政编码
trantype		否	否	翻译类型，按编码为code，不需要翻译为pk	code

返回类型参数:

参数名	类型	是否数组	必填	描述
billvo				公司档案实体_返回
begindate	string	否	否	业务开始日期
briefintro	string	否	否	简介
busibegindate	string	否	否	业务开始日期
busienddate	string	否	否	业务结束日期
chargedeptcode	string	否	否	上级主管部门编码
chargedeptname	string	否	否	上级主管部门名称
citycounty	string	否	否	市县
corptype	string	否	否	单位类型
countryarea	string	否	否	国家地区
createdate	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
ecotype	string	否	否	经济类型
email1	string	否	否	邮件1
email2	string	否	否	邮件2
email3	string	否	否	邮件3
enddate	string	否	否	业务终止日期
fathercorp	string	否	否	上级主键
fax1	string	否	否	传真1
fax2	string	否	否	传真2
foreignname	string	否	否	外文名称
idnumber	string	否	否	法人身份证号码
industry	string	否	否	所属行业
innercode	string	否	否	编码级次
ishasaccount	boolean	否	否	是否已建账
isseal	boolean	否	否	是否封存
isuseretail	boolean	否	否	是否用于零售
isworkingunit	boolean	否	否	是否经营单位
legalbodycode	string	否	否	法人代表
linkman1	string	否	否	联系人1
linkman2	string	否	否	联系人2
linkman3	string	否	否	联系人3
maxinnercode	string	否	否	内部编码下级最大值
memo	string	否	否	备注
ownersharerate	double	否	否	所有权份额
phone1	string	否	否	电话1
phone2	string	否	否	电话2
phone3	string	否	否	电话3
pk_TopSettlecenter	string	否	否	总结算中心主键
pk_corp	string	否	否	主键
pk_corpkind	string	否	否	公司类别
pk_currency	string	否	否	货币种类主键
postaddr	string	否	否	通讯地址
province	string	否	否	省-自治区
regcapital	double	否	否	注册资本
region	string	否	否	营业地址
sealeddate	string	否	否	封存日期
showorder	string	否	否	显示顺序
taxcode	string	否	否	纳税人登记号
taxpayertype	string	否	否	纳税人类别
tenant_no	string	否	否	商户号
ts	string	否	否	时间戳
unitcode	string	否	否	编码
unitdistinction	string	否	否	单位级别
unitname	string	否	否	单位名称
unitshortname	string	否	否	单位简称
url	string	否	否	Web网址
zipcode	string	否	否	邮政编码

代码示例:

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

请求参数示例:

最简示例有上级公司

复制代码

{
    "billvo": [
        {
            "unitcode": "APITest02",
            "unitname": "API测试新增公司02",
            "unitshortname": "API测试新增公司02"
        }
    ]
}

正确返回示例:

最简示例有上级公司

复制代码

{
    "status": "success",
    "data": "[{\"innercode\":\"21\",\"ishasaccount\":false,\"isseal\":false,\"isuseretail\":false,\"isworkingunit\":false,\"ownersharerate\":\"0.00000000\",\"pk_corp\":\"1087\",\"unitcode\":\"APITest02\",\"unitshortname\":\"API测试新增公司02\",\"unitname\":\"API测试新增公司02\"}]",
    "taskNumber": "202309110008"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32001",
    "errormsg": "U8C返回信息:公司编码不能重复",
    "taskNumber": "202009150058"
}