U8C API中心

API中心

商业汇票
收票登记

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

收票登记查询

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

详细描述:用于收票登记查询

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

接口地址

请求方式

请求参数header

请求参数body

返回类型参数

代码示例

请求参数示例

正确返回示例

错误返回示例

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

参数填写指南

请求方式:POST

请求参数(header):

参数填写指南

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

请求参数(body):

参数名	是否数组	必填	描述	默认值
corp	否	是	公司
gatherdate_begin	否	是	收票日期从
gatherdate_end	否	是	收票日期至
page_now	否	是	当前页	1
page_size	否	是	每页条数	10

返回类型参数:

参数名	类型	是否数组	必填	描述
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#模板示例下载

请求参数示例:

复制代码

{
     "corp":"01",
     "gatherdate_begin":"2021-09-22",
     "gatherdate_end":"2021-09-30",
     "page_now":"1",
     "page_size":"100"
}

正确返回示例:

复制代码

{
	"status": "success",
	"data": {
		"allcount": 19,
		"retcount": 10,
		"datas": [{
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "2",
				"moneyy": 11,
				"invoicedate": "2021-09-21",
				"enddate": "2022-03-21",
				"paybillunit": "00011210000000000HML",
				"paybillunit_code": "04",
				"paybillunit_name": "弘光食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-22",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ100000000074YV",
				"pk_baseinfo": "1001ZZ100000000074YU"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "5",
				"moneyy": 12,
				"invoicedate": "2021-09-24",
				"enddate": "2022-03-24",
				"paybillunit": "00011210000000000HML",
				"paybillunit_code": "04",
				"paybillunit_name": "弘光食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-27",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ10000000007MP2",
				"pk_baseinfo": "1001ZZ10000000007MP1"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "3",
				"moneyy": 12,
				"invoicedate": "2021-09-24",
				"enddate": "2022-03-24",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-28",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ10000000007P0B",
				"pk_baseinfo": "1001ZZ10000000007P0A"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "8",
				"moneyy": 12,
				"invoicedate": "2021-09-24",
				"enddate": "2022-03-24",
				"paybillunit": "00011210000000000HMH",
				"paybillunit_code": "02",
				"paybillunit_name": "永和食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-28",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ10000000007P0E",
				"pk_baseinfo": "1001ZZ10000000007P0D"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "12",
				"moneyy": 100,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ100000000087J0",
				"pk_baseinfo": "1001ZZ100000000087IY"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "13",
				"moneyy": 99,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HML",
				"paybillunit_code": "04",
				"paybillunit_name": "弘光食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ100000000087J1",
				"pk_baseinfo": "1001ZZ100000000087IZ"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "20",
				"moneyy": 100,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ100000000088B6",
				"pk_baseinfo": "1001ZZ100000000088B5"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "21",
				"moneyy": 100,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ1000000000892K",
				"pk_baseinfo": "1001ZZ1000000000892J"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "19",
				"moneyy": 100,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ100000000089UE",
				"pk_baseinfo": "1001ZZ100000000089UD"
			},
			"childrenvo": []
		}, {
			"parentvo": {
				"pk_curr": "00010000000000000001",
				"currtype_code": "CNY",
				"currtype_name": "人民币",
				"fbmbilltype": "FBMTYPE0000000000001",
				"notetype_code": "bank",
				"notetype_name": "银行承兑汇票",
				"fbmbillno": "14",
				"moneyy": 100,
				"invoicedate": "2021-09-28",
				"enddate": "2022-03-20",
				"paybillunit": "00011210000000000HMJ",
				"paybillunit_code": "03",
				"paybillunit_name": "王氏食品",
				"holdunit": "00011210000000000HMF",
				"holdunit_code": "01",
				"holdunit_name": "企业运营",
				"gatherdate": "2021-09-29",
				"gathertype": "input",
				"receiveunit": "00011210000000000HMF",
				"receiveunit_code": "01",
				"receiveunit_name": "企业运营",
				"pk_register": "1001ZZ10000000008CXK",
				"pk_baseinfo": "1001ZZ10000000008CXJ"
			},
			"childrenvo": []
		}]
	},
	"taskNumber": "202111010017"
}

错误返回示例:

复制代码

{
    "status": "falied",
    "errorcode": "-32000",
    "errormsg": "U8C返回信息:下列查询条件必须输入：[corp]",
    "taskNumber": "202111010019"
}