SCALERP-API

Verbinden Sie Ihre Fachsoftware über HTTPS mit den Unternehmensdaten. Der Konnektor stellt REST-Ressourcen bereit und tauscht Daten im JSON-Format aus.

Integration authentifizieren

Nach Freischaltung des Konnektors und Erteilung des Zugriffs senden Sie das Token mit dem Präfix Bearer im Authorization-Header. Bewahren Sie das Token auf dem Server auf. Fragen Sie zuerst den angemeldeten Benutzer ab, um die Identität der Integration zu prüfen. GET /connector/api/user/loggedin

Katalog abrufen

Rufen Sie die Standorte ab und filtern Sie die Produkte mit location_id nach dem gewünschten Standort. Beschränken Sie die erste Abfrage auf zehn Produkte. Rufen Sie für den gesamten Katalog auch die Folgeseiten ab. GET /connector/api/product?per_page=10

Vorgang anlegen und abgleichen

Der Konnektor ermöglicht das Lesen und Anlegen von Kontakten, Verkäufen und Ausgaben. Ermitteln Sie für einen externen Verkauf zunächst den Kundenkontakt und gleichen Sie die SCALERP-Antwort mit der Referenz des Quellsystems ab. GET /connector/api/contactapi · GET /connector/api/sell

Fehler untersuchen

Prüfen Sie bei fehlgeschlagener Anmeldung die Domain und die Gültigkeit des Tokens. Suchen Sie nach einem Verbindungsabbruch beim Anlegen erst nach dem Vorgang, bevor Sie es erneut versuchen. Nennen Sie dem Support Methode, Pfad und HTTP-Status und entfernen Sie das Token.