欢迎访问自贡市第一人民医院官方网站
医院OA办公系统  
医患互动  
联系我们  
专家坐诊时间表  
新农合异地结算接口技术方案Ver2.8.9_ 2015.07.16
发布时间:2016-09-21 来源: 作者: 点击数:

目录

1       更新日志... 4

1.1           [2016/09/27] 2.8.11=>2.8.12. 4

1.2           [2016/06/1] 2.8.10 => 2.8.11. 5

1.3           [2015/07/23] 2.8. 9 => 2.8.10. 5

1.4           [2015/07/16] 2.8.8 => 2.8.9. 5

1.5           [2015/04/22] 2.8. 7 => 2.8.8. 6

1.6           [2014/11/26] 2.8. 6 => 2.8.7. 6

1.7           [2014/11/17] 2.8. 5 => 2.8.6. 6

1.8           [2014/10/21] 2.8. 4 => 2.8.5. 6

1.9           [2014/10/21] 2.8. 3 => 2.8.4. 7

1.10        [2014/09/29] 2.8. 2 => 2.8.3. 7

1.11        [2014/09/20] 2.8. 1 => 2.8.2. 7

1.12        [2014/09/20] 2.8. 0 => 2.8.1. 8

1.13        [2014/09/19] 2.7.10 => 2.8. 0. 8

1.14        [2014/09/18] 2.7.9 => 2.7.10. 10

1.15        [2014/09/15] 2.7.8 => 2.7.9. 10

1.16        [2014/09/12] 2.7.7 => 2.7.8. 11

1.17        [2014/09/10] 2.7.6 => 2.7.7. 12

1.18        [2014/09/10] 2.7.5 => 2.7.6. 12

1.19        [2014/09/09]2.7.4 => 2.7.5. 13

2       前言... 13

3       概述... 13

4       身份认证... 13

4.1           医疗机构身份认证... 13

4.2           参合人员身份认证... 14

5       新农合业务流程... 14

5.1           住院流程状态... 14

5.2           普通结算... 15

5.3           预结算... 16

5.4           重大疾病... 16

6       接口... 18

6.1           重要说明... 18

6.2           业务流程接口... 19

6.2.1     入院... 19

6.2.2     查询转诊转出医疗机构... 20

6.2.3     撤销入院... 21

6.2.4     上传清单... 21

6.2.5     获取清单... 22

6.2.6     撤销部分清单... 23

6.2.7     使用HisID撤销部分清单... 23

6.2.8     撤销指定住院的全部清单... 24

6.2.9     出院... 24

6.2.10            撤销出院... 25

6.2.11            预结算... 26

6.2.12            结算... 26

6.2.13            撤销结算... 27

6.2.14            获取补偿凭证... 28

6.2.15            获取补偿凭证() 28

6.2.16            预览垫付资金申请表... 29

6.2.17            获取(打印)垫付资金申请表... 30

6.2.18            发送【撤销结算申请】... 30

6.2.19            查询最后一次【撤销结算申请】处理结果... 31

6.2.20            取消【撤销结算申请】... 31

6.2.21            重大疾病... 32

6.2.21.1        申请重大疾病... 32

6.2.21.2        查询重大疾病申请信息... 33

6.2.21.3        撤销申请重大疾病... 33

6.2.22            跨省转诊单上传... 34

6.2.23            标记逃费病人... 35

6.2.24            取消已标记逃费病人... 35

6.3           结算/预结算补偿方式... 36

6.3.1     补偿方式分类... 36

6.3.2     普通补偿... 36

6.3.3     特殊补偿... 36

6.3.3.1           特殊补偿分类... 36

6.3.3.2           重大疾病(ZDJB) 37

6.3.3.3           特殊疾病(TSJB)、特殊政策(TSZC)、单病种(DBZ) 37

6.4           辅助查询接口... 38

6.4.1     测试区县网络... 38

6.4.2     获取区划代码表(省、市、县三级)... 38

6.4.3     获取新农合医疗项目码表... 38

6.4.4     获取疾病编码表... 39

6.4.5     获取新农合特殊补偿码表... 39

6.4.6     获取新农合清单分类码表... 40

6.4.7     查询个人信息... 40

6.4.8     使用个人ID查询个人信息... 41

6.4.9     查询家庭成员信息... 41

6.4.10            查询住院信息... 41

6.4.11            获取补偿信息... 42

6.4.12            获取详细补偿信息... 43

6.4.13            查询跨省转诊单信息... 43

6.4.14            查询省外转诊医疗机构信息... 43

6.4.15            查询跨省转诊单信息... 44

7       相关类定义... 44

7.1           ICD10. 44

7.2           ItemClass. 45

7.3           ItemDetail 45

7.4           MedicalItem.. 46

7.5           Org. 47

7.6           PagingItemDetail 47

7.7           PayDetailInfo. 48

7.8           PayInfo. 49

7.9           PayList 51

7.10        PayVoucher 51

7.11        PersonInfo. 52

7.12        QdClassFee. 53

7.13        SIRequest 53

7.14        XnhCodeTableItem.. 54

7.15        XnhResult 54

7.16        ZhenLiaoMap. 54

7.17        ZyInfo. 55

7.18        ZzBillInfo. 56

 

 

 

 

 

1       更新日志

1.1     [2016/09/27] 2.8.11=>2.8.12

1)     添加跨省转诊单上传接口UploadKsZzRecords

2)     添加查询跨省转诊单信息接口GetKsZzBill:用于查询跨省转诊单信息;

3)     添加跨省转诊单类ZzBillInfo

4)      修改入院接口:InHospital入院类型添加“省外转诊”,码值为10,当选择省外转诊时,inHosInfo输入转诊单据号,转诊单号通过GetKsZzBill接口获取;

5)     添加查询省外转诊医疗机构信息接口:GetKsZzOrgs,用于查询可转诊的省外定点医疗机构;

6)     修改PayInfo类:添加可报销费用Kbxfy、封顶线Fdx、报销比例BL、起付线Qfx、本地累计报销费用Bdljbxfy、异地累计报销费用Ydljbxfy

7)     添加标记逃费病人接口SingDodgingToll:标记后经中心审核,该人员则无法在其他医疗机构结算;

8)     添加取消已标记逃费病人接口CancelSingDodgingToll:用于取消已标记的人员;

1.2     [2016/06/1] 2.8.10 => 2.8.11

1)      InHospital入院类型添加“门诊转诊”,码值为6(不涉及降起付线);

2)     添加GetPayVoucherNew接口(获取补偿凭证)

1.3     [2015/07/23] 2.8. 9 => 2.8.10

1)       调整目录层级,显示到第四级;

2)        调整文档结构:6.2.15 6.2.19调整次序,使之符合流程图次序。

to

1.4     [2015/07/16] 2.8.8 => 2.8.9

3)       第二批省级定点医院,大部分是市/州级医院。按相关政策调整,市/州级医院能够查询出县级以下的转诊医院;

4)       第二批省级定点医院,部分是县/区级医院,按相关政策可以首诊。 因此,InHospital方法新增入院方式“基层医疗机构首诊,供县级和县级以下的定点医院使用。

5)       此次更新不影响2.8.8版接口的使用。

1.5     [2015/04/22] 2.8. 7 => 2.8.8

1)        InHospital方法新增入院方式“复诊,免起付线。

1.6     [2014/11/26] 2.8. 6 => 2.8.7

1)        提高ItemDetail类价格字段的精确度:

publicdecimal?     Price;   //纳入补偿单价(精确到小数点后6)  (上传清单时置空,结算/预结算后获取时有值)

         publicdecimal ReallyPrice;  // [必填] 实收单价(精确到小数点后6)

         publicdecimal SumMoney; // [必填] 合计金额(精确到小数点后6)

1.7     [2014/11/17] 2.8. 5 => 2.8.6

1)        查询住院信息GetZyList返回数据量由100扩大到2000,便于医院查询住院信息。

1.8     [2014/10/21] 2.8. 4 => 2.8.5

2)        入院接口方法(InHospital)增加一种入院方式:普通(3),仅限市/州、区/县级医疗机构使用。

目前4种入院类型

l          急诊(1)

按正常方式计算,按政策要求提供相关手续证明。

l          转诊(2)

扣减起付线,按政策要求提供相关手续证明。

l          普通(3)

按参合地市州政策,可能会受到惩罚措施处理,如提高起付线或者降低报销比例。

l          特殊人群(99)

按正常方式计算,按政策要求提供相关手续证明。

1.9     [2014/10/21] 2.8. 3 => 2.8.4

3)        应政策要求,入院方法,新增加一种入院方式,即“特殊人群(99)”,详细使用方式见入院方法说明。此次更新不修改接口定义,对现有接入的客户端软件无影响。

文件摘要:

“对于需要特殊陪护才能就医的特殊人群(65岁以上老年人、0-6岁婴幼儿,重度残疾人等)、急危重症患者、同类疾病需要再次入院治疗患者、孕产妇、专科疾病患者等,可根据病情需要自主选择省内首次就诊医疗机构。”

1.10         [2014/09/29] 2.8. 2 => 2.8.3

1)        获取补偿凭证GetPayVoucher增加返回图片格式;

2)                                获取(打印)垫付资金申请表GetPays返回值PayList对象的Remark字段赋值为本次获取的住院信息的HisID拼接字符串,以";"分隔。

3)                                修正部分文档的错误描述。

4)                                转诊转出医疗机构增加一条记录:

{Name=“其他医疗机构” , NamePY =” QTYLJG”}起付线扣减额度为0

在转诊时查询不到转诊转出医院,可使用此数据,以便病人能够办理入院。

1.11         [2014/09/20] 2.8. 1 => 2.8.2

1、  支持分级转诊,涉及2项修改:

1)        入院接口增加2个参数;

2)        增加一个查询转诊转出医疗机构方法;

3)        增加一个类Org

2、  修复查询个人、家庭,返回的个人ID错误的问题;

3、  查询个人、家庭,若出生日期为空,则默认为0001/01/01

1.12         [2014/09/20] 2.8. 0 => 2.8.1

1、  ZyInfo类增加一个字段,更新类的说明信息

//撤销结算申请状态:

// -1 没有有效申请信息,

// 0 待审,

// 1 同意,

// 2 拒绝

publicint? CancelPayStatus;

2、  获取(打印)垫付资金申请表预览垫付资金申请表查询结果做了详细说明。主要是返回的数据受到“撤销结算申请状态”的影响:若某条住院信息发送了撤销结算申请,且处理状态是0(待审)或1(通过),那么,它不会出现在查询结果中,若处理状态是2(拒绝),则会出现在查询结果中。

3、  增加住院流程状态说明。

1.13         [2014/09/19] 2.7.10 => 2.8. 0

1、  流程优化,便于医院更顺畅地开展新农合异地结算业务:

1)在调用获取(打印)垫付资金申请表(GetPays)之前,可以直接使用CancelPay撤销结算

2) 在调用获取(打印)垫付资金申请表(GetPays)之后,需经申请/审批流程才能撤消结算。

相关修改如图:

2、  添加预览垫付资金申请表PreViewPays方法,便于在正式获取(打印)垫付资金申请表(GetPays)之前检查申请表信息。

3、  添加了2个调试方法

public void TestSoapException()

public void TestException()

调用后直接抛出SoapExceptionException异常,便于调试异常处理。

4、  增加一个调试页面,地址是:http://172.18.11.10:90/TestWS.aspx,方便调试与经办机构审批有关的操作;如图:

5、  更新流程图。

6、  流程变更影响到的查询类方法:

查询住院信息GetZyList, 参数住院状态(zyStatus)变更为:

已入院                            1

已出院                            2

已结算                            4

已打印了补偿凭证                  8

已打印了垫付资金申请表             16

已完成审批                        32

可组合如:(已入院1+ 已出院2)  3

1.14         [2014/09/18] 2.7.9 => 2.7.10

1、  关于清单价格、数量,合计金额,根据医院实际情况做了调整,放宽了验证:

一、合计金额不限制小数位数;

二、验证只精确到小数点后2位,即:

四舍五入保留2位小数(单价×数量)== 四舍五入保留2位小数(合计金额)

2、  优化了撤销结算方法,减小其受到的区县数据交换的影响。

1.15         [2014/09/15] 2.7.8 => 2.7.9

1、  MedicalItem类增加1个属性Class11,标识项目的11类分类,便于对码;

2、  补充/修正了部分类的说明;

3、  修正部分链接;

4、  关于接口参数personID的说明:

InHospitalGetPersonInfoByIDGetZyList3个接口方法中有一个参数名为personID,此数据来源于GetPersonInfo方法的返回值,类型为PersonInfo[],是PersonInfo类的一个字段:

publicstring ID;//新农合居民省平台唯一标识

1.16         [2014/09/12] 2.7.7 => 2.7.8

1、  增加了新的接口方法:撤销结算CancelPay

调整了相关流程,撤销结算动作由医院发起,如下图:

1)        结算之后,如果没有调用GetPayVoucher打印补偿凭证,可以调用CancelPay撤销结算,退回到[已出院]状态;

2)        已经调用GetPayVoucher打印了补偿凭证,需要撤销结算,则需发送申请,经办机构审批通过后,方可调用CancelPay撤销结算;

3)          因此,医院在打印补偿凭证之前,可以撤销结算。但须仔细核对补偿信息后再打印补偿凭证,避免进入撤销结算的申请/审批环节。

2、  补充了接口说明:撤销申请重大疾病CancelRequestSI

3、  删除了文档的接口列表小节,创建了文档目录。

1.17         [2014/09/10] 2.7.6 => 2.7.7

1、  PersonInfo类增加了一个字段,标识数据来源:

publicstring DataFrom;  //数据来源:1区县农合数据库,2省中心数据库

       影响到的接口方法有:

查询个人信息GetPersonInfo

使用ID查询个人信息GetPersonInfoByID

查询家庭成员信息 GetFamilyInfo

以上3个方法获取数据的逻辑:

1)   优先从区县数据库获取,获取成功则返回数据;

2)   若区县数据库获取失败,则从省平台的备份数据库获取,成功则返回数据,失败则抛出异常。

这样做目的在于使业务流程不受区县网络的影响,让病人能够顺利的办理新农合异地结算的业务。相关的流程环节也记录了这些信息,以备监管。

正常情况下,从区县数据库和省平台的备份数据库查询出来的数据是一致的,但因为数据同步有时间差,所以有可能造成查询结果不一致。

1.18         [2014/09/10] 2.7.5 => 2.7.6

1、  增加接口方法:使用HisID撤销部分清单CancelItemsByHisID

2、  经数据分析,一次住院清单条数2000条以下的占99%以上,但也有少量2000条甚至10000条以上的情况。因此住院清单上传/下载仍需分页,分页大小修改为2000。涉及的接口方法有:

上传清单SendItems

获取清单GetItems

1.19         [2014/09/09]2.7.4 => 2.7.5

1、  ICD10 MedicalItem增加了名称拼音简码字段,以便于HIS软件查询,字段定义:publicstring NamePY;

2       前言

此方案的接口将于2014101日正式上线运行,届时旧接口将逐步停用。2014101日前,各医疗机构仍使用旧接口进行异地结算业务。

3       概述

新农合异地结算业务涉及患者、医疗机构、新农合省中心、新农合各区县经办机构及各级各类监管机构,业务流程复杂,数据庞大。本方案主要涉及异地结算业务中,患者信息从医疗机构到新农合省中心的流转,以及与患者参合地经办机构的交互,实现基本的异地结算流程。概括来说,就是医疗机构发送患者就医信息到农合省中心,相关机构进行认证和审批。

4       身份认证

4.1     医疗机构身份认证

新农合异地定点医疗机构在农合省中心有注册信息和身份标识,在调用接口时需提供相关数据进行认证(异地医疗机构唯一识别码)。

医疗机构信息中,行政区划级别(如:省级、市州级、县级)、医疗机构级别(如三甲、二乙)是很重要的数据,根据政策要求,直接影响异地结算各项费用计算,如有变更,请及时联系省农合信息中心备案、更新。

4.2     参合人员身份认证

就诊参合人员提供参合证,将参合证的信息与系统中查询出来的姓名、参合号、身份证、住址等信息进行综合对比认证。系统中查询参合人员信息需要访问参合区县数据库,因此必须保证该区县和省中心网络畅通

新农合省平台参合人员的唯一标识(新农合居民省平台唯一标识),其长度为20位数字,前6位标识区县编码,后14位是县平台的参合人员唯一标识。

5       新农合业务流程

新农合异地结算业务记录患者从入院、治疗、出院、结算、审批环节的信息,最后医疗机构和经办机构打印结算单。在院期间可进行预结算,查看当前结算数据。入院后若诊断为重大疾病,须在结算前发送重大疾病申请。

5.1     住院流程状态

//  已入院                  1

    //  已出院                  2

    //  已结算                  4

    //  已打印了补偿凭证         8

    //  已打印了垫付资金申请表        16

    //  已完成审批               32

5.2     普通结算

E:\Project\xnh\Doc\1.新农合异地结算\2014接口方案\新农合异地结算总体流程.png

(因排版原因,此图非原始大小,可另存为图片查看原图)

5.3     预结算

入院后至结算前可进行预结算,方便在住院期间及时查看报销情况。

C:\Users\Administrator\Desktop\预结算.png

5.4     重大疾病

入院后至结算前,医疗机构可发送重大疾病申请。

重大疾病申请发送后,结算前,医疗机构可以调用接口查看申请审批状态。

重大疾病申请发送后,结算前,无论是否审批,医疗机构都可以取消申请。

结算/预结算时若申请还未审批,则流程阻塞,医疗机构须联系农合经办机构,让其审批。农合经办机构审批同意,则按重大疾病政策结算,拒绝则按普通方式结算。或者取消申请,按普通方式结算。

C:\Users\Administrator\Desktop\重大疾病.png

6       接口

6.1     重要说明

一、            此文档所有接口、类定义基于 .net framework 平台来描述。

二、            WSDL地址:http://172.18.11.10:90/XnhService.asmx?wsdl

三、            常用数据类型

int

4byte 32bit有符号整数,默认值为0

Int?

可为nullint

string

字符串

DateTime

日期时间

DateTime?

可为nullDateTime

decimal

128位数据类型,适合于财务和货币计算。

decimal?

可为nulldecimal

bool

布尔型, true false

四、            接口类别

按接口作用可分为2类:查询类、流程类。

查询类接口主要用于基础数据查询(码表、参合人员信息、家庭信息等)和业务流程上的辅助查询(住院信息)。

流程类接口使用于各个流程环节,完成各阶段的业务。

五、            参数描述

String类型的参数长度单位是byte,可表示1个英文字母或阿拉伯数字,一个汉字是2byte。长度描述规则:

                n: 定长字符串,如:32

                m,n: 变长字符串,如:1,20m>0表示必填)。

                n1/n2:长度必须是n1或者n2,如:15/18(身份证编号长度)

六、            接口版本

各接口中涉及的参数int version为预留参数,请填1,表示当前接口的实现版本。

6.2     业务流程接口

6.2.1    入院

入院

InHospital

接口定义

       publicXnhResult InHospital(

           int version,

           string hospitalCode,

           string hisID,

           string dept,

           string doctorName,

           string cardCode,

           string personID,

           string name,

           string IDCard,

           DateTime inHosTime,

           string ICDCode,

           string diagnose,

           string tel,

           int inHosType,

           stringzzOutHosID

           )

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

hisID

string

His住院号(建议his系统内唯一,以便于查询)

1,30

 

dept

string

入院科室

1,200

 

doctorName

string

主治医生姓名

1,20

 

cardCode

string

患者参合号

20

 

personID

string

新农合居民省平台唯一标识

20

PersonInfo.ID

name

string

患者姓名

1,20

 

IDCard

string

患者身份证号

15/18

 

inHosTime

DateTime

入院时间

 

 

ICDCode

string

入院诊断ICD编码

1,100

 

diagnose

string

入院诊断

1,255

 

tel

string

患者联系电话

0,50

 

inHosType

Int

入院类型:

急诊(1)

转诊(2)

普通(3)

复诊(4)

基层医疗机构首诊(5)

门诊转诊(6)

特殊人群(99)

省外转诊(10)

 

注意:普通(3)仅县、市级医院可用

zzOutHosID

类型String, 长度0,200

此参数根据inHosType类型填写:

急诊(1):留空

转诊(2):必填转出医院ID,转出医院ID通过GetZzOrgs获取;

普通(3):留空

复诊(4):留空

基层医疗机构首诊(5):留空

省外转诊(10):转诊单据号

特殊人群(99):必填特殊人群编码,编码表如下:

IHTS001        65岁以上老年人

IHTS002        0-6岁婴幼儿

IHTS003        重度残疾人

IHTS004        急危重症患者

IHTS005        同类疾病需要再次入院治疗的患者

IHTS006        孕产妇

IHTS007        专科疾病患者

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = 新农合住院唯一标识(36byte字符串)

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.2    查询转诊转出医疗机构

转诊医疗机构信息

GetZzOrgs

接口定义

GetZzOrgs(int version, string hospitalCode, string name, string namePY)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

name

string

机构名称(模糊查询)

0,20

 

namePY

string

机构名称拼音简码(模糊查询)

0,20

 

返回值说明

Org对象数组,返回满足查询条件的前100条。

6.2.3    撤销入院

撤销入院

CancelInHospital

接口定义

        publicXnhResult CancelInHospital(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            string cancelReason)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

cancelReason

string

撤销原因

1,200

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.4    上传清单

上传清单

SendItems

注意:

1、 清单条数2000以内请一次传完;

2、 清单条数多于2000条按每次2000条分批次上传;

3、 上传多条清单时,切勿每次调用接口只传一条,这样不但影响传输效率,而且会造成极大的服务器、网络资源浪费,省中心对上传清单会进行监控。

4、 目前设置的每次2000条,后期会根据实际运行情况进行调整,建议HIS厂商将此参数设置为可在HIS软件里边修改。

接口定义

        publicXnhResult SendItems(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            ItemDetail[] items)

输入参数说明

参数名

类型

说明

长度

备注

version

int     

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

操作人姓名

1,20

 

items

ItemDetail[]

住院清单数组

 

数组长度12000

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.5    获取清单

获取清单

GetItems

接口定义

        publicPagingItemDetail GetItems(

            int version,

            string hospitalCode,

            string xnhZyID,

            int ItemClass,

            int pageIdx

            )

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

ItemClass

int

清单分类

 

-1表示全部

pageIdx

int

页号

 

0 (n-1)

返回值说明

PagingItemDetail 对象,具体说明参见PagingItemDetail类定义。

 

6.2.6    撤销部分清单

撤销部分清单

CancelItems

接口定义

        publicXnhResult CancelItems(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            int[] itemIDs)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

操作人姓名

1,20

 

itemIDs

int[]

新农合住院清单ID数组

 

数组长度150

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.7    使用HisID撤销部分清单

使用HisID撤销部分清单

CancelItemsByHisID

接口定义

        publicXnhResult CancelItemsByHisID(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            string[] hisItemIDs)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

操作人姓名

1,20

 

hisItemIDs

string[]

新农合住院清单HisID数组

 

数组长度150;

HisID不能有为空的。

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.8    撤销指定住院的全部清单

撤销指定住院的全部清单

CancelAllItem

接口定义

publicXnhResult CancelAllItem(int version, string hospitalCode, string xnhZyID, string processMan)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

操作人姓名

1,20

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.9    出院

出院

OutHospital

接口定义

        publicXnhResult OutHospital(

            int version,

            string hospitalCode,

            string xnhZyID,

            string dept,

            DateTime outHosTime,

            string ICDCode,

            string outHosDiagnose,

            string doctorName,

            string result)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

dept

string

出院科室

1,200

 

outHosTime

DateTime

出院时间

 

 

ICDCode

string

出院诊断ICD编码

1,100

 

outHosDiagnose

string

出院诊断

1,255

 

doctorName

string

主治医生姓名

1,20

 

result

string

治疗结果

1,50

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.10   撤销出院

撤销出院

CancelOutHospital

接口定义

publicXnhResultCancelOutHospital(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明] 

6.2.11   预结算

预结算

SimulationPay

接口定义

        publicPayInfo SimulationPay(

            int version,

            string hospitalCode,

            string xnhZyID,

            string para1,

            string para2,

            string para3,

            string para4,

            string para5,

            string para6,

            string para7,

            string para8,

            string para9,

            string[] extParameters)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

para1

string

结算参数(特殊补偿方式编码)

 

 

para2

string

结算参数

 

 

para3

string

结算参数

 

 

para4

string

结算参数

 

 

para5

string

结算参数

 

 

para6

string

结算参数

 

 

para7

string

结算参数

 

 

para8

string

结算参数

 

 

para9

string

结算参数

 

 

extParameters

string[]

扩展参数

 

 

返回值说明

PayInfo对象。

6.2.12   结算

结算

CompletePay

接口定义

publicPayInfo CompletePay(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            string invoice,

            string para1,

            string para2,

            string para3,

            string para4,

            string para5,

            string para6,

            string para7,

            string para8,

            string para9,

            string[] extParameters)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

invoice

string

发票号

1,30

 

para1

string

结算参数(特殊补偿方式编码)

 

 

para2

string

结算参数

 

 

para3

string

结算参数

 

 

para4

string

结算参数

 

 

para5

string

结算参数

 

 

para6

string

结算参数

 

 

para7

string

结算参数

 

 

para8

string

结算参数

 

 

para9

string

结算参数

 

 

extParameters

string[]

扩展参数

 

 

返回值说明

PayInfo对象。

6.2.13   撤销结算

撤销结算

CancelPay

接口定义

publicXnhResult CancelPay(int version, string hospitalCode, string xnhZyID, string processMan, string cancelReason)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

cancelReason

string

撤销原因

1,200

 

返回值说明

成功:XnhResult.Result = true , XnhResult.Msg = ""

失败:XnhResult.Result = false , XnhResult.Msg = [失败说明]

6.2.14   获取补偿凭证

获取补偿凭证

GetPayVoucher

接口定义

publicPayVoucher GetPayVoucher(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本(1/2)

 

1返回PDF

2返回JPG

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

返回值说明

PayVoucher 对象。

6.2.15   获取补偿凭证()

获取补偿凭证

GetPayVoucherNew

接口定义

publicPayVoucher GetPayVoucherNew(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            stringbusinessMan,

            stringpaymentMan,

            stringtabMan,

            string phone)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本(1/2)

 

1返回PDF

2返回JPG

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

businessMan

string

核算人姓名

20

 

paymentMan

string

付款人姓名

20

 

tabMan

string

填表人姓名

20

 

phone

string

联系电话

20

 

返回值说明

PayVoucher 对象。

6.2.16   预览垫付资金申请表

预览垫付资金申请表

PreViewPays

注意:

1、                                           一次查询的时间范围 [beginTime , endTime]是闭区间,不能超过3个月;

2、                                           调用此方法不更改住院信息状态。

接口定义

        publicPayListPreViewPays(

            int version,

            string hospitalCode,

            DateTime beginTime,

            DateTime endTime)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

beginTime

DateTime

结算开始时间

 

 

endTime

DateTime

结算结束时间

 

 

返回值说明

PayList 对象。

只返回状态是【已打印补偿凭证】及之后状态的数据;

若住院状态是【已打印垫付资金申请表】且发送了撤销结算申请,会有以下2种情况:

1、  撤销结算申请处理状态为:0(待审)、1(通过),则不会出现在查询结果;

2、  撤销结算申请处理状态为:2(拒绝),则会出现在查询结果。

 

 

6.2.17   获取(打印)垫付资金申请表

获取(打印)垫付资金申请表

GetPays

注意:

1、一次查询的时间范围 [beginTime , endTime]是闭区间,不能超过3个月。

2、执行此方法后,住院信息状态变更:

【已打印了补偿凭证】=》【已打印了垫付资金申请表】,

之后,进入经办机构审批流程。

接口定义

        publicPayList GetPays(

            int version,

            string hospitalCode,

            DateTime beginTime,

            DateTime endTime)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

beginTime

DateTime

结算开始时间

 

 

endTime

DateTime

结算结束时间

 

 

返回值说明

PayList 对象。

PayList.Remark = 本次获取的住院信息的HisID拼接字符串,以";"分隔。

只返回状态是【已打印补偿凭证】及之后状态的数据;

若住院状态是【已打印垫付资金申请表】且发送了撤销结算申请,会有以下2种情况:

1、  撤销结算申请处理状态为:0(待审)、1(通过),则不会出现在查询结果;

2、  撤销结算申请处理状态为:2(拒绝),则会出现在查询结果。

6.2.18   发送【撤销结算申请】

申请撤销结算

RequestCancelPay

接口定义

        publicXnhResult RequestCancelPay(

            int version,

            string hospitalCode,

            string xnhZyID,

            string processMan,

            string cancelReason)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

processMan

string

经办人姓名

1,20

 

cancelReason

string

撤销原因

1,200

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

6.2.19   查询最后一次【撤销结算申请】处理结果

查询【撤销结算申请】处理结果

GetCancelPay

接口定义

publicint GetCancelPay(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

-2 没有发送过申请,

-1 已经取消,

0 待审,

1 同意,

2 拒绝

6.2.20   取消【撤销结算申请】

取消【撤销结算申请】

若申请已经处理,则取消失败

CancelRequestCancelPay

接口定义

publicXnhResult CancelRequestCancelPay(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

 

6.2.21   重大疾病

6.2.21.1     申请重大疾病

申请重大疾病

RequestSI

接口定义

        publicXnhResult RequestSI(

            int version,

            string hospitalCode,

            string xnhZyID,

            string siCode,

            int bcLevel,

            string description,

            string doctorName)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

siCode

string

重大疾病编码

1,50

 

bcLevel

int

重大疾病补偿标准

1 省级定点救治医院

2 二级医院

3 三级医院

 

 

description

string

申请说明

1,2000

 

doctorName

string

申请医生姓名

1,50

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

6.2.21.2     查询重大疾病申请信息

查询重大疾病申请信息

GetRequestSI

接口定义

publicSIRequest GetRequestSI(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

SIRequest对象

 

 

 

6.2.21.3     撤销申请重大疾病

撤销申请重大疾病

CancelRequestSI

接口定义

        publicXnhResult CancelRequestSI(

            int version,

            string hospitalCode,

            string xnhZyID,

            string doctorName,

            string description)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

doctorName

string

撤销医生姓名

1,50

 

description

string

撤销说明

1,2000

 

返回值说明

成功:XnhResult.Result = true , XnhResult.Msg = ""

失败:XnhResult.Result = false , XnhResult.Msg = [失败说明]

 

6.2.22   跨省转诊单上传

跨省转诊单上传

UploadKsZzRecords

接口定义

publicXnhResult UploadKsZzRecords(int version,

string hospitalCode,

string cardcode,

string ICDCode,

string ICDName,

string illustrate,

DateTime inHosTime,

string contacts,

string phone,

string patientContacts,

string patientPhone,

string inHospOne,

string inHospTwo,

string inHospThree)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

cardcode

string

参合号

20

 

ICDCode

string

诊断ICD

10

 

ICDName

string

诊断名称

192

 

illustrate

string

申请说明

270

 

inHosTime

DateTime

就诊时间

 

"yyyy-MM-dd HH:mm:ss"

contacts

string

机构联系人

50

 

phone

string

联系电话

20

 

patientContacts

string

患者联系人

50

 

patientPhone

string

患者联系电话

20

 

inHospOne

string

转入医疗机构1编号

50

通过“GetKsZzOrgs”获取

inHospTwo

string

转入医疗机构2编号

50

同上

inHospThree

string

转入医疗机构3编号

50

同上

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

 

6.2.23   标记逃费病人

标记逃费病人

SingDodgingToll

接口定义

publicXnhResult SingDodgingToll(

int version,

string hospitalCode,

string cardcode,

string doctorName)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

cardcode

string

参合号

20

 

doctorName

string

标记操作人姓名

50

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

 

6.2.24   取消已标记逃费病人

取消已标记逃费病人

CancelSingDodgingToll

接口定义

publicXnhResult CancelSingDodgingToll(

int version,

string hospitalCode,

string cardcode,

string doctorName)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

cardcode

string

参合号

20

 

doctorName

string

标记操作人姓名

50

 

返回值说明

XnhResult对象。

成功:

XnhResult.Result = true , 

XnhResult.Msg = ""

失败:

XnhResult.Result = false ,

XnhResult.Msg = [失败说明]

 

 

 

6.3     结算/预结算补偿方式

6.3.1    补偿方式分类

新农合的补偿方式,总的可以分为普通补偿特殊补偿

6.3.2    普通补偿

预结算结算的参数para1 para9,extParameters都留空;

6.3.3        特殊补偿

6.3.3.1        特殊补偿分类

特殊补偿有4种类型:

重大疾病(ZDJB)

特殊疾病(TSJB)

特殊政策(TSZC)

单病种(DBZ)

每种类型可通过获取新农合特殊补偿码表接口方法获取详细的清单,此方法返回值的数据类型是XnhCodeTableItem对象数组

XnhCodeTableItem 对象字段说明:

publicstring Name;          //特殊补偿名称

publicstring NamePY;        //特殊补偿名称拼音简码

publicstring Code;          //特殊补偿编码

publicstring Description;   //特殊补偿说明

publicstring Type;          //特殊补偿方式(如:定额、限额等,当前有9种)

6.3.3.2        重大疾病(ZDJB)

执行方式详见重大疾病申请/审批流程

6.3.3.3        特殊疾病(TSJB)、特殊政策(TSZC)、单病种(DBZ)

3类特殊补偿,通过在预结算结算的时候,参数para1传特殊补偿编码,既:XnhCodeTableItem.Code根据XnhCodeTableItem.Type ,9种计算方式中有2种需要额外传extParameters,具体如下:

9种补偿计算方式:

n    额定总费用和补偿费用

n    限额补偿

n    调整门槛费和报销比例

n    追加补偿

n    保底报销

n    单次特补

n    按总费用比例计算

n    定额补偿

n    分段报销

需要额外传extParameters2种计算方式是:

n    单次特补

单次特补,医疗机构须填写金额,操作人、补偿原因。

补偿费用:extParameters[0] = Fee,

操作人姓名:extParameters[1]= Oper,

补偿原因:extParameters[2] = Reason

n    调整门槛费和报销比例

调整门槛费和报销比例,医疗机构需指定:调整的门槛费、报销比例、调整原因、操作人姓名。

门槛费:   extParameters[0]

报销比例: extParameters[1]

调整原因: extParameters[2]

操作人姓名:extParameters[3]

6.4     辅助查询接口

6.4.1    测试区县网络

测试区县网络

TestNet

接口定义

publicXnhResult TestNet(int version, string hospitalCode, string countyCode)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

countyCode

string

区县代码

6

 

返回值说明

XnhResult对象。

网络通:XnhResult.Result = true ,    XnhResult.Msg = 该区县联系人信息

网络不通:XnhResult.Result = false , XnhResult.Msg = 该区县联系人信息

6.4.2    获取区划代码表(省、市、县三级)

获取区划代码表(省、市、县三级)

GetRegion

接口定义

publicXnhCodeTableItem[] GetRegion(int version, string hospitalCode)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

返回值说明

XnhCodeTableItem对象数组

XnhCodeTableItem 对象说明:

public string Name;         //区划名称

public string NamePY;       //区划名称拼音简码

public string Code;         //区划编码

public string Description;  //区划说明

public string Type;         //区划类别

6.4.3    获取新农合医疗项目码表

获取新农合医疗项目码表

此码表数据量大,首次(参数after2014-01-01 00:00:00)获取全部的数据,后边根据情况传适当的after 参数进行增量更新。

GetMedicalItem

接口定义

publicMedicalItem[] GetMedicalItem(int version, string hospitalCode, DateTime after, int bigCategory, bool includeRemark)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

after

DateTime

时间点,只取这个时间和之后(>=after)有变化(添加、废止)的数据

 

 

bigCategory

int

三大类: 药品1、诊疗2 、耗材4

 

 

includeRemark

bool

是否包含备注信息

 

 

返回值说明

MedicalItem对象数组

6.4.4    获取疾病编码表

获取疾病编码表

此码表数据量大,首次(参数after2014-01-01 00:00:00)获取全部的数据,后边根据情况传适当的after 参数进行增量更新。

GetICD10

接口定义

publicICD10[] GetICD10(int version, string hospitalCode, DateTime after)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

after

DateTime

时间点,只取这个时间和之后(>=after)有变化(添加、废止)的数据

 

 

返回值说明

ICD10对象数组

6.4.5    获取新农合特殊补偿码表

获取新农合特殊补偿码表

GetXnhCodeTable

接口定义

publicXnhCodeTableItem[] GetXnhCodeTable(int version, string hospitalCode, string regCode, string codeTableName)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

countyCode

string

()县代码

6

codeTableName

string

码表名称,目前有:

ZDJB    重大疾病

TSJB    特殊疾病

TSZC    特殊政策

DBZ     单病种 

1,20

 

返回值说明

XnhCodeTableItem对象数组

XnhCodeTableItem对象字段说明:

publicstring Name;          //特殊补偿名称

publicstring NamePY;        //特殊补偿名称拼音简码

publicstring Code;          //特殊补偿编码

publicstring Description;   //特殊补偿说明

publicstring Type;          //特殊补偿方式类别(如:定额、限额等)

6.4.6    获取新农合清单分类码表

获取新农合清单分类码表

GetXnhItemClass

接口定义

publicItemClass[] GetXnhItemClass(int version, string hospitalCode)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

返回值说明

ItemClass对象数组

6.4.7    查询个人信息

查询个人信息

GetPersonInfo

接口定义

publicPersonInfo[] GetPersonInfo(int version, string hospitalCode, string countyCode, string cardCode, string IDCard, string name)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

countyCode

string

区县代码

6

 

cardCode

string

个人参合号

0/20

 

IDCard

string

身份证号

0/15/18

 

name

string

姓名

0,20

 

返回值说明

PersonInfo对象数组

最多只返回满足查询条件的前100条记录(查询条件越详细,查询结果越精准)

6.4.8    使用个人ID查询个人信息

使用ID查询个人信息

GetPersonInfoByID

接口定义

publicPersonInfo GetPersonInfoByID(int version, string hospitalCode, string personID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

personID

string

新农合居民省平台唯一标识

20

PersonInfo.ID

返回值说明

PersonInfo对象

6.4.9    查询家庭成员信息

查询家庭成员信息

GetFamilyInfo

接口定义

publicPersonInfo[] GetFamilyInfo(int version, string hospitalCode, string countyCode, string familyCode)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

countyCode

string

区县代码

6

 

familyCode

string

家庭参合号

18

 

返回值说明

PersonInfo对象数组

6.4.10   查询住院信息

查询住院信息

GetZyList

接口定义

publicZyInfo[] GetZyList(int version, string hospitalCode, string hisID, int zyStatus, DateTime beginTime, DateTime endTime, string personID, string cardCode, string IDCard, string name)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

hisID

string

His住院号(建议his系统内唯一,以便于查询)

0,30

 

zyStatus

int

已入院1

已出院2

已结算4

已打印了补偿凭证8

已打印了垫付资金申请表16

已完成审批32

 

可组合如:(已入院1+ 已出院2)3

 

取值范围:

>=1 AND<=63

beginTime

DateTime

开始时间

 

必填

endTime

DateTime

结束时间

 

必填

personID

string

新农合居民省平台唯一标识

0/20

PersonInfo.ID

cardCode

string

个人参合号

0/20

 

IDCard

string

患者身份证号

0/15/18

 

name

string

患者姓名

0,20

 

返回值说明

ZyInfo对象数组,返回满足查询条件的前2000

6.4.11   获取补偿信息

获取补偿信息

GetPayInfo

接口定义

publicPayInfo GetPayInfo(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

PayInfo对象

6.4.12   获取详细补偿信息

获取详细补偿信息

GetPayDetailInfo

接口定义

publicPayDetailInfo GetPayDetailInfo(int version, string hospitalCode, string xnhZyID)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

xnhZyID

string

新农合住院唯一标识

36

 

返回值说明

PayDetailInfo 对象

 

6.4.13   查询跨省转诊单信息

查询跨省转诊单信息

GetKsZzBill

接口定义

publicZzBillInfo[] GetKsZzBill(int version, string hospitalCode, string IDCard)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

IDCard

string

身份证号

36

 

返回值说明

ZzBillInfo对象数组

 

6.4.14   查询省外转诊医疗机构信息

查询省外转诊医疗机构信息

GetKsZzOrgs

接口定义

publicOrg[] GetKsZzOrgs(int version, string hospitalCode, string name, string namePY)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

name

string

省外定点机构名称

100

 

namePY

 

省外定点机构拼音简码

20

 

返回值说明

Org对象数组

 

6.4.15   查询跨省转诊单信息

获取详细补偿信息

GetKsZzBill

接口定义

publicZzBillInfo[] GetKsZzBill(int version, string hospitalCode, string IDCard)

输入参数说明

参数名

类型

说明

长度

备注

version

int

接口版本

 

 

hospitalCode

string

异地医疗机构唯一识别码

32

 

IDCard

string

身份证号

36

 

返回值说明

ZzBillInfo对象数组

7       相关类定义

7.1     ICD10

publicclassICD10

{

publicstring Name;           //名称

publicstring NamePY;         //名称拼音简码

publicstring Code;           //编码

publicstring CodeExt;            //扩展编码

publicstring Description;        //说明

publicint Status;                //状态: 1正常 2废止。废止后就不能使用,但废止前发生的历史数据有效。

publicDateTime? AbolitionTime;//废止时间

publicDateTime BuildTime;        //创建时间

}

7.2     ItemClass

    publicclassItemClass

    {

        publicstring Name;      //名称

        publicstring Code;      //编码

        publicstringItemType;   //类别:药品、诊疗、耗材

        publicstring Remark;    //备注

    }

7.3     ItemDetail

     publicclassItemDetail

     {

         //----------------------------------------------------------------------------------

         publicint XnhItemID;        //新农合清单项ID(上传清单时置0,获取时有值)

         publicdecimal?     PayPercent;   //纳入补偿比例(精确到小数点后4) (上传清单时置空,结算/预结算后获取时有值)

         publicdecimal?     Price;        //纳入补偿单价(精确到小数点后6)  (上传清单时置空,结算/预结算后获取时有值)

         publicstring ItemCodeExt1;  //扩展编码1,预留,上传置空。     

         publicstring ItemCodeExt2;  //扩展编码2,预留,上传置空。     

         publicstring ItemCodeExt3;  //扩展编码3,预留,上传置空。     

         publicstring ItemCodeExt4;  //扩展编码4,预留,上传置空。     

         publicstring ItemCodeExt5;  //扩展编码5,预留,上传置空。     

         //----------------------------------------------------------------------------------

         publicstring XnhZyID;       // [必填] 住院ID

         publicint ItemClass;        // [必填] 11类清单分类代码(1-11

         publicstring XnhItemCode;   // [必填] 新农合项目编码

         publicstring Name;          // [必填] 清单项目名称

         publicstring HisItemCode;   //His系统自身的项目编码

         publicstring HisItemID; //His清单编号(尽量填写,后边可以用这个字段查询/撤销清单)

         //----------------------------------------------------------------------------------

         publicdecimal ReallyPrice;  // [必填] 实收单价(精确到小数点后6)

         publicdecimal Amount;       // [必填] 数量

         publicdecimal SumMoney; // [必填] 合计金额(精确到小数点后6)

         publicstring ChangePriceReason = "";// 价格变动原因(加价须说明原因,新农合经办机构会审核)

         publicDateTime ApplyTime;   // [必填] 开单时间

         publicstring Doctor;        // [必填] 开单医生姓名  

         publicstring Specs;         //规格       

         publicstring Dosage;        //剂型        

         publicstring Unit;          //单位       

         publicint? IsJK;            //是否进口:0(或留空)不是进口, 1进口

         publicint? ItemStatus;      //清单状态:0(或留空)普通,1重大疾病(重大疾病治疗项目传1)

         //----------------------------------------------------------------------------------

         /* 注意:

          *   1、关于规格、剂型和单位,如果清单项目是:

          *   a 药品:须指定规格、剂型;

          *   b 耗材:须指定规格、单位;

          *   c 诊疗:须指定单位,如有则指定规格。

          *

          *   2、关于数量、实收单价和合计金额

          *        a 实收单价、合计金额建议精确到四舍五入保留小数点后6位;

          *        b 上传清单的时候会验证:

          *            四舍五入保留2位小数(实收单价 *  数量)  ==  四舍五入保留2位小数(总价)

          *        如若不等,则上传失败。

         //-------------------------------------------------------------------------------*/

     }

7.4     MedicalItem

    publicclassMedicalItem

    {

        publicstring CategoryName;      // 全路径分类名称,例如:耗材-临床手术治疗-口腔 ,耗材-临床手术治疗-呼吸系统

        publicstring BigCategory;       // 三大类: 药品1、诊疗2 、耗材4

        publicstringClass11;            // 11

        publicstring Name;              // 名称

publicstring NamePY;            // 名称拼音简码

        publicstring Code;              // 编码

        publicint Status;               // 项目状态: 1正常  2废止。废止后就不能使用,但废止前发生的历史数据有效。

        publicstring DosageForms;       // 剂型(适用于药品,BigCategory=1

        publicstring Remark;            // 备注说明

        publicDateTime? AbolitionTime;  // 废止时间

        publicDateTime? BuildTime;      // 创建时间

    }

7.5     Org

///<summary>

   ///医疗机构信息

   ///</summary>

   publicclassOrg

   {

      publicstring ID;      // 唯一标识

      publicstring Name;    // 名称

      publicstring NamePy;  // 名称拼音简码

   }

7.6     PagingItemDetail

    ///<summary>

    ///分页数据(清单)

    ///</summary>

    publicclassPagingItemDetail

    {

        ///<summary>

        ///记录总条数

        ///</summary>

        publicint RecordCount;

 

        ///<summary>

        ///分页大小

        ///</summary>

        publicint PageSize;

 

        ///<summary>

        ///总页数(n)

        ///</summary>

        publicint PageCount;

 

        ///<summary>

        ///当前取回的数据是第几页: 0 (n-1),页号从0开始。

        ///</summary>

        publicint CurPage;

 

        ///<summary>

        ///数据

        ///</summary>

        publicItemDetail[] Items;

    }

7.7     PayDetailInfo

    //新农合补偿明细信息

    publicclassPayDetailInfo

    {

        publicstring Remark;                //备注

        //患者信息--------------------------------------------------------------------

        publicstring CountyName;            //患者参合区县名称

        publicstring Name;                  //患者姓名

        publicstring CardCode;              //患者农合号

        publicstring IDCard;                //患者身份证

        publicstring Tel;                   //患者联系电话

        //住院信息--------------------------------------------------------------------

        publicstring HospitalName;          //医院名称

        publicDateTime InHosTime;           //入院时间

        publicstring InHosDiagnose;     //入院诊断

        publicDateTime OutHosTime;          //出院时间

        publicstring OutHosDiagnose;        //出院诊断

        //结算信息--------------------------------------------------------------------

        publicDateTime PayTime;         //结算时间

        publicdecimal TotalMoney;           //总费用

        publicdecimal QzfMoney;         //总全自付费用

        publicdecimal JyMoney;              //基药费用

        publicdecimal JyPayMoney;           //基药补偿费用

        //11类费用信息-----------------------------------------------------------------

        publicdecimal XMedMoney;            //西药费用           1   药品

        publicdecimal ZMedMoney;            //中药费用           2   药品

        publicdecimal ZelMoney;         //诊疗费用           3   诊疗

        publicdecimal JcMoney;              //检查费用           4   诊疗

        publicdecimal HyMoney;              //化验费用           5   诊疗

        publicdecimal ZlMoney;              //治疗费用           6   诊疗

        publicdecimal SsMoney;              //手术费用           7   诊疗

        publicdecimal CwMoney;              //床位费用           8   诊疗

        publicdecimal HlMoney;              //护理费用           9   诊疗

        publicdecimal QtMoney;              //其他费用           10  诊疗

        publicdecimal ClMoney;              //材料费用           11  耗材

        //11类全自付(报销比例为0的项)_费用信息------------------------------------------

        publicdecimal Qzf_XMedMoney;        //全自付_西药费用    1   药品

        publicdecimal Qzf_ZMedMoney;        //全自付_中药费用    2   药品

        publicdecimal Qzf_ZelMoney;     //全自付_诊疗费用    3   诊疗

        publicdecimal Qzf_JcMoney;          //全自付_检查费用    4   诊疗

        publicdecimal Qzf_HyMoney;          //全自付_化验费用    5   诊疗

        publicdecimal Qzf_ZlMoney;          //全自付_治疗费用    6   诊疗

        publicdecimal Qzf_SsMoney;          //全自付_手术费用    7   诊疗

        publicdecimal Qzf_CwMoney;          //全自付_床位费用    8   诊疗

        publicdecimal Qzf_HlMoney;          //全自付_护理费用    9   诊疗

        publicdecimal Qzf_QtMoney;          //全自付_其他费用    10  诊疗

        publicdecimal Qzf_ClMoney;          //全自付_材料费用    11  耗材

    }

7.8     PayInfo

    publicclassPayInfo

    {

        ///<summary>

        ///总费用:所有上传的有效清单(未撤销)费用合计,既:ItemDetail.SumMoney的合计。

        ///</summary>

        publicdecimal Zfy;

 

        ///<summary>

        ///新农合补偿费用

        ///</summary>

        publicdecimal XnhBxfy;

 

        ///<summary>

        ///自付费用(病人支付费用)

        ///</summary>

        publicdecimal Zffy;

 

        ///<summary>

        ///计算说明,详细说明实际报销费用是怎样计算得来

        ///</summary>

        publicstring CalcDescription;

 

        ///<summary>

        ///报销方式(普通、重大疾病、单病种、特殊政策、特殊疾病)

        ///</summary>

        publicstring BxType;

 

///<summary>

///可报销费用

///</summary>

publicdecimal Kbxfy;

 

///<summary>

///封顶线

///</summary>

publicdecimal Fdx;

 

///<summary>

///报销比例

///</summary>

publicdecimal BL;

 

///<summary>

///起付线

///</summary>

publicdecimal Qfx;

///<summary>

///本地累计(纳入封顶线计算的)报销费用

///</summary>

publicdecimal Bdljbxfy;

 

///<summary>

///异地地累计(纳入封顶线计算的)报销费用

///</summary>

publicdecimal Ydljbxfy;

}

注意:某些特殊补偿方式下, 新农合补偿费用 + 自付费用 不一定等于总费用

例如:

【定额补偿方式】假设总费用 24000, 新农合定额20000,补偿标准75%

       新农合补偿费用 = 20000 ×75% = 15000

       病人自付费用 = 20000 ×25% = 5000

       既: (15000 + 5000) != 24000

7.9     PayList

publicclassPayList

    {

        ///<summary>

        ///创建时间

        ///</summary>

        publicDateTime CreateTime;

 

        ///<summary>

        ///文件数据

        ///</summary>

        publicbyte[] FileData;

 

        ///<summary>

        ///数据类型(如:PDFEXCEL)当前是EXCEL

        ///</summary>

        publicstring DataType;

       

        ///<summary>

        ///数据文件扩展名(如.pdf .xls等)当前是.xls

        ///</summary>

        publicstring FileExt;

 

        ///<summary>

        ///备注

        ///</summary>

        publicstring Remark;

    }

7.10         PayVoucher

publicclassPayVoucher

    {

        ///<summary>

        ///新农合住院ID

        ///</summary>

        publicstring XnhZyID;

 

        ///<summary>

        ///经办人

        ///</summary>

        publicstring ProcessMan;

 

        ///<summary>

        ///创建时间

        ///</summary>

        publicDateTime CreateTime;

 

        ///<summary>

        ///文件数据

        ///</summary>

        publicbyte[] FileData;

 

        ///<summary>

        ///数据类型(如:PDFEXCEL)当前是PDF

        ///</summary>

        publicstring DataType;

 

        ///<summary>

        ///数据文件扩展名(如.pdf .xls等)当前是.pdf

        ///</summary>

        publicstring FileExt;

 

        ///<summary>

        ///备注

        ///</summary>

        publicstring Remark;

    }

7.11         PersonInfo

    ///<summary>

    ///个人信息

    ///</summary>

    publicclassPersonInfo

    {

        publicstring ID;                //新农合居民省平台唯一标识

        publicstring Name;              //姓名

        publicstring Sex;               //性别

        publicDateTime Birthday;        //出生日期

        publicstring CardCode;          //农合号

        publicstring IDCard;            //身份证号

        publicstring Addr;              //地址

        publicstring XnhCHInfo;     //新农合参合情况(正常/死亡/退合/下一年新参合,正常才允许办理入院)

        publicstring FamilyRelation;    //家庭关系

publicstring DataFrom;          //数据来源:1区县农合数据库,2省中心数据库

    }

7.12         QdClassFee

    publicclassQdClassFee

    {

        publicstring ClassCode;//分类代码

        publicstring ClassName;//分类名称

        publicdecimal TotalFee;//分类总费用

        publicdecimal QzfFee;//分类自付费用

    }

7.13         SIRequest

    ///<summary>

    ///重大疾病申请/审批/撤销

    ///</summary>

    publicclassSIRequest

    {

        publicstring    XnhZyID;        //新农合住院ID

        publicstring    SiCode;     //重大疾病编码

        publicstring    BcLevel;        //申请补偿标准 1 省级定点救治医院 2 二级医院 3 三级医院

        publicint       Status;     //重大疾病申请状态:0 待审批 1 审批通过 2 审批不通过

        publicstring    RequestDoctor;      //申请医生姓名  

        publicstring    RequestDescription; //申请说明

        publicDateTime  RequestTime;            //申请时间  

        publicstring    AuditDoctor;            //审批人姓名

        publicstring    AuditDescription;   //审批说明

        publicDateTime? AuditTime;          //审批时间  

        publicstring    CancelStatus;       //撤销状态: 0正常 1撤销

        publicstring    CancelDoctor;       //撤销医生姓名

        publicstring    CancelDescription;  //撤销说明  

        publicDateTime? CancelTime;         //撤销时间

    }

当前政策,仅二级、三级和省级定点救治医院才能报销重大疾病。

7.14         XnhCodeTableItem

    ///<summary>

    ///新农合码表项

    ///</summary>

    publicclassXnhCodeTableItem

    {

        publicstring Name;          //码表项名称

        publicstring NamePY;        //码表项名称拼音简码

        publicstring Code;          //码表项编码

        publicstring Description;   //说明

        publicstringItemType;       //码表项类别

    }

7.15         XnhResult

    ///<summary>

    ///新农合通用接口返回数据类型

    ///</summary>

    publicclassXnhResult

    {

        publicbool Result;

        publicstring Msg;

    }

7.16         ZhenLiaoMap

///<summary>

    ///新旧物价编码映射。(用于辅助对码)

    ///</summary>

    publicclassZhenLiaoMap

    {

        [DataField("NAME")]publicstring Name;           //新编码名称

        [DataField("CODE")]publicstring Code;           //新编码代码

        [DataField("NAME_OLD")]publicstring OldName;    //旧编码

        [DataField("CODE_OLD")]publicstring OldCode;    //旧编码代码

    }

7.17         ZyInfo

///<summary>

    ///新农合住院信息

    ///</summary>

    publicclassZyInfo

    {

        publicstring xnhZyID;               //新农合住院唯一标识(36byte)

//住院状态: 

//  已入院                  1

        //  已出院                  2

        //  已结算                  4

        //  已打印了补偿凭证         8

        //  已打印了垫付资金申请表        16

        //  已完成审批               32

        publicint? ZyStatus;   

//撤销结算申请状态:

// -1 没有有效申请信息,

// 0 待审,

// 1 同意,

// 2 拒绝

        publicint? CancelPayStatus;        

        publicstring CountyName;            //患者参合区县名称

        publicstring PersonID;              //新农合居民省平台唯一标识

        publicstring Name;                  //患者姓名

        publicstring CardCode;              //患者农合号

        publicstring IDCard;                //患者身份证

        publicstring Tel;                   //患者联系电话

        publicstring InDoctorName;          //入院主治医生姓名

        publicstring HosName;               //就诊医院名称

        publicstring HisID;                 //His住院ID

        publicDateTime InHosTime;           //入院时间

        publicstring InHosDiagnose;         //入院诊断

        publicstring InHosICD;              //入院诊断ICD编码

        publicstring InHosDetp;             //入院科室

        publicstring OutDoctorName;         //出院主治医生姓名

        publicDateTime? OutHosTime;         //出院时间

        publicstring OutHosDiagnose;        //出院诊断

        publicstring OutHosICD;             //出院诊断ICD编码

        publicstring OutHosDetp;            //出院科室

        publicstring Result;                //治疗结果

        publicstring Invoice;               //发票号

        publicstring ProcessMan;            //结算人姓名

        publicDateTime? PayTime;            //结算时间

        publicdecimal? TotalMoney;          //总费用

        publicdecimal? KbxMoney;            //可报销费用

        publicdecimal? BxMoney;             //实际报销费用

        publicstring CalcDescription;       //计算说明,详细说明实际报销费用是怎样计算得来

        publicint? ApproveState;            //审批状态: 1完成,0未完成

        publicdecimal? ApprovePrice;        //审批费用

        publicint? ApproveDays;             //审批住院天数

        publicstring ApproverName;          //审批人姓名

        publicDateTime? ApproveTime;        //审批时间

        publicstring ApproveDescription;    //审批(金额变动)说明

    }

7.18         ZzBillInfo

    ///<summary>

///跨省转诊单

///</summary>

publicclassZzBillInfo

    {

        [DataField]   publicstring N507_05;      //转诊单号

        [DataField]   publicstring D507_01;      //个人代码

        [DataField]   publicstring D507_02;      //患者姓名

        [DataField]   publicstring D507_08;      //转入医院1代码

        [DataField]   publicstring N507_08;      //转入医院1名称

[DataField]   publicDateTime? D507_10;    //审核时间

        [DataField]   publicstring N507_01;      //参合区(县)地区代码

        [DataField]   publicstring N507_11;      //参合区(县)地区名称

        [DataField]   publicstring N507_13;      //身份证号

        [DataField]   publicstring N507_15;      //医疗证/卡号

        [DataField]   publicstring N507_18;      //性别代码

        [DataField]   publicstring N507_19;      //性别名称

[DataField]   publicDateTime? N507_23;    //出生日期

        [DataField]   publicstring N507_26;      //患者联系人

        [DataField]   publicstring N507_27;      //患者联系电话

        [DataField]   publicstring N507_30;      //家庭代码

        [DataField]   publicstring N507_31;      //转入医院2代码

        [DataField]   publicstring N507_32;      //转入医院2名称

        [DataField]   publicstring N507_33;      //转入医院3代码

        [DataField]   publicstring N507_34;      //转入医院3名称

[DataField]   publicint? N507_35;         //累计金额(元)

        [DataField]   publicstring N507_36;      //账户名称


收藏   打印   关闭  
上一篇:
下一篇:
更多
最新动态
医院概况 | 新闻动态 | 专家坐诊 | 联系我们 | 院务公告 | 医院招聘
Copyright © 2006-2024 自贡市第一人民医院版权所有 备案号:蜀ICP备14003336号-1
地址:四川省自贡市尚义灏一支路42号 电话:0813-2100694(院办公室) 0813-2100427(人事科) 预约挂号电话:0813-2121048 0813-2121067 技术支持:四川百信智创科技有限公司