金華城市用血實(shí)時(shí)聯(lián)網(wǎng)平臺(tái)接口規(guī)

范

2020年5月

目錄

目錄

1文檔介紹..........................................................................5

1.1文檔目的....................................................................5

1.2文檔范圍....................................................................5

1.3術(shù)語(yǔ)與縮寫解釋.............................................................6

2接入準(zhǔn)則........................................................................7

2.1接入指南....................................................................7

2.1.1接入環(huán)境..............................................................7

2.1.2接入拓?fù)鋱D............................................................7

2.1.3交互頻度..............................................................7

2.2請(qǐng)求結(jié)構(gòu)....................................................................8

2.2.1請(qǐng)求地址..............................................................8

2.2.2字符編碼..............................................................8

2.2.3數(shù)據(jù)類型說明..........................................................8

2.3通訊技術(shù)....................................................................9

2.3.1SOAP..................................................................................................................................9

2.3.2WSDL................................................................................................................................9

2.3.3WebService.......................................................................................................................9

2.4訪問控制....................................................................9

2.4.1獲取Token........................................................................................................................9

2.4.2使用Token........................................................................................................................9

2.5HTTP狀態(tài)碼...............................................................10

3接口規(guī)范.........................................................................11

3.1認(rèn)證接口...................................................................11

3.2獲取基礎(chǔ)數(shù)據(jù)接口..........................................................11

3.2.1獲取醫(yī)院機(jī)構(gòu)字典.....................................................11

3.2.2獲取血站機(jī)構(gòu)字典....................................................12

3.2.3獲取血液品種字典....................................................13

3.3醫(yī)院血液預(yù)訂接口..........................................................14

3.3.1提交血液預(yù)訂單.......................................................14

3.3.2取消血液預(yù)訂單.......................................................15

3.3.3根據(jù)過去一周查詢血液預(yù)訂單狀態(tài).....................................16

3.3.4根據(jù)預(yù)訂單號(hào)查詢血液預(yù)訂單詳情.....................................17

3.4血站發(fā)血交接單入庫(kù)接口....................................................19

3.4.1根據(jù)交接單號(hào)查詢血站往醫(yī)院出庫(kù)單詳情...............................19

3.4.2醫(yī)院接收確認(rèn)血站交接單..............................................21

3.5提交醫(yī)院庫(kù)存信息..........................................................21

3.5.1提交當(dāng)前庫(kù)存血袋匯總信息............................................21

3.5.2提交當(dāng)前庫(kù)存血袋明細(xì)信息...........................................23

3.6提交醫(yī)院接收血站發(fā)血入庫(kù)信息.............................................24

3.7提交醫(yī)院輸血申請(qǐng)信息......................................................25

3.8提交醫(yī)院出庫(kù)到臨床信息....................................................29

3.9提交醫(yī)院血袋報(bào)廢信息......................................................32

3.10提交醫(yī)院輸血不良反應(yīng)信息................................................33

4錯(cuò)誤響應(yīng).........................................................................35

4.1錯(cuò)誤響應(yīng)...................................................................35

4.2錯(cuò)誤響應(yīng)格式..............................................................35

4.3錯(cuò)誤碼.....................................................................35

5數(shù)據(jù)字典.........................................................................37

5.1ABO血型..................................................................37

5.2Rh(D)血型.................................................................37

5.3出入庫(kù)類型.................................................................37

5.4身份證件類型..............................................................38

5.5醫(yī)院科室代碼..............................................................38

5.6輸血目的代碼..............................................................40

5.7輸血申請(qǐng)類型..............................................................40

5.8血液失效原因..............................................................40

5.9輸血反應(yīng)類型..............................................................41

1文檔介紹

1.1文檔目的

本規(guī)范適用下穿越醫(yī)院聯(lián)網(wǎng)管理平臺(tái)與醫(yī)院相關(guān)系統(tǒng)之間、以及與各外部數(shù)據(jù)系統(tǒng)之

間的問步數(shù)據(jù)交換傳輸。規(guī)范規(guī)定了傳輸過程中系統(tǒng)結(jié)構(gòu)、協(xié)議與通訊模式。

本規(guī)范適用于通過接口實(shí)現(xiàn)從醫(yī)院輸血科系統(tǒng)把醫(yī)院臨床用血信息實(shí)時(shí)數(shù)據(jù)上報(bào)的醫(yī)

院，不適用于沒有使用輸血科系統(tǒng)的醫(yī)院。

1.2文檔范圍

本文闡述內(nèi)容僅限穿越醫(yī)院聯(lián)網(wǎng)管理平臺(tái)對(duì)接標(biāo)準(zhǔn)接口規(guī)范，對(duì)業(yè)務(wù)流程不做詳細(xì)闡述。

本文檔闡述內(nèi)容囊括矢院臨床用血信息聯(lián)網(wǎng)所需要的所有接口，醫(yī)院需要嚴(yán)格按照標(biāo)準(zhǔn)

規(guī)范進(jìn)行匹配，以保證醫(yī)院與城市用血實(shí)時(shí)聯(lián)網(wǎng)平臺(tái)的對(duì)接，實(shí)現(xiàn)全市用血信息業(yè)務(wù)數(shù)據(jù)同

步。

1.3術(shù)語(yǔ)與縮寫解釋

序號(hào)縮寫、術(shù)語(yǔ)解釋說明

HTTPBasicHTTPBasicAuthentication是一種允許客戶端提供用戶名和口

1

Authentication令為憑證的形式訪問受保護(hù)的資源

2HIS系統(tǒng)醫(yī)院信息管理系統(tǒng)簡(jiǎn)稱

3LIS系統(tǒng)實(shí)驗(yàn)室信息管理系統(tǒng)簡(jiǎn)稱

4BIS系統(tǒng)血站信息管理系統(tǒng)簡(jiǎn)稱

2接入準(zhǔn)則

2.1接入指南

血站搭建部署在衛(wèi)生專網(wǎng)開放的標(biāo)準(zhǔn)化接口，醫(yī)院通過調(diào)用標(biāo)準(zhǔn)化接口，上報(bào)臨床用血

情況等信息。從而實(shí)現(xiàn)數(shù)據(jù)的交互。

標(biāo)準(zhǔn)化接口采用HTTP/HTTPS協(xié)議，發(fā)布接口API,由各聯(lián)網(wǎng)醫(yī)院的“輸血科系統(tǒng)”單向

調(diào)用接口API,進(jìn)行數(shù)據(jù)傳輸。

2.1.1接入環(huán)境

接口程序能夠訪問：

政務(wù)網(wǎng)http://<ip>:<port>/hoslinkws/services/Hoslink?wsdl

2.1.2接入拓?fù)鋱D

2.1.3交互頻度

?數(shù)據(jù)上報(bào)

為保證信息的及時(shí)性，業(yè)務(wù)數(shù)據(jù)要求在業(yè)務(wù)發(fā)生時(shí)及時(shí)上報(bào)，當(dāng)天的庫(kù)存統(tǒng)計(jì)數(shù)據(jù)需要

在當(dāng)天晚上12點(diǎn)前上傳。

?調(diào)用控制

血液中心發(fā)血數(shù)據(jù)具有實(shí)時(shí)性，血液中心發(fā)出血液的業(yè)務(wù)完成后，醫(yī)院需通過接口獲取

發(fā)血單信息及血液制品信息。為保證接口服務(wù)的調(diào)度，接口請(qǐng)求進(jìn)行了流量控制，每個(gè)IP

每秒5次，每分鐘15次。超出請(qǐng)求控制的請(qǐng)求會(huì)被拒絕。

2.2請(qǐng)求結(jié)構(gòu)

2.2.1請(qǐng)求地址

?服務(wù)地址

WebService：

http://<ip>:<port>/hcslinkws/services/Hoslink?wsdl

?通訊協(xié)議

使用HTTP協(xié)議，支招通過HTTP5協(xié)議

2.2.2字符編碼

請(qǐng)求及返回結(jié)果都使用UTF-8字符集進(jìn)行編碼。

2.2.3數(shù)據(jù)類型說明

數(shù)據(jù)類型的描述規(guī)則見下表:

數(shù)據(jù)類型表示符描述

定長(zhǎng)字符串型字符長(zhǎng)度表示符（N）,其中N表示該字符串的長(zhǎng)度

變長(zhǎng)字符串型字符串在字段描述中定義最大長(zhǎng)度

長(zhǎng)度表示符（N,M）,其中N表示該數(shù)字的最長(zhǎng)長(zhǎng)度，包括整數(shù)位數(shù)、

數(shù)字型數(shù)字

小數(shù)點(diǎn)（算一位）、小數(shù)位數(shù)：M表示該數(shù)字的最長(zhǎng)小數(shù)位數(shù)

布爾型布爾用字符UT表示true,字符“0”表示false

日期型日期用定長(zhǎng)字符串表示，格式為YYYY-MM-dd

日期時(shí)間型日期時(shí)間用定長(zhǎng)字符串表示,格式為YYYY-MM-ddHH:mm:ss,24小時(shí)制

二進(jìn)制型二進(jìn)制二進(jìn)制數(shù)據(jù)類型，如圖象、音頻、視頻等二進(jìn)制流文件格式。

2.3通訊技術(shù)

通過適配器，客戶端連接到中心端開放的WebService,在同步傳輸技術(shù)中使用到了下

面的技術(shù)。

2.3.1SOAP

簡(jiǎn)單對(duì)象訪問協(xié)議(SimpleObjectAccessProtocol),SOAP是基于XML的簡(jiǎn)易協(xié)議，可

使應(yīng)用程序在HTTP之上進(jìn)行信息交換。或者更簡(jiǎn)單地說：SOAP是用于訪問網(wǎng)絡(luò)服務(wù)的協(xié)

議。

2.3.2WSDL

WSDL指網(wǎng)絡(luò)服務(wù)描述語(yǔ)言(WebServicesDescriptionLanguage)aWSDL是一種使用

XML編寫的文檔。這種文檔可描述某個(gè)WebService。它可規(guī)定服務(wù)的位置，以及此服務(wù)提

供的操作(或方法)。

2.3.3WebService

Web服務(wù)的出現(xiàn)定義了滿足動(dòng)態(tài)及時(shí)的業(yè)務(wù)協(xié)作所要求的基本功能和原則，而使用期間

Web不僅成為信息共享的平臺(tái)，而且成為服務(wù)共享的平臺(tái)。

2.4訪問控制

2.4.1獲取Token

系統(tǒng)會(huì)分配給每個(gè)調(diào)用接口的第三方一個(gè)客戶編號(hào)和對(duì)應(yīng)的密碼?？蛻粽{(diào)用接口時(shí)，通

過分配的客戶編號(hào)和密碼從平臺(tái)獲取Token,后面使用Token調(diào)用實(shí)際的業(yè)務(wù)接口。

如果客戶編號(hào)和密碼校驗(yàn)失敗，服務(wù)端返回HIIP401錯(cuò)誤。

2.4.2使用Token

業(yè)務(wù)接口調(diào)用需要傳入token作為第一個(gè)傳入?yún)?shù)，在業(yè)務(wù)方法參數(shù)說明不再?gòu)?fù)述

2.5HTTP狀態(tài)碼

描述

HTTP狀態(tài)碼

3接口規(guī)范

3.1認(rèn)證接口

描述根據(jù)醫(yī)院的訪問密鑰獲取訪問token,token用以調(diào)用業(yè)務(wù)接口以驗(yàn)證是否有效訪問。

方法Stringauth(strirgaccess);

參數(shù)說明Stringaccess:分配給醫(yī)院的訪問鍵值和密鑰

'，

返回值{"code":"","datc":"7msg":""}

失敗返回{"code":-999y,"data"：null,"m$g"："錯(cuò)誤信息"}

成功返回code：0;data:32位字符串(授權(quán)訪問token)：

access對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

accessKey字符串16分配給醫(yī)院的訪問鍵值

secret字符串16訪問密鑰

accessJSON樣例：

{"accessKey":"test"；,secret":"123456"}

3.2獲取基礎(chǔ)數(shù)據(jù)接口

3.2.1獲取醫(yī)院機(jī)構(gòu)字典

描述獲取平臺(tái)上所有醫(yī)院機(jī)構(gòu)字典。

方法Stringlistlnstitu:ion(Stringtoken);

參數(shù)說明Stringtoken:訪問token

返回值{"code":"","data":"","msg":巧

失敗返回{"code":-999ydata":null,"msg":"錯(cuò)誤信息"}

成功返回{"code":0,"data7institutionJSON},”msg”:嗎

institution對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

id數(shù)值16機(jī)構(gòu)ID

name字符串32機(jī)構(gòu)名稱

available數(shù)值40-無效：1-有效

返回結(jié)果institutionJSON格式:

(

"code":"0",

"data":({

"id":3,

"name":"寧德市醫(yī)院，

"available":1

})

3.2.2獲取血站機(jī)構(gòu)字典

描述獲取平臺(tái)上所有血站機(jī)構(gòu)字典，包括分血站。

方法StringlistStation(Stringtoken);

參數(shù)說明Stringtoken:訪問token

返回值{"code":"","data":"","msg":""}

失敗返回{"code"?999y,"data":null,"msg":"錯(cuò)誤信息”}

成功返回{"code":0,"data"XStation},"msg":巧

Station對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

deptld數(shù)值16機(jī)構(gòu)ID

name字符串32血站名稱

返回結(jié)果Station格式:

"msg":"查詢成功，

"code":"0",

"data"：({

"deptld":,

"name":"XX血站"

},{

"deptld":,

"name":"XX血站"

3.2.3獲取血液品種字典

描述獲取平臺(tái)上血液品種信息字典。血液預(yù)定和血站發(fā)血等信息，需要根據(jù)統(tǒng)一?血液品種來分類

數(shù)據(jù)。

方法StringlistBlood!ypc(Stringtoken);

參數(shù)說明Stringtoken:訪問token

返回值

失敗返回{"code":-999~-l,"data":null,"msg":"錯(cuò)誤信息"}

成功返回{"code":0,"data":{bloodTypeJSON},"msg":"success")

bloodType對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

id數(shù)值8血液品種id

name字符串32血液品種名稱

unit字符串4血量單位：ML-代表亳升；U-代表單位

available數(shù)值40-無效；1-有效

返回結(jié)果bloodTypeJSON樣例：

(

"code":"0",

"data":({

"id":1,

"name":"單采血小板",

"avoilablo":1

})

)

3.3醫(yī)院血液預(yù)訂接口

3.3.1提交血液預(yù)訂單

描述向血站平臺(tái)提交血液預(yù)訂單，定義所需要血液品種的血量，血型等信息

方法StringnewBooking(Stringtoken,StringbookingJSON);

參數(shù)說明Stringtoken:訪問token

StringbookingJSON:血液預(yù)訂單JSON

返回值{"code":"","data":"","msg":巧失敗返回{"code":-999~」,"data":null,"msg":"錯(cuò)誤信息"}

成功返回code：0;data:<booklnglD>平臺(tái)預(yù)訂單ID：msg:success

bookingJSON對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度是否必填屬性說明

id字符串21否預(yù)訂單號(hào)，提交后自動(dòng)生成

originalld字符串21否醫(yī)院原始預(yù)訂單號(hào)

type字符串4足預(yù)定類型：E代友緊急：N代衣常規(guī)：1'代表備血

planUseDate字符串20是計(jì)劃用血時(shí)間格式y(tǒng)yyy-MM-ddHH:nim:ss

remark字符串4否備注

bookBy字符串4是預(yù)定人姓名

status字符串8是狀態(tài)：NER'-舫建；C0NF1RM-H確認(rèn)：CANCEL-取消

stationld數(shù)值2是血站的編號(hào)參考機(jī)構(gòu)字典

BookingDetail字符串1240是預(yù)訂血液明細(xì)，參見bookingDetai】對(duì)象說明

BookingDetail對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度是否必填屬性說明

id字符串21否預(yù)訂單號(hào)，提交后自動(dòng)生成

detailld字符串21否明細(xì)號(hào)，提交后自動(dòng)生成

originalDtlld字符串21否醫(yī)院原始預(yù)訂單明細(xì)ID

bloodType數(shù)值4是血液品種類型ID,參見BloodType對(duì)象說明

bloodProduct字符串8是血液產(chǎn)品碼，參見BloodProduct對(duì)象說明

aboGroup數(shù)值2是ABO血型

rhGroup數(shù)值2是Rh(D)血型

bookVolume數(shù)值6,2是預(yù)定血量

replyVolume數(shù)值6,2否回復(fù)血量,血站審批填寫

replyStatus字符串8否回笈狀態(tài)：WAIT_AGREE待審核FULL-全部滿足：PARTIALTfS分滿

足：NONE-不滿足

Booking樣例(包含bookingDetail)：

"type":"N",

"planUseDate":"2019-08-1509:22:27",

"remark":"sdsdd",

"bookBy":"星恒123",

"BookingDetail":[{

,"bloodType":5,

"bloodProduct":

"aboGroup":2,

"rhGroup":1,

"bookvolume":2.0

}],

"stationld":2

)

3.3.2取消血液預(yù)訂單

描述向血站平臺(tái)，對(duì)已經(jīng)提交的血液偵訂單，需要撤回，不再預(yù)定

方法StringcancelBooking(Stringtoken,Stringbookingld);

參數(shù)說明Stringtoken:訪問token

Stringbookingld:血液預(yù)訂單號(hào)；使用平臺(tái)返回預(yù)訂單號(hào)，非醫(yī)院原始預(yù)定單號(hào)

返回值{"code":"","date":"","msg":""}

失敗返回{"code":-999~-l,"data":null,"msg":錯(cuò)誤信息}

,,,,,

成功返回{code：0,"data"：null,"msg":'success"}

3.3.3根據(jù)過去一周查詢血液預(yù)訂單狀態(tài)

描述查詢本醫(yī)院提交的血液預(yù)訂單的狀態(tài)，是否已經(jīng)被確認(rèn)，預(yù)訂血液是否滿足，以及被滿足的

血量，只查詢過去-?周內(nèi)的預(yù)訂單

方法StringlistRecentBooking(Stringtoken);

參數(shù)說明Stringtoken:訪問token

返回值{”code":，"data":，"msg":""}

失敗返回{"code":-999ydata":null,"msg":"錯(cuò)誤信息"}

成功返回{"code":0,"data":{booking對(duì)象數(shù)組(參見booking對(duì)象說明)},"m$g":"succes$"}

返回booking對(duì)象數(shù)組格式:

"code":"0",

"data":[

(

"id":"OD-00003",

"type":"N",

"planUseDate":"2019-09-2809:22:27",

"remark":"sdsdd'z

"bookBy":"星恒123”,

"status":"NEW",

"BookingDetail":(

(

"bloodType":5,

"bloodProduct":"123123"z

"aboGrDup":2,

rhGroup":1,

"bookVolume":2,

"replyVolume":0,

"replyStatus":"WAIT_AGREE"

)

L

"$tationld":2

},

{

"id":"OD-00001",

"type":"N",

"planUseDate":"2O19-O9-2809:22:27",

"remark":"sdsdd'/

"bookBy":"星恒123",

"status":"CANCEL"/

"BookingDetail":(

(

"bloodType":5,

"bloodProduct":"123123",

"aboGroup":2,

"rhGroup":l,

"bookVolume":2,

"replyVolume":0,

"replyStatus":"WAIT_AGREE"

)

L

"stationld":2

)

)

3.3.4根據(jù)預(yù)訂單號(hào)查詢血液預(yù)訂單詳情

描述根據(jù)與訂單號(hào)，查詢本醫(yī)院提交的血液預(yù)訂單的詳情信息

方法StringgetBookingByld(Stringtoken,Stringbookingld);

參數(shù)說明Stringtoken:訪問token

Stringbookingld:預(yù)定單號(hào)

返回值{"code":"","date":"","msg":""}

失敗返回{"code":-999~-l,"data":null,"msg":"錯(cuò)誤信息"}

成功返回{code：0;data：{booking對(duì)象(參見booking對(duì)象說明)},"msg":"success”}

Booking對(duì)象格式

"code":"0",

"data":({

"id":"OD-00003",

"type":"N",

"planUseDate":"2019-09-2809:22:27",

"remark":"sdsdd",

"bookBy":"星恒123",

"status":"NEW",

"BookingDetail":({

"bloodType":5,

"bloodProduct':"123123",

"aboGroup":2.

"rhGroup":1,

"bookvolume":2.0,

"replyVolume":0.0,

"replyStatus":"WAIT_AGREE"

}],

"stationld":2

}]

)

3.4血站發(fā)血交接單入庫(kù)接口

3.4.1根據(jù)交接單號(hào)查詢血站往醫(yī)院出庫(kù)單詳情

描述根據(jù)交接單號(hào)查詢血站往本醫(yī)院的發(fā)血交接單詳情

方法StringgetStationOutByld(Stringtoken,StringstationOutld,StringstationHospitalld);

參數(shù)說明Stringtoken:訪問token

StringstationOutld：交接單號(hào)

StringstationHospitalld：血站/分站id.參考3.2.2獲取血站機(jī)構(gòu)字典

接口

,',,,,

返回值{"code:"'7datc:"7'msg":""}

失敗返回("code":-999--l/data":null,"msg":',fi^^^")

成功返回{"code":0,"data":{StationOut對(duì)象},"msg':"success"}

StationOut對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

id字符串21交接單號(hào)

outStockTime字符串20出庫(kù)時(shí)間格式y(tǒng)yyy-\W-ddHH：mm：SS

status字符串8出庫(kù)單狀態(tài)：卜血站已出庫(kù)醫(yī)院未確認(rèn)：C-醫(yī)院已確認(rèn)

bloodBags字符串4960血袋對(duì)象數(shù)組BloodBag

BloodBag對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度屬性說明

bloodBagld字符串32血袋編號(hào)

donationld字符串18獻(xiàn)血序列號(hào)

bloodProduct字符串8血液產(chǎn)品碼，參見獲取血液產(chǎn)品接口

bloodType數(shù)值4血液品種ID,參見獲取血液品種接口

aboGroup數(shù)值2AB0血型代碼，參見《AB0血型》字典

rhGroup數(shù)值2Rh(D)血型代碼，參見《Rh(D)血型》字典

donationDate字符串20獻(xiàn)血日期格式y(tǒng)yyy-MM-ddHH:mm:ss

productionDate字符串20制備H期格式y(tǒng)yyy-MM-ddHH：mm：SS

expirationDate字符串20失效日期格式y(tǒng)yyy-MM-ddHH:nin:ss

volume數(shù)值6,2血量

unit字符串4血量單位：ML-毫升；U-單位；

bagld字符串20產(chǎn)品號(hào)血袋唯一標(biāo)識(shí)

stationOut對(duì)象格式：

{

"code":"0",

"data":({

"id":"PD-005",

"outStockTime":"2018-10-2208:58:18",

"status":"N",

"bloodBags":({

"bloodBagld":'355E",

"donationld":,355",

"bloodProduct":"E",

"bloodType":5,

"aboGroup":2.

"rhGroup":1,

"donationDate":"2018-10-0813:36:00",

"productionDate":"2018-10-0913:31:21",

"expirationDate":"2018-11-1213:36:00",

"volume":2.0,

"unit":"U",

"bagld":"355"

},{

"bloodBagld":'455E",

,'donationld":,455",

"bloodProduct":"E",

"bloodType":13,

"aboGroup":1.

"rhGroup":1,

"donationDate":"2018-10-1314:48:00",

"productionDate":"2018-10-1512:57:51",

"expirationDate":"2019-10-1314:48:00",

"volume":100.0,

"unit":"ml",

,,bagld":"355"

}]

}]

)

3.4.2醫(yī)院接收確認(rèn)血站交接單

描述通知血站聯(lián)網(wǎng)平臺(tái)，本醫(yī)院已經(jīng)確認(rèn)接收到出庫(kù)交接單數(shù)據(jù)，入庫(kù)時(shí)只操作未確認(rèn)的交接單。

方法StringconfirmStationOut(Stringtoken,StringstationOutld);

參數(shù)說明Stringtoken:訪問token：

StringstationOutld：交接單號(hào)

返回值

失敗返回{"code":-999~-l,"data":null,"msg":"錯(cuò)誤信息"}

成功返回{"code":0,"data":null,"msg":"success”}

3.5提交醫(yī)院庫(kù)存信息

3.5.1提交當(dāng)前庫(kù)存血袋匯總信息

描述往血液聯(lián)網(wǎng)平分上報(bào)本醫(yī)院當(dāng)前的庫(kù)存匯總信息，每1小時(shí)上傳?次。

方法StringpolnventorySumfStringtoken,StringinventorySumJSON);

參數(shù)說明StringinventorySumJSON:庫(kù)存匯總對(duì)象JSON;

返回值

失敗返回{,'code":-999~-l,"data、:null,"msg',:',錯(cuò)誤信息,,}

成功返回{"code":0,"data":nul「msg":""}

inventorySumJSON對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

summary字符串10240是庫(kù)存匯總數(shù)組，參見summary對(duì)象說明

summary對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

bloodType字符串4是血液品種ID,參見獲取血液品種接口

aPosVol數(shù)值6,2是當(dāng)前該血液品種A陽(yáng)性血袋總庫(kù)存血量

bPosVol數(shù)值6,2是當(dāng)前該血液品種B陽(yáng)性血袋總庫(kù)存血量

oPosVol數(shù)值6,2是當(dāng)前該血液品種0陽(yáng)性血袋總庫(kù)存血量

abPosVol數(shù)值6,2是當(dāng)前該血液品種AB陽(yáng)性血袋總庫(kù)存血量

aNegVol數(shù)值6,2是當(dāng)前該血液品種A陰性血袋總庫(kù)存血量

bNegVol數(shù)值6,2是當(dāng)前該血液品種B陰性血袋總庫(kù)存血量

oNegVol數(shù)值6,2是當(dāng)前該血液品種0陰性血袋總庫(kù)存血量

abNegVol數(shù)值6,2是當(dāng)前該血液品種AB陰性血袋總庫(kù)存血量

unit字符串4是血量單位：ML-磋升：U-單位

InventorySum對(duì)象格式：

(

"summary":[{

"bloodType":1,

"aPosVol":0,

"bPosVol":1,

"oPosVol":0,

"abPosVol":0,

"aNegVol":0,

"bNegVol":0,

"oNegVol":0,

"abNegVol":0,

"unit":"ml"

})

)

3.5.2提交當(dāng)前庫(kù)存血袋明細(xì)信息

描述往血液聯(lián)網(wǎng)平臺(tái)上報(bào)本醫(yī)院當(dāng)前的庫(kù)存明細(xì)信息，每1小時(shí)上傳一次。

方法StringpolnventoryBldfStringtoken,StringinventoryBldJSON);

參數(shù)說明StringinventoryBldJSON:庫(kù)存明細(xì)對(duì)象JSON;

返回值{"code":"","data":"","msg":""}

失敗返回{"code":-999~-l,"data":null,"msg":"錯(cuò)誤信息"}

成功返回{"8de":0,"data":nul「ms”"}

inventoryBldJSON對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

currcntDatc字符中11是當(dāng)前日期格式y(tǒng)yyy-MM-dd

bloodBags字符串102400是庫(kù)存血袋數(shù)組，參見bloodBag對(duì)象說明

InventoryBld對(duì)象格式:

"currentDate":"2017-01-C1",

"bloodBags":[{

"bloodBagld":"201C",

"donationld":"200",

"bloodProduct":"D"..

"bloodType":13,

"aboGroup',:0,

"rhGroup":1,

"donationDate":"2018-08-1015:45:00",

"productionDate":"2018-08-1010:04:32",

"expirationDate":"2018-08-1015:45:00",

"volume":225.0,

"unit":"ml",

"bagld":"025"

}]

)

3.6提交醫(yī)院接收血站發(fā)血入庫(kù)信息

描述往血液聯(lián)網(wǎng)平臺(tái)上報(bào)本醫(yī)院接收血站發(fā)血入庫(kù)的血液信息，實(shí)時(shí)上傳數(shù)據(jù)。

方法StringpolnStock(Stringtoken,StringinStockJSON);

參數(shù)說明StringinStockJSON:血液入庫(kù)對(duì)象JSON;

返回值

失敗返回{"code":-999ydata":null,"msg":"錯(cuò)誤信息"}

,

fi￡lbig0{"code":O；data":null,"msg":"success")

inStockJSON對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

id字符串21是入庫(kù)單號(hào)

stationld字符串16是血站機(jī)構(gòu)編號(hào)（默認(rèn)傳2,如果是分血站請(qǐng)傳相應(yīng)分站

機(jī)構(gòu)id）

outStockld字符串21是血站發(fā)血交接單號(hào)

inStockDate字符串20是入庫(kù)時(shí)間格式y(tǒng)yyy-MM-ddHH：mm：SS

inStockBy字符串16是入庫(kù)人姓名

bloodBags字符串12100是入庫(kù)血袋數(shù)組，參見bloodBag對(duì)象說明

InStockJSON對(duì)象格式:

(

"id":"2333",

"stationld":2,

"outStockld":"233",

"inStockDate":"2018-01-0100:00:00",

"inStockBy":"王小二，

"remark":

"bloodBags":[{

"bloodBagld":"201C",

"donationld":"200",

"hloodProduct":"D"..

"bloodType":13,

"aboGroup":1,

"rhGroup":1,

"donationDate":"2018-08-1015:45:00",

"productionDate":"2018-08-1010:04:32",

"expirationDate":"2018-08-1015:45:00",

"volume":225.0,

"unit":"ml",

"bagld":"200"

}]

)

3.7提交醫(yī)院輸血申請(qǐng)信息

描述往血液聯(lián)網(wǎng)平臺(tái)上報(bào)輸血申請(qǐng)信息，實(shí)時(shí)上傳數(shù)據(jù)。

方法StringpoApplication(Stringtoken,Stringapplication);

參數(shù)說明Stringtoken:訪問token;

Stringapplication:輸血申請(qǐng)對(duì)象JSON;

返回值{"code":"","data":"","msg":""}

失敗返回{"code":-999~-l,"data":null,"msg":"錯(cuò)誤信息"}

成功返回{"code":0,"data":null,"msg":"success”}

application對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

id字符串21是申請(qǐng)單號(hào)

applyDate字符串20是申請(qǐng)日期格式y(tǒng)yyy-MM-ddHH:mm:ss

applyBy字符串16是申請(qǐng)醫(yī)師姓名

approveDate字符串20是審批H期格式y(tǒng)yyy-MM-ddHH:mm:ss

approveBy字符串16是審批醫(yī)師姓名

applyType數(shù)字4是輸血申請(qǐng)類型代碼，參見《輸血申請(qǐng)類型》字典

planDate字符串20否預(yù)約輸血日期格式y(tǒng)yyy-MM-ddHH:mm:ss

transPurpose字符串4是輸血目的代碼，參見《輸血目的》字典

isConscntSigncd字符串1是是否已簽輸血知情同意書0-＞否1-＞同意

patient字符串480是病人病案信息，參見patient對(duì)象說明

bloodTest字符串480否病人輸血指征，參見bloodTest對(duì)象說明

applyBloods字符串1240是申請(qǐng)血液數(shù)組，參見applyBlood對(duì)象說明

bloodTest對(duì)象說明

屬性名數(shù)據(jù)類型長(zhǎng)度必填屬性說明

hbsag字符串10否Hbsag指標(biāo)NEGATIVE-陰性P0STIVE-陽(yáng)性

antiHbs字符串10否antihbs指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

hbeag字符串10否Hbeag指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

antiHbe字符串10否anti_hbe指標(biāo)NEGATIVE-陰性P0STIVE-陽(yáng)性

antiHbc字符串10否anti_hbc指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

antiHcv字符串10否anti.hcv指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

antiHiv字符串10否anti.hiv指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

syphilis字符串10否Syphilis指標(biāo)NEGATIVE-陰性POSTIVE-陽(yáng)性

HB數(shù)值6,2否