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。

