/ocr/medical/v2/medical_settlement
1.接口描述
该 API 用于识别并提取医保结算单(分割单)上的文字信息。
- 图片要求:
- 格式为 JPG(JPEG), PNG
- 宽和高大于 128px, 小于等于 6000px
- 小于等于 5 MB
请求方式
POST
https://cloudapi.deepfinch.com/ocr/medical/v2/medical_settlement/basic
调试工具
Debugging Tool
2.请求参数
2.1 请求头域
字段 |
类型 |
必需 |
描述 |
X-DF-API-ID |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
X-DF-API-SECRET |
string |
是 |
API调用凭证信息,详细信息请参考API调用 |
2.2 请求体
字段 |
类型 |
必需 |
描述 |
file |
file |
见下方注释 |
需上传的图片文件,上传本地图片进行检测时选取此参数 |
url |
string |
见下方注释 |
图片网络地址,采用抓取网络图片方式时需选取此参数 |
org_code |
string |
否 |
组织机构代码 |
auto_rotate |
boolean |
否 |
自动旋转图片,true开启,false不开启;默认不开启 |
请求参数 file
与 url
二选一。
url 中若含有特殊字符,则需要对这些字符进行转义,所有中文和特殊字符必需以UTF-8编码转义。
目前支持 http/https 协议的网络地址。下载限时 5s,超时后仍未下载完成则属于失败。
参数 file
需把图片文件以 multipart/form-data 的形式放到 POST 消息体中。
组织机构代码:
城市 |
组织机构 |
潍坊市 |
863401 |
枣庄市 |
860612 |
烟台市 |
860603 |
济南市 |
860601 |
泰安市 |
860605 |
日照市 |
860613 |
临沂市 |
860609 |
济宁市 |
860604 |
聊城市 |
860610 |
菏泽市 |
860614 |
德州市 |
860602 |
淄博市 |
860608 |
东营市 |
860607 |
威海市 |
860611 |
青岛市 |
862001 |
已优化省份:
省份 |
安徽 |
北京 |
重庆 |
甘肃 |
河北 |
黑龙江 |
河南 |
湖北 |
湖南 |
江苏 |
广东 |
广西 |
陕西 |
山东 |
上海 |
四川 |
云南 |
3.返回参数
字段 |
类型 |
说明 |
request_id |
string |
本次请求的id |
status |
string |
状态,正常为 OK |
degree |
int |
图片旋转角度 |
medical_result |
object |
票据信息提取结果 |
3.1 medical_result 字段的参数:
字段 |
类型 |
说明 |
note_title |
string |
票据标题 |
patient_name |
string |
患者姓名 |
patient_gender |
int |
性别:0-未知,1-男, 2-女 |
billing_date |
string |
发票日期 |
catalog_pays |
float |
医保内支付 |
checksum |
object |
票据内校验结果:-1-无法校验,0-校验不通过,1-校验通过,根据票内逻辑关系校验 |
cost_categories |
object |
大类项目花费 |
fund_payments |
object |
统筹支付 |
start_hospital_date |
string |
入院日期 |
end_hospital_date |
string |
出院日期 |
hospital_days |
float |
住院天数 |
hospital_name |
string |
医院名称 |
out_catalog_pays |
float |
医保外支付 |
total_cost |
float |
总金额 |
total_fund_payment |
float |
统筹总额项 |
total_part_self_pays |
float |
自负总额 |
total_self_pays |
float |
自费总额 |
3.1.1 checksum 字段的参数:
字段 |
类型 |
说明 |
total_cost |
int |
总金额校验是否通过 |
total_fund_payment |
int |
大类项目花费校验是否通过 |
part_self_pay |
int |
自负金额校验是否通过 |
self_pay |
int |
自费金额校验是否通过 |
3.1.2 cost_categories 字段的参数:
字段 |
类型 |
说明 |
is_drug |
int |
是否是药品:1-是,0-否 |
name |
string |
大类项目名称 |
part_self_pay |
float |
自负金额 |
self_pay |
float |
自费金额 |
3.1.3 fund_payments 字段的参数:
字段 |
类型 |
说明 |
name |
string |
统筹支付单项名称 |
cost |
float |
统筹支付单项花费 |
返回结果示例
{
"degree": 0,
"medical_result": {
"average_prob": 0.9224540396826342,
"catalog_pays": null,
"checksum": {
"total_cost": -1,
"total_fund_payment": -1,
"part_self_pay": -1,
"self_pay": -1
},
"cost_categories": [{
"is_drug": 1,
"name": "自费药品(或范围外药品)费用",
"part_self_pay": null,
"self_pay": 0
},
{
"is_drug": 1,
"name": "血费全自费",
"part_self_pay": null,
"self_pay": 0
},
{
"is_drug": 0,
"name": "基本医疗之外的费用",
"part_self_pay": null,
"self_pay": 4378.49
},
{
"is_drug": 0,
"name": "标准外床位费",
"part_self_pay": null,
"self_pay": 50
}
],
"end_hospital_date": "2019-02-27",
"fund_payments": [],
"hospital_days": 6,
"hospital_name": "四川省第五人民医院(四川省老年病胡光所)",
"note_title": "成都市大病医疗互助补充保险结算表",
"out_catalog_pays": null,
"patient_gender": 1,
"patient_name": "XXX",
"start_hospital_date": "2019-02-21",
"total_cost": 12706.21,
"total_fund_payment": 848.61,
"total_part_self_pays": null,
"total_self_pays": null
},
"request_id": "TIDa0f74432e2134772a8974cb086e9ae6b",
"status": "OK"
}
4.错误码
状态码 |
status 字段 |
说明 |
400 |
INVALID_ARGUMENT |
请求参数错误 |
400 |
DETETION_FAILED |
图片检测失败 |
400 |
DOWNLOAD_ERROR |
网络地址图片获取失败 |
401 |
UNAUTHORIZED |
未授权或授权失败 |
401 |
KEY_EXPIRED |
账号过期 |
403 |
NO_PERMISSION |
无调用权限 |
403 |
OUT_OF_QUOTA |
调用次数超出限额 |
403 |
RATE_LIMIT_EXCEEDED |
调用频率超出限额 |
404 |
NOT_FOUND |
请求路径错误 |
500 |
INTERNAL_ERROR |
服务器内部错误 |
备注: 以上40X系列错误描述请参考reason
字段
输出样例
{
"status": "INVALID_ARGUMENT",
"reason": "must specify 'file' or 'url' argument",
"request_id": "TID8bf47ab6eda64476973cc5f5b6ebf57e"
}
5.输入示例