SOP与BOM对比校对,生成独立校对报告。支持单个SOP与多个BOM合并校对。从SOP提取物料信息(含页码、序号),与BOM对比,生成包含三个表格的报告:有差异物料(并排对比)、SOP独有物料、BOM独有物料。差异用红色标注,重复物料编码用黄色标注。自动清理临时文件和旧报告缓存。跨平台兼容(Linux/Mac/Windows)。支持多种SOP格式(标准格式、AR列格式、共享字符串格式)。智能检测位号和数量列,自动调整报告格式。优化行距显示更清晰。
openpyxl(用于读取数值类型的数量数据)
pip install openpyxl
python sop_bom_report.py bom.xlsx --sop sop.xlsx
# 多个 BOM 文件会合并后一起与 SOP 对比
python sop_bom_report.py bom1.xlsx bom2.xlsx bom3.xlsx --sop sop.xlsx
python sop_bom_report.py bom.xlsx --sop sop.xlsx -d ./reports
python sop_bom_report.py bom.xlsx --sop sop.xlsx -v
每次生成报告后自动执行:
sop_extract_*、bom_extract_*、report_*如需手动清理,可执行:
# Linux/Mac
rm -rf /tmp/sop_extract_* /tmp/bom_extract_* /tmp/report_*
# Windows (PowerShell)
Remove-Item -Path "$env:TEMP\sop_extract_*" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:TEMP\bom_extract_*" -Force -ErrorAction SilentlyContinue
Remove-Item -Path "$env:TEMP\report_*" -Force -ErrorAction SilentlyContinue
| 页码 | 序号 | 物料编码 | 名称规格 | 位号 | 数量 | 项次 | 物料编码 | 名称 | 规格 | 位号 | 数量 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SOP数据 | BOM数据 |
颜色标注:
SOP 中有但 BOM 中没有的物料,显示完整 SOP 数据(页码、序号、物料编码、名称规格、位号、数量)。
BOM 中有但 SOP 中没有的物料,显示完整 BOM 数据(项次、物料编码、名称、规格、位号、数量)。
三级提取策略:
当 SOP 文件符合标准格式时,使用以下列提取:
| 列 | 字段 | 说明 |
|---|---|---|
| BF | 页码 | 格式:"第X页,共Y页" |
| AN | 序号 | 范围 1-20 |
| AQ | 物料编码 | 格式:XXXXX-XXX-XXX |
| AX | 名称规格 | 名称和规格合在一起 |
| BI | 位号 | 物料位置信息 |
| BO | 数量 | 物料数量(优先使用 openpyxl 读取数值) |
当标准格式提取不到物料时,自动启用多列兼容模式:
| 列 | 字段 | 说明 |
|---|---|---|
| AQ/AR/AX/AN/BU/BF | 物料编码 | 自动扫描多列查找(按优先级) |
| AX/AQ/AR/AN/BU/BF | 名称规格 | 自动检测(排除物料编码本身) |
| BI/BJ/BK | 位号 | 自动检测 |
| BO/BP/BN/BQ | 数量 | 自动检测(优先使用 openpyxl 读取数值) |
特殊格式支持:
data_only=True 模式读取实际显示的数值当以上格式都无法提取时,直接从 Excel 共享字符串中提取物料编码:
^\d{5}-\d{3}-\d{3}$自动识别两种 BOM 格式:
| 列 | 字段 | 说明 |
|---|---|---|
| F | 项次 | 物料序号 |
| G | 物料编码 | 格式:XXXXX-XXX-XXX |
| H | 名称 | 物料名称 |
| I | 规格 | 规格型号 |
| K | 用量分子 | 用于计算数量 |
| L | 用量分母 | 用于计算数量 |
| M | 备注 | 包含位号信息 |
| 列 | 字段 | 说明 |
|---|---|---|
| H | 项次 | 物料序号 |
| I | 物料编码 | 格式:XXXXX-XXX-XXX |
| J | 名称 | 物料名称 |
| K | 规格 | 规格型号 |
| N | 用量分子 | 用于计算数量 |
| O | 用量分母 | 用于计算数量 |
| P | 备注 | 包含位号信息 |
智能检测:脚本会自动检测 BOM 文件使用哪种格式,优先检测新格式(G列物料编码)。
数量计算:实际用量 = 分子 ÷ 分母,分母为空或0时默认为1
对比时自动忽略:
{订单编号}_校对报告.xlsx15214-100-008 VV12548主板PCBA作业指导书-V04.xlsx,输出文件名为 15214-100-008_校对报告.xlsx用户发送 BOM 和 SOP 文件要求对比校对时触发。
Python 版本错误
错误: 需要 Python 3.8 或更高版本
解决:升级 Python 到 3.8+
临时目录权限错误
PermissionError: [Errno 13] Permission denied
解决:检查临时目录权限,或设置 TEMP 环境变量
文件编码错误
UnicodeDecodeError
解决:确保文件为 UTF-8 编码
运行时添加 -v 参数查看详细日志:
python sop_bom_report.py bom.xlsx --sop sop.xlsx -v