全市临床输血管理平台

系统实施文档全市临床输血管理平台数据交换接口标准用途：通过数据接口方式实现医护工作站配血信息、用血信息、库存信息提交到全市平台上。同时医护工作站也可以获取血站发给医院的血袋信息V0.22017年3月

文档修改情况记录版本号修改状态修改日期修改摘要修改人审核人审核时间0.1新建2016-10-24配血信息、用血信息、库存信息接口规范肖泽鑫0.2增加2017-03-21获取血站发血清单肖泽鑫0.3修改2017-06-15增加配血信息、用血信息中的本地编号，以快速匹配；修改获取血站发血单出参的内容前言本接口规范的主要范围和内容如下：配血信息用血信息库存信息血站发血清单本接口规范的原则：非空字段，必须传值；可空字段，在不违反业务逻辑情况的条件下，都应尽量传值。

交叉配血数据格式交叉配血单数据格式交叉配血单字段名称数据类型长度是否必需字段说明MATCH_ID配血单编号NC16新建配血单可不传。（全市统一编号）OUTER_MATCHID第三方配血单号NC16是第三方系统配血单号，用于上传失败的统计以及快速匹配APPLY_ID申请单编号NC16是全市统一编号MATCHTIME配血时间DT15是OPT_NAME操作者姓名VC100是OPT_NO操作者工号VC20是TEST_NAME检验者姓名VC100TEST_NO检验者工号VC20APPROVER_NAME复检者姓名VC100APPROVER_NO复检者工号VC20DESCRIPTION备注VC255METHODS配血方法VC200多个配血方法以+分隔(参考配血方法字典)MAINSIDERESULT主侧VC100参考交叉配血试验字典SECSIDERESULT次侧VC100参考交叉配血试验字典ANTIRESULT抗体筛选试验结果VC100参考不规则抗体字典SELFCONTROL自身对照VC60配血记录字段名称数据类型长度是否必需字段说明BLOODBAG_ID血袋号C23是例如：9000816011199A0150V00OTHER_ID产品号C30是例如：1570155609RESULT交叉配血试验结果名称VC100参考交叉配血试验字典ANTIRESULT不规则抗体筛选结果名称VC100参考不规则抗体字典OTHERRESULT其他结果VC200FINALRESULT配血结论C1是1、相合；2、不相合DESCRIPTION备注VC200REVIEWBLOODGROUP复检血型VC2A、B、O、ABREVIEWRHBLOODGROUP复检Rh血型VC2阳性、阴性交叉配血接口说明配血单接收接口格式接口方式：WebService接口地址：http://{前置机IP}/webservice/BusinessService.asmx?wsdl方法名：CreateMatchList入参说明AUTH节点字段名称数据类型长度是否必需字段说明USERID授权帐号VC25是接口授权帐号PASSWORD授权密码VC25是MATCHLIST节点请参考配血表说明入参格式<?xmlversion="1.0"encoding="utf-8"?><MATCHS><AUTH><USERID>11</USERID><PASSWORD>123456</PASSWORD></AUTH><MATCHLIST><OUTER_MATCHID>12345678</OUTER_MATCHID><APPLY_ID>SS20161025000001</APPLY_ID><MATCHTIME>2016-10-25T10:23:23</MATCHTIME><OPT_NAME>操作者</OPT_NAME><OPT_NO>0031</OPT_NO><TEST_NAME>检验者</TEST_NAME><TEST_NO>2101</TEST_NO><APPROVER_NAME>复检者</APPROVER_NAME><APPROVER_NO>2548</APPROVER_NO><DESCRIPTION>备注</DESCRIPTION><METHODS>盐水法+卡式法</METHODS><MAINSIDERESULT>无溶血、无凝集</MAINSIDERESULT><SECSIDERESULT>无溶血、无凝集</SECSIDERESULT><ANTIRESULT>阴性</ANTIRESULT><SELFCONTROL></SELFCONTROL><MATCHRECORDS><MATCHRECORD><BLOODBAG_ID>9000816011199A0150V00</BLOODBAG_ID><OTHER_ID>1570155609</OTHER_ID><RESULT>无溶血、无凝集</RESULT><ANTIRESULT>阴性</ANTIRESULT><OTHERRESULT></OTHERRESULT><FINALRESULT>1</FINALRESULT><DESCRIPTION>备注</DESCRIPTION><REVIEWBLOODGROUP>A</REVIEWBLOODGROUP><REVIEWRHBLOODGROUP>阳性</REVIEWRHBLOODGROUP></MATCHRECORD></MATCHRECORDS></MATCHLIST></MATCHS>出参说明字段名称数据类型长度是否必需字段说明CODE返回代码String25是1:操作成功500内部错误其它：其它操作错误MSG返回信息String25是如果操作成功返回的是穿越输血平台配血单号，否则返回失败信息出参格式<?xmlversion="1.0"encoding="utf-8"?><MATCH_RESULT><CODE>1</CODE><MSG>PX20161025000001</MSG></MATCH_RESULT>用血信息数据格式用血出库信息数据格式用血出库单字段名称数据类型长度是否必需字段说明TAKEOUT_ID配血单编号NC16新建用血单可不传。（全市统一编号）OUTER_TAKEOUTID第三方出库单号NC16是第三方系统出库单号，用于上传失败的统计以及快速匹配APPLY_ID申请单编号NC16是全市统一编号TAKEOUT_TIME出库时间DT15OPT_NAME操作者姓名VC100OPT_NO操作者工号VC20DESCRIPTION备注VC255ISOPERATION是否为术中输血NC1是0、否，1、是用血记录字段名称数据类型长度是否必需字段说明BLOODBAG_ID血袋号C23是例如：9000816011199A0150V00OTHER_ID产品号C30是例如：1570155609用血记录接口说明用血记录单接收接口格式接口方式：WebService接口地址：http://{前置机IP}/webservice/BusinessService.asmx?wsdl方法名：CreateTakeout入参说明AUTH节点字段名称数据类型长度是否必需字段说明USERID授权帐号VC25是接口授权帐号PASSWORD授权密码VC25是TAKEOUT节点请参考用血表说明入参格式<?xmlversion="1.0"encoding="utf-8"?><TAKEOUTS><AUTH><USERID>11</USERID><PASSWORD>123456</PASSWORD></AUTH><TAKEOUT><OUTER_TAKEOUTID>SS20161025000001</OUTER_TAKEOUTID><APPLY_ID>SS20161025000001</APPLY_ID><TAKEOUTTIME>2016-10-25T11:23:23</TAKEOUTTIME><OPT_NAME>操作者</OPT_NAME><OPT_NO>0031</OPT_NO><DESCRIPTION>备注</DESCRIPTION><ISOPERATION>0</ISOPERATION><TAKEOUTRECORDS><TAKEOUTRECORD><BLOODBAG_ID>9000816011199A0150V00</BLOODBAG_ID><OTHER_ID>1570155609</OTHER_ID></TAKEOUTRECORD></TAKEOUTRECORDS></TAKEOUT></TAKEOUTS>出参说明字段名称数据类型长度是否必需字段说明CODE返回代码String25是1:操作成功500内部错误其它：其它操作错误MSG返回信息String25是如果操作成功返回的是穿越输血平台用血单号，否则返回失败信息出参格式<?xmlversion="1.0"encoding="utf-8"?><TAKEOUT_RESULT><CODE>1</CODE><MSG>CK20161025000001</MSG></TAKEOUT_RESULT>库存数据格式库存信息数据格式库存表字段名称数据类型长度是否必需字段说明BLOODBAG_ID血袋号C23是例如：9000816011199A0150V00OTHER_ID产品号C30是例如：1570155609库存信息接口说明库存接收接口格式接口方式：WebService接口地址：http://{前置机IP}/webservice/BusinessService.asmx?wsdl方法名：SyncStock入参说明AUTH节点字段名称数据类型长度是否必需字段说明USERID授权帐号VC25是接口授权帐号PASSWORD授权密码VC25是Stock节点请参考库存表说明入参格式<?xmlversion="1.0"encoding="utf-8"?><STOCKS><AUTH><USERID>11</USERID><PASSWORD>123456</PASSWORD></AUTH><STOCK> <STOCKITEM> <BLOODBAG_ID>9000816022199A0150V00</BLOODBAG_ID> <OTHER_ID>1570155709</OTHER_ID> </STOCKITEM> <STOCKITEM> <BLOODBAG_ID>9000816023199A0150V00</BLOODBAG_ID> <OTHER_ID>1570155809</OTHER_ID></STOCKITEM></STOCK></STOCKS>出参说明字段名称数据类型长度是否必需字段说明CODE返回代码String25是1:操作成功500内部错误其它：其它操作错误MSG返回信息String25是如果操作成功返回的是空字符串，否则返回失败信息出参格式<?xmlversion="1.0"encoding="utf-8"?><STOCK_RESULT><CODE>1</CODE><MSG></MSG></STOCK_RESULT>血站发血清单格式血站发血单数据格式血站发血单字段名称数据类型长度是否必需字段说明LIST_ID发血单号NC14是HOSPITAL_NAME医院名称VC100是TAKEOUT_TIME发血时间DT15是血站发血单明细字段名称数据类型长度是否必需字段说明OTHER_ID产品号C30是例如：1570155609BLOODBAG_ID血袋号C23是例如：9000816011199A0150V00BLOODGROUP血型VC2A、B、O、ABRHBLOODGROUPRh血型VC2阳性、阴性BLOOD_SUBTYPE血液名称VC60血液中类名称VOLUME血量N6,2UNIT单位VC2EXPIRATION失效时间DT15COLLECTTIME采血时间DT15PRODUCETIME制备时间DT15交叉配血接口说明查询血站发血单接口格式接口方式：WebService接口地址：http://{前置机IP}/webservice/BusinessService.asmx?wsdl方法名：GetBSToHosBloodList入参说明字段名称数据类型长度是否必需字段说明USERID授权帐号VC25是接口授权帐号PASSWORD授权密码VC25是LIST_ID发血单号NC14是入参格式<QUERY> <AUTH> <USERID>userID</USERID> <PASSWORD>password</PASSWORD> </AUTH> <ARGS> <LIST_ID>no</LIST_ID> </ARGS></QUERY>出参说明属性名称类型是否可空说明CODEString否返回代码1:成功返回数据；0：获取不到数据；500：内部错误MSGString否返回内部错误信息DATAXML节点否参照“血站发血单数据格式”出参格式<?xmlversion="1.0"encoding="utf-8"?><RESULT><CODE>1</CODE><MSG></MSG><DATA><LIST_ID>15326</LIST_ID><HOSPITAL_NAME>宁波市第二医院</HOSPITAL_NAME><TAKEOUT_TIME>2017-03-2116:38:00</TAKEOUT_TIME><BAGITEM> <OTHER_ID>1550239617</OTHER_ID> <BLOODBAG_ID>9001215000285A0078V00</BLOODBAG_ID> <BLOODGROUP>A</BLOODGROUP> <RHBLOODGROUP>阳性</RHBLOODGROUP> <SUBTYPENAME>普通冰冻血浆</SUBTYPENAME> <VOLUME>300</VOLUME> <UNIT>ML</UNIT> <EXPIRATION>2017-05-1000:00:00</EXPIRATION> <COLLECTTIME>2017-03-2108:00:00</COLLECTTIME>