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