Odoo Reporting

核心用法

Odoo Financial Intelligence 是一个面向企业财务场景的只读报告生成工具，通过RPC直连Odoo ERP的会计分录（account.move.line）而非发票摘要，确保数字可溯源、可复现。用户以自然语言发起请求（如"上季度财务健康报告""应收账款账龄"），系统自动完成多公司检测、会计期间确认、科目范围澄清，最终生成含可视化图表的专业报告。

关键工作流：
1. 参数收集 → 自动识别缺失信息并追问（公司/期间/科目/分组维度/输出格式）
2. 数据获取 → 从Chart of Accounts和日记账分录拉取原始数据
3. 准则适配 → 根据公司所在国自动匹配IFRS/US GAAP/Ind-AS/CAS等标准，调整数字格式、日期格式、报表命名
4. 报告生成 → 输出PDF（A4专业版）、WhatsApp卡片（1080×1080深色主题PNG）或Excel

预置报告类型： 财务健康度（现金流、burn rate、runway）、收入分析（环比趋势、TOP客户）、应收/应付账龄、费用拆解、高管摘要单页、自定义即席对比。

显著优点

• 审计级可信度：基于ledger entry而非业务单据，每条数字附带方法论注释
• 多准则原生支持：自动识别10+会计准则（IFRS/US GAAP/Ind-AS/UK GAAP/SOCPA/CAS/JGAAP等），无需手动切换模板
• 零配置可视化：图表自动嵌入，遵循"若有助于理解则默认包含"原则
• 股权计算准确性：正确处理Odoo特有的equity_unaffected suspense账户，实时计算当年损益确保资产负债表平衡
• 输出场景覆盖：既满足管理层WhatsApp快速阅览，也支持财务部门PDF存档及Excel二次分析

潜在缺点与局限性

• 只读约束：无法进行调账、分录创建或任何写入操作，纯报告用途
• Odoo版本依赖：RPC接口绑定特定Odoo版本，升级可能导致兼容性问题
• 环境配置门槛：需预置ODOO_URL/DB/USER/PASSWORD等环境变量，非开箱即用
• 本地化深度有限：虽识别准则但复杂的税务调整（如印度GST进项转出）需额外验证
• 实时性边界：基于已过账分录，未包含未过账凭证或银行在途资金

适合人群

• 中小企业财务负责人：需快速生成符合当地准则的报表向股东/银行提交
• 代账公司/外包CFO：服务多Odoo客户时标准化报告交付
• 审计师做 preliminary analytics：获取被审计单位ledger-based数据用于风险评估
• 运营管理层：通过WhatsApp卡片监控现金流、burn rate等关键指标

常规风险

| 风险类型 | 说明 | 缓释建议 |

|---------|------|---------|

| 数据完整性风险 | Odoo端科目配置错误（如费用误入资产类）导致报表失真 | 首次使用前运行`doctor`诊断，核对Chart of Accounts映射 |

| 准则误判风险 | 跨国集团子公司准则选择错误 | 强制指定`--standard`参数覆盖自动检测 |

| 期间边界风险 | 用户口语表述（"上月"）与实际会计期间错位 | 系统二次确认具体起止日期，避免沉默假设 |

| 访问凭证风险 | .env文件权限不当导致Odoo账号泄露 | 遵循最小权限原则，使用只读专用Odoo账号 |

| 股权计算风险 | 未理解`equity_unaffected`机制导致Balance Sheet不平 | 严格遵循文档公式：Equity Proper + Retained Earnings + Current Year Earnings |

核心功能

Odoo Financial Intelligence 是一款面向企业财务团队的智能报告工具，通过 Odoo XML-RPC/JSON-RPC 接口直连 ERP 总账，生成审计级财务报表与分析。核心能力包括：

财务报表生成

• 损益表(P&L)、资产负债表、现金流量表（支持间接法/直接法）
• 自动识别 IFRS、US GAAP、Ind-AS、UK GAAP、中国会计准则(CAS)、日本JGAAP 等 10+ 地区标准
• 正确处理 equity_unaffected 暂记账户，确保报表平衡

深度财务分析

• 现金流健康度：现金头寸、燃烧率、资金跑道
• AR/AP 账龄分析，逾期风险预警
• 收入趋势分析（同比/环比）、客户贡献度排名
• 支出拆解（按供应商/类别）

输出与可视化

• 自动渲染专业图表（现金流趋势、账龄饼图、收支对比等）
• 多格式导出：A4 PDF（白底铜色专业风格）、WhatsApp 卡片（1080×1080 深蓝主题）、Excel

显著优点

1. 数据源权威性：直接读取 account.move.line 总账分录，非发票汇总，数字可审计、可追溯
2. 标准合规性：自动检测企业所在国家，应用对应会计准则的报表格式、数字呈现方式（千分位、负号表示、日期格式）
3. 安全架构严谨：只读白名单机制（SAFE_METHODS/BLOCKED_METHODS），禁止任何 create/write/unlink 操作
4. 交互式参数收集：智能解析自然语言请求（"上季度财务健康报告"），缺失信息自动追问
5. 可视化零配置：根据报告类型自动匹配最佳图表，无需用户手动选择

潜在局限与风险

| 局限/风险 | 说明 | 缓解建议 |

|-----------|------|---------|

| 依赖 Odoo 实例可用性 | 若 Odoo 服务器离线或网络中断，报告生成失败 | 配置健康检查与离线提醒 |

| SSL 验证可禁用 | 提供 `--insecure` 选项供内网测试，生产环境误用存在中间人攻击风险 | 生产部署移除该选项或强制 `verify_ssl=True` |

| 凭证环境变量存储 | 依赖 `.env` 文件权限管理，若权限配置不当存在泄露风险 | 设置 600 权限，或改用 Docker Secrets/云密钥管理 |

| 子进程调用本地 Agent | `openclaw_intelligence.py` 通过 `subprocess.run()` 调用本地 AI 分析代理 | 验证二进制路径，防止 PATH 劫持 |

| 多公司环境需人工确认 | 不自动选择公司，必须用户指定，避免跨公司数据混淆 | 遵循设计，每次主动询问 |

适合人群

• CFO/财务总监：需要快速获取执行层摘要与资金健康度
• 审计与合规团队：需生成符合当地准则的审计证据链
• Odoo 实施顾问：为客户快速交付标准化财务报告方案
• 中小企业主：无专职财务团队，需自动化理解经营状况

常规风险提示

• 数据敏感性：财务数据属于核心商业机密，确保 Odoo 实例启用 TLS 1.2+，避免公共网络传输
• 版本兼容性：基于 Odoo 标准模型开发，若企业重度定制 Chart of Accounts 结构，可能需适配调整
• AI 分析边界：自然语言查询通过本地 OpenClaw Agent 处理，复杂财务逻辑建议人工复核
• 报告时效性：基于历史账簿数据，非实时银行流水，重大资金变动存在 T+1 延迟

---

> 使用建议：生产环境部署前，完成 SSL 强制验证配置、凭证文件权限加固（600）、openclaw 二进制完整性校验三项安全基线。