Erweiterte Zusatzdaten zum PDF-Lieferschein

Fachlicher Mehrwert

Was enthält das Gesamtdokument?

Das Lieferschein-Gesamtdokument fasst sämtliche Informationen zu einem Lieferschein in einer einzigen, zusammenhängenden PDF-Datei zusammen. Es entsteht automatisch im Hintergrund und steht Ihnen in der Anwendung per Klick zum Download bereit. Das Dokument vereint alle Bestandteile, die im Verlauf eines Liefervorgangs anfallen -- in einer festen Reihenfolge:

Inhalte des Gesamtdokuments

• Original-Lieferschein: das PDF, das Sie hochgeladen haben.
• Anhänge und Fotos aus dem Warenausgang, z. B. Ladebilder, Beipackzettel oder sonstige Dokumente, die Sie beim Checkout beigefügt haben.
• Ladungsträger-Informationen, die beim Checkout erfasst wurden.
• Unterschriften aus dem Warenausgang, einschließlich Fahrer-Unterschrift und ggf. Spediteur-Unterschrift beim Checkout.
• Fotos und Dokumente aus dem Wareneingang, z. B. Ladungsträger-Bilder, Abweichungsfotos, Quittungen und Palettenscheine des Empfängers.
• Unterschriften aus dem Wareneingang, einschließlich Fahrer-Unterschrift und Empfänger-Unterschrift beim Checkin.
• Dokumentierte Abweichungen mit Grund, Menge und Notiz.
• Kontrollseite als Addons-Erweiterung auf der letzten Seite des Dokuments.

Das Gesamtdokument PDF für den Warenausgang in C4L Addons enthält neben den Informationen wie in C4L weitere Zusatzinformationen die nur in C4L Addons erfasst werden. Dazu zählen:

• Erweiterte QS-Prüfszenarien: Ergebnisse der Zertifizierungsprüfungen für Bio, Naturland, QS und GQB -- auf einen Blick erkennbar, ob die jeweilige Prüfung durchgeführt wurde.
• Artikelnotizen: Am Warenausgang auf Artikelebene erfasste Notizen werden direkt im PDF dargestellt -- inklusive Artikelposition, Artikelnummer und Beschreibung.

Das Addons Gesamtdokument PDF ergänzt somit das Standard-PDF aus C4L (Lieferschein, Anlagen, Unterschriften, Bilder) um eine zusätzliche Kontrollseite mit allen Addons-spezifischen Daten. Dies ermöglicht eine vollständige Dokumentation des Warenausgangs in einem einzigen Dokument -- ideal für die Archivierung, den Versand an Geschäftspartner oder die interne Qualitätssicherung.

Wann ist das Gesamtdokument verfügbar?

Das Dokument wird dynamisch beim Abruf zusammengestellt. Es enthält immer den aktuellen Stand -- auch wenn der Wareneingang nachträglich Daten ergänzt hat. Die Kontrollseite ist nur enthalten, wenn Ihr Unternehmen das Addons-Feature aktiviert hat. Andernfalls erhalten Sie das Standard-Gesamtdokument ohne Kontrollseite.

Information für Frontend-Nutzer

Ist das Feature für die Organisation aktiviert, wird das erweiterte Addons PDF automatisch anstelle des Standard-PDFs geladen. Nutzer müssen nichts zusätzlich konfigurieren oder aktivieren -- der Austausch erfolgt transparent an allen Stellen, an denen das PDF angezeigt oder heruntergeladen werden kann:

• Checkout-Ansicht: Beim Klick auf einen Lieferschein in der Checkout-Sektion wird das Addons Merged PDF in der PDF-Vorschau angezeigt.
• Lieferschein-Tabelle: In der Lieferschein-Übersicht des Warenausgangs wird beim Anzeigen eines Lieferscheins das erweiterte PDF geladen.
• Download-Button: Beim Herunterladen eines Lieferscheins als PDF wird automatisch die Addons-Version mit der zusätzlichen Kontrollseite verwendet.

Die letzte Seite des PDFs ist die Addons-Kontrollseite mit den QS-Prüfergebnissen und den Artikelnotizen.

Information für API-Nutzer

Endpunkt

Methode	Pfad	Feature-Flag
GET	/organization-sites/{organizationSiteKey}/consignor/delivery-notes/{deliveryNoteKey}/complete-pdf	consignorCompletePdf

Die vollständige technische Dokumentation dieses Endpunkts (Parameter, Response-Schema, Fehlercodes) finden Sie in der Swagger-Dokumentation der Produktionsumgebung unter https://app.cloud4log-addons.com/api-docs/.

Einsatzmöglichkeiten in eigenen Systemen

Das Addons Merged PDF kann in eigenen Frontends, ERP-Systemen oder Drittsystemen als konsolidiertes Gesamtdokument pro Lieferschein genutzt werden. Typische Anwendungsfalle:

• Archivierung und Revisionssicherheit: Das PDF enthalt alle relevanten Informationen eines Warenausgangs in einem einzigen Dokument -- Lieferscheindaten, Anlagen, Unterschriften, Bilder sowie die zusätzlichen QS-Prüfungsergebnisse (Bio, Naturland, QS, GQB) und Artikelnotizen. Es kann direkt in ein DMS oder eine digitale Akte übernommen werden.
• Weiterleitung an Geschäftspartner: Das Dokument eignet sich zum automatisierten Versand an Warenempfänger oder Spediteure, z.B. als E-Mail-Anhang oder über ein Partnerportal. Empfänger erhalten so alle Checkout-Informationen inklusive der Addons-spezifischen Prüfungen ohne eigenen C4L-Zugang.
• Interne Qualitätssicherung: Die auf der letzten Seite zusammengefassten Zertifizierungsprüfungen (Bio, Naturland, QS, GQB) und Artikelnotizen können als Nachweis fur interne Auditprozesse dienen. -** Integration in Warenausgangsprozesse**: Der Endpunkt kann in bestehende WMS- oder ERP-Workflows eingebunden werden, um nach dem Checkout automatisch das vollständige PDF abzurufen und weiterzuverarbeiten.

Der Endpunkt liefert das PDF als fertiges Dokument (application/pdf) -- es ist keine weitere Verarbeitung oder Zusammenführung durch das aufrufende System erforderlich.

Hinweise für Entwickler

Anbindung

Der Endpunkt verhält sich wie ein einfacher PDF-Download. Ablauf:

1. Prüfen, ob das Feature consignorCompletePdf für den Standort aktiv ist (Feld consignorCompletePdf in der Feature-Flag-Konfiguration des Standorts).
2. GET-Request mit gültigem Bearer-Token an den Endpunkt senden.
3. Die Response enthält das PDF als Binary-Body (application/pdf). Der vorgeschlagene Dateiname steht im Content-Disposition-Header. Beispiel curl -s
     -H "Authorization: Bearer ${TOKEN}"
     "https://{host}/organization-sites/{orgSiteKey}/consignor/delivery-notes/{dnKey}/complete-pdf"
     -o lieferschein.pdf

 

Hinweise

• Der Endpunkt liefert immer das vollständige Merged PDF (Basis + Addons-Seite). Es gibt keine Option, nur die Addons-Kontrollseite separat abzurufen.
• Hinweis zum Abrufzeitpunkt: Das Dokument wird bei jedem Abruf dynamisch zusammengestellt. Es enthält immer den aktuellsten Stand aller Informationen -- auch wenn der Wareneingang nachträglich Fotos, Abweichungen oder Prüfvermerke ergänzt hat. Wir empfehlen, das Gesamtdokument erst nach Abschluss des Checkin-Prozesses abzurufen, um die vollständigen Informationen zu erhalten.