修茈科技 LogoXCAGI企业业务自动化平台
ERP 与业务文件 / 单据与打印

单据模板与套打

已验证Web · 已验证代码更新于 2026-11-02

自定义发货单、合同等单据模板，支持导入与套打，适配企业现有单据格式。

返回 ERP 与业务文件

功能价值

自定义发货单、合同等单据模板，支持导入与套打，适配企业现有单据格式。

使用方式

管理员上传企业模板后，业务单据按模板自动填充生成。

所属模块

ERP 与业务文件 / 单据与打印

适用平台

Web · 已验证

已知限制

  • 极端复杂的 Word 模板元素可能需要适配

平台验证状态

本项适用于 1 个平台，逐平台独立判定：平台状态只由该平台的实机验收记录产生，总体状态由平台状态自动汇总，目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物；当前源码或新安装包仍需独立验收。

Web

已验证

验收结果：PASS；通过 3 / 失败 0；产品版本 1.0.0.5；Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3；验证时间 2026-09-29。Acceptance JSON SHA-256 827167216b3ee343daa9ee8f26f1c2be14253c89035e25c6a1c8ed30f441b3bd

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：通过；画面内容：本轮真实浏览器会话录像（webm）：管理端登录 → 模板写读回 → 内置模板 → 负例。；SHA-256：e7a73b884bd3566fe52c5098f0917b5cc809aa56aadbc0bb0934aff813803976（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/video/erp-templates-web-20260929-152047.webm） 下载原始录像

实机截图

单据模板与套打 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：管理端登录页「XCMAX 服务器后台 · 管理员登录」，账号框已填 admin、密码框为掩码。；SHA-256：f8f4ff197718c12ee3a6085d63fc667ce3cd2d08731e6a44d8892967a5c40f38（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/shot/00-login-form.png） 查看原图
单据模板与套打 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染模板写-读回真实 JSON：create 200、template_id=db:2，列表命中新建名称，按 id 读回名称与 2 个字段。；SHA-256：31252a6386b3adb20796792aa4958812e54c9cb3acb3ca65e99d09c9b9512e99（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/shot/TPL1-template-roundtrip.png） 查看原图
单据模板与套打 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染内置单据与销售合同模板真实 JSON（slug 清单）。；SHA-256：a312b8bec7dc577e1429c92728c8c67e35af8f124b4e1c0ea10b2ed39a4c273b（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/shot/TPL2-builtin-templates.png） 查看原图
单据模板与套打 已复核截图
媒体内容已复核，记录结论：验收结果：通过；画面内容：浏览器渲染空 body 创建 400 tool_failed 与不存在模板 404。；SHA-256：db9fdd6e7fe3827413e77aba610aec6220571b4e55f767e9ad3bcc5ddab72d02（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/shot/TPL3-template-negative.png） 查看原图

运行日志

下载原件：erp-templates-web-20260929-152047.log；SHA-256：889f155f0c00d17abc2088623942f63758b00fe8549dfb923b2d618e34adda49（仓库路径：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/erp-templates/log/erp-templates-web-20260929-152047.log）

安装包 / 部署产物 SHA-256：cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试（平台无关）

图片内容复核（2026-09-30，Mac 1.0.0.5）：模板库列出出货明细、出货记录和产品目录模板。

源码实现

  • FHD/app/fastapi_routes/document_templates.py
  • FHD/app/fastapi_routes/template_create.py
  • FHD/app/fastapi_routes/template_api.py

API 端点

  • /api/document-templates/*

自动化测试

  • FHD/tests/test_chat_template_save_chain.py

CI 门禁：FHD/.github/workflows/ci-cd.yml

CI 工作流定义

  • FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

下列资料未绑定到具体平台，仅作实现与历史资料参考，不计入任何平台状态，也不构成实机验收。

实机截图

单据模板与套打 已复核截图
记录结论：资料收录（未绑定平台验收）；SHA-256：e67d1e4a22ee123d555afe3c51cdf7a9c15c27c40d5d9d00ed45167b2a38035d（原始文件：FHD/docs/evidence/capabilities/erp-templates-01-template-library.png） 查看原图

证据原件存放于私有对象存储，页面通过短时效签名地址读取原图与原始录像； 「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本， 也可下载原件后用 sha256sum 自行核对。