年度预算协同平台
连接船东与代理,让预算协同更清晰。
连接航运 · 让预算更清晰
环境与接口说明
审核工作台:跨代理案例列表、船东实际数据导入与准备、差异对比与原因审核、通过/退回、汇率等基础数据维护、最终导出。已接真实接口(登录/会话、案例读取、对比视图、汇率、船东报表上传、审核通过/退回);本部署为验收演示环境,请勿输入真实凭据。
代理案例列表(跨代理,只读)
点击某个案例即切换当前案例并重载本页对比视图;本页不重算金额、缺失值显示“暂无依赖数据”。
当前案例月份数 N:待总管理人确认
审核人只能审核、批注、通过或退回,不能改写代理已提交的预算金额。批准为终态锁定、不自动重开;退回后代理按退回理由修改并重新提交。完成下方对比核对后,在「最终审核操作」区通过或退回。
尚未提交。
汇率维护(审核人)
保存成功后本页会自动重新读取并显示新汇率与来源。仅审核人可维护汇率。
技术说明
写入口为 PUT /api/v1/fx-rates(body:currency_code / year / rate_cny_per_unit,汇率为十进制字符串)。需审核人权限;代理账号会被后端 403 拒绝。
审核侧船东报表上传(.xlsx)
上传后展示命中代理数、批次复用与跳过原因;解析失败会如实提示,不伪造成功。
技术说明
上传到 POST /api/v1/owner-reports(base64,上限 8 MiB,含 fiscal_year)。
船东数据与代理预算对比
左右滑动查看全部对比列,科目名称会保持固定。
| 科目 | 船东1~8月实际(原币) | 船东全年(原币) | 船东1~8月实际(本币) | 船东全年(本币) | 代理2027预算 | 代理2026年化(原币) | 代理2026年化(本币) | 差异 | 差异率 | 环比 | 环比率 | 原因说明 |
|---|
只读展示:金额一律原样,本页不计算、不取整;缺失或不可用显示“待补/不可用”,不以 0 代替。
技术说明
数据来自 GET /api/v1/cases/{case_id}/comparison。列组①–⑧按原币口径,本币值仅展示。行结构按 docs/architecture/reviewer-comparison-view.md 二、行结构:第一段(船代)5 项(AGF / MGF / CGF / TGF / DD COM)+ 小计;第二段(货代)操作佣金=DOPT+OPT、揽货佣金=NDSAL+NSAL、运费收取佣金=DCOL+COL、进舱单的local charge返还佣金 + 小计;末行总计(=两段小计之和),故共 12 行(2 个小计 + 1 个总计);小计行与总计行加粗。
最终审核操作
核对上方对比与船东数据后,在此通过或退回本次提交。退回需填写理由。
报告输出
按当前选中的提交版本生成预算报告,包含原币金额、全年预估、原因说明和审核记录。
选择提交版本后,点击“预览报告”。
提交与交付结果
尚未读取提交信息。
技术详情
提交版本:
交付结果
技术说明
数据来自只读 GET /api/v1/submissions/{submission_id}/artifacts(state 由后端交付表状态派生,未枚举的取值按原文显示)。本页不重算、不写回、不发起任何写请求;下载链接指向只读 GET /api/v1/artifacts/{artifact_id}/download。
技术详情
历史提交
技术说明
采纳规则:历史提交里 version 最大者为「当前提交」;退回后重新提交会生成新的 version,界面自动切换到最新一条。每条目自带「采纳为当前提交」按钮,点击后立即用该 submission_id 覆盖当前目标并重绘本页「当前提交」文案(只改目标,不发出任何写请求)。退回/审核(approve)都作用于已采纳的 submission_id,且 If-Match 取案例冻结 revision(GET /api/v1/cases/{id} 的 ETag),不使用提交版本号。本区数据来自 GET /api/v1/submissions/{submission_id}(冻结快照与交付登记),本页不重算金额、不写回、不发起任何写请求;交付状态为 null 或缺失时显示"暂无登记"。
呈现行
技术详情
技术说明
只读展示:数据来自 GET /api/v1/submissions/{submission_id}/presentation-rows(冻结快照的年化口径)。金额原样展示,本页不重算、不取整;缺失依赖显示“暂无依赖数据”,不以 0 代替。
结构化数据导出
提交审核通过后,可导出代理填列数据(CSV / XLSX)。未完成或失败时不会生成文件;Word 附件审核报告暂不可用。
技术说明(端点与联调证据)
导出已真实可用,需该提交已审核通过;未导出或失败时不会生成任何文件。状态码 202 仅表示受理,不表示完成。xlsx 导出已实现(与 CSV 同源同数据);仍未实现:Word 附件审核报告(模板映射未确认)。导出为只读 GET /api/v1/submissions/{submission_id}/agent-input.csv;下载件与后端响应体逐字节相同(含 UTF-8 BOM 与 CRLF),已在真实 Chrome + 真实后端联调通过(QA 证据 backend/evidence/shouye-qa/ui-export-bom-verify-0155)。