UPS Shipment Setup
Zentrale Einrichtungsseite für den UPS Shipping Connector. Hier werden OAuth 2.0 Zugangsdaten, Absenderadresse und Standardeinstellungen für den UPS-Versand konfiguriert.
Seite öffnen
- Über die Suche: UPS Shipment Setup
- Über das merchantCENTRAL Dashboard → Versanddienstleister → UPS
Felder
API Credentials (OAuth 2.0)
Zugangsdaten für die UPS Shipping REST API mit OAuth 2.0 Authentifizierung.
| Feld | Beschreibung |
|---|---|
| API Base URL | Basis-URL der UPS API. Produktiv: https://onlinetools.ups.com, Sandbox: https://wwwcie.ups.com |
| Sandbox Mode | Aktiviert den Sandbox-Modus für Testumgebungen |
| Client ID | OAuth 2.0 Client ID (maskiert). Wird im UPS Developer Portal erstellt |
| Client Secret | OAuth 2.0 Client Secret (maskiert) |
OAuth 2.0 Token-Caching
Der UPS Connector speichert das Access Token und erneuert es automatisch bei Ablauf (~4 Stunden Gültigkeit). Über die Aktion Clear Token Cache kann das Token manuell zurückgesetzt werden.
Account
| Feld | Beschreibung |
|---|---|
| Account Number | UPS Kundennummer (6-stellige Shipper Number) |
Shipper Address
Absenderadresse für alle UPS-Sendungen.
| Feld | Beschreibung |
|---|---|
| Shipper Name | Name des Absenders |
| Shipper Attention Name | Ansprechpartner / z.Hd. |
| Shipper Street | Straße des Absenders (Zeile 1) |
| Shipper Street 2 | Straße des Absenders (Zeile 2, optional) |
| Shipper Post Code | Postleitzahl des Absenders |
| Shipper City | Stadt des Absenders |
| Shipper Country Code | Ländercode (ISO alpha-2, z.B. DE) |
| Shipper State/Province | Bundesland/Provinz (z.B. BY für Bayern, für USA/CA Pflicht) |
| Shipper Phone | Telefonnummer des Absenders |
| Shipper Email | E-Mail-Adresse des Absenders |
Default Settings
Standardwerte für die Label-Erstellung.
| Feld | Beschreibung |
|---|---|
| Default Service | Standard-UPS-Service: 11 (Standard), 07 (Express), 65 (Express Saver), 54 (Express Plus), 08 (Expedited) |
| Default Weight (kg) | Standardgewicht in Kilogramm |
| Default Package Type | Standard-Verpackungsart (z.B. 02 = Customer Supplied Package, 01 = UPS Letter) |
| Label Format | Format des Versandlabels (z.B. PDF, ZPL, GIF) |
| Label Size | Größe des Labels (z.B. 4x6, 4x8 Zoll) |
Status
Aktuelle Statusinformationen zur UPS-Integration.
| Feld | Beschreibung |
|---|---|
| Last Label Created | Datum und Uhrzeit des zuletzt erstellten Labels |
| Labels Created Today | Anzahl der heute erstellten Labels |
| Last Error Message | Letzte Fehlermeldung der UPS API (rot bei Fehler) |
| Last Error DateTime | Zeitpunkt des letzten Fehlers |
Aktionen
| Aktion | Beschreibung |
|---|---|
| Test Connection | Testet die Verbindung zur UPS API durch Anforderung eines OAuth Access Tokens. Zeigt bei Erfolg eine Bestätigungsmeldung |
| Clear Token Cache | Löscht das zwischengespeicherte OAuth Access Token. Beim nächsten API-Aufruf wird automatisch ein neues Token angefordert |
Hinweise
Token Cache leeren
Wenn nach einer Änderung der Client ID oder des Client Secrets Authentifizierungsfehler auftreten, hilft oft das Leeren des Token-Caches über die Aktion Clear Token Cache.
Singleton-Seite
Diese Seite hat genau einen Datensatz. Beim ersten Öffnen wird der Datensatz automatisch angelegt.