ocr_收据函数
函数名：ocr_收据 / ocr_receipt
函数功能
对收据图片进行OCR识别，提取收据编号、开票日期、收款单位、付款单位、金额、事由等关键字段信息。支持返回原始JSON数据与字段标题行显示，满足收款凭证录入、台账整理等多种场景需求。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
文件路径 | String | 是 | "C:\\images\\receipt.jpg" | 收据图片完整路径，支持jpg/jpeg/png/bmp格式 |
原始数据 | Boolean | 否 | false | 默认false，true返回原始JSON格式数据 |
显示标题 | Boolean | 否 | false | 默认false，true在首行显示字段标题行 |
使用案例
基础收据识别
问题描述：识别收据图片，提取关键字段信息
公式演示：
excel
=ocr_收据("C:\\images\\receipt.jpg")输出效果：
| 收据编号 | 开票日期 | 收款单位 | 付款单位 | 金额 | 事由 |
|---|---|---|---|---|---|
| No.000123 | 2024-05-12 | xx服务中心 | xx有限公司 | 500.00 | 服务费 |
显示字段标题行
问题描述：识别收据并在首行展示字段名称，便于核对字段含义
公式演示：
excel
=ocr_收据("C:\\images\\receipt.jpg",,1)输出效果：
| 收据编号 | 开票日期 | 收款单位 | 付款单位 | 金额 | 事由 |
|---|---|---|---|---|---|
| No.000123 | 2024-05-12 | xx服务中心 | xx有限公司 | 500.00 | 服务费 |
返回原始JSON数据
问题描述：获取收据识别的原始JSON结果，便于二次处理
公式演示：
excel
=ocr_收据("C:\\images\\receipt.jpg",1)输出效果：
json
{"number":"No.000123","date":"2024-05-12","payee":"xx服务中心","payer":"xx有限公司","amount":"500.00","reason":"服务费"}错误处理示例
问题描述：文件路径为空或文件不存在
公式演示：
excel
=ocr_收据("")输出效果：
text
文件路径不能为空技术说明
识别原理
- 底层调用远程OCR服务接口（/ocr/recognize），识别类型为receipt
- 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
- 异步执行，处理中返回"Waiting..."
返回字段
| 字段名 | 说明 |
|---|---|
| 收据编号 | 收据编号 |
| 开票日期 | 格式YYYY-MM-DD |
| 收款单位 | 收款方名称 |
| 付款单位 | 付款方名称 |
| 金额 | 收据金额 |
| 事由 | 收款事由 |
异常处理
| 错误场景 | 返回值 |
|---|---|
| 文件路径为空 | 文件路径不能为空 |
| 文件不存在 | 文件不存在 |
| 图片格式不支持 | 不支持的图片格式 |
| 网络连接失败 | 网络请求失败 |
| OCR识别异常 | 处理错误: 错误信息 |
会员等级
本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。
扩展应用
批量收据识别
结合Excel批量文件路径，下拉调用本函数实现收据信息批量提取，便于台账汇总核对。
结合财务函数处理
识别结果中的金额字段可配合中文金额等函数转换为中文大写金额。
注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。