Anbindung von UPS an Xentral

In Xentral haben Sie die Möglichkeit, eine Anbindung zum Versanddienstleister UPS vorzunehmen. Im Folgenden werden die einzelnen Einrichtungspunkte für eine erfolgreiche Anbindung beschrieben.

Features

API Benutzer, API Passwort, API Key und Accountnummer erhalten Sie aus dem Kundenportal
Standardgewicht: Gewicht, das am Anfang im Versanddialog eingetragen ist
Länge, Breite, Höhe: Maße, die am Anfang im Versanddialog eingetragen sind
Benötigt Standard Service Code (aus Kundenportal, z.B. "011")
Benötigt Standard Service Description (aus Kundenportal, z.B. "UPS Standard")
Benötigt Standard Package Code (aus Kundenportal, z.B. "02")
Benötigt Standard Package Description (kann frei vergeben werden, z.B. "Customer Supplied")
Referenz1 und Referenz2 sind frei setzbar auf Label (mit Variablen erweiterbar: {LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER}, {INTERNET})
Volumengewicht: Es wird das Volumengewicht aus den Maßen berechnet und übergeben
Adressvalidierung deaktivieren: Adresse wird nicht durch UPS überprüft
Logging: Ausgabe und Antwort werden in einer XML Datei protokolliert (Datei liegt im Ordner userdata/tmp)
Tracking übernehmen: Rückgemeldete Trackingnummer wird automatisch in Folgedialog eingetragen und muss nicht mehr von der Paketmarke gescannt werden
ZPL als Ausgabeformat: Paketlabel wird in ZPL angefragt statt in PDF
UPS Sandbox (Testmodus): Zum Testen von Paketmarken. Auf Paketmarke wird SAMPLE aufgedruckt
UPS Quantum View Notify: Ankunftsvorhersage von UPS verwenden
Feld Name 3: Wird als "c/o (care of)" übergeben

Anbindung der UPS-Schnittstelle

API-Key im UPS-Portal

Im erste Schritt müssen Sie sich mit Ihren Zugangsdaten in Ihrem UPS-Account anmelden. Dazu melden Sie sich unter folgendem Link an: UPS Login

Danach gehen Sie bitte, wie folgt auf den Reiter Dienstleistungen und wählen UPS Technologie integrieren aus.

Im Anschluss wählen Sie "UPS KIT für Entwickler" aus.

Hier gehen Sie bitte auf "Versand API" und im nächsten Fenster dann auf "APIs herunterladen".

Damit gelangen Sie in die folgende Ansicht. Hier gehen Sie bitte auf Schritt 4 "Einen Zugriffsschlüssel anfordern".

Der Zugriffsschlüssel entspricht unserem API-Key der wie folgt unter Administration → Einstellungen → Versandarten → UPS hinterlegt werden kann:

Benutzer und Passwort entsprechen den Angaben Ihrer Zugangsdaten zum UPS-Portal.

Hinweis: UPS lässt u.U. keine Sonderzeichen in einem Passwort zu, auch kein Sternchen (*). Sollten Sie aus diesem Grund Probleme bei der Anbindung bekommen, bitte ändern Sie Ihr Passwort oder wenden Sie sich dafür an UPS.

Der Absender Name muss dabei mit dem Namen unter Mein Profil → Meine Informationen → Meine Adressen übereinstimmen.

Die Accountnummer finden Sie unter Mein Profil → Zahlungsmöglichkeiten:

Sobald Sie die Daten erfolgreich im Projekt hinterlegt und gespeichert haben, können Sie unter Lager → Lieferschein einen Testlieferschein erzeugen und die Versandart UPS wählen. Wenn Sie diese erfolgreich im Lieferschein abgespeichert haben, ist es Ihnen nun möglich unter dem Reiter "Paketmarke" selbige für den Versanddienstleister zu erstellen und zu drucken.

Bitte wählen Sie sich selbst als Empfänger und stornieren die Paketmarke im Anschluss über Ihr Kundenportal.

UPS-Paketmarken drucken

Mehrere Paketmarken drucken

Es ist möglich, mehrere Paketmarken für 1 Sendung zu erstellen. Dazu müssen Sie im Paketmarkenformular die Anzahl der Pakete eingeben

Das wird auch auf der Paketmarke als Mehrfachpaket markiert: