# 对账单单价刷新功能说明

## 功能概述

对账单管理系统的单价刷新功能可以自动从客户订单中获取最新的含税单价，支持批量刷新和单个获取。系统会根据合同编号和物料名称智能匹配客户订单中的单价。

## 使用方法

### 1. 批量刷新所有对账单单价
- 在对账单管理页面，点击"刷新单价"按钮
- 系统会自动匹配所有对账单记录并更新单价
- 更新完成后会显示成功更新的记录数量

### 2. 新增/编辑时获取单个单价
- 在新增或编辑对账单时，填写合同编号和物料名称
- 点击"获取单价"按钮，系统会自动匹配并填充单价
- 如果找到匹配的单价，会自动计算含税金额

## 匹配策略

系统采用多级匹配策略，按优先级顺序进行匹配：

### 策略1：精确匹配合同号
1. **精确匹配物料名**：合同号和物料名称完全一致
2. **部分匹配物料名**：对账单物料名包含客户订单物料名
3. **反向部分匹配**：客户订单物料名包含对账单物料名

### 策略2：关键词匹配
- 提取物料名称中的关键词（长度大于3的字符）
- 使用关键词在相同合同号下进行匹配

### 策略3：模糊匹配合同号
- 当合同号不完全一致时，检查是否包含关系
- 适用于合同号略有差异的情况

### 策略4：特殊物料处理
- **飞机盒**：默认单价 2 元
- **蓝牙模块**：取所有蓝牙模块的平均单价

## 注意事项

1. **数据一致性**：确保客户订单和对账单的合同编号使用统一的格式
2. **物料命名规范**：建议使用标准化的物料名称，避免使用简写或别名
3. **匹配精度**：系统会跳过单价相同的记录，只更新有变化的记录
4. **日志记录**：所有单价更新操作都会记录在系统日志中

## 常见问题

### Q: 为什么某些记录无法匹配到单价？
A: 可能的原因：
- 客户订单中没有对应的合同编号
- 物料名称差异较大
- 合同编号格式不一致

### Q: 如何提高匹配成功率？
A: 建议：
- 统一合同编号格式
- 标准化物料名称
- 定期更新客户订单数据

### Q: 匹配错误怎么办？
A: 可以手动编辑对账单记录，修正单价。系统不会覆盖已经手动修改的单价（除非再次刷新）。

## API接口

### 批量刷新单价
```
POST /api/reconciliations/refresh-prices
```

### 获取单个单价
```
POST /api/reconciliations/fetch-price
参数：
- contract_no: 合同编号
- material_name: 物料名称
```

## 更新日志

- 2025-01-27：实现基础价格刷新功能
- 2025-01-27：优化匹配策略，提高匹配成功率
- 2025-01-27：添加特殊物料处理逻辑