UPS: Unterschied zwischen den Versionen
Mirko (Diskussion | Beiträge) |
Mirko (Diskussion | Beiträge) (→Versandart hinterlegen) |
||
| (25 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 11: | Zeile 11: | ||
[[File:UPS VE Sammelabwicklung2.png]]<br> | [[File:UPS VE Sammelabwicklung2.png]]<br> | ||
''Abb.: VE Sammelabwicklung Register UPS'' | ''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. | 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. | ||
| Zeile 16: | Zeile 17: | ||
[[File:UPS Auorisierung Login.png]]<br> | [[File:UPS Auorisierung Login.png]]<br> | ||
''Abb.: Logindialog UPS-Autorisierungsseite'' | ''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.<br> | ||
| + | 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]]<br> | ||
| + | ''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]]<br> | ||
| + | ''Abb.: VE Sammelabwicklung Register UPS (rechts)'' | ||
| + | |||
| + | |||
| + | == Versandart hinterlegen == | ||
| + | Eine neue Versandart in der mention Warenwirtschaft erstellen und bei '''Schnittstelle Versand UPS (API) auswählen.'''<br> | ||
| + | |||
| + | [[File:UPS VE Versandart1.png]]<br> | ||
| + | ''Abb.: VE Versandarten'' | ||
| + | |||
| + | |||
| + | Für die Versandart müssen auch zusätzliche Dienste/Produkte ausgewählt werden (Schaltfläche Produkte).<br> | ||
| + | Für den Zollversand muss ein entsprechender Eintrag ausgewählt werden (Sammelabwicklung: Zollinhaltserklärung). | ||
| + | |||
| + | [[File:UPS VE Versandart Produkte2.png]]<br> | ||
| + | ''Abb.: VE Versandarten - UPS - Produkte'' | ||
Aktuelle Version vom 21. August 2026, 16:16 Uhr
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.

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.

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:

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:

Abb.: VE Sammelabwicklung Register UPS (rechts)
Versandart hinterlegen
Eine neue Versandart in der mention Warenwirtschaft erstellen und bei Schnittstelle Versand UPS (API) auswählen.
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).

