FoodSoul kann jetzt mit jedem Ihrer Systeme verbunden werden

Wir haben Zugriffstoken für die API hinzugefügt. Das bedeutet, dass Sie FoodSoul jetzt direkt mit Ihrer Buchhaltungssoftware, dem Lager, der Analytik, einem Bot oder Ihrer eigenen Entwicklung verbinden können. Ein manuelles Exportieren und Übertragen von Daten ist nicht mehr nötig.

Bisher war eine Anbindung nur an fertige Integrationen aus unserer Liste möglich. Jetzt können Sie Ihre eigene Integration erstellen.

Wofür werden Zugriffstoken für die FoodSoul API benötigt?

Mit einem Token können Sie mit den meisten Bereichen des CRM arbeiten. Welche Zugriffsrechte Ihre Integration genau erhält, hängt von der Rolle ab, die Sie für das Token auswählen.

Zum Beispiel hat ein Token mit der Rolle „Operator“ folgende Rechte:

✅ Erlaubt: Bearbeiten von Produkten, Kategorien, Stoplisten, Lagerbeständen, Bestellungen, Bewertungen und Adressen, Arbeiten mit Zahlungen.
❌ Nicht erlaubt: Einsicht in Buchhaltungsberichte und Geschäftspartner.

Ein solches Token eignet sich beispielsweise für ein Lagerverwaltungssystem, das Bestände und Stoplisten selbstständig aktualisiert. Wählen Sie für jede Integration eine Rolle, die nur die benötigten Rechte enthält: Je weniger Rechte ein Token hat, desto sicherer ist es.

Für Teilnehmer des Partnerprogramms gibt es eigene Anfragen: verbundene Unternehmen, Berichte und Auszahlungen.

Wie erfolgt die Anbindung?

1. Öffnen Sie im CRM den Bereich „API-Zugriffstoken“ und erstellen Sie ein Token. Das Token ist der Schlüssel, mit dem Ihr System auf FoodSoul zugreift. Es werden weder Login noch Passwort eines Mitarbeiters benötigt.

2. Wählen Sie eine Rolle für das Token. Das Token erhält die Rechte dieser Rolle, jedoch nicht mehr als Sie selbst besitzen.

3. Falls nötig, legen Sie Einschränkungen fest:

• Zugriff nur auf ein Netzwerk oder auf alle Netzwerke des Accounts;
• Gültigkeitsdauer: befristet oder unbefristet;
• Liste der IP-Adressen, von denen Anfragen erlaubt sind. Anfragen von anderen Adressen werden abgelehnt.

4. Fügen Sie das Token zu jeder Anfrage Ihres Systems hinzu:
Authorization: Bearer fs_api_...
Wenn das Token nicht an ein bestimmtes Netzwerk gebunden ist, geben Sie das gewünschte im Header an:
Chain: chain_id

Die Einstellungen des Tokens können Sie jederzeit ändern, das Token selbst bleibt dabei unverändert. Es kann auch gesperrt, entsperrt oder gelöscht werden.

❗️ Wichtig zur Sicherheit

• Das vollständige Token wird nur einmal, bei der Erstellung, angezeigt. Speichern Sie es sofort ab. Wir speichern das Token verschlüsselt und können es nicht wiederherstellen. Ein verlorenes Token kann nicht zurückgegeben werden. Sie müssen ein neues erstellen und es in der Integration ersetzen.
• Erstellen Sie für jede Integration ein separates Token. So können Sie bei Bedarf eine Integration deaktivieren, während die anderen weiter funktionieren.

Wo Sie mehr erfahren können:

📄 Die Beschreibung aller Methoden (OpenAPI-Spezifikation) erhalten Sie beim technischen Support. Bald wird es ein Entwicklerportal geben.

 
Mit freundlichen Grüßen, Ihr FoodSoul-Team! Wir arbeiten für Sie!