Featureinformationen
Fachlicher Mehrwert
Warenversender können die strukturierten Artikeldaten ihrer Lieferscheine per API abrufen und in ihre IT-Systeme übernehmen. Dies ist insbesondere dann nützlich, wenn der Lieferschein ursprünglich nur als PDF-Dokument hochgeladen wurde: Die im PDF enthaltenen Artikelpositionen werden durch Cloud4Log Addons mittels KI ausgelesen und als strukturierte Daten bereitgestellt.
Der Mehrwert im Einzelnen:
- Rückkanal für PDF-Lieferscheine: Warenversender, die Lieferscheine nur als PDF hochladen, erhalten die darin enthaltenen Artikeldaten als strukturierte Daten zurück -- GTIN, Artikelnummer, Menge, MHD, Chargennummer und Zertifizierungen. Diese können automatisiert in ERP- oder Warenwirtschaftssystemen weiterverarbeitet werden.
- Transparenz uber Änderungen: Die Response enthält nicht nur die ursprünglichen Artikeldaten, sondern auch alle Korrekturen und Ergänzungen, die der Wareneingang vorgenommen hat -- inklusive Änderungshistorie (wer hat wann welches Feld geändert).
- Abweichungserkennung: Pro Artikelposition ist erkennbar, ob Abweichungen vorliegen (hasDiscrepancy) und wie der automatische Mengenabgleich ausgefallen ist (automaticCompareStatus: MATCH, OVER_DELIVERED, UNDER_DELIVERED).
- Artikelnotizen: Am Artikel hinterlegte Notizen von Wareneingang und Warenausgang werden mitgeliefert, sofern diese freigegeben wurden.
Typischer Einsatz: Sie laden Ihren Lieferschein als PDF hoch, Cloud4Log liest die Artikelpositionen per KI aus, und Ihr ERP-System ruft die strukturierten Daten anschließend über die API ab -- für die automatisierte Weiterverarbeitung, den Abgleich mit Ihrer Auftragsbestätigung oder die Archivierung.
Information für Frontend-Nutzer
Im Frontend des Warenausgangs können die strukturierten Artikeldaten eingesehen werden, sofern das Feature "Anzeige strukturierter Artikeldaten im WA" ebenfalls aktiviert ist (aktuell noch nic ht implementiert). Der Warenversender sieht dort die Artikelpositionen sowie die vom Wareneingang vorgenommenen Änderungen und Notizen. Das Abrufen der Daten zur automatisierten Weiterverarbeitung in eigenen IT-Systemen erfolgt ausschließlich über die API.
Information für API-Anbindung (fachliche Aspekte)
Endpunkt
| Methode | Pfad | Feature-Flag | Beschreibung |
|---|---|---|---|
| GET | .../delivery-notes/{deliveryNoteKey}/articles | consignorArticlesRead | Alle Artikelpositionen eines Lieferscheins abrufen |
Der Endpunkt ist in der Swagger-Dokumentation der Produktionsumgebung unter https://app.cloud4log-addons.com/api-docs/ vollstandig dokumentiert.
Hinweis: Der Pfad enthalt kein /consignor/-Prefix. Die Zugriffsberechtigung wird intern anhand der Rolle und des Feature-Flags geprüft.
Fachliche Verwendung in eigenen Systemen
Der Endpunkt kann genutzt werden, um die strukturierten Artikeldaten nach dem Versandprozess automatisiert in die eigenen IT-Systeme zu übernehmen. Typische Einsatzszenarien:
- Automatischer Datenrückfluss ins ERP: Nach dem Checkout oder nach Abschluss der Mappe werden die Artikeldaten -- inklusive KI-ausgelesener Positionen und WE-Korrekturen -- per API abgerufen und im ERP-System als Versandbestätigung oder Wareneingangsdaten verbucht.
- Abweichungsmonitoring: Das Feld hasDiscrepancy und automaticCompareStatus je Artikelposition ermöglichen ein automatisiertes Monitoring von Mengenabweichungen im eigenen System, ohne dass ein Mitarbeiter die Plattform manuell prüfen muss.
- Reklamationsmanagement: Die Änderungshistorie (edits) zeigt pro Feld den Original- und den korrigierten Wert, wer die Änderung vorgenommen hat und wann. Diese Daten können als Nachweis in Reklamationsprozessen verwendet werden. Die Artikeldaten sind fur den Warenversender erst abrufbar, wenn die Mappe den Status sent oder closed hat.
Wichtige Response-Felder
| Feld | Beschreibung |
|---|---|
| isAI | true, wenn die Position per KI aus dem PDF ausgelesen wurde |
| edits | Änderungshistorie pro Feld (Original → korrigierter Wert, editedBy, editedOn) |
| hasDiscrepancy | Abweichung auf dieser Artikelposition vorhanden |
| automaticCompareStatus | Ergebnis des Soll-/Ist-Mengenabgleichs (MATCH, OVER_DELIVERED, UNDER_DELIVERED) |
| checked | Vom WE als kontrolliert markiert |
| articleNotes | Freigegebene Notizen von WA und WE |
Hinweise für Entwickler
Anbindung
Lieferschein-Key ermitteln: Über die Cloud4Log Basic-API (GET .../consignor/delivery-notes) den deliveryNoteKey des gewünschten Lieferscheins abrufen. Artikeldaten abrufen: GET-Request mit Bearer-Token an den Endpunkt senden. Daten verarbeiten: Die Response enthält ein JSON-Array aller Artikelpositionen mit den oben genannten Feldern.
Beispiel-Request
curl -s
-H "Authorization: Bearer ${TOKEN}"
"https://app.cloud4log-addons.com/api/v2/organization-sites/{orgSiteKey}/delivery-notes/{dnKey}/articles"
Hinweise
- Die Artikeldaten sind für den Consignor erst lesbar, wenn die Mappe im Status sent oder closed ist.
- Der Endpunkt liefert sowohl vom WA hochgeladene als auch per KI ausgelesene Artikelpositionen -- unterscheidbar über das Feld isAI.
- Das Feld edits enthalt nur dann Daten, wenn der Wareneingang Korrekturen vorgenommen hat. Jedes editierte Feld enthalt den neuen Wert, den Zeitpunkt und den Bearbeiter.