Featureinformationen

Ladungsträgerabweichungen auf Artikelebene

Mitarbeitende im Wareneingang können Ladungsträger direkt an einzelnen Artikelpositionen erfassen und dokumentieren. Dadurch lassen sich Ladungsträgerabweichungen bereits im Rahmen der Artikelkontrolle den betroffenen Positionen zuordnen.

Die erfassten Informationen unterstützen die strukturierte Erfassung und Auswertung von Ladungsträgerabweichungen. Die ermittelten Mengen werden dabei artikelübergreifend summiert und für die weitere Bearbeitung bereitgestellt.

Aktuell erfolgt keine automatische Übernahme der auf Artikelebene erfassten Ladungsträgerdaten in die zentrale Ladungsträgerverwaltung.

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

Empfohlener Ablauf für die technische Anbindung

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 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 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 setzen einen gestarteten Wareneingang voraus.
Die Addons-Endpunkte verwenden die Addons-Authentifizierung.
Eine Abweichung wird immer einer konkreten Artikelposition zugeordnet.
Für Ladungsträgerabweichungen wird die Ladungsträgerart über das Feld unit angegeben.
Die API-Antwort sollte nach dem Speichern verwendet werden, um den aktuellen Schlüssel und Status der gespeicherten Abweichung im eigenen System zu übernehmen.
Wenn die vollständige Liste der Abweichungen übertragen wird, ist der PUT-Endpunkt zu verwenden. Dabei werden die bisherigen Einträge durch die übergebene Liste ersetzt und die Artikelposition als geprüft markiert.

Die Summen- oder Plausibilitätsprüfung zwischen den auf Artikelebene erfassten Ladungsträgern und den Ladungsträgern des Lieferscheins muss im eigenen Frontend beziehungsweise System umgesetzt werden.

Die Addons API stellt die artikelbezogenen Abweichungen bereit, liefert jedoch keinen separaten Endpunkt für eine fertig berechnete Differenzübersicht.

Ladungsträgerabweichungen auf Artikelebene erfassen