闵行区孕产妇及儿童检查减免系统接口规范1.2.docx

孕产妇及儿童检查减免系统接口规【枷蛔接口规范33334445888«2727272727282831332规范使用对象第三方软件实现接口的前提嵌入式接口软件简要说明.版权声明第一部分嵌入式接口软件流程一数据流程二业务流程第二部分DLL调用说明一功能说明二服务功能列表三XML实体或XML数据样本定义四调用服务方法及使用第三部分参考资料11 'Lj''I1第四部分配置手册一医院前置机配置：二HIS客户机配置第五部分数据代码规范S201-01科室代码S201-02医疗机构级别代码S201-03乡镇名称S201-03医院代码引言一前言闵行区孕产妇及儿童检查减免系统接口规范是杭州创业软件股份有限公司根据闵行区卫生局规定的要求编写而成，用于辅助第三方医院管理信息系统开发商修改现有软件，顺利实现与闵行区孕产妇及儿童检查减免系统进行联网运行，此方案交闵行区卫生局确认后实施。二规范使用对象 闵行区卫生局及其他相关科室 医疗机构 第三方软件开发商及其技术人员 与接口开发实施工作相关的技术人员三第三方软件实现接口的前提 第三方软件必须提供真实有效的数据信息 拥有足够的技术实力正常调用服务功能四嵌入式接口软件简要说明1 .运行环境 工作站操作系统：WIN2000及以上版本 前置机操作系统：WIN2000及以上版本或Unix2 .功能及构成简要说明接口软件分为两部分：接口 DLL程序、妇幼减免软件服务程序。接口 DLL程序：接口 DLL程序，主要是为第三方软件提供通讯服务，调用该DLL函数后将返回状态值。妇幼减免服务程序妇幼减免服务程序主要用于各种交易的转发，并处理医院前置机的数据，实现上传下载数据功能，确保与妇幼减免中心数据库进行数据交换。五版权声明闵行区孕产妇及儿童检查减免系统接口规范及提供的服务程序（包括所有动态链接库）仅限于第三方软件开发商内部参考使用，任何情况下都不能以任何方式公开、告知其他任何个人或组织。第一部分嵌入式接口软件流程数据流程1、流程图转发数据 <1e,1*1中心数据政策算法IOK 鹏深渊锌1曲丽,独网中心前置机中心前置机返回数据发送数据J 日返回数据巨曰1发送数据至DLLA调用一返回数据医院前置机医院前置机HUl®医院工作站2、数据流程说明1）发起交易信息:医院管理信息系统根据自身的业务并按照一定的数据包格式调用DLL动态库，DLL动态库根据参数设置并向设定的前置机的端口发送数据包。2）医院前置机监视：医院前置机的服务程序开启后会自动监测设定的端口，一旦收到消息,服务程序将收到的数据包进行解包并根据不同的定义响应不同的处理事件，服务程序通过与数据中心进行数据交换获得处理结果，并返回结果给发起交易信息的用户。二业务流程1、医院业务流程图2、业务流程说明医院管理信息系统读卡后，将得到的健康卡号及相关交易所需信息按照本规范规定的格式打包，通过调用DLL动态库将打包的数据发送到医院前置机，医院前置机收到数据包后会根据收到的数据包的意义进行相应的业务处理并返回结果给医院管理信息系统，医院管理信息系统再根据返回的结果进行相关的医院业务操作。三调用流程图HIS系统调用接口的主要流程图主流程:检查登记CheckGrzh 和Mzdj输入减免检查项目 Getlmje费用登记UploadFyxx<>费用试算FybxYjs检查目录对照流程:下载减免的检查目录 GetJcxm进行对照处理上传对照后的检查目录UploadDzml中心审核对照情况下载已审核后对照检查目录GetDzmla） HIS系统建议添加病人性质：孕产妇减免和儿童保健减免；在选择病人性质为孕产妇减免或儿童保健减免，需要调用服务CheckGrzh进行减免对象的审核验证。调用该服务后，可获取孕产妇或儿童信息（得到孕产妇编号或儿童编号）孕产妇编号或儿童编号用于下面的服务调用。b） HIS系统先调用功能号为Mzdj的服务进行检查登记，调用该服务可得到登记号。c） HIS系统在输入检查项目时需要调用功能号为：Getjmje的服务，得到该项费用是否可以减免。d）调用功能号为UploadFyxx的服务，进行费用信息的上传。e）在收费时，需要调用功能号为FybxYjs的服务，进行费用试算。f）在收费时，需要调用功能号为Fybxjs的服务，进行费用结算。第二部分DLL调用说明一功能说明新农合接口 DLL名称为HCN.dll,通过调用DLL,可以向服务端发送妇幼减免规定的交易，并可根据返回的结果进行相应的业务处理。二服务功能列表序功能说明服务编号1减免对象的审核验证CheckGrzh2孕产妇卡信息上传Yfxx_Upload3孕产妇检查信息上传Yfjc_Upload4儿童保健卡信息上传Etxx_Upload5儿童保健服务信息上传Etjc_Upload6检查登记Mzdj7费用登记或取消费用记录UploadFyxx8费用预结算FybxYjs9费用结算FybxJs10退费处理ReSaveJmbx11获取检查费用是否减免GetJmje12对账（总账及明细下载）Jmdzmx13对帐结果上传DzXxSc14下载检查目录GetJcxm15上传对照后的检查目录UploadDzml16下载已审核后对照检查目录GetDzml17上传减免明细信息UploadJmxx提示：上述黑体显示的功能号为闵行区二级医院做的接口功能.> XML结构字符串中的一指的是：省略号（一）上面的节点可能有多个兄弟节点。> 时间类型的格式：1998-01-01,时间类型必须使用该格式。1 .减免对象的审核验证有效功能号：CheckGrzh功能描述：验证是否符合减免对象，如有效，可获取孕产妇或儿童信息,调用说明：如果是孕产妇对象，在返回的个人信息中包含孕周信息。序号入参入参说明长度可空类型1OPERATOR当前操作员ID10N字符2JKKH健康卡号20N字符3BRXZ病人性质代码（1孕产妇减免2儿童保健减免）2N字符4YYBH医院编号（S201-03医院代码）20N字符返回结果定义:序号出参出参说明长度可空类型1CODE状态码：3N数值2MSG返回消息100Y字符3<PATIENT>个人信息NXML数据出参CODE的值如下1正常状态允许减免-1列入止付名单不允许减免2 .孕产妇卡信息上传功能号： Yfxx_Upload功能描述：上传孕产妇基本信息。调用说明：上传社区卫生服务中心经过审核符合减免的孕产妇基本信息数据。允许对中心数据进行增加，修改或注销操作。入参定义:序号入参入参说明长度可空类型1OPERATOR操作员10N字符2CZLX操作类型代码：（A增加，M修改,D注销）1N字符3XM姓名20N字符4ZZJMSJ终止减免时间N时间格式YYYY-M5YYBH医院编号（S201-03医院代码）10N字符6JKKH健康卡号30N字符7YCFBII孕产妇编号30N字符8CSRQ出生日期N时间格式YYYY-MM-DD9SFZH身份证号18N字符10HJLX户籍类型代码（1本市、2外地、3外地常住、4外地流动）1N字符11JKRQ建卡日期N时间格式YYYY-MM-DD12JKYZ建卡孕周30N时间格式YYYY-MM-DD13JKJD建卡街道名称20N字符14JKR建卡人30N字符15MCYJ末次月经N时间格式YYYY-MM-DD16YCQ预产期Y时间格式YYYY-MM-DD17HKDZ户口住址150Y字符18JTDZ家庭住址150Y字符19SZQ所在区名称20Y字符（中文文字描述）20SZXZ所在乡镇名称（S201-03乡镇名称）20Y字符（中文文字描述）21SZJW所在居委20Y字符（中文文字描述）22LXDH联系电话20Y字符23LXSJ联系手机20Y字符24ZFXM丈夫姓名20Y字符25ZFSFZ丈夫身份证18Y字符27SYBX生育保险代码（1参加0不参加）1Y数值28HJQK婚检情况代码（1在闵行区婚检2非闵行区婚检3未婚检）30Y字符29HJRQ婚检日期20Y时间格式YYYY-MM-DD30HJJG婚检机构60Y字符31SFZSM身份证扫描500Y字符33JZZSM居住证扫描500Y字符34CJJMDSQ出具减免单社区代码（S201-03医院代码）50N字符35ZRYS责任医生（名称）30Y字符36CZRQ初诊日期（首次产后检查日期）N时间格式YYYY-MM-DD37JARQ结案日期N时间格式YYYY-MM-DD38JABZ结案标志1Y字符39FMRQ分娩日期N时间格式YYYY-MM-DD40FMDW分娩单位20Y字符返回结果定义:序号出参出参说明长度可空类型1CODE状态码1上传成功-1上传失败3N数值2MSG返回消息100Y字符3 .孕产妇检查信息上传功能号：Yfjc.Upload功能描述：上传孕产妇早孕检查信息，产科医院检查信息，产后访视信息。调用说明：同一天同一个孕产妇只能上传