深度預(yù)約診療服務(wù)系統(tǒng)數(shù)據(jù)接口協(xié)議V1.2(醫(yī)院)

預(yù)約診療服務(wù)系統(tǒng)數(shù)據(jù)接口協(xié)議(RTDP)版本號(hào)：1.2技術(shù)支持：北京盛源宜佳網(wǎng)絡(luò)技術(shù)服務(wù)有限公司電話哈爾濱辦事處)傳真哈爾濱辦事處)手機(jī)/p>

&目錄1.概要 12.術(shù)語(yǔ)和定義 13. 網(wǎng)絡(luò)結(jié)構(gòu) 24.連接方式 25.數(shù)據(jù)定義 35.1.請(qǐng)求科室信息 35.1.1.入口參數(shù) 35.1.2.返回記錄 35.2.請(qǐng)求醫(yī)生信息 35.2.1.入口參數(shù) 35.2.2返回記錄 45.3.請(qǐng)求排班信息 45.3.1.入口參數(shù) 45.3.2返回記錄 45.4.送交預(yù)約信息 55.4.1.入口參數(shù) 55.4.2.返回記錄 65.5.送交取消預(yù)約信息 75.5.1.入口參數(shù) 75.5.2.返回記錄 75.6.請(qǐng)求取消預(yù)約信息（可選接口） 75.6.1.入口參數(shù) 75.6.2.返回記錄 75.7.送交恢復(fù)預(yù)約信息 75.7.1.入口參數(shù) 85.7.2.返回記錄 85.8.請(qǐng)求用戶(hù)就診信息 85.8.1.入口參數(shù) 85.8.2.返回記錄 85.9.請(qǐng)求用戶(hù)退診信息 85.9.1.入口參數(shù) 95.9.2.返回記錄 95.10.請(qǐng)求用戶(hù)登記信息（可選接口） 95.10.1.入口參數(shù) 95.10.2.返回記錄 95.11.請(qǐng)求月報(bào)數(shù)據(jù)（可選接口） 105.11.1.入口參數(shù) 105.11.2.返回記錄 105.12.送交月報(bào)報(bào)表（可選接口） 105.12.1.入口參數(shù) 115.12.2.返回記錄 115.13.送交系統(tǒng)通知（可選接口） 115.13.1.入口參數(shù) 115.13.2.返回記錄 12深度預(yù)約診療服務(wù)系統(tǒng)數(shù)據(jù)接口協(xié)議V1.2第12頁(yè)1.概要本規(guī)范適用于以開(kāi)放數(shù)據(jù)接口的方式接入深度預(yù)約診療服務(wù)系統(tǒng)的醫(yī)院及其醫(yī)院信息系統(tǒng)的軟件廠商。本規(guī)范規(guī)定了預(yù)約診療服務(wù)系統(tǒng)中的醫(yī)院內(nèi)網(wǎng)前置機(jī)程序訪問(wèn)醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)的方式及其交互數(shù)據(jù)的定義。2.術(shù)語(yǔ)和定義英文縮寫(xiě)術(shù)語(yǔ)RTSS預(yù)約診療服務(wù)系統(tǒng)RTCENTER預(yù)約中心通信程序RTINNER醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序RTOUTER醫(yī)院外網(wǎng)前置機(jī)通信程序HIS醫(yī)院信息系統(tǒng)RTCP預(yù)約診療服務(wù)系統(tǒng)通信接口協(xié)議RTDP預(yù)約診療服務(wù)系統(tǒng)數(shù)據(jù)接口協(xié)議3.網(wǎng)絡(luò)結(jié)構(gòu)說(shuō)明：醫(yī)院根據(jù)RTDP接口協(xié)議編寫(xiě)相關(guān)存儲(chǔ)過(guò)程，供“醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序”調(diào)用，從而實(shí)現(xiàn)醫(yī)院內(nèi)網(wǎng)HIS系統(tǒng)與部署于醫(yī)院內(nèi)網(wǎng)的預(yù)約診療服務(wù)前置機(jī)通信程序之間的各種數(shù)據(jù)交互。醫(yī)院對(duì)內(nèi)部HIS系統(tǒng)進(jìn)行適當(dāng)改造，實(shí)現(xiàn)掛號(hào)處、導(dǎo)診臺(tái)、分診臺(tái)、醫(yī)生工作站，以及門(mén)辦、院辦等管理部門(mén)對(duì)本院預(yù)約診療服務(wù)工作的管理和操作。4.連接方式醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)建立一個(gè)特定權(quán)限賬戶(hù)，醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序通過(guò)這個(gè)賬戶(hù)，以O(shè)DBC數(shù)據(jù)源方式與醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)建立起一個(gè)連接。醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序?qū)︶t(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)的所有數(shù)據(jù)訪問(wèn)均采用此連接，此連接在醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序運(yùn)行期間始終保持。醫(yī)院內(nèi)網(wǎng)前置機(jī)通信程序?qū)︶t(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)的所有數(shù)據(jù)訪問(wèn)均采用存儲(chǔ)過(guò)程調(diào)用方式進(jìn)行，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)應(yīng)按預(yù)約診療服務(wù)系統(tǒng)與醫(yī)院信息系統(tǒng)之間需要交互的各個(gè)數(shù)據(jù)建立對(duì)應(yīng)的存儲(chǔ)過(guò)程。存儲(chǔ)過(guò)程的定義規(guī)則參照《5.數(shù)據(jù)定義》章節(jié)。5.數(shù)據(jù)定義基本數(shù)據(jù)類(lèi)型描述varchar變長(zhǎng)字符串，其長(zhǎng)度指字節(jié)數(shù)。若漢字則為雙字節(jié)。integer無(wú)符號(hào)整型數(shù)據(jù)，其長(zhǎng)度指字節(jié)數(shù)。如：長(zhǎng)度為1，則表示1－256間的數(shù)字。5.1.請(qǐng)求科室信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求所有科室信息，以保持預(yù)約診療服務(wù)系統(tǒng)與醫(yī)院信息系統(tǒng)之間的科室信息同步。注：請(qǐng)求頻率為每天１次。5.1.1.入口參數(shù)無(wú)5.1.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述DEP_IDvarchar20科室編號(hào)（必填）DEP_NAMEvarchar80科室名稱(chēng)（比填）DEP_INTROvarchar1024科室介紹（可空）5.2.請(qǐng)求醫(yī)生信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求所有醫(yī)生信息，以保持預(yù)約診療服務(wù)系統(tǒng)與醫(yī)院信息系統(tǒng)之間的醫(yī)生信息的同步。注：請(qǐng)求頻率為每天１次。5.2.1.入口參數(shù)無(wú)5.2.2返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述DOC_IDvarchar20醫(yī)生編碼（必填）DOC_NAMEvarchar80醫(yī)生姓名（必填）SEXvarchar2性別：（可空）女男DOC_DUTYvarchar80醫(yī)生級(jí)別：（可空）主任醫(yī)師副主任醫(yī)師主治醫(yī)師助理醫(yī)師普通醫(yī)師DOC_EXPERTInteger1是否專(zhuān)家：（可空）0否1是DOC_SPECvarchar300醫(yī)生擅長(zhǎng)（可空）DOC_INTROvarchar1024醫(yī)生介紹（可空）DEP_IDSvarchar200醫(yī)生所屬科室的編碼（必填）注：一個(gè)醫(yī)生可隸屬多個(gè)科室，此時(shí)各科室編碼間使用“,”分割；當(dāng)僅僅隸屬于一個(gè)科室時(shí)，即為DEP_ID。5.3.請(qǐng)求排班信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求所有醫(yī)生排班信息，以保持預(yù)約診療服務(wù)系統(tǒng)與醫(yī)院信息系統(tǒng)之間的醫(yī)生排班信息的同步。注：此排班信息為次日起7日內(nèi)的所有醫(yī)生排班信息，請(qǐng)求頻率為每天１次。5.3.1.入口參數(shù)無(wú)5.3.2返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述DOC_IDvarchar20醫(yī)生編碼（必填）DEP_IDvarchar20科室編碼（必填）DOC_EXPERTInteger1是否專(zhuān)家：（必填）0否1是DUTY_DATEvarchar8排班日期（必填）格式為:yyyymmddDUTY_CODEinteger1排班編碼（必填）1上午出診2下午出診3晚上出診10上午停診20下午停診30晚上停診DOC_REGFEEvarchar10掛號(hào)費(fèi)（可空）STOP_REASONvarchar300停診原因（可空）5.4.送交預(yù)約信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)送交用戶(hù)的預(yù)約信息，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)將此信息保存。5.4.1.入口參數(shù)字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDinteger8預(yù)約流水號(hào)（必填）由RTSS生成，每條預(yù)約信息的流水號(hào)唯一。(當(dāng)前版本該字段的實(shí)際最大數(shù)值為2147483647)USER_NAMEvarchar80用戶(hù)姓名（必填）ID_CARDvarchar30用戶(hù)證件號(hào)碼（必填）ID_CARD_TYPEinteger1用戶(hù)證件類(lèi)型（可空，為空則表示身份證）1身份證2軍官證3護(hù)照4監(jiān)護(hù)人證件(兒童)9其它證件IC_CARDvarchar30用戶(hù)就診卡卡號(hào)（可空，僅醫(yī)院要求具有此醫(yī)院就診卡的用戶(hù)方可預(yù)約時(shí)填寫(xiě)）DOC_IDvarchar20預(yù)約醫(yī)生編碼（必填）DEP_IDvarchar20預(yù)約科室編碼（必填）TIMEvarchar14預(yù)約就診時(shí)間（必填）格式為:yyyymmddhhnnssILLNESSvarchar300病情（可空）USER_GRADEinteger1用戶(hù)級(jí)別：（可空）1普通用戶(hù)2會(huì)員用戶(hù)3中級(jí)會(huì)員4高級(jí)會(huì)員USER_CARDNOvarchar20用戶(hù)預(yù)約卡卡號(hào)（可空）FZ_FLAGinteger3是否復(fù)診（必填）1初診2復(fù)診FZ_BDFLAGinteger3是否本地病人（必填）0否1是FZ_TYPEinteger3復(fù)診類(lèi)型（若為復(fù)診病人，此項(xiàng)必填）1口腔科復(fù)診2產(chǎn)前檢查3術(shù)后復(fù)查4其它科室復(fù)診DOC_EXPERTinteger3是否專(zhuān)家（必填）：0否1是ORDER_SCRvarchar1預(yù)約途徑（必填）：1網(wǎng)站2電話3WAP4短信5現(xiàn)場(chǎng)6自助ORDER_LYvarchar1預(yù)約來(lái)源（必填）：1本站2電信1143移動(dòng)125808醫(yī)院9社區(qū)SEXvarchar2用戶(hù)性別（若用戶(hù)證件類(lèi)型非身份證，則此項(xiàng)必填）：女男BIRTHDAYvarchar10出生日期（若用戶(hù)證件類(lèi)型非身份證，則此項(xiàng)必填）：格式為yyyy-mm-ddMOBILEvarchar20用戶(hù)手機(jī)（可空）5.4.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述sResultInteger4結(jié)果（必填）0:成功10:就診卡卡號(hào)不存在（可不判斷）11:證件號(hào)碼錯(cuò)誤（可不判斷）12:姓名錯(cuò)誤（可不判斷）13.科室不存在14.該科室沒(méi)有此醫(yī)生編碼15.此預(yù)約時(shí)間該醫(yī)生不出診1000:其它錯(cuò)誤5.5.送交取消預(yù)約信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)送交用戶(hù)在預(yù)約診療服務(wù)系統(tǒng)上取消預(yù)約的操作信息，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)根據(jù)此信息修改用戶(hù)的預(yù)約狀態(tài)為取消。5.5.1.入口參數(shù)字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDinteger8預(yù)約流水號(hào)（必填）注：此字段與【預(yù)約信息】中的ORDER_ID對(duì)應(yīng)。5.5.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述sResultInteger4結(jié)果（必填）0:成功20:預(yù)約流水號(hào)不存在1000:其它錯(cuò)誤5.6.請(qǐng)求取消預(yù)約信息（可選接口）醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求因?yàn)樘厥庠蛲ㄟ^(guò)醫(yī)院信息系統(tǒng)取消的用戶(hù)預(yù)約信息。注：請(qǐng)求頻率為每小時(shí)１次，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)返回當(dāng)天用戶(hù)取消數(shù)據(jù)。若醫(yī)院HIS系統(tǒng)中無(wú)現(xiàn)場(chǎng)取消預(yù)約的操作模塊，此接口可忽略。5.6.1.入口參數(shù)無(wú)5.6.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDinteger8預(yù)約流水號(hào)（必填）注：此字段與【預(yù)約信息】中的ORDER_ID對(duì)應(yīng)。5.7.送交恢復(fù)預(yù)約信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)送交用戶(hù)在預(yù)約診療服務(wù)系統(tǒng)上恢復(fù)其原來(lái)取消的預(yù)約操作信息，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)根據(jù)此信息將用戶(hù)的預(yù)約取消狀態(tài)修改為恢復(fù)狀態(tài)。5.7.1.入口參數(shù)字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDinteger8預(yù)約流水號(hào)（必填）注：此字段與【預(yù)約信息】中的ORDER_ID對(duì)應(yīng)。5.7.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述sResultInteger4結(jié)果（必填）0:成功20:預(yù)約流水號(hào)不存在1000:其它錯(cuò)誤5.8.請(qǐng)求用戶(hù)就診信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求已赴醫(yī)院就診的未失約的用戶(hù)預(yù)約信息。注：請(qǐng)求頻率為每天１次，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)返回當(dāng)天和前一天的預(yù)約用戶(hù)的就診數(shù)據(jù)。5.8.1.入口參數(shù)無(wú)5.8.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDInteger8預(yù)約流水號(hào)（必填）注：此字段與【預(yù)約信息】中的ORDER_ID對(duì)應(yīng)。TIMEvarchar14就診時(shí)間（必填）格式為:yyyymmddhhnnss5.9.請(qǐng)求用戶(hù)退診信息醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求已赴醫(yī)院就診的但因特殊原因用戶(hù)又退診的預(yù)約信息。注：請(qǐng)求頻率為每天請(qǐng)求１次，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)返回當(dāng)天和前一天的預(yù)約用戶(hù)退診數(shù)據(jù)。5.9.1.入口參數(shù)無(wú)5.9.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述ORDER_IDInteger8預(yù)約流水號(hào)（必填）注：此字段與【預(yù)約信息】中的ORDER_ID對(duì)應(yīng)。TIMEvarchar14退診時(shí)間（必填）格式為:yyyymmddhhnnss5.10.請(qǐng)求用戶(hù)登記信息（可選接口）醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求在該醫(yī)院進(jìn)行實(shí)名登記或資料修改的預(yù)約診療服務(wù)用戶(hù)信息。注：請(qǐng)求頻率為每小時(shí)請(qǐng)求１次，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)返回當(dāng)天的用戶(hù)登記信息。若醫(yī)院HIS系統(tǒng)中無(wú)預(yù)約診療服務(wù)用戶(hù)登記模塊，此接口可忽略。5.10.1.入口參數(shù)無(wú)5.10.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述USER_NAMEvarchar80用戶(hù)姓名（必填）ID_CARDvarchar30用戶(hù)證件號(hào)碼（必填）ID_CARD_TYPEinteger1用戶(hù)證件類(lèi)型（可空，為空則表示身份證）1身份證2軍官證3護(hù)照4監(jiān)護(hù)人證件(兒童)9其它證件SEXvarchar2用戶(hù)性別（若用戶(hù)證件類(lèi)型非身份證，則此項(xiàng)必填）：女男BIRTHDAYvarchar8出生日期（若用戶(hù)證件類(lèi)型非身份證，則此項(xiàng)必填）：格式為yyyy-mm-ddMOBILEvarchar20用戶(hù)手機(jī)（必填）TELEPHONEvarchar20用戶(hù)電話號(hào)碼（可空）ADDRESSvarchar80用戶(hù)通信地址（可空）POSTCODEvarchar10用戶(hù)郵編（可空）USER_IDvarchar20用戶(hù)名（可空）USER_PASSWORDvarchar20用戶(hù)密碼（可空）IDENTIFY_TYPEInteger1操作類(lèi)型：（必填）0登記1更新TIMEvarchar14登記時(shí)間（必填）格式為:yyyymmddhhnnss5.11.請(qǐng)求月報(bào)數(shù)據(jù)（可選接口）醫(yī)院內(nèi)網(wǎng)前置機(jī)程序向醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)請(qǐng)求本院上個(gè)月的預(yù)約診療服務(wù)月報(bào)數(shù)據(jù)。注：請(qǐng)求頻率為每月的1至5日請(qǐng)求１次，醫(yī)院信息系統(tǒng)數(shù)據(jù)庫(kù)返回上個(gè)月的醫(yī)院月報(bào)數(shù)據(jù)。若醫(yī)院HIS系統(tǒng)中無(wú)此數(shù)據(jù)，可由醫(yī)院預(yù)約診療服務(wù)工作人員每月手工提交至黑龍江預(yù)約掛號(hào)網(wǎng)。5.11.1.入口參數(shù)無(wú)5.11.2.返回記錄字段名數(shù)據(jù)類(lèi)型最大長(zhǎng)度描述YB_NYvarchar7月報(bào)月份（必填）格式為：yyyy-mmYB_PTHMZLinteger4普通號(hào)門(mén)診量（必填）YB_ZJHMZLinteger4專(zhuān)家號(hào)門(mén)診量（必填）YB_BDBRSinteger4本地病人數(shù)（必填）YB_KQKBRSinteger4口腔科病人數(shù)（必填）YB_CQJCBRSinteger4產(chǎn)前檢查病人數(shù)（必填）Y