某公司數(shù)據(jù)采集器客戶端接口

1、數(shù)據(jù)采集器客戶端接口V3中信21世紀(jì)有限公司目 錄1 簡(jiǎn)介31.1 目的31.2 范圍32 整體說(shuō)明32.1 名詞解釋32.2 藥監(jiān)碼模型32.3 文件說(shuō)明32.4 角色定義42.4.1 企業(yè)客戶端42.4.2 往來(lái)單位42.4.3 委托客戶（第三方物流專用）43 功能需求43.1 業(yè)務(wù)功能需求43.1.1 主要功能43.1.2 補(bǔ)充功能103.2 系統(tǒng)功能需求133.2.1 數(shù)據(jù)通訊133.2.2 系統(tǒng)設(shè)置153.2.3 數(shù)據(jù)刪除184 數(shù)據(jù)下載接口184.1 終端操作員數(shù)據(jù)下載接口184.2 上游企業(yè)出庫(kù)數(shù)據(jù)下載接口194.3 往來(lái)單位列表下載接口（第三方物流PDA專用）204.4 委托客

2、戶列表下載接口（第三方物流PDA專用）204.5 藥品產(chǎn)品編碼信息下載接口（第三方物流PDA專用）215 業(yè)務(wù)數(shù)據(jù)上傳接口225.1 接口規(guī)范225.1.1 XML Schema規(guī)范235.1.2 XML Schema規(guī)范中基礎(chǔ)數(shù)據(jù)屬性表315.2 接口示例326 文件傳輸規(guī)范396.1 文件大小396.2 文件拆分391 簡(jiǎn)介1.1 目的本文檔的目的是分析藥監(jiān)項(xiàng)目中企業(yè)出入庫(kù)（核準(zhǔn)、核銷）數(shù)據(jù)與中國(guó)藥監(jiān)網(wǎng)平臺(tái)交互的文件接口的需求，滿足企業(yè)入庫(kù)核注、出庫(kù)核銷操作的條碼數(shù)據(jù)采集和數(shù)據(jù)上傳的要求。1.2 范圍· 掃描終端范圍支持任何可掃描藥監(jiān)碼的設(shè)備· 適用企業(yè)范圍本文檔適用企

3、業(yè)包括生產(chǎn)企業(yè)、經(jīng)營(yíng)企業(yè)、第三方物流企業(yè)。2 整體說(shuō)明2.1 名詞解釋中國(guó)藥品電子監(jiān)管碼：最小銷售單元（包裝）的藥監(jiān)碼包裝藥監(jiān)碼：外包裝（中包裝以上）的藥監(jiān)碼包裝級(jí)別：1級(jí)為最低級(jí)藥監(jiān)碼，即產(chǎn)品藥監(jiān)碼；2級(jí)為1級(jí)的上級(jí)包裝碼，依次類推。2.2 藥監(jiān)碼模型藥監(jiān)碼采用十六或二十位數(shù)字構(gòu)成，采用Code 128C條碼標(biāo)識(shí)。2.3 文件說(shuō)明企業(yè)按此規(guī)范要求提交文件到中國(guó)藥監(jiān)網(wǎng)平臺(tái)。對(duì)于文件的產(chǎn)生機(jī)制，企業(yè)根據(jù)自身情況實(shí)現(xiàn)。此規(guī)范只涉及以下幾類文件：1、平臺(tái)下載到企業(yè)n 上游企業(yè)出庫(kù)數(shù)據(jù)文件n 往來(lái)單位列表文件n 委托客戶列表文件n 藥品基本信息文件n 操作員信息文件2、企業(yè)上傳到平臺(tái)n 業(yè)務(wù)數(shù)據(jù)文件2

4、.4 角色定義2.4.1 企業(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)。2.4.2 往來(lái)單位與企業(yè)發(fā)生往來(lái)業(yè)務(wù)關(guān)系的單位2.4.3 委托客戶（第三方物流專用）指委托第三方物流進(jìn)行倉(cāng)儲(chǔ)、藥品配送的客戶，一般是藥品生產(chǎn)企業(yè)。3 功能需求3.1 業(yè)務(wù)功能需求業(yè)務(wù)功能分為三種：主功能、補(bǔ)充功能主功能：系統(tǒng)核心功能。補(bǔ)充功能，輔助性功能。3.1.1 主要功能3.1.1.1 核注入庫(kù)功能描述：該功能用于企業(yè)入庫(kù)核注。1、入庫(kù)操作時(shí)，用戶需首先需要

5、選擇入庫(kù)種類（生產(chǎn)入庫(kù)、退貨入庫(kù)、購(gòu)買(mǎi)入庫(kù)、調(diào)撥入庫(kù)）。2、如果用戶選擇退貨入庫(kù)、購(gòu)買(mǎi)入庫(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步操作。3、輸入企業(yè)入庫(kù)單號(hào)，之后根據(jù)系統(tǒng)設(shè)置該功能是否有附加功能，如果有，則輸入附加功

6、能所需關(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ù)中是否已存在，如果存在則提示用戶“該入庫(kù)單號(hào)已經(jīng)在xxxx.xx.xx xx:xx執(zhí)行了入庫(kù)掃描”，同時(shí)給出兩個(gè)選項(xiàng)“重新輸入”（默認(rèn)）和“追加掃描”，如果選擇重新輸入則回到該步驟起始處，如果選擇追加掃描則進(jìn)行

7、后續(xù)操作。注：追加掃描操作的意思是指一個(gè)單子的貨物分多次掃描。 xxxx.xx.xx xx:xx為時(shí)間格式，該時(shí)間為該單號(hào)起初掃描第一個(gè)碼的時(shí)間4、設(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)4.1校驗(yàn)規(guī)則） 4.1校驗(yàn)規(guī)則：

8、校驗(yàn)藥監(jiān)碼類型時(shí)，可以根據(jù)碼長(zhǎng)度以及編碼規(guī)則判斷。 4.1.1 碼長(zhǎng)度普藥碼長(zhǎng)度均為20位；特藥包含16、20位兩種長(zhǎng)度 4.1.2 標(biāo)志位普藥：藥監(jiān)碼前兩位為標(biāo)志位-80或81或82或83或84或85或88；特藥：16位特藥藥監(jiān)碼第一位為標(biāo)志位1；20位特藥藥監(jiān)碼前兩位為標(biāo)志位-895、掃描時(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)碼，則

9、提示用戶“該碼不屬于任何出庫(kù)單”，并提示用戶強(qiáng)制輸入或者重新掃描。同時(shí)，強(qiáng)制入庫(kù)的藥監(jiān)碼需要在上傳數(shù)據(jù)時(shí)做出標(biāo)記，具體見(jiàn)4.2.1接口規(guī)范。6、用戶如選擇結(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)入的

10、藥監(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)前委托客戶。輸入方式包括：1、檢索方式，可通過(guò)客戶名稱、名稱拼音簡(jiǎn)寫(xiě)進(jìn)行模糊檢索；2、可手工或者掃描輸入委托客戶的唯一編碼，系統(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ù)流程：3.

11、1.1.2 核銷出庫(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ù)中，

12、具體位置和格式參加業(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)前委托客戶。輸入方式包括：1、檢索方式，可通過(guò)客戶名稱、名稱拼音簡(jiǎn)寫(xiě)進(jìn)行模糊檢索；2、可手工或者掃描輸入委托客戶的唯一編碼，系統(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)要

13、增加一次校驗(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ù)中是否已存在，如果存在則提示用戶“該出庫(kù)單號(hào)已經(jīng)在xxxx.xx.xx xx:xx執(zhí)行了出庫(kù)掃描”，同時(shí)給出兩個(gè)選項(xiàng)“重新輸入”（默認(rèn)）和“追加掃描”，如果選擇重新輸入則回到該步驟起始處，如果選擇追加掃描則進(jìn)行后續(xù)操作。追加掃描操作的意思是指一個(gè)單號(hào)的貨物分多次掃描。注：追加掃描操作的意思是指一個(gè)單子的貨物分多次掃描。 xxxx.xx.xx xx:xx

14、為時(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位；特藥包含16、20位兩種長(zhǎng)度 標(biāo)志

15、位-普藥：藥監(jiān)碼前兩位為標(biāo)志位-80或81或82或83或84或85或88；特藥：16位特藥藥監(jiān)碼第一位為標(biāo)志位1；20位特藥藥監(jiān)碼前兩位為標(biāo)志位-893.1.2 補(bǔ)充功能3.1.2.1 用戶登陸功能描述：該功能用于操作員在終端登陸。用戶信息從用戶檔案文件中讀取，獲得該操作員的編號(hào)。關(guān)鍵數(shù)據(jù)：用戶名、密碼業(yè)務(wù)流程圖：3.1.2.2 庫(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)容量判

16、斷、碼長(zhǎng)度判斷同樣包括在該功能內(nèi)（該功能不在流程圖中列出）。關(guān)鍵數(shù)據(jù)：   盤(pán)點(diǎn)任務(wù)編號(hào)、藥監(jiān)碼、盤(pán)點(diǎn)數(shù)量業(yè)務(wù)流程圖：3.1.2.3 藥監(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ù)流程圖：

17、60;  3.1.2.4 藥監(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ù)流程圖：   3.2 系統(tǒng)功能需求3.2.1 數(shù)據(jù)通訊3.2.1.1 終端操作員數(shù)據(jù)下載功能描述：該功能用于下載用戶檔案基礎(chǔ)數(shù)據(jù)，實(shí)現(xiàn)數(shù)據(jù)同步。下載時(shí)，由企業(yè)客戶端在指定目錄生成TXT文件，再由終端讀取該文件并解析。下載文件后，軟件自動(dòng)更新現(xiàn)有檔案文件。具體文件定義見(jiàn)4.1終端操

18、作員數(shù)據(jù)下載接口關(guān)鍵數(shù)據(jù)：用戶檔案文件（操作員姓名、編號(hào)、密碼）3.2.1.2 上游企業(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ò)誤需要提示。下載接口定義見(jiàn)：4.2上游企業(yè)出庫(kù)數(shù)據(jù)下載接口。關(guān)鍵數(shù)據(jù)：上游企業(yè)名稱、上游企業(yè)出庫(kù)單號(hào)、藥監(jiān)碼3.2.1.3 企業(yè)業(yè)務(wù)數(shù)據(jù)上傳功能描述：該功能用于將手持終端內(nèi)的數(shù)據(jù)整合成規(guī)定格式的XML文件，然后上傳到企業(yè)客戶端指定的目錄。上傳成功后，用戶可選擇清空或者繼續(xù)保留手持終端數(shù)據(jù)?？紤]到有可能文件會(huì)比較大，傳輸時(shí)間較長(zhǎng)。上傳控件必須提供檢索當(dāng)前文件

19、傳輸百分比功能。上傳數(shù)據(jù)時(shí)，需要將數(shù)據(jù)分成三部分，關(guān)聯(lián)關(guān)系相關(guān)數(shù)據(jù)（建立關(guān)聯(lián)、刪除關(guān)聯(lián)、重建關(guān)聯(lián)和查驗(yàn)關(guān)聯(lián)）生成一個(gè)XML文件，普藥、特藥分別生成不同的XML文件。普藥、特藥的XML文件分別放入兩個(gè)相互獨(dú)立的目錄下。企業(yè)客戶端上傳XML文件時(shí)，選擇上傳普藥文件，系統(tǒng)自動(dòng)提取包含普藥的所有XML文件，選擇特藥文件系統(tǒng)自動(dòng)提取包含特藥的所有XML文件，然后上傳到企業(yè)客戶端指定目錄。關(guān)聯(lián)關(guān)系數(shù)據(jù)上傳格式見(jiàn)通訊接口>關(guān)聯(lián)關(guān)系數(shù)據(jù)上傳接口其他數(shù)據(jù)上傳格式見(jiàn)通訊接口>業(yè)務(wù)數(shù)據(jù)上傳接口3.2.1.4 往來(lái)單位列表下載（增值服務(wù)、第三方物流企業(yè)PDA專用）功能描述：該功能用于下載企業(yè)在客戶端維護(hù)的

20、往來(lái)單位列表。下載后，企業(yè)進(jìn)行入出庫(kù)操作時(shí)，可以通過(guò)檢索的方式在往來(lái)單位列表中選擇上游發(fā)貨企業(yè)或者下游收貨企業(yè)下載接口見(jiàn)4.3數(shù)據(jù)下載接口>往來(lái)單位下載接口關(guān)鍵數(shù)據(jù)：往來(lái)單位名稱、名稱拼音簡(jiǎn)寫(xiě)、往來(lái)單位編碼3.2.1.5 委托客戶列表下載（增值服務(wù)、第三方物流企業(yè)PDA專用）功能描述：該接口用于物流企業(yè)從PC端下載委托客戶列表到手持終端。用于企業(yè)進(jìn)行當(dāng)前委托客戶設(shè)置使用。下載接口見(jiàn)4.4數(shù)據(jù)下載接口委托客戶列表下載接口關(guān)鍵數(shù)據(jù)：委托客戶名稱、委托客戶名稱拼音簡(jiǎn)寫(xiě)、委托客戶編碼3.2.1.6 藥品監(jiān)管碼基本信息下載（增值服務(wù)、第三方物流企業(yè)PDA專用）功能描述：該功能用于物流企業(yè)下載藥品監(jiān)

21、管碼網(wǎng)入圍企業(yè)的藥品產(chǎn)品編碼信息。下載后，企業(yè)進(jìn)行入出庫(kù)操作時(shí)，可以通過(guò)檢索的方式查詢碼對(duì)應(yīng)的藥品信息。下載接口見(jiàn)4.5數(shù)據(jù)下載接口>藥品產(chǎn)品編碼信息下載接口關(guān)鍵數(shù)據(jù)：藥品類型、生產(chǎn)企業(yè)、藥品通用名、劑型、制劑規(guī)格、包裝規(guī)格、批準(zhǔn)文號(hào)、商品名、產(chǎn)品編碼、包裝比例、包裝層級(jí)3.2.2 系統(tǒng)設(shè)置   3.2.2.1 系統(tǒng)時(shí)間設(shè)置功能描述：該功能用于用戶設(shè)定手持終端的系統(tǒng)時(shí)間。用戶選擇該功能后，顯示系統(tǒng)當(dāng)前時(shí)間。用戶可手工輸入時(shí)間，更改系統(tǒng)時(shí)間。關(guān)鍵數(shù)據(jù)：系統(tǒng)時(shí)間3.2.2.2 系統(tǒng)最低容量報(bào)警設(shè)置功能描述：該功能用于每次出庫(kù)掃描時(shí)，檢查系統(tǒng)容量，計(jì)算出剩余空間可

22、容納的藥監(jiān)碼數(shù)量，顯示。當(dāng)剩余藥監(jiān)碼容量小于系統(tǒng)預(yù)警設(shè)置的閥值時(shí)，提示用戶上傳并清空數(shù)據(jù)。關(guān)鍵數(shù)據(jù)：系統(tǒng)容量，藥監(jiān)碼長(zhǎng)度   3.2.2.3 使用企業(yè)功能設(shè)置功能描述：該功能用于設(shè)置當(dāng)前使用企業(yè)，備選項(xiàng)為生產(chǎn)企業(yè)、運(yùn)營(yíng)企業(yè)、使用單位。根據(jù)該項(xiàng)的設(shè)置，手持終端需要屏蔽相應(yīng)的功能項(xiàng)，以免用戶誤操作。生產(chǎn)企業(yè)、運(yùn)營(yíng)企業(yè)、使用單位各自具備的功能項(xiàng)如下表：功能點(diǎn)生產(chǎn)企業(yè)運(yùn)營(yíng)企業(yè)使用單位第三方物流生產(chǎn)入庫(kù)退貨入庫(kù)采購(gòu)入庫(kù)調(diào)撥入庫(kù)銷售出庫(kù)銷毀出庫(kù)抽檢出庫(kù)退貨出庫(kù)調(diào)撥出庫(kù)庫(kù)存盤(pán)點(diǎn)藥監(jiān)碼替換藥監(jiān)碼注銷上游企業(yè)出庫(kù)單下載業(yè)務(wù)數(shù)據(jù)上傳操作員數(shù)據(jù)下載往來(lái)單位列表下載委托客戶列表下載委托客

23、戶設(shè)置3.2.2.4 藥品類型設(shè)置功能描述：該功能用于設(shè)置采集器可支持的藥品類型（藥品類型包括：普藥類型、特藥類型、混合類型），每次制定單據(jù)時(shí)系統(tǒng)自動(dòng)讀取該設(shè)置。類型說(shuō)明：1 普藥類型：系統(tǒng)設(shè)置為普藥類型，創(chuàng)建單據(jù)時(shí)系統(tǒng)自動(dòng)設(shè)定為普藥類型單據(jù)，掃描過(guò)程中僅可掃描屬于普藥類型的碼。2特藥類型：系統(tǒng)設(shè)置為特藥類型，創(chuàng)建單據(jù)時(shí)系統(tǒng)自動(dòng)設(shè)定為特藥類型單據(jù)，掃描過(guò)程中僅可掃描屬于特藥類型的碼。3 混合類型：系統(tǒng)設(shè)置為混合類型，創(chuàng)建單據(jù)時(shí)系統(tǒng)需提示用戶設(shè)定藥品類型（此時(shí)可選類型為：普藥類型、特藥類型），掃描過(guò)程中僅可掃描符合當(dāng)前單據(jù)設(shè)定的藥品碼。關(guān)鍵數(shù)據(jù)：藥品類型類型  3.2.2.5

24、 當(dāng)前委托客戶設(shè)置（第三方物流PDA專用）功能描述：該功能用于物流企業(yè)用戶選擇其當(dāng)前操作的業(yè)務(wù)單據(jù)屬于哪家客戶。用戶可在客戶列表中設(shè)定其當(dāng)前委托客戶。企業(yè)選擇當(dāng)前委托客戶的方式包括：1、檢索方式，可通過(guò)客戶名稱、名稱拼音簡(jiǎn)寫(xiě)進(jìn)行模糊檢索；2、可手工或者掃描輸入委托客戶的唯一編碼，系統(tǒng)自動(dòng)檢索并進(jìn)行填寫(xiě)。設(shè)定委托客戶后，該客戶名稱需要PDA的顯著位置隨時(shí)可見(jiàn)。關(guān)鍵數(shù)據(jù)：委托客戶名稱、委托客戶名稱拼音簡(jiǎn)寫(xiě)3.2.3 數(shù)據(jù)刪除功能描述：   該功能用于將用戶已經(jīng)輸入的數(shù)據(jù)。包括所有的主要功能和補(bǔ)充功能數(shù)據(jù)。   用戶刪除數(shù)據(jù)時(shí)，可按照企業(yè)的

25、出/入庫(kù)單批量刪除，也可按照藥監(jiān)碼逐個(gè)刪除。   刪除關(guān)聯(lián)關(guān)系數(shù)據(jù)時(shí)，刪除包裝碼時(shí)，同時(shí)刪除下屬產(chǎn)品碼。 刪除數(shù)據(jù)要求可以掃描刪除。4 數(shù)據(jù)下載接口4.1 終端操作員數(shù)據(jù)下載接口接口描述：該接口用于從PC端下載手持終端操作員數(shù)據(jù)到手持終端。用于手持終端操作員登陸使用。文件名稱Accounts.txt。接口標(biāo)準(zhǔn)：<操作員1編號(hào)>,<操作員1名稱>,<操作員1密碼>（回車換行）<操作員2編號(hào)>,<操作員2名稱>,<操作員2密碼>（回車換行）     

26、;    <操作員N編號(hào)>,<操作員N名稱>,<操作員N密碼>數(shù)據(jù)屬性：（長(zhǎng)度定義為最大長(zhǎng)度，不是指定長(zhǎng)度）名稱類型長(zhǎng)度操作員編號(hào)數(shù)字4操作員名稱字符10操作員密碼字符8接口示例：  0001,User1,11111111  0002,User2,11111          .  0101,User10,abcdefg4.2 上游企業(yè)出庫(kù)數(shù)據(jù)下載接口接口描述：

27、該接口用于從企業(yè)客戶端下載上游企業(yè)的出庫(kù)數(shù)據(jù)使用。接口標(biāo)準(zhǔn)：$<企業(yè)名稱>，<企業(yè)出庫(kù)單號(hào)><藥監(jiān)碼>，<藥品名稱>，<生產(chǎn)批號(hào)>，<生產(chǎn)日期><藥監(jiān)碼>，<藥品名稱>，<生產(chǎn)批號(hào)>，<生產(chǎn)日期><藥監(jiān)碼>，<藥品名稱>，<生產(chǎn)批號(hào)>，<生產(chǎn)日期>#說(shuō)明：$符號(hào)：出庫(kù)單開(kāi)始符#符號(hào)：出庫(kù)單結(jié)束符數(shù)據(jù)屬性：名稱類型長(zhǎng)度企業(yè)名稱字符20（漢字）出庫(kù)單號(hào)字符20藥品名稱字符10(漢字)生產(chǎn)日期字符6生產(chǎn)批號(hào)字符20藥監(jiān)碼字符16或20

28、接口示例：$青海制藥廠，10991213C123456789012345，青海藥品1，1234567890，060901123456789012345，青海藥品1，1234567890，060901#$北京制藥廠，293210123456789012346，北京藥品1，1234567890，060901123456789022345，北京藥品1，1234567890，060901#4.3 往來(lái)單位列表下載接口（第三方物流PDA專用）接口描述：該接口用于從PC端下載往來(lái)單位列表到手持終端。用于企業(yè)入出庫(kù)時(shí)，選擇上游發(fā)貨企業(yè)或者下游收貨企業(yè)。文件名稱Customers.txt。接口標(biāo)準(zhǔn)： <

29、往來(lái)單位名稱>,<往來(lái)單位拼音頭字母簡(jiǎn)寫(xiě)>,<往來(lái)單位編碼>（回車換行）<往來(lái)單位名稱>,<往來(lái)單位拼音頭字母簡(jiǎn)寫(xiě)>,<往來(lái)單位編碼>（回車換行）         <往來(lái)單位名稱>,<往來(lái)單位拼音頭字母簡(jiǎn)寫(xiě)>,<往來(lái)單位編碼>（回車換行）數(shù)據(jù)屬性：（長(zhǎng)度定義為最大長(zhǎng)度，不是指定長(zhǎng)度）名稱類型長(zhǎng)度往來(lái)單位名稱字符30往來(lái)單位拼音頭字母簡(jiǎn)寫(xiě)字符30往來(lái)單位編碼字符12接口示例：  北京天壇

30、生物制品有限公司，bjttswzpysgs，BJ001  北京積水潭醫(yī)院,bjjstyy,00002          .  上海醫(yī)藥股份有限公司,shyyyxgs，SH2304.4 委托客戶列表下載接口（第三方物流PDA專用）接口描述：該接口用于物流企業(yè)從PC端下載委托客戶列表到手持終端。用于企業(yè)進(jìn)行當(dāng)前委托客戶設(shè)置使用。接口標(biāo)準(zhǔn)： <委托客戶名稱>,<委托客戶拼音頭字母簡(jiǎn)寫(xiě)>,<委托客戶編碼>（回車換行）<委托

31、客戶名稱>,<委托客戶拼音頭字母簡(jiǎn)寫(xiě)>,<委托客戶編碼>（回車換行）         <委托客戶名稱>,<委托客戶拼音頭字母簡(jiǎn)寫(xiě)>,<委托客戶編碼>（回車換行）數(shù)據(jù)屬性：（長(zhǎng)度定義為最大長(zhǎng)度，不是指定長(zhǎng)度）名稱類型長(zhǎng)度委托客戶名稱字符30委托客戶拼音頭字母簡(jiǎn)寫(xiě)字符30委托客戶編碼字符12接口示例：  北京天壇生物制品有限公司，bjttswzpysgs，BJ001  北京積水潭醫(yī)院,bjjstyy,00

32、002          .  上海醫(yī)藥股份有限公司,shyyyxgs，SH2304.5 藥品監(jiān)管碼信息下載接口（第三方物流PDA專用）接口描述：該功能用于物流企業(yè)下載藥品監(jiān)管碼網(wǎng)入圍企業(yè)的藥品產(chǎn)品編碼信息。下載后，企業(yè)進(jìn)行入出庫(kù)操作時(shí)，可以通過(guò)檢索的方式查詢碼對(duì)應(yīng)的藥品信息。接口標(biāo)準(zhǔn)： <藥品類型>,<生產(chǎn)企業(yè)>,<藥品通用名><劑型>,<制劑規(guī)格>,<包裝規(guī)格>,<批準(zhǔn)文號(hào)>,<商品

33、名>,<產(chǎn)品編碼>，<包裝比例>，<包裝級(jí)別>（回車換行）         <藥品類型>,<生產(chǎn)企業(yè)>,<藥品通用名><劑型>,<制劑規(guī)格>,<包裝規(guī)格>,<批準(zhǔn)文號(hào)>,<商品名>,<產(chǎn)品編碼>，<包裝比例>，<包裝級(jí)別>（回車換行）數(shù)據(jù)屬性：（長(zhǎng)度定義為最大長(zhǎng)度，不是指定長(zhǎng)度）名稱類型長(zhǎng)度藥品類型字符30生產(chǎn)企業(yè)字符60藥品通用名字

34、符60劑型字符60制劑規(guī)格字符60包裝規(guī)格字符60批準(zhǔn)文號(hào)字符60商品名字符120藥品本位碼（SDC）字符30產(chǎn)品編碼字符12包裝比例字符20包裝層級(jí)字符1接口示例：  第二類精神藥品,北京天壇生物制品有限公司,甘草片,片劑, 0.25mg, 袋200片, 國(guó)藥準(zhǔn)字Z1120100999,復(fù)方甘草片,0000000000000, 89300002,1:10:100,1          .  國(guó)家基本藥物,北京華蘭生物制品有限公司, 注射用青霉素, 注射劑

35、, 10mg, 盒50支, 國(guó)藥準(zhǔn)字Z1120100888, 注射用青霉素,0000000000000, 8100001,1:10:50,1國(guó)家基本藥物,北京華蘭生物制品有限公司, 注射用青霉素, 注射劑, 10mg, 盒50支, 國(guó)藥準(zhǔn)字Z1120100888, 注射用青霉素,0000000000000, 8800001,1:10:20,25 業(yè)務(wù)數(shù)據(jù)上傳接口5.1 接口規(guī)范該接口規(guī)范定義了手持終端內(nèi)的除關(guān)聯(lián)關(guān)系數(shù)據(jù)外所有數(shù)據(jù)上傳格式，上傳時(shí)需要將數(shù)據(jù)按照接口規(guī)范整合成一個(gè)XML文件，然后上傳到企業(yè)客戶端的制定目錄。5.1.1 XML Schema規(guī)范手持終端生成的業(yè)務(wù)數(shù)據(jù)XML文件必須符合

36、我方提供的Schema規(guī)范，結(jié)構(gòu)如下：各節(jié)點(diǎn)注釋如下表：節(jié)點(diǎn)名稱節(jié)點(diǎn)含義節(jié)點(diǎn)屬性下級(jí)節(jié)點(diǎn)舉例：Document文檔根節(jié)點(diǎn)License：可選EventsEventsDocument子節(jié)點(diǎn)，只可出現(xiàn)一次，用于區(qū)分多種事件產(chǎn)生的數(shù)據(jù)，如出庫(kù)事件、碼替換事件Comment擴(kuò)展屬性，可選Event、ActionMapping、DataMaping、DataDesc、DataFieldEventEvents子節(jié)點(diǎn)，定義當(dāng)前事件發(fā)生哪些動(dòng)作。Name：事件名稱，可選PreAction：前置動(dòng)作名稱，可選MainAction：主動(dòng)作名稱，必選AfterAction：后置動(dòng)作名稱，可選Comment：擴(kuò)展屬性

37、，可選ActionMapping、DataMaping、DataDesc、DataField<Event Name="SalesWareHouseOut" MainAction="WareHouseOut" PreAction=" " AfterAction=" " />ActionMappingEvent子節(jié)點(diǎn)，定義當(dāng)前事件激發(fā)的動(dòng)作所需要的數(shù)據(jù)。例如出庫(kù)動(dòng)作所需數(shù)據(jù)Action<ActionMapping><Action Name="SalesWareHouseOut&q

38、uot;><ActionData>CorpOrderID</ActionData><ActionData>CorpOrderID</ActionData><ActionData>Actor</ActionData><ActionData> Actor</ActionData><ActionData> ActDate</ActionData><ActionData>Code</ActionData></Action></Actio

39、nMapping>ActionActionMapping子節(jié)點(diǎn)，可出現(xiàn)多次，定義每一個(gè)動(dòng)作所需要的數(shù)據(jù)Name：Action描述的動(dòng)作名稱，必選ActionDataActionDataAction子節(jié)點(diǎn)，可出現(xiàn)多次，表示Action描述動(dòng)作所需要要的一個(gè)數(shù)據(jù)名稱DataMapingEvent子節(jié)點(diǎn)，當(dāng)前事件所需所有數(shù)據(jù)的數(shù)據(jù)描述和列表MetaData<DataMaping><MetaData Name="CorpOrderID" Type="String"/><MetaData Name="Actor&quo

40、t; Type="String"/><MetaData Name="ActDate" Type="Date"/><MetaData Name="Code" Type="String"/>/></DataMaping>MetaDataDataMaping子節(jié)點(diǎn)，描述每一個(gè)數(shù)據(jù)的名稱和屬性Name：所需數(shù)據(jù)的名稱Type：所需數(shù)據(jù)的類型DataDescEvent子節(jié)點(diǎn)，描述該事件所需所有數(shù)據(jù)的關(guān)系，該子節(jié)點(diǎn)可選MetaDataDesc<DataD

41、esc><MetaDataDesc MetaName="CorpOrderID" IsParent="true"><MetaDataDesc MetaName="Code" IsParent="false"/></MetaDataDesc><MetaDataDesc MetaName=" ActDate" IsParent="true"><MetaDataDesc MetaName="Code"

42、IsParent="false"/></MetaDataDesc></DataDesc>MetaDataDescDataDesc子節(jié)點(diǎn)，描述每一個(gè)數(shù)據(jù)與其他數(shù)據(jù)的關(guān)系，可嵌套自身節(jié)點(diǎn)MetaDataDescIsParent:該數(shù)據(jù)是否父屬性MetaName:該數(shù)據(jù)的名稱DataFieldEvent子節(jié)點(diǎn)，包含具體的數(shù)據(jù)具體格式見(jiàn)接口示例具體格式見(jiàn)接口示例<DataField><Code value="123456789012345" CorpOrderID="010101" Actor=

43、"test01" ActDate="2006-07-08 14:32:40"/><Code value="123456789012345" CorpOrderID="010101" Actor="test01" ActDate="2006-07-08 14:32:40"/></DataField>源代碼如下：<?xml version="1.0" encoding="UTF-8"?><!-

44、 edited with XMLSPY v2004 rel. 2 U () by ELEVEN (ELEVEN) -><xs:schema xmlns:xs="" elementFormDefault="qualified"><!-文檔根節(jié)點(diǎn)document-><xs:element name="Document"><xs:complexType><xs:sequence><xs:element name="Events" type="

45、;EventsType"/></xs:sequence><xs:attribute name="SN" type="xs:string" use="optional"/><xs:attribute name="License" type="xs:string" use="optional"/><xs:attribute name="Version" type="xs:string"

46、; use="optional"/><xs:attribute name="Comment" type="xs:string" use="optional"/><!-二級(jí)節(jié)點(diǎn)事件節(jié)點(diǎn)Events，類型EventsType-></xs:complexType></xs:element><!-一級(jí)節(jié)點(diǎn)Events類型定義-><xs:complexType name="EventsType"><xs:sequence&

47、gt;<xs:element name="Event" type="EventType" maxOccurs="unbounded"/></xs:sequence><xs:attribute name="Comment" type="xs:string"/></xs:complexType><xs:complexType name="MetaDataDesc"><xs:sequence><xs:el

48、ement name="MetaData" type="DataDescType" maxOccurs="unbounded"/></xs:sequence></xs:complexType><xs:complexType name="DataDescType"/><xs:simpleType name="ParentType"><xs:restriction base="xs:string"><xs:e

49、numeration value="Yes"/><xs:enumeration value="No"/></xs:restriction></xs:simpleType><!-二級(jí)節(jié)點(diǎn) Event類型定義-><xs:complexType name="EventType"><xs:sequence><xs:element name="ActionMapping" type="ActionMapingType"/&

50、gt;<xs:element name="DataMaping" type="DataMapType"/><xs:element name="DataDesc" minOccurs="0"><xs:complexType><xs:complexContent><xs:extension base="DataDescType"><xs:sequence><xs:element ref="MetaDataDesc

51、" minOccurs="0" maxOccurs="unbounded"/></xs:sequence></xs:extension></xs:complexContent></xs:complexType></xs:element><xs:element name="DataField"><xs:complexType><xs:complexContent><xs:extension base="Data

52、FieldType"><xs:sequence><xs:any namespace="#any" processContents="skip" minOccurs="0" maxOccurs="unbounded"/></xs:sequence></xs:extension></xs:complexContent></xs:complexType></xs:element></xs:sequence>&l

53、t;xs:attribute name="Name" type="EventList"/><xs:attribute name="PreAction" type="ActionList" use="optional"/><xs:attribute name="MainAction" type="ActionList"/><xs:attribute name="AfterAction" type=&qu

54、ot;ActionList" use="optional"/><xs:attribute name="Comment" type="xs:string" use="optional"/></xs:complexType><!-二級(jí)節(jié)點(diǎn)ActionMapping類型定義-><xs:complexType name="ActionMapingType"><xs:sequence><xs:element name=&qu

55、ot;Action" type="ActionType" maxOccurs="unbounded"/></xs:sequence></xs:complexType><!-三級(jí)節(jié)點(diǎn)Action類型定義-><xs:complexType name="ActionType"><xs:sequence><xs:element name="ActionData" type="MetaDataList" minOccurs=

56、"0" maxOccurs="unbounded"/></xs:sequence><xs:attribute name="Name" type="ActionList"/></xs:complexType><!-二級(jí)節(jié)點(diǎn)DataMap類型定義-><xs:complexType name="DataMapType"><xs:sequence><xs:element name="MetaData"

57、 type="MetaDataType" maxOccurs="unbounded"/></xs:sequence></xs:complexType><!-三級(jí)節(jié)點(diǎn)MetaData類型定義-><xs:complexType name="MetaDataType"><xs:attribute name="Type" type="DataTypeList" use="optional"/><xs:attrib

58、ute name="Length" type="xs:short" use="optional"/><xs:attribute name="Name" type="MetaDataList" use="required"/></xs:complexType><!-二級(jí)節(jié)點(diǎn)數(shù)據(jù)區(qū)DataField類型定義-><xs:complexType name="DataFieldType"/><xs:elem

59、ent name="MetaDataDesc"><xs:complexType><xs:sequence><xs:element ref="MetaDataDesc" minOccurs="0" maxOccurs="unbounded"/></xs:sequence><xs:attribute name="MetaName" type="MetaDataList" use="required"/

60、><xs:attribute name="IsParent" type="xs:string" use="required"/></xs:complexType></xs:element><!-可選動(dòng)作列表-><xs:simpleType name="ActionList"><xs:restriction base="xs:string"><xs:enumeration value="WareHouse

61、In"/><xs:enumeration value="WareHouseOut"/><xs:enumeration value="CodeReplace"/><xs:enumeration value="CodeDestory"/></xs:restriction></xs:simpleType><!-可選事件列表-><xs:simpleType name="EventList"><xs:restrictio

62、n base="xs:string"><xs:enumeration value="PurchaseWareHouseIn"/><xs:enumeration value="SalesWareHouseOut"/><xs:enumeration value="ReturnWareHouseIn"/><xs:enumeration value="ReturnWareHouseOut"/><xs:enumeration value=&quo

63、t;ProduceWareHouseIn"/><xs:enumeration value="AllocateWareHouseIn"/><xs:enumeration value="AllocateWareHouseOut"/><xs:enumeration value="ReworkWareHouseOut"/><xs:enumeration value="DestoryWareHouseOut"/><xs:enumeration value=

64、"CheckWareHouseOut"/><xs:enumeration value="DirectAllocateWareHouseOut"/><xs:enumeration value="CodeReplace"/><xs:enumeration value="CodeDestory"/></xs:restriction></xs:simpleType><!-可選基礎(chǔ)數(shù)據(jù)列表-><xs:simpleType name="MetaDataList"><xs:restriction base="xs:string"><xs:enumeration value="CorpOrderID"/><xs:enumeration value="FromCorpID"/><xs:enumeration value="ToCorpID"/><xs:enumeration value="OwnerCorpID"/><