FastBill Auto-Upload für macOS

Automatischer Upload von Rechnungen und Belegen zu FastBill via Ordneraktion (Folder Action).

Features

• 📁 Dateien in Ordner legen → automatisch zu FastBill hochladen
• 🔔 macOS-Benachrichtigungen bei Erfolg/Fehler
• 📦 Optionale Archivierung hochgeladener Dateien
• 📄 Unterstützt PDF, JPG, JPEG, PNG

Voraussetzungen

• macOS mit Automator
• FastBill-Account mit API-Zugang
• API-Key (findest du unter FastBill → Einstellungen → API)

Installation

1. Ordner erstellen

mkdir -p ~/Downloads/Rechnungen/
mkdir -p ~/Downloads/Rechnungen/Archiv

Ordner können natürlich auch woanders liegen.

2. Automator Ordneraktion erstellen

1. Automator öffnen → Neues Dokument → Ordneraktion
2. Oben den Zielordner auswählen (~/Downloads/Rechnungen/)
3. "Shell-Skript ausführen" in den Workflow ziehen
4. Einstellungen:
   • Shell: /bin/bash
   • Eingabe übergeben: als Argumente
5. Inhalt von fastbill-upload.sh in das Fenster kopieren
6. E-Mail & API-Key anpassen
7. Wenn gewünscht: weitere Anpassungen (siehe nächster Punkt)
8. Speichern (⌘S)

Konfiguration

Im Skript anpassbar:

# Archivierung deaktivieren
ENABLE_ARCHIVE=false

# Anderen Archivordner verwenden
ARCHIVE_FOLDER="/pfad/zum/archiv"

# Anderes Logfile
LOG_FILE="$HOME/Library/Logs/fastbill-upload.log"

Fehlerbehebung

Ordneraktion wird nicht ausgeführt

• Rechtsklick auf Ordner → Dienste → Ordneraktionen konfigurieren
• "Ordneraktionen aktivieren" anhaken

"Operation not permitted"

• Systemeinstellungen → Datenschutz & Sicherheit → Automation
• Automator Zugriff erlauben

API-Fehler

Logfile prüfen:

cat ~/Downloads/Rechnungen/Logs/fastbill-upload.log

Wie es funktioniert

Das Skript nutzt die FastBill API mit document.create, um Dateien in die Dokumenten-Inbox hochzuladen. Von dort können sie in FastBill weiterverarbeitet werden.

Lizenz

MIT License - siehe LICENSE