《京市预约挂号服务平台数据接口规范》由会员分享，可在线阅读，更多相关《京市预约挂号服务平台数据接口规范（114页珍藏版）》请在金锄头文库上搜索。
1、内部资料，注意保密文件编号：WSXX2012002文件版次：WSXX2012002-001文档编号：YY2012-001版本号：1.0发布日期：2012-5-16南京市预约挂号服务平台数据接口规范南京市卫生信息中心技术支持：江苏捷士达高校科技开发有限责任公司目 录1.引言11.1.文档编制目的11.2.背景12.预约挂号平台总体架构23.预约挂号流程33.1.预约挂号总体流程33.2.预约挂号流程33.3.预约取号流程53.4.在线退号流程63.5.医院现场预约挂号退号流程63.6.违约自动退款流程74.详细接口定义（是否考虑参数不下发，只提供方法名称）74.1.第三方适用接口74.1.1.初
2、始化74.1.2.医院查询84.1.3.科室查询94.1.4.医生查询114.1.5.号表查询154.1.6.患者查询274.1.7.预约下单404.1.8.预约查询444.1.9.预约取消464.1.10.患者登陆认证464.1.11.患者预约历史查询474.1.12.获取接口版本号534.1.13.验证用户是否存在544.1.14.根据市民卡号获取用户信息544.1.15.获取系统配置参数554.1.16.获取医院图片的XML信息564.1.17.获取医院科室的一周排班信息564.1.18.获取医院当天预约状态的人数574.1.19.修改个人信息584.1.20.修改个人密码604.1.2
3、1.根据账号名获取用户详细信息604.1.22.获取医院科室的一周排班信息（包括该专科下的专家信息）624.2.医院HIS适用接口634.2.1.数据交换接口版本查询：634.2.2.门诊诊疗科目排班管理接口定义：634.2.3.患者预约验证接口定义：654.2.4.患者预约确认接口定义：704.2.5.科室表上传接口定义：724.2.6.医生表上传接口定义：734.2.7.科室预约情况查询754.2.8.专家预约情况查询：844.2.9.医院取消患者预约接口：934.2.10.医院获取患者就诊卡号相关信息接口：944.2.11.错误返回接口964.3.银联对账适用接口964.3.1.查询指定
4、日期医院确认数据964.3.2.预约挂号对账接口（查询指定日期患者取消预约信息）984.3.3.预约挂号对账接口（查询指定日期患者违约信息）994.4.省集约式预约诊疗服务平台对接说明1014.4.1.初始化1014.4.2.医院查询1014.4.3.科室查询1014.4.4.医生查询1024.4.5.号表查询1034.4.6.患者查询1054.4.7.预约下单1064.4.8.预约查询1074.4.9.预约取消1074.4.10.患者登陆认证1074.4.11.患者预约历史查询1084.4.12.获取接口版本号1094.4.13.验证用户是否存在1094.4.14.根据市民卡号获取用户信息1
5、094.4.15.获取系统配置参数1094.4.16.获取医院图片的XML信息1094.4.17.获取医院科室的一周排班信息1094.4.18.获取医院当天预约状态的人数1104.4.19.修改个人信息1104.4.20.修改个人密码1104.4.21.根据账号名获取用户详细信息1104.4.22.获取医院科室的一周排班信息（包括该专科下的专家信息）110南京市预约挂号服务平台数据接口规范1. 引言1.1. 文档编制目的本规范主要表述了南京市预约挂号平台设计方案，内容包含预约挂号流程描述、医院方接口、支付接口、第三方接口等。本报告的阅读对象包括软件开发人员、软件设计人员、软件实施人员以及与该项
6、目相关的其他人员等。1.2. 背景江苏省卫生厅下发了关于建设江苏省集约式预约诊疗服务平台推进预约诊疗服务工作的意见，要求2012年6月之前，建立统一、高效，集预约和管理于一体的“江苏省集约式预约诊疗服务平台”，向全省乃至全国公众提供更加方便、快捷的预约诊疗服务。南京市预约诊疗服务平台集中整合了南京市区域内各级医疗服务机构的门诊诊疗挂号资源，为广大患者提供便捷的基于互联网络的预约诊疗服务，南京市辖区内的医院采用属地化管理的方式，所有医院统一接入南京市预约挂号服务平台。通过平台的建设，将建立一个更加方便群众就医、以病人为中心的好的服务系统。平台搭建了一个沟通患者、医院和卫生管理部门的渠道，同时也为
7、全省服务平台提供服务链接。2. 预约挂号平台总体架构预约挂号平台主体由三部分功能构成，包括公众预约挂号功能、医院管理功能、卫生局管理功能。通过公众预约挂号功能，公众能够通过12320网站进行预约挂号；通过医院管理功能，一方面让医院可以维护本院的科室、医生、排班信息，另外还可以对预约本院的患者预约信息进行管理；通过卫生局管理功能，卫生局可以管理所有接入的医院，还可以对预约信息进行监控。为了方便患者，通过提供第三方预约通道服务，使患者通过银行自动柜员机，iTV，手机自助端等方式进行预约挂号。为了方便医院HIS系统与预约挂号平台的对接，提供医院通道，并在医院部署前置，让HIS系统通过调用预约挂号HI
8、S接口（DLL）与预约挂号平台进行对接。为了实现预约挂号的银联支付功能，银联提供了支付接口供预约挂号平台来调用。3. 预约挂号流程3.1. 预约挂号总体流程预约挂号总体流程如下图所示：南京市预约挂号平台预约挂号总体流程可以分为两部分：预约挂号和预约取号。u 预约挂号患者可以通过12320网站、拨打12320电话、银行自动柜员机、iTV、手机自助端等方式进行预约挂号。u 现场取号患者预约成功后，在规定时间到指定医院的预约挂号服务台，出示证件及验证码，进行预约取号。3.2. 预约挂号流程预约挂号流程图如下图所示：不管通过哪种途径进行预约挂号，都需要患者已经在预约挂号平台进行过注册。如果没有注册，则
9、必须先进行注册。患者可以在12320网站上自己注册。患者登录成功后，经过选择医院、选择专家/转科、选择预约时间，确认预约信息，即可完成预约挂号。如果选择银联支付或者必须银联支付，则会转到银联支付的界面要求输入银行账号信息。预约成功后会返回预约信息及验证码，患者凭注册登记的证件及验证码，即可在规定时间到指定医院进行预约取号。预约挂号的银联支付目前只支持在12320网站上由患者自己操作完成。3.3. 预约取号流程预约取号流程图如下图所示：患者在规定时间到指定医院的预约挂号窗口或服务台，出示证件及预约挂号验证码，服务台的工作人员会对证件及验证码进行确认。确认通过后，要求患者出示市民卡，如果没有，则要
10、求先办理市民卡。如果患者预约时已经支付了挂号费，则直接挂号并打印挂号单给患者，如果患者预约挂号时没有支付挂号费，则要求患者支付挂号费，然后进行挂号并打印挂号单给患者，患者凭挂号单进行后续就诊。3.4. 在线退号流程在线退号流程图如下图所示：患者预约挂号后，在规定的时间内，可以通过多种途径进行退号。通过12320网站进行退号的步骤是：患者登录12320网站后，选择预约挂号的记录，然后选择退号，确认后，即完成退号。如果患者预约挂号时已经支付挂号费，则系统将挂号费退回到患者原支付账户中。如果患者在规定的时间内没有进行退号，又没有到医院取号，则构成违约。3.5. 医院现场预约挂号退号流程医院现场预约挂
11、号退号流程如下图所示：患者在预约取号拿到挂号单后，如果想退号，则可以到挂号窗口，出示挂号单，要求退号，挂号员收回挂号单并退回相应的挂号费用。至此患者完成预约挂号的退号流程。3.6. 违约自动退款流程如果患者预约挂号并且已经支付了费用，但是没有在规定的时间内退号，又没有导医院取号，则构成违约。系统会在预约当天指定的时间点（银联结账时间点之前）将费用返还到患者原支付账户上。4. 详细接口定义（是否考虑参数不下发，只提供方法名称）4.1. 第三方适用接口4.1.1. 初始化名称：Init说明： 接口初始化，返回为True则表示服务运行正常，可以开始调用其他业务接口；False则表示初始化服务失败，暂
12、时无法进行调用其他业务接口。函数名Init() AS Boolean输入参数无返回值True 成功 ;False 失败4.1.2. 医院查询4.1.2.1. 获得所有已登录的医院信息名称：GetAllHospital 说明：获得所有已登录的医院信息。返回XML格式字符串，包括医院编码，医院名称。函数名GetAllHospital() AS String输入参数无返回值XML 格式字符串返回XML字段描述：编号数据项类型说明1HospitalCodeChar医院代码2HospitalNameChar医院名称XML 格式定义为： 32175000江苏省人民医院 3204000 南京市脑科医院 4.1.2.2. 获得所有已登录的医院信息（包括支付设置）名称：GetAllHospital2说明：获得所有已登录的医院信息。返回XML格式字符串，包括医院代码，医院名称，支付设置。函数名GetAllHospital2() AS String参数无返回值XML 格式字符串返回XML字段描述：编号数据项类型说明1HospitalCodeChar医院代码2HospitalNameChar医院名称3ForcePayChar预约支付标识：0 = 现场支付1 = 强制在线支付2 = 可选支付XML 格式定义为： 32175000 江苏省人民医院 0 3204000南京市脑科医院 0/ForcePay
