API Dokumentation

💬

Hallo, ich bin Sophie! 👋 Sie möchten BuchhaltGenie in Ihre eigenen Systeme integrieren? Wunderbar - ich erkläre Ihnen gerne, wie unsere API funktioniert und wie Sie sie am besten nutzen können.

Unsere REST API ermöglicht es Ihnen, Rechnungen automatisch zu erstellen, Kundendaten zu synchronisieren und sogar mich - Sophie - in Ihre eigene Anwendung einzubinden. Klingt spannend, oder?

🔐

DSGVO-Hinweis: Über die API verarbeiten Sie Geschäftsdaten Ihrer Kunden. Gemäß DSGVO Art. 28 sind Sie als Auftragsverarbeiter verantwortlich für die korrekte Handhabung dieser Daten. BuchhaltGenie stellt Ihnen einen Auftragsverarbeitungsvertrag (AVV) zur Verfügung.

Basis-URL

Alle API-Aufrufe gehen an unsere sichere Produktionsumgebung:


https://buchhaltgenie.at/api/v1

Für Ihre Entwicklung und Tests steht Ihnen eine separate Testumgebung zur Verfügung:


https://api-sandbox.buchhaltgenie.at/v1

💡

Sophie’s Tipp: Nutzen Sie immer zuerst die Sandbox-Umgebung zum Testen! Dort können Sie experimentieren, ohne echte Geschäftsdaten zu beeinflussen. Die Sandbox ist identisch mit der Produktionsumgebung, verwendet aber isolierte Testdaten.

Was kann die API für Sie tun?

Erstellen Sie UStG-konforme Rechnungen direkt aus Ihrem System

Rechnungen automatisieren

Binde mich als KI-Assistentin in Ihre Anwendung ein

Sophie AI integrieren

Halte Kundendaten zwischen Ihren Systemen aktuell

Daten synchronisieren

Greife auf Buchungen und Finanzdaten zu

Transaktionen abrufen

Schnellstart in 3 Schritten

API-Schlüssel erstellen

Navigieren Sie in BuchhaltGenie zu Einstellungen > API-Zugang und erstellen Sie einen neuen Schlüssel. Sie erhalten einen Schlüssel im Format sk_live_xxxx für die Produktion oder sk_test_xxxx für Tests.

Ersten API-Aufruf machen

Testen Sie die Verbindung mit einem einfachen Aufruf:


curl -X GET "https://buchhaltgenie.at/api/v1/me" \
  -H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxx"

Loslegen!

Wenn Sie eine erfolgreiche Antwort erhalten, sind Sie bereit für die Integration. Schauen Sie sich unsere Endpunkt-Dokumentation an.

Verfügbare Endpunkte

Endpunkt	Beschreibung	Status
Rechnungen	Erstellen, abrufen und verwalten Sie Rechnungen	Verfügbar
Kunden	Kundenverwaltung und Stammdaten	Verfügbar
Transaktionen	Buchungen und Finanztransaktionen	Verfügbar
Sophie AI	KI-gestützte Buchhaltungsassistenz	Verfügbar

Rate Limits

Um eine faire Nutzung für alle zu gewährleisten, gelten je nach Tarif unterschiedliche Limits:

Tarif	Anfragen pro Minute	Anfragen pro Tag
Starter	60	1.000
Pro	300	10.000
Business	600	50.000
Enterprise	Individuell	Individuell

💡

Sophie’s Tipp: Wenn Sie das Rate Limit erreichen, erhalten Sie einen HTTP-Statuscode 429. Implementieren Sie ein exponentielles Backoff in Ihrem Code, um solche Situationen elegant zu handhaben. Die Antwort enthält im Header Retry-After die empfohlene Wartezeit in Sekunden.

Mehr Details finden Sie auf unserer Rate Limits Seite.

Fehlerbehandlung

Unsere API verwendet Standard-HTTP-Statuscodes. Alle Fehlermeldungen sind auf Deutsch, damit Sie sie direkt an Ihre Benutzer weitergeben können:


{
  "error": {
    "code": "INVALID_UID",
    "message": "Die angegebene UID-Nummer ist ungültig.",
    "details": {
      "field": "uid_number",
      "value": "ATU123"
    }
  }
}

Statuscode	Bedeutung
`200`	Erfolg
`201`	Ressource erstellt
`400`	Ungültige Anfrage (prüfen Sie Ihre Parameter)
`401`	Nicht authentifiziert (API-Schlüssel prüfen)
`403`	Zugriff verweigert (fehlende Berechtigung)
`404`	Ressource nicht gefunden
`429`	Rate Limit überschritten
`500`	Serverfehler (bitte kontaktieren Sie uns)

Compliance und Datenschutz

Da Sie über die API Geschäftsdaten verarbeiten, beachten Sie bitte:

DSGVO: Ein Auftragsverarbeitungsvertrag (AVV) ist für API-Nutzer Pflicht
BibuG: Die API stellt sicher, dass alle erstellten Rechnungen den österreichischen Vorschriften entsprechen
Protokollierung: Alle API-Zugriffe werden gemäß BAO 7 Jahre protokolliert

⚠️

Wichtig: Speichern Sie niemals API-Schlüssel im Quellcode oder in öffentlichen Repositories. Verwenden Sie stattdessen Umgebungsvariablen oder einen Secret Manager.

Nächste Schritte

API-Schlüssel und OAuth 2.0 im Detail

Authentifizierung

Best Practices für sichere Integrationen

Sicherheit

Support

Bei Fragen zur API-Integration bin ich zwar nicht direkt erreichbar, aber unser Entwickler-Support hilft Ihnen gerne:

E-Mail: api-office@buchhaltgenie.at
Status-Seite: status.buchhaltgenie.at

⚖️

Hinweis: Die API-Dokumentation ersetzt keine professionelle Beratung zur Systemintegration. Bei komplexen Integrationen empfehlen wir, einen erfahrenen Entwickler hinzuzuziehen.