Integrationen
Hallo, ich bin Sophie! 👋 Ich zeige dir, wie Sie BuchhaltGenie mit anderen Tools verbinden kannst. Ob Sie Rechnungen automatisch aus Ihrem Shopsystem importieren oder Daten mit Ihrem CRM synchronisieren möchtest - hier finden Sie alle Möglichkeiten.
Datenschutz bei Integrationen: Bei jeder Verbindung mit Drittanbietern werden nur die notwendigen Daten übertragen. Sie behältst die volle Kontrolle und kannst Integrationen jederzeit deaktivieren.
Übersicht
Programmatischer Zugriff auf Ihre Daten
API-SchlüsselEchtzeit-Benachrichtigungen bei Ereignissen
WebhooksZapier, Shopify, WooCommerce und mehr
Fertige IntegrationenFür Entwickler und Agenturen
Eigene IntegrationAPI-Schlüssel verwalten
Mit API-Schlüsseln können externe Anwendungen auf Ihre BuchhaltGenie-Daten zugreifen.
Was ist ein API-Schlüssel?
Ein API-Schlüssel ist wie ein spezielles Passwort für Programme:
| Aspekt | Beschreibung |
|---|---|
| Zweck | Authentifizierung von Software-Anfragen |
| Format | Langer, zufälliger Zeichenstring |
| Gültigkeit | Bis zum Widerruf gültig |
| Berechtigungen | Individuell einstellbar |
Neuen API-Schlüssel erstellen
Integrationen öffnen
Gehen Sie zu Einstellungen, dann Integrationen, dann API-Schlüssel
Neuen Schlüssel erstellen
Klicken Sie auf Neuen API-Schlüssel erstellen
Namen vergeben
Gib einen beschreibenden Namen ein (z.B. “Shopsystem-Integration” oder “Backup-Service”)
Berechtigungen festlegen
Wählen Sie, auf welche Daten der Schlüssel zugreifen darf
Schlüssel kopieren
Der Schlüssel wird einmalig angezeigt - kopiere ihn sofort und speichere ihn sicher
Einmalige Anzeige: Der API-Schlüssel wird nur einmal vollständig angezeigt. Speichere ihn sofort an einem sicheren Ort. Bei Verlust müssen Sie einen neuen Schlüssel erstellen.
Berechtigungsstufen
| Berechtigung | Zugriff |
|---|---|
| Nur Lesen | Daten abrufen, keine Änderungen |
| Lesen und Schreiben | Daten abrufen und erstellen |
| Vollzugriff | Alle Operationen inkl. Löschen |
Berechtigungen nach Bereich
| Bereich | Verfügbare Aktionen |
|---|---|
| Rechnungen | Lesen, Erstellen, Aktualisieren |
| Kunden | Lesen, Erstellen, Aktualisieren |
| Transaktionen | Nur Lesen |
| Belege | Lesen, Hochladen |
| Berichte | Lesen, Generieren |
Vergib nur die minimal notwendigen Berechtigungen. Ein Backup-Service benötigt nur Lesezugriff, ein Shopsystem braucht Schreibzugriff nur für Rechnungen. Weniger Berechtigungen bedeuten mehr Sicherheit.
API-Schlüssel widerrufen
Falls ein Schlüssel kompromittiert wurde oder nicht mehr benötigt wird:
API-Schlüssel aufrufen
Gehen Sie zu Einstellungen, dann Integrationen, dann API-Schlüssel
Schlüssel finden
Suchen Sie den zu widerrufenden Schlüssel in der Liste
Widerrufen
Klicken Sie auf Widerrufen und bestätige
Integration aktualisieren
Aktualisiere die betroffene Integration mit einem neuen Schlüssel
Webhooks einrichten
Webhooks benachrichtigen externe Systeme automatisch, wenn in BuchhaltGenie etwas passiert.
Was sind Webhooks?
| Vergleich | Ohne Webhooks | Mit Webhooks |
|---|---|---|
| Datenfluss | Externes System muss regelmäßig abfragen | BuchhaltGenie sendet automatisch |
| Geschwindigkeit | Verzögert (Minuten bis Stunden) | Sofort (Sekunden) |
| Ressourcenverbrauch | Hoch durch viele Abfragen | Niedrig, nur bei Ereignissen |
Verfügbare Ereignisse
Rechnungen
Rechnungs-Ereignisse
| Ereignis | Beschreibung |
|---|---|
invoice.created | Neue Rechnung erstellt |
invoice.sent | Rechnung versendet |
invoice.paid | Rechnung bezahlt |
invoice.overdue | Zahlungsfrist überschritten |
invoice.cancelled | Rechnung storniert |
Webhook erstellen
Webhooks öffnen
Gehen Sie zu Einstellungen, dann Integrationen, dann Webhooks
Neuen Webhook erstellen
Klicken Sie auf Webhook hinzufügen
URL eingeben
Gib die URL ein, an die Ereignisse gesendet werden sollen
Ereignisse auswählen
Wählen Sie, welche Ereignisse den Webhook auslösen sollen
Geheimschlüssel notieren
Der generierte Geheimschlüssel dient zur Verifizierung der Anfragen
Webhook aktivieren
Klicken Sie auf Speichern und aktivieren
Webhook-Sicherheit
Jeder Webhook wird mit einem HMAC-SHA256-Signatur versehen:
X-BuchhaltGenie-Signature: sha256=abc123...Verifiziere diese Signatur in Ihrem Empfangssystem, um sicherzustellen, dass die Anfrage wirklich von BuchhaltGenie stammt.
Signatur immer prüfen: Ohne Signaturprüfung könnte jeder Anfragen an Ihre Webhook-URL senden. Implementiere die Verifizierung unbedingt in Ihrem Backend.
Webhook-Protokoll
Unter jedem Webhook sehen Sie ein Protokoll:
| Information | Beschreibung |
|---|---|
| Zeitpunkt | Wann wurde der Webhook ausgelöst |
| Ereignis | Welches Ereignis trat ein |
| Status | Erfolgreich oder fehlgeschlagen |
| Antwortzeit | Wie lange dauerte die Verarbeitung |
| Wiederholungen | Anzahl der Wiederholungsversuche |
Fertige Integrationen
Verbinde BuchhaltGenie mit beliebten Business-Tools ohne Programmierung.
Zapier
Mit Zapier verbindest Sie BuchhaltGenie mit über 5.000 Apps.
Beliebte Zaps:
| Trigger | Aktion | Beispiel |
|---|---|---|
| Neue Rechnung | E-Mail senden | Benachrichtigung bei neuer Rechnung |
| Rechnung bezahlt | Slack-Nachricht | Team über Zahlungseingang informieren |
| Neuer Kunde | CRM-Eintrag | Kunde automatisch in HubSpot anlegen |
| Transaktion importiert | Google Sheets | Automatisches Transaktionsprotokoll |
Zapier aufrufen
Gehen Sie zu Einstellungen, dann Integrationen, dann Zapier
Mit Zapier verbinden
Klicken Sie auf Mit Zapier verbinden und melde Sie an
Zap erstellen
Wählen Sie BuchhaltGenie als Trigger-App und konfiguriere Ihren Zap
E-Commerce-Integrationen
| Platform | Funktionen | Einrichtung |
|---|---|---|
| Shopify | Bestellungen als Rechnungen importieren | Native Integration |
| WooCommerce | Automatische Rechnungserstellung | Plugin verfügbar |
| Wix | Bestellsynchronisation | Via Zapier |
| Amazon Seller | Abrechnungsdaten importieren | CSV-Import |
Buchhaltungs-Bridges
| Ziel-Software | Datenfluss | Hinweis |
|---|---|---|
| BMD | Export | UVA-Daten im BMD-Format |
| RZL | Export | Buchungssätze exportierbar |
| DATEV | Export | Für deutsche Steuerberater |
Wenn Ihr Steuerberater eine bestimmte Software nutzt, können Sie Ihre Daten meist im passenden Format exportieren. Frag uns nach dem optimalen Export-Format für Ihren Steuerberater.
Eigene Integration entwickeln
Für Entwickler und Agenturen bieten wir eine vollständige REST-API.
API-Dokumentation
Unsere API-Dokumentation finden Sie unter:
| Ressource | Endpunkt | Methoden |
|---|---|---|
| Rechnungen | /api/v1/invoices | GET, POST, PUT, DELETE |
| Kunden | /api/v1/customers | GET, POST, PUT, DELETE |
| Transaktionen | /api/v1/transactions | GET |
| Belege | /api/v1/receipts | GET, POST |
| Berichte | /api/v1/reports | GET |
Authentifizierung
Alle API-Anfragen müssen einen gültigen API-Schlüssel enthalten:
Authorization: Bearer YOUR_API_KEYRate Limits
| Tarif | Anfragen pro Minute | Anfragen pro Tag |
|---|---|---|
| Starter | 60 | 5.000 |
| Pro | 120 | 20.000 |
| Business | 300 | 100.000 |
| Enterprise | Unbegrenzt | Unbegrenzt |
Sandbox-Umgebung
Teste Ihre Integration in unserer Sandbox:
- Separate Testdaten, keine echten Finanzdaten
- Vollständige API-Funktionalität
- Eigene API-Schlüssel für Tests
Sandbox aktivieren
Gehen Sie zu Einstellungen, dann Integrationen, dann Entwickler
Sandbox-Schlüssel erstellen
Erstelle einen API-Schlüssel mit Sandbox-Präfix
Integration testen
Verwende sandbox.buchhaltgenie.at als Basis-URL
Zur Produktion wechseln
Tausche Sandbox- gegen Produktions-Schlüssel
Integrations-Sicherheit
Best Practices
| Empfehlung | Begründung |
|---|---|
| Schlüssel rotieren | Erstelle regelmäßig neue Schlüssel |
| Minimale Berechtigungen | Nur notwendige Rechte vergeben |
| HTTPS verwenden | Für alle Webhook-URLs |
| Signatur prüfen | Bei allen eingehenden Webhooks |
| Audit-Log prüfen | Regelmäßig API-Zugriffe kontrollieren |
API-Audit-Log
Unter Einstellungen, dann Integrationen, dann Audit-Log siehst du:
- Alle API-Anfragen der letzten 30 Tage
- Verwendeter API-Schlüssel
- Aufgerufene Endpunkte
- Erfolgreiche und fehlgeschlagene Anfragen
Bei verdächtigen Aktivitäten: Widerrufe den betroffenen API-Schlüssel sofort und erstelle einen neuen. Prüfe, ob unbefugte Änderungen vorgenommen wurden.
Häufige Fragen
Wie viele Integrationen kann ich einrichten?
Unbegrenzt. Sie kannst beliebig viele API-Schlüssel und Webhooks erstellen.
Werden Integrationen bei Tarifwechsel übernommen?
Ja, alle Integrationen bleiben bestehen. Beachte jedoch die unterschiedlichen Rate Limits.
Kann ich Integrationen für Teammitglieder einschränken?
Ja, nur Administratoren können Integrationen verwalten. Teammitglieder sehen die API-Schlüssel nicht.
Was passiert bei einem Webhook-Fehler?
Bei fehlgeschlagener Zustellung versucht BuchhaltGenie bis zu 5 Wiederholungen mit zunehmendem Abstand (1 Minute, 5 Minuten, 30 Minuten, 2 Stunden, 24 Stunden).
Gibt es eine Testphase für die API?
Die Sandbox-Umgebung ist kostenlos verfügbar. Für Produktions-API-Zugriff benötigst Sie mindestens den Starter-Tarif.
Haben Sie Fragen zu Integrationen oder benötigst Hilfe bei der Einrichtung? Schreib mir - ich helfe Ihnen gerne weiter!
Weiterführende Seiten: