Lagerorte je Artikelposition

Lagerorte in der Artikelliste

Für jede Artikelposition kann der zugeordnete Lagerort direkt in der Artikelliste angezeigt werden. Die Lagerortinformationen werden aus den bereitgestellten ASN-Daten übernommen und stehen den Mitarbeitenden im Wareneingang zur Verfügung.

Die Lagerort-Spalte ist sortierbar, sodass Artikel gezielt nach ihrem Zielbereich im Lager angeordnet und abgearbeitet werden können. Dies erleichtert die Warenvereinnahmung und reduziert unnötige Wege im Lager.

Fachlicher Mehrwert

Ausgangssituation

In vielen Lager- und Distributionsumgebungen ist es entscheidend, dass Mitarbeitende im Wareneingang nicht nur wissen, was geliefert wird, sondern auch wohin die Ware im Lager gehört. Ohne Lagerortinformationen müssen diese Daten in anderen Systemen nachgeschlagen werden, was Zeit kostet und Fehler verursachen kann.

Was das Feature leistet

Cloud4Log Addons ordnet jedem Artikel eines Lieferscheins automatisch den passenden Lagerort zu und zeigt diesen direkt in der Artikelliste an.

Die Lagerortinformationen werden vom Warenempfänger im Vorfeld bereitgestellt:

• Über eine ASN-Excel-Datei
• Über die ASN-API

Beim Eintreffen der Lieferung identifiziert Cloud4Log Addons die Artikel anhand von Bestellnummer und Empfänger-Artikelnummer und ordnet den hinterlegten Lagerort automatisch zu.

Mehrwert für das Unternehmen

• Schnellere Warenvereinnahmung: Mitarbeitende sehen direkt am Artikel, in welchen Lagerbereich die Ware eingelagert werden soll.
• Weniger Laufwege: Die Artikelliste kann nach Lagerorten sortiert werden, sodass Artikel desselben Lagerbereichs gemeinsam bearbeitet werden können.
• Weniger Fehler: Die automatische Zuordnung reduziert manuelle Übertragungs- und Zuordnungsfehler.
• Nahtlose Integration: Lagerortdaten können automatisiert aus bestehenden ERP- oder Lagerverwaltungssystemen übernommen werden.

---

Information für Frontend-Nutzer

Voraussetzung

Der Standort- oder Unternehmensadministrator muss ASN-Daten mit Lagerortinformationen bereitgestellt haben:

• Per Excel-Upload
• Oder über die ASN-API

So funktioniert es im Wareneingang

1. Öffnen Sie eine Mappe und wechseln Sie zur Artikelliste eines Lieferscheins.
2. In der Artikeltabelle wird die Spalte „Lagerort“ angezeigt.
3. Zu jedem Artikel erscheint der zugeordnete Lagerort, sofern dieser in den ASN-Daten vorhanden ist.
4. Über einen Klick auf die Spaltenüberschrift „Lagerort“ kann die Liste nach Lagerorten sortiert werden.
5. Die Suchfunktion der Artikelliste unterstützt ebenfalls die Suche nach Lagerorten.
6. In der Detailansicht eines Artikels wird der Lagerort zusätzlich angezeigt.

Bereitstellung der Lagerortdaten per Excel

Der Administrator lädt im Admin-Panel unter „ASN-Daten verwalten“ eine Excel-Datei hoch.

Die Spalte „Lagerort“ enthält dabei die Lagerplatzbezeichnung pro Artikelposition, beispielsweise:

Halle-A-Regal-12-Fach-3

Cloud4Log Addons ordnet die Angaben automatisch den richtigen Artikelpositionen zu.

---

Information für API-Anbindung (fachliche Aspekte)

Die Lagerortinformation wird über das Feld storageLocation innerhalb der ASN-Daten (Advanced Shipping Notice) übertragen.

Betroffene Endpunkte (API v3)

Methode	Endpunkt	Beschreibung
POST	/organization-sites/{organizationSiteKey}/consignee/advanced-shipping-notes	ASN-Daten anlegen oder aktualisieren (inkl. Lagerort)
GET	/organization-sites/{organizationSiteKey}/consignee/advanced-shipping-notes	Gespeicherte ASN-Daten inklusive Lagerort abrufen

Feld storageLocation im ASN-Objekt

Beim Schreiben (POST)

• Typ: string
• Optional
• Maximale Länge: 1024 Zeichen

Beispiel:

{
  "storageLocation": "Lager-Süd-A1"
}

Beim Lesen (GET)

• Enthält den gespeicherten Lagerort
• Wird kein Lagerort gespeichert, wird ein leerer String zurückgegeben

Auswirkung auf die Artikelanzeige

Wurden ASN-Daten mit Lagerortinformationen hochgeladen und konnte die entsprechende Artikelposition identifiziert werden, wird der Lagerort automatisch in den Artikelmetadaten (ASNMetaData) bereitgestellt.

Folgendes Feld wird ergänzt:

ASNMetaData.storageLocation

Zuordnungslogik

Die Verknüpfung zwischen ASN-Daten und Lieferscheinpositionen erfolgt über:

• articleOrderNumber (Bestellnummer)
• sellableCode (Empfänger-Artikelnummer / Item-Code)

Nur auf dieser Basis wird ein Lagerort automatisch zugeordnet.

---

Hinweise für Entwickler

Lagerort übermitteln

POST /api/v3/organization-sites/{siteKey}/consignee/advanced-shipping-notes

[
  {
    "advancedShippingNotice": "ASN-99821",
    "articleOrderNumber": "ART-552",
    "sellableCode": "EAN-123456",
    "storageLocation": "Lager-Süd-A1",
    "quantity": 10
  }
]

Erfolgsantwort

204 No Content

Fehlerfall

400 Bad Request

Der Fehler tritt auf, wenn innerhalb eines Requests doppelte Kombinationen aus:

• articleOrderNumber
• sellableCode

vorhanden sind.

Lagerort auslesen

GET /api/v3/organization-sites/{siteKey}/consignee/advanced-shipping-notes

Die Antwort enthält für jeden ASN-Eintrag:

• storageLocation
• dateCreated
• dateUpdated

Upsert-Verhalten

Wird ein ASN-Eintrag mit derselben advancedShippingNotice erneut gesendet:

• werden alle Felder inklusive storageLocation aktualisiert
• bleiben andere ASN-Einträge unverändert erhalten

Zuordnung zu Lieferscheinartikeln

Die serverseitige Verknüpfung erfolgt über:

articleOrderNumber + sellableCode

Der Lagerort wird anschließend in den Artikelantworten unter folgendem Feld bereitgestellt:

ASNMetaData.storageLocation

Maximale Batchgröße

• Maximal 500 ASN-Einträge pro Request