Fastbill Skill

Verwalte Fastbill-Buchhaltung direkt aus Clawdbot: Kunden, Rechnungen, Produkte und Einnahmen.

Setup

1. API-Zugangsdaten holen

1. In Fastbill einloggen → Einstellungen → API
2. API-Key kopieren (oder neu generieren)

2. Environment Variables setzen

export FASTBILL_EMAIL="deine@email.de"
export FASTBILL_API_KEY="dein-api-key"

Verwendung

Kunden

Kunden auflisten:

<skill>/scripts/fastbill.sh customer-list [limit] [offset]

Kunden suchen:

<skill>/scripts/fastbill.sh customer-search "Suchbegriff"

Kunden Details:

<skill>/scripts/fastbill.sh customer-get <customer_id>

Kunden anlegen:

<skill>/scripts/fastbill.sh customer-create '{"CUSTOMER_TYPE":"business","ORGANIZATION":"Firma GmbH","LAST_NAME":"Kontakt","EMAIL":"info@firma.de"}'

Rechnungen

Rechnungen auflisten:

<skill>/scripts/fastbill.sh invoice-list [limit] [offset]

Rechnung Details:

<skill>/scripts/fastbill.sh invoice-get <invoice_id>

Rechnungen eines Kunden:

<skill>/scripts/fastbill.sh invoice-by-customer <customer_id>

Rechnung erstellen:

<skill>/scripts/fastbill.sh invoice-create '{"CUSTOMER_ID":"12345","ITEMS":[{"DESCRIPTION":"Beratung","UNIT_PRICE":"100.00","QUANTITY":"8"}]}'

Rechnung finalisieren (Entwurf → final):

<skill>/scripts/fastbill.sh invoice-complete <invoice_id>

Rechnung als bezahlt markieren:

<skill>/scripts/fastbill.sh invoice-setpaid <invoice_id> [datum]

Rechnung per E-Mail versenden:

<skill>/scripts/fastbill.sh invoice-send <invoice_id> <empfaenger@email.de>

Rechnung stornieren:

<skill>/scripts/fastbill.sh invoice-cancel <invoice_id>

Produkte/Artikel

Produkte auflisten:

<skill>/scripts/fastbill.sh product-list [limit] [offset]

Produkt erstellen:

<skill>/scripts/fastbill.sh product-create '{"TITLE":"Beratungsstunde","UNIT_PRICE":"120.00","VAT_PERCENT":"19"}'

Einnahmen/Ausgaben

Einnahmen auflisten:

<skill>/scripts/fastbill.sh revenue-list [limit] [offset]

Sonstiges

Wiederkehrende Rechnungen:

<skill>/scripts/fastbill.sh recurring-list

Rechnungsvorlagen:

<skill>/scripts/fastbill.sh template-list

Agent-Anweisungen

Typische Anfragen

"Zeige offene Rechnungen"

1. invoice-list 100 aufrufen
2. Filtern nach STATE != "paid"
3. Übersichtlich formatieren

"Erstelle Rechnung für Kunde X"

1. customer-search "X" für Kunden-ID
2. Items zusammenstellen (Beschreibung, Preis, Menge)
3. invoice-create mit JSON
4. Optional: invoice-complete zum Finalisieren
5. Optional: invoice-send zum Versenden

"Markiere Rechnung als bezahlt"

1. invoice-search oder invoice-list für Invoice-ID
2. invoice-setpaid <id> mit optionalem Datum

"Wer schuldet uns noch Geld?"

1. invoice-list 100
2. Filtern nach STATE = "unpaid" oder "overdue"
3. Gruppieren nach Kunde, Summen berechnen

Formatierung

Rechnungsliste:

📋 Offene Rechnungen:

• RE-2026-001 | Kunde A | 1.200,00 € | fällig 15.02.
• RE-2026-002 | Kunde B | 850,00 € | überfällig seit 10.01. ⚠️

Gesamt: 2.050,00 €

Zahlungsarten (PAYMENT_TYPE)

| Code | Bedeutung | |------|-----------| | 1 | Überweisung | | 2 | Lastschrift | | 3 | Bar | | 4 | PayPal | | 5 | Vorkasse | | 6 | Kreditkarte |

Rechnungsstatus (STATE)

| Status | Bedeutung | |--------|-----------| | draft | Entwurf | | created | Erstellt (noch nicht versendet) | | unpaid | Versendet, noch offen | | overdue | Überfällig | | paid | Bezahlt | | canceled | Storniert |

Kundentypen (CUSTOMER_TYPE)

| Typ | Bedeutung | |-----|-----------| | business | Geschäftskunde (ORGANIZATION erforderlich) | | consumer | Privatkunde (FIRST_NAME, LAST_NAME erforderlich) |

API-Referenz

Dokumentation: https://apidocs.fastbill.com/

API-URL: https://my.fastbill.com/api/1.0/api.php

Authentifizierung: HTTP Basic Auth mit Email + API-Key

Format: JSON (oder XML)

Wichtige Services:

• customer.get/create/update/delete
• invoice.get/create/update/delete/complete/cancel/sendbyemail/setpaid
• article.get/create/update/delete
• revenue.get/create
• subscription.get (wiederkehrende Rechnungen)
• template.get (Rechnungsvorlagen)

Rate Limits:

• Solo: 50 Calls/h
• Pro: 500 Calls/h
• Premium: 1000 Calls/h