【正文】 數(shù)據(jù)采集器客戶端接口V3中信21世紀(jì)有限公司38 / 38目 錄1 簡(jiǎn)介 3 目的 3 范圍 32 整體說(shuō)明 3 名詞解釋 3 藥監(jiān)碼模型 3 文件說(shuō)明 3 角色定義 4 企業(yè)客戶端 4 往來(lái)單位 4 委托客戶（第三方物流專用） 43 功能需求 4 業(yè)務(wù)功能需求 4 主要功能 4 補(bǔ)充功能 10 系統(tǒng)功能需求 13 數(shù)據(jù)通訊 13 系統(tǒng)設(shè)置 15 數(shù)據(jù)刪除 184 數(shù)據(jù)下載接口 18 終端操作員數(shù)據(jù)下載接口 18 上游企業(yè)出庫(kù)數(shù)據(jù)下載接口 19 往來(lái)單位列表下載接口（第三方物流PDA專用） 20 委托客戶列表下載接口（第三方物流PDA專用） 20 藥品產(chǎn)品編碼信息下載接口（第三方物流PDA專用） 215 業(yè)務(wù)數(shù)據(jù)上傳接口 22 接口規(guī)范 22 XML Schema規(guī)范 23 XML Schema規(guī)范中基礎(chǔ)數(shù)據(jù)屬性表 31 接口示例 326 文件傳輸規(guī)范 39 文件大小 39 文件拆分 391 簡(jiǎn)介 目的本文檔的目的是分析藥監(jiān)項(xiàng)目中企業(yè)出入庫(kù)（核準(zhǔn)、核銷）數(shù)據(jù)與中國(guó)藥監(jiān)網(wǎng)平臺(tái)交互的文件接口的需求，滿足企業(yè)入庫(kù)核注、出庫(kù)核銷操作的條碼數(shù)據(jù)采集和數(shù)據(jù)上傳的要求。 范圍 掃描終端范圍支持任何可掃描藥監(jiān)碼的設(shè)備 適用企業(yè)范圍本文檔適用企業(yè)包括生產(chǎn)企業(yè)、經(jīng)營(yíng)企業(yè)、第三方物流企業(yè)。2 整體說(shuō)明 名詞解釋中國(guó)藥品電子監(jiān)管碼：最小銷售單元（包裝）的藥監(jiān)碼包裝藥監(jiān)碼：外包裝（中包裝以上）的藥監(jiān)碼包裝級(jí)別：1級(jí)為最低級(jí)藥監(jiān)碼，即產(chǎn)品藥監(jiān)碼；2級(jí)為1級(jí)的上級(jí)包裝碼，依次類推。 藥監(jiān)碼模型藥監(jiān)碼采用十六或二十位數(shù)字構(gòu)成，采用Code 128C條碼標(biāo)識(shí)。 文件說(shuō)明企業(yè)按此規(guī)范要求提交文件到中國(guó)藥監(jiān)網(wǎng)平臺(tái)。對(duì)于文件的產(chǎn)生機(jī)制，企業(yè)根據(jù)自身情況實(shí)現(xiàn)。此規(guī)范只涉及以下幾類文件：平臺(tái)下載到企業(yè)n 上游企業(yè)出庫(kù)數(shù)據(jù)文件n 往來(lái)單位列表文件n 委托客戶列表文件n 藥品基本信息文件n 操作員信息文件企業(yè)上傳到平臺(tái)n 業(yè)務(wù)數(shù)據(jù)文件 角色定義 企業(yè)客戶端部署在企業(yè)，負(fù)責(zé)運(yùn)行出入庫(kù)系統(tǒng)。根據(jù)用戶輸入生成企業(yè)入庫(kù)單和企業(yè)出庫(kù)單，并將手持終端下載到PC的數(shù)據(jù)文件(.XML)保存到本地，加密后上傳到藥監(jiān)網(wǎng)平臺(tái)。支持企業(yè)入庫(kù)單和企業(yè)出貨單查詢，帶有用戶系統(tǒng)。 往來(lái)單位與企業(yè)發(fā)生往來(lái)業(yè)務(wù)關(guān)系的單位 委托客戶（第三方物流專用）指委托第三方物流進(jìn)行倉(cāng)儲(chǔ)、藥品配送的客戶，一般是藥品生產(chǎn)企業(yè)。3 功能需求 業(yè)務(wù)功能需求業(yè)務(wù)功能分為三種：主功能、補(bǔ)充功能主功能：系統(tǒng)核心功能。補(bǔ)充功能，輔助性功能。 主要功能 核注入庫(kù)功能描述：該功能用于企業(yè)入庫(kù)核注。入庫(kù)操作時(shí)，用戶需首先需要選擇入庫(kù)種類（生產(chǎn)入庫(kù)、退貨入庫(kù)、購(gòu)買入庫(kù)、調(diào)撥入庫(kù)）。如果用戶選擇退貨入庫(kù)、購(gòu)買入庫(kù)和調(diào)撥入庫(kù)、且用戶下載了上游企業(yè)的出庫(kù)信息用來(lái)做入庫(kù)數(shù)據(jù)對(duì)比。則用戶首先需要掃描一個(gè)入庫(kù)的藥監(jiān)碼，終端根據(jù)該藥監(jiān)碼顯示該藥品的上游企業(yè)名稱、藥品名稱和生產(chǎn)批號(hào)。并將該藥品的出庫(kù)單作為當(dāng)前的上游企業(yè)出庫(kù)單號(hào)，然后進(jìn)行第3步操作。如果對(duì)比藥監(jiān)碼，沒(méi)有發(fā)現(xiàn)任何匹配的上游企業(yè)出庫(kù)單，則提示用戶是否繼續(xù)入庫(kù)，如果用戶選擇“確認(rèn)”，則直接執(zhí)行第3，如果用戶選擇“取消“，則重復(fù)第2步 。如果用戶未下載上游企業(yè)出庫(kù)數(shù)據(jù)，則直接進(jìn)行第3步操作。輸入企業(yè)入庫(kù)單號(hào)，之后根據(jù)系統(tǒng)設(shè)置該功能是否有附加功能，如果有，則輸入附加功能所需關(guān)鍵數(shù)據(jù)，然后開(kāi)始掃描藥監(jiān)碼，掃描中，關(guān)鍵數(shù)據(jù)出現(xiàn)變更時(shí)，如生產(chǎn)日期變更，則需要重新輸入，然后繼續(xù)掃描。為了防止用戶輸入錯(cuò)誤的單號(hào)，系統(tǒng)要增加一次校驗(yàn)，當(dāng)?shù)谝淮屋斎氪_認(rèn)后提示“請(qǐng)?jiān)俅屋斎肴霂?kù)單號(hào)”，如果兩次輸入相同則進(jìn)行后續(xù)操作，如果不同，則提示“兩次輸入的單號(hào)不一致，請(qǐng)重新輸入”，用戶按確認(rèn)后回到該步驟起始處繼續(xù)輸入單號(hào)；如果兩次輸入相同，則判斷輸入的入庫(kù)單號(hào)在終端的入庫(kù)單數(shù)據(jù)庫(kù)中是否已存在，如果存在則提示用戶“ xx:xx執(zhí)行了入庫(kù)掃描”，同時(shí)給出兩個(gè)選項(xiàng)“重新輸入”（默認(rèn)）和“追加掃描”，如果選擇重新輸入則回到該步驟起始處，如果選擇追加掃描則進(jìn)行后續(xù)操作。注：追加掃描操作的意思是指一個(gè)單子的貨物分多次掃描。 xx:xx為時(shí)間格式，該時(shí)間為該單號(hào)起初掃描第一個(gè)碼的時(shí)間設(shè)置藥品類型。 藥品類型包括：普藥類型、特藥類型、混合類型，系統(tǒng)自動(dòng)讀取設(shè)置中的藥品類型； 系統(tǒng)設(shè)置為普藥類型，則當(dāng)前藥品類型為普藥類型，系統(tǒng)設(shè)置為特藥類型，則當(dāng)前藥品類型為特藥類型，系統(tǒng)設(shè)置為混合類型時(shí)，用戶需再次選擇藥品類型（普藥類型、特藥類型）。 為滿足一單據(jù)中僅包含一種藥品類型的需求，掃描過(guò)程中需校驗(yàn)藥監(jiān)碼是否匹配藥品類型，如不匹配，則提示用戶：“該碼不符合當(dāng)前藥品類型，請(qǐng)重新掃描”，如匹配則繼續(xù)掃描。（） ：校驗(yàn)藥監(jiān)碼類型時(shí)，可以根據(jù)碼長(zhǎng)度以及編碼規(guī)則判斷。 碼長(zhǎng)度—普藥碼長(zhǎng)度均為20位；特藥包含120位兩種長(zhǎng)度 標(biāo)志位普藥：藥監(jiān)碼前兩位為標(biāo)志位80或81或82或83或84或85或88；特藥：16位特藥藥監(jiān)碼第一位為標(biāo)志位—1；20位特藥藥監(jiān)碼前兩位為標(biāo)志位89 掃描時(shí)，如果用戶執(zhí)行了第二步，則需要根據(jù)掃描的藥監(jiān)碼查找對(duì)比數(shù)據(jù)，并顯示該碼所代表的藥品名稱、生產(chǎn)批號(hào)、生產(chǎn)日期。對(duì)比中，發(fā)現(xiàn)錯(cuò)誤提示如下：a) 掃描的碼屬于上游企業(yè)出庫(kù)的藥監(jiān)碼，但是該碼不在當(dāng)前的出庫(kù)單內(nèi)。則提示用戶掃描“該碼屬于其他出庫(kù)單”，并提示用戶跳過(guò)該碼。b) 掃描的碼不屬于上游企業(yè)出庫(kù)的藥監(jiān)碼，則提示用戶“該碼不屬于任何出庫(kù)單”，并提示用戶強(qiáng)制輸入或者重新掃描。同時(shí)，強(qiáng)制入庫(kù)的藥監(jiān)碼需要在上傳數(shù)據(jù)時(shí)做出標(biāo)記。用戶如選擇結(jié)束本次入庫(kù)掃描。則返回輸入企業(yè)入庫(kù)單號(hào)界面。掃描完成后，軟件需要顯示此次掃描多少產(chǎn)品，表示本次入庫(kù)完成。每次掃描的藥監(jiān)碼軟件需判斷該藥監(jiān)碼是否已經(jīng)掃描過(guò)。如掃描過(guò)則報(bào)重碼錯(cuò)誤，用戶確認(rèn)后返回掃描界面繼續(xù)掃描。重碼判斷在相同功能內(nèi)判斷，如生產(chǎn)入庫(kù)，則在所有入庫(kù)掃描的碼中判斷，入庫(kù)掃描后，如果做出庫(kù)掃描，則不算重碼。每次掃描藥監(jiān)碼時(shí)，系統(tǒng)需要檢查剩余藥監(jiān)碼容量，當(dāng)容量小于設(shè)定閥值時(shí)，需要報(bào)警。每次掃描藥監(jiān)碼時(shí)，系統(tǒng)需要判斷掃描進(jìn)入的藥監(jiān)碼長(zhǎng)度是否等于16位或20位數(shù)字，如果不為其中一種情況，則提示用戶掃描錯(cuò)誤，并重新掃描。高端PDA專用需求：（第三方物流專用） 物流企業(yè)輸入出庫(kù)單號(hào)時(shí)，系統(tǒng)需要顯示出當(dāng)前委托客戶名稱。如企業(yè)未設(shè)定當(dāng)前委托客戶，需要求企業(yè)輸入當(dāng)前委托客戶。輸入方式包括：檢索方式，可通過(guò)客戶名稱、名稱拼音簡(jiǎn)寫(xiě)進(jìn)行模糊檢索；可手工或者掃描輸入委托客戶的唯一編碼，系統(tǒng)自動(dòng)檢索并進(jìn)行填寫(xiě)。前置條件：無(wú)后置條件：入庫(kù)數(shù)據(jù)導(dǎo)出到企業(yè)客戶端。關(guān)鍵數(shù)據(jù)：入庫(kù)種類、企業(yè)入庫(kù)單編號(hào)、藥監(jiān)碼、操作員編號(hào)、掃描時(shí)間、系統(tǒng)設(shè)置附加功能所需關(guān)鍵數(shù)據(jù)、上游企業(yè)出庫(kù)數(shù)據(jù)。業(yè)務(wù)流程： 核銷出庫(kù)功能描述：核銷出庫(kù)功能基本相同核注入庫(kù)。區(qū)別在于用戶首先需要選擇出庫(kù)種類（銷售出庫(kù)、退貨出庫(kù)、殘次品返工出庫(kù)、調(diào)撥出庫(kù)、銷毀出庫(kù)），然后輸入的是企業(yè)的出貨單號(hào)。沒(méi)有上游企業(yè)對(duì)比功能。 重碼判斷、系統(tǒng)容量判斷、碼長(zhǎng)度判斷同樣包括在該功能內(nèi)（該功能不在流程圖中列出）。高端PDA專用需求：（增值服務(wù)、第三方物流專用） 企業(yè)輸入出庫(kù)單號(hào)時(shí)，系統(tǒng)提供其輸入收貨方功能。用戶可在其往來(lái)單位列表中通過(guò)模糊檢索輸入收貨方。檢索條件：收貨方名稱關(guān)鍵字，收貨方名稱拼音頭字母簡(jiǎn)寫(xiě)。也可輸入或者掃描收貨方唯一編碼，系統(tǒng)自動(dòng)檢索并進(jìn)行輸入。 企業(yè)輸入收貨方后，系統(tǒng)須將該收貨方編號(hào)記錄，并寫(xiě)入上傳業(yè)務(wù)數(shù)據(jù)中，具體位置和格式參加業(yè)務(wù)數(shù)據(jù)上傳接口。 如企業(yè)未導(dǎo)入往來(lái)單位列表，該字段可為空，等同于通用核銷出庫(kù)流程。高端PDA專用需求：（第三方物流專用） 物流企業(yè)輸入出庫(kù)單號(hào)時(shí)，系統(tǒng)需要顯示出當(dāng)前委托客戶名稱。如企業(yè)未設(shè)定當(dāng)前委托客戶，需要求企業(yè)輸入當(dāng)前委托客戶。輸入方式包括：檢索方式，可通過(guò)客戶名稱、名稱拼音簡(jiǎn)寫(xiě)進(jìn)行模糊檢索；可手工或者掃描輸入委托客戶的唯一編碼，系統(tǒng)自動(dòng)檢索并進(jìn)行填寫(xiě)。前置條件：無(wú)；關(guān)鍵數(shù)據(jù)：企業(yè)出貨單編號(hào)、藥監(jiān)碼、操作員編號(hào)、掃描時(shí)間、系統(tǒng)設(shè)置附加功能所需關(guān)鍵數(shù)據(jù)。后置條件：出庫(kù)數(shù)據(jù)上傳到PC客戶端。業(yè)務(wù)流程圖：輸入企業(yè)出庫(kù)單號(hào)步驟：為了防止用戶輸入錯(cuò)誤的單號(hào)，在輸入單號(hào)后系統(tǒng)要增加一次校驗(yàn)，當(dāng)?shù)谝淮屋斎氪_認(rèn)后提示“請(qǐng)?jiān)俅屋斎氤鰩?kù)單號(hào)”，如果兩次輸入相同則進(jìn)行后續(xù)操作，如果不同，則提示“兩次輸入的單號(hào)不一致，請(qǐng)重新輸入”，用戶按確認(rèn)后回到該步驟起始處繼續(xù)輸入單號(hào)；如果兩次輸入相同，則判斷輸入的出庫(kù)單號(hào)在終端的出庫(kù)單數(shù)據(jù)庫(kù)中是否已存在，如果存在則提示用戶“ xx:xx執(zhí)行了出庫(kù)掃描”，同時(shí)給出兩個(gè)選項(xiàng)“重新輸入”（默認(rèn)）和“追加掃描”，如果選擇重新輸入則回到該步驟起始處，如果選擇追加掃描則進(jìn)行后續(xù)操作。追加掃描操作的意思是指一個(gè)單號(hào)的貨物分多次掃描。注：追加掃描操作的意思是指一個(gè)單子的貨物分多次掃描。 xx:xx為時(shí)間格式，該時(shí)間為該單號(hào)起初掃描第一個(gè)碼的時(shí)間設(shè)置藥品類型。 藥品類型包括：普藥類型、特藥類型、混合類型，系統(tǒng)自動(dòng)讀取設(shè)置中的藥品類型； 系統(tǒng)設(shè)置為普藥類型，則當(dāng)前藥品類型為普藥類型，系統(tǒng)設(shè)置為特藥類型，則當(dāng)前藥品類型為特藥類型，系統(tǒng)設(shè)置為混合類型時(shí)，用戶需再次選擇藥品類型（普藥類型、特藥類型）。 為滿足一單據(jù)中僅包含一種藥品類型的需求，掃描過(guò)程中需校驗(yàn)藥監(jiān)碼是否匹配藥品類型，如不匹配，則提示用戶：“該碼不符合當(dāng)前藥品類型，請(qǐng)重新掃描”，如匹配則繼續(xù)掃描。（見(jiàn)校驗(yàn)規(guī)則）校驗(yàn)規(guī)則：校驗(yàn)藥監(jiān)碼類型時(shí)，可以根據(jù)碼長(zhǎng)度以及編碼規(guī)則判斷。 碼長(zhǎng)度—普藥碼長(zhǎng)度均為20位；特藥包含120位兩種長(zhǎng)度 標(biāo)志位普藥：藥監(jiān)碼前兩位為標(biāo)志位80或81或82或83或84或85或88；特藥：16位特藥藥監(jiān)碼第一位為標(biāo)志位—1；20位特藥藥監(jiān)碼前兩位為標(biāo)志位89 補(bǔ)充功能 用戶登陸功能描述：該功能用于操作員在終端登陸。用戶信息從用戶檔案文件中讀取，獲得該操作員的編號(hào)。關(guān)鍵數(shù)據(jù)：用戶名、密碼業(yè)務(wù)流程圖： 庫(kù)存盤(pán)點(diǎn)功能描述：該功能用于企業(yè)盤(pán)點(diǎn)庫(kù)存數(shù)據(jù)。操作員盤(pán)點(diǎn)前，需要首先輸入盤(pán)點(diǎn)任務(wù)的編號(hào)（該編號(hào)可從企業(yè)客戶端處通過(guò)建立盤(pán)點(diǎn)任務(wù)獲得），然后通過(guò)掃描藥監(jiān)碼進(jìn)行盤(pán)點(diǎn)操作。盤(pán)點(diǎn)結(jié)束后，需要顯示本次盤(pán)點(diǎn)掃描的藥監(jiān)碼數(shù)量。 重碼判斷、系統(tǒng)容量判斷、碼長(zhǎng)度判斷同樣包括在該功能內(nèi)（該功能不在流程圖中列出）。關(guān)鍵數(shù)據(jù)：盤(pán)點(diǎn)任務(wù)編號(hào)、藥監(jiān)碼、盤(pán)點(diǎn)數(shù)量業(yè)務(wù)流程圖： 藥監(jiān)碼替換功能描述：該功能用于發(fā)生藥監(jiān)碼損壞的情況下，將損壞碼用中性碼替換。該功能要求損壞藥監(jiān)碼最少可人工識(shí)讀，如果損壞藥監(jiān)碼不可識(shí)讀，則需要使用關(guān)聯(lián)關(guān)系變更功能。替換藥監(jiān)碼時(shí)，首先提示用戶輸入損壞的藥監(jiān)碼，然后輸入替換的中性碼。 重碼判斷、系統(tǒng)容量判斷、碼長(zhǎng)度判斷同樣包括在該功能內(nèi)（該功能不在流程圖中列出）。關(guān)鍵數(shù)據(jù)：損壞藥監(jiān)碼、替換中性碼、操作人前置條件：損壞藥監(jiān)碼可人工識(shí)讀后置條件：數(shù)據(jù)上傳企業(yè)客戶端。數(shù)據(jù)刪除業(yè)務(wù)流程圖： 藥監(jiān)碼注銷功能描述：該功能用于企業(yè)注銷藥監(jiān)碼使用。用戶使用此功能時(shí)，提示用戶輸入注銷的藥監(jiān)碼，用戶可循環(huán)輸入，直到手工選擇結(jié)束為止。 重碼判斷、系統(tǒng)容量判斷、碼長(zhǎng)度判斷同樣包括在該功能內(nèi)（該功能不在流程圖中列出）。關(guān)鍵數(shù)據(jù)：注銷藥監(jiān)碼，操作人業(yè)務(wù)流程圖： 系統(tǒng)功能需求 數(shù)據(jù)通訊 終端操作員數(shù)據(jù)下載功能描述：該功能用于下載用戶檔案基礎(chǔ)數(shù)據(jù)，實(shí)現(xiàn)數(shù)據(jù)同步。下載時(shí)，由企業(yè)客戶端在指定目錄生成TXT文件，再由終端讀取該文件并解析。下載文件后，軟件自動(dòng)更新現(xiàn)有檔案文件。關(guān)鍵數(shù)據(jù)：用戶檔案文件（操作員姓名、編號(hào)、密碼） 上游企業(yè)出庫(kù)數(shù)據(jù)下載功能描述： 該功能用于從企業(yè)客戶端上下載上游企業(yè)的出庫(kù)數(shù)據(jù)使用。該數(shù)據(jù)下載后，企業(yè)在做入庫(kù)時(shí)，需要先跟下載的上游企業(yè)出庫(kù)數(shù)據(jù)進(jìn)行對(duì)比，如果發(fā)現(xiàn)錯(cuò)誤需要提示。 下載接口定