Nach der Installation richten Sie Ventoo Shipping in zwei Schritten ein:
-
Spediteureinrichtung – pro Spediteur (z. B. Planzer) ein Eintrag mit Verbindungs- und Authentifizierungsdaten.
-
Versandeinrichtung – globale Standardwerte (Standardspediteur, Auto-Druck, Standardabholung von Firma).
Spediteur einrichten
Die Spediteureinrichtung enthält alle Verbindungs-, Authentifizierungs- und Stammdaten eines Spediteurs. Jeder Spediteur wird durch einen Code identifiziert, der sich am Business-Central-Lieferantencode (Tabelle Shipping Agent) orientiert.
Spediteurliste öffnen
-
Suchen Sie über die Suchfunktion (Tell Me) nach Spediteureinrichtung (
Carrier Setup). -
Wählen Sie Neu, um einen neuen Spediteurdatensatz zu erfassen.
-
Wechseln Sie über Bearbeiten in die Spediteureinrichtungskarte.
Allgemein
|
Feld |
Beschreibung |
|---|---|
|
Code |
Eindeutiger Spediteurcode. Verweist auf den Business-Central-Lieferantencode ( |
|
Beschreibung |
Anzeigename des Spediteurs. |
|
Spediteur-Typ |
Auswahl des technischen Konnektors. Verfügbare Werte: (kein Spediteur) und Planzer. Der Wert bestimmt, welcher Code die API-Aufrufe ausführt. |
|
Aktiviert |
Steuert, ob der Spediteur für die Etikettenerstellung verwendet werden darf. Deaktivierte Spediteure werden bei der Verarbeitung mit einer Fehlermeldung abgewiesen. |
Verbindung
|
Feld |
Beschreibung |
|---|---|
|
Basis-URL Test |
API-Endpunkt für die Testumgebung. |
|
Basis-URL Produktion |
API-Endpunkt für die Produktivumgebung. |
|
Produktion verwenden |
Wenn aktiviert, wird die Produktions-URL verwendet. Andernfalls die Test-URL. |
OAuth 2.0-Authentifizierung
Ventoo Shipping verwendet den OAuth 2.0 Client-Credentials-Flow. Client-ID und Client-Secret werden in IsolatedStorage von Business Central abgelegt und nicht im Klartext in der Tabelle gespeichert.
|
Feld |
Beschreibung |
|---|---|
|
OAuth-Token-URL |
URL des Token-Endpunkts des Spediteurs. |
|
OAuth-Client-ID |
Client-ID des Spediteurzugangs. Wird beim Speichern verschlüsselt abgelegt und in der Karte als |
|
OAuth-Client-Secret |
Client-Secret des Spediteurzugangs. Wird beim Speichern verschlüsselt abgelegt und in der Karte als |
|
OAuth-Scope |
Optionaler Scope-Parameter, falls vom Spediteur verlangt. |
Etiketten-Standardwerte
|
Feld |
Beschreibung |
|---|---|
|
Standard-Etikettenformat |
Standardausgabeformat des Etiketts. Mögliche Werte: PDF oder ZPL. |
|
Standard-Etikettenauflösung (dpi) |
Standardauflösung in DPI. Wird vor allem für ZPL benötigt (z. B. |
Spediteurkonto (Planzer)
Diese Gruppe ist nur sichtbar, wenn Spediteur-Typ auf Planzer gesetzt ist.
|
Feld |
Beschreibung |
|---|---|
|
Konto-ID |
Planzer-Konto-ID (6 Stellen). Wird beim Aufruf automatisch links mit Nullen aufgefüllt. |
|
Kunden-ID |
Planzer-Kunden-ID (6 Stellen). |
|
Abteilungs-ID |
Planzer-Abteilungs-ID (2 Stellen). |
|
Abfrageparameter NachrichtArt |
Optionaler Query-String-Parameter |
|
Abfrageparameter System |
Optionaler Query-String-Parameter |
Optionen
|
Feld |
Beschreibung |
|---|---|
|
API-Aufrufe protokollieren |
Wenn aktiviert, werden Request- und Response-JSON pro Etikett im jeweiligen Datensatz gespeichert (Felder Request JSON und Response JSON). Nützlich für die Fehlersuche. |
Stammdaten initialisieren
Mit der Aktion Stammdaten initialisieren befüllt Ventoo Shipping die spediteurspezifischen Tabellen Spediteur-Serviceoptionen und Spediteur-Hinweismeldungen mit den zum Spediteur passenden Codes. Für Planzer enthält dies u. a. die Servicecodes für Pflichtunterschrift, Samstagszustellung, Identitätsprüfung sowie die Hinweismeldungscodes remark, reference1, billing, routing1–routing4 und deposit.
-
Öffnen Sie die Spediteureinrichtungskarte.
-
Wählen Sie Stammdaten initialisieren.
-
Bestätigen Sie die Meldung. Die Tabellen werden für diesen Spediteur neu aufgebaut.
Hinweis: Die Aktion löscht bestehende Einträge für diesen Spediteur und legt sie neu an. Eigene Anpassungen an Beschreibungen oder dem Aktiviert-Status gehen verloren.
Die Aktionen Serviceoptionen und Hinweismeldungen auf der Spediteureinrichtungskarte öffnen die jeweilige Stammdatenseite, gefiltert auf den aktuellen Spediteur. Dort können einzelne Codes mit den Aktionen Alle aktivieren und Alle deaktivieren in Massen freigeschaltet oder gesperrt werden.
Versandeinrichtung
Auf der Seite Versandeinrichtung legen Sie globale Voreinstellungen fest. Pro Mandant existiert nur ein Datensatz; er wird beim ersten Öffnen automatisch angelegt.
|
Feld |
Beschreibung |
|---|---|
|
Standard-Spediteurcode |
Spediteur, der beim Erstellen eines neuen Etiketts vorgeschlagen wird. |
|
Auto-Druck nach Erstellung |
Wenn aktiviert, wird das Etikett nach erfolgreicher Rückmeldung des Spediteurs automatisch über die in Business Central konfigurierte Druckerauswahl gedruckt. |
|
Standardabholung von Firma |
Wenn aktiviert, werden Name, Adresse, Postleitzahl, Ort, Land, Kontaktperson, Telefon und E-Mail aus den Firmendaten ( |
Über die Aktion Spediteureinrichtung in der Versandeinrichtung gelangen Sie direkt zur Spediteurliste.
Druckerauswahl konfigurieren (optional)
Damit Etiketten automatisch auf einem bestimmten Drucker landen (Aktion Auto-Druck nach Erstellung), verwenden Sie die Standard-Druckerauswahl von Business Central. Ventoo Shipping registriert pro Spediteur einen schlanken Bericht (z. B. Planzer Label Print VTO). Beim Druck wird das vom Spediteur zurückgegebene PDF über den Ereignis-Subscriber Ship Label Print Events VTO in die Berichtsausgabe injiziert.
-
Suchen Sie nach Druckerauswahl.
-
Wählen Sie Neu und legen Sie einen Eintrag für den jeweiligen Bericht und Benutzer an.
-
Ordnen Sie den gewünschten Drucker zu.