Featureinformationen
Artikeldaten pflegen und ergänzen
Strukturierte Artikeldaten können im digitalen Lieferschein bearbeitet, ergänzt oder gelöscht werden. Dies gilt sowohl für per KI ausgelesene Daten als auch für vom Warenabsender bereitgestellte Artikeldaten.
Zusätzlich können neue Artikel manuell erfasst werden. So können Wareneingänge präziser dokumentiert und Abweichungen zwischen Lieferung und Lieferschein direkt berücksichtigt werden.
Fachlicher Mehrwert
Warenempfänger können die strukturierten Artikeldaten eines Lieferscheins korrigieren, ergänzen und bei Bedarf einzelne Positionen entfernen oder neue hinzufügen. Die originalen Artikeldaten bleiben dabei vollständig historisiert erhalten — jede Änderung wird mit Bearbeiter und Zeitstempel dokumentiert.
Was das Feature bietet:
- Korrektur einzelner Artikelattribute (z. B. Menge, Artikelnummer, GTIN, Bezeichnung, Gebindeart, MHD, Chargennummer, Qualitätssiegel) direkt im Wareneingang
- Bestellnummer pro Artikelposition erfassen oder korrigieren, auch wenn diese bereits per KI ausgelesen oder vom Warenversender strukturiert geliefert wurde
- Neue Artikelpositionen hinzufügen, die nicht im ursprünglichen Lieferschein enthalten waren
- Artikelpositionen als entfernt markieren
- Notizen pro Artikelposition erfassen mit steuerbarer Sichtbarkeit für den Warenversender
Mehrwert:
- Die tatsächliche Warenlieferung kann exakt dokumentiert werden, auch wenn der ursprüngliche Lieferschein durch die KI-unterstützte Auslesung Fehler enthält oder unvollständig ist
- Korrigierte Daten fließen automatisch in nachgelagerte Prozesse ein
- Bei Korrektur vergleichsrelevanter Felder (Bestellnummer, Artikelnummer des Empfängers, Menge) werden automatische Abweichungen zurückgesetzt, sodass ein erneuter Abgleich mit korrekten Daten erfolgen kann
Information für Frontend-Nutzer
Im Reiter „Artikel & Abweichungen" stehen folgende Bearbeitungsfunktionen zur Verfügung:
Artikel bearbeiten:
- Über das Aktionsmenü (Drei-Punkte-Symbol) einer Artikelzeile → „Bearbeiten" öffnet sich ein Dialog zur Korrektur der Artikelattribute
- Bearbeitbare Felder: Position, Artikelnummer, GTIN, Bezeichnung, Menge, Gebindeart, Chargennummer, MHD, Gefahrgutklasse, Bestellnummer, Artikelnummer des Empfängers, Qualitätssiegel (Bio, QS, GQB, Naturland), GGN und Herkunftsland
Artikel hinzufügen:
- Über den Button „Artikel hinzufügen" kann eine neue Position ergänzt werden
- Hinzugefügte Positionen sind als editedAdded gekennzeichnet
Artikel entfernen:
- Über das Aktionsmenü → „Löschen" wird eine Position als entfernt markiert
- Entfernte Positionen sind über den Schalter „Artikelhistorie" weiterhin sichtbar und können wiederhergestellt werden
Artikelnotizen (separates Feature):
- Über das Aktionsmenü → „Notizen" können Freitext-Notizen zu einzelnen Positionen erfasst werden
- Per Slide-Toggle kann gesteuert werden, ob die Notiz für den Warenversender sichtbar sein soll
- Notizen des Warenversenders sind ebenfalls einsehbar
- Information für API-Anbindung (fachliche Aspekte)
Alle Endpunkte erfordern das Feature-Flag consigneeArticlesEditing und die Rolle Warenempfänger (Consignee).
| Methode | Pfad | Beschreibung |
|---|---|---|
| PATCH | .../consignee/articles/{articleKey}/edit | Artikelattribute teilweise korrigieren |
| POST | .../consignee/delivery-notes/{dnKey}/articles/edit | Neue Artikelposition hinzufügen |
| DELETE | .../consignee/articles/{articleKey}/edit | Artikelposition als entfernt markieren (Soft Delete) |
| POST | .../consignee/delivery-notes/{dnKey}/articles/{articleKey}/notes | Notiz zu einer Artikelposition erfassen (v3) |
| POST | .../consignee/.../articles/{articleKey}/notes/{noteKey}/visible | Notiz für den Warenausgang (WA) sichtbar machen (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:
- WMS-Integration: Korrekturen aus dem eigenen Warehouse-Management-System automatisiert an Cloud4Log Addons übermitteln, z. B. wenn bei der physischen Vereinnahmung Abweichungen zum Lieferschein festgestellt werden
- Datenbereinigung: Fehlende oder fehlerhafte Artikeldaten (GTIN, Chargennummer, MHD) nachträglich über die API ergänzen, damit nachgelagerte Reports und Abgleiche auf korrekten Daten basieren
- Artikelnotizen als Kommunikationskanal: Rückmeldungen zu einzelnen Positionen an den Warenversender übermitteln, ohne den Umweg über eine separate Abweichung
Hinweise für Entwickler
Artikelattribute korrigieren:
curl -X PATCH -H "Authorization: Bearer {token}"
-H "Content-Type: application/json"
-d '{"quantity": 48, "articleOrderNumber": "BN-2026-0815"}'
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/articles/{articleKey}/edit"
Neue Artikelposition hinzufügen:
curl -X POST -H "Authorization: Bearer {token}"
-H "Content-Type: application/json"
-d '[{"index": 99, "articleNumber": "ART-NEW", "description": "Zusatzposition", "quantity": 10, "containerType": "Karton"}]'
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/delivery-notes/{dnKey}/articles/edit"
Hinweise:
- PATCH ist partiell: nur die übergebenen Felder werden aktualisiert, alle anderen bleiben unverändert
- Editierbare Felder: index, gtin, description, pos, articleNumber, customerArticleNumber, containerType, quantity, danger, dangerClass, dateExpired, batchNumber, qs, organic, naturland, gqb, articleOrderNumber, ggn, countryOfOrigin
- Jede Korrektur wird mit editedBy (User-Key) und editedOn (Zeitstempel) historisiert — Originalwerte bleiben im edits-Objekt erhalten
- Bei Korrektur von articleOrderNumber, customerArticleNumber oder quantity werden automatische Abweichungen zurückgesetzt
- DELETE führt ein Soft Delete durch: Die Position bleibt mit editedRemoved: true abrufbar
- Feature setzt consigneeArticlesRead (E5a) als Abhängigkeit voraus