《千方百剂医疗器械版对接国药赛飞接口平台》应用简介及操作说明
一、应用场景：
千方百剂医疗器械版软件，与国药平台对接，实现单据流转等功能；如：租用国药仓库、认证达标等等；
二、应用对接版本：
千方百剂医疗器械专业版 V9.4，数据库：MSSQL 2008R2；
三、应用操作说明：
3.1、产品主界面，如下图
3.2、先点击数据库配置，配置对接软件版本的账套数据库名；
3.3、点击功能配置，配置货主编码及货主保管账ID等信息，其中，出入库类单据往来单位为空时的默认值为千方百剂医疗器械软件中的对应的往来单位的单位编号。如下图所示：
3.4、对码配置。此值已由系统内置，上传对应编码按此内容上传即可；
其中，对码类型以WT开头的，不需要上传国药对码，为内部使用。对码名称为空的类型也不用上传国药对码。建议直接将此EXCEL文档传给国药平台，让国药方进行对码设置。
此对码设置，在实际应用时，如无特殊需求，不建议变更！
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：生产日期；运输方式：自运出库；
4.11、第9步操作完成后，打开千方国药赛飞接口应用，选中出库类单据（销售单 、报损单、采购退货单 ），确定单据的时间范围，点击开始打包，系统将自动将此时间范围内的选中的单据类型对应的生效的单据全部打包生成国药指定接口文件，并自动打开所在文件夹位置；将生成的打包文件上传至FTP的UP文件夹下；
4.12、等待国药方反馈出库信息已上传完成，可由千方操作人员，查看FTP的History\<yyyyMMdd>\send 文件夹下的文件，如果有新生成的压缩包反馈文件，则下载到本机；若没有，则等待反馈压缩包生成；
4.13、打开千方国药赛飞接口应用 - 出库单反馈，点击导入文件， 选中第12步下载的反馈压缩包，
若能正确读取，则点击确定数据，将出库反馈文件导致至千方数据库；
若不能正确读取，可重新下载后再试，如果确定无法读取，可能此文件并非出库单 反馈文件，需要等等反馈压缩包生成，或咨询国药方原因；
4.14、调整单的数据导入，与入库单反馈和出库单反馈的操作方法一致；
更新日志：
V1.0.0.455 202110111545
1、新增：增加装箱单位关系，取千方软件中商品字典的辅助单位1的值；
2、其它已知BUG的修复
V1.0.0.445 20210913
1、新增：采购订单作为采购入库类业务类型的打包生成；
2、优化：自动判定系统打开开始日期时，修正开始日期会大于当前日期的问题；
3、其它已知BUG的修复
