医保接口调用参考手册

重庆跨统筹区就医结算平台接口调用参考手册

重庆跨统筹区就医结算平台

接口调用 参考手册

(Rev 2.0)

成都莲合创想科技有限公司

2010年10月

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

.目录

1. 2. 3.

重庆跨统筹区就医结算平台及医院接口整体介绍 ................................................................ 3 重庆跨统筹区就医结算平台医院接口的体系结构介绍 ........................................................ 5 重庆跨统筹区就医结算平台接口调用概述 ........................................................................... 6

3.1. IPAPI编程范例说明 ................................................................................................................... 6 3.2. 主要业务调用流程说明 ........................................................................................................... 8 3.3. 业务数据字典 ........................................................................................................................... 8 4.

基础性操作函数 ..................................................................................................................... 9 4.1. 系统调用(SYS_???).................................................................................................................... 9 4.2. 对于ID识别设备的操作(ID_ CALL) ......................................................................................... 11 4.3. 对于数据集操作功能 (DS_CALL) ........................................................................................... 15 5.

业务操作函数 ....................................................................................................................... 21 5.1. 登录及身份验证功能(IP_REGCALL) ....................................................................................... 21

? OperReg【操作员登录】 ..................................................................................................... 22 ? OperPassChange【操作员修改密码】 .............................................................................. 22 ? OperOut【操作员退出】 ...................................................................................................... 23 ? UserReg【参保人登录】 ..................................................................................................... 23

5.2. 就医管理功能(IP_DIAGCALL) .................................................................................................. 24

? InReg【就诊登记】 .............................................................................................................. 25 ? CancelInReg【取消就诊登记】 .......................................................................................... 28 ? OutReg【出院登记】 ........................................................................................................... 28 ? CancelOutReg【取消出院登记】 ....................................................................................... 29 ? ItemReg【费用登记】 .......................................................................................................... 30 ? CancelItemReg【取消费用登记】 ...................................................................................... 31 ? CancleAllItem【清空上传费用】 ......................................................................................... 31 ? FirstPage【修改病案首页】 ................................................................................................ 32

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

? SetChkParm【设置结算参数】 ........................................................................................... 33 ? CheckOut【结算】 ............................................................................................................... 33 ? InvoiceLoad【下载结算单】 ................................................................................................ 35 ? Redraw【门诊退票】 ........................................................................................................... 35 ? CancelCheck【取消结算】 ................................................................................................. 36 ? CheckInsteadPay【查询个帐可冲抵金额】 ...................................................................... 36 ? InsteadPay【住院个帐冲抵自费】 ..................................................................................... 37

5.3. 综合查询功能(IP_MANAGECALL) ........................................................................................... 38

? Doctors【下载本院医生】 ................................................................................................... 38 ? ItemQuery【收费项目模糊查询】 ....................................................................................... 39 ? billMaster【结果账目查询】 ................................................................................................ 40

5.4. 审批相关的功能调用(IP_REQUESTCALL) ............................................................................... 41

? PutRequest【网上申报】 .................................................................................................... 42

1. 重庆跨统筹区就医结算平台及医院接口整体介绍

重庆跨统筹区就医结算平台(InsurePay)是处理医疗保险中支付业务的信息

管理平台，支付平台通过管理详细的就医记录的方式来连接医药机构（医院、药店、卫生服务站）和医疗保险经办机构，通过药品管理，就医的详细记录来完成医疗保险业务中的支付结算业务。

重庆跨统筹区就医结算平台医院接口(IPAPI)是提供给大中型医院的信息管

理系统(HIS)所使用的无缝接口，医院信息管理系统通过调用IPAPI可以完成就医

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

人员身份验证、就医登记、出院入院、费用登记、结算等功能；除了基本的功能外，医院接口(IPAPI)还提供特殊用药、特殊诊疗的网上申报功能，医保收费目录的下载等其他辅助功能。 对于部分小型医院和乡镇卫生院，我们提供了重庆跨统筹区就医结算平台医院终端系统(ipterm), 该系统能够完成就医人员身份验证，就医登记，出入院，费用登记，结算报销等功能。该系统也是通过调用IPAPI来实现功能的。ipterm相关功能请参见相关(ipterm)的用户手册。

重庆跨统筹区就医结算平台(InsurePay), 重庆跨统筹区就医结算平台医院

接口(IPAPI), 重庆跨统筹区就医结算平台医院终端系统(ipterm)三者关系如下图所示:

重庆跨统筹区就医结算平台 ipterm ipapi ipapi his 如果所示:

1. ipterm,ipapi都是重庆跨统筹区就医结算平台(InsurePay)的组成部分。

2. his和ipterm都是通过调用ipapi来完成和支付中心的信息交换的。his, ipterm并不能直接访问支付中心，使用接口的医院也可以安装ipterm进行医保相关信息的查询以及医保月结报表的统计打印。

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

2. 重庆跨统筹区就医结算平台医院接口的体系结构介绍

重庆跨统筹区就医结算平台医院接口是采用WINDOWS DLL方式提供的，实际上精确的说IPAPI是采用activex自动机方式提供的，支持idispatch和vtable二种接口。可以方便的为C#, VB, VC,CB, BC,DEPHI,等开发工具调用。

IPAPI 支付中心 外部程序 调用接口 通讯处理模块 设备管理摸块 数据集缓存 身份识别设备 如图所示:

1、 IPAPI提供接口，供外部程序调用。接口的方式为Activex自动机方式。IPAPI不提供事件接口。接口功能分为几个部分：系统功能，数据集操作，身份识别设备操作，注册管理，就医管理，信息查询七个部分的功能，详细情况请参见后面相关章节。

2、 IPAPI提供对中心的通讯支持，这部分的支持是透明的，调用程序可以不管理这部分功能，使用通讯是自动的。

3、 IPAPI提供对身份识别设备的驱动支持，身份识别设备可能根据各地情况不同有很多的不同，IC卡，磁卡，指纹识别，射频卡等都可

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

以很好的支持。 针对不同的设备，莲合公司将提供不同的设备驱动程序配合IPAPI完成相关工作。

4、 IPAPI内部提供数据集缓冲机制，外部可以通过调用接口来访问这些数据集合。数据集合是外部程序调用和中心进行数据交换的重要桥梁。数据集的结构是预定义好的，不允许调用程序新建立数据集，但是可以允许外部调用程序增加，删除，修改记录。相关数据集的说明,参见后面章节的描述。

3. 重庆跨统筹区就医结算平台接口调用概述

3.1. IPAPI编程范例说明

IPAPI是采用activex自动机方式提供的，可以适用于任何支持windows

activex机制的编程语言访问。比如: C#, VB, DEPHI, VC, C++Builder, BorlandC++ 等主流开发工具都可以方便的访问IPAPI。

基本的调用方式(通用的activex自动机调用方式) STEP1: 首先注册ipapi. 使用 regsvr32 ipapi_dll.dll.

STEP2: 如果要使用身份验证设备，则必须把相关的设备驱动程序拷贝到

windows/system32目录或者接口ipai_dll.dll同一目录下，否则将以下以C#语言为例，简单说明如何使用IPAPI处理相关业务。

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

无法通过初始化设备程序。

STEP3: 建立一个C#项目，并在项目中添加引用，选择COM的标签。在

列表中选择”IPAPI 类型库” (同时检查一下文件名称和位置是否合STEP1注册时候位置相同). 如果未发现则表示STEP1注册未成功，应该重新注册或检查环境情况。

STEP4: 做好STEP1~STEP3后，就可以在程序中调用ipapi_dll的功能了。 STEP5: 如果这台机器不需要应用ipapi_dll.dll，可以通过regsvr32 /u

ipapi_dll.dll 反注册该active自动机。

简单的C#调用结构如下:

ipapi_dll.Cipapi m_ipapi; //定义类对象 int retcode;

string retstr;

m_ipapi = new ipapi_dll.Cipapi(); //初始化类实例

retcode = m_ipapi.SYS_Init(); //调用接口的初试化涵数 if (retcode != 0) {

return; //初始化接口失败，返回 }

//设置通信服务器连接信息

m_ipapi.set_SYS_CFG(\, \192.168.0.204\); //服务器IP地址 m_ipapi.set_SYS_CFG(\, \); //服务器端口 m_ipapi.set_SYS_CFG(\,\ ); //服务器节点 //调用操作员登录//

retstr = m_ipapi.IP_RegCall(\,\1101\,\,\1234\,\”); if (retstr ！= \) {

return; //操作员登录失败退出 }

// TODO…调用相关功能 //

retstr = m_ipapi.IP_RegCall(\, \, \, \, \); //操作员退出。 成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

retcode = m_ipapi.SYS_Exit(); // 调用接口退出函数 m_ipapi = null;

return;

3.2. 主要业务调用流程说明

初始化接口 操作员登录 就诊人员登录 参保档案查询 医院医生查询 收费项目查询 门诊\\住院业务 I.门诊业务流程 就诊登记 ? ?取消就诊登记 费用项目登记 预结算 确认结算 门诊退票 II.住院业务流程 就诊(入院)登记? ?取消就诊登记 费用项目登记 ? ?取消项目登记 出院登记 ? ?取消出院登记 预结算 确认结算 ? ?取消结算，招回在院 网上申报 操作员退出登录

3.3. 业务数据字典

? organ_id C4 经办机构号（参保人的险种类别编号）;

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

? hospital_id C4 定点医疗服务机构号（医院号/药店）; ? insure_id C20 医保号; ? card_no C20 就医卡卡号;

? diag_id C20 医保就诊登记号，就诊登记时医保返回的登记流水号，

一次就诊一个就诊登记号；

? rcpt_no C20 结算交易号，就诊结算时返回的此次结算流水号,一

次就诊可多笔结算交易（及就诊登记号与结算交易是一对多关系），此编号结算后需保存，以便 门诊退票 和 住院取消结算 使用;

? invoice_no C10 税务发票号，由HIS前端在确认结算时传入,(如果HIS

没有使用实际税务发票上的发票号，也可以直接传HIS打印在发票上的编号);

? hdiag_id C20 医院内部就诊号,门诊时为门诊就诊号，住院时为住

院号；

4. 基础性操作函数

4.1. 系统调用(SYS_???)

? SYS_Init

调用模型: int SYS_Init(); 功能说明: 初始化接口 参数说明: <无>

返回值说明: 0:表示正确， 其他：表示错误

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

备注: 必须首先调用该函数，SYS_Init只初始化本地数据，并不连接服务器

和初始化身份识别设备等。

? SYS_Exit

调用模型: int SYS_Exit(); 功能说明: 退出接口 参数说明: <无>

返回值说明: 0:表示正确， 其他：表示错误 备注: <无> ? set_SYS_CFG

调用模型: void set_SYS_CFG(string cfgname,string cfgvalue); 功能说明: 设置系统参数

参数说明: cfgname=参数名，cfgvalue参数值 返回值说明:<无> 备注: ? get_SYS_CFG

调用模型: string get_SYS_CFG(string cfgname); 功能说明: 取得系统参数信息 参数说明: cfgname=参数名 返回值说明:<无> 备注:

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

4.2. 对于ID识别设备的操作(ID_ CALL)

ID识别就是操作医疗保险管理部门发行的各种医疗保险卡，IPAPI中提供 了详细的操作函数来支持这些设备的操作。具体采用的身份识别方式由本地医疗保险管理部门决定。IPAPI可以处理磁卡，IC卡，射频卡，条码卡，指纹仪器，虹膜识别，等多种身份识别方式。 函数定义

string ID_ CALL(string func_id,

string instr);

func_id为具体的功能子号，instr为调用参数，返回值也是一个串,其中func_id不同来决定是调用的何种功能。init:初始化环境，exit:退出环境，havepass：读卡，并判断是否有密码，chkpass：验证密码，get:从设备中取得数据，put: 向设备发送指令。其中之一 get,put命令根据设备的不同，有不同的功能。以下对每个功能调用进行详细的说明。

? init

功能说明: 初始化身份识别设备驱动程序

参数说明: func_id=\为设备参数,设备不同意义不同。 返回值说明:\表示成功，\表示失败

备注: 必须先通过set_SYS_CFG 设置设备驱动程序，参数名称为\

电话(传真)：028-85217600

成都莲合创想科技有限公司

重庆跨统筹区就医结算平台接口调用参考手册

? exit

功能说明: 卸除身份识别设备驱动程序 参数说明: func_id=\无意义。 返回值说明: \表示成功，\表示失败 备注: <无>

? havepass

功能说明: 读卡，并判断是否有密码，取卡上信息必需先做此步骤 参数说明: func_id= \ \返回值说明: \有密码，\无密码，\操作失败 备注: <无>

? chkpass

功能说明: 密码效验

参数说明: func_id=\% 返回值说明: \表示成功，\表示失败 备注: <无>

? get

功能说明: 从身份识别设备上取得数据

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册 参数说明: func_id=\为要取得的数据名称。 返回值说明: \表示失败, 其他表示取得了相关的数据.

备注:instr有可能是需要取得的数据名称，也可能是数据命令。根据不同的设

备驱动，命令有很大的不同。

Instr参数对应功能说明:

*type: 取得卡片类别oper|insure|error，必需先读卡 *organ_id: 取得就医卡发卡的经办机构,错误返回* *insure_id: 返回就医保参保号，错误返回* *card_no: 返回卡号，错误返回* *oper_id: 返回操作员号。错误返回*

*familycard: 返回是否家庭卡标志。\家庭卡,\个人卡,家庭卡读取

的(insure_id)字段为家庭编号,个人卡读取的insure_id为医保号

? put

功能说明:发送控制命令或写数据到身份识别设备上。 参数说明: func_id=\发送的命令或要写的数据。 返回值说明: \表示失败, 其他表示取得了相关的数据.

备注:instr有可能是需要取得的数据名称，也可能是数据命令。根据不同的设

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

备驱动，命令有很大的不同。 Instr参数对应功能:

以下以莲合公司的IC卡为例说明ID_CALL的操作方式。

string strpwd = ““;

retstr = m_ipapi.ID_Call(“havepass”,”%”); //判断有无密码 if (retstr == “Y”) {

//有密码，效验密码

frmCardPwd frmPwd = new frmCardPwd(); try {

frmPwd.ShowDialog(); strpwd = frmPwd.strpwd;

retstr = m_ipapi.ID_Call(“chkpass”,”%” + strpwd);//验证密码 if (retstr == “*”) //验证失败，并取错误信息 {

Messagebox.Show(“ERROR:“ +m_ipapi.get_SYS_CFG(“msgno”) + “\\n” + m_ipapi.get_SYS_CFG(“msg”));

m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return -1; }

} catch {

Messagebox.Show(“验证密码失败！” + retstr); m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return -1; } }

else if (retstr == “*”) {

Messagebox.Show(“判断有无密码出错”); m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return -1;

成都莲合创想科技有限公司

电话(传真)：028-85217600

*pop: 弹卡

重庆跨统筹区就医结算平台接口调用参考手册

}

retstr = m_ipapi.ID_Call(“get”,”*type”); // 分析卡片类型，操作员卡/就医卡 if (retstr == “oper”) {

// 操作员卡，可以取医院号(hospital_id)，操作员号(oper_id)，和操作员名称(name) // Messagebox.Show(“卡类型错误,需要医保卡!”); m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return -1; }

else if (retstr == “insure”) {

// 如果是就医卡，则可以取卡号(card_no)，经办人机构号(organ_id)，医保号(insure_id) card_no = m_ipapi.ID_Call(“get”,”*card_no”); organ_id = m_ipapi.ID_Call(“get”,”*organ_id”); insure_id = m_ipapi.ID_Call(“get”,”*insure_id”);

/*家庭卡标志，部分险种使用一户一卡形式，如果为家庭卡时需要HIS放做个查询选择界面。具体在需要使用的地方，单独文档介绍*/

insure_id = m_ipapi.ID_Call(“get”,”*familycard”); m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return 0; } else {

// 如果不是操作员卡(oper),也不时就医卡(insure),那么肯定就是非法卡。 Messagebox.Show(“非法卡” + retstr); m_ipapi.ID_Call(“put”,”*pop”); // 弹卡// return -1; }

4.3. 对于数据集操作功能 (DS_CALL)

函数作用说明：业务交易调用中，主要有两个部分需要用到此函数

(1) 涉及多参数需要HIS前端传入时，IPAPI提供DS_CALL函数，先将参数

写入数据集缓存中，然后调用交易函数进行业务。

(2) 查询医保多行数据时，先调用调用具体的查询交易，然后再调用

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

DS_CALL函数，将数据集从缓存中取回使用。

函数定义:

string DS_Call(string funcid,

string dsname, string par_name, string par_value)

其中funcid为功能号，dsname为所访问的数据集名称，par_name为访问的参数名称, par_value为参数值。除了funcid,dsname这二个参数对每个调用意义相同外，par_name,par_value根据不同的调用有不同的意义。 以下对每个功能进行详细描述:

? getrownum

功能说明: 取得指定数据集行数

参数说明: par_name无意义、par_value无意义 返回值说明:返回行数

备注: <无意义字段请直接传入“*“>

? setrownum

功能说明: 设置指定数据集行数

参数说明: par_name无意义,par_value新行数, 后面的行就被删除 返回值说明: ”0”表示成功，”*”表示失败

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册 备注: <无意义字段请直接传入“*“>

? getfieldvalue

功能说明: 取得字段值

参数说明: par_name字段名称，par_value无意义 返回值说明: 字段内容，如果无该字段，则返回”” 备注: <无意义字段请直接传入“*“>

? setfieldvalue

功能说明: 设置字段值

参数说明: par_name 字段名称 par_value 字段值 返回值说明:”0”表示成功，”*”表示失败 备注: <无>

? setlineno

功能说明: 设置指定数据集的当前行数,并把当前行数据读入到缓冲区，要取

某行数据时，调用此函数

参数说明: par_name、par_value无意义。 返回值说明:”0”表示成功，”*”表示失败 备注: <无意义字段请直接传入“*“>

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

? getlineno

功能说明: 取得指定数据集当前行号 参数说明: par_name、par_value无意义。 返回值说明: 返回当前行号. 备注: <无意义字段请直接传入“*“>

? clearline

功能说明: 清空缓冲区。

参数说明: par_name、par_value无意义。 返回值说明:”0”表示成功，”*”表示失败 备注: <无意义字段请直接传入“*“>

? updateline

功能说明: 修改当前行,实际就是把缓冲区数据写到数据集合中。 参数说明: par_name、par_value无意义。 返回值说明:”0”表示成功，”*”表示失败 备注: <无意义字段请直接传入“*“>

? appendline

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

功能说明: 追加当前行,把当前数据追加到数据集末，并把当前行号设置到这

里。

参数说明: par_name、par_value无意义 返回值说明:”0”表示成功，”*”表示失败 备注: <无意义字段请直接传入“*“>

? getstruct

功能说明: 取得当前数据集类型,某列结构.

参数说明: par_value 要取得结构的列号，par_name无意义。

返回值说明:返回结构，格式：<字段名称>.<字段类型>.<字段长度>.<字段精

度>

备注: <无意义字段请直接传入“*“>

? getcolnum

功能说明: 取得列数

参数说明: par_name、par_value 无意义。 返回值说明: 返回列数。 备注: <无意义字段请直接传入“*“>

以下以门诊就诊登记业务和下载医院医生为例，演示DS_CALL函数的设置数据集和取数据集的方法:

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册 (1) 门诊就诊登记业务示例代码

////////step 1: 开始准备就诊登记的参数信息 ////////////////////// //清空数据集，以下两步必须做

m_ipapi.DS_Call(“setrownum”,”diagPage”,”*”,”0”); m_ipapi.DS_Call(“clearline”,”diagPage”,”*”,”*”); //将参数数据写入

m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”hdiag_id”,”121201212”); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”card_no”,card_no); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”outtype_code”,”01”); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”insure_name”,”张三”); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”dept_name”,”1001”); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”doct_name”,”张山”);

m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”regstart_date”,”20071010”)); m_ipapi.DS_Call(“setfieldvalue”,”diagPage”,”h_desc”,”*”); //将参数数据提交到数据集缓存

m_ipapi.DS_Call(“appendline”,”diagPage”,”*”,”*”);

////////step 2: 调用门诊就诊登记函数 //////////////////////

retstr=m_ipapi.IP_DiagCall(“InReg”,txtorgan_id.Text.Trim(),txtinsure_id.Text.Trim(),tmpinsure_session,”*”,”diag”); if (retstr != “*”) {

//就诊登记成功，取回医保就诊登记号。注，医保相关操作必须医保就诊登记号才能进行． txtdiagid.Text = retstr;// 就诊登记号 } else{

//门诊就诊登记失败

MessageBox.show(m_ipapi.get_SYS_CFG(“msgno”) + “|” + m_ipapi.get_SYS_CFG(“msg”)); }

(2) 下载医院医生示例代码

//先清空数据表

m_ipapi.DS_Call(\//调用接口查询函数

string restr = m_ipapi.IP_ManageCall(\,\,\,\,\); if (restr == \) {

MessageBox.show(\ + m_ipapi.get_SYS_CFG(\) + \ + m_ipapi.get_SYS_CFG(\));

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

return; }

//以下代码取回医院医生信息,并组成字符串 string rowstr= \;

colnum = Convert.ToInt32(m_ipapi.DS_Call(\,\,\,\));//数据表列数 rownum = Convert.ToInt32(m_ipapi.DS_Call(\,\,\,\));//数据表行数 //取多个医生信息，如果只有一行数据的，可以直接设置取0行数据，不用作循环。 for (int j = 0; j < rownum; j++) {

m_ipapi.DS_Call(\//清空缓存集,次步必做

m_ipapi.DS_Call(\,\,\,j.ToString());//设置数据行号,次步必做 rowstr = m_ipapi.DS_Call(\//取出医生编号 //取医生姓名

rowstr = rowstr + \//取医生状态

rowstr = rowstr + \ + m_ipapi.DS_Call(\,\,\,\); }

5. 业务操作函数

5.1. 登录及身份验证功能(IP_REGCALL)

函数定义：

string IP_RegCall(string func_id,

string mhospital_id, string organ_id , string insure_id , string insure_pass, string insure_newpass)

功能说明

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

此功能函数提供操作员登录，操作员员修改密码，操作员退出，参保人身份验证等功能;其中func_id为功能号，其他字段根据操作不同具有不同的意义。

以下对每个功能进行详细描述 ? OperReg【操作员登录】

功能说明: 操作员登录

主参数说明: mhospital_id 归属医院号，

organ_id 医院终端号。 insure_id 操作员号 insure_pass 操作员密码

insure_newpass 定点授权码

数据集参数<无>

返回值说明: ”0”表示成功,其他表示失败

? OperPassChange【操作员修改密码】

功能说明: 操作员修改密码

主参数说明: mhospital_id “*”无意义，

organ_id “*”无意义。 insure_id 操作员号 insure_pass 原密码

成都莲合创想科技有限公司

(传真)：028-85217600

电话重庆跨统筹区就医结算平台接口调用参考手册

insure_newpass 新密码

数据集参数<无>

返回值说明:”0”表示成功,其他表示失败

? OperOut【操作员退出】

功能说明: 操作员退出

主参数说明: mhospital_id “*”无意义，

organ_id “*”无意义。 insure_id “*”无意义 insure_pass “*”无意义、 insure_newpass “*”无意义

数据集参数<无>

返回值说明:”0”表示成功,其他表示失败

? UserReg【参保人登录】

功能说明: 参保人登录

主参数说明: mhospital_id “*”无意义，

organ_id 经办机构号(9位)，读卡时获取 insure_id 医保号 insure_pass “*”无意义 insure_newpass 医保卡号

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册 数据集参数<无>

返回值说明: ”0”表示成功,其他表示失败 返回数据集：

字段名称 类型 Varchar(4) varchar(20) varchar(16) varchar(4) 可为空 Not Null Not Null Not Null Not Null Not Null Not Null Not Null 备注 重新取回4位经办机构号(organ_id ) 医保号 参保人姓名 性别 赔付待遇 住址 出生年月yyyyMMdd 身份证号 单位编号 单位名称 基本险本年已统筹 补充险本年已统筹 公务员险本年已统筹 本年已发生总费用 本年已医保合格金额 本年已现金支付 最近就医日期 年已住院次数 特病门诊疾病列表 门诊视同疾病列表 特病门诊出险方式编号 门诊视同出险方式编号 行政区位码 行政区名称 个人状态 单位状态 其他备注信息 organ_id insure_id insure_name sex address birthday icd_id unit_id unit_name organ_oldpay bc_oldpay gwy_oldpay old_totalfee old_pulfee old_percash last_date htimes illness h_illness outtype h_outtype area_id area_name ptakesta utakesta mark

insure_paytype varchar(16) varchar(128) varchar(8) varchar(20) varchar(20) varchar(64) Number(12,2) Number(12,2) Number(12,2) Number(12,2) Number(12,2) Number(12,2) varchar(8) Number(12,0) varchar(128) varchar(128) varchar(4) varchar(4) varchar(20) varchar(64) varchar(8) varchar(8) varchar(128) 5.2. 就医管理功能(IP_DIAGCALL)

函数定义：

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

string IP_DiagCall(string func_id,

string organ_id, string insure_id, string insure_session, string diag_id, string instr)

功能说明

此功能函数提供就诊登记，费用登记，出院结算等业务功能;其中func_id为功能号，其他字段根据操作不同具有不同的意义。

以下对每个功能进行详细描述 ? InReg【就诊登记】

功能说明: 就诊登记

主参数说明: organ_id 经办机构号

insure_id 医保号

insure_session 参保人登录时取得的通信SESSION diag_id

“*”无意义

instr 就诊类型，门诊类为\住院类为\

数据集参数:使用数据集、,注:为就诊主信息参数表(门诊、住院都必需传入此表参数)，为病案首页参数

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

信息表，住院入院登记时需传入,门诊不需要传此表参数。传入两张表的字段如下（数据集参数的传入方法，请参考DS_CALL函数调用说明部分） diagPage就诊信息主表参数

字段名称 hdiag_id card_no outtype_code 类型 Varchar(20) varchar(8) varchar(4) 可为空 Not Null Not Null Not Null 备注 医院内部系统的门诊就诊登记号或住院的住院号 医保卡号 出险方式代码 01 普通门诊,02 普通住院, （特病门诊或门诊视同住院代码，从查询个人档案返回 ） insure_name dept_name doct_name regstart_date h_desc

varchar(12) varchar(16) varchar(8) varchar(8) varchar(4) Not Null Not Null Not Null Not Null 病人姓名 HIS科室编号 医保医生编号 就诊日期yyyyMMdd 就诊说明,可为空 firstPage病案首页参数

字段名称 diag_id his_diagid insure_name idcard married profession tel address unit_zip re_name limreln re_tel re_address re_zip mz_diag mz_icd mz_doctid mz_doctname in_date Inhosptim 类型 Varchar(20) Varchar(20) Varchar(12) Varchar(18) Varchar(4) Varchar(8) Varchar(16) Varchar(128) Varchar(8) Varchar(16) Varchar(8) Varchar(16) Varchar(128) Varchar(8) Varchar(128) Varchar(16) Varchar(8) Varchar(12) Varchar(8) Varchar(8) 可为空 Not Null Not Null Not Null Not Null Not Null Not Null Not Null Not Null Not Null Not Null Not Null 备注 医保就诊登记号，修改病案首页时传入 HIS病案首页号 姓名 身份证号 婚姻情况 职业 单位电话 单位地址 单位邮政编码 联系人 联系人与患者关系 联系人电话 联系人地址 联系人邮编 门诊诊断 门诊诊断ICD码 门诊诊断医生编号 门诊诊断医生名称 入院日期yyyymmdd 入院时间（精确到分）hh24miss 如：163021

电话(传真)：028-85217600

成都莲合创想科技有限公司

重庆跨统筹区就医结算平台接口调用参考手册

hosp_diag hosp_icd defidat hosp_way hosp_stat pathdiag dept bed_id main_doctid main_doctname paymode cadachek firstcase Varchar(128) Varchar(16) Varchar(8) Varchar(8) Varchar(8) Varchar(64) Varchar(10) Varchar(10) Varchar(8) Varchar(8) Varchar(10) Varchar(1) Varchar(1) Not Null Not Null Not Null Not Null Not Null Not Null Not Null 入院初步诊断 入院初步诊断ICD编码 入院后确诊日期yyyymmdd 入院方式(急诊/门诊/住院/转院) 入院状态(急症/危症/一般) 病理诊断 治疗科室(HIS入院科室编号) 病室床位(入院时未分配床位的情况传0) 主诊医生ID（医保注册医生编号） 主诊医生名称 医疗付款方式 是否尸检 0否 1是 手术、治疗、检查、诊断是否为本院第一例 0否 1是 homediag homediaw homediam homediay educase bloodtype rhchara blooreac bcelldosa platdosa plasdosa blodosa otheblodosa extecaus anaphylactic hbsag Varchar(1) Varchar(2) Varchar(2) Varchar(2) Varchar(1) Varchar(8) Varchar(8) Varchar(1) Varchar(8) Varchar(8) Varchar(8) Varchar(8) Varchar(8) Varchar(64) Varchar(64) Varchar(1) 是否随诊 0否 1是 随诊期限（周） 随诊期限（月） 随诊期限（年） 是否为示教病例 0否 1是 血型 RH血型性质 有无输血反应 1 有 2 没有 红细胞用量 血小板用量 血浆用量 全血用量 其他输血品种用量 损伤、中毒的外部因素 过敏药物 乙型肝炎表面抗原HbsAg 0 未做 1 阴性 2阳性 hca_ab Varchar(1) 丙型肝炎病毒抗体HCA-Ab 0 未做 1 阴性 2阳性 hivab clinleaacco inoutaccor baoperaccor raydiagacco clinpathacco rescuetim Varchar(1) Varchar(1) Varchar(1) Varchar(1) Varchar(1) Varchar(64) Varchar(2) 获得性人类免疫缺陷病毒抗体HIV-Ab,0未做 1阴性 2阳性 门诊与出院诊断符合情况 0未做 1符合 2不符合 3不肯定 入院与出院诊断符合情况 0未做 1符合 2不符合 3不肯定 术前与术后诊断符合情况 0未做 1符合 2不符合 3不肯定 放射与病理诊断符合情况 0未做 1符合 2不符合 3不肯定 临床与病理符合情况 抢救次数

电话(传真)：028-85217600

成都莲合创想科技有限公司

重庆跨统筹区就医结算平台接口调用参考手册

succrescu treafilqa Varchar(2) Varchar(1) 抢救成功次数 病案质量 1 甲 2 乙 3 丙 codeid Varchar(12) ICD编码录入人员 返回值说明: ”*”表示失败,其他医保就诊登记号 返回数据集：<无>

? CancelInReg【取消就诊登记】

功能说明: 取消就诊登记

主参数说明: organ_id 经办机构号

insure_id 医保号 insure_session “*”无意义 diag_id

医保就诊登记号

instr “*”无意义

数据集参数: <无>

返回值说明: ”*”表示失败, “0”表示成功 返回数据集：<无>

? OutReg【出院登记】

功能说明: 出院登记

主参数说明: organ_id 经办机构号

insure_id 医保号 insure_session “*”无意义 diag_id

医保就诊登记号

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

instr “*”无意义

数据集参数:

字段名称 out_date leavtim leavoffi leavward out_diag out_diag 格式: 序号|诊断病种|治疗情况|治疗情况备注|诊断类型()|ICD10编码; 序号：出院诊断序号 诊断病种：诊断的疾病名称 治疗情况：1 治愈 2 好转 3 未愈 4 死亡 5 其他 治疗情况备注:治疗情况为其他时，填写此字段,可为空 诊断类型：1主要诊断,2其他诊断,3医院感染 ICD10编号: 诊断病种的ICD10编码, 可为空 示例：1|肉毒中毒|治愈|1|005.10;2|细菌性痢疾|好转|2|004.90; hosp_outs out_way outtype main_doctid main_doctname varchar(128) varchar(8) varchar(4) varchar(8) varchar(12) Not Null Not Null Not Null 出院备注说明 出院类型（普通出院/转院出院） 出险方式编号,可为空 主诊医生ID（医保注册医生编号） 主诊医生名称 类型 Varchar(8) varchar(8) varchar(16) varchar(8) varchar(512) 可为空 Not Null Not Null Not Null Not Null Not Null 备注 出院日期yyyymmdd 出院时间（精确到分）hh24miss 如：163021 HIS出院科室编号 出院病床 出院诊断 返回值说明: ”*”表示失败,“0”表示成功 返回数据集：<无>

? CancelOutReg【取消出院登记】

功能说明: 取消出院登记

主参数说明: organ_id 经办机构号

insure_id 医保号

成都莲合创想科技有限公司

电话(传真)：028-85217600

重庆跨统筹区就医结算平台接口调用参考手册

insure_session “*”无意义 diag_id

医保就诊登记号

instr “*”无意义

数据集参数: <无>

返回值说明: ”*”表示失败,“0”表示成功 返回数据集：<无>

? ItemReg【费用登记】

功能说明: 费用登记

主参数说明: organ_id 经办机构号

insure_id 医保号 insure_session “*”无意义 diag_id

医保就诊登记号

instr 就诊类型，门诊类为“diag”，住院类为“hosp”

数据集参数:

字段名称 diag_id 类型 Varchar(20) varchar(8) varchar(4) varchar(12) varchar(16) varchar(8) varchar(8) varchar(4) 可为空 Not Null Not Null Not Null Not Null Not Null Not Null Not Null 备注 医保就诊登记号 医保项目编号 医院项目编号 医院内部费用序号，此序号对一次就诊必需唯一 项目名称 剂型 规格 单位 医院卖家 数量

电话(传真)：028-85217600

item_id h_itemid h_diagsno item_name item_dosage item_spec units price number 成都莲合创想科技有限公司

本文来源：https://www.bwwdw.com/article/rtm.html