Auch den Versanddienstleister UPS kannst du an xentral anbinden und dort nutzen. In diesem Artikel werden die einzelnen Einrichtungspunkte für deine erfolgreiche Anbindung beschrieben.
Eine allgemeine Übersicht über die Versandarten und Paketmarken, die du in xentral nutzen kannst, findest du hier.
UPS bietet dir u.a. folgende Features:
-
Testdruck von Paketmarken über Sandbox
-
Modifizierung der Paketmarke über Referenzfelder
-
Nutzung des Services der Nachnahme
-
Berechnung des Volumengewichts
-
Deaktivierung der Adressvalidierung
Im folgenden Abschnitt findest du Informationen darüber, wie die Anbindung der UPS-Schnittstelle an xentral funktioniert und an welchem Ort du welche Daten findest.
Melde dich im ersten Schritt mit deinen Zugangsdaten in deinem UPS-Account an, folge dazu diesem Link: UPS Login
Navigiere zum Reiter "Dienstleistungen" und wählen "UPS Technologie integrieren" aus:
Klicke dann auf "UPS KIT für Entwickler":
Navigiere zu "Versand API" und dann zu "APIs herunterladen":
Dadurch gelangst du zur folgenden Ansicht. Klicke hier auf "Schritt 4: Einen Zugriffsschlüssel anfordern":
Dieser Zugriffsschlüssel entspricht dem API-Key in xentral, der in der Versandart hinterlegt werden muss.
Anmerkung
UPS lässt u.U. keine Sonderzeichen in einem Passwort zu, auch kein Sternchen (*). Solltest du aus diesem Grund Probleme bei der Anbindung bekommen, ändere dein Passwort oder wende dich an UPS.
Um UPS in xentral als Versandart nutzen zu können, musst du zunächst eine neue Versandart anlegen. Dafür erstellst du unter Administration → Einstellungen → Versandarten → Übersicht → "+NEU" → UPS eine neue Versandart.
Befülle folgende Felder:
-
Bezeichnung → Wähle frei eine Bezeichnung für die Versandart. Diese wird in xentral u.a. im Auftrag zur Auswahl im Drop-Down Menü angezeigt
-
Typ → Gib den Typ/die Feldbezeichnung an. Diese kannst du generell beliebig wählen, sofern sie nicht für das Shop Mapping oder andere Mappings notwendig ist. Idealerweise behältst du die Voreinstellung bei
-
Modul → Wähle "UPS" aus dem Drop-Down Menü aus
-
Projekt → Wähle optional ein Projekt aus, sofern für jedes Projekt eine eigene UPS-Versandart angelegt wird
-
Aktiv → Durch Anhaken aktivierst du die Versandart und machst sie sicht- und nutzbar
-
Kein Portocheck → Durch Anhaken wird kein Portocheck im Auftrag durchgeführt
-
Drucker Paketmarke → Wähle aus dem Drop-Down Menü den Standarddrucker aus, welcher die Paketmarken druckt
-
Drucker Export → Wähle aus dem Drop-Down Menü den Standarddrucker aus, welcher die Exportpapiere druckt
-
Versandmail → Wähle aus dem Drop-Down Menü das Verhalten der Versandmail aus. "Standardverhalten" bedeutet, dass eine Standard-Trackingmail versendet wird, "keine Versandmail" bedeutet, dass keine Trackingmail bei dieser Versandart versendet wird und "eigene Textvorlage" bedeutet, dass für diese Versandart eine eigene Textvorlage für die Versandbestätigung verwendet wird, unabhängig vom Projekt und Logistikprozess
-
API Benutzer → Gib den API Benutzer ein, dieser entspricht deinen Zugangsdaten zum UPS-Portal
-
API Passwort → Gib das API Passwort ein, dieses entspricht deinen Zugangsdaten zum UPS-Portal
-
API Key → Gib den API Key aus dem Kundenportal ein
-
Accountnummer → Gib deine Accountnummer bei UPS an. Diese findest du unter Mein Profil → Zahlungsmöglichkeiten
-
Absender Name → Gib den Namen des Absenders ein. Dieser muss dabei mit dem Namen unter Mein Profil → Meine Informationen → Meine Adressen übereinstimmen
-
Absender Ansprechpartner → Gib den Namen des Ansprechpartners auf Seiten des Absenders ein
-
Absender Strasse → Gib die Straße des Absenders an
-
Absender Hausnummer → Gib die Hausnummer des Absenders an
-
Absender PLZ → Gib die PLZ des Absenders ein
-
Absender Ort → Gib den Ort des Absenders ein
-
Absender Bundesstaat → Gib den Bundesstaat des Absenders ein
-
Absender Land → Gib das Land des Absenders ein
-
Absender E-Mail → Gib die E-Mail Adresse des Absenders ein
-
Absender Telefon → Gib die Telefonnummer des Absenders ein
-
Absender Internet → Gib die Website des Absenders ein
-
Absender Steuerkennung → Gib die Steuerkennung des Absenders ein
-
Standardgewicht → Gib das Standardgewicht deiner Sendungen an. Dieses erscheint im Versanddialog
-
Länge → Gib die Länge deiner Standardsendungen in cm an
-
Breite → Gib die Breite deiner Standardsendungen in cm an
-
Höhe → Gib die Höhe deiner Standardsendungen in cm an
-
Standard Service Code → Gib den Standard Service Code aus dem Kundenportal ein, z.B. "011"
-
Standard Service Description → Gib die Standard Service Description aus dem Kundenportal ein, z.B. "UPS Standard"
-
Standard Package Code → Gib den Standard Package Code aus dem Kundenportal an, z.B. "02"
-
Standard Package Description → Die Standard Package Description kannst du frei vergeben, z.B. "Customer Supplied"
-
Referenz auf Label 1 → Gib den auf der Paketmarke erscheinenden Text ein. Verwende optional eine Variablen {LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER} und {INTERNET}. Beachte, dass in das Feld nur eine Variable eingetragen werden darf
-
Referenz auf Label 2 → Gib den auf der Paketmarke erscheinenden Text ein. Verwende optional eine Variablen {LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER} und {INTERNET}. Beachte, dass in das Feld nur eine Variable eingetragen werden darf
-
Volumengewicht → Durch Anhaken wird das Volumengewicht aus den Maßen berechnet und übergeben
-
Adressvalidierung deaktivieren → Durch Anhaken deaktivierst du die Adressvalidierung durch UPS, d.h. die Adresse wird nicht durch UPS überprüft
-
Export Grund → Trage den Exportgrund ein. Diesen musst du nur bei ausländischen Sendungen angeben
-
Logging → Durch Anhaken werden die Ausgabe und Antwort in einer XML Datei protokolliert, die Datei liegt im Ordner userdata/tmp
-
Tracking übernehmen → Durch Anhaken wird die Trackingnummer nach dem Erstellen der Paketmarke automatisch in das Feld eingefügt und muss nicht mehr von der Paketmarke gescannt werden
-
ZPL als Ausgabeformat → Durch Anhaken wird das Paketlabel in ZPL statt in PDF angefragt
-
UPS Sandbox (Testmodus) → Durch Anhaken kannst du den Paketmarkendruck mit der UPS Sandbox testen. Auf die Paketmarke wird dann "SAMPLE" aufgedruckt
-
UPS Quantum View Notify → Durch Anhaken verwendest du die Ankunftsvorhersage von UPS
Klicke abschließend rechts unten auf "Speichern".
Sobald du alle Einstellungen wie oben beschrieben vorgenommen hast, kannst du den Paketmarkendruck im Versandzentrum oder auch in einem einzelnen Lieferschein testen. Wähle dazu im Lieferschein im Reiter "Lieferschein" die Versandart "UPS" aus dem Drop-Down Menü aus.
Klicke auf die "Speichern"-Schaltfläche, bevor du in den Paketmarkendialog navigierst.
Klicke im Anschluss im Lieferschein auf den Reiter "Paketmarke", trage dich selbst als Empfänger ein und drucke über "Paketmarke drucken" eine Paketmarke für die enthaltenen Artikel.
Falls du den Service der Nachnahme nutzen möchtest, kannst du diesen über das Anhaken des Felds "Nachnahme" aktivieren.
Nachdem dein Testdruck abgeschlossen ist, kannst du im Anschluss die Paketmarke im UPS-Geschäftskundenportal stornieren.
Anmerkung
Beim Versand ins Ausland musst du die Felder Name, Name2 und Telefon unbedingt ausfüllen.
