《千方百劑醫(yī)療器械版對(duì)接國(guó)藥賽飛接口平臺(tái)》應(yīng)用簡(jiǎn)介及操作說(shuō)明
一、應(yīng)用場(chǎng)景：
千方百劑醫(yī)療器械版軟件，與國(guó)藥平臺(tái)對(duì)接，實(shí)現(xiàn)單據(jù)流轉(zhuǎn)等功能；如：租用國(guó)藥倉(cāng)庫(kù)、認(rèn)證達(dá)標(biāo)等等；
二、應(yīng)用對(duì)接版本：
千方百劑醫(yī)療器械專業(yè)版 V9.4，數(shù)據(jù)庫(kù)：MSSQL 2008R2；
三、應(yīng)用操作說(shuō)明：
3.1、產(chǎn)品主界面，如下圖
3.2、先點(diǎn)擊數(shù)據(jù)庫(kù)配置，配置對(duì)接軟件版本的賬套數(shù)據(jù)庫(kù)名；
3.3、點(diǎn)擊功能配置，配置貨主編碼及貨主保管賬ID等信息，其中，出入庫(kù)類單據(jù)往來(lái)單位為空時(shí)的默認(rèn)值為千方百劑醫(yī)療器械軟件中的對(duì)應(yīng)的往來(lái)單位的單位編號(hào)。如下圖所示：
3.4、對(duì)碼配置。此值已由系統(tǒng)內(nèi)置，上傳對(duì)應(yīng)編碼按此內(nèi)容上傳即可；
其中，對(duì)碼類型以WT開(kāi)頭的，不需要上傳國(guó)藥對(duì)碼，為內(nèi)部使用。對(duì)碼名稱為空的類型也不用上傳國(guó)藥對(duì)碼。建議直接將此EXCEL文檔傳給國(guó)藥平臺(tái)，讓國(guó)藥方進(jìn)行對(duì)碼設(shè)置。
此對(duì)碼設(shè)置，在實(shí)際應(yīng)用時(shí)，如無(wú)特殊需求，不建議變更！
點(diǎn)擊下方鏈接，查看《商品單位對(duì)碼操作說(shuō)明》整體功能說(shuō)明！
http://m.fuja-group.com/xueyuan/show-1293.aspx
3.5、開(kāi)始打包 在主界面中，選擇要打包的數(shù)據(jù)內(nèi)容，也可以點(diǎn)擊快速選擇處理，確定時(shí)間范圍，點(diǎn)擊“開(kāi)始打包”即可生成符合國(guó)藥接口規(guī)范的接口壓縮包文件；將此文件上傳至國(guó)藥指定FTP目錄UP文件夾下即可；
打包千方做單注意事項(xiàng)請(qǐng)參考此教程步驟：3.10、3.11；
3.6、打包日志
可查看所有打包歷史記錄，包括打包時(shí)間、時(shí)間范圍、打包類型等；
3.7、入庫(kù)單反饋
3.7.1、在分配的FTP目錄：/history/<年月日>/send/，下載入庫(kù)單的反饋壓縮包，然后，點(diǎn)擊入庫(kù)單反饋?lái)?yè)面的“導(dǎo)入文件”，選擇剛下載的入庫(kù)單反饋壓縮包，再點(diǎn)擊“確定數(shù)據(jù)”即可將此入庫(kù)單反饋記錄導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)；
3.7.2、點(diǎn)擊查詢按鈕，可查詢所有已導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)的入庫(kù)單反饋記錄；
3.8、出庫(kù)單反饋
3.8.1、在分配的FTP目錄：/history/<年月日>/send/，下載出庫(kù)單的反饋壓縮包，然后，點(diǎn)擊出庫(kù)單反饋?lái)?yè)面的“導(dǎo)入文件”，選擇剛下載的出庫(kù)單反饋壓縮包，再點(diǎn)擊“確定數(shù)據(jù)”即可將此出庫(kù)單反饋記錄導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)；
3.8.2、點(diǎn)擊查詢按鈕，可查詢所有已導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)的出庫(kù)單反饋記錄；
3.9、調(diào)整單反饋
3.9.1、在分配的FTP目錄：/history/<年月日>/send/，下載調(diào)整單的反饋壓縮包，然后，點(diǎn)擊調(diào)整單反饋?lái)?yè)面的“導(dǎo)入文件”，選擇剛下載的調(diào)整單反饋壓縮包，再點(diǎn)擊“確定數(shù)據(jù)”即可將此調(diào)整單反饋記錄導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)；
3.9.2、點(diǎn)擊查詢按鈕，可查詢所有已導(dǎo)入至千方軟件數(shù)據(jù)庫(kù)的調(diào)整單反饋記錄；
3.10 千方百劑醫(yī)療器械軟件中，做單的注意事項(xiàng)：
3.10.1、接口所涉及單據(jù)類型包括：采購(gòu)單、采購(gòu)?fù)素泦?、銷售單、銷售退貨單、報(bào)溢單、報(bào)損單等共6種單據(jù)；
3.10.2、所有單據(jù)填寫(xiě)時(shí)，如果表頭的運(yùn)輸方式，均填寫(xiě)自運(yùn)出庫(kù)；如果表頭無(wú)此字段或有此字段但不填寫(xiě)或填寫(xiě)自提，生成接口則為自提；
3.10.3、表體明細(xì)的附加信息一對(duì)應(yīng)：國(guó)藥入庫(kù)批號(hào)；附加信息二對(duì)應(yīng)國(guó)藥入庫(kù)效期；附加信息三對(duì)應(yīng)國(guó)藥生產(chǎn)日期；
3.10.4、入庫(kù)類單據(jù)，表體明細(xì)的附加信息一、附加信息二、附加信息三均為空，不能填寫(xiě)；
3.10.5、出庫(kù)類單據(jù)，表體明細(xì)的附件信息一、附加信息二、附加信息三，均需要填寫(xiě)，按3.10.3的說(shuō)明及3.7.2中的入庫(kù)單反饋的批號(hào)效期等，進(jìn)入填寫(xiě)；
3.10.6、往來(lái)單位中的倉(cāng)庫(kù)地址，會(huì)自動(dòng)生成T103中的地址信息，建議填寫(xiě)；
3.11、打包及上傳FTP注意事項(xiàng)
3.11.1、先打包T101、T102、T103這三項(xiàng)基本信息，并上傳至FTP指定文件夾UP中；
3.11.2、待3.11.1步完成無(wú)誤后，再打包入庫(kù)類單據(jù)并上傳，可以通過(guò)快速選擇按鈕，
，然后確定好單據(jù)的時(shí)間范圍，點(diǎn)擊開(kāi)始打包并上傳即可；
3.11.3、打包出庫(kù)類單據(jù)時(shí)，要確保出庫(kù)類單據(jù)商品的批號(hào)已在國(guó)藥平臺(tái)系統(tǒng)上有相應(yīng)的入庫(kù)單反饋記錄，如果沒(méi)有，需要等待入庫(kù)單反饋記錄產(chǎn)生；否則會(huì)導(dǎo)致國(guó)藥系統(tǒng)卡單；
四、操作步驟簡(jiǎn)要說(shuō)明
4.1、安裝好五通定制工具箱及千方國(guó)藥賽飛接口應(yīng)用，并做好數(shù)據(jù)庫(kù)配置、功能配置等 ；
4.2 、將五通公司提供的對(duì)碼表，提交給國(guó)藥相關(guān)人員，由國(guó)藥方進(jìn)行對(duì)碼操作，直到國(guó)藥方提示對(duì)碼已全部完成；
4.3、打開(kāi)千方國(guó)藥賽飛接口應(yīng)用，選中基本信息：商品、單位 、地址等三項(xiàng)，然后點(diǎn)擊開(kāi)始打包，打包完成后，系統(tǒng)會(huì)自動(dòng)打開(kāi)生成的打包文件所在文件夾位置。
4.4、打開(kāi)FTP軟件，并連接由國(guó)藥提供的FTP站點(diǎn)，打開(kāi)UP文件夾后，將第3步生成的三個(gè)文件傳到FTP的UP文件夾下；
4.5、等待國(guó)藥方反饋基本信息已上傳并匹配完成，再進(jìn)行下面的單據(jù)上傳操作；
4.6、上述5步完成后，打開(kāi)千方國(guó)藥賽飛接口應(yīng)用，選中入庫(kù)類單據(jù)（采購(gòu)單 、報(bào)溢單 ），確定單據(jù)的時(shí)間范圍，點(diǎn)擊開(kāi)始打包，系統(tǒng)將自動(dòng)將此時(shí)間范圍內(nèi)的選中的單據(jù)類型對(duì)應(yīng)的生效的單據(jù)全部打包生成國(guó)藥指定接口文件，并自動(dòng)打開(kāi)所在文件夾位置；
4.7、以第4步類似，將第6步生成的打包文件上傳至FTP的UP文件夾下；
4.8、等待國(guó)藥方反饋入庫(kù)信息已上傳完成，可由千方操作人員，查看FTP的History\<yyyyMMdd>\send 文件夾下的文件，如果有新生成的壓縮包反饋文件，則下載到本機(jī)；若沒(méi)有，則等待反饋壓縮包生成；
4.9、打開(kāi)千方國(guó)藥賽飛接口應(yīng)用 - 入庫(kù)單反饋，點(diǎn)擊導(dǎo)入文件， 選中第8步下載的反饋壓縮包，
若能正確讀取，則點(diǎn)擊確定數(shù)據(jù)，將入庫(kù)反饋文件導(dǎo)致至千方數(shù)據(jù)庫(kù)；
若不能正確讀取，可重新下載后再試，如果確定無(wú)法讀取，可能此文件并非入庫(kù)單 反饋文件，需要等等反饋壓縮包生成，或咨詢國(guó)藥方原因；
4.10、千方中的出庫(kù)類單據(jù)注意事項(xiàng)，附加信息1：批號(hào)；附加信息2：效期；附加信息3：生產(chǎn)日期；1.0.0.495的版本，已修改為：直接取銷售單時(shí)的批號(hào)，生產(chǎn)日期及效期。運(yùn)輸方式：自運(yùn)出庫(kù)；
4.11、第9步操作完成后，打開(kāi)千方國(guó)藥賽飛接口應(yīng)用，選中出庫(kù)類單據(jù)（銷售單 、報(bào)損單、采購(gòu)?fù)素泦?nbsp;），確定單據(jù)的時(shí)間范圍，點(diǎn)擊開(kāi)始打包，系統(tǒng)將自動(dòng)將此時(shí)間范圍內(nèi)的選中的單據(jù)類型對(duì)應(yīng)的生效的單據(jù)全部打包生成國(guó)藥指定接口文件，并自動(dòng)打開(kāi)所在文件夾位置；將生成的打包文件上傳至FTP的UP文件夾下；
4.12、等待國(guó)藥方反饋出庫(kù)信息已上傳完成，可由千方操作人員，查看FTP的History\<yyyyMMdd>\send 文件夾下的文件，如果有新生成的壓縮包反饋文件，則下載到本機(jī)；若沒(méi)有，則等待反饋壓縮包生成；
4.13、打開(kāi)千方國(guó)藥賽飛接口應(yīng)用 - 出庫(kù)單反饋，點(diǎn)擊導(dǎo)入文件， 選中第12步下載的反饋壓縮包，
若能正確讀取，則點(diǎn)擊確定數(shù)據(jù)，將出庫(kù)反饋文件導(dǎo)致至千方數(shù)據(jù)庫(kù)；
若不能正確讀取，可重新下載后再試，如果確定無(wú)法讀取，可能此文件并非出庫(kù)單 反饋文件，需要等等反饋壓縮包生成，或咨詢國(guó)藥方原因；
4.14、調(diào)整單的數(shù)據(jù)導(dǎo)入，與入庫(kù)單反饋和出庫(kù)單反饋的操作方法一致；
更新日志：
V1.0.0.495 2021-12-03
1、變更：打包時(shí)間范圍精確到時(shí)分秒；
2、優(yōu)化：系統(tǒng)框架優(yōu)化；
3、其它已知BUG的修復(fù)
V1.0.0.455 202110111545
1、新增：增加裝箱單位關(guān)系，取千方軟件中商品字典的輔助單位1的值；
2、其它已知BUG的修復(fù)
V1.0.0.445 20210913
1、新增：采購(gòu)訂單作為采購(gòu)入庫(kù)類業(yè)務(wù)類型的打包生成；
2、優(yōu)化：自動(dòng)判定系統(tǒng)打開(kāi)開(kāi)始日期時(shí)，修正開(kāi)始日期會(huì)大于當(dāng)前日期的問(wèn)題；
3、其它已知BUG的修復(fù)
