概述
RZL Klientenportal 是奥地利 RZL Software 提供的税务客户门户,专为中小企业和个人用户设计,实现与税务会计师之间的安全文档交换。本 Skill 基于 Playwright 浏览器自动化技术,提供完整的 CLI 工作流:登录认证、文档上传分类、查询已发布文件、下载事务所文档及安全登出。
核心用法
python3 klientenportal.py login python3 klientenportal.py upload -f invoice.pdf --belegkreis KA python3 klientenportal.py released # 列出可下载文件 python3 klientenportal.py download -o /path python3 klientenportal.py logout # 必须执行以清理会话
支持四种票据分类(Belegkreis):ER(进项发票)、AR(销项发票)、KA(现金/信用卡)、SP(储蓄银行)。
显著优点
- 官方生态集成:直接对接奥地利主流税务软件 RZL,无需手动登录网页
- 完整工作流闭环:从登录到登出的全自动化,会话状态本地持久化
- 安全存储设计:会话文件权限严格限制(目录 700、文件 600),凭证仅限
config.json - 批量处理能力:支持通配符批量上传 XML/PDF 等格式的电子票据
潜在缺点与局限性
- 地域锁定:仅适用于奥地利 RZL Klientenportal.at 用户,其他国家税务系统不支持
- 浏览器依赖:依赖 Playwright 和 Python3,环境配置较复杂(需安装 Chromium 等浏览器)
- 无图形界面:纯命令行操作,对非技术用户门槛较高
- 会话管理风险:若未执行
logout,本地会话文件可能存在残留风险
适合人群
- 奥地利中小企业财务负责人需定期向税务师提交票据
- 会计事务所 IT 管理员批量处理多客户文档上传
- 自动化工作流开发者集成税务文档交换到 CI/CD 或定时任务
常规风险
| 风险项 | 说明 | 缓解建议 |
|--------|------|---------|
| 凭证泄露 | `config.json` 存储明文凭据 | 设置文件权限 600,使用专用服务账户 |
| 会话劫持 | 持久化会话 Cookie 可能被复制利用 | 务必执行 `logout`,定期清理 `{workspace}/klientenportal/` || 上传误操作 | 错误选择 Belegkreis 导致税务分类错误 | 对照表格确认分类代码后再执行 |
| 浏览器漏洞 | Playwright 依赖的 Chromium 存在 0-day 风险 | 保持 `playwright` 库更新至最新版 |
---
评估基于 Skill 文档 v1.3.1,最后更新:2024年