mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 06:00:28 +01:00
1 line
5.6 KiB
Plaintext
1 line
5.6 KiB
Plaintext
<h1>Anbindung von UPS an Xentral</h1>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.<h1>Features</h1><ul><li>API Benutzer, API Passwort, API Key und Accountnummer erhalten Sie aus dem Kundenportal</li><li>Standardgewicht: Gewicht, das am Anfang im Versanddialog eingetragen ist</li><li>Länge, Breite, Höhe: Maße, die am Anfang im Versanddialog eingetragen sind</li><li>Benötigt Standard Service Code (aus Kundenportal, z.B. "011")</li><li>Benötigt Standard Service Description (aus Kundenportal, z.B. "UPS Standard")</li><li>Benötigt Standard Package Code (aus Kundenportal, z.B. "02")</li><li>Benötigt Standard Package Description (kann frei vergeben werden, z.B. "Customer Supplied")</li><li>Referenz1 und Referenz2 sind frei setzbar auf Label (mit Variablen <i>erweiterbar: {LIEFERSCHEIN}, {AUFTRAG}, {PROJEKT}, {IHREBESTELLNUMMER}, {INTERNET}</i>)</li><li>Volumengewicht: Es wird das Volumengewicht aus den Maßen berechnet und übergeben</li><li>Adressvalidierung deaktivieren: Adresse wird nicht durch UPS überprüft</li><li>Logging: Ausgabe und Antwort werden in einer XML Datei protokolliert (Datei liegt im Ordner userdata/tmp)</li><li>Tracking übernehmen: Rückgemeldete Trackingnummer wird automatisch in Folgedialog eingetragen und muss nicht mehr von der Paketmarke gescannt werden</li><li>ZPL als Ausgabeformat: Paketlabel wird in ZPL angefragt statt in PDF</li><li>UPS Sandbox (Testmodus): Zum Testen von Paketmarken. Auf Paketmarke wird SAMPLE aufgedruckt</li><li>UPS Quantum View Notify: Ankunftsvorhersage von UPS verwenden</li><li>Feld Name 3: Wird als "c/o (care of)" übergeben</li></ul><h2><br />Anbindung der UPS-Schnittstelle</h2><h3><br />API-Key im UPS-Portal</h3>Im erste Schritt müssen Sie sich mit Ihren Zugangsdaten in Ihrem UPS-Account anmelden. Dazu melden Sie sich unter folgendem Link an: <a href="https://www.ups.com/lasso/login">UPS Login</a><br /><br />Danach gehen Sie bitte, wie folgt auf den Reiter Dienstleistungen und wählen UPS Technologie integrieren aus.<br /><br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=1" /><br />Im Anschluss wählen Sie "UPS KIT für Entwickler" aus.<br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=2" /><br /><br />Hier gehen Sie bitte auf "Versand API" und im nächsten Fenster dann auf "APIs herunterladen".<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=3" /><br /><br /><br />Damit gelangen Sie in die folgende Ansicht. Hier gehen Sie bitte auf Schritt 4 "Einen Zugriffsschlüssel anfordern".<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=4" /><br /><br />Der Zugriffsschlüssel entspricht unserem API-Key der wie folgt unter Administration → Einstellungen → Versandarten → UPS hinterlegt werden kann:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=5" /><br /><br />Benutzer und Passwort entsprechen den Angaben Ihrer Zugangsdaten zum UPS-Portal.<br /><br /><strong>Hinweis</strong>: 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.<br /><br />Der Absender Name muss dabei mit dem Namen unter Mein Profil → Meine Informationen → Meine Adressen übereinstimmen.<br /><br />Die Accountnummer finden Sie unter Mein Profil → Zahlungsmöglichkeiten:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=6" /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=7" /><br /><br />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.<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=8" width="500" /><br /><br />Bitte wählen Sie sich selbst als Empfänger und stornieren die Paketmarke im Anschluss über Ihr Kundenportal.<h2><br />UPS-Paketmarken drucken</h2><h3>Mehrere Paketmarken drucken</h3>Es ist möglich, mehrere Paketmarken für 1 Sendung zu erstellen. Dazu müssen Sie im Paketmarkenformular die Anzahl der Pakete eingeben<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=9" /><br /><br /><br />Das wird auch auf der Paketmarke als Mehrfachpaket markiert:<br /><br /><img src="index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=versandarten_ups&fileid=10" /><br /> <br /><br /> <br /> |