农医保接口开发

 

 接口使用配置操作手册与

开发技术深层讲解

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. 常见问题处理