# P23 报价成本核算引擎 接口清单

> 说明：路径为平台内规划路径，经现有数据层访问；数据库未就绪时回退本机演示数据。

## 1. 计价

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/quote/calc` | 执行成本计算，返回区间价与分项明细 |
| POST | `/quote/calc/from-dfm` | 由 DFM 任务读取参数并计算 |
| POST | `/quote/calc/from-panel` | 由拼板任务读取利用率并计算 |
| GET | `/quote/detail?id=` | 报价明细 |
| GET | `/quote/list?user_id=&supplier_id=&rfq_id=` | 报价记录列表 |
| POST | `/quote/export` | 生成报价单文件 |

## 2. 供应商配置

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/quote/supplier-config?supplier_id=` | 读取本厂计价参数 |
| PUT | `/quote/supplier-config/{supplier_id}` | 维护单价、工时、损耗、溢价系数 |

## 3. 行情与风控

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| GET | `/quote/market-base?layer=&thickness=&surface=` | 读取行情基准价 |
| POST | `/quote/validate` | 校验报价是否超出风控区间 |

## 4. RFQ 联动

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | `/rfq/bind-quote` | 报价绑定询价单 |
| GET | `/rfq/quote-compare?rfq_id=` | 多供应商比价 |

## 5. 数据字段

`quote_task`：`id` `quote_sn` `user_id` `supplier_id` `rfq_id` `dfm_id` `panel_id` `stack_id` `layer_count` `board_size_w` `board_size_h` `qty` `unit_price` `total_price` `currency` `lead_time` `valid_days` `quote_json` `status`

`quote_supplier_config`：`supplier_id` `surface_treat` `base_cost` `process_rate` `loss_rate` `rush_rate` `enabled`

`quote_market_base`：`layer` `thickness` `surface_treat` `base_price` `effective_from`

`quote_item`：`task_id` `item_code` `item_name` `qty` `unit` `amount` `note`

## 6. 错误码

| 码 | 含义 | 处理 |
| --- | --- | --- |
| 23001 | 参数缺失或非法 | 提示具体字段与合法区间 |
| 23002 | DFM 存在致命风险 | 阻断报价并给出风险项 |
| 23003 | 无可用基准价 | 回退通用基准并标注 |
| 23004 | 报价超出风控区间 | 标记预警，允许提交但需备注 |
| 23005 | 报价已过期 | 提示重新计算 |
| 23006 | 导出失败 | 保留参数并允许重试 |

## 7. 状态机

`draft → calculated → submitted → bound_to_rfq → expired / void`。