Featureinformationen
Mit den strukturierten Artikeldaten können Mitarbeitende im Wareneingang jede Artikelposition einzeln prüfen und das Prüfergebnis direkt dokumentieren. Geprüfte Artikel werden entsprechend gekennzeichnet, während festgestellte Mängel oder Abweichungen unmittelbar an der betroffenen Artikelposition erfasst werden können. Dadurch wird die Wareneingangskontrolle transparent auf Artikelebene dokumentiert und Abweichungen können deutlich präziser zugeordnet werden als bei einer ausschließlichen Erfassung auf Lieferscheinebene. Die Erfassung von Abweichungen auf Lieferscheinebene bleibt weiterhin möglich und kann parallel genutzt werden.
Fachlicher Mehrwert
Im Wareneingang können Artikel einzeln auf Positionsebene geprüft und als kontrolliert gekennzeichnet werden. Zusätzlich können Abweichungen direkt zu einzelnen Artikelpositionen erfasst werden, wodurch diese in strukturierter Form auch dem Warenversender zur Verfügung stehen.
Was das Feature bietet:
- Einzelne Artikelpositionen als „kontrolliert" abhaken — erfolgreich geprüfte Positionen werden visuell grün hervorgehoben
- Abweichungen pro Artikelposition erfassen mit Art der Abweichung (Überlieferung, Unterlieferung, nicht avisiert, Annahmeverweigerung), Anzahl, Einheit und Freitext-Anmerkung
- Abweichungen nachträglich korrigieren oder löschen
- Positionen mit Abweichungen werden rot hervorgehoben, sodass Problemfälle sofort erkennbar sind
- Die bestehende Erfassung von Abweichungen auf Lieferscheinebene (Basic-System) bleibt parallel verfügbar
Mehrwert:
- Präzise Zuordnung von Abweichungen zu konkreten Artikelpositionen statt nur auf Lieferscheinebene — damit wird die Ursachenanalyse und Reklamationsbearbeitung deutlich vereinfacht
- Der Warenversender kann die strukturierten Abweichungsdaten pro Position per API abrufen und direkt in sein Reklamations- oder Qualitätsmanagementsystem übernehmen
- Durchgängige Nachvollziehbarkeit: Prüfstatus und Abweichungen werden dokumentiert und sind über die gesamte Lieferkette hinweg abrufbar
- Farbliche Statusanzeige (grün = geprüft, rot = Abweichung) ermöglicht eine schnelle visuelle Übersicht über den Kontrollfortschritt
- Information für Frontend-Nutzer
Information für Frontend-Nutzer
Im Reiter „Artikel & Abweichungen" stehen folgende Funktionen zur Verfügung:
Artikelprüfung:
- In der Spalte „Kontrolliert" kann jede Artikelposition per Checkbox als geprüft markiert oder wieder zurückgesetzt werden
- Erfolgreich geprüfte Positionen ohne Abweichung werden grün hinterlegt
Abweichungserfassung:
- Per Klick auf eine Artikelzeile öffnet sich ein Dialog zur Erfassung von Abweichungen zu dieser Position
- Pflichtangaben: Art der Abweichung, Anzahl und Einheit
- Optionale Freitext-Anmerkung (max. 400 Zeichen)
- Positionen mit Abweichungen werden rot hinterlegt
- Bestehende Abweichungen können über den gleichen Dialog bearbeitet oder gelöscht werden
- Über die PUT-Funktion können alle Abweichungen einer Position auf einmal ersetzt werden — der Artikel wird dabei automatisch als geprüft markiert
| Wert |
|---|
| Überlieferung |
| Unterlieferung |
| Nicht avisiert |
| Annahmeverweigerung |
Information für API-Anbindung (fachliche Aspekte)
Alle Endpunkte erfordern das Feature-Flag consigneeArticleDiscrepancies. Die Mappe muss sich im Status „Checkin gestartet" befinden.
| Methode | Pfad | Beschreibung |
|---|---|---|
| PATCH | .../consignee/articles/{articleKey}/check | Artikel als kontrolliert markieren oder zurücksetzen |
| POST | .../consignee/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies | Neue Abweichung zu einer Artikelposition erfassen |
| PATCH | .../consignee/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies/{discrepancyKey} | Bestehende Abweichung aktualisieren |
| DELETE | .../consignee/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies/{discrepancyKey} | Abweichung löschen |
| PUT | .../consignee/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies | Alle Abweichungen einer Position ersetzen (Artikel wird automatisch als geprüft markiert) |
| GET | .../delivery-notes/{dnKey}/articles/{articleKey}/discrepancies | Alle Abweichungen einer Artikelposition abrufen |
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:
- Automatisierte Wareneingangskontrolle: Prüfergebnisse aus dem eigenen WMS per API an Cloud4Log Addons übermitteln — Artikel als geprüft markieren und Abweichungen strukturiert erfassen
- Reklamationsmanagement: Abweichungsdaten pro Artikelposition direkt in das eigene Reklamations- oder QM-System übernehmen
- Lieferantenbewertung: Abweichungsdaten auswerten, um Lieferqualität systematisch zu messen
Hinweise für Entwickler
Artikel als geprüft markieren:
curl -X PATCH -H "Authorization: Bearer {token}"
-H "Content-Type: application/json"
-d '{"checked": true}'
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/articles/{articleKey}/check"
Abweichung zu einer Artikelposition erfassen:
curl -X POST -H "Authorization: Bearer {token}"
-H "Content-Type: application/json"
-d '{"reason": "UNDER_DELIVERED", "number": 5, "unit": "CARTON", "note": "5 Kartons fehlen"}'
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies"
Hinweise:
- reason: OVER_DELIVERED, UNDER_DELIVERED, NOT_ANNOUNCED, REFUSAL_OF_ACCEPTANCE
- unit: PIECE, CARTON, PALLET, COLLI, TRAY, KILOGRAM, GRAM, TON, PARTIAL_PALLET, PACKAGE u. a.
- note: Freitext, max. 400 Zeichen
- Abweichungen werden parallel im Basic-System gespeichert (Synchronisation erfolgt automatisch)
- Feature setzt consigneeArticlesRead und consigneeArticlesEditing als Abhängigkeiten voraus
- Die GET-Endpunkte zum Lesen von Abweichungen verwenden keinen /consignee/-Prefix im Pfad und sind auch für den Warenversender abrufbar