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.
Versandkosten regeln. Kosten nach Gewicht, Wert oder fix je Zone und Carrier, einschließlich einer Schwelle für kostenfreien Versand.
Felder im Detail
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. |
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. |
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 |
|---|---|---|
codAmount | Betrag in Cent | Nachnahme-Betrag der Sendung. Er wird vor der Buchung gegen die gebuchte Zusatzleistung geprüft: ein Betrag ohne Nachnahme wird abgewiesen, eine Nachnahme ohne Betrag ebenso — sonst käme sie beim Dienstleister ohne Summe an, und der Zusteller kassiert nichts. Teilt sich die Lieferung auf mehrere Sendungen auf, trägt ihn die führende; zweimal kassiert wird nicht. |
insuredAmount | Betrag in Cent | Versicherungswert der Sendung, mit derselben Prüfung in beide Richtungen. |
Einstellungen & Rechte
- Modul
module.shipping. shipping.delivery.view/.managefür Lieferscheine,shipping.shipment.managefür
Sendungen, shipping.return.manage für Retouren, shipping.config.manage für die Kostenregeln.
- 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.