Featureinformationen
Artikeldaten auf Positionsebene
Strukturierte Artikeldaten werden im Reiter „Artikel & Abweichungen“ auf Positionsebene bereitgestellt. Die Daten stammen entweder aus einer KI-gestützten Erkennung des Lieferscheins oder werden vom Warenabsender bereits strukturiert übermittelt.
Damit werden die Inhalte eines Lieferscheins nicht nur als Dokument angezeigt, sondern für die digitale Weiterverarbeitung auf Artikelebene verfügbar gemacht. Dies schafft die Grundlage für digitale Wareneingangs- und Warenvereinnahmungsprozesse sowie für Such-, Prüf-, Scan-, QS- und Automatisierungsfunktionen in Cloud4Log Addons.
Fachlicher Mehrwert
Was das Feature bietet:
- Tabellarische Anzeige aller Artikelpositionen eines Lieferscheins mit Artikelnummer, GTIN, Bezeichnung, Menge, Gebindeart, Chargennummer, MHD, Gefahrgutklasse und weiteren Feldern
- GGN (GlobalGAP-Nummer) und Herkunftsland pro Artikelposition, sofern erfasst
- Kennzeichnung von Qualitätssiegeln (Bio, QS, GQB, Naturland) pro Position
- Kennzeichnung, ob eine Position per KI ausgelesen wurde
- Anzeige des Originalversenders, sofern vom Warenversender beim Hochladen erfasst
- Vollständige Änderungshistorie: nachträglich korrigierte, hinzugefügte oder entfernte Positionen sind nachvollziehbar dokumentiert
Mehrwert:
- Bessere Übersicht der Lieferscheininformationen als Grundlage für eine effiziente Kontrolle im Wareneingang
- Strukturierte Daten statt manueller PDF-Auswertung — durchsuchbar, sortierbar und filterbar
- Grundlage für weiterführende Features: Abweichungserfassung auf Artikelebene (E6), automatischer Soll/Ist-Abgleich (A9/E29), Artikelnotizen (E31) und KI-Auslesung (A17) bauen auf E5a auf
- Digitale Wareneingangskontrolle wird beschleunigt und standardisiert
Information für Frontend-Nutzer
Im Checkin-Prozess steht der Reiter „Artikel & Abweichungen" zur Verfügung. Die Ansicht ist als zweigeteiltes Layout aufgebaut:
- Linkes Teilfenster: Liste der Lieferscheine im Vorgang. Per Klick wird der zugehörige Lieferschein ausgewählt.
- Rechtes Teilfenster: Artikeltabelle zum ausgewählten Lieferschein.
Funktionen der Artikeltabelle:
- Volltextsuche über Artikelbezeichnung, Artikelnummer, GTIN, Gebindeart und Lagerort
- Sortierung per Klick auf Spaltenüberschriften (z. B. nach Position, Menge, MHD)
- Filter nach Qualitätssiegeln (Bio, QS, GQB, Naturland) und Gebindeart
- Spalten ein-/ausblenden: Über einen Dialog können angezeigte Spalten individuell ausgewählt werden
- Spaltenreihenfolge ändern: Per Drag-and-Drop können Spalten umsortiert werden
- Artikelhistorie: Über einen Schalter lassen sich entfernte und korrigierte Positionen einblenden
- KI-Kennzeichnung: Per KI ausgelesene Positionen sind mit einem Roboter-Symbol markiert. Bei fehlgeschlagener Auslesung wird ein Hinweis mit Neustart-Option angezeigt.
Information für API-Anbindung (fachliche Aspekte)
Die strukturierten Artikeldaten eines Lieferscheins können über die API abgerufen werden. Alle Endpunkte erfordern das Feature consigneeArticlesRead.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles | Alle Artikelpositionen eines Lieferscheins abrufen |
| GET | /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/notes | Notizen zu einer Artikelposition abrufen (v3) |
Die vollständige API-Spezifikation mit Request- und Response-Schemas ist in der Swagger-Dokumentation unter https://app.cloud4log-addons.com/api-docs/ einsehbar.
Fachliche Einsatzmöglichkeiten in eigenen Systemen:
- Wareneingangsprüfung automatisieren: Artikeldaten strukturiert in eigenes WMS/ERP übernehmen und mit Bestelldaten abgleichen
- Qualitätskontrolle: Zertifizierungsstatus (Bio, QS, GQB, Naturland) und MHD automatisch auswerten
- Chargenverfolgung: Chargennummern und Herkunftsland aus den Artikelpositionen für Rückverfolgbarkeit nutzen
- Abweichungsmonitoring: Über die Felder hasDiscrepancy, checked und automaticCompareStatus den Kontrollstatus der Positionen maschinell auswerten
Hinweise für Entwickler
Anbindung:
Artikeldaten abrufen — GET /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles:
curl -H "Authorization: Bearer {token}"
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles"
Hinweise:
- Artikeldaten sind erst verfügbar, wenn der Lieferschein in einer Mappe mit Status sent oder closed enthalten ist
- Das Feld isAI kennzeichnet per KI ausgelesene Positionen; edits enthält die Änderungshistorie mit Wert, Bearbeiter und Zeitstempel pro Feld
- automaticCompareStatus (MATCH, OVER_DELIVERED, UNDER_DELIVERED) und expectedQuantity sind nur gefüllt, wenn ein Soll/Ist-Abgleich stattgefunden hat
- articleNotes enthält freigegebene Notizen von WA und WE — Sichtbarkeitsfilter wird serverseitig angewendet
- E5a ist das Lesefundament: Bearbeitungsfunktionen (Artikel ändern/hinzufügen/entfernen) erfordern zusätzlich consigneeArticlesEditing, Abweichungserfassung erfordert consigneeArticleDiscrepancies