FoodSoul kann jetzt mit jedem Ihrer Systeme verbunden werden

Wir haben Zugangstoken für die API hinzugefügt. Das bedeutet, dass FoodSoul jetzt direkt mit Ihrer Buchhaltungssoftware, 1C, dem Lager, der Analytik, einem Bot oder Ihrer eigenen Entwicklung verbunden werden kann. 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 Zugangstoken zur 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: Einsehen von Buchhaltungsberichten und Geschäftspartnern.

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 dafür notwendigen 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-Zugangstoken“ 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:

• Zugang nur zu einem Netzwerk oder zu allen Netzwerken des Accounts;
• Gültigkeitsdauer: temporär oder unbegrenzt;
• Liste der IP-Adressen, von denen Anfragen erlaubt sind. Anfragen von anderen Adressen werden abgelehnt.

4. Fügen Sie das Token in jede Anfrage Ihres Systems ein:
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 jederzeit geändert werden, 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 eigenes Token. So können Sie bei Bedarf eine Integration deaktivieren, während die anderen weiter funktionieren.

Wo Sie mehr erfahren können:

📖 Anleitung zur Einrichtung im WIKI: https://wiki.foodsoul.ru/ru/public/api
📄 Die Beschreibung aller Methoden (OpenAPI-Spezifikation) erhalten Sie beim technischen Support. Bald wird ein Entwicklerportal verfügbar sein.

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