REST-API für n8n, Zapier oder Make: Rechnungen, Belege, Buchungen und Kunden per HTTP-Request lesen und anlegen.
Zuletzt geprüft am
Pfeffersack lässt sich über die REST-API in n8n-Workflows einbinden: Mit einem persönlichen API-Key (Bearer-Token) liest der HTTP Request Node Rechnungen, Belege, Buchungen und Kunden und legt sie an, im Einzelfirma- wie im GmbH-Bereich. Ein Ablauf startet zeitgesteuert (Schedule Trigger) oder aus einem anderen Dienst. Ausgehende Webhook-Ziele lassen sich in Pfeffersack einrichten und mit einem Test-Event prüfen; Rechnungs-Events löst Pfeffersack derzeit noch nicht aus. Dieselbe API funktioniert auch mit Zapier und Make.
Jeder Punkt unten ist direkt im Pfeffersack-Code implementiert — keine geplanten Features, keine Ankündigungen.
Mit deinem persönlichen API-Key (`Authorization: Bearer <key>`) liest n8n Rechnungen, Belege, Buchungen und Kunden und legt sie an; zum Anlegen braucht der Key die passenden Schreibrechte. So übernimmst du zum Beispiel Kunden aus deinem CRM oder legst Rechnungen aus einem Bestellformular an (im GmbH-Bereich entstehen Rechnungen und Buchungen als Entwurf).
Ein Schedule Trigger fragt zum Beispiel jeden Morgen die Rechnungsliste ab, gefiltert nach Status oder Rechnungsdatum (`status`, `from`, `to`), und schreibt die offenen Rechnungen in ein Google Sheet oder schickt eine Nachricht an dein Team.
Unter «Profil → Integrationen → n8n & Automatisierung» legst du ein `https://`-Ziel an und prüfst es mit «Test senden»: Pfeffersack liefert ein HMAC-SHA256-signiertes `webhook.test`-Event. Rechnungs-Events (`invoice.created`, `invoice.paid`) löst Pfeffersack derzeit noch nicht aus; Abläufe zu neuen oder bezahlten Rechnungen fragen deshalb die API ab.
API-Keys erstellst und widerrufst du einzeln im Dashboard, ein widerrufener Key gilt sofort nicht mehr. Webhook-Ziele müssen `https://` verwenden; interne Adressen (RFC 1918, Loopback, Link-Local, Cloud-Metadata) blockiert Pfeffersack.
Die API ist Standard-REST mit JSON. Jede Plattform mit einem HTTP-Request-Schritt und frei setzbarem Authorization-Header kann Pfeffersack-Daten lesen und anlegen, auch Zapier und Make.
Gesamtaufwand: 1 Min + 2 Min + 3 Min + 5 Min + 15 Min
Im Pfeffersack-Dashboard unter „Profil → Integrationen → Pfeffersack API“ auf „API-Keys verwalten“ klicken und einen Key mit sprechendem Namen erstellen (z. B. „n8n Prod“). Für schreibende Abläufe die passenden Schreibrechte wählen (z. B. `write:invoices`); ohne Auswahl ist der Key nur lesend. Der Key wird nur einmal angezeigt, also sofort sicher speichern.
In n8n (Cloud oder Self-Hosted) eine Credential vom Typ «Header Auth» anlegen: Name `Authorization`, Wert `Bearer <dein-key>`.
Einen neuen Workflow mit einem Schedule Trigger (z. B. täglich um 7 Uhr) oder einem Trigger aus einem anderen Dienst erstellen.
Methode und Endpunkt aus der Dokumentation unter pfeffersack.ch/docs wählen, etwa die Rechnungsliste, und die Credential aus Schritt 2 zuweisen. Den Node einmal ausführen und die Antwort prüfen.
Die JSON-Antwort in n8n filtern und weitergeben, etwa an Google Sheets, Slack oder dein CRM. Für schreibende Abläufe denselben Node mit POST verwenden.
Hilfe beim Setup?
Unser Team unterstützt dich kostenlos beim Verbinden von n8n.
Zugangsdaten werden vor dem Speichern AES-GCM-verschlüsselt. Der Schlüssel liegt ausserhalb der Datenbank.
Pfeffersack fordert nur Lese-Berechtigungen an. Dein n8n-Account bleibt unverändert.
Buchhaltungsdaten und Tokens werden in der Schweiz gespeichert. Welche Dienstleister Daten bearbeiten, steht in der Datenschutzerklärung.
Alles, was sich über die REST-API lesen oder anlegen lässt: zum Beispiel jeden Morgen die offenen Rechnungen in ein Google Sheet schreiben, Kunden aus Pipedrive oder HubSpot nach Pfeffersack übernehmen, Rechnungen aus einem Bestellformular anlegen oder Buchungen für ein eigenes Dashboard abrufen. Abläufe, die im selben Moment auf eine neue oder bezahlte Rechnung reagieren, gehen heute nicht, weil Pfeffersack noch keine Rechnungs-Events sendet. Am nächsten kommt dem ein zeitgesteuerter Abruf.
Für Rechnungen noch nicht. Webhook-Ziele lassen sich unter «Profil → Integrationen → n8n & Automatisierung» einrichten, und «Test senden» liefert ein signiertes `webhook.test`-Event an deinen n8n-Webhook-Trigger. Die Rechnungs-Events `invoice.created` und `invoice.paid` sind in der Webhook-Dokumentation beschrieben, werden aber derzeit noch nicht ausgelöst. Wer auf neue oder bezahlte Rechnungen reagieren will, fragt die Rechnungsliste zeitgesteuert über die API ab.
Ja. Bei den API-Abläufen ruft n8n Pfeffersack auf; dein n8n muss dafür nicht aus dem Internet erreichbar sein, es muss nur pfeffersack.ch erreichen. Für den Webhook-Test muss der Empfänger dagegen unter einer öffentlich erreichbaren `https://`-Adresse laufen, weil Pfeffersack interne Adressen, Loopback (`127.0.0.1`), Link-Local und Cloud-Metadata-Endpunkte blockiert.
Ja. Mit dem HTTP Request Node und `Authorization: Bearer <api-key>` legst du über die Endpunkte der REST-API Rechnungen, Belege, Buchungen und Kunden an, zum Beispiel Kunden aus Pipedrive oder Rechnungen aus einem Bestellformular; im GmbH-Bereich entstehen Rechnungen und Buchungen als Entwurf. Der API-Key braucht dafür die passenden Schreibrechte, ohne Auswahl ist er nur lesend. Welche Felder ein Endpunkt erwartet, steht in der Dokumentation unter pfeffersack.ch/docs.
API und Webhook-Einstellungen sind im Pfeffersack-Abo (ab CHF 5/Monat im Jahresabo) für Einzelfirmen und GmbH enthalten, ohne Zusatzgebühr. Für reine Privat-Konten ist die Integration nicht freigeschaltet. Bei n8n entscheidest du selbst zwischen Cloud und Self-Hosted.
Ja, über die API: Jede Plattform mit einem HTTP-Request-Schritt und frei setzbarem Authorization-Header kann Pfeffersack-Daten lesen und anlegen. Die n8n-Kachel im Dashboard ist nur die Bezeichnung; die Mechanik ist dieselbe.
AES-GCM-verschlüsselt in der Pfeffersack-Datenbank auf Schweizer Infrastruktur. Der Entschlüsselungs-Schlüssel liegt ausserhalb der DB. Das Plaintext-Secret wird genau einmal nach der Erstellung bzw. Rotation angezeigt und danach nie wieder — speichere es sofort sicher in deinem n8n-Credential-Store.
Teste die Integration kostenlos. Ab CHF 5/Monat im Jahresabo — inklusive aller Integrationen, MWST-Abrechnung und Support auf Deutsch.
