ocr_身份证函数

函数名：ocr_身份证 / ocr_idcad

函数功能

对身份证图片进行OCR识别，提取身份证上的姓名、性别、民族、出生日期、住址、身份证号等字段信息。支持返回原始JSON数据与字段标题行显示，满足身份证信息采集、录入核验等多种场景需求。

参数规范

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

使用案例

基础身份证识别

问题描述：识别身份证图片，提取关键字段信息

公式演示：

=ocr_身份证("C:\\images\\idcard.jpg")

输出效果：

姓名	性别	民族	出生日期	住址	身份证号
张三	男	汉	1990-01-01	北京市朝阳区xx路xx号	110101199001011234

显示字段标题行

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

公式演示：

=ocr_身份证("C:\\images\\idcard.jpg",,1)

输出效果：

姓名	性别	民族	出生日期	住址	身份证号
张三	男	汉	1990-01-01	北京市朝阳区xx路xx号	110101199001011234

返回原始JSON数据

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

公式演示：

=ocr_身份证("C:\\images\\idcard.jpg",1)

输出效果：

{"name":"张三","sex":"男","nation":"汉","birth":"1990-01-01","address":"北京市朝阳区xx路xx号","idcard":"110101199001011234"}

错误处理示例

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

公式演示：

=ocr_身份证("")

输出效果：

文件路径不能为空

技术说明

识别原理

• 底层调用远程OCR服务接口（/ocr/recognize），识别类型为idcard
• 实现上调用证件提取.sfz_OCR，将身份证图片转Base64后POST到 http://a.52ecyun.com/idcard_ocr
• 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
• 异步执行，处理中返回"Waiting..."

返回字段

字段名	说明
姓名	身份证持有人姓名
性别	男/女
民族	民族名称，如汉
出生日期	格式YYYY-MM-DD
住址	户籍住址
身份证号	18位身份证号码

异常处理

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

会员等级

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

扩展应用

批量身份证识别

结合Excel批量文件路径，下拉调用本函数实现身份证信息批量提取与整理。

结合证件信息提取函数

识别结果中的身份证号可配合取年龄、取性别、取星座等函数进一步扩展分析。

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