U8C API中心

API中心

商业汇票
收票登记

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

收票登记新增

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

详细描述:用于收票登记新增

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

接口地址:http://ip:port/u8cloud/api/fbm/gather/insert

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

参数名	类型	是否数组	必填	描述
billvo		是	是	收票登记聚合VO
parentvo		是	是	主表VO
divisible	string	否	否	能否分包流转(5.1及以上支持)
enddate	string	否	否	到期日期
fbmbillno	string	否	否	票据编号
fbmbillno_main	string	否	否	票据（包）号码(5.1及以上支持)
fbmbillno_sub_end	string	否	否	子区间至(5.1及以上支持)
fbmbillno_sub_start	string	否	否	子区间起(5.1及以上支持)
fbmbilltype	string	否	否	票据类型
gatherdate	string	否	否	收票日期
holdunit	string	否	否	持票单位
invoicedate	string	否	否	出票日期
isnewbill_fbm	string	否	否	是否新一代票据(5.1及以上支持)
moneyy	double	否	否	汇票金额
paybillunit	string	否	否	付票单位
pk_corp	string	否	否	公司
pk_curr	string	否	否	币种
voperatorid	string	否	否	操作人

返回类型参数:

参数名	类型	是否数组	必填	描述
billvo				收票登记聚合VO_返回
parentvo		是	否	收付票据登记表_返回
acceptanceno	string	否	否	承兑协议编号
cctype	string	否	否	授信类型
chargeitem	string	否	否	手续费支出项目
chargeplanitem	string	否	否	手续费支出计划项目
contractno	string	否	否	交易合同编号
currtype_code	string	否	否	币种编码
currtype_name	string	否	否	币种名称
dapprovedate	string	否	否	审核日期
dept	string	否	否	部门
dvoucherdate	string	否	否	制证日期
enddate	string	否	否	到期日期
fbmbillno	string	否	否	票据编号
fbmbilltype	string	否	否	票据类型
gatherdate	string	否	否	收票日期
gatheritem	string	否	否	gatheritem
gatherplanitem	string	否	否	收票计划项目
gathertype	string	否	否	收票来源类型
holdunit	string	否	否	持票单位
holdunit_code	string	否	否	持票单位编码
holdunit_name	string	否	否	持票单位名称
impawnmode	string	否	否	担保方式
invoicedate	string	否	否	出票日期
invoiceitem	string	否	否	开票收入项目
invoiceoutitem	string	否	否	付票支出项目
invoiceoutplanitem	string	否	否	付票计划项目
invoiceplanitem	string	否	否	开票收入计划项目
invoiceunit	string	否	否	出票单位
invoiceunit_code	string	否	否	出票单位编码
invoiceunit_name	string	否	否	出票单位名称
moneyy	string	否	否	汇票金额
note	string	否	否	备注
notetype_code	string	否	否	票据类型编码
notetype_name	string	否	否	票据类型名称
operator_code	string	否	否	操作人编码
operator_name	string	否	否	操作人名称
paybank	string	否	否	付款银行
paybank_code	string	否	否	付款银行编码
paybank_name	string	否	否	付款银行名称
paybankacc	string	否	否	付款单位银行帐号
paybillunit	string	否	否	付票单位
paybillunit_code	string	否	否	付票单位编码
paybillunit_name	string	否	否	付票单位名称
payunit	string	否	否	付款单位
payunit_code	string	否	否	付款单位编码
payunit_name	string	否	否	付款单位名称
pk_corp	string	否	否	公司
pk_corp_code	string	否	否	公司编码
pk_corp_name	string	否	否	公司名称
pk_curr	string	否	否	币种
poundagemoney	string	否	否	手续费金额
poundagemoneyb	string	否	否	手续费本币
poundagemoneyf	string	否	否	手续费辅币
receivebank	string	否	否	收款银行
receivebank_code	string	否	否	收款银行编码
receivebank_name	string	否	否	收款银行名称
receivebankacc	string	否	否	收款单位银行帐号
receivebankacc_code	string	否	否	收款单位银行帐号编码
receivebankacc_name	string	否	否	收款单位银行帐号名称
receiveunit	string	否	否	收款单位
receiveunit_code	string	否	否	收款单位编码
receiveunit_name	string	否	否	收款单位名称
registerno	string	否	否	登记单编号
securityaccount	string	否	否	保证金帐号
securitycode	string	否	否	保证金编号
securitymoney	string	否	否	保证金金额
securitymoneyb	string	否	否	保证金本币金额
securitymoneyf	string	否	否	保证金辅币金额
securityrate	string	否	否	保证金比例
securityratey	string	否	否	保证金汇率
securitytype	string	否	否	保证金类型
vapproveid	string	否	否	审核人
vapprovenote	string	否	否	审核批语
verifyman	string	否	否	核销人
voperatorid	string	否	否	操作人
vvouchermanid	string	否	否	制证人

代码示例:

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

请求参数示例:

复制代码

{
	"billvo": [{
		"parentvo": {
				"paybillunit":"03",
				"holdunit":"01",
				"gatherdate":"2021-10-07",
				"pk_corp":"01",
				"moneyy":"100",
				"fbmbillno":"22",
				"fbmbilltype":"bank",
				"pk_curr":"CNY",
				"invoicedate":"2021-10-08",
				"enddate":"2022-03-20",
				"voperatorid":"13072522785"
		}
	}]
}

正确返回示例:

复制代码

{
	"status": "success",
	"data": [{
		"parentvo": {
			"pk_curr": "00010000000000000001",
			"currtype_code": "CNY",
			"currtype_name": "人民币",
			"fbmbilltype": "FBMTYPE0000000000001",
			"notetype_code": "bank",
			"notetype_name": "银行承兑汇票",
			"fbmbillno": "28",
			"moneyy": 100,
			"invoicedate": "2021-10-08",
			"enddate": "2022-03-20",
			"pk_corp": "1001",
			"pk_corp_code": "01",
			"pk_corp_name": "企业运营",
			"voperatorid": "00011210000000003KCD",
			"operator_code": "13072522785",
			"operator_name": "尹茜",
			"paybillunit": "00011210000000000HMJ",
			"paybillunit_code": "03",
			"paybillunit_name": "王氏食品",
			"holdunit": "00011210000000000HMF",
			"holdunit_code": "01",
			"holdunit_name": "企业运营",
			"gatherdate": "2021-10-08",
			"gathertype": "input",
			"pk_register": "1001ZZ100000000099C2",
			"pk_baseinfo": "1001ZZ100000000099C1"
		},
		"childrenvo": [null]
	}],
	"taskNumber": "202111010007"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "U8C返回信息:存在以下错误，请检查：[第 1张收票登记单的收票日期应该大于等于出票日期]",
    "taskNumber": "202111010009"
}