Versand
Überblick
Das Versandzentrum ist die Arbeitsfläche des physischen Versands. Es zeigt Arbeitsvorräte statt Listen: versandfertig, kommissionieren, unterwegs, Retouren — also das, was jetzt zu tun ist.
Darunter liegen vier Gegenstände, die man auseinanderhalten sollte:
| Gegenstand | Was er ist |
|---|---|
| Lieferschein | Kommissionierung, Versand und Zustellung je Auftrag |
| Sendung | die physische Sendung mit Carrier, Tracking und Packstücken — nur lesend |
| Retoure (RMA) | Anfrage, Genehmigung, Wareneingang und Erstattung |
| Versandkosten | regelbasiert je Zone, Carrier und Marke |
Dass Sendungen nur lesend sind, ist kein Mangel: Sie spiegeln, was beim Carrier passiert. Wer dort etwas ändern will, ändert es beim Carrier, nicht in der Anzeige.
Kernaufgaben
Kommissionieren und versenden. Über den Lieferschein zum Auftrag — von versandfertig bis unterwegs.
Sendungen verfolgen. Carrier, Tracking-Nummer und Packstücke stehen an der Sendung.
Retouren abwickeln. Der RMA-Weg ist vierstufig: Anfrage → Genehmigung → Wareneingang → Erstattung. Jede Stufe ist eine Entscheidung; eine Retoure, die ohne Genehmigung im Lager auftaucht, ist genau das Problem, das dieser Weg verhindert. Retourenschein (PDF) am Retouren-Detail erzeugt den Rücksendeschein über die Belegvorlage Retoure. Bei automatischer Erstattung entsteht die Gutschrift nur, wenn alle Positionen im Zustand neu zurückkommen — gebrauchte oder beschädigte Ware geht zur Freigabe.
Beleg-Beilagen packen. Wird ein Beleg (Angebot, Auftrag, Rechnung) mit der Ware ausgegeben, merkt ihn das System als Beilage für die nächste Sendung des Auftrags vor. Versandzentrum → Sendungen → Beilagen zeigt, was in den Karton gehört — vorgefiltert auf Wartet auf Sendung, mit Link zum Beleg, Zahl der Exemplare und dem eingefrorenen PDF zum Ausdrucken. Beigelegt wird beim Versand; die Liste ist nur lesend und zeigt danach Beigelegt mit Zeitpunkt.
Streckengeschäft sehen. Meldet der Lieferant eine Strecken-Lieferung als versandt, entsteht dazu ein Lieferschein und eine Sendung mit dessen Tracking-Nummer (Erfüllungsart Strecke). Der Lieferfortschritt des Auftrags folgt, ohne dass Ware durch Ihr Lager geht.
Fulfiller-Versand sehen. Meldet ein Logistikdienstleister (Dienstleister-Lager, z. B. im JTL-Fulfillment-Netzwerk) den Versand eines Auslagerungsauftrags, der zu einem Auftrag gehört, entsteht ein Lieferschein am Dienstleister-Lager (versendet) und eine Sendung mit Versanddienstleister und Sendungsnummer (Erfüllungsart Fulfiller). Der Auftrag schreitet fort — Sets über ihre Komponenten, Teil-Lieferungen inklusive. Den Bestand bucht allein die Versandmeldung des Lagers, der Versand bucht nicht noch einmal. Die Sendungsnummer geht wie bei eigener Ware an Marktplatz und Abläufe (Sendungsnummer vergeben), die Unterwegs- und Zugestellt-Nachricht an den Kunden kommt aus der gewöhnlichen Sendungsverfolgung. Ist das Versand-Modul aus, entsteht nichts davon.
Kunden informieren. Im Kundenportal sieht der Kunde am Auftrag seine Sendungen mit Status und Tracking-Link (Portal-Recht Aufträge und Sendungen ansehen).
Versandkosten regeln. Kosten nach Gewicht, Wert oder fix je Zone und Carrier, einschließlich einer Schwelle für kostenfreien Versand. Die Versandzeile am Auftrag rechnet sich nach jeder Änderung der Positionen von selbst neu; wer das nur auf Knopfdruck will, schaltet die Einstellung shipping.charge.auto_apply aus.
Nachnahme und Versicherung buchen. Im Dialog Versenden erscheinen nur die Zusatzleistungen, die der gewählte Dienstleister über seine Anbindung wirklich bucht; mit Nachnahme oder Zusatzversicherung kommen die Felder Nachnahmebetrag bzw. Zu versichernder Warenwert dazu. Was der Dienstleister so nicht annimmt, wird vor der Buchung abgelehnt — mit dem Grund, statt dass die Ware ohne Nachnahme das Haus verlässt.
| Dienstleister | Nachnahme | Zusatzversicherung | Grenzen |
|---|---|---|---|
| DHL | ja | ja | Nachnahme nur Paket national (Warenpost wird zu Paket), nur EUR |
| GLS | ja | ja | nur EUR |
| UPS | ja | ja | Betrag auch in CHF, CZK, DKK, GBP, HUF, NOK, PLN, RON, SEK |
| shipcloud | ja | ja | je Produkt: Nachnahme über DHL, GLS, Hermes, UPS; Versicherung über DHL, UPS |
| Hermes | ja | nein | nur innerhalb Deutschlands |
| Sendcloud | nein | ja | Versicherung 2 bis 5.000 EUR je Sendung |
| DPD | nein | ja | DPD hat die Nachnahme in seiner Versandschnittstelle abgeschafft |
| Deutsche Post | nein | nein | Briefmarke ohne Geldeinzug |
Das Konto, auf das der Zusteller das kassierte Geld überweist, ist die Bankverbindung der Marke (dieselbe wie auf der Rechnung, Einstellungen → Marken); als Verwendungszweck geht die Auftragsnummer mit. Bei DHL kann stattdessen eine im Geschäftskundenportal hinterlegte Nachnahme-Kontoreferenz genutzt werden — Feld cod_account_reference der DHL-Integration.
Beträge in Fremdwährung. Beide Beträge stehen in der Währung des Auftrags. Nimmt der Dienstleister sie so an (UPS), gehen sie unverändert hinaus. Sonst rechnet der Versand zum am Auftrag eingefrorenen Kurs in Euro um, der Dialog sagt das vorher, und die Sendung zeigt in der Zeile Umgerechnet Ursprungsbetrag und Kurs. Ohne Beleg (belegfreies Etikett) gibt es keinen Kurs — dann wird eine fremde Währung abgelehnt statt still als Euro gelesen.
Zollpapiere bei Ausfuhr. Geht eine Lieferung aus dem Zollgebiet der EU hinaus, zeigt das Lieferschein-Detail zwei zusätzliche Knöpfe: Zollerklärung (CN22/CN23) und Handelsrechnung, beide als PDF. Ob das so ist, entscheidet allein die Lieferanschrift: Länder außerhalb der 27 Mitgliedstaaten (Monaco zählt wie Frankreich dazu) brauchen Papiere, ebenso Helgoland (PLZ 27498) und Büsingen am Hochrhein (PLZ 78266); die Sondergebiete anderer Länder erkennt das System nicht. Innerhalb der EU erscheinen die Knöpfe nicht. Welches Formular gilt, rechnet das System aus der Sendung: CN22 bis 2 kg Nettogewicht und 425 € Warenwert, darüber CN23. Je Position stehen darauf Zolltarifnummer und Ursprungsland aus dem Artikel, das Gewicht aus dem Nettogewicht des Artikels und der Stückwert aus der Auftragsposition. Die Werte stehen immer in Euro — bei einem Auftrag in Fremdwährung umgerechnet zum am Auftrag eingefrorenen Kurs, nicht zum Tageskurs. Fehlt ein Gewicht, steht die Position mit 0 g da, statt geschätzt zu werden; fehlt der Auftragsbezug, steht der Wert auf 0 — beides fällt auf dem Papier auf und gehört am Artikel bzw. Auftrag nachgetragen.
Felder im Detail
Lager des Warenausgangs (warehouseId, mit Mehrlager): Vorgabe aus dem Auftrag, bis zum Versand überstimmbar; leer = Regel (Default-Lager, dann Priorität).
Lieferschein
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Auftrag orderUlid | ja | bestehender Auftrag | Wozu geliefert wird. Von dort kommen Positionen und Anschrift. |
Sammellieferschein orderUlids | nein | mehrere Aufträge | Mehrere Aufträge desselben Kunden und derselben Marke auf einen Lieferschein. Der erste Auftrag führt (Marke, Nummernkreis, Anschrift); jeder genannte Auftrag muss dafür freigegeben sein. Ohne Angabe bleibt es beim einzelnen Auftrag. |
Positionen items | ja | Artikel mit Menge | Was tatsächlich hinausgeht. Weniger als bestellt ist eine Teillieferung — der Auftrag bleibt offen, bis nichts mehr fehlt. Braucht eine Position ohne gescannte Charge Ware aus mehreren Chargen, teilt der Versand sie: je Charge eine Zeile mit ihrer Menge, zuerst die früher ablaufende. Bei differenzbesteuerter Ware führt die Rechnung aus dem Auftrag dann je Charge eine Zeile mit eigenem Einstand. |
Lieferanschrift shippingAddress | nein | Anschrift | Wohin. Vorbelegt vom Auftrag; eine abweichende Anschrift bleibt am Lieferschein. |
Lieferung oder Leistung supplyDateMode | nein | ohne, Liefertag, Leistungstag, Lieferzeitraum, Leistungszeitraum | Der eine Schalter für die Angabe nach § 14 UStG. Tages-Modi füllen den Liefertag, Zeitraum-Modi den Zeitraum; die jeweils anderen Felder werden beim Speichern geleert. Nicht dasselbe wie der Zustellvermerk — der hält fest, wann tatsächlich zugestellt wurde. |
Liefer-/Leistungstag deliveryDate | bei Tages-Modus | Datum | Der Tag, der als Liefer- oder Leistungszeitpunkt auf dem Beleg steht. Ein leerer Wert löscht ihn. |
Zeitraum von servicePeriodFrom | bei Zeitraum-Modus | Datum | Beginn des Liefer- oder Leistungszeitraums. |
Zeitraum bis servicePeriodTo | nein | Datum, nicht vor dem Beginn | Ende des Zeitraums; leer = auf dem Beleg steht nur der Beginn. |
Belegvorlage documentTemplateId | nein | eingerichtete Belegvorlage | Layout des Lieferscheins. |
MRN (Ausfuhr) exportMrn | nein | 18 Zeichen: 2 Ziffern Jahr, 2 Buchstaben Land, 13 Buchstaben oder Ziffern, 1 Prüfziffer | Die Ausfuhr-Referenznummer dieses Lieferscheins. Werden Teillieferungen ins Drittland einzeln angemeldet, trägt jeder Lieferschein seine eigene Nummer; leer gilt die MRN des Auftrags. Geprüft und bereinigt wie am Auftrag. Die Rechnung aus dem Auftrag übernimmt die Nummern aller zugehörigen Lieferscheine. |
Kopftext headerText | nein | formatierter Text | Steht auf dem Lieferschein über den Positionen. Neue Lieferscheine bekommen den Standard-Kopftext der Belegart Lieferschein aus den Textbausteinen. Bis zum Versand änderbar; leer räumt ihn. |
Fußtext footerText | nein | formatierter Text | Steht unter den Positionen — Hinweise zur Warenprüfung, Restlieferung, Grußformel. Vorbelegung und Änderbarkeit wie beim Kopftext. |
Versanddienstleister carrierKey | nein | eingerichteter Dienstleister, max. 50 Zeichen | Über wen versendet wird. |
Versandart service | nein | Leistung des Dienstleisters, max. 50 Zeichen | Standard, Express, Sperrgut … Bestimmt Preis und Laufzeit. |
Packstücke packages | nein | Liste mit Maßen und Gewicht | Wie die Sendung aufgeteilt ist. Grundlage für Etikett und Versandkosten. |
Abweichender Zustellort deliveryLocation | nein | Hausanschrift, Packstation, Postfiliale, Paketshop oder Abholpunkt | Wohin statt an die Hausanschrift zugestellt wird, samt Kennung der Station und Postnummer. Was der gewählte Dienstleister nicht kann, wird abgelehnt, statt still an die Hausanschrift zu gehen — sonst wartet der Kunde an der falschen Tür. |
Zusatzleistungen valueAddedServices | nein | Nachnahme, Unterschrift, Altersprüfung, Sperrgut | Welche Zusatzleistungen beim Dienstleister mitgebucht werden. Sie kosten Geld und müssen vom Dienstleister unterstützt werden. Trägt ein Artikel des Lieferscheins eine Altersgrenze (siehe Artikel), wird die Altersprüfung selbst mitgebucht — ein Dienstleister ohne Altersprüfung wird dann vor der Buchung abgewiesen. |
Nachnahmebetrag codAmount | mit Nachnahme | Betrag in der kleinsten Einheit der Währung (Cent) | Was der Zusteller kassiert. Er wird vor der Buchung gegen die gebuchte Zusatzleistung geprüft: ein Betrag ohne Nachnahme wird abgewiesen, eine Nachnahme ohne Betrag ebenso. Teilt sich die Lieferung auf mehrere Sendungen auf, trägt ihn die führende; zweimal kassiert wird nicht. |
Zu versichernder Warenwert insuredAmount | mit Zusatzversicherung | Betrag in der kleinsten Einheit der Währung | Der zu versichernde Warenwert, nicht die Prämie — mit derselben Prüfung in beide Richtungen. |
Der Lieferschein bucht den Bestand ab. Was hier steht, verlässt das Lager — deshalb ist er kein Papier, sondern der Buchungsvorgang.
Ausfuhr. Trägt der Auftrag eine MRN (Ausfuhr-Referenznummer der Zollanmeldung), steht sie auf dem Lieferschein-PDF; ohne MRN bleibt die Zeile weg.
Charge und MHD. Jede Zeile des Lieferschein-PDFs nennt ihre Charge und, wenn die Charge eines trägt, das Mindesthaltbarkeitsdatum. Belegvorlagen erreichen beides als items[].batchRef und items[].bestBefore.
Rücksendung
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Auftrag orderUlid | ja | bestehender Auftrag | Worauf sich die Rücksendung bezieht. |
Positionen items | ja | Artikel mit Menge | Was zurückkommt. Mehr als geliefert lässt sich nicht erfassen. |
Grund reason | ja | Stammdaten „Rücksendegründe" | Warum. Er entscheidet über die Behandlung — ein Defekt geht anders weiter als eine Fehlbestellung — und ist die einzige Grundlage, Rücksendequoten je Ursache auszuwerten. |
Erstattung refundMode | nein | automatisch oder nach Freigabe | Ob die Gutschrift von selbst entsteht oder auf eine Entscheidung wartet. Nach Freigabe ist die Wahl, wenn die Ware erst geprüft werden soll. |
Belegvorlage documentTemplateId | nein | eingerichtete Belegvorlage | Layout des Rücksendescheins. |
Versandkostenregel
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Dienstleister carrierPluginKey | nein | eingerichteter Dienstleister, max. 50 Zeichen | Für wen die Regel gilt. Leer heißt: für alle. |
Zone zone | nein | Text, max. 20 Zeichen | Für welches Gebiet — Inland, EU, Welt. |
Grundlage basis | ja | Gewicht, Warenwert, fest | Woran sich die Kosten bemessen. |
Von / Bis fromValue, toValue | nein | Zahl | Der Bereich, in dem die Regel greift — etwa 0 bis 2000 Gramm. Lückenlose Bereiche sind wichtig: Was in keinen fällt, bekommt keine Versandkosten. |
Kosten costAmount | ja | Betrag | Was berechnet wird. |
Versandkostenfrei ab freeThresholdAmount | nein | Betrag | Ab welchem Warenwert nichts berechnet wird. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke. |
Versandart service | nein | Kennung des Dienstleisters, max. 50 Zeichen | Die Versandart, die die Regel vorschreibt — bei Sendcloud der Code der Versandoption (z. B. dhl:standard), keine Nummer der alten Schnittstelle. Leer: die Regel bestimmt nur die Kosten. |
Länder countries | nein | Auswahlliste mit Suche, mehrere Länder möglich (in der Schnittstelle: zweistellige ISO-Codes, z. B. ["AT", "CH"]) | Für welche Länder die Regel gilt — feiner als die Zone, etwa für Inselzuschläge. Ein ungültiger Code wird abgewiesen; leere Liste: alle Länder. |
Längste Kante bis maxLengthMm | nein | Millimeter, 0 = keine Grenze | Bis zu welcher Kantenlänge die Regel gilt. |
Gurtmaß bis maxGirthMm | nein | Millimeter, 0 = keine Grenze | Bis zu welchem Gurtmaß (Länge + 2 × Breite + 2 × Höhe) die Regel gilt — daran machen Dienstleister Zuschläge fest. |
Reihenfolge priority | nein | Zahl, Standard 100 | Passen zwei Regeln gleich genau, gewinnt die kleinere Zahl. |
Aktiv active | nein | Ja/Nein | Ob die Regel greift. |
Gefahrgut-Profil (am Artikel, Reiter „Gefahrgut")
Enthält ein Auftrag einen Artikel mit aktivem Profil, steht die Versandampel auf Gelb: der Autoversand hält an, der Versand bleibt erlaubt. Die Meldung sagt, was die Sendung braucht — das entscheidet die Verpackungsart; bei mehreren Profilen gilt die strengste.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Artikel productId | ja | bestehender Artikel | Zu welchem Artikel das Profil gehört; im Reiter vorbelegt, nach dem Anlegen fest. |
UN-Nummer unNumber | ja | Text, max. 10 Zeichen, z. B. 3480 | Welcher Stoff — sie steht in der Ampel-Meldung. |
ADR-Klasse adrClass | nein | Text, max. 10 Zeichen, z. B. 9 | Die Gefahrgutklasse für die Papiere. |
Offizielle Benennung properShippingName | ja | Text, max. 255 Zeichen | Die Bezeichnung laut ADR, unverändert für die Papiere. |
Verpackungsart packagingMode | nein | Volle Vorschrift full (Vorgabe), Begrenzte Menge lq, Freigestellte Menge eq | Was die Sendung braucht: volle Vorschrift — Beförderungspapier nach ADR 5.4.1 und Gefahrzettel; begrenzte Menge (ADR 3.4) — kein Beförderungspapier, aber das LQ-Kennzeichen; freigestellte Menge (ADR 3.5) — kein Beförderungspapier, aber das Kennzeichen für freigestellte Mengen. Genau das nennt die Versandampel. |
Nettomenge je Stück netQuantityGrams | nein | Gramm | Grundlage der Freigrenzen. |
Aktiv active | nein | Ja/Nein | Ein abgeschaltetes Profil zählt an der Ampel nicht. |
Je Artikel gibt es ein Profil; der Artikel ist nach dem Anlegen fest. Lesen dürfen alle mit shipping.delivery.view, pflegen nur mit shipping.config.manage.
Nur über Schnittstelle und Automation
Diese Felder trägt keine Maske; sie lassen sich über die Schnittstelle, einen Import oder eine Automation setzen.
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
amountCurrency | Währungscode (ISO 4217) | Währung von Nachnahme- und Versicherungsbetrag. Ohne Angabe die des Auftrags (belegfreies Etikett: EUR); Umrechnung wie unter Beträge in Fremdwährung beschrieben. |
Geplante Läufe jetzt ausführen
Vier Läufe arbeiten selbsttätig nach Zeitplan. Mit Jetzt ausführen ziehst du einen vor — zum Beispiel nach einer Umstellung oder zum Prüfen. Der Dialog nennt den Takt, bietet Nur prüfen (Probelauf) an und zeigt danach die Zähler des Laufs. Läuft der geplante Lauf gerade, wird abgewiesen statt doppelt gearbeitet.
| Lauf | Wo | Takt | Was er tut |
|---|---|---|---|
| Autoversand | Einstellungen → Versand → Geplante Läufe | alle 15 Minuten | Legt für Aufträge mit grüner Ampel je einen Lieferschein an (keine Etiketten). |
| Sendungsverfolgung abgleichen | Einstellungen → Versand → Geplante Läufe | alle 2 Stunden | Fragt offene Sendungen beim Dienstleister ab und benachrichtigt den Kunden. |
| Sendungsnummern Streckengeschäft | Einstellungen → Versand → Geplante Läufe | stündlich | Übernimmt die Nummern aus den Versandmeldungen der Lieferanten an die Dropship-Sendungen. |
| Überfällige Retouren melden | Retouren → Überfällige melden | täglich 07:35 | Meldet Retouren, deren Ware nach der eingestellten Zahl Tage nicht eingegangen ist. |
Unter den Läufen stehen die Beiträge der Versand-Anbindungen — etwa die shipcloud-Produkte des Kontos mit ihrem Code, den du als Versandart in Regeln und beim Versand einträgst.
Einstellungen & Rechte
- Modul
module.shipping. shipping.delivery.view/.managefür Lieferscheine,shipping.shipment.managefür
Sendungen, shipping.return.manage für Retouren (auch „Überfällige melden"), shipping.config.manage für die Kostenregeln, die geplanten Läufe und die Gefahrgut-Profile.
- Zollpapiere lädt, wer den Lieferschein sehen darf (
shipping.delivery.view); Schnittstelle
GET /api/v1/delivery-notes/{ulid}/customs-declaration und …/commercial-invoice.
- Der Auftrag gibt frei. Ohne Lieferfreigabe gibt es nichts zu kommissionieren, siehe
- Kunden können Rücksendungen selbst anmelden und das Retourenetikett laden — im
FAQ & Fehlerbilder
Ein Auftrag erscheint nicht als versandfertig. Prüfen Sie die Lieferfreigabe — bei Vorkasse wartet der Auftrag auf den Zahlungseingang.
Ich kann eine Sendung nicht bearbeiten. Sendungen sind nur lesend. Änderungen entstehen beim Carrier.
Die Versandkosten stimmen nicht. Prüfen Sie Zone, Carrier und Marke der Regel — und die Schwelle für kostenfreien Versand.
Eine Retoure kam ohne Ankündigung. Legen Sie die Anfrage nach und führen Sie sie durch die Stufen; sonst fehlt der Bezug für die Erstattung.