Inhaltsverzeichnis

Shipcloud-Schnittstelle (Optional)

AKQUINET 365 Shipping - Shipcloud ist eine optionale Erweiterung, die AKQUINET 365 Shipping mit der Shipcloud-Plattform verbindet. Diese Schnittstelle ermöglicht die automatische Erstellung von Versandetiketten und die Verwaltung von Zustellern über die Shipcloud-API.

Wichtig

Diese Schnittstelle ist optional und nur erforderlich, wenn Sie Shipcloud als Ihre Versandplattform nutzen.

Wichtig

Diese Schnittstelle übermittelt aktuell keine zollrelevanten Informationen.

Überblick

Die Shipcloud-Schnittstelle bietet folgende Funktionen:

  • Automatischer Zusteller-Import: Laden Sie verfügbare Zusteller und deren Transportarten direkt aus Shipcloud
  • Versandetikett-Erstellung: Automatische Generierung von Versandetiketten über die Shipcloud-API
  • Sendungsverwaltung: Erstellen und verfolgen Sie Sendungen in Shipcloud
  • Sichere API-Integration: Geschützte Speicherung des API-Schlüssels

Shipcloud-Setup-Group.png

Voraussetzungen

Bevor Sie die Shipcloud-Schnittstelle nutzen können, benötigen Sie:

Technische Anforderungen

  • AKQUINET 365 Shipping installiert und konfiguriert
  • Shipcloud-Konto mit gültigem, kostenpflichtigem Abonnement
  • API-Schlüssel von Shipcloud (erhalten Sie in Ihrem Shipcloud-Konto unter Einstellungen)

Einrichtung

Wie erhalte ich den API-Schlüssel?

  1. Melden Sie sich bei Ihrem Shipcloud-Konto an (https://shipcloud.io)
  2. Navigieren Sie zu Einstellungen > API
  3. Kopieren Sie Ihren API-Schlüssel

Schritt 1: Shipcloud-Integration aktivieren

  1. Öffnen Sie die Versandauftrag Einrichtung über die Suchfunktion
  2. Scrollen Sie zum Register Shipcloud (wird nur angezeigt, wenn die Shipcloud-Erweiterung installiert ist)
  3. Aktivieren Sie das Feld Shipcloud aktiviert

Schritt 2: API-Verbindung konfigurieren

Konfigurieren Sie die Verbindung zur Shipcloud-API:

Feld Beschreibung
Shipcloud aktiviert Aktivieren Sie diese Option, um die Shipcloud-Integration zu nutzen. Wenn deaktiviert, steht Shipcloud nicht als Versandschnittstellenart zur Verfügung.
Shipcloud API Url Die URL des Shipcloud-API-Endpunkts. Standardwert: https://api.shipcloud.io/v1/ (sollte normalerweise nicht geändert werden). Wichtig: Muss mit https:// beginnen.
API-Schlüssel Geben Sie Ihren Shipcloud-API-Schlüssel ein. Der Schlüssel wird sicher und verschlüsselt gespeichert und als ***** angezeigt. Wichtig: Beim Ändern wird eine Bestätigung angefordert, da der vorhandene Schlüssel überschrieben wird.
Shipcloud Zeitlimit Maximale Wartezeit für API-Aufrufe. Empfehlung: 30 Sekunden für stabile Verbindungen, 60 Sekunden bei langsameren Internetverbindungen.
Wichtig

Der API-Schlüssel wird verschlüsselt im isolierten Speicher von Business Central gespeichert und ist nicht als Klartext sichtbar.

Tipp

Erneuern Sie Ihren API-Schlüssel regelmäßig (z.B. jährlich) aus Sicherheitsgründen

Zusteller-Import von Shipcloud

Ein Hauptvorteil der Shipcloud-Schnittstelle ist der automatische Import von Zustellern.

Import durchführen

  1. Stellen Sie sicher, dass die Shipcloud-Integration aktiviert und konfiguriert ist (siehe Einrichtung)
  2. Öffnen Sie die Versandauftrag Einrichtung
  3. Klicken Sie auf Zusteller importieren (oder öffnen Sie die Zustellerliste und verwenden Sie die entsprechende Aktion)
  4. Wählen Sie Shipcloud als Importquelle
  5. Das System:
    • Ruft alle verfügbaren Zusteller von Shipcloud ab
    • Erstellt oder aktualisiert Zusteller-Datensätze in Business Central
    • Importiert alle Transportarten für jeden Zusteller
    • Ordnet Shipcloud-Service-Codes den BC-Zustellertransportarten zu

Shipcloud-Carrier-Import.png

Was wird importiert?

Der Import erstellt/aktualisiert folgende Daten:

Zusteller:

  • Zustellercode
  • Zustellername
  • Shipcloud-spezifische Einstellungen

Transportarten:

  • Transportartencode
  • Beschreibung
  • Zusteller Service Code: Der Shipcloud-interne Service-Code (z.B. "standard", "express")

Import wiederholen

Sie können den Import jederzeit wiederholen, um:

  • Neue Zusteller hinzuzufügen, die in Shipcloud verfügbar sind
  • Änderungen an Transportarten zu aktualisieren
  • Fehlende Service-Codes zu ergänzen
Wichtig

Bestehende Zusteller werden aktualisiert, nicht überschrieben. Ihre manuellen Anpassungen (z.B. Standardpackmittel) bleiben erhalten.

Shipcloud-Ressourcen