Zum Inhalt

Labels erstellen

Mit dem UPS Connector können Sie Einzellabels, Bulk-Labels und Retourenlabels erstellen sowie Sendungen stornieren und Labels erneut abrufen. Diese Anleitung erklärt alle Varianten Schritt für Schritt.

Einzellabel erstellen

Schritt 1: Label-Erstellung starten

Über das merchantCENTRAL Dashboard:

  1. Öffnen Sie das merchantCENTRAL Dashboard
  2. Klicken Sie auf Versandlabels → Neues Label erstellen

Über die Versandlabel-Liste:

  1. Öffnen Sie die Versandlabel-Liste (Suche: Shipment Labels)
  2. Klicken Sie auf Neu in der Aktionsleiste

Über einen Verkaufsauftrag:

  1. Öffnen Sie den gebuchten Verkaufsauftrag oder die Verkaufslieferung
  2. Nutzen Sie die Aktion Versandlabel erstellen

Schritt 2: Versanddienstleister wählen

Im Dialog Label erstellen:

  • Shipment Provider: UPS
  • Service: wird aus dem UPS Setup vorbelegt (z. B. 11 für UPS Standard)

Service pro Label ändern

Sie können den UPS-Service pro Sendung individuell ändern. Zum Beispiel normalerweise UPS Standard für reguläre Sendungen, aber UPS Express für dringende Pakete.

Schritt 3: Empfängerdaten ausfüllen

Feld Beschreibung Pflicht
Recipient Name Name des Empfängers ✅ Ja
Recipient Attention Name Ansprechpartner (z.Hd.) ❌ Nein
Recipient Street Straße des Empfängers ✅ Ja
Recipient Street 2 Adresszusatz ❌ Nein
Recipient Post Code Postleitzahl ✅ Ja
Recipient City Stadt ✅ Ja
Recipient Country Code Ländercode (ISO-2, z. B. DE, US) ✅ Ja
Recipient State/Province Bundesland/Staat (für USA/CA Pflicht) ⚠️ Bedingt
Recipient Email E-Mail (für QVN Ship Notification) ❌ Nein
Recipient Phone Telefon ❌ Nein

Automatische Befüllung

Wenn Sie das Label aus einem Verkaufsauftrag erstellen, werden die Empfängerdaten automatisch aus der Lieferadresse übernommen.

USA & Kanada: State ist Pflicht

Für Sendungen in die USA oder nach Kanada muss das Feld State/Province ausgefüllt werden (z. B. CA, NY, ON). UPS lehnt Sendungen ohne dieses Feld ab.

Schritt 4: Sendungsdetails angeben

Feld Beschreibung Standard
Weight (kg) Gewicht in Kilogramm Aus UPS Setup
Package Type Verpackungsart Aus UPS Setup
Package Content Inhaltsbeschreibung —
Reference No. 1 Ihre Referenznummer (z. B. Auftragsnummer) —
Reference No. 2 Zweite Referenznummer —

Schritt 5: Label erstellen

Klicken Sie auf Erstellen. Business Central führt folgende Schritte aus:

  1. Validierung — Prüfung aller Pflichtfelder, Gewicht ≤ 70 kg, Ländercodes = 2 Zeichen
  2. OAuth Token — Falls kein gültiges Token vorhanden, wird ein neues angefordert
  3. JSON-Request — Sendung als JSON an die UPS Shipping API (POST /api/shipments/v2409/ship)
  4. Antwort parsen — ShipmentIdentificationNumber, Tracking-Nummern, Label-Grafik
  5. Speicherung — Label und Tracking-Nummern werden in Business Central gespeichert

Nach erfolgreicher Erstellung sehen Sie:

  • Die Shipment Identification Number (UPS-Sendungsnummer)
  • Eine Tracking-Nummer pro Packstück
  • Tracking-URL: https://www.ups.com/track?tracknum={Nummer}
  • Das Label steht zum Download/Druck bereit

Bulk-Labels erstellen

Für die Verarbeitung mehrerer Sendungen auf einmal:

Vorgehensweise

  1. Öffnen Sie die Versandlabel-Liste
  2. Wählen Sie mehrere offene Labels aus (++ctrl+klick++ oder ++shift+klick++)
  3. Klicken Sie auf Bulk-Labels erstellen in der Aktionsleiste
  4. Bestätigen Sie die Erstellung

Sequenzielle Verarbeitung

Anders als bei DPD (ein SOAP-Aufruf für alle) werden UPS-Labels sequenziell erstellt — eine Sendung nach der anderen. Dies liegt an der UPS-API, die keinen Multi-Shipment-Endpunkt bietet. Die Bulk-Funktion automatisiert den Prozess trotzdem erheblich.

Fehlerbehandlung bei Bulk

  • Bei einem Fehler wird die betroffene Sendung markiert, der Prozess läuft für die verbleibenden Sendungen weiter
  • Prüfen Sie nach der Bulk-Erstellung die Fehlermeldungen in der Label-Liste

Multi-Parcel-Sendungen

Für Sendungen mit mehreren Packstücken:

Packstücke hinzufügen

  1. Öffnen Sie das Label
  2. Im Bereich Packages sehen Sie die Packstückliste
  3. Fügen Sie für jedes Packstück eine Zeile hinzu:
Feld Beschreibung
Package Type Verpackungsart (pro Packstück individuell)
Weight (kg) Gewicht in Kilogramm (max. 70 kg)
Length / Width / Height (cm) Abmessungen in Zentimetern
Package Content Inhaltsbeschreibung
Reference No. 1 Referenz für dieses Packstück

Volumetriegewicht

UPS berechnet das Transportgewicht als Maximum aus tatsächlichem Gewicht und Volumetriegewicht (L × B × H / 5000). Geben Sie die Abmessungen an, damit UPS das korrekte Gewicht berechnet und keine Nachberechnung erfolgt.

Nach der Erstellung

Jedes Packstück erhält eine eigene Tracking-Nummer. In der Package-Liste sehen Sie:

  • Tracking Number — individuelle UPS-Tracking-Nummer pro Packstück
  • Alle Packstücke sind über die gemeinsame Shipment Identification Number verknüpft

→ Details: Pakete

Sendung stornieren

Erstellte UPS-Sendungen können storniert werden, solange sie noch nicht abgeholt wurden:

Vorgehensweise

  1. Öffnen Sie das Versandlabel, das Sie stornieren möchten
  2. Klicken Sie auf Sendung stornieren in der Aktionsleiste
  3. Bestätigen Sie die Stornierung

Was passiert bei der Stornierung?

  • Business Central sendet einen Void-Request an UPS (DELETE /api/shipments/v2409/void/cancel/{id})
  • UPS bestätigt die Stornierung mit StatusCode 1
  • Das Label wird in Business Central als storniert markiert
  • Die Tracking-Nummer wird ungültig

Zeitfenster beachten

Eine Stornierung ist nur möglich, bevor UPS das Paket physisch übernommen hat. Nach der Abholung kann die Sendung nicht mehr storniert werden.

Label erneut abrufen (Label Recovery)

Falls ein Label verloren gegangen ist oder nicht gedruckt werden konnte:

Vorgehensweise

  1. Öffnen Sie das betroffene Versandlabel
  2. Klicken Sie auf Label erneut abrufen in der Aktionsleiste
  3. Business Central fordert das Label über die Label Recovery API erneut an

Tracking-Nummer erforderlich

Für die Label Recovery muss die Tracking-Nummer bekannt sein. Diese wird beim Erstellen des Labels automatisch gespeichert.

Validierung vor der Erstellung

Bevor ein Label erstellt wird, prüft Business Central automatisch:

Prüfung Fehlermeldung
Account Number vorhanden? Account Number must have a value
Absenderadresse vollständig? Shipper Name/Street/PostCode/City must have a value
Credentials vorhanden? Client ID and Client Secret are required
Empfängername vorhanden? Recipient name is required
Empfängerstraße vorhanden? Recipient street is required
Empfänger-PLZ vorhanden? Recipient post code is required
Empfängerstadt vorhanden? Recipient city is required
Ländercode = 2 Zeichen? Country code must be 2 characters
Gewicht ≤ 70 kg? Weight must not exceed 70 kg
Zollartikel für Non-EU? Customs items are required for non-EU shipments

Gewichtsformat

UPS verwendet Kilogramm (KGS) als Gewichtseinheit:

Eingabe in BC An UPS gesendet
0,5 kg 0.5 KGS
1 kg 1.0 KGS
5 kg 5.0 KGS
31,5 kg 31.5 KGS
70 kg (Maximum) 70.0 KGS

Gewichtsumrechnung

Falls Gewichte in Ihrem System in Gramm gespeichert sind, rechnet der Connector automatisch um (÷ 1000).

Häufige Fragen

Kann ich ein erstelltes Label nachträglich ändern?

Nein. Stornieren Sie das Label und erstellen Sie ein neues.

Werden Versandbenachrichtigungen an den Empfänger gesendet?

Ja! Wenn eine E-Mail-Adresse des Empfängers angegeben ist, aktiviert der Connector automatisch die UPS Quantum View Notification (QVN) — der Empfänger erhält eine E-Mail mit Tracking-Informationen.

Welcher Pakettyp ist der Standard?

Customer Supplied Package (02) — Ihre eigene Verpackung. Verwenden Sie die UPS-Verpackungstypen (Letter, Tube, PAK, Express Box) nur, wenn Sie tatsächlich UPS-eigene Verpackungsmaterialien nutzen.

Wie viele Packstücke kann eine Sendung haben?

Es gibt kein festes Limit. Jedes Packstück erhält eine eigene Tracking-Nummer.

Kann ich nach einer Stornierung das gleiche Label wiederverwenden?

Nein. Nach einer Stornierung ist die Tracking-Nummer ungültig. Erstellen Sie ein neues Label.