ocr_社保卡函数
函数名：ocr_社保卡 / ocr_social_security_card
函数功能
对社保卡图片进行OCR识别，提取持卡人姓名、社会保障号码、卡号、发卡日期等关键字段信息。支持返回原始JSON数据与字段标题行显示，满足社保信息采集、参保核验等多种场景需求。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
文件路径 | String | 是 | "C:\\images\\socialcard.jpg" | 社保卡图片完整路径，支持jpg/jpeg/png/bmp格式 |
原始数据 | Boolean | 否 | false | 默认false，true返回原始JSON格式数据 |
显示标题 | Boolean | 否 | false | 默认false，true在首行显示字段标题行 |
使用案例
基础社保卡识别
问题描述：识别社保卡图片，提取关键字段信息
公式演示：
excel
=ocr_社保卡("C:\\images\\socialcard.jpg")输出效果：
| 持卡人姓名 | 社会保障号码 | 卡号 | 发卡日期 |
|---|---|---|---|
| 张三 | 110101199001011234 | 1234567890 | 2020-06-01 |
显示字段标题行
问题描述：识别社保卡并在首行展示字段名称，便于核对字段含义
公式演示：
excel
=ocr_社保卡("C:\\images\\socialcard.jpg",,1)输出效果：
| 持卡人姓名 | 社会保障号码 | 卡号 | 发卡日期 |
|---|---|---|---|
| 张三 | 110101199001011234 | 1234567890 | 2020-06-01 |
返回原始JSON数据
问题描述：获取社保卡识别的原始JSON结果，便于二次处理
公式演示：
excel
=ocr_社保卡("C:\\images\\socialcard.jpg",1)输出效果：
json
{"name":"张三","social_security_no":"110101199001011234","card_number":"1234567890","issue_date":"2020-06-01"}错误处理示例
问题描述：文件路径为空或文件不存在
公式演示：
excel
=ocr_社保卡("")输出效果：
text
文件路径不能为空技术说明
识别原理
- 底层调用远程OCR服务接口（/ocr/recognize），识别类型为social_security_card
- 图片以multipart方式上传，返回结果经AES解密后格式化为二维数组
- 异步执行，处理中返回"Waiting..."
返回字段
| 字段名 | 说明 |
|---|---|
| 持卡人姓名 | 持卡人姓名 |
| 社会保障号码 | 社会保障号码 |
| 卡号 | 社保卡卡号 |
| 发卡日期 | 格式YYYY-MM-DD |
异常处理
| 错误场景 | 返回值 |
|---|---|
| 文件路径为空 | 文件路径不能为空 |
| 文件不存在 | 文件不存在 |
| 图片格式不支持 | 不支持的图片格式 |
| 网络连接失败 | 网络请求失败 |
| OCR识别异常 | 处理错误: 错误信息 |
会员等级
本函数为**专业版(Pro)**功能，需开通专业版会员授权后使用。
扩展应用
批量社保卡识别
结合Excel批量文件路径，下拉调用本函数实现社保卡信息批量提取，便于参保信息归档核对。
卡号脱敏处理
识别出的社会保障号码可配合文本函数进行脱敏处理，保护个人隐私信息。
注：本函数为专业版功能，依赖联网环境调用AI服务接口。支持jpg/jpeg/png/bmp格式图片，建议在WPS 2019+和Excel 365中使用。