Featureinformationen
Fachlicher Mehrwert
Mit diesem Feature können Unternehmens- und Standortadministratoren detaillierte Reports zu ihren Lieferscheinen als ZIP-Datei mit mehreren CSV-Dateien herunterladen. Die Reports umfassen alle relevanten Prozessdaten der letzten 10 Wochen und ermöglichen eine verbesserte Nachverfolgbarkeit und Analyse. Das ZIP-Archiv enthalt fünf separate CSV-Reports: Markdown
| CSV-Datei | Inhalt |
|---|---|
| basicReport | Lieferschein-Stammdaten: Nummern, Status, Beteiligte (WA/SP/WE), Unterschriften-Zeitstempel, QS-Prüfungsergebnisse (Bio, Naturland, QS, GQB – sowohl manuell als auch KI-erkannt), unternehmensspezifische Metadaten (A6n) |
| articlesReport | Artikelpositionen: GTIN, Bezeichnung, Menge, Verpackungsart, MHD, Chargennummer, Zertifizierungen, Prüfstatus, Abweichungsflag, KI-Kennzeichnung, manuelle Ergänzungen/Entfernungen, vollständige Änderungshistorie pro Feld |
| discrepanciesReport | Abweichungen auf Lieferscheinebene: Artikel, Grund, Menge, Einheit, Notiz |
| loadCarrierConsignorReport | Ladungsträgertausch Warenausgang: Bezeichnung, Operation, Menge, Beschädigungen, Bemerkungen |
| loadCarrierConsigneeReport | Ladungsträgertausch Wareneingang: gleiche Struktur wie Consignor-Report |
Alle CSV-Dateien sind über delivery_note_key, delivery_note_number und delivery_note_order_number verknüpfbar und können so in Excel, BI-Tools oder ERP-Systemen zusammengeführt und ausgewertet werden.
Information für Frontend-Nutzer
Der CSV-Export ist im Admin-Panel unter dem Bereich Reports verfügbar. Dort können Unternehmens- und Standortadministratoren den Report herunterladen:
- Standort wählen: Aus der Liste der eigenen Standorte den gewünschten Standort auswählen.
- Zeitraum festlegen: Start- und Enddatum wählen. Der Zeitraum darf maximal 35 Tage umfassen und das Startdatum darf nicht mehr als 10 Wochen in der Vergangenheit liegen.
- Report-Typ wählen: Den Eintrag "Alle Reports" auswahlen (ZIP mit allen fünf CSV-Dateien).
- Herunterladen: Der Download liefert eine ZIP-Datei mit dem Dateinamen {Unternehmen}{Standort}reportData{von}{bis}.zip.
Es werden nur Lieferscheine berücksichtigt, deren Mappe bereits versendet oder abgeschlossen wurde (Status sent oder closed). Offene Mappen sind nicht enthalten.
Berechtigung: Der Export steht ausschließlich Nutzern mit der Rolle Unternehmensadministrator oder Standortadministrator zur Verfügung.
Information für API-Anbindung (fachliche Aspekte)
Endpunkt
| Methode | Pfad | Feature-Flag | Beschreibung |
|---|---|---|---|
| GET | .../administration/organization-sites/{organizationSiteKey}/delivery-notes/reports/csv | csvReporting | CSV-Reports als ZIP-Datei herunterladen |
Der Endpunkt ist in der Swagger-Dokumentation der Produktionsumgebung unter https://app.cloud4log-addons.com/api-docs/ vollständig dokumentiert.
Query-Parameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| from | number | Startdatum als UNIX-Timestamp in Millisekunden (inklusiv) |
| to | number | Enddatum als UNIX-Timestamp in Millisekunden (exklusiv) |
Fachliche Verwendung in eigenen Systemen
Der Endpunkt kann genutzt werden, um die CSV-Reports regelmaessig und automatisiert in die eigenen Systeme zu integrieren. Typische Einsatzszenarien:
- Automatisiertes Reporting: Der Endpunkt kann per Cronjob oder Scheduler periodisch aufgerufen werden, um wöchentliche oder tägliche Reports automatisch in ein BI-System oder Data Warehouse zu laden.
- Qualitatsauswertung: Der articlesReport enthält pro Artikelposition den Prufstatus, Abweichungsflag und Zertifizierungen -- ideal fur systematische Qualitätsanalysen über alle Lieferungen hinweg.
- Ladungstrager-Abgleich: Die beiden Ladungsträger-Reports ermöglichen einen Soll/Ist-Abgleich des Palettenkontos zwischen Warenausgang und Wareneingang.
- Abweichungsmonitoring: Der discrepanciesReport kann in Reklamationssysteme eingespeist werden, um Abweichungen systematisch nachzuverfolgen.
Einschränkung: Der maximale Zeitraum pro Abruf beträgt 35 Tage. Für längere Zeitraume müssen mehrere Abrufe erfolgen. Daten sind bis zu 10 Wochen in die Vergangenheit verfügbar.
Hinweise für Entwickler
Anbindung
- Token beschaffen: Bearer-Token mit einer Rolle organization_admin oder site_admin fur den gewünschten Standort.
- Zeitraum berechnen: from und to als UNIX-Timestamps in Millisekunden. Differenz darf maximal 35 Tage (3.024.000.000 ms) betragen.
- ZIP herunterladen: GET-Request an den Endpunkt. Die Response ist ein ZIP-Archiv (application/zip).
- CSV-Dateien entpacken und verarbeiten: Das ZIP enthält fünf CSV-Dateien, alle uber delivery_note_key verknüpfbar.
Beispiel-Request
Letzte 7 Tage abrufen
FROM=$(date -d '7 days ago' +%s)000
TO=$(date +%s)000
curl -s
-H "Authorization: Bearer ${TOKEN}"
"https://app.cloud4log-addons.com/api/v2/administration/organization-sites/{orgSiteKey}/delivery-notes/reports/csv?from=${FROM}&to=${TO}"
-o report.zip
Hinweise
- Nur Lieferscheine mit Mappen-Status sent oder closed sind in den Reports enthalten.
- Die CSV-Dateien verwenden Komma als Trennzeichen, alle Felder sind in Anführungszeichen eingeschlossen.
- Zeitstempel in den CSVs sind im Format dd.MM.yyyy HH:mm:ss (deutsche Lokalisierung).
- Wenn für den gewünschten Zeitraum keine Daten vorliegen, wird eine leere Response geliefert.