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