码上放心追溯码辅助工具
软件使用说明
功能介绍
本软件是一款 PC 端追溯码处理工具，主要面向 码上放心平台（mashangfangxin.com） 的追溯码业务场景。软件旨在帮助用户高效管理、查询和处理上游出库单及追溯码数据，减少人工操作，提高工作效率与数据准确性。
普通版主要通过导入用户从码上放心平台导出的上游出库单数据，实现对追溯码的集中管理与处理。软件支持快速查询追溯码、批量复制追溯码、导出为文本或 Excel 文件，并可模拟键盘输入追溯码，满足对接其他系统或网页录入的使用需求。同时，程序可记录追溯码的处理状态，在导入数据时自动过滤已保存的单据，避免重复导入和重复处理。
在普通版功能的基础上，定制版支持用户在申请并开通码上放心平台官方 API 接口（免费）后，通过配置相关 API 参数，直接从平台接口获取上游出库单数据，无需手动导出与导入。定制版还支持将大包装码自动拆分为最小单位的追溯码子码，并可根据客户的实际业务需求进行功能定制，进一步提升数据处理的自动化和灵活性。
使用说明
一、普通版
1、码上放心平台下载数据压缩包
登录码上放心平台后，选择“上下游出库单”就可以看到你上游给你的发货单据；输入筛选条件选择要导出的单据；点击“导出”按钮，选择“按码维度导出”（有2个选择，一个是导出筛选后的所有数据，一个是导出勾选的数据）。提示：可以导出的范围大一些，我们程序导入的时候会过滤掉已经导入我们工具的订单。
平台会自动跳转到下载中心，就可以看到你刚才选择的出库单的下载链接，点击后就可以下载到本地，是一个压缩文件，无需解压就可以直接导入我们的软件中。
点击“导入码上放心文件”，然后选择刚才下载的压缩包，如果你已解压选择解压后的EXCEL也可以。
2、已经导入本软件的追溯码可以进行多种条件查询，选出你需要复制的追溯码，复制出的追溯码你可以直接复制到HIS系统入库界面里，或其他有需要的地方。
可根据单据号、发货单位、药品名称（这3个都可以进行模糊搜索如只输入其中1-2个关键词就可以查询）、产品批号（系统自动整理，如果进行了搜索这里批号也只保留筛选后记录有的批号）、入库日期（上游出库单的日期），点击搜索按钮就可以在列表里看到结果，左下角会显示当前列表的数量。如需要显示全部记录可以点击“重置”按钮。
另外为了快速操作，你自己在列表里双击药品名称就可以进符合这个药品名称的快速搜索。
为了方便用户快速搜索，你选择一条记录后点击鼠标右键可以对这条记录的相关信息进行快速复制，如需要搜索相关记录可以直接粘贴到对应的条件输入框里再检索。
3、搜索到你需要的结果后，可以进行复制、导出。
“复制追溯码”按钮，点击后就把当前列表里的所有追溯码复制到粘贴板中，在需要输入的地方点击ctrl+v ，就可以粘贴进去。（默认多个追溯码是使用回车分隔，如果需要改为逗号分隔请在“设置”窗口里修改保存。）
“导出文本文件”按钮，点击后会让你选择导出目录并输入导出文件名，就可以将列表里的所有追溯码写入到文本文件了。
“导出EXCEL模版”按钮，点击后会让你选择导出目录并输入导出文件名，就可以将列表里的所有追溯码写入EXCEL文件里了。（如需要导出为指定的EXCEL模版请联系我们定制处理）
进行以上3个功能的时候，系统会提示里是否需要将处理的追溯码标记为已处理，这样列表里的追溯码的背景色就会改为绿色，方便你识别哪些追溯码已经处理了。
如果需要删除列表里的数据，请点击“删除列表记录”，二次确认后就会把列表里的记录删除，如果鼠标点选了一条或多条记录，删除操作仅针对你选择的数据条目进行操作。
4、一键出库（这个功能就是采用模拟输入的方式将选择的追溯码，录入到您指定的系统中，可以是码上放心平台中的出库，一次输入一条然后自动发送回车，也可以只其他系统的相关输入）
请先在主界面里通过筛选条件选择出您要进行出库的二维码，然后可以点击“标记已处理”，这样列表里的追溯码的背景色就会改为绿色，方便你识别哪些追溯码已经处理了。
点击“一键出库”后，主界面将自动隐藏，然后只显示一个一键出库窗口，请拖动到合适位置（程序会自动记录上次拖动到的位置，下次启动会显示到相同为止）。
然后如果需要导入主界面列表里的追溯码请点击“导入列表”，这样就会把主界面列表里的追溯码导入进来，如果需要导入独立的追溯码文件（可以是文本文件一行一个，或者是EXCEL文件只处理表格的第一列），请点击“导入”按钮然后选择文件，程序会自动判断导入合法的追溯码进入列表，并会自动进行去重。
如果需要将这个窗口置顶，请点击“置顶”按钮，这样这个窗口就显示在最上级不会被其他窗口遮挡。
然后可以看到系统的快捷键设定和间隔时间设定，可以在“设置”窗口修改，保存。（快捷键可以是一个独立的键也可以设置组合键，注意不要和常用的软件冲突）
将鼠标移动到需要录入的位置，单击鼠标左键，让光标在输入框中闪烁，然后按下快捷键就可以自动开始模拟录入了，这个窗体的状态栏会显示当前的运行时间，还有多少记录需要录入。
中途如果需要中断输入可以点击“终止”按钮手工打断输入。
5、设置
点击“设置”按钮后可以看到程序的设置界面。
“快捷键设置”里主要是针对“一键出库”功能里的快捷键和发送间隔的设置。
“显示设置”里，可以设置追溯码分隔字符（针对复制到粘贴板和导出文本文件有效）。“列表排序”可以设置主界面的列表排序。“显示模式”可以设置主界面列表里是否显示已经标记处理完成的记录。
“数据管理”里数据库初始化点击后可以将系统的所有设置清空，含所有入库单据和追溯码、日志记录、API设置信息等。查看同步日志可以查看API接口的调用日志情况。删除历史数据可以选择一个时间点将此时间点之前的所有订单和追溯码数据删除，主要用来解决长时间时候后列表数据可能过多导致加载缓慢的问题。
“列表显示设置”里可以修改主界面列表里的显示哪些字段，和字段的顺序，修改完保存后重启程序才能生效。
“升级”按钮点击后程序会自动判断是否有最新版本，如果有就会自动完成升级。
二、定制版 码上放心平台 API接口对接
1、申请API接口
https://qg6r2i.yuque.com/qg6r2i/csvggm/acim7z?singleDoc#
请通过我们提供的这个文档里进行申请。
2、拿到相关参数后可以自己在“API设置”里将参数设置输入。
首先输入AppKey、AppSecret、企业ID参数，然后点击“获取回调地址”按钮，然后将回调地址复制到阿里开放平台应用设置里的 回调地址中，然后保存。
设置完回调地址后，就可以点击打开授权页面，就可以获取到SessionKey（阿里开发平台里这个应用没用正式发布的时候SessionKey的有效期一般是1-2天，应用发布后有效期为6个月）。如果SessionKey有效期已过就无法通过接口获取码上放心平台里的出库单信息，需要重新打开授权页面进行授权。
3、配置完毕后要点击窗体里的“保存”按钮将参数信息进行保存。
4、然后返回主界面，选择需要获取的上游出库单时间范围，默认为3天内，你可以手工修改。
5、然后点击“一键获取数据”就可以看到一个进度条，由程序自动获取指定日期范围内的所有上游出库单，并判断是否为大包装，如果是大包装追溯码会自动拆分为最小包装追溯码，进度条走完后可以点击“关闭”按钮，就可以看到导入的新的数据了。
定制版系统的其他操作和标准版一致，请直接参考标准版。