功能描述

识别银行回执单。

支持对各大银行的银行回单（银行回执单）中28个关键字段进行结构化识别，包括收/付款人户名、账号、开户银行、交易日期、大小写金额、交易流水号等。

更新日志

2024.09.06 - v1.0.5

• 新增多页识别能力，在网页端使用高级模式开启，API调用使用参数开启
  • 新增参数multipage，是否需要对pdf进行多页识别，0为单页识别，1为多页识别，默认为0
  • 默认不开启

请求头说明（Request Header）

header名	值
x-ti-app-id	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code	请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

URL参数（Parameters）

参数名	数据类型	是否必填	允许的值	描述
multipage	int	否	0, 1	是否需要对pdf进行多页识别，0为单页识别，1为多页识别，默认为0

请求体说明（Request Body）

Content-Type: application/octet-stream

要上传的图片，目前支持jpg, png, bmp, pdf, tiff, 单帧gif等大部分格式，其中pdf可以通过开启对应功能，支持单页和多页pdf。

请注意，请求体的数据格式为文件的二进制流，非 FormData 或其他格式。文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

响应体说明（Response Data）

Content-Type: application/json

JSON结构说明如下：

字段名	类型	描述
code	integer	错误码，详见“错误码说明”
message	string	错误信息
result	object
+ image_angle	integer	图片角度，指原图需要经过顺时针旋转多少度，才能得到正方向的图片
+ rotated_image_width	integer	正方向时图片的宽
+ rotated_image_height	integer	正方向时图片的高
+ type	string	当前识别证件类型，当为other的时候,代表无法识别的图片 中国银行收款回单 中国银行付款回单 中国银行收费回单 中国银行客户贷记回单 中国银行客户借记回单 中国银行利息收入回单 中国农业银行电子回单 中国工商银行电子回单 中国建设银行网上银行电子回执 中国建设银行收付款回单 中国建设银行缴税回单 中国建设银行收费回单 招商银行信贷业务付款回单 招商银行信贷业务利息回单 招商银行付款回单 招商银行收款回单 招商银行收费回单 招商银行存款结息回单 招商银行利息收入回单 招商银行退款回单 交通银行个人贷款回单 交通银行代理结算回单 交通银行公共收费回单 交通银行汇总收费回单 交通银行利息回单 交通银行内部调拨回单 交通银行支付结算回单 交通银行支付转账回单 中国邮政网上银行电子回单 中信银行二代支付回单 中信银行发放个人贷款回单 中信银行第三方代收费回单 中信银行保证金划转回单 中信银行保证金存入回单 中信银行收费回单 中信银行存款利息回单 中信银行转账回单 光大银行电子回单 广发银行电子回单 民生银行存款利息收款回单 民生银行收款回单 民生银行入账收款回单 民生银行付款回单 民生银行对公贷款扣款回单 民生银行电子缴税付款凭证 民生银行通用电子回单 平安银行存款利息回单 平安银行收费回单 平安银行收付款回单 上海浦东发展银行业务凭证/回单 浦发银行电子回单 顺德农商行电子交易回单 兴业银行网上回单 兴业银行汇款回单 兴业银行汇入回单 中国建设银行单位客户专用回单 中国建设银行清单式贷方汇总凭证 民生银行支付业务回单(收款) 招商银行出账入账回单 other
+ item_list	array	常规结构化结果
++ description	string	结构化结果字段描述
++ value	string	结构化结果字段的值
++ confidence	number	字段置信度
++ position	array	识别的字段在旋转后图中的坐标, 是个长度为8的数组 [0,1,2,3,4,5,6,7] (0, 1) 左上角坐标 (2, 3) 右上角坐标 (4, 5) 右下角坐标 (6, 7) 左下角坐标
++ key	string	结构化结果的字段名 receipt_number:回单编号 serial_number:交易流水号/记账流水号 trade_type:交易类型 trade_date:交易日期 trade_time:交易时间 payer_account:付款账号 payer_name:付款户名 payer_bank:付款银行 payee_account:收款账号 payee_name:收款户名 payee_bank:收款银行 amount:金额 abstract:摘要 postscript:附言 usage:用途 loan_mark:借贷标志 remark:备注/附言 registered_name:实际记账户名 registered_number:实际记账账号 bank_postscript:银行附言 customer_postscript:客户附言 note:备注 business_type:业务类型 name:户名 account:账号 amount_big:金额大写 amount_small:金额小写 currency:货币种类

JSON结构示例

{"code":200,"message":"Success","version":"v1.2.0","duration":123,"result":{"image_angle":90,"rotated_image_width":1920,"rotated_image_height":1080,"type":"中国工商银行电子回单","item_list":[{"description":"结构化结果字段描述","value":"结构化结果字段的值","confidence":0.99,"position":[0,0,50,0,50,30,0,30],"key":"receipt_number"}]}}

错误码说明

错误码	描述
40101	x-ti-app-id 或 x-ti-secret-code 为空
40102	x-ti-app-id 或 x-ti-secret-code 无效，验证失败
40103	客户端IP不在白名单
40003	余额不足，请充值后再使用
40004	参数错误，请查看技术文档，检查传参
40007	机器人不存在或未发布
40008	机器人未开通，请至市场开通后重试
40301	图片类型不支持
40302	上传文件大小不符，文件大小不超过 10M
40303	文件类型不支持
40304	图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
40305	识别文件未上传
30203	基础服务故障，请稍后重试
500	服务器内部错误