Featureinformationen

Ladungsträgerübersicht je Mappe

Cloud4Log Addons stellt im Wareneingang eine zentrale Übersicht über alle erfassten Ladungsträger einer Mappe bereit. Die Summen basieren auf den Ladungsträgerdaten, die entweder automatisch aus dem Warenausgang übernommen oder im Wareneingang manuell bzw. über Schnittstellen erfasst wurden.

Mitarbeitende erhalten dadurch jederzeit einen aktuellen Überblick über die bereits dokumentierten Ladungsträger und den Fortschritt der Ladungsträgerprüfung. Werden während der Artikelkontrolle weitere Ladungsträger erfasst, aktualisiert sich die Summenanzeige automatisch.

Die Übersicht steht sowohl im Reiter „Ladungsträger“ als auch im Reiter „Artikel & Abweichungen“ zur Verfügung.

Fachlicher Mehrwert

Während des Wareneingangs können Ladungsträger nicht nur auf Lieferscheinebene, sondern auch einzelnen Artikelpositionen zugeordnet werden.

Dazu werden die am Lieferschein erfassten beziehungsweise übernommenen Ladungsträger je Artikel geprüft und mengenmäßig zugeordnet. Die Summe der auf Artikelebene erfassten Ladungsträger kann mit der Gesamtmenge des Lieferscheins verglichen werden.

Das nutzende Unternehmen kann dadurch nachvollziehen:

welchen Artikelpositionen Ladungsträger zugeordnet wurden,
welche Ladungsträger je Artikel erfasst wurden,
ob die Ladungsträger des Lieferscheins vollständig berücksichtigt wurden,
bei welcher Artikelposition eine Ladungsträgerabweichung besteht.

Die artikelbezogene Erfassung schafft eine detailliertere Dokumentation des Wareneingangs und erleichtert die Prüfung von Abweichungen. Rückfragen und Klärungen können gezielt auf eine konkrete Artikelposition bezogen werden.

Die Funktion ist vom allgemeinen Ladungsträgertausch auf Lieferscheinebene zu unterscheiden. Sie ergänzt diesen um die Zuordnung zu einzelnen Artikeln.

Information für Frontend-Nutzer

Im Wareneingang können Artikelpositionen einzeln geprüft werden. Für eine Artikelposition kann über den Bereich „Ladungsträger“ erfasst werden, welche Ladungsträger zu diesem Artikel gehören.

Dabei werden die für den Lieferschein vorhandenen Ladungsträger angezeigt. Für die einzelne Artikelposition kann je Ladungsträgerart eine Menge eingetragen werden.

Die Anwendung zeigt dabei:

die Ladungsträger je Artikelposition,
die bereits erfasste Menge zur ausgewählten Artikelposition,
die Summe der auf Artikelebene erfassten Ladungsträger,
die Gesamtmenge der Ladungsträger auf Lieferscheinebene.

So kann der Mitarbeiter im Wareneingang prüfen, ob alle Ladungsträger den entsprechenden Artikeln zugeordnet wurden.

Die Erfassung erfolgt innerhalb eines gestarteten Wareneingangs. Nach der Speicherung können die Angaben im Rahmen des laufenden Wareneingangs weiterbearbeitet werden.

Information für API-Anbindung (fachliche Aspekte)

Die Funktionen für Ladungsträgerabweichungen auf Artikelebene werden über die Cloud4Log Addons API bereitgestellt.

Die Endpunkte beziehen sich auf einen konkreten:

Organisationsstandort,
Lieferschein,
Artikel,
gegebenenfalls eine einzelne Abweichung.

Abweichung zu einer Artikelposition anlegen

POST /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies

Mit diesem Addons-Endpunkt wird eine neue Abweichung zu einer Artikelposition angelegt.

Für Ladungsträgerabweichungen werden insbesondere folgende Angaben verwendet:

reason: Grund der Abweichung
number: Abweichende Menge
unit: Einheit beziehungsweise Ladungsträgerart
note: Optionale Bemerkung

Als unit können unter anderem verschiedene Ladungsträgerarten verwendet werden, beispielsweise:

EURO_PALLET
DDP_HALF_PALLET
H1_PALLET
CHEP_1_1
CHEP_1_2
LPR_1_1
GITTERBOX
DISPOSABLE_PALLET
OTHER

Der genaue Werteumfang ist in der Addons-Swagger-Spezifikation definiert.

Alle Abweichungen einer Artikelposition abrufen

GET /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies

Mit diesem Addons-Endpunkt werden alle zu einer Artikelposition gespeicherten Abweichungen abgerufen.

Die Antwort kann unter anderem enthalten:

Schlüssel der Abweichung,
Schlüssel der Artikelposition,
Abweichungsgrund,
Menge,
Einheit beziehungsweise Ladungsträgerart,
Bemerkung,
Erstellungszeitpunkt.

Eine einzelne Artikelabweichung abrufen

GET /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies/{discrepancyKey}

Dieser Addons-Endpunkt liefert eine einzelne Abweichung zu einer Artikelposition.

Abweichung einer Artikelposition ändern

PATCH /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies/{discrepancyKey}

Mit diesem Addons-Endpunkt kann eine bestehende Abweichung geändert werden.

Die Änderung kann sich beispielsweise auf folgende Angaben beziehen:

Abweichungsgrund,
Menge,
Ladungsträgerart,
Bemerkung.

Der Lieferschein muss sich für die Änderung in einem gestarteten Wareneingang befinden.

Alle Abweichungen einer Artikelposition ersetzen

PUT /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies

Mit diesem Addons-Endpunkt wird die vollständige Liste der Abweichungen einer Artikelposition ersetzt.

Dieser Endpunkt kann verwendet werden, wenn das eigene System die vollständige Erfassung einer Artikelposition in einem Vorgang speichern möchte. Laut API-Beschreibung wird die Artikelposition dabei als geprüft markiert.

Eine Artikelabweichung löschen

DELETE /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies/{discrepancyKey}

Mit diesem Addons-Endpunkt wird eine einzelne Abweichung zu einer Artikelposition gelöscht.

Swagger-Quelle der Addons API

Die zugehörige Swagger-Dokumentation der Cloud4Log Addons API ist:

Die Endpunkte für die artikelbezogenen Abweichungen sind dort unter dem Pfad discrepancies beschrieben.

Abgrenzung zur Cloud4Log Basic API

Die oben aufgeführten Endpunkte sind Addons-Endpunkte.

Basic-Endpunkte für allgemeine Abweichungen auf Lieferscheinebene sind für die Umsetzung dieser Funktion nicht erforderlich und werden daher hier nicht aufgeführt. Die artikelbezogene Erfassung von Abweichungen und die dafür vorgesehenen Einheiten für Ladungsträger werden über die Addons API behandelt.

Hinweise für Entwickler

Für die technische Anbindung im eigenen Frontend oder System empfiehlt sich folgender Ablauf

Die Artikelpositionen des Lieferscheins bestimmen.

Für die jeweilige Artikelposition bereits gespeicherte Abweichungen abrufen:

GET /organization-sites/{organizationSiteKey}/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies

Die für die Artikelposition festgestellte Ladungsträgerabweichung mit dem Addons-Endpunkt speichern:

POST /organization-sites/{organizationSiteKey}/consignee/delivery-notes/{deliveryNoteKey}/articles/{articleKey}/discrepancies

Für Änderungen den PATCH-Endpunkt verwenden.
Für die vollständige Ersetzung der Einträge den PUT-Endpunkt verwenden.
Nicht mehr benötigte Einträge mit dem DELETE-Endpunkt löschen.

Beispiel für das Anlegen einer Ladungsträgerabweichung

{
  "reason": "OVER_DELIVERED",
  "number": 2,
  "unit": "EURO_PALLET",
  "note": "Zwei zusätzliche Europaletten bei der Artikelposition festgestellt"
}

Die Bezeichnungen für reason und unit müssen den in der Addons-Swagger-Spezifikation definierten Werten entsprechen. Die Menge wird als positive Zahl übergeben.

Technische Hinweise

organizationSiteKey, deliveryNoteKey und articleKey müssen zur betroffenen Organisation, zum Lieferschein und zur Artikelposition gehören.
Schreibende Vorgänge

Hinweis bei unvollständig geprüften Lieferungen