U8C API中心

API中心

总账
期初

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

期初余额新增

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

详细描述:用于期初余额新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/gl/init/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

全量参数不带辅助核算项的科目带辅助核算项和不带辅助核算项的科目带辅助核算项的科目以名称导入带辅助核算项的科目以编码导入带有累计余额的新增

参数名	类型	是否数组	必填	描述
initmanagevo		是	是	期初聚合vo
importPattern	string	否	是	辅助核算是否以名称导入(Y：是；N：否)
initvo		是	是	期初明细
assvalue		是	否	辅助核算
checktypecode	string	否	是	辅助核算类型编码
checkvaluecode	string	否	是	辅助核算的值编码
creditamount	string	否	否	贷方累计原币
creditquantity	string	否	否	贷方累计数量
debitamount	string	否	否	借方累计原币
debitquantity	string	否	否	借方累计数量
endamount	string	否	否	期初原币
endfracamount	string	否	否	期初辅币
endlocalamount	string	否	否	期初本币
endquantity	string	否	否	期初数量
fraccreditamount	string	否	否	贷方累计辅币
fracdebitamount	string	否	否	借方累计辅币
localcreditamount	string	否	否	贷方累计本币
localdebitamount	string	否	否	借方累计本币
subjcode	string	否	否	科目编码
subjname	string	否	否	科目名称
isHasAss	string	否	是	是否包含辅助核算(Y：是；N：否)
isroundup	string	否	是	是否四舍五入(Y：是；N：否)
period	string	否	是	会计期间
pk_corp	string	否	是	公司
pk_currtype	string	否	是	币种
pk_glorgbook	string	否	是	主体账簿
pk_user	string	否	是	录入人
version_period	string	否	是	会计科目版本启动期间
year	string	否	是	会计年度

返回类型参数:

参数名	类型	是否数组	必填	描述
initmanagevo				期初聚合vo
corp_code	string	否	否	公司编码
corp_name	string	否	否	公司名称
currtype_code	string	否	否	币种编码
currtype_name	string	否	否	币种名称
glorgbook_code	string	否	否	主体账簿编码
glorgbook_name	string	否	否	主体账簿名称
period	string	否	否	会计期间
pk_corp	string	否	否	公司
pk_currtype	string	否	否	币种
pk_glorgbook	string	否	否	主体账簿
pk_user	string	否	否	录入人
user_code	string	否	否	录入人编码
user_name	string	否	否	录入人名称
version_period	string	否	否	科目版本启动期间
year	string	否	否	会计年度

代码示例:

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

请求参数示例:

不带辅助核算项的科目带辅助核算项和不带辅助核算项的科目带辅助核算项的科目以名称导入带辅助核算项的科目以编码导入带有累计余额的新增

复制代码

{
	"initmanagevo": [{
        "initvo": [{
			"subjcode": "1001",
			"subjname": "库存现金",
			"endquantity":"9",
			"endamount":"8",
			"endlocalamount":"7",
			"endfracamount":"6"
		},{
			"subjcode": "1003",
			"subjname": "科目测试",
			"endquantity":"5",
			"endamount":"4",
			"endlocalamount":"3",
			"endfracamount":"2"
		}],
		"pk_corp": "03",
		"pk_glorgbook": "03-0001",
		"pk_user": "13011111111",
		"pk_currtype": "CNY",
		"year":"2022",
		"period":"01",
		"version_period":"01",
		"isHasAss":"N",
		"importPattern":"Y",
		"isroundup":"Y"
	}]
}

正确返回示例:

复制代码

{
    "status": "success",
    "data": "[{\"pk_glorgbook\":\"000112100000000007JO\",\"glorgbook_code\":\"03-0001\",\"glorgbook_name\":\"王氏食品集团基准账薄\",\"year\":\"2022\",\"period\":\"01\",\"pk_user\":\"00011210000000003KCD\",\"user_code\":\"13011111111\",\"user_name\":\"尹茜\",\"pk_currtype\":\"00010000000000000001\",\"currtype_code\":\"CNY\",\"currtype_name\":\"人民币\",\"pk_corp\":\"1003\",\"corp_code\":\"03\",\"corp_name\":\"王氏食品\",\"version_period\":\"01\"}]",
    "taskNumber": "202203100018"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "U8C返回信息:[第 1条期初余额的参数 是否包含辅助核算[isHasAss]的值不能为空]",
    "taskNumber": "202203100027"
}