ocr_发票函数

函数名：ocr_发票 / ocr_invoice

函数功能

对发票图片进行OCR识别，提取发票代码、发票号码、开票日期、价税合计、销售方、购买方等关键字段信息。支持返回原始JSON数据与字段标题行显示，满足财务报销、发票录入核验等多种场景需求。

参数规范

参数名	类型	必填	示例	特殊说明
文件路径	String	是	"C:\\images\\invoice.jpg"	发票图片完整路径，支持jpg/jpeg/png/bmp格式
原始数据	Boolean	否	false	默认false，true返回原始JSON格式数据
显示标题	Boolean	否	false	默认false，true在首行显示字段标题行

使用案例

基础发票识别

问题描述：识别发票图片，提取关键字段信息

公式演示：

=ocr_发票("C:\\images\\invoice.jpg")

输出效果：

发票代码	发票号码	开票日期	价税合计	销售方名称	购买方名称
110002020111	12345678	2024-05-12	1000.00	xx科技有限公司	xx商贸有限公司

显示字段标题行

问题描述：识别发票并在首行展示字段名称，便于核对字段含义

公式演示：

=ocr_发票("C:\\images\\invoice.jpg",,1)

输出效果：

发票代码	发票号码	开票日期	价税合计	销售方名称	购买方名称
110002020111	12345678	2024-05-12	1000.00	xx科技有限公司	xx商贸有限公司

返回原始JSON数据

问题描述：获取发票识别的原始JSON结果，便于二次处理

公式演示：

=ocr_发票("C:\\images\\invoice.jpg",1)

输出效果：

{"invoice_code":"110002020111","invoice_number":"12345678","date":"2024-05-12","total":"1000.00","seller":"xx科技有限公司","buyer":"xx商贸有限公司"}

错误处理示例

问题描述：文件路径为空或文件不存在

公式演示：

=ocr_发票("")

输出效果：

文件路径不能为空

技术说明

识别原理

• 底层调用远程OCR服务接口（/ocr/recognize），识别类型为invoice
• 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
• 异步执行，处理中返回"Waiting..."

返回字段

字段名	说明
发票代码	发票代码
发票号码	发票号码
开票日期	格式YYYY-MM-DD
价税合计	含税总金额
销售方名称	销售方名称
购买方名称	购买方名称

异常处理

错误场景	返回值
文件路径为空	文件路径不能为空
文件不存在	文件不存在
图片格式不支持	不支持的图片格式
网络连接失败	网络请求失败
OCR识别异常	处理错误: 错误信息

会员等级

本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。

扩展应用

批量发票识别

结合Excel批量文件路径，下拉调用本函数实现发票信息批量提取，便于财务汇总核对。

结合财务函数处理

识别结果中的金额字段可配合个税计算、中文金额等函数进一步处理。

注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。