修复手工开票下载与错误提示

docs/project/frontend-backend/backend-to-frontend-notes.md

@@ -399,6 +399,8 @@ M009 后端 CP2 已实现：页面可不依赖订单或任务，用户手工填
 - 正式业务生成接口为 `POST /api/reservation/invoices/manual-generations`，需要 Bearer token、酒店访问权和 `RESERVATION_INVOICE_GENERATE` 权限。
 - 第一版后端只支持 `source_type=MANUAL`，`task_id` / `order_id` 可以为空；传入时后端会反查对象所属酒店；如果两者同时传入，任务必须属于该订单，否则返回 `RESERVATION_INVOICE_CONTEXT_MISMATCH`。
 - 第一版后端最多支持 10 条费用明细；超过 10 条会返回 `RESERVATION_INVOICE_VALIDATION_FAILED`。
+- `pdf_url` 前端会优先用 `fetch + Blob` 下载；如果 OSS CORS 不允许浏览器读取文件，则只能退回打开 PDF 页面。若测试环境或正式环境需要稳定下载按钮，建议后端后续提供带 `Content-Disposition` 的下载代理或签名下载 URL。
+- 错误响应里的 `error_code` 用于普通用户主提示；`message` / `details[]` 前端仅折叠为技术详情，避免把字段路径、模板异常等内部信息直接铺到主提示区。
 - 第一版暂未提供 Invoice 历史列表、详情查询、任务 / 订单预填接口和客户联系人目录查询接口；前端客户 / 联系人候选可先按 M009 文档中的种子数据实现。
 - 前端不得直接调用 `POST /api/system/document-conversions/excel-to-pdf` 来完成业务开票；该接口是 M008 调试 / 后台工具能力，受 access key 控制，不具备业务开票审计和权限边界。