UPS Unlock

UPS Unlock ermöglicht Ihnen, Zonos-konforme Sendungen über Ihre eigene Versandplattform zu erstellen, anstatt das Zonos Dashboard zu nutzen. Durch Hinzufügen einer bestimmten Referenznummer bei der Bearbeitung von UPS-Sendungen validiert und aktualisiert UPS Sendungsdaten automatisch über Zonos – einschließlich Zollbeschreibungen, HS-Codes, Zollkontonummern, Steuer-IDs und Warenwerte. Das macht komplexe Regeln oder Integrationen überflüssig, um diese Informationen an Ihre Versandplattform zu übergeben. Stattdessen ruft UPS die Daten direkt von Zonos ab, reduziert Abweichungen oder fehlende Informationen und minimiert manuellen Einrichtungs- und Wartungsaufwand.

UPS Unlock einrichten 

1. Zonos Support kontaktieren – Bevor Sie UPS Unlock aktivieren, wenden Sie sich an den Zonos Support, um sicherzustellen, dass Ihr UPS-Konto korrekt konfiguriert ist. Dieser Prozess dauert in der Regel 24–48 Stunden.
2. UPS Unlock im Dashboard aktivieren – Gehen Sie zum Zonos Dashboard → Einstellungen → Tarife → UPS und schalten Sie UPS Unlock auf Aktivieren
3. Referenznummern konfigurieren – Mindestens eine Referenznummer muss mit zx oder zx- beginnen. Solange mindestens eine Referenz mit zx beginnt (auch wenn der Wert nur zx ist), durchsucht Zonos alle Referenznummern, um eine passende Zonos-Bestell-ID oder Händler-Bestellnummer zu finden.
   • Beispiele:
     • zxORDER123 oder zx-ORDER123 (kombiniertes Format mit Händler-Bestellnummer)
     • zxorder_0jy1vh6gygcks oder zx-order_0jy1vh6gygcks (kombiniertes Format mit Zonos-Bestell-ID)
     • Referenz 1: zx, Referenz 2: ORDER123 (auf zwei Referenzfelder aufgeteilt)

Funktionsweise 

Nach der Einrichtung von UPS Unlock verweisen UPS-Sendungen auf Zonos-Bestelldaten. So funktioniert der Prozess:

1. UPS ruft Zonos automatisch auf, um die Bestellung mit den angegebenen Referenzfeldern zu validieren
2. Zonos validiert und gibt aktualisierte Zolldetails an UPS zurück – Zonos prüft, ob die Sendung dem ursprünglichen Angebot entspricht:
   1. Artikel in der Sendung entsprechen denen im Angebot
   2. Mengen sind kleiner oder gleich den angebotenen Mengen
   3. Teilenummern entsprechen Produkt-IDs oder SKUs aus dem Angebot
   4. Zieldetails (Land/Bundesland) entsprechen dem Angebot
3. UPS verarbeitet Ihre Sendung mit Compliance-Informationen
4. UPS ruft Zonos auf, um einen Sendungsdatensatz mit Sendungsverfolgungsnummer zu erstellen
5. Zonos erfasst die Sendung in der Bestellung

Referenzabgleich 

Wenn UPS Zonos mit einer Referenz wie zx-ORDER123 aufruft, entfernt Zonos das Präfix und sucht die Bestellung. Der Wert nach dem Präfix (ORDER123 in diesem Beispiel) wird mit drei Feldern der Zonos-Bestellung abgeglichen:

Zonos gibt die zuletzt passende Bestellung zurück. Wird keine gefunden, wird ein Fehler zurückgegeben.

Anforderungen

Damit UPS Unlock erfolgreich ist, muss die Bestellung diese Anforderungen erfüllen:

• Landed Cost Guarantee (LCG) – Die Bestellung muss über den Zonos-Checkout-Flow mit garantiertem Landed Cost erstellt worden sein. Außerhalb von Zonos erstellte Bestellungen können nicht mit UPS Unlock genutzt werden.
• Übereinstimmender Ursprung/Ziel – Versand- und Zielland müssen dem ursprünglichen Angebot entsprechen. Bei Sendungen nach Kanada oder Brasilien muss auch die Provinz übereinstimmen.
• Übereinstimmende Produkte – Teilenummern müssen den Produkt-IDs oder SKUs aus dem Angebot entsprechen, und Mengen dürfen die angebotenen Mengen nicht überschreiten.

Fehlercodes 

Schlägt die Validierung fehl, erhält UPS eine Fehlerantwort von Zonos. Häufige Fehlercodes:

ShipStation-Integration 

ShipStation-Nutzer können UPS Unlock konfigurieren, indem sie das zx-Präfix entweder upstream (per API, bevor Bestellungen ShipStation erreichen) oder in ShipStation mit Label Messages und Automation Rules hinzufügen. So können zx-Präfix und Bestell-ID in über ShipStation verarbeiteten UPS-Sendungen enthalten sein und UPS Unlock auslösen. Nach den ersten Einrichtungsschritten können Sie ShipStation für UPS Unlock konfigurieren.

zx upstream hinzufügen

Wenn Sie das zx-Präfix upstream hinzufügen können (bevor Bestellungen ShipStation erreichen), müssen Sie nur Ihre Label Messages so konfigurieren, dass die zx-Bestellnummer angezeigt wird:

Label Messages konfigurieren

1. Label Messages-Einstellungen öffnen: Gehen Sie zu Settings → Printing → Printing Setup, dann Document Options für Label
2. Label Messages konfigurieren: Im Abschnitt Label Messages können Sie bis zu 3 benutzerdefinierte Nachrichten definieren, die als Referenznummern auf UPS-Labels erscheinen. Label Messages akzeptieren nur voreingestellte Werte wie „Custom Field 1“, „Order #“ usw.
3. Nachrichten auf Bestellnummer setzen: Setzen Sie Message #1 auf [Order #]. Falls #1 bereits belegt ist, nutzen Sie #2 oder #3
4. Einstellungen speichern, um die Konfiguration anzuwenden

Danach setzt ShipStation automatisch Ihre Bestellnummer auf das Label – einschließlich Ihres konfigurierten zx-Präfixes.

zx in ShipStation hinzufügen

Wenn Sie das zx-Präfix nicht upstream hinzufügen können, konfigurieren Sie Label Messages und Automation Rules so, dass Präfix und Bestellnummer über zwei separate Label Messages angezeigt werden:

Schritt 1: Label Messages konfigurieren

Konfigurieren Sie Label Messages für Präfix und Bestellnummer:

1. Label Messages-Einstellungen öffnen: Gehen Sie zu Settings → Printing → Printing Setup, dann Document Options für Label
2. Label Messages konfigurieren: Im Abschnitt Label Messages können Sie bis zu 3 benutzerdefinierte Nachrichten definieren, die als Referenznummern auf UPS-Labels erscheinen.
3. Nachrichten setzen:
   • Message #1 auf [Custom Field 1] setzen (wird per Automation Rule mit „zx“ befüllt)
   • Message #2 auf [Order #] setzen (aus Dropdown wählen)
4. Einstellungen speichern, um die Konfiguration anzuwenden

Schritt 2: Automation Rules konfigurieren

Nach der Label-Messages-Konfiguration erstellen Sie eine Automation Rule, die Custom Field 1 mit dem zx-Präfix befüllt. Gehen Sie zu Settings → Automation → Automation Rules und klicken Sie Create a Rule.

Regel für Zonos-UPS-Bestellungen:

1. Name: „Zonos UPS Unlock“
2. Stellen Sie sicher, dass Active Rule aktiviert ist
3. Wählen Sie Orders match these specific criteria
4. Kriterien setzen: „International Order“ = „True“ UND „Carrier“ + „Includes“ + „UPS“

Hinweis: Ihre Auslösekriterien können je nach ShipStation-Konfiguration variieren. Dies ist ein empfohlener Ausgangspunkt – passen Sie die Bedingungen an Ihren Workflow an, damit UPS Unlock nur bei passenden Bestellungen greift.

1. Aktionen setzen:
   • Action Type: „Set Custom Field 1...“ wählen
   • Custom Field 1: zx (setzt das Präfix)
2. Klicken Sie auf Save Rule

Danach befüllt ShipStation automatisch Custom Field 1 mit zx und Message #2 mit der Bestellnummer für internationale UPS-Bestellungen. Diese erscheinen auf UPS-Labels als zwei separate Referenzzeilen.

Wichtig: Die Label-Messages-Konfiguration in ShipStation ist eine globale Änderung für alle Carrier. Mit Automation Rules funktioniert UPS Unlock nahtlos für Zonos-Bestellungen, während Ihre bevorzugten Label Messages für andere Sendungen erhalten bleiben.