东华医院信息平台解决方案-药房流程接口

1、药房流程接口文档1.概述该文档定义了 DIH 药房流程与医院 HIS 系统或其他系统之间的数据交互内容及通讯方式，需要与 DIH 药房流程进行连接的系统可参考此文档实现各自的接口定义和开发。2.接口方式说明DIH 药房流程现在支持的接口方式有：视图：由数据提供方提供数据内容，并视图内容的即时过滤（只包含特定时间段内的数据），对双方系统程序改动最小，容易实现，牺牲一些实时性的要求；中间表：由数据提供方即时向中间表是要牺牲一些实时性的要求；数据，由数据接收方中间表数据总量（删除数据），双方系统程序改动较小，也WebService：通过标准的 WebService 接口即时传递数据，双方系统程序都要

2、做较大改动，需要一些对接调试时间，需要注意异构系统之间的差异，实时性好；在实际应用中可根据实际情况采用其中一种接口方式，或几种方式混合使用，具体的使用原则是：对实时性要求比较高的接口尽量采用 Webservice，如：门诊处方数据接口，如果 HIS 需要 DIH 分配取药窗口并要求 DIH返回窗给 HIS，这个就要求接口即时返回，实时要求高，最好采用 Webservice 接口调用。调用更新数据的接口尽量不要使用视图方式。基础字典数据完全由数据提供方提供数据，接收方不会做如何改动，采用视图方式比较合适，DIH 流程的定时同步服务会定时将数据同步到 DIH中，必要时 DIH 流程可以手动触发同步

3、过程。3. 接口内容DIH 流程定义的接口包含以下几部分内容，各接口的详细说明和数据结构内容定义请参见后面的附件一、附件二中的具体描述。3.1.基础字典数据药品字典药房字典科室字典病区字典3.2.处方业务数据门诊处方门诊配药完成通知门诊患者取药通知门诊发药完成通知门诊发药窗口状态变更通知附件一. 视图/中间表1. 概述基础字典数据建议使用视图实现，业务数据建议使用中间表，可以创建在 DIH库、HIS 数据库，或其他中间数据库中。基础数据接口定义药品字典create table dictDrug (drugCodevarchar(40)not null-药品代码(最好唯一，如不唯一，请标明哪几个

4、字段可以确定唯一药品)charge_code 和 serial 共同确定一个药,drugName miniSpec miniUnit miniDose doseUnit packageSpec packageUnit packageRatio drugClass drugForm drugAttribute drugProperty drugRefrigerated drugControlled firmNamePYCodevarchar(80) varchar(40) varchar(20) double varchar(20) varchar(40) varchar(20) double

5、varchar(20) varchar(20) varchar(20) varchar(20) char(1) char(1) varchar(100) varchar(80) varchar(50) varchar(30)not not notnull null null-药品名称最小不可拆分包装规格：ml、mg 等最小不可拆分包装：片、粒、支等null default null1最小包装规格所含剂量最小包装规格所含剂量零售包装规格：2mg x 100、1mg/板 xnot not notnull null null2 等零售包装：盒、瓶等default1零售包装拆零为最小包装的转换系数药品

6、类别: 西药、中药、草药等药品剂型：片剂、针剂、胶囊等药品属性：普通、麻醉、精神等药品性质：口服、外用、注射等冷藏药品标志药品标志厂家药品查询码null null null null null nulldefault defaultNNnot null not null null null null null nullsupervi barcode sizeL sizeW sizeHCode药品码药品条码尺寸：长尺寸：宽尺寸：高,weight isEnabled updatedDT primary key(float char(1) datetimedrugCode )null-重量有效标志修

7、改时间根据 HIS 药品字典实际情况创建主键not notnull nulldefaultY);2.2. 药房字典create table dictPharmacy (pharmacyCode pharmacyName PYCode isEnabled updatedDT primary key(varchar(20) varchar(60) varchar(60) char(1) datetimenot not not not notnull null null null null-药房代码药房名称拼音代码有效标志修改时间,defaultYpharmacyCode);2.3. 科室字典cre

8、ate table dictDeptdeptCode(varchar(20) varchar(60) varchar(60) char(1) datetimedeptCode )not not not not notnull null null null null-科室代码科室名称拼音代码有效标志修改时间,deptName PYCode isEnabled updatedDT primary key(defaultY);2.4. 病区字典create table dictWardwardCode(varchar(20) varchar(60) varchar(60) char(1) datet

9、imewardCode )not not not not notnull null null null null-病区代码病区名称拼音代码有效标志修改时间,wardName PYCode isEnabled updatedDT primary key(default Y);处方业务接口定义门诊处方数据：由 HIS 向该表中处方数据，DIH 只做操作。createtable outpOrder_his (orderNo orderType windowNo outpNo visitNo groupNo patientID patientName patientPYName patientGend

10、er patientAge identity insuranceType chargeType deptCode deptName doctCode doctNamediagnosisvarchar(40) varchar(10)not null-门诊处方处方类型:取药窗,null null null null nulldefaultMM-门诊, J-, O-其他（由 DIH 分配窗口时置 0）varchar(30) varchar(30) varchar(30) varchar(30) varchar(40) varchar(40) varchar(10)门诊就诊号患者配药（报到）组号唯一编

11、码not null not null null null null null null null null null null nullnull拼音码varchar(30) varchar(40) varchar(30) varchar(20) varchar(40) varchar(20) varchar(40)varchar(200)医保类型类别就诊科室代码就诊科室名称就诊医生代码就诊医生名称临床,drugCode drugName drugSpec firmName amount takeUnit takeMethod takeType takeNote orderSort pharma

12、cyCodepaymentIPvarchar(36) varchar(80) varchar(40) varchar(100)not not not not not notnull null null null null null-药品代码药品名称药品规格厂家药品数量发药服用方法服用类型服用备注说明处理顺序药房代码电脑 IP(适用于医院有多个缴费处，且分布不同楼层，varchar(20) varchar(40) varchar(40) varchar(100)null null nullnot notnull nullvarchar(20) varchar(20)null但在同一药房取药，需要

13、根据缴费处位置增加处方分配延迟时间),paymentDT createdDT primary key(datetime datetimeorderNo, drugCode,nullnot null orderSort)-计费时间创建日期（时间戳）);3.2. 门诊配药完成通知：由 DIH 在处方配药完成时写入，叫号系统create table outpOrderReadyNotify (该信息实现叫号、上屏操作。windowNo patientID groupNo completedDT createdDT orderType primary key(varchar(10) varchar(3

14、0) varchar(30) datetime datetime varchar(30)not not notnull null null-窗患者唯一 ID患者配药组号配药完成时间创建日期（时间戳）,nullnot null nullwindowNo, patientID, groupNo);3.3. 门诊患者取药通知：在患者前来取药时由 HIS create table outpOrderTakeNotify (，DIH该信息后提示引导发药药师查找患者药篮。windowNovarchar(10)not null-窗-HIS 建中间表存患者 ID，处方号，窗,patientID groupNo

15、 createdDT orderType completedS primary key(varchar(30) varchar(30) datetime varchar(30)not null nullnot null nullnull default-患者唯一 ID患者配药组号创建日期（时间戳）-处方类型，门诊-M；-完成状态，默认 0-J；其他-Ous0windowNo, patientID, groupNo);3.4. 门诊患者发药完成通知：由 HIS 在完成患者发药操作后作。，DIH该信息完成发药后的；叫号系统该信息完成患者下屏操create tablepletionNotify va

16、rchar(30) varchar(30) datetime(,patientID groupNo createdDT completedS primary key(not null nullnot null null default-患者唯一 ID患者配药组号创建日期（时间戳）uspatientID, groupNo)0- 完成状态默认零);3.5. 门诊发药窗口状态变更通知：由 HIS 系统在发药窗口发生状态变更时create table outpWindowNotify (，DIH该信息调整配药分配路径。windowIP windowNo windowSvarchar(20) varch

17、ar(10) varchar(10) varchar(10)varchar(10) datetimenot null not null null null-窗口 ip 地址窗窗口状态：open-打开、close-关闭、pause-暂停窗口工作类型：direct-直发；indirect-预配；all-混合,uswindowType, completedS, createdDT, primary key(usnulldefault0- 完成状态默认零not null-创建日期（时间戳）windowIP );附件二. Webservice1. 概述此接口定义只包含处方业务数据部分 DIH 药房流程议

18、采用中间视图的形式。与医院 HIS 或其他系统之间的数据交互、传递，基础字典数据的接口依然建接口定义门诊处方数据接口描述：由 HIS 在适当的时机（缴费时、药房报到时）将患者待取药的处方给 DIH 药房流程，并等待 DIH返回处方接收结果。如果取药窗口由 HIS 分配，请将窗随处方一并发给 DIH 药房流程；如果由 DIH 分配取药窗口，返回的结果中会包含已分配的取药窗提供方：DIH调用方：HIS。方法：String outpOrderDispense(String xml);参数：xml 门诊处方 xml 字符串返回：xml 字符串-code：非零为错误接口返回结果内容取药窗，message

19、：结果描述22患者配药（报到）组号门诊处方 xml 字符串结构式样:自动创建）-患者信息取药窗（只在由 HIS 分配窗时有，且不能为 0）患者配药（报到）组号（只在报到机制时有用，如 HIS 没有定义，DIH 会-患者唯一 ID医保类型类别-处方处方，no：处方唯一，type：M-门诊，J-，O-其他，缴费时间：yyyy-MM-ddHH:mm:ss-号 就诊就诊科室编码就诊科室名称就诊医生编码就诊医生临床电脑 IP缴费时间：yyyy-MM-dd处方中药品HH:mm:ss-药品编码名称规格厂家-药品数量（浮点数值）发药服用方法服用类型备注说明药房编码在处方中的药品顺序号（整数值）2.2. 门诊处

20、方缴费接口描述：该接口适用于在缴费前患者处方信息已经发给 DIH药房流程的场景，由 HIS 在适当的时机（缴费时、药房报到时）将患者待取药的处方 ID并发给 DIH 药房流程提供方：DIH调用方：HIS方法：String outpOrd给 DIH 药房流程，并等待 DIH返回处方接收结果。如果取药窗口由 HIS 分配，请将窗随处方一；如果由 DIH 分配取药窗口，返回的结果中会包含已分配的取药窗。ayment(String xml);参数：xml 门诊处方缴费 xml 字符串返回：xml 字符串-code：非零为错误接口返回结果内容取药窗，message：结果描述22门诊处方缴费 xml 字符

21、串结构式样:患者配药（报到）组号- 患者信息自动创建）prescription no= type=间：yyyy-MM-dd HH:mm:ss-取药窗（只在由 HIS 分配窗时有，且不能为 0）患者配药（报到）组号（只在报到机制时有用，如 HIS 没有定义，DIH 会-患者唯一 ID-paymentDT=/处方- 处方，no：处方唯一，type：M-门诊，J-，O-其他，缴费时2.3. 门诊配药完成通知接口描述：当配药师完成患者的所有处方药品调配，将药篮放到正确的发药窗口时，由 DIH以开始叫号或等待患者前来取药。提供方：HIS调用方：DIH向 HIS 发送配药完成通知，告知 HIS 可方法：o

22、utpOrderReadyNotify(Stringxml);参数：配药完成 xml 字符串返回：0-成功，1-失败配药完成 xml 字符串结构式样：-窗患者唯一 ID患者配药组号-配药处方，id：处方2.4. 门诊患者取药通知接口描述：患者来到发药窗口，刷卡或扫描处方时，由 HIS 向 DIH 流程直发设备出药。提供方：DIH调用方：HIS方法：String outpOrderTakeNotify(String xml);参数：取药通知 xml 字符串返回：xml 字符串发送患者取药通知，引导发药药师拿取该患者药篮，或等待-code：非零为错误 接口返回结果内容 是否有直发处方标志已配好药篮数，message：结果描述false1取药通知 xml 字符串结构式样：-窗患者唯一 ID患者配药组号2.5.门诊患者发药完成通知接口描述：HIS 完成发药确认时，向 DIH提供方：DIH调用方：