UPS

2026-08-20T13:05:21Z

Mirko: /* Versandart hinterlegen */

Für die Benutzung der UPS REST API Schnittstelle wird neben einem '''aktiven Konto bei UPS (Account), die mention Warenwirtschaft ab Version 2026 sowie mention Logistics ab Version 38.12.0 benötigt.'''

== Autorisierung I ==
Damit die mention Schnittstelle mit der UPS API Daten austauschen kann, muss zuvor der Zugriff durch den Benutzer bei UPS autorisiert werden. Hierfür wird der sechsstellige UPS-Abrechnungsnummer dem mention Entwickler-Account hinzugefügt und der UPS-Benutzer muss wiederum die Autorisierung auf UPS bestätigen.

Nach der Autorisierung durch den Benutzer kann die UPS-Abrechnungsnummer mit dem mention Entwickler-Account verknüpft und eine App für den Zugriff auf UPS erstellt werden. Die Verknüpfung und Erstellung der App erfolgt durch mention.

== Autorisierung II ==
In den Voreinstellungen für die Sammelabwicklung müssen neben den Absenderadressdaten, die UPS-Abrechnungsnummer sowie die von mentrion bereit gestellte Client-ID und Client-Secret eingetragen werden und anschließend damit eine weitere Autorisierung durchzuführen, um Token für den Zurgiff erzeugen zu können.

[[File:UPS VE Sammelabwicklung2.png]] 
''Abb.: VE Sammelabwicklung Register UPS''

Nach Klick auf die Schaltfläche '''Autorisierung''' öffnet sich im Browser die Autorisierungsseite von UPS, auf dieser der Zugriff durch die App bestätigt wird.

[[File:UPS Auorisierung Login.png]] 
''Abb.: Logindialog UPS-Autorisierungsseite''

Wurde die Autorisierung durchgeführt, erscheint ein Hinweis, dass das Browser-Fenster geschlossen werden kann. Nun kann das Token für den API-Zugriff durch Klick auf die Schaltfläche '''Zugriffstoken anfordern''' bei UPS abgerufen werden. 
Nachdem die Token-Anforderung erfolgreich durchgeführt und auf dem Arbeitsplatz-Rechner für die weitere Verwendung gespeichert wurde, wird dies mit einer entsprechenden Meldung bestätigt:

[[File:UPS VE Sammelabwicklung Ok Dialog.png]] 
''Abb.: OK-Meldung nach erfolgreicher Token-Anforderung''

'''Hinweise'''

Standardmäßig erfolgt kein vollständiger Zugriff auf alle Bereiche UPS-API. Je nach Anforderungsprofil müssen einige Funktionen erst extra freigeschaltet werden, auch kann eine Überprüfung seitens UPS zur Berechtigung erfolgen. Eine Freischaltung muss bei der mention Software angefragt werden.

Für die meisten UPS-Versanddienste ist eine Kurzbeschreibung der Waren zwingend erforderlich. Dazu muss in den Voreinstellungen eine Angabe der zu versendenden Güter hinterlegt werden:

[[File:UPS VE Sammelabwicklung Warenbeschreibung.png]] 
''Abb.: VE Sammelabwicklung Register UPS (rechts)''

== Versandart hinterlegen ==
Eine neue Versandart in der mention Warenwirtschaft erstellen und bei '''Schnittstelle Versand UPS (API) auswählen.''' 

[[File:UPS VE Versandart1.png]] 
''Abb.: VE Versandarten''

Für die Versandart müssen auch zusätzliche Dienste/Produkte ausgewählt werden (Schaltfläche Produkte). 
Für den Zollversand muss ein entsprechender Eintrag ausgewählt werden (Sammelabwicklung: Zollinhaltserklärung).

[[File:UPS VE Versandart Produkte2.png]] 
''Abb.: VE Versandarten - UPS - Produkte''

mention Software Wiki - Neue Seiten [de]

UPS