Featureinformationen
KI-gestützte Erkennung nach dem Checkout
Nach dem Checkout eines digitalen Lieferscheins werden die enthaltenen Artikeldaten mithilfe moderner KI-Verfahren automatisch ausgelesen und in strukturierter Form bereitgestellt. Dabei werden unter anderem Artikelinformationen, Mengen und Bestellnummern erkannt und für die weitere Verarbeitung im Wareneingang verfügbar gemacht.
Der Status der KI-Auslesung ist jederzeit transparent einsehbar. Sollte die Verarbeitung fehlschlagen, kann der Auslesevorgang durch Mitarbeitende im Wareneingang einmalig erneut gestartet werden.
Fachlicher Mehrwert
Was das Feature bietet:
- Automatische Extraktion der Artikelpositionen aus PDF-Lieferscheinen mittels KI-Verfahren (Bilderkennung + OpenAI-basierte Auswertung)
- Anzeige des KI-Auslesestatus pro Lieferschein, sodass der Fortschritt der Verarbeitung transparent ist
- Bei fehlgeschlagener Auslesung kann der Mitarbeiter am Wareneingang den Vorgang einmalig manuell neu starten
- Per KI ausgelesene Artikelpositionen sind in der Artikeltabelle mit einem Roboter-Symbol gekennzeichnet
Mehrwert:
- Artikeldaten stehen strukturiert zur Verfügung, auch wenn der Warenversender keine strukturierten Daten über die API liefert, sondern nur ein PDF hochlädt
- Manuelle Abtippen von Lieferscheindaten entfällt — die KI übernimmt die Datenerfassung
- Grundlage für weiterführende Prozesse: Soll/Ist-Abgleich (A9/E29), Abweichungserfassung auf Artikelebene (E6) und Artikelnotizen (E31) können direkt auf den KI-extrahierten Daten arbeiten
- Der Wareneingang wird beschleunigt und die Datenqualität erhöht
Information für Frontend-Nutzer
Die KI-Auslesung läuft vollständig im Hintergrund. Nach dem Checkout durch den Warenversender startet die Verarbeitung automatisch.
Statusanzeige im Reiter „Artikel & Abweichungen":
- Während der Auslesung wird der aktuelle Verarbeitungsstatus angezeigt
- Nach erfolgreicher Auslesung erscheinen die Artikelpositionen in der Artikeltabelle, per KI erkannte Positionen sind mit einem Roboter-Symbol markiert
- Bei fehlgeschlagener Auslesung wird ein Fehler-Banner mit einer Beschreibung und einem Neustart-Button angezeigt. Der Neustart kann einmalig ausgelöst werden.
Hinweis: Wenn das Feature nicht für die Organisation freigeschaltet ist, wird anstelle der Artikeltabelle ein Hinweispanel mit einer Vorschau und einer Kontaktmöglichkeit zur Freischaltung angezeigt.
Information für API-Anbindung (fachliche Aspekte)
Die KI-Auslesung wird automatisch nach dem Checkout ausgelöst. Über die API kann der Auslesestatus abgefragt und bei Bedarf ein Neustart angestoßen werden.
| Methode | Pfad | Beschreibung |
|---|---|---|
| GET | /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey} | Lieferschein-Metadaten inkl. articleStage und extractionAttemptCount abrufen |
| GET | /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles | Extrahierte Artikelpositionen abrufen (nach erfolgreicher Auslesung) |
| POST | /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/extraction/restart | Fehlgeschlagene KI-Auslesung einmalig neu starten |
| Die vollständige API-Spezifikation ist in der Swagger-Dokumentation unter https://app.cloud4log-addons.com/api-docs/ einsehbar. |
KI-Auslesestatus (articleStage):
| Status | Bedeutung |
|---|---|
UNSTRUCTURED_DELIVERYNOTE |
Auslesung gestartet |
TXT_EXTRACTED |
Text aus PDF extrahiert |
IMAGES_EXTRACTED |
Bilder aus PDF extrahiert |
AI_ARTICLE_EXTRACTED |
KI-Auswertung abgeschlossen |
STRUCTURED_DELIVERYNOTE |
Artikeldaten strukturiert verfügbar |
FAILED |
Auslesung fehlgeschlagen |
Fachliche Einsatzmöglichkeiten in eigenen Systemen:
- Polling auf Auslesestatus: Über articleStage den Fortschritt der KI-Verarbeitung überwachen und bei Status STRUCTURED_DELIVERYNOTE die Artikeldaten automatisch abrufen
- Fehlerbehandlung automatisieren: Bei Status FAILED und extractionAttemptCount < 1 den Neustart-Endpunkt aufrufen
- Strukturierte Daten weiterverarbeiten: KI-extrahierte Artikelpositionen direkt in WMS/ERP-Systeme übernehmen
Hinweise für Entwickler
Verarbeitungspipeline (BullMQ):
checkout_finished Event → checkoutFinishedEventHandlerWorker (extrahiert deliveryNoteKeys) → articleExtractionPrepareWorker (PDF herunterladen, Metadaten erfassen) → ingestionWorker (PDF vorbereiten) → pdf2ImageWorker (PDF → Seitenbilder konvertieren) → OpenAI Image Worker (KI-Auswertung der Bilder) → DB Result Worker (Artikeldaten in DB speichern)
Neustart bei Fehler:
curl -X POST -H "Authorization: Bearer {token}"
"https://app.cloud4log-addons.com/api/v2/organization-sites/{siteKey}/consignee/delivery-notes/{dnKey}/extraction/restart"
Hinweise:
- Neustart ist nur möglich bei articleStage: FAILED oder bei festgefahrenen Vorgängen (>30 Minuten in Zwischenstatus) mit extractionAttemptCount < 1
- Maximal 1 Neustart pro Lieferschein — bei erneutem Fehlschlag bleibt der Status FAILED
- Per KI ausgelesene Artikel sind im Response über isAI: true gekennzeichnet
- Die Artikeldaten sind erst abrufbar, wenn die Mappe den Status sent oder closed hat