Suche und Sortierung von Artikeldaten

Suchen und Sortieren im Check-In

Mit der Such- und Sortierfunktion im Check-In können Mitarbeitende im Wareneingang Artikeldaten gezielt filtern und nach relevanten Kriterien sortieren. So behalten Sie auch bei Lieferungen mit vielen Positionen jederzeit den Überblick.

Die strukturierte Darstellung ermöglicht ein schnelles Auffinden einzelner Artikel und erleichtert die Prüfung von Lieferungen sowie die Bearbeitung von Abweichungen.

Artikel suchen, filtern und sortieren

Mit der Such- und Sortierfunktion im Check-In können Mitarbeitende im Wareneingang Artikeldaten gezielt filtern und nach relevanten Kriterien sortieren. So behalten sie auch bei Lieferungen mit vielen Positionen jederzeit den Überblick.

Die strukturierte Darstellung ermöglicht ein schnelles Auffinden einzelner Artikel und erleichtert die Prüfung von Lieferungen sowie die Bearbeitung von Abweichungen.

Fachlicher Mehrwert

Im Reiter „Artikel & Abweichungen“ können die angezeigten Artikeldaten durchsucht, sortiert und gefiltert werden. Die Tabelle bietet umfangreiche Möglichkeiten, um auch bei umfangreichen Lieferscheinen mit vielen Positionen schnell die relevanten Artikel zu finden und übersichtlich darzustellen.

Was das Feature bietet

• Volltextsuche über mehrere Artikelfelder gleichzeitig
• Sortierung per Klick auf Spaltenüberschriften (aufsteigend oder absteigend)
• Filter nach Qualitätssiegeln (Bio, QS, GQB, Naturland), Gebindeart und QS-Ampel
• Individuelles Ein- und Ausblenden von Spalten mit Anzeige der sichtbaren und verfügbaren Spaltenanzahl
• Anpassung der Spaltenreihenfolge per Drag-and-Drop
• Benutzerspezifische Spaltenkonfiguration wird gespeichert und beim nächsten Aufruf automatisch wiederhergestellt

Mehrwert

• Effiziente Wareneingangskontrolle: Mitarbeitende können gezielt nach bestimmten Artikeln, GTINs oder Gebindearten suchen, anstatt alle Positionen manuell prüfen zu müssen.
• Individuelle Arbeitsweise: Jeder Nutzer kann die Tabellenansicht nach den eigenen Anforderungen konfigurieren und nur die für den jeweiligen Prüfprozess relevanten Informationen anzeigen.
• Schnelle Orientierung bei großen Lieferungen: Durch Sortier- und Filterfunktionen wird die sichtbare Datenmenge auf die tatsächlich relevanten Artikel reduziert und die Prüfung von Lieferungen beschleunigt.

Information für Frontend-Nutzer

Volltextsuche

• Über dem Tabellenbereich befindet sich ein Suchfeld (Lupe-Symbol). Die Eingabe filtert die Artikelliste sofort über folgende Felder:
  • Artikelbezeichnung
  • Artikelnummer
  • Artikelnummer des Empfängers
  • Gebindeart
  • GTIN
  • Lagerort (sofern per ASN vorhanden)
• Über das Löschen-Symbol (X) kann der Suchbegriff zurückgesetzt werden.

Sortierung

• Per Klick auf eine Spaltenüberschrift wird die Tabelle nach dieser Spalte sortiert (aufsteigend → absteigend → unsortiert).
• Sortierbare Spalten:
  • Position
  • Lagerort
  • PO-Nummer
  • Art.-Nr. Empfänger
  • Artikelnummer
  • GTIN
  • GGN
  • Herkunftsland
  • Bezeichnung
  • Menge
  • QS-Ampel
  • Chargennummer
  • MHD
  • Gefahrgutklasse
  • Kontrolliert
• Spezialbehandlung:
  • Lagerorte werden alphanumerisch sortiert (z. B. A1-2-3 vor A1-10-1)
  • MHD wird als Datum sortiert

Filter

Qualitätssiegel

• Per Checkbox können Bio, QS, GQB und Naturland ein- oder ausgeschaltet werden.
• Es werden nur Positionen mit dem gewählten Siegel angezeigt.

Gebindeart

• Per Checkbox-Liste können bestimmte Gebindearten ein- oder ausgeblendet werden.

QS-Ampel

• Per Checkbox-Liste können die Ampelfarben Grün, Gelb und Rot gefiltert werden.

Spaltensteuerung

• Der Button „Spalten ein-/ausblenden“ öffnet einen Dialog mit allen verfügbaren Spalten (Anzeige z. B. „12/20“).
• Einzelne Spalten können per Checkbox ein- oder ausgeblendet werden.
• Über „Zurücksetzen“ wird die Standardkonfiguration wiederhergestellt.
• Spaltenüberschriften können direkt in der Tabelle per Drag-and-Drop in der Reihenfolge verschoben werden.
• Die Konfiguration (sichtbare Spalten und Reihenfolge) wird benutzerspezifisch gespeichert.

Information für API-Anbindung (fachliche Aspekte)

Dies ist ein reines Frontend-Feature. Suche, Sortierung und Filter werden clientseitig auf den bereits geladenen Artikeldaten ausgeführt. Es gibt keine zusätzlichen API-Endpunkte für E24.

Die Artikeldaten werden über den bestehenden Endpunkt abgerufen:

Methode	Pfad	Beschreibung
GET	/organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles	Alle Artikelpositionen eines Lieferscheins abrufen

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

Hinweis für eigene Frontends

Die API liefert alle Artikelpositionen eines Lieferscheins als Array zurück. Suche, Sortierung und Filter müssen im eigenen Frontend implementiert werden.

Folgende Felder eignen sich als Suchfelder:

• description
• articleNumber
• customerArticleNumber
• containerType
• gtin
• metaData[].storageLocation

Folgende Felder eignen sich als Filterkriterien:

• organic
• qs
• gqb
• naturland
• containerType

Hinweise für Entwickler

Da diese Funktion rein clientseitig arbeitet, gibt es keine zusätzliche API-Anbindung. Die Artikeldaten werden einmalig per GET .../articles geladen. Alle weiteren Operationen erfolgen im Browser.

Sortierung

Das Feld pos (Position) kann alphanumerische Werte enthalten (z. B. „1a“, „10“, „2b“). Eine natürliche Sortierung (Natural Sort) ist daher empfehlenswert.

Für dateExpired (MHD) sollte eine Datumssortierung mit Nullwert-Behandlung verwendet werden.

Effektiver Wert

Bei editierten Feldern gilt das folgende Muster:

edits?.{field}?.value ?? {field}

Der korrigierte Wert hat Vorrang vor dem Originalwert. Dieses Verhalten sollte auch bei der clientseitigen Suche und Sortierung berücksichtigt werden.

Spaltenkonfiguration

Die Tabelle unterstützt 20 verfügbare Spalten. Eine persistente Spaltenkonfiguration pro Benutzer verbessert die Nutzererfahrung und ermöglicht eine individuelle Arbeitsweise.