Featureinformationen
Eindeutige Bestellzuordnung je Artikel
Bestellnummern werden je Artikelposition aus strukturierten Daten übernommen oder per KI aus dem Lieferschein ausgelesen. Mitarbeitende im Wareneingang können die Bestellnummern prüfen, ergänzen oder korrigieren und jedem Artikel eine individuelle Bestellnummer zuordnen.
Dies erleichtert insbesondere die Bearbeitung von Sammellieferscheinen, bei denen Artikel unterschiedlichen Bestellungen zugeordnet sind. So können Lieferungen schneller geprüft und den richtigen Beschaffungsprozessen zugeordnet werden.
Wie eine PO-Nummer an einen Artikel gelangt
- Automatisch aus dem PDF-Lieferschein: Wird ein Lieferschein mit der Option „Upload starten mit AI“ hochgeladen, liest die KI den PDF-Lieferschein aus und versucht, für jeden Artikel eine eigene Bestellnummer (PO-Nummer) zu erkennen. Wenn die KI eine PO-Nummer im PDF findet, wird sie automatisch am jeweiligen Artikel hinterlegt.
- Automatischer Rückfall auf die Bestellnummer des Versenders: Wenn die KI für einen Artikel keine eigene PO-Nummer im PDF finden kann, übernimmt das System automatisch die Bestellnummer des Versenders als PO-Nummer für diesen Artikel.
- Manuelle Pflege durch den Wareneingang: In der Artikeltabelle im Bereich Wareneingang kann der MAWE über das Drei-Punkte-Menü „Artikel bearbeiten“ einen Artikel öffnen und dort im Feld „PO-Nummer“ den Wert anpassen oder erstmalig erfassen.
Fachlicher Mehrwert
Was das Feature bietet:
- Bestellnummer (articleOrderNumber / PO-Nummer) pro Artikelposition erfassen oder korrigieren
- Artikelnummer des Empfängers (customerArticleNumber / Art-Nr. Empfänger) pro Position erfassen oder korrigieren
- Beide Felder dienen als Schlüssel für die eindeutige Zuordnung zwischen Lieferscheinposition und interner Bestellung des Empfängers
Mehrwert:
- Eindeutige Zuordnung von Lieferscheinpositionen zu Bestellungen des Empfängers — die Grundlage für eine automatisierte Wareneingangsprüfung
- Korrekte Bestellnummern und Artikelnummern sind Voraussetzung für den automatischen Soll/Ist-Abgleich (E29/articlesCompare): Der Abgleich erfolgt anhand der Bestellnummer und Artikelnummer des Empfängers
- Bei Korrektur dieser Felder werden automatische Abweichungen zurückgesetzt, sodass ein erneuter Abgleich mit den korrigierten Daten möglich ist
- ASN-Daten (Lieferavise) werden ebenfalls über die Bestellnummer und Artikelnummer des Empfängers den Artikelpositionen zugeordnet — korrekte Werte sind daher auch für die QS-Ampel und Lagerort-Anzeige erforderlich
Abgrenzung: Drei verschiedene Bestellnummern im System
| 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) |
Alle drei Felder sind unabhängig voneinander. Diese Funktion bezieht sich ausschließlich auf articleOrderNumber auf Artikelpositionsebene.
Anzeigepriorität (Frontend und Backend):
| Priorität | Quelle | Bedingung |
|---|---|---|
| 1 (höchste) | WE-Korrektur (edits.articleOrderNumber.value) |
Wenn vorhanden und nicht leer |
| 2 | Originalwert (article.articleOrderNumber) |
Wenn vorhanden und nicht leer |
| 3 (niedrigste) | Lieferschein-Bestellnummer (orderNumber) |
Fallback, wenn kein Wert auf Artikelebene vorhanden ist |
Diese dreistufige Priorisierung wird intern auch für die ASN-Zuordnung (Lieferavise) und den automatischen Soll/Ist-Abgleich (articlesCompare) verwendet. Bei Korrektur der PO-Nummer werden automatische Abweichungen zurückgesetzt, damit ein erneuter Abgleich mit den korrigierten Daten erfolgen kann.
Information für Frontend-Nutzer
Im Reiter „Artikel & Abweichungen" sind die Felder PO-Nummer und Art-Nr. Empfänger als Spalten in der Artikeltabelle sichtbar:
PO-Nummer (articleOrderNumber): Zeigt die Bestellnummer der Position an. Wurde der Wert korrigiert, wird der korrigierte Wert angezeigt. Art-Nr. Empfänger (customerArticleNumber): Zeigt die eigene Artikelnummer des Empfängers an.
Bearbeitung:
- Über das Aktionsmenü (Drei-Punkte-Symbol) einer Artikelzeile → „Bearbeiten" öffnet sich der Bearbeitungsdialog
- Dort können die PO-Nummer und die Artikelnummer des Empfängers erfasst oder korrigiert werden
- Nach der Korrektur werden eventuell vorhandene automatische Abweichungen aus dem Soll/Ist-Abgleich zurückgesetzt
Beide Spalten können über den Spalten-Dialog ein- und ausgeblendet sowie per Drag-and-Drop in der Reihenfolge angepasst werden.
Information für API-Anbindung (fachliche Aspekte)
Die Bestellnummer und Artikelnummer des Empfängers werden über den allgemeinen Artikel-Bearbeitungsendpunkt korrigiert. Das Feature erfordert das Feature-Flag consigneeArticlesEditing.
| Methode | Pfad | Beschreibung |
|---|---|---|
| PATCH | .../consignee/articles/{articleKey}/edit | Artikelattribute teilweise korrigieren (u. a. articleOrderNumber, customerArticleNumber) |
| GET | .../delivery-notes/{deliveryNoteKey}/articles | Artikelpositionen abrufen (inkl. aktueller und korrigierter Werte im edits-Objekt) |
Die vollständige API-Spezifikation ist in der Swagger-Dokumentation unter https://app.cloud4log-addons.com/api-docs/ einsehbar.
Fachliche Einsatzmöglichkeiten in eigenen Systemen:
- Bestellzuordnung automatisieren: Bestellnummern aus dem eigenen ERP/WMS automatisiert an Artikelpositionen zuweisen, um den Soll/Ist-Abgleich (E29) vorzubereiten
- Stammdaten-Abgleich: Eigene Artikelnummern des Empfängers systematisch an die Lieferscheinpositionen anhängen, um eine durchgängige Artikelidentifikation sicherzustellen
- Korrekturen anstoßen: Bei falscher KI-Erkennung der Bestellnummer den korrekten Wert per API nachliefern — automatische Abweichungen werden daraufhin zurückgesetzt
Hinweise für Entwickler
Bestellnummer und Artikelnummer des Empfängers korrigieren:
curl -X PATCH -H "Authorization: Bearer {token}"
-H "Content-Type: application/json"
-d '{"articleOrderNumber": "PO-2026-0815", "customerArticleNumber": "ITEM-4711"}'
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/articles/{articleKey}/edit"
Hinweise:
- PATCH ist partiell: nur die übergebenen Felder werden aktualisiert
- articleOrderNumber und customerArticleNumber sind vergleichsrelevante Felder — bei Korrektur werden automatische Abweichungen aus dem Soll/Ist-Abgleich (articlesCompare) zurückgesetzt, ebenso bei Korrektur von quantity
- Die Korrektur wird historisiert: Im Response enthält das edits-Objekt pro Feld den korrigierten Wert (value), den Bearbeiter (editedBy) und den Zeitstempel (editedOn)
- Feature setzt consigneeArticlesRead (E5a) als Abhängigkeit voraus