Klientenportal

这是基于Playwright的脚本工具，可自动化RZL Klientenportal.at会计文档交换门户操作，核心功能含登录验证、登出清会话、按分类上传收据/发票、查看会计师发布文件、列表及下载会计师发来的文档。适合需频繁与税务会计交换会计资料的用户，替代手动重复操作。通过命令行传入参数执行，结果以终端提示反馈，下载文件可指定目录，需配置环境变量及依赖。

odrobnik

热度 79.75

最近更新 2026-05-11 16:28:08

分类：自动化依赖：代码执行 / 联网浏览搜索 / 读写文件应用场景：自动化脚本 / 财务 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add klientenportal

Metadata

name: klientenportal
description: Automate RZL Klientenportal.at — a web-based portal by RZL Software for exchanging receipts, invoices, and reports with your tax accountant. Login/logout, upload documents (Belegübergabe), list released files, and download Kanzleidokumente via Playwright.
summary: RZL Klientenportal automation: upload receipts, download reports.
version: 1.5.1
homepage: https://github.com/odrobnik/klientenportal-skill
metadata: {"openclaw":{"emoji":"📋","requires":{"bins":["python3","playwright"],"python":["playwright"],"env":["KLIENTENPORTAL_PORTAL_ID","KLIENTENPORTAL_USER_ID","KLIENTENPORTAL_PASSWORD"]}}}

RZL Klientenportal

Automate klientenportal.at — a web portal by RZL Software for securely exchanging accounting documents between clients and their tax accountant.

Entry point: {baseDir}/scripts/klientenportal.py

Setup

See SETUP.md for prerequisites and setup instructions.

Commands

Login / Logout

python3 {baseDir}/scripts/klientenportal.py login          # Test login (validates credentials)
python3 {baseDir}/scripts/klientenportal.py logout         # Clear stored browser session

Upload Documents (Belegübergabe)

Upload receipts/invoices to a specific Belegkreis category:

python3 {baseDir}/scripts/klientenportal.py upload -f invoice.pdf --belegkreis KA
python3 {baseDir}/scripts/klientenportal.py upload -f *.xml --belegkreis SP

Code	Name	Use for
ER	Eingangsrechnungen	Incoming invoices (default)
AR	Ausgangsrechnungen	Outgoing invoices
KA	Kassa	Credit card payments
SP	Sparkasse	Bank account receipts

List Released Files

Show files your accountant has released (freigegebene Dokumente):

python3 {baseDir}/scripts/klientenportal.py released

Received Files (from Accountant)

List files received from your accountant (Kanzleidokumente / Auswertungen):

python3 {baseDir}/scripts/klientenportal.py received              # List all
python3 {baseDir}/scripts/klientenportal.py received -n 5          # Latest 5
python3 {baseDir}/scripts/klientenportal.py received --json         # JSON output

Output columns: Datei, Von, Dokumentbereich, Empfangen

Download Received Files

Download specific files from the received files list:

python3 {baseDir}/scripts/klientenportal.py received-download --latest                  # Latest file
python3 {baseDir}/scripts/klientenportal.py received-download 1 2 3                     # By index (1=latest)
python3 {baseDir}/scripts/klientenportal.py received-download "10-12_2025"              # By name pattern
python3 {baseDir}/scripts/klientenportal.py received-download "10-12_2025" -o ~/Downloads  # Custom output

Single-file downloads are auto-extracted from ZIP wrapper.

Download Kanzleidokumente (Legacy)

Download all available Kanzleidokumente at once:

python3 {baseDir}/scripts/klientenportal.py download                    # To default dir
python3 {baseDir}/scripts/klientenportal.py download -o /path/to/dir    # Custom output dir

Default output: /tmp/openclaw/klientenportal/

Options

--visible — Show the browser window (useful for debugging or first login)

Recommended Flow

login → upload / released / download → logout

Always call logout after completing all operations to clear the stored browser session.