接口使用配置操作手册与
开发技术深层讲解
1. 接口概述
为了方便客户的工作以及实现及时结报
2. 接口类型
2.1 接口模式分类: 接口分为外挂式接口, 嵌入式接口, 模拟接口, 共享式接口.
2.1.1 外挂式接口:
1> 使用方式: 一种是程序中实现的外部接口; 一种是his提供视图供对方公司调用, 具体配置在第4功能点详细讲解.
2> 业务场景: his系统需要现金结算之后, 不需要及时进行结报. 隔几天再到医院进行报销.
2.1.2 嵌入式接口:
1> 使用方式: 询问农合办或者第三方公司要求对应的参数信息,根据配置文件进行配置. 比如说:地区编码, 医疗机构编码, 经办人, 用户名与密码, 具体配置在第4功能点详细讲解.
2> 业务场景: 嵌入式接口就是嵌入到his系统中, 与his的业务绑定一起处理, 可以实现及时结报.
2.1.3 模拟接口:
1> 使用方式: 首先进行接口设置. 配置好即可使用. 具体配置在第4功能点详细讲解.
2> 业务场景: 一种是医院操作员在第三方系统中进行报销结算之后, 再把补偿总额输入到his系统中, 一种是所有的计算方式都是根据医院的要求而定,开发出来的模拟接口, 不予第三方进行交互.
2.1.4 医保共享式接口:
1> 使用方式: 首先进行接口设置, 需要第三方公司提供对应的参数信息. 具体配置在第4功能点详细讲解.
2> 业务场景: 需要两边系统操作. 但是此接口是医保免费开发的.
3. 接口模式
具体分为: 接口管理, 票据接口管理, 药招平台接口管理, 平台数据上传接口管理, 银联接口;
目前都在投入使用.
4. 接口配置与使用
4.1.1 嵌入式接口配置
医保接口设置根据医保前台客户端的ini配置文件进行配置, 具体的配置参数见如下图:
农合接口设置配置如下图:
重要的参数:
接口服务地址, 所属机构编码, 所属区县编码, 登录帐号与密码需要咨询农合办或者农合部门人员.
打印补偿单模式:
窗体模式与普通模式, 窗体模式是直接调取农合提供的链接, 嵌入在窗体中. 展示农合的样式风格; 普通模式是调取农合提供的打印补偿单函数, 返回数据, his系统自己编辑样式进行补偿单样式打印;
是否传医院科室名称:
是入院的时候农合系统中需要显示his的科室名称, 需设置为是;
是否允许跨类别进行对应: 就是项目对应的时候, 药品对应到诊疗中.
IC卡类型门诊/住院: 0--表示手动输入; 其他表示读卡类型(这个根据不同的区县来设置,只限制湖南地区);
联系电话是否必填:
读卡或者查询的时候, 农合要求联系电话必需传入;
是否提示一般诊疗费补偿:
这个是针对其个别区县, 需要在门诊收费的时候, 只有当启用参数并且一般诊疗费补偿金额等于0的时候会提示;
门诊/住院是否进行银行转账:
针对医院开启一站式支付的医院. 如果开通则在收费或者是出院结算的时候, 会自动在规定的日期银行把补偿金额打入指定账户中; 前提是该病人必须按现金进行结算, 先垫付后补偿;
4.1.2 操作使用方式
4.1.2.1 门诊业务收费流程与接口业务流程图. 如下图:
(4.1.2.1-1 操作流程图)
4.1.2.2 住院业务收费流程与接口业务流程图:
4.2模拟接口
4.2.1 模拟接口: 洱源--农合,医保,城居,离休; 会同--民政,手动输入补偿金额.
4.2.2 模拟接口设置配置
模拟接口设置跟参数值没有关系, 默认保存确定即可;
4.3外挂式接口
外部接口: 配置方式跟嵌入式接口的配置方式一样, 但是操作方式截然不同.
视图接口: 根据第三方提供的视图结构化文档进行视图书写, 部署时单独创建数据库用户, 授予只访问这几个视图的权限, 然后把建好的用户名与密码以及数据库的IP地址端口号提供给第三方即可.
4.4共享式接口
共享式接口: 是由于API接口医院要缴纳一定的费用, 但是共享式接口是第三方免费开放的,专门提供给his厂商进行调用的.
操作步骤: 医保系统入院登记--his系统入院登记--his系统住院上传--医保系统费用调取--医保系统费用结算--his系统出院结算---打印发票.
5. 接口开发
5.1前期准备
获知接口对接人联系方式.
获知接口的调用方式: 1. Webservice; 2.直插数据库; 3.调用动态库; 4.COM组件;
获知接口地址以及一些配置信息;
熟悉his中的接口的框架;
获知网络环境是外网还是内网;
从接口文档中分离出以下几个公共方法的能力, 每一个接口大致可以分为获取病人信息, 登记, 上传明细, 预结算, 结算, 召回, 打印结算单. 还有一些扩展方法.
5.2搭建空框架
具体代码讲解.
5.3实现公用方法
具体代码讲解.
5.4调 试
调试接口需要搭建环境, 如果是外网直接可以在公司进行调试, 如果是专网则需要去现场或者远程搭建环境进行调试, 不建议远程调试, 耗时长, 出现接口方问题不能及时沟通解决;
6. 常见问题处理