产品
体验中心
应用场景
资讯中心
文档与支持
400-6666-582
登录
文档中心
接入技术服务

医疗票据识别

功能描述

医疗票据v1接口识别

请求URL

https://api.textin.com/ai/service/v1/medical_recognize

HTTP请求方法（Method）

HTTP POST

请求头说明（Request Headers）

请在HTTP请求中添加以下自定义标头（Header）。

header 名 值
x-ti-app-id 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

URL参数（Parameters）

URL参数指以 {参数名}={参数值} 形式拼接到 URL 上的键值对。它以 ? 开头，不同参数之间使用 & 连接。形如 ?p1=v1&p2=v2
参数名 数据类型 是否必填 允许的值 描述
crop_image integer 否 0, 1

选择是否需要进行图片切分，0关闭切分，1开启切分，默认为0
return_image_base64 integer 否 0, 1

选择是否需要输出图片base64，对应image_list中image_base64，0关闭，1开启，默认为0
category integer 否 1, 2, 3, 4, 5, 6

指定样本类型，不进行样本分类，直接抽取结果，默认为0不使用该功能 | 1: 医疗发票识别 | 2: 医疗费用明细 | 3: 医疗费用结算单 | 4: 医疗处方单 | 5: 医疗检验报告单 | 6: 医疗诊断报告单

请求体说明（Request Body）

支持以下两种请求格式

1. Content-Type: application/octet-stream

要上传的图片，目前支持jpg, png, bmp, pdf, tiff, ofd, webp, 单帧gif等大部分格式.

请注意，请求体的数据格式为本地文件的二进制流，非 FormData 或其他格式。文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

2. Content-Type: text/plain

请求体的数据格式为文本，内容为在线文件的URL链接（支持http以及https协议）。在线文件大小不超过 10M，图像宽高须介于 20 和 10000（像素）之间。

响应体说明 （Response）

Content-Type: application/json

JSON结构说明如下：

说明：所有接口响应中均包含字段 x_request_id（string类型），作为请求的唯一标识。

字段名 类型 描述
code integer 错误码，详见“错误码说明”
message string

错误信息
duration integer

接口总耗时，单位为毫秒
version string

接口版本
result object

样本识别结果
  + success_count integer

成功识别的图片数量
  + page_count integer

样本总页数
  + ppi integer

pdf解析分辨率，默认144
  + image_list array
   ++ image_angle integer

切分后单张票据的角度
   ++ rotated_image_width integer

切分后单张票据转正后的宽度
   ++ rotated_image_height integer

切分后单张票据转正后的高度
   ++ page_id integer

如果是pdf样本，该图片在pdf上的所在页，默认0，第一页
   ++ image_base64 string

图片base64
   ++ image_position array
  + object_list array
   ++ type string

单份医疗票据类型

  • medical_invoice 医疗发票识别
  • medical_cost_details 医疗费用明细
  • medical_insurance_settlement 医疗费用结算单
  • medical_prescription 医疗处方单
  • medical_laboratory_report 医疗检验报告单
  • medical_diagnostic_report 医疗诊断报告单
  • other 其他
   ++ page_ids array

如果是pdf文件，该份票据样本在pdf中的页码
   ++ image_ids array

该份票据在image_list中的所有图片
   ++ details object

识别结果

JSON结构示例

{"success_count":1,"duration":100,"result":{"page_count":1,"ppi":144,"image_list":[{"image_angle":0,"rotated_image_width":1000,"rotated_image_height":3000,"page_id":0,"image_base64":"","image_position":[100,100,200,100,200,200,100,200]}],"object_list":[{"type":"medical_invoice","page_ids":[0],"image_ids":[0],"details":{"invoice_information":{"document_title_name":{"value":"","description":"单据标题名称"},"invoice_code":{"value":"","description":"票据代码"},"invoice_number":{"value":"","description":"票据号码"},"business_serial_number":{"value":"","description":"业务流水号"},"bill_verification_code":{"value":"","description":"票据校验码"},"issuance_date":{"value":"","description":"开具日期"},"total_pages_of_invoice":{"value":"","description":"票据总页数"},"current_page_number":{"value":"","description":"当前页码"}},"patient_information":{"name":{"value":"","description":"姓名"},"gender":{"value":"","description":"性别"},"age":{"value":"","description":"年龄"},"inpatient_number":{"value":"","description":"住院号"},"medical_record_number":{"value":"","description":"病历号"},"outpatient_number":{"value":"","description":"门诊号"},"patient_medical_insurance_number":{"value":"","description":"患者医保编号"},"patient_medical_insurance_type":{"value":"","description":"患者医保类型"},"patient_social_security_card_number":{"value":"","description":"患者社保卡号"}},"medical_visit_institution_information":{"name_of_medical_institution":{"value":"","description":"医疗机构名称"},"type_of_medical_institution":{"value":"","description":"医疗机构类型"},"department":{"value":"","description":"科别"},"admission_time":{"value":"","description":"入院时间"},"discharge_time":{"value":"","description":"出院时间"},"hospitalization_days":{"value":"","description":"住院天数"},"medical_treatment_date":{"value":"","description":"就诊日期"}},"expense_information":{"total_amount_in_words":{"value":"","description":"大写合计金额"},"total_expense_amount":{"value":"","description":"费用合计金额"},"personal_account_balance":{"value":"","description":"个人账户余额"},"personal_self_payment_amount":{"value":"","description":"个人自付金额"},"personal_self_funded_amount":{"value":"","description":"个人自费金额"},"prepaid_amount":{"value":"","description":"预缴金额"},"supplementary_payment_amount":{"value":"","description":"补缴金额"},"refund_amount":{"value":"","description":"退费金额"}},"payment_method":{"payee_unit":{"value":"","description":"收款单位"},"payee":{"value":"","description":"收款人"},"reviewer":{"value":"","description":"复核人"},"payer":{"value":"","description":"交款人"},"medical_insurance_overall_planning_payment":{"value":"","description":"医保统筹支付"},"personal_account_payment":{"value":"","description":"个人账户支付"},"personal_cash_payment":{"value":"","description":"个人现金支付"},"other_payments":{"value":"","description":"其他支付"}},"item_details":[[{"amount":{"value":"","description":"金额"},"remarks":{"value":"","description":"备注"},"project_name":{"value":"","description":"项目名称"},"quantity":{"value":"","description":"数量"},"unit_price":{"value":"","description":"单价"},"project_code_symbol":{"value":"","description":"项目编码/代号"}}]]}}]}}

错误码说明

错误码 描述
40101 x-ti-app-id 或 x-ti-secret-code 为空
40102 x-ti-app-id 或 x-ti-secret-code 无效，验证失败
40103 客户端IP不在白名单
40003 余额不足，请充值后再使用
40004 参数错误，请查看技术文档，检查传参
40007 机器人不存在或未发布
40008 机器人未开通，请至市场开通后重试
40301 文件类型不支持，接口会返回实际检测到的文件类型，如“当前文件类型为.gif”
40302 上传文件大小不符，文件大小不超过 10M
40303 文件类型不支持
40304 图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
40305 识别文件未上传
40306 QPS超过限制，收到此状态码时请勿重试，持续请求可能触发IP流控，如需扩容请联系商务
40400 无效的请求链接，请检查链接是否正确
30203 基础服务故障，请稍后重试
500 服务器内部错误
技术交流群
技术交流群

联系我们