Sendcloud

Sendcloud verbindet den Shop mit Sendcloud, überträgt Bestellungen an die Versandplattform und stellt den Sendcloud-Labeldruck in Bestellungen sowie in Versandprozessen bereit.

Voraussetzungen und Verbindung

Die Seite ist nur nutzbar, wenn die Sendcloud-App aktiv ist und das Backend-Recht für Sendcloud-Versand vorhanden ist. Beim Öffnen legt das Backend fehlende Sendcloud-Konfigurationswerte automatisch an.

• Bei Sendcloud anmelden: Öffnet die Registrierung bei Sendcloud, wenn noch kein Sendcloud-Konto vorhanden ist.
• Mit Sendcloud verbinden: Startet den Verbindungsprozess für ein vorhandenes Sendcloud-Konto. Nach der Freigabe werden Public Key, Secret Key und Integrations-ID über den Sendcloud-Webhook in den Shop übernommen.
• Erfolgsmeldung: Nach dem Speichern oder einer erfolgreichen Rückkehr aus dem Verbindungsprozess zeigt die Seite eine Setup-Bestätigung an.

Datenfilter, Tabellen und Optionen

Sendcloud ist eine Einstellungsseite und keine Übersichtsseite. Das Backend rendert keine Datentabelle, keine Suchmaske, keine Filterleiste und keine Optionsspalte für Zeilenaktionen.

• Keine Filter: Es gibt keine aktiven Filter, keine Reset-Funktion und keine Anwenden-Schaltfläche.
• Keine Tabelle: Spalten, Sortierung, Spaltenauswahl und Tabellenaktionen sind auf dieser Seite nicht vorhanden.
• Aktionen auf der Seite: Nutzbar sind die Anmeldung, die Verbindung mit Sendcloud und das Speichern des Einstellungsformulars.

Einstellungsformular

Das Formular speichert Werte im Konfigurationsbereich sendcloud. Nicht gesetzte Checkboxen werden beim Speichern ausdrücklich auf 0 gesetzt; eine leere Statusauswahl wird als leere Auswahl gespeichert.

• aktiv (Bestellungen übertragen): Aktiviert die automatische Übergabe von Bestellungen an Sendcloud. Ist die Option deaktiviert, beendet die Backendlogik die Übergabe sofort.
• aktiv_status (bei folgendem Status): Mehrfachauswahl von Bestellstatusstufen. Ohne Auswahl wird eine Bestellung beim Erstellen und bei jedem Statuswechsel an Sendcloud übertragen oder aktualisiert. Mit Auswahl erfolgt die Übergabe nur, wenn die Bestellung einen der gewählten Status erreicht.
• aktiv_status_after (ändere Bestellung dann auf den Status): Optionaler Folgestatus. Nach erfolgreicher Übergabe an Sendcloud setzt das Backend die Bestellung auf diesen Status, wenn ein Wert hinterlegt ist.
• client_id (Public Key): Zugriffsschlüssel aus der Sendcloud-Integration. Der Wert wird normalerweise automatisch über den Verbindungsprozess gesetzt.
• client_secret (Secret Key): Geheimer Zugriffsschlüssel aus der Sendcloud-Integration. Der Wert wird normalerweise automatisch übernommen und sollte nur gezielt geändert werden.
• integration_id (Integrations Id): Kennung der verbundenen Sendcloud-Integration. Diese Kennung wird für die Übergabe von Bestellungen an die passende Sendcloud-Integration verwendet.
• standard_versandmethode (Standard Versandmethode): Standardwert für die Sendcloud-Versandmethode. Die Auswahl wird aus den von Sendcloud gelieferten Versandmethoden aufgebaut.
• labeldruck (Bei Transportdienst Sendcloud - Labeldruck): Aktiviert die Labelerzeugung, wenn in der Bestellung oder Versandliste der Transportdienst Sendcloud verwendet wird. Ist die Option aus, zeigt die Labelmaske einen Deaktivierungshinweis statt der Sendcloud-Versandoptionen.
• status_zugestellt (Bestellstatus bei Zustellung): Bestellstatus, der bei einem Sendcloud-Paketstatus Delivered gesetzt wird, sofern ein Wert hinterlegt ist.
• status_sonstiges (Bestellstatus bei Sonstiger Änderung): Bestellstatus für sonstige relevante Paketstatusmeldungen, sofern ein Wert hinterlegt ist.

Automatische Bestellübergabe

Bei Bestellerstellung und bei Statusänderungen ruft das Backend die Sendcloud-Übergabe auf. Die Option aktiv und die Statusauswahl entscheiden, ob wirklich Daten übertragen werden.

• Übertragene Bestelldaten: Adresse, Land, Bestellnummer, Zahlungsstatus, Währung, Bestellwert, Gesamtgewicht und Positionsdaten werden aus der Bestellung aufgebaut.
• Positionsdaten: Artikelname, Artikel-ID, Artikelnummer, Menge, Wert, Gewicht sowie vorhandene Größen- und Farbangaben werden als Sendcloud-Positionsdaten übergeben.
• Zahlungsstatus: Bezahlte Bestellungen erhalten einen bezahlten Status mit Zahlungsdatum; offene Bestellungen werden als offen markiert, bei Nachnahme mit entsprechendem Zusatz.
• Rückmeldung: Bei erfolgreicher Übergabe schreibt das Backend einen Eintrag in die Bestellhistorie und setzt bei Bedarf den konfigurierten Folgestatus.
• Fehlerfall: Meldet Sendcloud einen Fehler, wird ein Fehlereintrag in der Bestellhistorie ergänzt und kein Folgestatus gesetzt.

Manueller Labeldruck in Bestellungen

In der Bestellung kann ein Sendcloud-Ticket manuell erzeugt werden, wenn die Sendcloud-App aktiv ist. Die Maske übernimmt Empfängerdaten aus der Bestellung und erlaubt Korrekturen vor der Labelerstellung.

• Lieferantenadresse wählen: Optionaler Wechsel auf eine Lieferantenadresse. Das Backend ersetzt dann Empfängerfirma, Name, Straße, Land, Telefon und E-Mail durch die Lieferantendaten.
• Empfängerfelder: Firma, Vorname, Nachname, Straße, Hausnummer, Zusatz, PLZ, Ort, Land, Telefon und E-Mail werden im Formular angezeigt und an Sendcloud übergeben.
• order_number: Die Bestellnummer wird als versteckter Formularwert für die Sendcloud-Sendung mitgegeben.
• weight: Paketgewicht. Das Feld ist für die manuelle Ticket-Erstellung erforderlich.
• shipping_method: Sendcloud-Versandmethode. Die Liste wird nach dem Empfängerland gefiltert; ohne vorhandenen Wert wird die konfigurierte Standard-Versandmethode vorbelegt.
• apply_shipping_rules: Radiowahl, ob Sendcloud-Versandregeln angewendet werden sollen. Standardmäßig wird die Anwendung der Versandregeln vorbelegt.
• Ticket erstellen: Sendet die Daten an Sendcloud. Bei erfolgreichem Status wird das Label als PDF gespeichert, die Trackingnummer in die Bestellhistorie geschrieben und das Fenster anschließend aktualisiert.

Exportdokumente und Auslandssendungen

Wenn für das Empfängerland Exportdokumente erforderlich sind, ergänzt die Sendcloud-Maske zusätzliche Zollangaben.

• customs_shipment_type: Sendungsart für das Exportdokument, zum Beispiel Geschenk, Dokumente, Handelsmuster, kommerzielle Güter oder Rücksendung.
• customs_invoice_nr: Auswahl einer zur Bestellung vorhandenen Rechnung, die für die Zollunterlagen verwendet wird.
• exportpos_sc: Positionsdaten für das Exportdokument mit Beschreibung, Ursprungsland, Zolltarifnummer, Menge, Nettogewicht und Zollwert.
• CN23-Dokument: Bei exportpflichtigen Sendungen ruft das Backend zusätzlich zum Label ein passendes Exportdokument bei Sendcloud ab und speichert es beim Ticket.

Versandliste und Statusupdates

Auch die Versandliste kann Sendcloud-Labels erzeugen. Voraussetzung ist, dass die Sendcloud-App aktiv ist, labeldruck eingeschaltet ist und der Transportdienst der Sendung Sendcloud lautet.

• Versandliste: Die Labelerzeugung läuft über den allgemeinen Shipping-Service. Trackingnummern, Fehlermeldungen und Ticket-IDs werden an den Versandprozess zurückgegeben.
• Sendcloud-Status: Paketstatusmeldungen werden per Webhook verarbeitet. Die Bestellhistorie erhält den Sendcloud-Status; bei Zustellung oder sonstigen relevanten Änderungen kann zusätzlich ein konfigurierter Bestellstatus gesetzt werden.
• Tracking: Bei versandbereiten Paketen wird eine Trackinginformation in der Bestellhistorie ergänzt.
• Belegstapel: Sendcloud-Tickets und Sendcloud-Exportdokumente stehen als eigene Stapeltypen zur Verfügung, wenn die Sendcloud-App aktiv ist.