Setup und Konfiguration von Ventoo Shipping

Nach der Installation richten Sie Ventoo Shipping in zwei Schritten ein:

1. Spediteureinrichtung – pro Spediteur (z. B. Planzer) ein Eintrag mit Verbindungs- und Authentifizierungsdaten.

2. 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

1. Suchen Sie über die Suchfunktion (Tell Me) nach Spediteureinrichtung (Carrier Setup).

2. Wählen Sie Neu, um einen neuen Spediteurdatensatz zu erfassen.

3. Wechseln Sie über Bearbeiten in die Spediteureinrichtungskarte.

Allgemein

Verbindung

Hinweis: Wird eine Umgebung in eine Sandbox kopiert (z. B. Produktion → Sandbox zum Testen), wird Produktion verwenden auf allen Spediteureinrichtungen automatisch deaktiviert. So sendet die Testumgebung nicht versehentlich echte Versandetiketten an den Spediteur – analog dazu, wie Business Central beim Kopieren den E-Mail-Versand und Aufgabenwarteschlangen deaktiviert. Um aus der Sandbox gegen die produktive Spediteur-API zu testen, aktivieren Sie Produktion verwenden pro Spediteur wieder manuell. Dies gilt für Kopien ab dieser Version; eine vor dieser Version kopierte Sandbox muss den Schalter einmalig von Hand deaktiviert bekommen.

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.

Etiketten-Standardwerte

Datumsstandards

Diese Felder steuern, wie Abholdatum und Lieferdatum beim Anlegen eines Etiketts für diesen Spediteur vorbelegt werden. Da Vorlaufzeiten von Natur aus spediteurabhängig sind, liegt die Einstellung am Spediteur und nicht in der globalen Versandeinrichtung.

Die Default-Werte (Basis = Arbeitsdatum, Versatz = 0) erzeugen exakt das bisherige Verhalten. Bestehende Spediteure ändern sich also nicht, solange sie nicht aktiv anders eingestellt werden.

Hinweis: Wird auf einem Etikett der Spediteurcode geändert, werden Abhol- und Lieferdatum anhand der Einstellungen des neu gewählten Spediteurs neu berechnet. Dabei wird ein zuvor manuell eingegebenes Datum überschrieben – ein individuelles Datum sollte daher erst nach der Spediteurwahl gesetzt werden.

Beispiel – Planzer: Abholung immer am nächsten Tag

Setzen Sie Basis Abholdatum = Arbeitsdatum und Standardversatz Abholdatum = 1. Neue Planzer-Etiketten erhalten dann automatisch morgen als Abholdatum.

Arbeitstage-Kalender für die Datums-Vorbelegung

Der konfigurierte Versatz (Offset) auf Abhol- und Lieferdatum kann nun arbeitsfreie Tage (Wochenenden und Feiertage) überspringen. Damit zählt der Versatz wahlweise in Arbeitstagen statt in Kalendertagen. Grundlage ist der BC-Standard Base Calendar.

Versatz-Anwendung

• Mit hinterlegtem Kalender: Der Versatz zählt Arbeitstage – Wochenenden und Feiertage werden übersprungen. +1 bedeutet "nächster Arbeitstag". Das Ergebnis liegt immer auf einem Arbeitstag (auch bei Versatz 0: Ist das Basisdatum selbst arbeitsfrei, wird auf den nächsten Arbeitstag gerollt).

• Ohne Kalender: reine Kalendertage (Basisdatum + Versatz), wie bisher.

Auflösung des Kalenders (Priorität, stärkste zuerst): Spediteur (Carrier Setup) → Lagerort (Auftragskopf) → Company Information → kein Kalender.

Die erste gesetzte Quelle gewinnt. Ist der Spediteur-Kalender gefüllt, überschreibt er Lagerort- und Firmenkalender; ist er leer, greift der Lagerort; danach der Firmenkalender; ist nirgends einer hinterlegt, wird ohne Arbeitstage-Logik gerechnet.

Verhalten in Sonderfällen

• Versatz 0 auf arbeitsfreiem Basisdatum (z. B. Versanddatum fällt auf einen Sonntag): das Datum wird auf den nächsten Arbeitstag gerollt.

• Lagerort aus dem Belegkopf: der Lagerort-Kalender greift nur, wenn der Kopf-Lagerort des Belegs gefüllt ist. Wird der Lagerort nur auf Zeilenebene geführt (Kopf leer), fällt die Logik auf den Firmenkalender zurück.

• Manuelles Etikett: kein Quellbeleg → kein Lagerort; es greifen Spediteur- bzw. Firmenkalender.

Abwärtskompatibilität: Ist kein Basiskalender hinterlegt (Spediteur, Lagerort und Company Information alle leer), ändert sich nichts – der Versatz wirkt wie bisher in Kalendertagen.

Setup-Voraussetzung (Stammdaten)

Damit die Arbeitstage-Logik wirkt, muss ein Base Calendar gepflegt und an Spediteur, Lagerort oder Company Information hinterlegt sein:

• Wochenenden als Weekly Recurring arbeitsfrei,

• Feiertage als Annual Recurring bzw. als konkrete Daten.

Hinweis: Bewegliche Feiertage (Ostern, Pfingsten) müssen als konkrete Daten gepflegt werden – sie lassen sich nicht als "jährlich wiederkehrend" abbilden (BC-Standard).

Beispiel – Abholung immer am nächsten Arbeitstag

Setzen Sie Basis Abholdatum = Arbeitsdatum, Standardversatz Abholdatum = 1 und einen Basiskalendercode mit Wochenenden und Feiertagen. → Auftrag am Freitag, Montag = Feiertag ⇒ Abholdatum Dienstag.

Spediteurkonto (Planzer)

Diese Gruppe ist nur sichtbar, wenn Spediteur-Typ auf Planzer gesetzt ist.

Optionen

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.

1. Öffnen Sie die Spediteureinrichtungskarte.

2. Wählen Sie Stammdaten initialisieren.

3. 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.

Ü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.

1. Suchen Sie nach Druckerauswahl.

2. Wählen Sie Neu und legen Sie einen Eintrag für den jeweiligen Bericht und Benutzer an.

3. Ordnen Sie den gewünschten Drucker zu.

Nächste Schritte

• Shipping Labels anfordern

• Bereits bestellte Shipping Labels einsehen

• Tabellen- und Feldreferenz