HRPGV6.5产品手册-高值耗材接口版权用友网络科技股份有限公司未经用友网络科技股份有限公司的书面许可，本操作手册任何整体或部分的内容不得被复制、复印、翻译或缩减以用于任何目的。本操作手册的内容在未经通知的情形下可能会发生改变，敬请留意。请注意：本操作手册的内容并不代表用友软件所做的承诺。1/24目录版权1导读3第一章概述.41.1产品概述.41.2产品价值.41.3应用范围及使用必要条件..51.3.1耗材接口应用范围.51.3.2接口使用必要条件.5第二章应用场景.62.1高值耗材计费.62.1.1场景介绍.62.1.2业务流程.72.1.3方案概述及关键特性.72.2高值耗材退费.8第三章初始准备.93.1HIS与HRP基础数据对照.93.1.1HIS科室与HRP部门对照..93.1.2高值耗材（HRP物料）和HIS收费项目对照.123.2正常业务流转..143.3异常业务处理..153.4退费业务处理..16第四章HIS接口方案.174.1高值耗材与HIS系统接口.174.2接口说明.174.2.1HIS收费项目明细档案同步接口..174.2.2HIS科室档案同步接口.184.2.3调用WebService前登录HRP接口.194.2.4条形码扫描获取HIS收费项目接口..204.2.5HIS计费信息创建接口.204.2.6HIS计费信息删除接口.22导读此手册面向实施顾问以及医疗机构关键用户，旨在为实施规划、解决方案制定和落实提供指导。手册围绕产品能够解决的主要业务场景展开，并以此为依托展现产品的关键应用功能，提供业务需求与产品功能相匹配的思路。本手册包括四大部分，第一部分是对产品及其价值的概要介绍；第二部分是对有关本模块的主要业务场景、流程、以及对应的业务功能的介绍；第三部分是初始准备设置；第四部分是关于本模块功能点的重要操作，此部分未就详细条目展开，详情可查阅产品相关模块的在线帮助说明。此外，为了便于用户对整体内容加深理解，手册中对一些关键的名词进行了解释，并在附录中对一些可能需要对照查询的关键点进行了补充说明，以便用户查找对照。为突出重点，本手册定位于方案性说明，仅对产品操作中的重要控制点有所描述。若读者希望深入了解特定板块的产品应用，可结合本手册，查阅如下资料：1.《产品手册-组织管理》-----深入阐述了产品关键概念（如集团、组织、业务委托关系等）以及建模思路，是实施规划、蓝图设计的重要参考资料。2.产品帮助----针对具体功能点的关键字段、按钮操作进行详细解释，并提供关键应用示例。3.《产品手册-流程管理》-----提供关于交易类型、流程设计工具的应用指导。4.《产品手册-基础数据》-----可对手册第三部分（即初始准备设置）中的有关基础数据的理解和应用进行更详细深入地了解。3/24第一章概述1.1产品概述高值耗材接口平台，主要解决HIS系统高值耗材收费后能与HRP物流系统实现实耗实销管理；同时可解决高值耗材条码全过程跟踪问题。1.2产品价值1、HIS系统能够与HRP收费材料系统实现收费项目的同步更新；2、HIS系统能够与HRP物流系统实现高值收费耗材的实耗实销管理,即HIS系统对高值耗材实行“实耗实销”和全条码管理，科室人员根据病人手术的耗材使用情况，在HRP中进行耗材的采购入库，然后HRP系统将该耗材入库信息传送至HIS系统，收费人员在HIS系统中扫描入库耗材条码进行收费，收费成功后，HIS自动生成一笔对应的可出库信息推送到HRP系统中，根据该信息HRP再生成该高值耗材的出库信息。3、HIS系统通过接口传递收费信息到HRP系统时，需要进行异常记录和异常处理，并且异常调整后，可以再次生成对应业务数据；4、HIS退费业务处理：大致分为三种，一种HIS收费数据只传递到中间暂时未传递到HRP时；二种是HIS收费数据信息传递到了HRP系统并且进行了库存记账，但尚未进行业务结算；三种是HIS收费数据信息传递到了HRP系统并且进行了库存记账，且进行了业务结算；5、接口可以实现实时传递；4/241.3应用范围及使用必要条件1.3.1耗材接口应用范围1)此耗材接口适用于高值耗材，即耗材：收费项目N:1；2)应用于普通收费耗材，即耗材：收费项目=N：1；1.3.2接口使用必要条件1)HRP收费系统正常运行才能运行与HIS的收费项目价格接口；2)HRP物流系统的库存管理和采购管理正常运行才能运行与HIS的耗材的收费清单接口；3)HRP物流系统耗材管理的最小单元要与HIS收费的计量单位保持一致，以免发生数量上的错误；4)物流接口只限于HIS中单体收费材料；5)支持耗材:收费项目=N：1；HIS科室与HRP科室=1:1；HIS科室与HRP仓库=N：1；5/24第二章应用场景2.1高值耗材计费2.1.1场景介绍高值耗材计费业务是指患者在手术中使用了高值耗材，手术完成后由护士/医生根据患者使用耗材情况生成患者收费单的过程。一般情况下高值耗材计费都伴随着手术治疗费用、术中麻醉药品费用等其他收费项目一起执行，并且该过程一般在手术完成后执行。高值耗材计费一方面作为患者缴费的前提条件，另一方面作为科室高值耗材库存管理的出口及科室材料成本的数据来源。6/242.1.2业务流程2.1.3方案概述及关键特性该方案可使用前提为医疗接口平台中收费项目、科室档案已与HIS系统联通，并通过档案对照表，将收费项目与物料、科室档案与部门、科室档案与仓库完成了对照。该方案针对实现了条码管理的计费高值耗材，包括物资品种码、批次码、唯一码，根据计费信息生成材料出库单的需求。该方案可分为内部和外部两个需求，一个为HIS收费单据的维护功能，包括新增、修改、7/24删除、查询、审批等操作；另一个为HIS与HRP系统的交互需求，共3个Web服务接口。2.2高值耗材退费高值耗材计费业务由护士在患者手术完成后执行，对于门诊患者会携带该收费单去收费处缴费，对于住院患者直接在其住院预交金中扣除相关费用。如护士在患者缴费完成前发现患者收费单据有问题，可作废患者收费单据，开具新单，具体流程见3.1；如患者缴费后再出现极端业务情况，必须执行患者退费的情况下，需人为考虑已使用耗材的后续处理情况。为遵循科室高值耗材库存实物管理原则，建议患者退费科室材料出库不做操作。如确实需要将对应的高值材料收回，则可按如下流程如下：8/24第三章初始准备3.1HIS与HRP基础数据对照3.1.1HIS科室与HRP部门对照1)将HIS科室档案下载到HRP系统节点：在“外部接口平台”-“外部档案”-“科室档案”进行“下载”或者“刷新”；操作角色：业务管理员操作界面：9/24图-HIS科室档案下载备注：外部科室档案为接口平台公用档案，所以和HIS有关的接口涉及到科室对照的均可调用此部分内容；2)HIS科室档案与HRP系统科室档案对照节点：“高值耗材接口”-“基本档案”-“档案对照表”操作角色：业务管理员10/24操作界面：数据来源：HIS科室编码：参照“外部接口平台”-“外部档案”-“科室档案”下档案信息；科室编码：参照HRP系统部门档案；关键特性1)科室对照关系：如果HIS与HRP科室编码规则不一致，要建立科室的对应关系，并且要建立1：1的关系；11/242)科室与仓库对应(HRP物流系统中设置)，进行实耗实销的科室要建立二级库，同时要设定二级库与科室的对应关系（二级库与科室的对应关系遵循1：N的关系，科室与二级库的关系遵循1：1的关系）；3.1.2高值耗材（HRP物料）和HIS收费项目对照1)HIS收费项目下载到HRP系统节点：在“外部接口平台”-“外部档案”-“收费项目”进行“下载”或者“刷新”；收费项目为接口平台公共调用档案；收费项目依据属性不同区分为：耗材和药品；操作角色：业务管理员操作界面：12/2413/24图-HIS收费项目下载界面图2)收费项目和收费耗材对照建立收费项目编码:参照“外部接口平台”-“外部档案”-“收费项目”下档案信息；物料编码:参照HRP系统物料档案；关键特性可实现物料与收费项目N：1的对照；物料对照范围：收费耗材，物料档案财务页签下标有“是否收费”标识物料；可实现新增，进行高值耗材和收费项目的对照关系建立；实现“刷新”按钮时，自动刷新更新的“外部接口平台”-“外部档案”-“收费项目”的14/24档案；过滤条件为“收费项目”属性为“材料”的；3.2正常业务流转1)由HIS收费后，生成HIS收费单据，单据执行出库后自动扣减HRP系统材料，生成材料出库单；操作岗位：手术室录单员操作任务：1、确认患者治疗方案及相关收费；2、确认收费项目,扫描耗材条码到HIS；3、在HIS建立收费项目单据并确认；操作步骤：正常使用：HIS收费员在HIS系统收费界面进行扫码收费，HIS系统访问HRP提供的接口，根据收费项目和耗材对照关系，自动带出收费项目；录入收费项目并保存后调用HRP提供的接口将收费单传递给HRP，HRP创建HIS收费单据。处理正常的业务信息可以在功能节点：医用耗材接-高值耗材接口-HIS收费信息处查看到，执行状态=“执行成功”；备注：HIS收费单据有三种状态：一种：HIS收费数据传递到中间库表时，状态为“未执行”状态；二种：实时或者定时将中间库表收费信息传递到HRP生成材料出库单时，状态为“已执行”状态；三种：中间表生成HRP材料出库单时发生异常的数据，状态为“异常”，且单独存与“异常数据”表；15/24查询界面2)由HIS收费后，自动扣减HRP系统材料库存，生成材料出库单；执行成功后生成对应的材料出库单；3.3异常业务处理建立异常数据处理的表，当交互过程中发生异常，不能成功操作的要存在异常数据表中，并记录操作中断产生异常的原因，方便调整配置，重新处理业务异常数据查询，修正异常产生的原因，重新生成单据或者进行数据的同步；异常业务大致分为两种：16/241、耗材和收费项目未建立对照关系；2、HRP科室和HIS科室未建立对照关系；3、网络异常；4、HRP现存量不足；5、其它；“数据异常处理”界面字段信息，未执行成功的信息状态显示“执行异常”。修订信息正确后，点击“执行出库”，可以再次执行成功。3.4退费业务处理HIS系统退费,退费信息以负数的形式调用HRP接口程序，生成退库单据（根据收费记录进行退费操作，传递收费记录号到HRP系统，HRP系统根据收费记录号查找对应的高值耗材出库单据，取相应的字段生成耗材退库单）。退费业务场景存在三种情况：一种，HIS计费后不久进行退费，此时中间库表的收费信息尚未传递到HRP；则正负相抵即可；不需要传递到HRP系统；二种，HIS计费后，收费信息已传递到HRP生成了材料出库单，但尚未进行正式结算；则需要按照正常业务流程生成一张负数的材料出库单；正负相抵；三种，HIS计费后，收费信息传递到HRP系统，则与供应商进了正式结算；此种情况直接在财务账处理；17/24第四章HIS接口方案4.1高值耗材与HIS系统接口实现条码管理的高值耗材，通过患者收费单中的材料收费信息自动出库，减少高值耗材现存量。高值耗材由HRP管理，而患者计费一般都在医院的HIS系统中执行，所以为了产品可以支持上述高值耗材管理方案的落地，需利用HRP中的医疗接口平台，并在此基础上再开发三个接口，如上图红字所示。4.2接口说明4.2.1HIS收费项目明细档案同步接口接口方式：中间库（中间表名称：hstf_mid_chargetype）数据传递方向：HISHRP接口字段说明：NameCodeDataTypeLengthPrecisionPrimaryForeignKeyMandatory备注18/24主键pk_mid_chargetypeCHAR(20)20TRUEFALSETRUE业务单元编码syscodeVARCHAR2(30)30FALSEFALSEFALSE各个医院的his系统编码收费项目编码codeVARCHAR2(30)30FALSEFALSEFALSE同一个来源系统收入项目编码+名称必须唯一收费项目名称nameVARCHAR2(100)100FALSEFALSEFALSE所属收入项目编码sssrxmcodeVARCHAR2(30)30FALSEFALSEFALSE新增加字段收入项目编码所属收入项目名称sssrxmnameVARCHAR2(100)100FALSEFALSEFALSE新增加字段收入项目名称属性propertyVARCHAR2(30)30FALSEFALSEFALSE材料/药品/服务标准码名称standardnameVARCHAR2(50)50FALSEFALSEFALSE标准码编码standardcodeVARCHAR2(50)50FALSEFALSEFALSE单价unitpriceNUMBER(20,8)20,8FALSEFALSEFALSE计价单位chargeunitVARCHAR2(50)50FALSEFALSEFALSE规格型号formatVARCHAR2(50)50FALSEFALSEFALSE30个字符字段预留def1-def30VARCHAR2(100)100FALSEFALSEFALSE新增加字段10个小数字段预留def31-def40NUMBER(20,8)20,8FALSEFALSEFALSE新增加字段时间戳tsCHAR(19)19FALSEFALSEFALSE格式：yyyy-mm-ddhh24:mi:ss删除标志drNUMBER(10)10FALSEFALSEFALSEhis写入值默认为0其他说明：此接口使用前提：已启用医疗接口平台。此中间表对HIS开放insert、select权限，对HRP开放select、update权限。初始化时，将当前HIS系统中所有启用的材料收费项目插入该表中，之后，HIS已有的收费项目发生变化后需将变化的数据条目再次插入该表中，HIS有新增的收费项目，也需将新增的数据条目插入该表中。HIS可采用实时或定时（建议定时间隔不能超过半个小时）方式将变更信息同步到中间表。4.2.2HIS科室档案同步接口接口方式：中间库（中间表名称：hstf_mid_dept）19/24数据传递方向：HISHRP接口字段说明：中间表字段业务含义类型长度是否必填备注pk_mid_deptHIS科室主键CHAR(20)20Tsyscode来源系统编码（医院编码）VARCHAR2(30)30T各个医院的his系统编码（联合主键）code科室编码VARCHAR2(30)30T同一个来源系统科室编码+名称必须唯一（联合主键）name科室名称VARCHAR2(100)100T（联合主键）ts时间戳CHAR(19)19T格式：yyyy-mm-ddhh24:mi:ss，默认操作记录的当前时间dr删除标志NUMBER(10)10This写入值默认为0def1-def3030个字符字段预留VARCHAR2(100)100F预留字段def31-def4010个小数字段预留NUMBER(20,8)20,8F预留字段其他说明：此接口使用前提：已启用医疗接口平台。此中间表对HIS开放insert、select、update权限，对HRP开放select权限。初始化时，将当前HIS系统中所有启用的科室档案插入该表中，之后，HIS已有的科室信息发生变化后需将变化的数据条目同步到该表中，同步逻辑为：查询该表中是否已存在该科室（存在的含义为：来源系统编码、科室编码、科室名称完全相同），如果存在则更新该条记录，如果不存在则新增一条记录。特别说明：接口5.3、5.4、5.5的接口中涉及到的汉字，需接口调用方将汉字按照GBK的编码规则进行编码后传输，HRP会按照GBK进行解码。如果不对汉字进行编码，则会出现乱码。具体编码规则使GBK或者UTF-8，根据项目上实际设置的HRP系统编码规则为准。4.2.3调用WebService前登录HRP接口接口方式：WebService服务提供方：HRP服务调用方：HIS接口说明：wsdl：http://ip:port/uapws/restservice/url/hstf/login/输入参数：20/24{"login_user_code":"mpp",//HRP提供给HIS的HRP系统的用户名，//后面HIS同步来的收费单据的创建人、制单人"login_user_pwd":"123qwe",//密码"login_sys_code":"system"//账套登录页面选择的系统}输出参数：不需要HIS处理，带入下面的接口中即可{“result”:T/F}4.2.4条形码扫描获取HIS收费项目接口接口方式：WebService服务提供方：HRP服务调用方：HIS接口说明：wsdl:http://ip:port/uapws/restservice/url/hstf/query/输入参数：{"sourcesyscode":"rmyy",//来源系统编码"sourcesysname":"人民医院",//来源系统名称"czxdepcode":"D01",//HIS执行科室编码"vserialcode":"201711131407",//条形码"login_user_code":"mpp","login_sys_code":"system"}输出参数：参考程序输出其他说明：HRP档案与HIS档案已对接完成。已调用login接口获取token。4.2.5HIS计费信息创建接口接口方式：WebService服务提供方：HRP服务调用方：HIS接口说明：wsdl：http://ip:port/uapws/restservice/url/hstf/create/21/24输入参数：{"arrayParameterB":[{"citemcode":"001","chargebid":"111111","citemname":"%CA%D5%B7%D1%CF%EE%C4%BF01"}],"sourcesyscode":"bj","sourcesysname":"%B1%B1%BE%A9%D2%BD%D4%BA%D6%D0%BC%E4%BF%E2","pk_entryconfig":"1001AF100000000027JK","cmaterialoid":"1001AF100000000036BI","cmaterialname":"%B8%DF%D6%B5%BA%C4%B2%C4","cmaterialcode":"20180615052","cmaterialvid":"1001AF100000000036BI","czxdepcode":"001","czxdepname":"%BF%DA%C7%BB%BF%C6","vbarcode":"20180151","vserialcode":"20180151","pk_org":"0001AF10000000002VPQ","login_user_code":"ly","login_sys_code":"system","bsex":"femmale","cbedcode":"0922201","chargeid":"1","creator":"creator","cperdepcode":"D02","cpername":"patientli","czycode":"20180221001zhuyuanhao","dbirthdate":"1990-12-08","dmakedate":"2018-02-0612:22:22","imoney":3097.3,"ipirce":3097.3,"iquantity":1,"opecode":"opecode（ICD-9122）","opename":"opename","opercode":"oper","section":"section","cdoctorcode":"2018020201","cdoctorname":"Drwang","opername":"caozuoyuan",22/24"chargeno":"111111","srcbillbid":"111111","srcbillid":"111111","srcbillno":"111111","dperdate":"2018-02-0512:22:22"}输出参数：{"result":"T"}其他说明：HRP档案与HIS档案已对接完成。已调用login接口获取token。4.2.6HIS计费信息删除接口接口方式：WebService服务提供方：HRP服务调用方：HIS接口说明：wsdl：http://ip:port/uapws/restservice/url/hstf/delete/输入参数：{"srcbillbid":"111111","srcbillid":"111111","srcbillno":"111111",}输出参数：{"result":"T"}其他说明：HRP档案与HIS档案已对接完成。已调用login接口获取token。23/24
