UPS Versand-Connector
Der merchantCENTRAL Shipment UPS Connector ermöglicht die vollständige Integration der UPS Shipping REST API in Microsoft Dynamics 365 Business Central. Sie können direkt aus Business Central heraus UPS-Versandlabels erstellen, Sendungen stornieren, Retourenlabels generieren und Sendungen verfolgen — ohne das UPS-Portal nutzen zu müssen.
Was kann der UPS Connector?
| Funktion | Beschreibung |
|---|---|
| :material-label-outline: Einzellabels | Versandlabel für einzelne Sendungen erstellen |
| :material-label-multiple-outline: Bulk-Labels | Mehrere Sendungen nacheinander in einem Durchlauf verarbeiten |
| :material-undo: Retourenlabels | Rücksende-Etiketten für Ihre Kunden erstellen (UPS Return Service) |
| :material-close-circle-outline: Stornierung | Erstellte Sendungen bei UPS stornieren (Void Shipment) |
| :material-refresh: Label Recovery | Bereits erstellte Labels erneut abrufen |
| :material-package-variant: Multi-Parcel | Sendungen mit mehreren Packstücken (individuelle Tracking-Nummern) |
| :material-earth: International | Internationale Sendungen mit Zolldokumenten (Commercial Invoice) |
| :material-image: Flexible Formate | Labels in GIF, PNG, ZPL, EPL oder SPL |
| :material-shield-check: Zusatzleistungen | Samstagszustellung, Unterschrift, Wertversicherung u. v. m. |
Schnellstart in 5 Schritten
Schritt 1: UPS Developer-Zugangsdaten bereithalten
Sie benötigen folgende Daten:
- Client ID — aus dem UPS Developer Portal
- Client Secret — aus dem UPS Developer Portal
- Account Number — Ihre 6-stellige UPS Shipper Number
Wo bekomme ich Zugangsdaten?
Registrieren Sie sich im UPS Developer Portal unter developer.ups.com. Dort erstellen Sie eine App und erhalten Client ID und Client Secret. Ihre Account Number (Shipper Number) finden Sie auf Ihren UPS-Rechnungen oder im UPS-Geschäftskundenportal.
Schritt 2: Setup öffnen und konfigurieren
- Öffnen Sie in Business Central die Suche (++alt+q++) und geben Sie UPS Shipment Setup ein
- Tragen Sie Client ID, Client Secret und Account Number ein
- Hinterlegen Sie Ihre Absenderadresse
- Wählen Sie Ihren Standard-Service (z. B. UPS Standard)
→ Detaillierte Anleitung: Ersteinrichtung
Schritt 3: Verbindung testen
Klicken Sie auf Test Connection. Bei Erfolg wird ein OAuth Access Token angefordert und die Verbindung bestätigt.
Schritt 4: Erstes Label erstellen
- Öffnen Sie die Versandlabels-Liste im merchantCENTRAL Dashboard
- Klicken Sie auf Label erstellen
- Wählen Sie UPS als Versanddienstleister
- Füllen Sie die Empfängerdaten aus und klicken Sie auf Erstellen
→ Detaillierte Anleitung: Labels erstellen
Schritt 5: Label drucken
Das erstellte Label wird als GIF, PNG oder ZPL in Business Central gespeichert und kann sofort gedruckt werden.
Unterstützte UPS-Services
| Code | Service | Einsatzgebiet |
|---|---|---|
| 11 | UPS Standard | Europa (2–5 Werktage) |
| 07 | UPS Express | Weltweit (nächster Werktag) |
| 65 | UPS Express Saver | Europa (nächster Werktag, günstiger) |
| 54 | UPS Express Plus | Weltweit (frühestmögliche Zustellung) |
| 08 | UPS Expedited | Weltweit (2–5 Werktage) |
| 70 | UPS Access Point Economy | Zustellung an UPS Access Point |
| 96 | UPS Worldwide Express Freight | Frachtsendungen weltweit |
→ Detaillierte Beschreibung: UPS-Services
Technische Details
| Eigenschaft | Wert |
|---|---|
| API | UPS Shipping REST API (JSON) |
| API-Version | v2409 |
| Authentifizierung | OAuth 2.0 Client Credentials |
| Token-Gültigkeit | ~4 Stunden (mit automatischem Refresh) |
| Produktiv-URL | https://onlinetools.ups.com |
| Sandbox-URL | https://wwwcie.ups.com |
| Labelformate | GIF, PNG, ZPL, EPL, SPL |
| Labelgrößen | 4×6 Zoll, 4×8 Zoll |
| Gewichtseinheit | Kilogramm (KGS) |
| Maßeinheit | Zentimeter (CM) |
| Max. Gewicht | 70 kg pro Packstück |
Weitere Themen
- Ersteinrichtung — Schritt-für-Schritt-Anleitung für die Erstkonfiguration
- Labels erstellen — Einzel- und Bulk-Labels erstellen, stornieren, wiederherstellen
- Retourenlabels — Rücksende-Etiketten über UPS Return Service generieren
- UPS-Services — Alle verfügbaren UPS-Services im Detail
- Zusatzleistungen (VAS) — Samstagszustellung, Unterschrift, Versicherung u. v. m.
- Internationale Sendungen — Zolldokumente, Commercial Invoice, EORI
- Einrichtung (Referenz) — Feldreferenz der Setup-Seite
- Pakete — Multi-Parcel-Verwaltung
- Fehlerbehebung — Häufige Probleme und Lösungen