Originalversender anzeigen und suchen

Originalversender anzeigen und suchen

Im Reiter „Artikel & Abweichungen“ wird im linken Teilfenster je Lieferschein der Originalversender angezeigt, sofern dieser beim Hochladen des Lieferscheins durch den Versender erfasst wurde.

Zusätzlich können Mitarbeitende im Wareneingang gezielt nach Lieferscheinen eines bestimmten Originalversenders suchen. Das erleichtert die Zuordnung bei der Sichtung von Paletten und beschleunigt das Auffinden des passenden Lieferscheins.

Fachlicher Mehrwert

Wenn der Warenversender zu einem Lieferschein beim Hochladen einen Originalversender erfasst hat, wird dieser dem Mitarbeiter im Wareneingang im Reiter „Artikel & Abweichungen“ im linken Teilfenster angezeigt. Zusätzlich kann nach dem Originalversender und der Lieferscheinnummer gesucht werden.

Was das Feature bietet

• Anzeige des Originalversenders (Name) im linken Lieferschein-Panel, sofern dieser beim Hochladen erfasst wurde
• Anzeige der zugehörigen GLN (Global Location Number) des Originalversenders
• Suchfeld oberhalb der Lieferscheinliste, das Lieferscheine gleichzeitig nach Originalversender und Lieferscheinnummer filtert

Hintergrund

• Der Originalversender ist der tatsächliche Erzeuger oder Lieferant der Ware und kann vom eingetragenen Versender (Consignor) abweichen, beispielsweise bei Speditionslagern, Umschlagpunkten oder Kommissionierern.
• Die Felder originalConsignor (Name, 3 bis 60 Zeichen, kein Komma) und originalConsignorGln (13-stellige GLN) werden vom Warenversender beim Hochladen des Lieferscheins über die Basis-API gesetzt.

Mehrwert

• Schnelle Identifikation des tatsächlichen Warenursprungs im Wareneingang, ohne den PDF-Lieferschein öffnen zu müssen
• Gezielte Eingrenzung von Lieferscheinen eines bestimmten Originalversenders bei umfangreichen Lieferungen oder Lieferscheinmappen
• Unterstützung der Rückverfolgbarkeit und Qualitätssicherung, insbesondere für Frischware, Bio-Produkte und Waren mit Herkunftsnachweispflicht

Information für Frontend-Nutzer

Im Reiter „Artikel & Abweichungen“ wird der Originalversender im linken Teilfenster (Lieferscheinliste) angezeigt.

Anzeige pro Lieferschein

• Original Versender – Name des Originalversenders; wird nur angezeigt, wenn dieser vom Warenversender beim Hochladen erfasst wurde
• Darunter werden zusätzlich Bestellnummer, Eigene Bestellnummer und das avisierte Lieferdatum angezeigt

Suchfunktion

• Über dem Lieferschein-Panel befindet sich ein Suchfeld mit Lupe-Symbol
• Die Eingabe filtert die Lieferscheinliste gleichzeitig nach Lieferscheinnummer und Originalversender
• Über das X-Symbol wird der Suchfilter zurückgesetzt und alle Lieferscheine werden wieder angezeigt

Hinweis

Der Originalversender ist ein reines Anzeigefeld im Wareneingang. Er wird vom Warenversender beim Erstellen des Lieferscheins gesetzt und kann vom Warenempfänger nicht bearbeitet werden.

Information für API-Anbindung (fachliche Aspekte)

Der Originalversender ist Bestandteil der Lieferschein-Metadaten und wird über die bestehenden Lieferschein-Endpunkte bereitgestellt. Es gibt keine separaten Endpunkte für E20.

Methode	Pfad	Beschreibung
GET	.../consignee/delivery-notes/{deliveryNoteKey}	Lieferschein-Metadaten abrufen (inkl. originalConsignor und originalConsignorGln)

Die vollständige API-Spezifikation ist in der Swagger-Dokumentation unter Cloud4Log Addons API-Dokumentation einsehbar.

Datenmodell (auf Lieferscheinebene)

Feld	Typ	Beschreibung
originalConsignor	string	Name des Originalversenders (3 bis 60 Zeichen, kein Komma)
originalConsignorGln	string	GLN des Originalversenders (13-stellige Nummer)

Fachliche Einsatzmöglichkeiten in eigenen Systemen

• Rückverfolgbarkeit: Automatische Übernahme des Originalversenders in QM-Systeme zur lückenlosen Dokumentation des tatsächlichen Warenursprungs
• Lieferantenzuordnung: Identifikation tatsächlicher Erzeuger oder Lieferanten bei Sammellieferungen über Spediteure oder Umschlagpunkte
• Filterung im eigenen Frontend: Lieferscheine nach Originalversender filtern, um beispielsweise alle Lieferungen eines bestimmten Erzeugers zu finden

Hinweise für Entwickler

Originalversender aus Lieferschein-Metadaten auslesen

curl -H "Authorization: Bearer {token}" \
  "https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/delivery-notes/{dnKey}"

Beispielhafte Response:

{
  "originalConsignor": "Bio-Hof Müller GmbH",
  "originalConsignorGln": "4399902000019"
}

Hinweise

• originalConsignor und originalConsignorGln werden vom Warenversender beim Hochladen des Lieferscheins über die Basis-API gesetzt. Die Felder sind im Addons-System nur lesbar und nicht bearbeitbar.
• Beide Felder können leer sein, wenn kein Originalversender angegeben wurde.
• E20 erfordert das Feature consigneeArticlesRead. Die Anzeige erfolgt ausschließlich im Reiter „Artikel & Abweichungen“ und nicht in der klassischen Lieferscheinansicht.