Erweiterte Ladungsträgerverwaltung

Cloud4Log Addons erweitert die Ladungsträgerverwaltung im Wareneingang um zusätzliche Automatisierungs- und Bearbeitungsfunktionen. Vom Warenausgang erfasste Ladungsträgertausche werden automatisch in den Wareneingang übernommen und können dort geprüft, ergänzt und angepasst werden.

Beschädigte Ladungsträger werden dabei automatisch von der Übernahme ausgeschlossen und können gesondert berücksichtigt werden. Nach der Bearbeitung stellt das System die Summen je Ladungsträgertyp getrennt nach Annahme und Abgabe übersichtlich dar.

Zusätzlich können Ladungsträger auch direkt einzelnen Artikelpositionen zugeordnet werden. Die automatisch übernommenen Ladungsträgertypen lassen sich unternehmensweit konfigurieren.

Fachlicher Mehrwert

Bei der Warenübergabe zwischen Versender, Spediteur und Empfänger werden regelmäßig Ladungsträger getauscht, beispielsweise Europaletten, Gitterboxen, Poolpaletten und weitere Typen. Im Cloud4Log Basic-System kann der Warenausgang diese Ladungsträgertausche bereits bei der Übergabe an den Spediteur dokumentieren. Der Wareneingang musste dieselben Informationen jedoch bislang erneut manuell erfassen, obwohl die Daten bereits im System vorliegen.

Mit der Erweiterung „Erweiterte Ladungsträgerverwaltung“ in Cloud4Log Addons entfällt diese Doppelerfassung. Nach dem Checkout im Warenausgang werden die vom Versender erfassten Ladungsträgerdaten automatisch in den Wareneingang übernommen. Dort können sie geprüft, ergänzt und bei Bedarf korrigiert werden.

Die Erweiterung umfasst

• Automatische Übernahme der Ladungsträgerdaten: Ladungsträger, die der Versender beim Checkout an den Spediteur übergeben hat (Abgabe), werden automatisch als Annahme im Wareneingang vorbelegt. Beschädigte Ladungsträger werden dabei bewusst von der automatischen Übernahme ausgeschlossen und können gesondert berücksichtigt werden.
• Bearbeitung im Wareneingang: Die vorausgefüllten Ladungsträgertausche können im Wareneingang angepasst werden, beispielsweise Mengen korrigieren, Beschädigungen vermerken, Bemerkungen ergänzen oder weitere Ladungsträger hinzufügen.
• Palettenscheine und Fotos: Ergänzend zum Ladungsträgertausch können DPL-Scheine als PDF sowie Fotos von Ladungsträgern direkt am Lieferschein hinterlegt werden.
• Summenanzeige: Im Reiter „Ladungsträger“ wird eine Gesamtübersicht über alle getauschten Ladungsträger einer Mappe dargestellt, getrennt nach Annahme und Abgabe sowie je Ladungsträgertyp.
• Ladungsträger auf Artikelebene: Zusätzlich können Ladungsträger direkt einzelnen Artikelpositionen zugeordnet werden, um Abweichungen präzise am betroffenen Artikel zu dokumentieren.

Hinweis: Für den Ladungsträgertausch steht ein umfangreicher Katalog vorkonfigurierter Ladungsträgertypen zur Verfügung, darunter Europaletten, DDP-Halbpaletten, CHEP-, LPR- und IPP-Poolpaletten, Gitterboxen, CC-/EC-Container, IFCO-Kisten und weitere. Über den Typ „Sonstige“ können auch nicht im Katalog enthaltene Ladungsträger erfasst werden.

Mehrwert für das nutzende Unternehmen

• Erfassungsaufwand reduzieren: Ladungsträgerdaten aus dem Warenausgang werden automatisch übernommen und müssen nicht erneut erfasst werden.
• Fehlerquote senken: Durch die Vorbelegung aus dem Warenausgang sinkt das Risiko von Erfassungsfehlern bei Mengen und Ladungsträgertypen.
• Durchgängig digitale Dokumentation: Ladungsträgertausche werden zentral am digitalen Lieferschein dokumentiert und stehen für Nachweise, Audits und die Weiterverarbeitung in nachgelagerten Systemen zur Verfügung.
• Transparenz auf einen Blick: Die Summenanzeige je Ladungsträgertyp und Mappe schafft eine sofortige Übersicht über den Tauschstand.
• Medienbruchfrei mit Palettenscheinen: DPL-Scheine und Fotos können direkt digital hinterlegt werden, Papierbelege werden überflüssig.
• Erweitertes Reporting: Die Ladungsträgerbewegungen fließen in die CSV-Reports ein und können für Pooling-Abrechnungen und die Bestandsführung genutzt werden.

Information für Frontend-Nutzer

Wo finde ich die Ladungsträgerverwaltung?

Im Check-In (Wareneingangsprüfung) steht der Reiter „Ladungsträger“ als zweiter Tab zur Verfügung.

Dieser Reiter enthält:

1. Summenanzeige

   • Oben wird unter der Überschrift „Summe Ladungsträger“ eine Gesamtübersicht aller getauschten Ladungsträger der Mappe angezeigt.

   • Jeder Ladungsträgertyp wird mit Symbol, Menge und Bezeichnung dargestellt.

   • Annahme – Ladungsträger, die Sie erhalten haben

   • Abgabe – Ladungsträger, die Sie zurückgegeben haben

2. Ladungsträgertausch je Lieferschein

   • Für jeden Lieferschein der Mappe wird ein ausklappbarer Bereich angezeigt, in dem die Ladungsträger bearbeitet werden können.

Wie verwende ich die erweiterte Ladungsträgerverwaltung?

Automatisch übernommene Ladungsträger prüfen und anpassen

1. Navigieren Sie im Check-In zum Reiter „Ladungsträger“.

2. Klappen Sie den gewünschten Lieferschein auf.

3. Die vom Warenausgang erfassten Ladungsträger sind bereits vorausgefüllt. Prüfen Sie die Angaben:

   • Ladungsträgertyp – Wählen Sie den Typ aus der Dropdown-Liste (z. B. Europalette, H1-Palette, CHEP 1/1).
   • Anzahl – Tragen Sie die Menge ein.
   • Annahme / Abgabe – Legen Sie fest, ob es sich um eine Annahme oder Abgabe handelt.
   • Ladungsträger ist beschädigt – Setzen Sie den Haken, wenn der Ladungsträger beschädigt ist.
   • Bemerkung – Ergänzen Sie bei Bedarf eine Notiz (max. 500 Zeichen).

4. Klicken Sie auf „Speichern“, um die Änderungen zu sichern. Der Button wechselt anschließend zu „Gespeichert“.

Weitere Ladungsträger hinzufügen

1. Klicken Sie auf „Ladungsträger hinzufügen“ unterhalb der vorhandenen Einträge.
2. Es werden automatisch zwei Zeilen angelegt – eine für Annahme und eine für Abgabe.
3. Füllen Sie die Felder aus und speichern Sie.

Ladungsträger entfernen

• Klicken Sie auf das Papierkorb-Symbol neben dem Eintrag, um einen Ladungsträger zu entfernen.

Palettenscheine und Fotos hinterlegen

1. Klicken Sie auf „Palettenschein hinzufügen“, um einen DPL-Schein als PDF hochzuladen.
2. Klicken Sie auf „Fotos hinzufügen“, um Fotos von Ladungsträgern hochzuladen (JPEG, PNG, HEIC/HEIF).
3. Hochgeladene Anhänge werden als Chips angezeigt und können einzeln entfernt werden.

Ladungsträger auf Artikelebene zuordnen

Im Reiter „Artikel & Abweichungen“ können Sie zusätzlich Ladungsträger direkt an einzelnen Artikelpositionen dokumentieren.

Im Bearbeitungsdialog eines Artikels werden die verfügbaren Ladungsträgertypen mit den Mengen aus dem Ladungsträgertausch angezeigt.

Per Tooltip sehen Sie:

• „Von allen Artikeln“ – die Gesamtmenge aus allen Artikelzuordnungen
• „Insgesamt erhalten“ – die Gesamtmenge aus dem Ladungsträgertausch

Hinweise

• Nicht gespeicherte Änderungen werden durch den Hinweis „Es gibt nicht gespeicherte Änderungen“ angezeigt.
• Falls das Speichern fehlschlägt, erscheint die Meldung „Beim Speichern des Ladungsträgertausches ist ein Fehler aufgetreten.“
• Bei Lieferscheinen ohne Ladungsträger wird der Hinweis „Dieser Lieferschein hat keine Ladungsträger“ angezeigt.

Information für API-Anbindung (fachliche Aspekte)

Die erweiterte Ladungsträgerverwaltung ermöglicht es, Ladungsträgertausche im Wareneingang über die Cloud4Log API zu lesen, zu erstellen, zu aktualisieren und zu ersetzen.

Zusätzlich werden Ladungsträgerdaten aus dem Warenausgang automatisch in den Wareneingang übernommen, sobald der Checkout abgeschlossen ist.

Voraussetzung

Das Feature loadCarrierExchange muss für den Standort aktiviert sein. Die automatische Übernahme der Ladungsträgerdaten vom Warenausgang erfolgt nur bei aktiviertem Feature.

Betroffene API-Endpunkte

1. Ladungsträger im Wareneingang (Consignee)

Methode	Endpunkt	Beschreibung
POST	/organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/load-carriers	Neuen Ladungsträger zu einem Lieferschein hinzufügen
PUT	/organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/load-carriers	Alle Ladungsträger eines Lieferscheins ersetzen (Bulk-Update)
GET	/organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/load-carriers	Alle Ladungsträger eines Lieferscheins abrufen

2. Ladungsträger im Warenausgang (Consignor)

Methode	Endpunkt	Beschreibung
POST	/organization-sites/{organizationSiteKey}/consignor/delivery-note-bundles/{deliveryNoteBundleKey}/delivery-notes/{deliveryNoteKey}/load-carriers	Ladungsträger hinzufügen
PUT	/organization-sites/{organizationSiteKey}/consignor/delivery-note-bundles/{deliveryNoteBundleKey}/delivery-notes/{deliveryNoteKey}/load-carriers	Alle Ladungsträger ersetzen
GET	/organization-sites/{organizationSiteKey}/consignor/delivery-note-bundles/{deliveryNoteBundleKey}/delivery-notes/{deliveryNoteKey}/load-carriers	Alle Ladungsträger abrufen
PATCH	.../{deliveryNoteKey}/load-carriers/{loadCarrierKey}	Einzelnen Ladungsträger aktualisieren
DELETE	.../{deliveryNoteKey}/load-carriers/{loadCarrierKey}	Einzelnen Ladungsträger löschen

3. Ladungsträgervorlagen (Templates)

Methode	Endpunkt	Beschreibung
GET	/organizations/{organizationKey}/load-carrier-templates	Alle verfügbaren Ladungsträgertypen der Organisation abrufen

4. Palettenscheine (Pallet Tickets)

Methode	Endpunkt	Beschreibung
POST	/organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/pallet-tickets/file/{fileName}	Palettenschein (PDF) hochladen
GET	.../{deliveryNoteKey}/pallet-tickets	Alle Palettenscheine eines Lieferscheins auflisten
GET	.../{deliveryNoteKey}/pallet-tickets/{attachmentKey}	Einzelnen Palettenschein herunterladen
DELETE	.../{deliveryNoteKey}/pallet-tickets/{attachmentKey}	Palettenschein löschen

5. Pooling-Report (Addons API v3)

Methode	Endpunkt	Beschreibung
POST	/api/v3/pooling/organization-sites/{organizationSiteKey}/report	Bericht über alle getauschten Ladungsträger in einem Zeitraum (max. 2 Tage) abrufen

6. CSV-Reports (inklusive Ladungsträgerdaten)

Methode	Endpunkt	Beschreibung
GET	/api/v2/administration/organization-sites/{organizationSiteKey}/delivery-notes/reports/csv	CSV-Report inklusive Ladungsträgerdaten herunterladen

Hinweise für Entwickler

Automatische Übernahme nach Checkout

Nach dem Checkout im Warenausgang werden die vom Versender erfassten Ladungsträger automatisch in den Wareneingang übernommen.

Dabei gilt folgende Transformationslogik:

1. Nur Ladungsträger mit operation: "DELIVERY" (Abgabe des Versenders) werden übernommen.
2. Die Operation wird invertiert: Aus der Abgabe des Versenders wird eine ADOPTION (Annahme) im Wareneingang.
3. Beschädigte Ladungsträger (damaged: true) werden übernommen, erhalten aber keine automatische Gegenposition.

Die automatische Übernahme erfolgt asynchron. Es kann einige Sekunden nach dem Checkout dauern, bis die Ladungsträger im Wareneingang erscheinen.

Ladungsträger im Wareneingang erstellen

Einzelnen Ladungsträger anlegen

POST /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/load-carriers

{
  "name": "Europalette",
  "description": "Europalette",
  "operation": "adoption",
  "quantity": 5,
  "damaged": false,
  "notice": ""
}

• Antwort bei Erfolg: 201 Created
• Das Ergebnis enthält den erzeugten Ladungsträger inklusive generiertem _key.
• Voraussetzung: Der Check-In für den Lieferschein muss gestartet sein.

Alle Ladungsträger ersetzen (Bulk-Update)

PUT /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/load-carriers

[
  {
    "name": "Europalette",
    "operation": "adoption",
    "quantity": 5,
    "damaged": false,
    "notice": ""
  },
  {
    "name": "Europalette",
    "operation": "delivery",
    "quantity": 5,
    "damaged": false,
    "notice": ""
  }
]

• Antwort bei Erfolg: 200 OK
• Dieser Endpunkt ersetzt alle vorhandenen Ladungsträger durch die übergebenen Werte.

Verfügbare Ladungsträgertypen abrufen

GET /organizations/{organizationKey}/load-carrier-templates

Die Antwort enthält alle für die Organisation konfigurierten Ladungsträgervorlagen. Der Wert des Feldes name muss beim Anlegen eines Ladungsträgers verwendet werden.

Palettenscheine hochladen

POST /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/pallet-tickets/file/{fileName}

Content-Type: application/pdf

• Es werden ausschließlich PDF-Dateien akzeptiert.
• Voraussetzung: Der Check-In für den Lieferschein muss gestartet sein.

Pooling-Report abrufen

Für die automatisierte Auswertung von Ladungsträgerbewegungen steht ein dedizierter Report-Endpunkt zur Verfügung:

POST /api/v3/pooling/organization-sites/{organizationSiteKey}/report

{
  "dateFrom": 1700000000000,
  "dateTo": 1700172800000
}

• Maximaler Auswertungszeitraum: 2 Tage.
• Die Antwort enthält je Ladungsträger:
  • Lieferscheinnummer
  • Bestellnummer
  • Empfangsdatum
  • Absenderstandort
  • Empfängerstandort
  • Ladungsträgertyp
  • Menge
  • Beschädigungsstatus