安徽新型农村合作医疗接口规范.docx
《安徽新型农村合作医疗接口规范.docx》由会员分享，可在线阅读，更多相关《安徽新型农村合作医疗接口规范.docx（188页珍藏版）》请在冰豆网上搜索。
安徽新型农村合作医疗接口规范
安徽新型农村合作医疗接口规范
参
考
手
册
V4.0
安徽省卫生厅
2013年04月
1.目的
为了更好的加快城市新型农村合作医疗建设，及与县内外各级农合合作医院平台的对接，对于新农合报销算法的准确性、可控性、可维护性和安全性等多方面的考虑，在对医院原有系统的改造的过程中，我们准备提供WebService以供访问来解决。
2．方案介绍
2．1流程图解
2．1．1匹配子流程图解
2．1．2门诊子流程图解
2．1．3住院子流程图解
注：
→表示流程走向，□表示业务操作，○表示操作后状态，补偿试算如何时候都可以执行，不会改变县平台状态
2．2医院需要做的修改
●首先医院需要根据新农合政策的需要，按照我们所提供的webservice改造医院的HIS系统，使其HIS系统能够适应新农合报销的需要。
●医院需要根据合管办提供的两个基本目录，包括病种信息、药品及诊疗项目信息建立与医院内码对应的对照信息，称为匹配。
●对于自费药品，可以匹配成保外费用。
●此标准跨操作系统,支持各种开发语言,如java、.Net、VB、Delphi、PB、C++、C等
3．医院管理信息系统改造实施详细说明
3．1疾病及药品匹配部分
●准备工作：
HIS应该添加农合疾病表，农合药品及诊疗项目表，疾病匹配表，药品及诊疗项目匹配表，具体字段请参照附表。
新增数据匹配管理以实现农合需求。
●其中农合疾病表和疾病匹配表为可选建表，如果HIS的疾病字典与农合的一致，可不需要这两个表。
●具体操作步骤：
数据匹配管理应先定点的县级平台下载农合相关数据并定时更新，再将HIS药品和诊疗项目表逐条匹配，可能会存在一条农合数据对多条HIS数据。
●匹配后将数据上传，必须审核后才能使用这些匹配信息。
●疾病不推荐匹配，如需匹配可另外提供相关函数。
●相关表格请参见5.1.1
●参照MatchUpdate、MatchSeek函数
3．1．1单条匹配药品数据上传函数
●单条匹配药品数据上传。
●参照MatchUpdate函数
3．1．2药品匹配数据审核状态查询
●查看药品匹配审核情况。
●参照MatchSeek函数
3．1．3下载（更新）疾病信息数据函数
●以最后更新时间下载疾病目录，。
●参照updateDisease函数
3．1．4下载（更新）药品及诊疗项目函数
●以最后更新时间下载药品及诊疗目录，。
●参照updateLeechdom函数
3．1．5分页下载疾病目录
●下载疾病目录。
●参照updateDiseaseByPage函数
3．1．6分页下载药品信息
●下载药品目录。
●参照updateLeechdomByPage函数
3．1．7药品诊疗分类字典下载
●下载药品目录。
●参照feeClassDown函数
3．2基础信息部分
3．2．1查询病人信息并保存
●准备工作：
HIS应该在门诊登记表中添加农合相关字段，具体字段参照附表（建议新建表）。
●具体操作步骤：
根据病人提供的合作医疗证号进行查询，选择一条病人数据后返回该病人的个人编号、姓名、性别、出生日期等相关信息，如果病人能找到，将相关信息保存到HIS相关表中。
否则定为非农合病人，不能进行农合操作。
●参照GetPersonInfo函数
3．2．2获取医疗机构信息函数
●获取县平台中医疗机构名单的相关信息。
●参照getHospitalInfo函数
3．2．3补偿类别字典下载
●下载县平台补偿类别的相关信息。
●参redeemTypeDownLoad函数
3．2．4科室信息下载
●下载县平台科室的相关信息。
●参照officeCodeDown函数
3．2．5治疗方式下载
●治疗方式下载服务,下载农合平台设置的治疗信息列表。
包括疾病限定关联信息。
●参照treatmentModeUpdate函数
3．3门诊部分
3．3．1查询病人信息并保存
●准备工作：
HIS应该在门诊登记表中添加农合相关字段，具体字段参照附表（建议新建表）。
●具体操作步骤：
根据病人提供的合作医疗证号进行查询，选择一条病人数据后返回该病人的个人编号、姓名、性别、出生日期等相关信息，如果病人能找到，将相关信息保存到HIS相关表中。
否则定为非农合病人，不能进行农合操作。
●参照GetPersonInfo函数
3．3．2传输门诊登记信息并保存农合门诊流水号
●提交个人编号进行门诊病人的就诊登记，并返回就诊号（农合唯一报销识别号）保存到相关表中，前提是能查询到此人的农合信息。
●门诊登记参照CliRegister函数
3．3．3门诊费用传输
●准备工作：
HIS应该在门诊费用表中添加状态字段，具体字段参照附表。
●费用序号ID（DEAIL_ID）是费用新增上传时农合网返回的值，是费用修改的唯一凭证。
●具体操作步骤：
进行门诊费用传输前必须保证已经传输了门诊登记信息。
在HIS系统产生费用时或发生费用后可进行费用传输。
如传输成功则将状态改为“已上传”，如果当时传输不成功，根据提示信息进行相关处理再传输。
●此操作可以依据当时网络状况即时或延时传输
●参照CliDetailInput函数。
3．3．4门诊费用取消
●传入门诊登记流水号，可取消本次门诊登记的所有明细信息。
●传入门诊明细登记号，取消门诊单条明细信息。
●参照cliCancelFee，cliSingleCancelFee函数
3．3．5家庭账户余额查询
●查询参合人员家庭帐户的余额
●参照cliSeek函数
3．3．6门诊费用试算
●费用传输完后，传入门诊就诊号进行门诊补偿费用试算。
返回相关信息。
●参照cliCalculate函数
3．3．7门诊结算
●费用传输完后，传入门诊就诊号进行门诊结算，生成门诊补偿单号。
是门诊兑付，取消结算等操作的唯一凭证。
●参照cliSettlement函数
3．3．8门诊取消结算
●根据门诊补偿单号取消门诊结算补偿单信息
●参照cliCancelSettlement函数
3．3．9门诊审核状态查询
●传入门诊补偿单号返回本次门诊的补偿单当前审核状态。
●参照cliAuditingSeek函数
3．3．10门诊兑付
●家庭账户余额查询后，传入门诊补偿单号和补偿金额可以进行兑付。
返回相关信息。
●参照CliBalance函数
3．3．11门诊冲红
●在进行门诊兑付后，传入门诊补偿单号可以进行门诊冲红。
返回相关信息。
●返回1表示冲红成功
●参照cliStrikeBalance函数
3．3．12门诊费用查询
●传入就诊号，费用明细序号，用于检查某笔费用是否已经上传。
●参照CliDetailSeek函数
3．3．13门诊修改,取消登记,转院登记
●门诊修改指没有进行结算时将登记信息进行修改.
●取消门诊登记可以冲消该病人本次在合管办中心的门诊登记。
只有在登记病人没有进行过门诊结算时才可以进行此操作。
●参照GetHospitalInfo、CliRegister函数
3．3．14判断门诊是否可以进行直接兑付
●根据传入的门诊补偿单号，判断本次补偿是否可以进行直接兑付
●返回0表示可直接兑付,1表示需审核
●参照isCashRedeem
3．3．15门诊登记（扩展函数）
●实现门诊登记功能实现（与原有接口函数cliRegister方法regType参数为1时实现功能相同），修改了部分参数，实现了对单病种门诊的登记
●参照clinicRegister
3．3．16门诊登记查询（扩展函数）
●参照clinicRegisterSeek
●根据所上传信息医院，病人农合个人编码，所属农合中心，门诊就诊号获取最后一次门诊登记信息
3．3．17取消门诊登记（扩展函数）
●参照cancelClinicRegister
●区县农合病人门诊登记信息包括对应明细信息（等同于原有接口cliRegister中参数regType为3时的功能）
3．3．18取消门诊登记（扩展函数）
●参照cancelClinicRegister
●区县农合病人门诊登记信息包括对应明细信息（等同于原有接口cliRegister中参数regType为3时的功能）
3．3．19门诊补偿核算（门诊补偿单生成）（扩展函数）
●参照createClinicCalculate（与原接口cliCalculate实现功能相同）
●费用传输完后，传入门诊就诊号进行门诊补偿费用试算。
返回相关信息。
3．3．20门诊补偿核算撤销（门诊补偿单撤销）（扩展函数）
●参照cancelCLinicRedeem
●撤销门诊补偿核算的操作，撤销成功后状态为门诊登记状态
3．3．21门诊兑付（扩展函数）
●参照ClinicPay
●对不需要审核的补偿信息进行直接兑付操作（与原有接口函数cliSettlement实现功能相同）
3．3．22门诊补偿冲红（取消兑付）（扩展函数）
●参照cancelClinicPay
●取消门诊兑付，取消门诊补偿兑付信息，并将门诊登记信息状态变为门诊登记状态（等同原有接口函数cliCancelSettlement的操作）
3．3．23门诊补偿试算（扩展函数）
●参照clinicCalculate
●门诊补偿试算，该功能可在门诊期间，至兑付前均可调用，但系统实际补偿不可以该函数返回结果为准。
3．3．24门诊补偿分级分段信息获取（扩展函数）
●获取门诊分段信息
●参照ClinicGradeList
3．3．24门诊分类信息获取（扩展函数）
●获取门诊分类信息
●参照ClinicFeeResult
3．3．25获取门诊登记和补偿信息（扩展函数）
●获取门诊登记和补偿信息
●参照getClinicInfo
3．4住院部分
3．4．1查询病人信息并保存
●参见3.3.1，只是在住院登记表中新增相关字段
●参照GetPersonInfo函数
3．4．2传输住院登记信息并保存农合住院流水号
●参见3.3.2，只是在住院登记表中处理。
●参照GetCenter、InpRegister函数
3．4．3住院费用传输
●参见3.3.3，只在住院明细表中处理
●住院费用传输时可增加住院费用预结算功能，即将现有上传的费用进行一次计算，并不影响农合数据库，并将相关信息返回。
参照Calculate函数
●参照InpDetailInput函数
3．4．4住院费用查询
●参见3.3.12
●参照InpDetailSeek函数
3．4．5住院费用试算
●费用传输完毕后，传入就诊号可以进行住院费用试算。
●参照Calculate函数
3．4．6取消传送
●将已上传，但未结算的数据一次性清空，
●参照InpCancelFee、singleInpCancelFee函数
3．4．7出院登记
●费用试算完毕，就进行出院登记，系统返回是否需要农合中心审核。
●参照InpRegister函数
3．4．8查询审核状态
●传入就诊号可以查询当前审核状态。
●参照AuditingSeek函数
3．4．9住院兑付
●如果出院登记时不需要审核，则可直接兑付，否则需查询审核通过才可兑付
●参照InpBalance函数
3．4．10住院退费
●进行冲消结算时如果病人已经出院则必须先进行取消出院登记。
●参照InpRegister函数
3．4．11取消出院登记
●如果已经进行了（3.4.7）出院登记后，要进行（3.3.10）住院退费，则必须进行此步骤。
●参照InpRegister函数
3．4．12住院修改,取消登记,转院登记
●参照GetHospitalInfo、InpRegister函数
3．4．13住院登记（扩展函数）
●参照inpatientRegister
●实现住院登记功能实现（与原有接口函数inpRegister方法opType参数为1时实现功能相同），修改了部分参数，实现了对单病种住院的登记
3．4．14住院登记查询（扩展函数）
●参照inpatientRegisterSeek
●根据所上传信息医院，病人农合个人编码，所属农合中心，医院住院号获取最后一次住院登记信息
3．4．14住院登记修改（扩展函数）
●参照inpatientUpdate
●修改农合病人住院登记信息（与原有接口函数inpRegister方法opType参数为2时实现功能相同）
3．4．15取消住院登记（扩展函数）
●参照cancelInpatientRegister
●区县农合病人住院登记信息包括对应明细信息（等同于原有接口inpRegister中参数opType为3时的功能）
3．4．16出院登记（扩展函数）
●参照leaveInpatientRegister
●农合病人出院登记（与原有接口函数inpRegister方法opType参数为4时实现功能相同）
3．4．17取消出院登记（扩展函数）
●参照cancelLeaveInpatientRegister
●取消出院登记，取消后住院登记信息为”在院”状态（等同原有接口函数inpRegister参数opType值为7的操作）
3．4．18住院补偿核算（住院补偿单生成）（扩展函数）
●参照creareInpatientRedeem（与原接口createRedeemInfo实现功能相同）
●根据补偿类型，通过调用后台政策算法，计算出本次应补偿金额，形成补偿单信息
3．4．19住院补偿核算撤销（住院补偿单撤销）（扩展函数）
●参照cancelInpatientRedeem
●撤销住院补偿核算的操作，撤销成功后状态为“出院”状态
3．4．20住院兑付（扩展函数）
●参照inpatientPay
●对不需要审核的补偿信息进行直接兑付操作（与原有接口函数inpPay实现功能相同）
3．4．21住院补偿冲红（取消兑付）（扩展函数）
●参照cancelInpatientPay
●取消住院兑付，取消住院补偿兑付信息，并将住院登记信息状态变为”已出院”状态（等同原有接口函数inpRegister参数opType值为8的操作）
3．4．22住院补偿试算（扩展函数）
●参照inpatientCalculate
●住院补偿试算，该功能可在住院期间，出院后直至兑付前均可调用，但系统实际补偿不可以该函数返回结果为准。
3．4．23住院补偿分级分段信息获取
●参照getInpatientGradeList
●获取住院补偿分段信息。
3．4．24住院批量费用明细录入函数（扩展函数）
●参照uploadInpatientDetails
●批量上传住院费用明细
3．4．25获取住院登记以及补偿信息（扩展函数）
●参照getInpatientInfo
●获取住院登记及补偿信息
3．5门诊结算统一申报
3．5．1目的
省级定点医疗机构与各区县新农合管理机构之间的补偿垫付款结算是新农合省级医疗机构即时结报工作的重要环节。
随着新农合省级医院即时结报工作的全面展开，建立便捷、高效的结算通道，是新农合信息化建设的一个重要任务。
为建立便捷、高效的结算通道，方便医疗机构用户和新农合管理机构用户进行垫付款结算操作，特制定新农合门诊结算申报接口，该接口适用于所有医疗机构，尤其是省市级医院，通过本接口即可完成医院与所有新农合区县平台的新农合门诊补偿垫付款结算申报。
3．5．2申报流程图
3．6住院结算统一申报
3．6．1目的
省级定点医疗机构与各区县新农合管理机构之间的补偿垫付款结算是新农合省级医疗机构即时结报工作的重要环节。
随着新农合省级医院即时结报工作的全面展开，建立便捷、高效的结算通道，是新农合信息化建设的一个重要任务。
为建立便捷、高效的结算通道，方便医疗机构用户和新农合管理机构用户进行垫付款结算操作，特制定新农合门诊结算申报接口，该接口适用于所有医疗机构，尤其是省市级医院，通过本接口即可完成医院与所有新农合区县平台的新农合门诊补偿垫付款结算申报。
3．6．2申报流程图
4．WebService调用说明
4．1调用说明
4．1．1WebService调用说明
●WebService地址联系本地合管办。
●WebService里面的入参中农合中心编码、医疗机构编码、经办人用户名请与合管办联系索取。
●出于数据安全性与通用性考虑，WebService的入参与出参均采用Base64编码，相关介绍请参见：
●如果入参错误，则抛出相关异常。
4．1．2入参说明
●为了方便调用，所有入参均为string类型，但是会要求不同的格式，如数字，日期，时间等，格式说明如下：
●数字格式：
必须是0-9的数字，可以带+号，-号，小数点.等符号字节，如无特别申明一般保留2位小数。
不能是表达式
日期格式：
必须是yyyy-MM-dd（年4位，月2位，日2位）
时间格式：
必须是yyyy-MM-ddhh:
mm:
ss（年4位，月、日、时、分、秒均2位）
字符格式：
指定长度的字符串。
●XML约定
1.接口上传数据如果设计到XML包，需组装为标准XML（包括xml头和xml数据包）格式字符串
2.除非有特殊说明，否则所有xml根元素都为。
3.Xml头字符编码必须指定为GBK编码（
xmlversion="1.0"encoding="GBK"?
>）
4．1．3返回值说明
●返回值由WebService指定
●如果标记为“无返回值，默认为成功，如果不成功则会抛出异常”，则不会返回结果
●如果标记（只返回一个String类型的值），则只返回一个字符串，否则会返回WebService指定的对象。
4．2函数功能说明
4．2．1函数列表
序号
函数名
代码
1
匹配药品数据上传函数
matchUpdate
2
药品匹配数据审核状态查询
matchSeek
3
下载（更新）疾病信息数据函数
updateDisease
4
下载（更新）药品及诊疗项目函数
updateLeechdom
5
获取病人信息函数
getPersonInfo
6
获取医疗机构信息函数
getHospitalInfo
7
补偿类别字典下载
redeemTypeDownLoad
8
科室信息下载
officeCodeDown
9
治疗方式下载
treatmentModeUpdate
10
门诊就诊登记函数
clinicRegister
11
门诊费用明细录入函数
cliDetailInput
12
门诊费用查询函数
cliDetailSeek
13
门诊所有明细取消函数
cliCancelFee
14
门诊单条明细取消函数
cliSingleCancleFee
15
门诊家庭帐户余额查询
cliSeek
16
门诊登记修改
clinicUpdate
17
取消门诊登记
cancelClinicRegister
18
门诊补偿试算
clinicCalculate
19
门诊补偿核算（门诊补偿单生成）
createClinicCalculate
20
门诊补偿核算撤销（门诊补偿单撤销）
cancelCLinicRedeem
21
门诊审核状态查询
cliAuditingSeek
22
门诊兑付
clinicPay
23
门诊补偿冲红（取消兑付）
cancelClinicPay
24
门诊判断本次补偿是否能进行直接兑付
isCashRedeem
25
门诊补偿分级分段信息获取
ClinicGradeList
26
住院就诊登记函数
inpatientRegister
27
住院登记查询
inpatientRegisterSeek
28
住院单条费用明细录入函数
inpDetailInput
29
住院批量费用明细录入函数
uploadInpatientDetails
30
住院费用查询函数
inpDetailSeek
31
住院所有明细取消函数
inpCancelFee
32
住院单条取消传送函数
inpSingleCancelFee
33
住院登记修改
inpatientUpdate
34
取消住院登记
cancelInpatientRegister
35
出院登记
leaveInpatientRegister
36
取消出院登记
cancelLeaveInpatientRegister
37
住院补偿试算
inpatientCalculate
38
住院补偿核算（住院补偿单生成）
creareInpatientRedeem
39
住院补偿核算撤销（住院补偿单撤销）
cancelInpatientRedeem
40
住院审核状态查询
auditingSeek
41
住院兑付
inpatientPay
42
住院补偿冲红（取消兑付）
cancelInpatientPay
43
获取住院登记以及补偿信息
getInpatientInfo
44
住院补偿分级分段信息获取
getInpatientGradeList
45
获取本机构门诊未申报补偿垫付数据
getClinicUnApplyRedeemData
46
申报本机构门诊补偿垫付数据
applyClinicRedeemData
47
已结算门诊信息查询
settleClinicRedeemInquiry
48
已申报门诊数据处理结果查询
applyClinicStatusInquiry
49
获取本机构未申报住院补偿垫付数据
getUnApplyRedeemData
50
申报本机构住院补偿垫付数据
applyRedeemData
51
已结算住院信息查询
settleRedeemInquiry
52
已申报住院数据处理结果查询
applyStatusInquiry
53
总额预算信息查询
budgetAmountInquiry
4．2．2疾病及药品匹配部分
4．2．2．1匹配药品数据上传函数matchUpdate
●入参：
参数
类型
参数名
是否可空
说明
centerNo
12字节
农合中心编码
N
hospitalSysno
24字节
医疗机构编码
N
code
24字节
农合编码
N
hisCode
40字节
HIS编码
N
hisName
100字节
HIS药品名称
N
hisSpec
200字节
HIS药品规格
N
如无规格，请上传”无”
hisUnit
100字节
HIS药品单位
N
hisConf
100字节
HIS药品剂型
N
hisPrice
升级会员 