采购变更模块用户使用手册
一、模块概述
本扩展模块主要用于处理采购变更相关业务，包括采购变更单的创建、展示以及将采购变更信息导出为 Excel 文件等功能。以下将详细介绍该模块的具体使用方法。
二、模块功能及使用方法
（一）采购变更单视图（purchase_change/views/purchase_change_view.xml）
此视图文件定义了采购变更单的界面布局和交互元素。
1. 视图加载
当你进入采购变更单相关界面时，系统会加载 purchase_change_form 视图，该视图基于 purchase.change 模型构建。
2. 界面元素
- 按钮操作
- 提交按钮：按钮名称为“提交”，对应方法
button_submit。当采购变更单处于draft（草稿）状态时，该按钮可见，点击可进行提交操作。 - 确认按钮：按钮名称为“确认”，对应方法
button_change_done。当采购变更单处于submit（已提交）状态时，该按钮可见，并且只有具有purchase.group_purchase_manager权限组的用户才能看到并操作此按钮，点击可进行确认操作。 - 修改按钮：按钮名称为“修改”，对应方法
button_change_draft。当采购变更单处于submit（已提交）状态时，该按钮可见，点击可进行修改操作。
- 提交按钮：按钮名称为“提交”，对应方法
- 状态显示
界面上有一个状态字段state，使用statusbar小部件展示，可显示的状态包括draft（草稿）、submit（已提交）、done（已完成），该字段为只读字段。 - 基本信息显示
- 显示“采购变更单”标题以及变更单的名称，名称字段为只读。
- 显示源采购订单信息（
old_order_id），在具有base.group_multi_company权限组时显示，当变更单状态为done（已完成）时，该字段为只读。 - 显示供应商信息（
partner_id），该字段为只读且强制保存。
（二）采购变更信息导出为 Excel 文件（purchase_change/controllers/download.py）
该功能允许用户将采购变更信息导出为 Excel 文件。
1. 导出操作入口
在 purchase_change/wizard/purchase_change_download.py 中定义了一个向导 PurchaseChangeDownload，在相关界面可找到“采购变更下载”操作入口。
2. 操作步骤
- 在向导界面选择需要导出的采购变更单（
order_ids字段，支持多选），类型默认为“采购变更单”（type字段）。 - 点击“下载”按钮（对应方法
action_download），系统会将选择的采购变更单信息传递给/web/export/purchase_change_xls路由。
3. 导出文件生成过程
- 系统会根据传递的采购变更单 ID 列表，从数据库中获取相应的采购变更记录。
- 为每个采购变更记录生成一个 Excel 工作表，工作表名称为采购变更单的名称（若没有名称则为“采购变更单”）。
- 在工作表中填充采购变更单的基本信息，如采购变更单号、源采购订单、供应商、变更人等。
- 填充采购变更单的明细信息，包括产品、说明、原数量、变更后数量、单位、单价、变更后单价、税率、小计等。
- 最后计算并填充未税金额、税率设置、合计等信息。
- 生成的 Excel 文件以“采购变更”加上当前日期时间戳命名，文件格式为
.xls。
三、注意事项
- 导出 Excel 文件时，需要确保你有相应的权限，且系统环境中已正确安装
xlsxwriter库。 - 在操作采购变更单的按钮时，需注意按钮的可见状态和权限限制，避免误操作。
