Norman mit n8n und Make nutzen

REST oder MCP wählen

Nutze eine HTTP-Anfrage, wenn dein Workflow eine konkrete API-Operation ausführen soll, etwa Transaktionen lesen oder einen Rechnungsentwurf erstellen. So können sowohl n8n als auch Make die Norman Public API verwenden.

Nutze MCP, wenn ein KI-Agent Norman-Werkzeuge für eine Aufgabe selbst auswählen soll. Die n8n-Karte unter Integrationen verlinkt auf die MCP-Einrichtung. Ein REST-API-Schlüssel und eine MCP-OAuth-Verbindung sind unterschiedliche Zugangswege. Für MCP beachte die Verbindungsanleitung und die Unterstützung deines Tools für Remote-MCP mit OAuth.

Einen Norman-Schlüssel vorbereiten

Öffne Automatisierungen → Integrationen → Public API. Wähle das Unternehmen und erstelle für den ersten Test einen Schlüssel mit Nur Lesen / Read only. Speichere ihn im Zugangsdaten-Speicher von n8n oder Make. Verwende separate Schlüssel, wenn Workflows unterschiedliche Rechte oder einen unabhängigen Widerruf benötigen.

Den HTTP-Schritt einrichten

Füge in n8n einen HTTP Request-Knoten hinzu. Wähle generische Zugangsdaten mit Header Auth. Verwende den Headernamen Authorization und den Wert Bearer YOUR_API_KEY. Wähle diese Zugangsdaten am Knoten aus.

Füge in Make das Modul HTTP → Make a request hinzu. Konfiguriere dessen Zugangsdaten- oder Keychain-Option so, dass sie denselben Authorization-Header sendet. Die Bezeichnungen hängen von der Version des HTTP-Moduls ab.

Führe den Schritt einmal aus. Die erfolgreiche Antwort enthält results. Übernimm die publicId des Unternehmens in nachfolgende unternehmensbezogene Pfade. Bei einem archivierten Unternehmen ergänze den Query-Parameter include_archived=true.

Die aktuellen Bedienelemente beschreiben die offiziellen Anleitungen für n8n HTTP Request und Make HTTP.

Beispiel: Transaktionen regelmäßig exportieren

Rufe nach dem Unternehmenstest folgende Adresse auf:

https://api.norman.finance/api/v1/accounting/transactions/?page=1&page_size=100

Nutze read_transactions, übernimm die Einträge aus results und folge der Antwort-URL next, bis sie null ist. In n8n bietet HTTP Request die Paginierung Response Contains Next URL. In Make verwendest du die Paginierungsoptionen deines HTTP-Moduls oder eine Schleife. Folge nur nächsten URLs auf dem Norman-API-Host.

Teste einen kleinen Export, bevor du einen Zeitplan aktivierst. Aktualisiere vorhandene Zeilen im Zielsystem anhand der zurückgegebenen Datensatz-IDs.

Beispiel: Vom CRM zum Rechnungsentwurf

Starte den Workflow aus deinem CRM, lege den Kunden an oder aktualisiere ihn und erstelle einen Rechnungsentwurf in Norman. Nutze die Invoicing-Rechte, JSON-Anfragen und das Rechnungsbeispiel. Speichere Kunden- und Rechnungs-ID im CRM. Prüfe den Entwurf, bevor du einen E-Mail-Versand ergänzt.

Für einen Dokument-Upload verwendest du Multipart mit dem Feld file statt JSON. Die Verarbeitung kann nach der Upload-Antwort weiterlaufen. Lies das Dokument später erneut, um das Ergebnis zu prüfen.

Wiederholte Ausführungen zuverlässig gestalten

Richte einen Fehlerzweig ein: Erneuere ungültige Zugangsdaten, kläre fehlende Rechte und beachte bei 429 den Header Retry-After. Wiederhole eine Anlage oder einen Versand nach einem Timeout erst, wenn du geprüft hast, ob die Aktion bereits erfolgreich war.

Öffentliche Ereignis-Abonnements gehören derzeit nicht zum API-Vertrag. Starte solche Workflows zeitgesteuert oder durch ein Ereignis in deinem Quellsystem. Weitere Hilfe: API-Zugriff und Fehler und vollständige Referenz.