Featureinformationen
Fachlicher Mehrwert
- Höchste Datenqualität: Die Artikeldaten kommen direkt aus dem Quellsystem -- Artikelnummer, GTIN, Menge, Verpackungsart, Chargennummer, Mindesthaltbarkeitsdatum und Zertifizierungen (Bio, QS, Naturland, GQB) werden präzise übertragen, ohne manuelle Erfassung oder KI-Auslesung.
- Prozessautomatisierung: Der Upload kann vollautomatisiert in bestehende Versand-Workflows integriert werden. Sobald ein Lieferschein in Cloud4Log angelegt ist, können die zugehörigen Artikelpositionen per API hinzugefugt werden.
- Beschleunigung: Die Artikeldaten stehen dem Wareneingang sofort zur Verfugung -- ohne Wartezeit auf eine KI-Auslesung des PDF-Lieferscheins.
- Durchgängige Lieferkette: Die bereitgestellten Artikeldaten fließen in alle nachgelagerten Prozesse ein: der Wareneingang kann Abweichungen auf Artikelebene erfassen, der automatische Soll/Ist-Mengenabgleich (Articles Compare) arbeitet mit den gelieferten Daten, und das Gesamtdokument PDF enthält die Artikelnotizen.
Information für Frontend-Nutzer
Dieses Feature ist ein reines API-Feature fur die Rolle Warenversender. Der Upload der strukturierten Artikeldaten erfolgt ausschließlich über die API -- es gibt keine manuelle Upload-Funktion im Frontend. Im Frontend des Warenausgangs sind die hochgeladenen Artikeldaten nach dem Upload sichtbar und können dort vor dem Checkout eingesehen und bei Bedarf korrigiert werden.
Information für API-Anbindung (fachliche Aspekte)
Endpunkte
| Methode | Pfad | Feature-Flag | Beschreibung |
|---|---|---|---|
| POST | .../consignor/delivery-notes/{deliveryNoteKey}/articles | consignorArticlesEditing | Artikelpositionen zu einem Lieferschein hinzufügen |
| DELETE | .../consignor/delivery-notes/{deliveryNoteKey}/articles/{articleKey} | consignorArticlesEditing | Einzelne Artikelposition entfernen |
Die für dieses Feature relevanten Endpunkte sind in der Swagger-Dokumentation der Produktionsumgebung unter https://app.cloud4log-addons.com/api-docs/ vollständig dokumentiert.
Fachliche Verwendung in eigenen Systemen
Der Upload-Endpunkt kann in ERP-, WMS- oder anderen Warenwirtschaftssystemen eingesetzt werden, um die Artikelpositionen eines Lieferscheins automatisiert an Cloud4Log Addons zu übermitteln. Typische Einsatzszenarien:
- Automatisierter Versandprozess: Nach dem Anlegen eines Lieferscheins in Cloud4Log werden die zugehörigen Artikelpositionen aus dem ERP-System per API hinzugefugt -- als fester Bestandteil des Versand-Workflows.
- Stammdatenbasierte Artikeldaten: Die Artikeldaten (GTIN, Artikelnummer, Menge, MHD, Chargennummer, Zertifizierungen) kommen direkt aus den Stammdaten des Versenders. Damit entfallt die Fehler anfällige KI-Auslesung von PDF-Dokumenten.
- Korrekturen vor dem Checkout: Einmal hochgeladene Artikelpositionen können über den DELETE-Endpunkt entfernt und anschließend mit korrigierten Daten neu hochgeladen werden, solange die Mappe noch nicht versendet wurde.
Der Upload ist nur möglich, solange der Lieferschein im Status open ist oder noch keiner Mappe zugeordnet wurde. Nach dem Versenden (sent) oder Abschließen (closed) der Mappe sind keine Änderungen mehr möglich.
Hinweise für Entwickler
Anbindung
Lieferschein anlegen (uber die Cloud4Log Basic-API) und den deliveryNoteKey erhalten. Artikelpositionen hochladen: POST-Request mit einem JSON-Array der Artikelpositionen an den Endpunkt senden. Optional: Einzelne Positionen bei Bedarf uber den DELETE-Endpunkt entfernen und korrigiert neu hochladen.
Beispiel-Request
curl -X POST
-H "Authorization: Bearer ${TOKEN}"
-H "Content-Type: application/json"
-d '[
{
"index": 1,
"articleNumber": "ART-2024-001",
"description": "Bio-Apfel Elstar",
"quantity": 120,
"containerType": "Karton",
"gtin": "4012345678901",
"organic": true,
"batchNumber": "CH-2026-0815",
"dateExpired": 1788220800000,
"countryOfOrigin": "DE"
}
]' \ "https://app.cloud4log-addons.com/api/v2/organization-sites/{orgSiteKey}/consignor/delivery-notes/{dnKey}/articles"
Hinweise
- Die Pflichtfelder pro Artikelposition sind: index, articleNumber, description, quantity und containerType.
- dateExpired wird als UNIX-Timestamp in Millisekunden erwartet.
- Der Endpunkt gibt bei Erfolg die angelegten Artikel mit ihren generierten _key-Werten zuruck.
- Bereits vorhandene Artikelpositionen werden nicht überschrieben -- bei erneutem Aufruf werden zusätzliche Positionen angelegt. Zum Korrigieren: zuerst per DELETE entfernen, dann neu hochladen.