Servererweiterung

Eine Servererweiterung ermöglicht es 3PL-Lizenzinhabern, zusätzliche Funktionen an Webship Online anzuhängen, wie zum Beispiel die Hinzufügung von Informationen zu einer Bestellung, die zunächst von einem anderen Server aufgefordert oder über externe Parameter validiert werden muss. Der Unterschied zwischen Webhooks und einer Servererweiterung ist, dass Webship Online wartet, bis eine Antwort vom angefragten Server eingegangen ist, bevor es weitermacht.

Über Admin > Servererweiterung kann die Servererweiterung konfiguriert werden und Servererweiterungshooks erstellt und verwaltet werden.

Servererweiterungs-Konfiguration

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

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

Servererweiterungshooks

Eine Servererweiterungshook besteht aus einem Trigger und optionalen Filters.

Triggers

Für jeden Servererweiterungshook muss ein Trigger gewählt werden. Ein Ereignis, bei dem Webship Online eine HTTP-Anforderung an einen ausgewählten URL sendet. Einige wichtige Trigger sind zum Beispiel:

  • Wenn Sendungen registriert werden auf einer Bestellung
  • Wenn eine Bestellung bearbeitet wird

Filters

Filters sind optional und können verwendet werden, um zu bestimmen, ob Webship Online die Servererweiterung kontaktieren soll. Da HTTP-Verkehr zwischen Webship Online und der Servererweiterung einige Zeit dauern kann, ist es am besten, diese Kommunikation so weit wie möglich zu vermeiden, indem zum Beispiel nur für Bestellungen bestimmter Shops die Servererweiterung kontaktiert wird.

Wann wird die Servererweiterung kontaktiert?

Servererweiterungshooks werden immer ausgeführt vor der Speicherung des Triggers in der Datenbank. Das bedeutet, dass wenn ein Hook während der Bearbeitung einer Bestellung ausgelöst wird, kann die Servererweiterung (falls erforderlich) noch Anpassungen vornehmen, bevor die Bestellung in unserer Datenbank gespeichert wird.

Beispiele

Eine Servererweiterung ermöglicht also das Hinzufügen eines unbegrenzten Sets an Funktionen an Webship Online. Einige gute Beispiele sind:

  • Standardtransporteur einstellen auf der Grundlage von Parametern in externem Software
  • Individualisierte Sendelabel zum Ausdruck vorbereiten, die dann von Webship Online gedruckt werden können

Servererweiterungen verwenden

Da das Aufsetzen und Verwenden einer Servererweiterung software auf Maß erfordert, ist es am besten, sich mit den Entwicklern von Webship Online in Verbindung zu setzen, um alle technischen Aspekte zu besprechen.