Versandkosten nach Entfernung

Konfigurationsanleitung

Installation

1. Installation des Plugins

1.1) Laden Sie das Plugin über den Plugin Manager herunter.
1.2) Installieren Sie das Plugin
1.3) Tragen Sie nun den Google API Key ein. Um diesen API Key zu erhalten, befolgen Sie bitte die Schritte aus Punkt 2 "Google API Key beantragen"
1.4) Fügen Sie den Google API Key in die Plugin Konfiguration ein, speichern diese und aktiveren anschließend das Plugin.

2. Google API Key beantragen

Um den Google API Key zu erhalten, müssen Sie folgende Schritte durchführen:

2.1) Registrieren Sie sich auf https://developers.google.com/
2.2) Legen Sie sich unter https://console.developers.google.com/projectcreate ein neues Projekt an
2.3) Gehen Sie nun auf https://console.developers.google.com/apis/library/distance-matrix-backend.googleapis.com und Klicken Sie oben auf "Aktivieren". Dadurch wird die API für dieses Projekt aktiviert und steht somit zur Verfügung.
2.4) Gehen Sie links auf "Zugangsdaten" um hierüber die Anmeldedaten für die API zu erstellen. Klicken Sie hier auf "Anmeldedaten erstellen" und wählen Sie dort die Option bei "API-Schlüssel" aus. Sie erhalten nun den API-Schlüssel, welcher für die Verwendung vom Plugin benötigt wird. Eine Einschränkung vom API Key ist nicht erforderlich, kann jedoch erstellt werden. Wichtig dabei ist, dass der API Key für die Domain verwendet werden darf.

2.5) Legen Sie ein Zahlungskonto an, um die Verwendung sämtlicher API's von Google in vollem Umfang verwenden zu können. Ansonsten kommt es vor, dass das Plugin keinen gültigen Zugriff auf die Google API erhält und das Plugin somit nicht korrekt funktionieren kann.

3. Einrichtung der Versandarten

3.1) Gehen Sie nun unter Einstellungen > Versandkosten. Dort können Sie nun beliebige Versandarten erstellen bzw. bestehende Versandarten für das Plugin konfigurieren.
3.2) Um eine Versandart für das Plugin zu konfigurieren, klicken Sie innerhalb vom Bearbeitsfenster auf den Tab "Freitextfelder". Hier finden Sie sämtliche Einstellungen, um die Versandart zusammen mit dem Plugin einzurichten. Nachfolgend eine Erklärung der möglichen Einstellungen:3.2.1) Versandkosten nach Entfernung :: aktivieren: Setzen Sie hier den Haken, wenn das Plugin für diese Versandart aktiviert werden soll
3.2.2) Versandkosten nach Entfernung :: Ausgangsadresse: Tragen Sie dort die Ausgangsadresse ein, ab welcher die Entfernung zur Lieferanschrift des Kunden berechnet werden soll. Beispiel: Spielstrasse 1, 12345 Spielstadt
3.2.3) Versandkosten nach Entfernung :: Modus: Wählen Sie hier den Modus, oder auch Bedingung aus, für welche das Plugin die Berechnung durchführen soll
3.2.4) Versandkosten nach Entfernung :: Entfernung A: Tragen Sie hier die Entfernung (KM) ein, die für den Modus gelten soll. Wenn Sie die Versandart für das Plugin aktivieren möchten, muss hier ein Wert eingetragen werden.
3.2.5) Versandkosten nach Entfernung :: Entfernung B:, Sollten Sie den Modus 3 wählen, ist hier die Entfernung (KM) einzutragen, die höher ist, als die Entfernung A
3.2.6) Versandkosten nach Entfernung :: Freikilometer: Falls eine Berechnung der Kosten nach KM erfolgen soll, können Sie hier Freikilometer eintragen. Diese werden dann nicht berechnet
3.2.7) Versandkosten nach Entfernung :: Kosten p. KM: Falls eine Berechnung der Kosten nach KM erfolgen soll, können Sie hier einen Wert eintragen, der pro KM berechnet wird. Es sind Kommazahlen (z.B. 1,55) zulässig.
3.2.8) Versandkosten nach Entfernung :: Kosten p. KM sind Brutto: Ist die Eingabe der Kosten pro KM Brutto, so können Sie dies über das Setzen des Hakens festlegen.
3.3) Speichern Sie die Einstellungen
3.4) Das Plugin kann nun verwendet werden.

4. Erweiterung der Versandkostenbeschreibung um Parameter

Für eine genauere Angabe der Versandkosten, können Sie in der Beschreibung von der Versandart folgende Parameter einsetzen:

4.1) [StorageAddress] :: Ausgabe der eingestellten Lageradresse in der Versandart
4.2) [Distance] :: Angabe der errechneten Entfernung in KM
4.3) [FreeDistance] :: Eingestellte Freikilometer in der Versandart
4.4) [CostsPerKm] :: Kosten pro KM (Wert ist ohne MwSt)
4.5) [DistanceCosts] :: Errechnete Kosten für diese Entfernung, welche zu den Versandkosten hinzugerechnet werden (Wert ist ohne MwSt)
4.6) [ChargeableDistance] :: Zu berechnende KM (= [Distance] - [FreeDistance])