QS-Ampel für Artikel, Lieferscheine, Mappen und Touren

QS-Ampel für mehrere Prozessebenen

Cloud4Log Addons vergleicht die im Lieferschein enthaltenen Artikeldaten automatisch mit den avisierten Bestelldaten (ASN-Daten). Auf Basis von Bestellnummer, Artikelnummer und Liefermenge wird für jede Artikelposition ein QS-Status ermittelt und als Ampel angezeigt.

Die QS-Ampel macht Abweichungen sofort sichtbar und unterstützt Mitarbeitende im Wareneingang bei der schnellen Prüfung von Lieferungen. Der Status wird dabei nicht nur auf Artikelebene, sondern auch für Lieferscheine, Mappen und Touren angezeigt.

Ampelstatus

• 🟢 Bestellnummer, Artikelnummer und Menge stimmen mit den ASN-Daten überein.
• 🟡 Bestellnummer und Artikelnummer stimmen überein, die Liefermenge weicht jedoch von der avisierten Menge ab.
• 🔴 Es konnten keine passenden ASN-Daten zugeordnet werden oder Bestellnummer bzw. Artikelnummer stimmen nicht überein.

Fachlicher Mehrwert

Mehrwert

• Sofortige Transparenz bei der Wareneingangskontrolle: Jeder Artikel erhält eine farbige Ampel. Grün signalisiert eine Übereinstimmung, Gelb eine Mengenabweichung und Rot einen fehlenden ASN-Abgleich. Dadurch erkennen Mitarbeitende sofort, bei welchen Positionen Handlungsbedarf besteht.
• Durchgängige Sichtbarkeit auf allen Ebenen: Die QS-Ampel wird nicht nur auf Artikelebene angezeigt, sondern auch aggregiert auf Lieferschein-, Mappen- und Tourebene. Es gilt das Prinzip „Worst Wins“: Enthält ein Lieferschein mindestens einen roten Artikel, wird der gesamte Lieferschein als Rot bewertet.
• Automatischer Abgleich ohne manuelle Prüfung: Der Vergleich zwischen avisierter und gelieferter Menge erfolgt automatisch auf Basis von Bestellnummer und Empfänger-Artikelnummer.
• Filterbare Übersicht: Artikel können gezielt nach ihrem Ampelstatus (Rot, Gelb oder Grün) gefiltert werden.
• Korrekturen werden berücksichtigt: Änderungen an Mengenangaben werden unmittelbar bei der Berechnung des QS-Status berücksichtigt.

Information für Frontend-Nutzer

Voraussetzung

Für die Nutzung müssen folgende Features aktiviert sein:

• ASN-Daten hochladen und verarbeiten
• Erweiterte QS-Prüfszenarien

Zusätzlich müssen ASN-Daten (Lieferavise mit Bestellmengen) zuvor per Excel-Upload oder API importiert worden sein.

QS-Ampel in der Artikeltabelle

Im Reiter „Artikel & Abweichungen“ befindet sich die Spalte „QS Status“.

Symbol	Farbe	Bedeutung	Tooltip
cancel	Rot	Kein passender ASN-Eintrag gefunden	„Artikel nicht gefunden“
circle	Gelb	ASN-Eintrag gefunden, Menge weicht ab	„Erwartete Menge: {Zahl}“
check_circle	Grün	ASN-Eintrag gefunden, Menge stimmt überein	„Erwartete Menge: {Zahl}“

Filtern nach Ampelstatus

• In der Spaltenüberschrift „QS Status“ befindet sich ein Filtersymbol.
• Über das Filtersymbol können die Status Rot, Gelb und Grün ausgewählt werden.
• Nach Auswahl der gewünschten Status klicken Sie auf „Anwenden“, um die Artikelliste einzuschränken.
• Über „Zurücksetzen“ werden wieder alle Artikel angezeigt.

QS-Ampel auf übergeordneten Ebenen

Die QS-Ampel wird ebenfalls auf Lieferschein-, Mappen- und Tourebene angezeigt.

Folgende Logik wird verwendet:

• Enthält ein Lieferschein mindestens einen roten Artikel → Ampel = Rot
• Kein roter, aber mindestens ein gelber Artikel → Ampel = Gelb
• Alle Artikel sind grün → Ampel = Grün

Die gleiche Logik gilt für Mappen und Touren.

Information für API-Anbindung (fachliche Aspekte)

Die QS-Ampel basiert auf dem Abgleich der Artikelpositionen eines Lieferscheins mit zuvor importierten ASN-Daten (Lieferavisen).

Der berechnete Status wird im Feld qsStatus zurückgegeben und kann folgende Werte annehmen:

• red
• yellow
• green

Betroffene Endpunkte

Ebene	Methode	Endpunkt	QS-Status
ASN-Import (v3)	POST	/api/v3/.../consignee/advanced-shipping-notes	Datenquelle
ASN-Import (v2)	PUT	/api/v2/.../consignee/advancedShippingNotes	Datenquelle
ASN-Abruf (v3)	GET	/api/v3/.../consignee/advanced-shipping-notes	Datenquelle
Artikelpositionen	GET	/api/v2/.../delivery-notes/{deliveryNoteKey}/articles	Pro Artikel
Lieferscheine	GET	/api/v3/.../consignee/delivery-notes	Aggregiert pro Lieferschein
Mappen	GET	/api/v3/.../consignee/delivery-note-bundles	Aggregiert pro Mappe
Touren	GET	/api/v3/.../consignee/tours	Aggregiert pro Tour

Die vollständige API-Spezifikation ist in der Cloud4Log Addons API-Dokumentation verfügbar.

Benötigte Feature-Flags

Feature-Flag	Funktion
advancedShippingNotice	ASN-Datenimport (POST/PUT/GET)
extendedQSInspection	Berechnung und Anzeige der QS-Ampel

Fachliche Einsatzmöglichkeiten in Drittsystemen

• Automatisierte Wareneingangskontrolle: Der Wert qsStatus kann zur automatischen Auslösung von Prüfprozessen oder Aufgaben genutzt werden.
• Lieferantenmonitoring: Aggregierte Ampelstatus auf Tour- oder Mappenebene ermöglichen eine systematische Bewertung der Lieferqualität.
• ERP-/WMS-Integration: Avisierte Mengen (expectedQuantity) und gelieferte Mengen (quantity) können für Soll-/Ist-Abgleiche übernommen werden.

Hinweise für Entwickler

Schritt 1 – ASN-Daten importieren

POST /api/v3/.../consignee/advanced-shipping-notes

[
  {
    "advancedShippingNotice": "ASN-2026-001",
    "articleOrderNumber": "PO-12345",
    "sellableCode": "4711",
    "quantity": 100
  }
]

Pflichtfelder:

• advancedShippingNotice
• articleOrderNumber
• sellableCode
• quantity

Optionale Felder:

• consigneeOrderNumber
• storageLocation
• description

Weitere Regeln:

• Maximal 500 Einträge pro Request
• Vorhandene ASN-Einträge werden per Upsert aktualisiert

Schritt 2 – Artikelpositionen mit QS-Ampel abrufen

GET /api/v2/.../delivery-notes/{deliveryNoteKey}/articles

Jede Artikelposition enthält zusätzlich:

• qsStatus
• expectedQuantity

Matching-Logik

• Zuordnung erfolgt über articleOrderNumber und sellableCode
• Fallback auf articleNumber, falls notwendig
• expectedQuantity == null → red
• expectedQuantity != quantity → yellow
• expectedQuantity == quantity → green
• Korrigierte Mengen (edits.quantity) werden automatisch berücksichtigt

Die API-Endpunkte sind vollständig in der Cloud4Log Addons API-Dokumentation beschrieben.