Klientenportal

核心用法

本 Skill 专为奥地利税务场景设计，通过 Playwright 自动化浏览器操作，实现客户端与税务会计师之间的安全文档交换。核心功能覆盖完整工作流：

1. 身份认证管理

• login 命令验证并持久化会话，支持通过环境变量配置 Portal ID、User ID 和 Password
• logout 强制清除浏览器会话，防止凭据残留

2. 文档上传（Belegübergabe）
支持批量上传收据、发票至指定凭证分类（Belegkreis）：

• ER（Eingangsrechnungen）- 进项发票（默认）
• AR（Ausgangsrechnungen）- 销项发票
• KA（Kassa）- 信用卡凭证
• SP（Sparkasse）- 银行账户凭证

3. 文档获取

• released 列出会计师已释放的文件
• download 批量下载 Kanzleidokumente 至本地（默认 /tmp/openclaw/klientenportal/）

显著优点

• 奥地利本地化深度集成：直接对接 RZL Software 官方 Klientenportal，符合奥地利会计流程
• 无头自动化：默认后台运行，支持 --visible 调试模式
• 分类上传：Belegkreis 代码映射确保凭证准确归类
• 批量处理能力：通配符上传、全量下载提升效率

潜在缺点与局限性

• 地域限制：仅适用于使用 RZL Software 的奥地利税务会计师客户
• 平台绑定：依赖 Playwright 和 Python 3 环境，非技术用户配置门槛较高
• 下载粒度粗：不支持单文件选择，只能全量下载
• 无原生 API：基于浏览器自动化，受页面结构变更影响
• 会话管理：需显式调用 logout，遗忘可能导致会话残留

适合人群

• 奥地利中小企业财务人员需定期向会计师批量提交凭证
• 个人经营者寻求自动化月度/季度文档提交流程
• 开发者构建奥地利本地化会计自动化 pipeline

常规风险

• 凭据安全：Password 等敏感信息通过环境变量注入，需确保运行环境隔离
• 浏览器自动化稳定性：页面改版或网络波动可能导致脚本中断
• 数据本地存储：默认下载至 /tmp，需关注临时文件权限与清理
• 版本耦合：Playwright 浏览器版本与目标站点兼容性需持续维护