Logistics/UPS: Unterschied zwischen den Versionen
Mirko (Diskussion | Beiträge) |
Mirko (Diskussion | Beiträge) |
||
| (45 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
<p>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.'''</p> | <p>Für die Benutzung der UPS REST API Schnittstelle wird neben einem '''aktiven Konto bei UPS (Account), die mention ERP Warenwirtschaft ab Version 2026 sowie mention Logistics ab Version 38.12.0 benötigt.'''</p> | ||
== Autorisierung I == | == 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 | 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 die sechsstellige UPS-Abrechnungsnummer dem mention UPS-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. | 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 einen Mitarbeiter von mention ERP. | ||
== Autorisierung II == | == Autorisierung II == | ||
In den Voreinstellungen für die Sammelabwicklung müssen neben den Absenderadressdaten, die UPS-Abrechnungsnummer sowie die von | In den Voreinstellungen für die Sammelabwicklung müssen neben den Absenderadressdaten, die UPS-Abrechnungsnummer sowie die von mention bereit gestellte Client-ID und das Client-Secret eingetragen und anschließend damit eine weitere Autorisierung durchgeführt werden, um die Zugriffstoken anfordern zu können. | ||
[[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. | |||
[[File:UPS Auorisierung Login.png]]<br> | |||
''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 mention ERP 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 ERP 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 29. September 2026, 08:30 Uhr
Für die Benutzung der UPS REST API Schnittstelle wird neben einem aktiven Konto bei UPS (Account), die mention ERP 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 die sechsstellige UPS-Abrechnungsnummer dem mention UPS-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 einen Mitarbeiter von mention ERP.
Autorisierung II
In den Voreinstellungen für die Sammelabwicklung müssen neben den Absenderadressdaten, die UPS-Abrechnungsnummer sowie die von mention bereit gestellte Client-ID und das Client-Secret eingetragen und anschließend damit eine weitere Autorisierung durchgeführt werden, um die Zugriffstoken anfordern 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 mention ERP 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 ERP Warenwirtschaft erstellen und bei Schnittstelle Versand UPS (API) auswählen.
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).
Abb.: VE Versandarten - UPS - Produkte
