Zum Inhalt

Ersteinrichtung UPS

Diese Anleitung führt Sie Schritt für Schritt durch die Ersteinrichtung des UPS Versand-Connectors in Business Central. Nach Abschluss können Sie direkt UPS-Versandlabels erstellen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgende Dinge haben:

  • [x] UPS-Geschäftskundenkonto — Ein aktives Konto bei UPS
  • [x] UPS Developer Portal Account — Zugang unter developer.ups.com
  • [x] Client ID & Client Secret — Erstellt im UPS Developer Portal (OAuth 2.0 App)
  • [x] Account Number — Ihre 6-stellige UPS Shipper Number
  • [x] merchantCENTRAL Hub — Die merchantCENTRAL Hub-App muss installiert sein
  • [x] UPS Connector — Die App „AD merchantCENTRAL Shipment UPS" muss installiert sein

Sandbox vs. Produktivzugang

UPS bietet eine Sandbox-Umgebung zum Testen. Aktivieren Sie diese unbedingt zuerst, bevor Sie mit echten Sendungen arbeiten! Die Sandbox-Zugangsdaten werden separat im UPS Developer Portal erstellt.

Schritt 1: UPS Developer Portal einrichten

Falls Sie noch keinen Zugang haben:

  1. Gehen Sie zu developer.ups.com
  2. Registrieren Sie sich mit Ihrem UPS-Geschäftskonto
  3. Erstellen Sie eine neue App:
    • App Name: z. B. merchantCENTRAL BC
    • Callback URL: kann leer bleiben (Client Credentials Flow)
    • Products: Shipping aktivieren
  4. Nach der Erstellung erhalten Sie:
    • Client ID — z. B. A1B2C3D4E5F6G7H8I9J0
    • Client Secret — z. B. K1L2M3N4O5P6... (nur einmal sichtbar!)

Client Secret sichern

Das Client Secret wird im UPS Developer Portal nur einmal angezeigt. Kopieren Sie es sofort und speichern Sie es sicher. Wenn Sie es verlieren, müssen Sie eine neue App erstellen.

Schritt 2: Setup-Seite öffnen

Es gibt drei Wege, die UPS-Einrichtungsseite zu öffnen:

Weg 1 — Über die Suche:

  1. Drücken Sie ++alt+q++ (oder das Suchfeld oben rechts)
  2. Geben Sie UPS Shipment Setup ein
  3. Klicken Sie auf das Suchergebnis

Weg 2 — Über das merchantCENTRAL Dashboard:

  1. Öffnen Sie das merchantCENTRAL Dashboard
  2. Navigieren Sie zu Versanddienstleister
  3. Klicken Sie auf UPS

Weg 3 — Über die Versanddienstleister-Liste:

  1. Öffnen Sie die Versanddienstleister-Liste
  2. Suchen Sie den Eintrag UPS
  3. Klicken Sie auf Setup öffnen in der Aktionsleiste

Automatische Erstanlage

Beim ersten Öffnen der Setup-Seite wird automatisch ein leerer Datensatz angelegt. Sie müssen nichts manuell erstellen.

Schritt 3: API-Zugangsdaten eintragen

Im Bereich API Credentials tragen Sie Ihre OAuth 2.0-Zugangsdaten ein:

3.1 API Base URL

Umgebung URL
Produktiv https://onlinetools.ups.com
Sandbox https://wwwcie.ups.com

Empfehlung: Mit Sandbox starten

Aktivieren Sie das Feld Sandbox Mode — die URL wird automatisch auf die Sandbox-Adresse umgestellt.

3.2 OAuth 2.0 Zugangsdaten

Feld Was eintragen? Beispiel
Client ID OAuth 2.0 Client ID aus dem Developer Portal A1B2C3D4E5F6G7H8I9J0
Client Secret OAuth 2.0 Client Secret (wird maskiert) ***

Credential-Sicherheit

Client ID und Client Secret werden verschlüsselt im Business Central IsolatedStorage gespeichert — nicht als Klartext in der Datenbank. Nach der Eingabe werden sie nur noch als *** angezeigt.

3.3 Account Number

Feld Was eintragen? Beispiel
Account Number 6-stellige UPS Shipper Number A12B34

Wo finde ich die Account Number?

Die UPS Account Number (Shipper Number) finden Sie:

  • Auf Ihren UPS-Rechnungen
  • Im UPS Geschäftskundenportal unter Profil → Kontoinformationen
  • In Ihrem UPS-Vertragsschreiben

Schritt 4: Verbindung testen

Testen Sie die Verbindung, bevor Sie fortfahren:

  1. Klicken Sie auf Test Connection in der Aktionsleiste
  2. Business Central fordert ein OAuth Access Token bei UPS an

  3. Bei Erfolg erscheint eine Bestätigungsmeldung:

    ✅ Verbindung erfolgreich. OAuth Token erhalten.

  4. Das Token wird im Hintergrund gespeichert (Gültigkeit: ~4 Stunden)

Verbindung fehlgeschlagen?

Mögliche Ursachen:

  • Falsche Client ID oder Client Secret — Prüfen Sie Ihre Zugangsdaten im UPS Developer Portal
  • Falsche URL — Sandbox-Zugangsdaten funktionieren nur mit der Sandbox-URL
  • App nicht aktiviert — Stellen Sie sicher, dass Ihre App im Developer Portal den Status Active hat
  • Firewall — Der BC-Server muss onlinetools.ups.com (Port 443) erreichen können

→ Weitere Hilfe: Fehlerbehebung

Schritt 5: Absenderadresse eintragen

Im Bereich Shipper Address hinterlegen Sie Ihre Absenderadresse:

Feld Beschreibung Beispiel
Shipper Name Firmenname ALTENBRAND Datentechnik GmbH
Shipper Attention Name Ansprechpartner (z.Hd.) Max Mustermann
Shipper Street Straße (Zeile 1) Am Brunnenfeld 1
Shipper Street 2 Adresszusatz (Zeile 2, optional) Gebäude B
Shipper Post Code Postleitzahl 86511
Shipper City Stadt Schmiechen
Shipper Country Code Ländercode (ISO-2) DE
Shipper State/Province Bundesland (für USA/CA Pflicht) BY
Shipper Phone Telefonnummer +49 8206 96200
Shipper Email E-Mail-Adresse versand@altenbrand.de

Pflichtfelder

Shipper Name, Shipper Street, Shipper Post Code, Shipper City und Shipper Country Code sind zwingend erforderlich.

State/Province

Für Sendungen innerhalb Deutschlands ist das Feld State/Province optional. Für Sendungen in die USA oder nach Kanada ist es Pflicht (z. B. CA für Kalifornien, ON für Ontario).

Schritt 6: Standardeinstellungen festlegen

6.1 Standard-Service

Service Code Laufzeit Einsatzgebiet
UPS Standard 11 2–5 Werktage Europa
UPS Express 07 Nächster Werktag Weltweit
UPS Express Saver 65 Nächster Werktag (günstiger) Europa
UPS Express Plus 54 Frühestmöglich Weltweit
UPS Expedited 08 2–5 Werktage Weltweit
UPS Access Point Economy 70 2–5 Werktage Access Points
UPS Worldwide Express Freight 96 Nächster Werktag Fracht, weltweit

Empfehlung

Für europäischen B2B-Versand ist UPS Standard (11) die gängigste Wahl. Für zeitkritische Sendungen wählen Sie UPS Express (07).

6.2 Pakettypen

Typ Code Beschreibung
Customer Supplied 02 Eigene Verpackung (Standard)
UPS Letter 01 UPS-Briefumschlag
Tube 03 Versandrolle
PAK 04 UPS PAK (Kunststoffumschlag)
Express Box 21 UPS Express Box
25KG Box 24 UPS 25-kg-Karton
10KG Box 25 UPS 10-kg-Karton

6.3 Labelformat

Format Beschreibung Verwendung
GIF Standard-Bildformat Bürodrucker, Webansicht
PNG Hochauflösendes Bildformat Bürodrucker
ZPL Zebra Programming Language Zebra-Thermodrucker
EPL Eltron Programming Language Eltron-Thermodrucker
SPL Star Programming Language Star-Thermodrucker

6.4 Labelgröße

Größe Beschreibung
4x6 4 × 6 Zoll — Standard-Thermodrucker-Format
4x8 4 × 8 Zoll — größeres Format mit mehr Platz

6.5 Standardgewicht

Geben Sie ein Standardgewicht in Kilogramm ein (z. B. 1 für 1 kg, max. 70 kg). Dieses wird verwendet, wenn kein Gewicht am Packstück hinterlegt ist.

Schritt 7: Internationale Einstellungen (optional)

Im Bereich International / Customs können Sie Standardwerte für den internationalen Versand hinterlegen:

Feld Beschreibung Beispiel
Shipper Tax ID EORI-Nummer oder USt-ID für Zolldokumente DE123456789
Default Reason for Export Standardmäßiger Exportgrund SALE

→ Details: Internationale Sendungen

Nur für internationalen Versand

Wenn Sie ausschließlich innerhalb der EU versenden, können Sie diesen Schritt überspringen.

Einrichtung abgeschlossen ✓

Nach diesen Schritten ist Ihr UPS Connector einsatzbereit. Sie können jetzt:

Checkliste

  • [ ] Client ID und Client Secret eingetragen
  • [ ] Account Number eingetragen
  • [ ] Test Connection erfolgreich
  • [ ] Absenderadresse vollständig (Name, Straße, PLZ, Stadt, Land)
  • [ ] Standard-Service gewählt (z. B. 11 für UPS Standard)
  • [ ] Pakettyp gewählt (z. B. 02 für Customer Supplied)
  • [ ] Labelformat gewählt (GIF, PNG, ZPL, EPL oder SPL)
  • [ ] Labelgröße gewählt (4x6 oder 4x8)
  • [ ] Standardgewicht eingetragen
  • [ ] Optional: Shipper Tax ID für internationalen Versand