预约诊疗系统接口标准

预约诊疗系统接口标准

（试行版）

Version:4.0

编制：陈璐

审核：毛云鹏

日期:2015-7-17

文档修订历史纪录

日期版本说明编制审核

2013-04-09V1.0创建陈璐毛云鹏

2015-03-28V3.0增加了病床查询接口陈璐毛云鹏

2015-4-3V3.0增加转诊的病床查询、挂号接口陈璐毛云鹏

2015-7-17V4.0陈璐毛云鹏

目录

目录...............................................................2

1.接口概述.......................................................

2.接口定义........................................................2

3.1消息传输格式...............................................................2

3.2发送命令格式...............................................................3

3.3响应命令格式...............................................................4

3.4获取挂号科室...............................................................5

3.5获取挂号医生...............................................................6

3.6获取医生挂号级别信息.......................................................8

3.7获取普通排班信息...........................................................9

3.8新增患者信息..............................................................11

3.9预约挂号..................................................................12

3.10预约挂号确认（取号）.....................................................13

3.11预约挂号撤销（退号）.....................................................15

3.12获取挂号信息.............................................................16

3.13机构信息.................................................................17

3.14获取体检项目.............................................................20

3.15获取体检套餐.............................................................21

3.16新增体检预约.............................................................22

3.17当日排班信息.............................................................23

3.18当日挂号.................................................................24

3.19当日挂号确认（取号）.....................................................26

3.20当日挂号撤销（退号）.....................................................27

3.21获取医生挂号量信息.......................................................28

3.22检验结果查询.............................................................30

3.23医生咨询.................................................................33

3.24咨询查询.................................................................34

3.25门诊费用查询.............................................................35

3.26住院费用查询.............................................................38

3.27药品价格查询.............................................................40

3.28检查项价格查询...........................................................41

3.29检查结果查询.............................................................42

3.30叫号查询.................................................................45

3.31导医查询.................................................................46

3.32医嘱查询.................................................................48

3.33医院床位查询.............................................................49

3.34医院转诊床位查询.........................................................50

3.35面向公众即时号源信息.....................................................51

3.36面向医疗机构即时号源信息.................................................52

3.37获取网上诊疗排班信息.....................................................53

L接口概述

本接口是预约诊疗系统的接口标准的实现。

接口采用http标准的webservice和中间表方式实现接口功能，主要提供几个

方面功能：

＞挂号科室信息同步

＞挂号医生信息同步

＞医生排班信息同步

＞新增患者信息

＞预约挂号

＞预约挂号确认（取号）

＞预约挂号撤销（退号）

＞挂号记录查询

＞机构信息同步（可选）

＞预约体检同步

＞检验单查询

＞医生咨询

＞咨询查询

＞门诊费用查询

＞住院费用查询

＞药品价格查询

＞检验项价格查询

＞叫号查询

第1页共63页

2.接口定义

3.1消息传输格式

消息传输格式为XML规则字符串。

同时，为了传输格式的规范化，以及传输的高效率，我们定义简易的XML规则字

符串，此处对传输格式进行概念的说明：

简易XML规则字符串包含三个重要的定义，数据集、数据表、数据字段。

1、数据集：我们使用〈ADTECHX/ADTECH〉匹配对来定义数据集，每次消息

传输，只允许传一个数据集，也就是说在单次数据传输的过程中

<ADTECHX/ADTECH>匹配对只会出现一次；

2、数据表：我们使用〈数据表名>〈/数据表名〉匹配对来定义数据表（其中

“数据表名”表示要传的记录），每次消息传输允许传输多条记录；

3、数据字段：我们使用〈数据字段名〉〈/数据字段名〉匹配对来定义数据字

段（其中“数据字段名”表示要传的记录中的字段），每个数据表中不允许出现

不同的字段名。

例如，我们现在有个“数据表名”叫做“TABLE」”的表记录需要传输，包含了

三个字段分别是“COLUMN」”、“C0LUMN_2”、“COLUMN_3”，另有个“TABLE_2”

表记录，包含两个字段分别是“C0LUMN_4"、“COLUMN_5”。现在需要传输一条

“TABLE」”记录和两条“TABLE_2”记录，那么XML规则字符串的应该如下所示：

<ADTECH>

<TABLE_1>

〈COLUMN」〉值1</COLUMN_1>

〈COLUMN_2>值2</C0LUMN_2〉

<COLUMN_3><3</COLUMN_3>

</TABLE_l>

<TABLE_2>

<C0LUMN_4>值4</C0LUMN_4>

〈COLUMN_5>值5</COLUMN_5>

第2页共63页

</TABLE_2>

<TABLE2>

〈C0LUMN_4>值6</C0LUMN_4>

〈C0LUMN_5〉值7〈/C0LUMN_5〉

</TABLE_2>

</ADTECH>

3.2发送命令格式

发送命令形式的XML规则字符串，后者通过解析收到的XML规则字符串，执

行相应的命令以后，将结果返回给医院。

数据集内容：

数据表保留字说明

消息头<HEADERX/HEADER>包含命令和验证，单记录（由接口提供方规

定）

消息参数<HEADERX/HEADER>包含执行命令的参数，单记录

数据集格式:

<ADTECH>

<HEADER>

〈TRANSACT〉交易命令〈/TRANSACT〉

〈ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

〈参数名1>参数值1</参数名1>

〈参数名2>参数值2〈/参数名2>

〈参数名n〉参数值n〈/参数名n>

</INPARA>

第3页共63页

</ADTECH>

3.3响应命令格式

接收到发送过来的XML规则字符串，将命令解析，在验证正确的情况下,

执行交易命令，并将结果返回给第三方。

数据集内容：

数据表保留字说明

消息头<HEADERX/HEADER>包含命令和验证，单记录

消息参数<RESULTSX/RESULTS>包含执行交易命令后的传出参数，单记录

消息体〈结果表名X/结果表名〉包含执行命令的参数，多记录

数据集格式:

<ADTECH>

<HEADER>

〈TRANSACT〉交易命令〈/TRANSACT〉

〈ORG_CODE>医院代码</ORG_CODE〉

〈PASSWORD）交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>返回代码</RET_CODE>

<RET_INFO〉返回结果描述〈/RET_INFO〉

〈参数名1〉参数值1</参数名1>

〈参数名2>参数值2〈/参数名2>

〈参数名n〉参数值n〈/参数名n>

</RESULTS>

〈结果表名〉

〈字段名1>字段值1〈/字段名1>

〈字段名2>字段值2〈/字段名2>

第4页共63页

〈字段名n〉字段值n〈/字段名n>

〈/结果表名》

〈结果表名〉

〈字段名1>字段值1〈/字段名1>

〈字段名2>字段值2〈/字段名2>

〈字段名n>字段值n〈/字段名n>

〈/结果表名〉

</ADTECH>

3.4获取挂号科室

说明：通过接口向医院请求查询科室的命令，医院通过中间库返回所有科室信息,

例如专科，内科等。

参数：

返回值：科室列表，RET_CODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_DEPT</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD>

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_DEPT</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

第5页共63页

〈PASSWORD〉交易密码〈/PASSWORD>

</HEADER>

<RESULTS>

<RET_CODE>信息代码</RET_CODE>

〈RET」NFO>返回信息描述</RET_INFO>

<LIST>

<DEPT>

<DEPT_TYPE_ID>科室类别ID〈/DEPT_TYPE_ID>

〈ORG_CODE>医院编码</ORG_CODE>

<DEPT_CODE〉科室编码〈/DEPT_CODE>

〈DEPT_NAME〉科室名称〈/DEPT_NAME〉

<DEPT_ADDR>科室地址〈/DEPT_ADDR〉

<DEPT_REMARK>科室简介</DEPT_REMARK>

〈PARENT_ID>上级ID</PARENT_ID>

<IS_LEAF>是否子节点〈/IS_LEAF>

<NODE_LEVEL>等级〈/NODE_LEVEL>

〈STATUS〉状态〈/STATUS〉

<P_CODE>拼音简码（/P_CODE>

</DEPT>

</LIST>

</RESULTS>

</ADTECH>

3.5获取挂号医生

说明：通过接口向医院请求查询医生的命令，通过中间表返回所有医生信息，主

要查询内容有医生信息，所属部门，挂号级别等

参数：

返回值：医生列表。RET/ODE为1为成功，其他失败

第6页共63页

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码</RET_CODE>

<RET_INFO>返回信息描述〈/RETJNFO〉

<LIST>

<STAFF>

〈DEPT_CODE〉科室编码〈/DEPT_CODE>

<STAFF_CODE>医生编码</STAFF_CODE>

<STAFF_NAME>医生名称</STAFF_NAME〉

〈STAFF_REMARK〉医生简介〈/STAFF_REMARK>

<HOME_TEL>电话〈/HOME_TEL〉

〈BIRTH〉生日</BIRTH>

〈SEX>性别〈/SEX>

<E_MAIL>电子邮件〈/E_MAIL>

<ID_CARD〉身份证号码</ID_CARD〉

〈HOME_ADDR>家庭地址〈/HOME_ADDR>

第7页共63页

(STATUS〉状态〈/STATUS〉

〈SPELLING〉拼音〈/SPELLING〉

〈AVGTIME〉平均看病时间〈/AVGTIME〉

〈STAFF_REGNUM>挂号数〈/STAFF_REGNUM〉

</STAFF>

</LIST>

</RESULTS>

</ADTECH>

3.6获取医生挂号级别信息

说明：通过接口向医院请求查询挂号级别的命令，医院中间表返回所有挂号级别

信息，如副高、正高，专家等

参数：

返回值：医生挂号级别列表，RET/ODE为1为成功，其他失败

A发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF_TYPE</TRANSACT>

〈ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_STAFF_TYPE</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

第8页共63页

</HEADER>

<RESULTS>

〈RET_CODE〉信息代码</RET_CODE〉

<RET」NFO〉返回信息描述</RET」NFO>

<LIST>

<STAFF_TYPE>

<ORG_CODE>医院编码</ORG_CODE>

<STAFF_TYPE_CODE>医生级别编码〈/STAFF_TYPE_CODE〉

〈STAFF_TYPE_NAME〉医生级别名称</STAFF_TYPE_NAME〉

<REGIST_PRICE>挂号费</REGIST_PRICE>

<CLINIC_PRICE>诊疗费</CLINIC_PRICE>

〈OTHER_PRICE>其他费用</OTHER_PRICE>

</STAFF_TYPE>

</LIST>

</RESULTS>

</ADTECH>

3.7获取普通排班信息

说明：向医院发出同步排班信息（排班周期一般为一周或根据医院需求）的请求,

医院中间表返回未来一段时间的排班信息。

参数：

返回值：排班信息列表。RET/ODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

第9页共63页

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

<RET」NFO>返回信息描述〈/RET_INFO〉

<LIST>

<DUTY>

<UUID>排班ID</UUID>

〈DUTY_DATE〉排班日期〈/DUTY_DATE〉

〈PERIOD〉上下午〈/PERIOD〉

<STAFF_CODE>医生编码</STAFF_CODE〉

<DEPT_CODE>科室编码</DEPT_CODE〉

<STAFF_TYPE_CODE>医生级别编码〈/STAFF_TYPE_CODE>

〈STATUS〉状态〈/STATUS》

〈REG_NUM>可预约数</REG_NUM>

</DUTY>

</LIST>

</RESULTS>

</ADTECH>

第10页共63页

3.8新增患者信息

说明：向医院提交增加患者信息的请求，并传入患者信息。写入中间库或第二阶

段通过医院接口处理成功后返回患者的编号(USER_CODE)；失败则返回错误

消息。

参数：患者信息，如患者姓名、性别、年龄等。

返回值：患者CODE或失败消息，RET/ODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_AMS_USER</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<ID_CARD〉身份证号〈/ID_CARD〉

<NAME_CN>中文姓名</NAME_CN>

〈NAME_EN>英文姓名</NAME_EN>

<HOME_TEL>家庭电话〈/HOME_TEL>

〈MOBILE〉移动电话〈/MOBILE>

<BIRTH>生日〈/BIRTH〉

〈SEX>性别〈/SEX>

〈FOLK〉民族〈/FOLK〉

〈WEDLOCK〉婚姻状态</WEDLOCK>

<E_MAIL>电子邮件</E_MAIL>

<ID_CARD>身份证〈/ID_CARD>

〈HOME_ADDR>家庭地址〈/HOME_ADDR>

〈CARTEVITALE>医保卡号</CARTEVITALE>

</INPARA>

</ADTECH>

第11页共63页

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_USER</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

<RET」NFO》返回信息描述〈/RET」NFO>

</RESULTS>

</ADTECH>

3.9预约挂号

说明：向医院发出挂号请求，传入挂号信息，医院处理后返回成功或失败消息。

第一阶段只将挂号数据写入到医院前置机中间表。第二阶段调用医院提供实时接

口，返回成功信息。

参数：挂号信息

返回值：预约成功或失败消息。RET/ODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<UUID>排班ID</UUID>

<USER_ID_CARD>患者身份证号码</USER」D_CARD〉

〈USER_CARD_NUMBER>患者就诊卡号〈/USER_CARD_NUMBER>

第12页共63页

〈USER_NAME>患者姓名</USER_NAME>

〈PAY_TYPE〉1-三方支付、2-医保〈/PAYJTYPE〉

〈PAY_AMOUNT>支付金额</PAY_AMOUNT〉

〈PAY_NO>支付流水号〈/PAY_NO>

〈PAY_CARD_ID〉支付卡号〈/PAY_CARD」D〉

<IS_PAY>是否支付〈/IS_PAY>

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代码</RET_CODE〉

〈RETJNFO〉返回信息描述</RET」NFO>

<REG_UUID>本次预约挂号功成的唯一标识〈/REG_UUID》

</RESULTS>

</ADTECH>

3.10预约挂号确认（取号）

患者到医院进行预约挂号确认后，医院向预约系统更新预约取号成功的信息。该

方法只需要在中间前置机中将挂号记录中的is_used修改为1,取号时间修改为

患者取号的时间即可，然后由预约诊疗系统通过查询挂号记录的状态，更新状态

到预约平台。

说明：向医院提交预约挂号是否取号的请求。

参数：就诊日期

返回值:预约挂号记录列表或失败消息,RET/ODE为1为成功，其他失败;CONFIRM

第13页共63页

为1是已取号，2是未取号，3已退号

察发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_CONFIRM</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<VISIT_DATE>就诊日期〈/VISIT_DATE〉

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

<TRANSACT>REG_CONFIRM</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

〈RET」NFO》返回信息描述〈/RET」NFO>

<LIST>

<REG>

〈REG_UUID〉预约挂号功成的唯一标识〈/REG_UUID>

〈CONFIRM）是否取号（0-未取，1-已取）</CONFIRM>

</REG>

</LIST>

</RESULTS>

第14页共63页

</ADTECH>

3.11预约挂号撤销（退号）

说明：患者可在预约就诊前一天通过各个途径对预约挂号进行撤销操作，向医院

发送退号请求，医院对退号请求处理后返回成功或失败信息。

参数：挂号信息，挂号状态，退号时间等。

返回值：返回信息描述。RET/ODE为1为成功，其他失败

A发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<REG_UUID〉预约挂号的UUID</REG_UUID>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE〉

<RET」NFO>返回信息描述</RET」NFO>

</RESULTS>

第15页共63页

</ADTECH>

3.12获取挂号信息

说明：向医院发出获取挂号信息的请求，医院中间表返回一段时间的挂号信息。

参数：

返回值：挂号信息列表

异发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_REG</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

〈TIMEBEGIN〉创建时间的开始时间</TIMEBEGIN>

〈TIMEEND>创建时间的结束时间</TIMEEND>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_REG</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

〈RET_INFO>返回信息描述〈/RET_INFO>

第16页共63页

<LIST>

<REG>

〈REG_UUID>挂号UUID</REG_UUID>

〈USER_CODE>用户编码</USER_CODE>

〈REG_WAY〉挂号途径〈/REG_WAY>

<STAFF_CODE>医生编码</STAFF_CODE>

<DEPT_CODE>科室编码</DEPT_CODE〉

〈ORG_CODE>医院编码</ORG_CODE>

〈ORDER」IME〉预约时间</ORDER_TIME>

〈PERIOD_NAME>时段名称〈/PERIOD_NAME〉

<PERIOD_DETAIL>时段详情</PERIOD_DETAIL>

<STAFF_NAME>医生名称〈/STAFF_NAME>

〈DEPT_NAME〉科室名称〈/DEPT_NAME〉

〈ORG_NAME>医院编码</ORG_NAME>

〈USER_NAME>用户名称〈/USER_NAME〉

〈CREATEJHME〉创建挂号时间</CREATE_TIME>

〈REG_NUMBER>就诊号〈/REG_NUMBER〉

〈IS_PAY>是否支付</IS_PAY>

<IS_USER〉是否取号〈/IS_USER>

</REG>

</LIST>

</RESULTS>

</ADTECH>

3.13机构信息

说明：向医院发送医院信息同步请求，医院返回本医院信息。（本接口所需信息

可以人工到医院采集，无须做接口）

参数：

第17页共63页

返回值：机构信息列表

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_ORG</TRANSACT>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_ORG</TRANSACT>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

<RET_CODE〉信息代码〈/RET_CODE>

〈RET」NFO>返回信息描述〈/RET_INFO>

<ORG>

〈ORG_CODE>医院编码</ORG_CODE>

〈PARENT_CODE>上级机构编码〈/PARENT_CODE〉

〈ORG_NAME>医院名称</ORG_NAME>

<ORG_DESC>医院排序</ORG_DESC〉

(STATUS〉状态〈/STATUS>

〈ORG_REMARK>医院简介</ORG_REMARK〉

<CONTACT_PHONE>联系电话</CONTACT_PHONE>

<IS_PAY>支付提供支付</IS_PAY>

〈SPELLING》拼音编码〈/SPELLING〉

<ISNEED_CARD〉是否需要就诊卡</ISNEED_CARD>

</ORG>

</RESULTS>

第18页共63页

</ADTECH>

3.14就诊卡验证

说明：如果医院需要挂号必须要就诊卡需要添加此接口，通过用户姓名，身份证

号和就诊卡号调用医院接口判断就诊卡是否真实。

返回值：RET_CODE为1为成功，其他失败

A发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CHECK_USER_INFO</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD》交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<ID_CARD〉身份证号</ID_CARD>

<USER_NAME>用户姓名</USER_NAME>

<HOSPITAL_CARD〉医院就诊卡号</HOSPITAL_CARD>

</INPARA>

</ADTECH>

》返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_NUMBER</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

〈RET」NFO》信息描述〈/RET_INFO>

</RESULTS>

</ADTECH>

第19页共63页

3.15获取体检项目

说明：通过接口向医院请求查询体检项目的命令。

参数：

返回值：项目列表RET_CODE为1成功，其他失败

》发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_PRODUCT</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD》

</HEADER>

</ADTECH>

A返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_PRODUCT</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代码〈/RET_CODE>

〈RET」NFO〉返回信息描述</RET」NFO>

<MCPRODUCT>

〈PRODUCT_CODE〉体检项目编码</PRODUCT_CODE〉

<PRODUCT_NAME>体检项目名称〈/PRODUCT_NAME〉

〈EXPLAIN〉值〈/EXPLAIN)

<PRODUCT_TYPE>体检类别〈/PRODUCT_TYPE〉

〈STATUS〉状态〈/STATUS〉

第20页共63页

〈PRICEAMOUNT〉价格〈/PRICEAMOUNT〉

〈ORG_CODE>医院编码</ORGJXDE〉

</MCPRODUCT>

</RESULTS>

</ADTECH>

3.16获取体检套餐

说明：通过接口向医院请求查询体检套餐的命令。

参数：

返回值：套餐列表RET_CODE为1成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_PRODUCT_COMPOSITION</TRANSACT>

〈ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

》返回格式

<ADTECH>

<HEADER>

<TRANSACT>GET_PRODUCT_COMPOSITION</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE>信息代码〈/RET_CODE>

〈RET」NFO>返回信息描述〈/RET_INFO>

<MCPRODUCT>

第21页共63页

<COMPOSITION_CODE>体检套餐编码（/COMPOSITION_CODE>

〈PRDUCTJODE〉体检项目编码〈/PRDUCT_CODE〉

〈ORG_CODE>医院编码</ORG_CODE〉

<IS_MUST>是否必选项〈/IS_MUST>

〈STATUS〉状态〈/STATUS〉

〈PRICEAMOUNT〉价格〈/PRICEAMOUNT〉

</MCPRODUCT>

</RESULTS>

</ADTECH>

3.17体检预约

说明：通过接口向医院新增预约体检。

参数：

返回值：是否成功RET/ODE为1成功，其他失败

%发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_CHECKUP</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD）交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<C0MP0Sm0N_C0DE>套餐编码</COMPOSITION_CODE〉

<USER_ID_CARD>客户身份证号码〈/USER_ID_CARD〉

<USER_NAME〉客户姓名</USER_NAME>

<PAY_TYPE>1-三方支付、2-医保〈/PAY_TYPE>

〈PAY_AMOUNT>支付金额</PAY_AMOUNT>

<PAY_NO>支付流水号</PAY_NO>

<PAY_CARD_ID>支付卡号〈/PAY_CARD_ID〉

第22页共63页

<IS_PAY〉是否支付</IS_PAY>

</INPARA>

</ADTECH>

>返回格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_CHECKUP</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD》

</HEADER>

<RESULTS>

<RET_CODE〉信息代码</RET_CODE>

<RET」NFO》返回信息描述〈/RET」NFO>

</RESULTS>

</ADTECH>

3.18当日排班信息

说明：通过接口获取医院的当日排班信息

返回值：排班信息列表。RET_CODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_MC_DUTY_NOW</TRANSACT>

〈ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

</ADTECH>

>返回格式

<ADTECH>

第23页共63页

<HEADER>

<TRANSACT>GET_MC_DUTY_NOW</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE〉

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE>信息代码〈/RET_CODE>

<RET」NFO>返回信息描述〈/RET_INFO>

<LIST>

<DUTY>

〈UUID〉编码</UUID>

〈ORG_ID>医院编码</ORG_ID>

<DUTY_DATE>排班日期</DUTY_DATE〉

〈PERIOD〉上下午〈/PERIOD>

<STAFF_CODE>医生编码〈/STAFF_CODE>

(STAFF_NAME〉医生姓名〈/STAFF_NAME〉

<DEPT_NAME〉科室名称〈/DEPT_NAME>

〈DEPT_CODE〉科室编码〈/DEPTJXDE〉

〈STAFF_TYPE_CODE>医生级别编码〈/STAFF_TYPE_CODE>

〈STATUS〉状态〈/STATUS〉

<REG_NUM>可挂号数</REG_NUM〉

</DUTY>

</LIST>

</RESULTS>

</ADTECH>

319当日挂号

说明：向医院发出挂号请求，传入挂号信息，医院处理后返回成功或失败消息。

第24页共63页

调用医院挂号的实时接口，实现当日挂号的实时性。

参数：挂号信息

返回值：挂号成功或失败消息。RET/ODE为1为成功，其他失败

>发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG_NOW</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

〈UUID〉排班ID</UUID>

〈USER_ID_CARD>患者身份证号码〈/USER_ID_CARD>

〈USER_CARD_NUMBER>患者就诊卡号〈/USER_CARD_NUMBER>

<USER_NAME>患者姓名</USER_NAME>

<PAY_TYPE>1-三方支付、2-医保</PAY_TYPE〉

〈PAY_AMOUNT>支付金额</PAY_AMOUNT〉

<PAY_NO>支付流水号</PAY_NO>

<PAY_CARD_ID>支付卡号</PAY_CARD_ID〉

<IS_PAY>是否支付（/IS_PAY>

</INPARA>

</ADTECH>

>返回］n、格式

<ADTECH>

<HEADER>

<TRANSACT>ADD_MC_REG_NOW</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

第25页共63页

〈RET_CODE>信息代码</RET_CODE>

<RET」NFO>返回信息描述〈/RET」NFO>

〈REG_UUID〉本次预约挂号功成的唯一标识</REG_UUID〉

</RESULTS>

</ADTECH>

3.20当日挂号确认（取号）

说明：患者到医院进行挂号确认后，医院向预约系统更新预约取号成功的信息。

该方法只需要在中间前置机中将挂号记录中的is_used修改为1,取号时间修改

为患者取号的时间即可，然后由预约诊疗系统通过查询挂号记录的状态，更新状

态到预约平台。

说明：向医院提交挂号是否取号的请求。

参数：就诊日期

返回值:预约挂号记录列表或失败消息,RET/0DE为1为成功，其他失败;CONFIRM

为1是已取号，2是未取号，3已退号

A发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>GET_REG_CONFIRM</TRANSACT>

<ORG_CODE>医院代码</ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<INPARA>

<VISIT_DATE>就诊日期〈/VISIT_DATE>

</INPARA>

</ADTECH>

>返回信息格式

<ADTECH>

<HEADER>

第26页共63页

<TRANSACT>REG_CONFIRM</TRANSACT>

<ORG_CODE>医院代码〈/ORG_CODE>

〈PASSWORD〉交易密码〈/PASSWORD〉

</HEADER>

<RESULTS>

〈RET_CODE〉信息代码〈/RET_CODE>

〈RET」NFO>返回信息描述</RET_INFO>

<LIST>

<REG>

〈REG_UUID>挂号功成的唯一标识〈/REG_UUID〉

〈CONFIRM〉是否取号（0-未取，1-已取）</CONFIRM>

</REG>

</LIST>

</RESULTS>

</ADTECH>

3.21当日挂号撤销（退号）

说明：患者可在未在医院取号时，通过各个途径对当日挂号进行撤销操作，向医

院发送退号请求，医院对退号请求处理后返回成功或失败信息。当患者进行了退

号操作后，调用医院的退号接口，进行实时退号

参数：挂号信息，挂号状态，退号时间等。

返回值：返回信息描述。RET/ODE为1为成功，其他失败

A发送命令格式

<ADTECH>

<HEADER>

<TRANSACT>CANCEL_REG_NOW</TRANSACT>

<ORG_CODE>