Shipping Labels anfordern

Ventoo Shipping erlaubt drei Wege, ein Versandetikett zu erstellen:

• aus einem Verkaufsauftrag (Sales Order),

• aus einer gebuchten Verkaufslieferung (Posted Sales Shipment),

• manuell, ohne Quelldokument.

In allen Fällen öffnet sich der Assistent Versandetikett erstellen (Seite Create Shipment Label VTO). Dort werden die für den Spediteur relevanten Daten geprüft, ergänzt und mit der Aktion An Spediteur senden an die API übermittelt.

Voraussetzungen

• Es ist mindestens ein aktivierter Spediteur in der Spediteureinrichtung vorhanden.

• Die OAuth-Zugangsdaten des Spediteurs sind hinterlegt.

• Optional: Standardspediteur und Standardabholung von Firma sind in der Versandeinrichtung gesetzt.

Versandetikett aus einem Verkaufsauftrag erstellen

1. Öffnen Sie den gewünschten Verkaufsauftrag.

2. Wählen Sie im Menüband Versandetikett erstellen.

3. Der Assistent Versandetikett erstellen öffnet sich mit folgenden Vorbelegungen:

   • Quelldokumenttyp = Verkaufsauftrag, Quelldokumentnr. = Auftragsnummer.

   • Referenz = Auftragsnummer (max. 40 Zeichen).

   • Abholadresse aus den Firmendaten, sofern Standardabholung von Firma aktiviert ist.

   • Lieferadresse aus den Ship-to-Feldern des Auftrags (Name, Adresse, Postleitzahl, Ort, Land, Kontakt).

   • Spediteurcode = Standardspediteur aus der Versandeinrichtung.

   • Abhol- und Lieferdatum = WorkDate().

   • Eine leere Pakete-Zeile (Transporteinheit) wird vorinitialisiert.

Hinweis: Telefonnummer und E-Mail-Adresse sind in den Ship-to-Feldern des Auftrags nicht vorhanden und müssen bei Bedarf manuell ergänzt werden. Über das Integrationsereignis OnPopulateDeliveryAddress lassen sich zusätzliche Felder automatisch vorbelegen.

Versandetikett aus einer gebuchten Verkaufslieferung erstellen

1. Öffnen Sie die Gebuchte Verkaufslieferung.

2. Wählen Sie Versandetikett erstellen.

3. Der Assistent öffnet sich, Quelldokumenttyp ist Gebuchte Lieferung und die Ship-to-Felder werden aus der Lieferung übernommen.

Versandetikett manuell erstellen

1. Öffnen Sie die Seite Versandetiketten.

2. Wählen Sie Neu. Der Datensatz wird mit Quelldokumenttyp = Manuell angelegt.

3. Befüllen Sie die Pflichtfelder im Assistenten.

Eingaben im Assistenten

Im Inforegister Spediteur und Referenz wählen Sie den Spediteur und die Referenz (max. 40 Zeichen). Quelldokumenttyp und Quelldokumentnr. sind nicht änderbar.

In den Inforegistern Abholadresse und Lieferadresse prüfen und vervollständigen Sie die Adressdaten. Für Planzer sind insbesondere folgende Felder erforderlich:

• Name, Strasse, Postleitzahl, Ort und Landcode.

• Der Landcode muss CH oder LI sein.

• Die Postleitzahl muss vierstellig und numerisch sein.

Im Inforegister Daten und Zeiten legen Sie Abholdatum und Lieferdatum fest. Optional können Abholzeit von/bis und Lieferzeit von/bis ergänzt werden.

Im Unterformular Pakete (Transporteinheiten / Pakete) erfassen Sie eine Zeile pro Transporteinheit:

Im Unterformular Serviceoptionen wählen Sie über die Spalte Beschreibung eine Serviceoption aus den vom Spediteur freigegebenen Codes (z. B. 2030001 – Pflichtunterschrift, 2030004 – Samstagszustellung). Die Auswahl ist auf den Spediteur und auf aktivierte Codes gefiltert.

Im Unterformular Hinweismeldungen fügen Sie textbasierte Zusatzinformationen hinzu, z. B. eine allgemeine Bemerkung (remark), eine zusätzliche Referenz (reference1) oder eine Zustellanweisung (deposit). Die maximale Länge wird beim Speichern automatisch gegen die Spediteur-Definition (Feld Maximallänge) geprüft.

Im Inforegister Etiketteneinstellungen legen Sie Etikettenformat (PDF oder ZPL) und Etikettenauflösung (dpi) fest. Für ZPL ist die Auflösung Pflicht.

Versandetikett senden

1. Wählen Sie im Assistenten An Spediteur senden.

2. Ventoo Shipping prüft die Eingaben (ValidateRequest). Sind Pflichtfelder leer oder ungültig (z. B. ungültiger Landcode, zu langes Referenzfeld, fehlende Pakete, Gewicht > 30 kg), wird der Status auf Fehler gesetzt und alle Validierungsmeldungen werden gesammelt in Fehlermeldung ausgegeben.

3. Bei erfolgreicher Validierung baut der Spediteur-Konnektor das JSON-Payload, holt einen OAuth-Access-Token und sendet den Request an die Spediteur-API. Der Status wechselt vorübergehend auf Gesendet.

4. Bei erfolgreicher Antwort:

   • Der Status wechselt auf Erfolg.

   • Das zurückgegebene Base64-PDF wird im Feld Label PDF abgelegt.

   • Die Transporteinheitsnummer, der Tracking-Link und – sofern geliefert – der Strichcode werden in der zugehörigen Paketzeile gespeichert.

5. Bei einem HTTP-Fehler oder einer ungültigen Antwort:

   • Der Status wechselt auf Fehler.

   • Die Fehlermeldung wird befüllt.

   • Sind im Spediteur API-Aufrufe protokollieren aktiv, werden Request und Response im Etikett gespeichert.

6. Ist in der Versandeinrichtung Auto-Druck nach Erstellung aktiviert, wird das PDF nach Erfolg automatisch über die hinterlegte Druckerauswahl gedruckt. Andernfalls erscheint eine Bestätigungsmeldung mit der Etikettnummer. Bei PDF-Etiketten ohne Auto-Druck wird das PDF direkt zur Vorschau geöffnet.

Etikett verwerfen

Im Assistenten beendet die Aktion Abbrechen den Vorgang. Das Etikett bleibt mit Status Entwurf in der Liste Versandetiketten und kann später weiterbearbeitet oder über Standard-Business-Central-Funktionen gelöscht werden.

Nächste Schritte

• Bereits bestellte Shipping Labels einsehen

• Tracking einsehen