Reporting für Wareneingangsprozesse

Cloud4Log Addons stellt für den Wareneingang umfangreiche Reporting-Funktionen bereit. Unternehmens- und Standortadministratoren können verschiedene Reports zu Lieferscheinen, Artikeldaten, Abweichungen und Ladungsträgerbewegungen als CSV-Dateien herunterladen und für Analysen, Audits oder die Weiterverarbeitung in anderen Systemen nutzen.

Die Reports stehen für einen Zeitraum von bis zu zehn Wochen zur Verfügung und ermöglichen eine detaillierte Auswertung der Wareneingangsprozesse sowie aller im Rahmen der Cloud4Log Addons erfassten Informationen.

Fachlicher Mehrwert

Was bietet das erweiterte Reporting?

Das erweiterte Reporting stellt umfassende, strukturierte Berichte über sämtliche Wareneingangsprozesse als CSV-Dateien bereit.

Über einen frei wählbaren Zeitraum (bis zu 35 Tage) werden alle relevanten Informationen zu Lieferscheinen, Artikelpositionen, Abweichungen und Ladungsträgern gebündelt als ZIP-Archiv exportiert – bereit zur Weiterverarbeitung in Excel, Business-Intelligence-Systemen oder ERP-Lösungen.

Welche Berichte sind enthalten?

Das ZIP-Archiv enthält fünf spezialisierte CSV-Reports, die gemeinsam ein vollständiges Bild der Wareneingangsprozesse liefern:

Report	Inhalt	Typischer Anwendungsfall
Basisreport	Stammdaten aller Lieferscheine inklusive Status, Lieferkette, Zeitstempel und Zertifizierungsprüfungen	Gesamtüberblick, SLA-Monitoring, Compliance-Nachweis
Artikelreport	Alle Artikelpositionen mit Detaildaten, Prüfstatus und vollständiger Änderungshistorie	Qualitätssicherung, Artikelanalyse, Rückverfolgbarkeit
Abweichungsreport	Erfasste Abweichungen auf Artikelebene mit Grund, Menge und Anmerkungen	Reklamationsmanagement, Lieferantensteuerung
Ladungsträger Versender	Vom Versender gemeldete Ladungsträger mit Typ, Menge und Beschädigungsstatus	Ladungsträgerbilanz, Pooling-Abgleich
Ladungsträger Empfänger	Vom Empfänger erfasste Ladungsträger mit Typ, Menge und Beschädigungsstatus	Gegenkontrolle, Schwundanalyse

Mehrwert für das nutzende Unternehmen

• Zentrale Datenbasis: Alle Wareneingangsinformationen eines Standorts in einem standardisierten Format – kein manuelles Zusammentragen aus verschiedenen Quellen.
• Zeitraumbasierte Auswertung: Flexible Analyse beliebiger Zeiträume (bis 35 Tage) ermöglicht Tages-, Wochen- und Monatsreporting.
• Lückenlose Rückverfolgbarkeit: Der Artikelreport dokumentiert nicht nur den aktuellen Stand, sondern die vollständige Änderungshistorie – welcher Wert wurde wann korrigiert.
• Qualitätskontrolle und Compliance: Zertifizierungsprüfungen (Bio, Naturland, QS, GQB) werden pro Lieferschein ausgewiesen – sowohl die manuelle Prüfung als auch der KI-gestützte Status.
• Lieferantensteuerung: Abweichungen und deren Häufigkeit sind pro Lieferschein und Artikel auswertbar – Grundlage für Lieferantengespräche und Verbesserungsmaßnahmen.
• Ladungsträger-Transparenz: Versand- und Empfangsdaten der Ladungsträger werden getrennt reportet – Differenzen und Beschädigungen sind auf einen Blick erkennbar.
• ERP-Integration: Das CSV-Format ermöglicht eine direkte Übernahme in SAP, Microsoft Dynamics, Oracle oder andere ERP- und BI-Systeme.
• Dynamische Metadaten: Unternehmensspezifische Zusatzdaten, die über die Metadaten-API an Lieferscheine angehängt wurden, erscheinen automatisch als zusätzliche Spalten im Basisreport.

Information für Frontend-Nutzer

Voraussetzungen

• Rolle: Standort-Admin oder Organisations-Admin
• Feature „Erweitertes Reporting“ muss für die Organisation freigeschaltet sein.
• Ohne Freischaltung erscheint der Hinweis:

„WE Erweitertes Reporting nicht verfügbar – Die Erweiterung ist in Ihrer Organisation derzeit nicht freigeschaltet. Sie können WE Erweitertes Reporting jederzeit dazubuchen!“

Schritt-für-Schritt-Anleitung

1. Navigieren Sie im Admin-Bereich zum Menüpunkt „Berichte“ in der linken Seitennavigation.

2. Sie sehen die Seite „Berichte generieren“ mit folgendem Beschreibungstext:

   „Generieren Sie Berichte zu den relevanten Vorgängen als .zip-Datei für den angegebenen Zeitraum.“

3. Wählen Sie im Dropdown „Standort“ den gewünschten Standort aus („Standort auswählen“).

4. Legen Sie unter „Zeitspanne (max. 35 Tage)“ den gewünschten Zeitraum fest.

5. Beachten Sie dabei:

   • Start- und Enddatum im Format dd.mm.yyyy
   • Der Zeitraum darf maximal 35 Tage umfassen.
   • Das Startdatum darf maximal 10 Wochen in der Vergangenheit liegen.

6. Klicken Sie auf „Generiere alle Berichte“, um das ZIP-Archiv mit allen fünf CSV-Reports herunterzuladen.

7. Die heruntergeladene Datei trägt den Namen:

{Organisationsname}_{Standortname}_reportData_{Startdatum}_{Enddatum}.zip

Validierungshinweise

Fehlermeldung	Ursache
„Der Zeitraum darf maximal 35 Tage betragen.“	Start- und Enddatum liegen mehr als 35 Tage auseinander
„Das Startdatum darf maximal 10 Wochen zurückliegen.“	Das gewählte Startdatum liegt zu weit in der Vergangenheit

Inhalt der ZIP-Datei

Das Archiv enthält fünf CSV-Dateien, jeweils nach folgendem Muster benannt:

{Standortname}_{Berichtstyp}_{Startdatum}_{Enddatum}.csv

Beispiel für den Standort „Berlin Lager 1“ im Zeitraum 01.01.2026 bis 31.01.2026:

Berlin_Lager_1_basicReport_2026-01-01_2026-01-31.csv
Berlin_Lager_1_articlesReport_2026-01-01_2026-01-31.csv
Berlin_Lager_1_discrepanciesReport_2026-01-01_2026-01-31.csv
Berlin_Lager_1_loadCarrierConsignorReport_2026-01-01_2026-01-31.csv
Berlin_Lager_1_loadCarrierConsigneeReport_2026-01-01_2026-01-31.csv

Hinweis: Es werden nur Lieferscheine mit dem Status „versendet“ oder „geschlossen“ in die Reports aufgenommen. Lieferscheine im Status „offen“ sind nicht enthalten.

Vollständige Attributlisten

Basisreport (basicReport)

Enthält pro Zeile einen Lieferschein mit allen Stamm- und Prozessdaten.

#	Spalte	Beschreibung
1	delivery_note_key	Eindeutiger technischer Schlüssel des Lieferscheins
2	delivery_note_number	Lieferscheinnummer
3	delivery_note_order_number	Bestellnummer des Lieferscheins
4	consignee_order_number	Eigene Bestellnummer des Warenempfängers
5	status	Aktueller Status (sent, closed)
6	delivery_note_date_announced	Avisiertes Lieferdatum
7	user_role_consignor	Standort hat Versender-Rolle
8	user_role_carrier	Standort hat Spediteur-Rolle
9	user_role_consignee	Standort hat Empfänger-Rolle
10	original_consignor	Name des Original-Versenders
11	consignor_name	Name des Versenders
12	carrier_name	Name des Spediteurs
13	consignee_name	Name des Warenempfängers
14	timestamp_driver_signature_in_consignor	Fahrer-Unterschrift beim Versender
15	timestamp_consignee_signature	Unterschrift des Warenempfängers
16	timestamp_driver_signature_in_consignee	Fahrer-Unterschrift beim Empfänger
17	timestamp_self_checkin_driver_registration	Self-Check-in des Fahrers
18	organic_certification_number	Bio-Prüfung manuell
19	naturland_certification_number	Naturland-Prüfung manuell
20	qs_certification_number	QS-Prüfung manuell
21	gqb_certification_number	GQB-Prüfung manuell
22	organic_certification_number_ai	Bio-Prüfung KI
23	naturland_certification_number_ai	Naturland-Prüfung KI
24	qs_certification_number_ai	QS-Prüfung KI
25	gqb_certification_number_ai	GQB-Prüfung KI
26+	Dynamische Metadaten-Spalten	Unternehmensspezifische Zusatzdaten

Hinweis: Die Spalten ab Position 26 sind dynamisch und werden automatisch aus den über die Metadaten-API bereitgestellten Daten erzeugt.

Artikelreport (articlesReport)

Enthält pro Zeile eine Artikelposition inklusive vollständiger Änderungshistorie.

Basis-Spalten (1–26):

• Lieferscheinreferenz
• Bestell- und Artikeldaten
• Verpackungsinformationen
• Zertifizierungsinformationen
• Prüfstatus
• KI-/Manuell-Kennzeichen
• Historie für hinzugefügte bzw. entfernte Artikel

Änderungshistorie-Spalten (27–58):

Für jedes bearbeitbare Feld werden zwei Spalten erstellt:

• <feld>_value
• <feld>_edited_on

Beispiele:

• article_number_value
• article_number_edited_on
• batch_number_value
• batch_number_edited_on
• customer_article_number_value
• customer_article_number_edited_on
• quantity_value
• quantity_edited_on
• organic_value
• organic_edited_on
• naturland_value
• naturland_edited_on
• qs_value
• qs_edited_on
• gqb_value
• gqb_edited_on

Abweichungsreport (discrepanciesReport)

Enthält pro Zeile eine erfasste Abweichung auf Artikelebene.

Spalten:

1. delivery_note_key
2. delivery_note_number
3. delivery_note_order_number
4. date_created
5. article
6. reason
7. number
8. unit
9. note

Abweichungen werden nur für Lieferscheine mit Status „geschlossen“ reportet.

Ladungsträger Versender (loadCarrierConsignorReport)

Enthält pro Zeile einen vom Versender gemeldeten Ladungsträger.

Spalten:

1. delivery_note_key
2. delivery_note_number
3. delivery_note_order_number
4. name
5. operation
6. quantity
7. damaged
8. notice

Ladungsträger Empfänger (loadCarrierConsigneeReport)

Identische Struktur wie der Versender-Report, jedoch mit den vom Warenempfänger erfassten Daten.

Information für API-Anbindung (fachliche Aspekte)

Endpunktübersicht

Für das erweiterte Reporting steht ein zentraler Add-ons-Endpunkt zur Verfügung:

GET /api/v2/administration/organization-sites/{organizationSiteKey}/delivery-notes/reports/csv

Eigenschaft	Wert
System	Add-ons
Feature Flag	csvReporting
Antwort	ZIP mit 5 CSV-Dateien

Abgrenzung zu Cloud4Log Basic

Cloud4Log Basic bietet unter demselben Pfadmuster einen deutlich einfacheren Basisreport an.

Aspekt	Add-ons-Endpunkt	Basic-Endpunkt
Backend	Cloud4Log Addons	Cloud4Log Basic
Feature Flag	csvReporting	keines
Output	ZIP mit 5 CSV-Reports	einzelne CSV-Datei
Inhalt	Stammdaten, Artikel, Abweichungen, Ladungsträger, Metadaten	nur Stammdaten
Änderungshistorie	Ja	Nein
Zertifizierungen	Ja	Nein
Dynamische Metadaten	Ja	Nein

Endpunkt-Details

Request-Parameter

Parameter	Ort	Typ	Pflicht	Beschreibung
organizationSiteKey	Pfad	String	Ja	Schlüssel des Standorts
from	Query	Integer	Ja	Beginn des Zeitraums
to	Query	Integer	Ja	Ende des Zeitraums

Einschränkungen

• Maximaler Zeitraum: 35 Tage
• Zeitstempel in UTC-Millisekunden
• Rolle: Standort-Admin oder Organisations-Admin
• Feature Flag csvReporting muss aktiv sein

Antworten

• 200 OK → ZIP-Datei mit fünf CSV-Dateien
• 400 Bad Request → Ungültiger Zeitraum
• 403 Forbidden → Fehlende Berechtigung oder Feature deaktiviert

Beispielaufruf

curl -X GET \
  -H "Authorization: Bearer ${TOKEN}" \
  -o report.zip \
  "https://app.cloud4log-addons.com/api/v2/administration/organization-sites/12345/delivery-notes/reports/csv?from=1735689600000&to=1738368000000"

Hinweise für Entwickler

Anbindung in Kürze

Das erweiterte Reporting ist über einen einzigen GET-Endpunkt im Add-ons-Backend verfügbar.

Die Authentifizierung erfolgt per OAuth 2.1 Bearer Token.

Basis-URL

Produktion

https://app.cloud4log-addons.com

Test

https://test.dls.addons.cloud4log.dev

Request

GET /api/v2/administration/organization-sites/{organizationSiteKey}/delivery-notes/reports/csv?from={timestampMs}&to={timestampMs}

Authorization: Bearer <ACCESS_TOKEN>
Accept: application/zip

Response

• HTTP 200 mit Content-Type: application/zip
• ZIP enthält 5 CSV-Dateien
• UTF-8 Format
• Komma als Trennzeichen
• Header-Zeile vorhanden

Hinweise zur Integration

• Zeitstempelberechnung: Alle Zeitstempel werden in UTC-Millisekunden übergeben.
• ZIP-Verarbeitung: In vielen HTTP-Clients muss arraybuffer oder blob verwendet werden.
• CSV-Parsing: Standard-CSV-Parser wie PapaParse, Apache Commons CSV oder Python csv können direkt eingesetzt werden.
• Dynamische Spalten: Die Spaltenanzahl des Basisreports ist variabel und sollte immer über die Header-Zeile ausgewertet werden.
• Automatisierung: Für regelmäßige Auswertungen empfiehlt sich ein Cronjob mit rollierendem Zeitraum. Die M2M-Authentifizierung (Client-Credentials-Flow) eignet sich hierfür.