fastbill

name	fastbill
description	Fastbill Buchhaltung & Rechnungen - Kunden verwalten, Rechnungen erstellen/versenden, Produkte/Artikel pflegen, Einnahmen erfassen. Nutze für "Rechnung erstellen", "Kunden anlegen", "Rechnung versenden", "offene Rechnungen", "Umsätze".
metadata	{"clawdbot":{"emoji":"🧾","requires":{"env":"[Truncated]"}}}

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="[e-mail]"
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":"[e-mail]"}'

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> <[e-mail]>

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