Servererweiterung

Eine Servererweiterung ermöglicht es 3PL-Lizenzinhabern, weitere Funktionen an Stoqflow anzuhängen wie zum Beispiel die Hinzufügung von Informationen zu einer Bestellung, die zuvor auf einer anderen Server abgerufen werden muss oder erst durch externe Parameter geprüft werden muss. Der Unterschied zwischen Webhooks und einer Servererweiterung ist, dass Stoqflow auf eine Antwort des angesprochenen Servers warten wird, bevor es weitergeht.

Über Admin > Servererweiterung kann die Servererweiterung eingestellt werden und können Servererweiterungshooks erstellt und verwaltet werden.

Servererweiterungs-Einstellungen

Bevor die Servererweiterung verwendet werden kann, müssen folgende Einstellungen ausgefüllt werden:

  • Activated: Ob die Servererweiterung aktiviert ist oder nicht
  • URL: Die URL, an der Stoqflow HTTP-Anforderungen senden wird
  • Geheim: Eine einzigartige Schlüssel, die zum Schutz der Kommunikation zwischen Stoqflow und der Servererweiterung verwendet wird

Servererweiterungshooks

Eine Servererweiterungshook besteht aus einer Initiierung und optionalen Filters.

Initiierungen

Für jeden Servererweiterungshook muss eine Initiierung gewählt werden. Eine Ereignis, bei dem Stoqflow eine HTTP-Anforderung an einen bestimmten URL sendet. Einige wichtige Initiationen sind zum Beispiel:

  • Bei der Registrierung von Sendungen auf einer Bestellung
  • Bei der Bearbeitung eines Bestellings

Filters

Filters sind optional und können verwendet werden, um zu bestimmen, ob Stoqflow die Servererweiterung kontaktieren muss. Da das HTTP-Verkehr zwischen Stoqflow und der Servererweiterung einige Zeit in Anspruch nehmen kann ist es am besten dies Verkehr so gut wie möglich zu vermeiden, zum Beispiel nur für Bestellungen aus bestimmten Shops die Servererweiterung anzusprechen.

Wann wird die Servererweiterung angesprochen?

Servererweiterungshooks werden immer ausgeführt vor der Sicherung der Initiierung in der Datenbank. Dies bedeutet, dass wenn ein Hook ausgeführt wird bei der Bearbeitung eines Bestellings die Servererweiterung (wenn nötig) noch Änderungen vornehmen kann, bevor die Bestellung in unsere Datenbank gespeichert wird.

Beispiele

Eine Servererweiterung ermöglicht also die Hinzufügung einer Vielzahl von Funktionen an Stoqflow. Einige gute Beispiele sind:

  • Ein bevorzugten Versender auf der Grundlage von Parametern in externer Software festlegen
  • Versandetiketten nach Maß zu Bestellungen hinzufügen, die dann durch Stoqflow gedruckt werden können

Servererweiterungen verwenden

Da das Aufsetzen und Verwenden einer Servererweiterung software auf Maß ist es am besten Kontakt mit den Entwicklern von Stoqflow aufzunehmen, um alle technischen Aspekte davon zu besprechen.