Erweiterte Lieferscheindokumentation

Cloud4Log Addons erweitert die Original-Lieferscheine im PDF-Format um zusätzliche Informationen aus dem Wareneingangsprozess. Neben den bereits in Cloud4Log enthaltenen Informationen wie Ladungsträgern, Abweichungen, Unterschriften und ergänzenden Dokumenten werden auch die in den Add-ons erfassten Daten dokumentiert.

Dazu gehören beispielsweise erweiterte Qualitäts- und Zertifizierungsprüfungen, artikelbezogene Notizen sowie weitere Informationen aus den Zusatzfunktionen für den Wareneingang. Alle relevanten Informationen stehen dadurch gemeinsam mit dem Lieferschein in einer zentralen Dokumentation zur Verfügung.

Fachlicher Mehrwert

Mit der erweiterten Lieferscheindokumentation werden zusätzlich zu den im Basic-System enthaltenen Lieferschein- und Wareneingangsinformationen auch die im Add-on erfassten Zusatzinformationen in das PDF aufgenommen.

Dazu gehören insbesondere:

• Ergebnisse erweiterter Qualitäts- und Zertifizierungsprüfungen
• Notizen auf Artikelebene
• Weitere im Add-on erfasste Prüf- und Dokumentationsinformationen

Dadurch werden auch die ergänzenden Informationen aus dem Add-on im abschließenden Lieferscheindokument dokumentiert und können gemeinsam mit dem Lieferschein weitergegeben oder archiviert werden.

Information für Frontend-Nutzer

Im Webfrontend kann der Warenempfänger für einen Lieferschein eine vollständige PDF-Dokumentation herunterladen.

Die PDF-Datei enthält den Lieferschein sowie die im Wareneingangsprozess erfassten Zusatzinformationen, beispielsweise:

• Ergebnisse von Prüfungen
• Artikelnotizen
• Anhänge und Bilder
• Signaturen
• Die abschließende Kontrollseite

Die Funktion steht nur zur Verfügung, wenn sie für die Organisation beziehungsweise den Standort freigeschaltet wurde.

Information für API-Anbindung (fachliche Aspekte)

Die erweiterte Lieferscheindokumentation ergänzt die bereits im Basic-System vorhandene PDF-Dokumentation für Warenempfänger.

Der Basic-Endpunkt liefert bereits ein zusammengeführtes PDF für einen Lieferschein beziehungsweise ein Lieferscheinbündel. Dieses enthält die im Basic-System vorhandenen Dokumentbestandteile, jedoch nicht die zusätzlichen Informationen aus den Add-ons.

Mit der erweiterten Lieferscheindokumentation kann zusätzlich ein vollständiges PDF mit den im Add-on erfassten Informationen abgerufen werden, insbesondere:

• Ergebnisse erweiterter Qualitäts- und Zertifizierungsprüfungen
• Notizen auf Artikelebene
• Weitere ergänzende Prüf- und Dokumentationsinformationen

Betroffene API-Endpunkte

Basic-PDF für einen einzelnen Lieferschein

GET /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/pdf

Dieser Endpunkt liefert das im Basic-System erzeugte PDF des Lieferscheins ohne die zusätzlichen Informationen aus den Add-ons.

Basic-Merged-PDF für ein Lieferscheinbündel

GET /organization-sites/{organizationSiteKey}/consignee/delivery-note-bundles/{deliveryNoteBundleKey}/delivery-note-pdfs

Dieser Endpunkt liefert die PDFs aller Lieferscheine eines Bündels als zusammengeführtes PDF. Die zusätzlichen Informationen aus den Add-ons sind darin nicht enthalten.

Erweiterte PDF-Dokumentation für einen einzelnen Lieferschein

GET /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/complete-pdf

Dieser Endpunkt liefert ein vollständiges PDF für einen einzelnen Lieferschein. Es basiert auf der Basic-Dokumentation und ergänzt diese um die im Add-on erfassten Prüf- und Dokumentationsinformationen.

Der Endpunkt ist erforderlich, wenn das eigene Frontend oder System die zusätzlichen Add-on-Informationen in einer zusammenhängenden PDF-Datei bereitstellen soll.

Die Funktion muss für den jeweiligen Organisationsstandort freigeschaltet sein.

Hinweise für Entwickler

Die Anbindung erfolgt über einen GET-Request an:

/organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/complete-pdf

Die Antwort ist als application/pdf zu verarbeiten. Der Dateiname wird über den Header Content-Disposition bereitgestellt.

Für die Implementierung im eigenen Frontend oder System sollte insbesondere Folgendes berücksichtigt werden

• Den PDF-Response als Binärdaten beziehungsweise Blob behandeln
• Den Download über den Dateinamen aus Content-Disposition anbieten
• organizationSiteKey und deliveryNoteKey aus dem eigenen Prozesskontext übergeben
• Fehlerantworten wie 404 oder 500 behandeln
• Vor der Nutzung prüfen, ob die Funktion für den Standort freigeschaltet ist

Die API prüft die erweiterten Daten serverseitig und erzeugt daraus das vollständige PDF. Eine eigene Zusammenführung der einzelnen Dokumentbestandteile ist daher nicht erforderlich.