ITEM-Code als Barcode und QR-Code

ITEM-Code als Scan-Code

Ist die Artikelnummer des Empfängers (ITEM-Code) auf dem Lieferschein oder in den strukturierten Artikeldaten vorhanden, kann diese im Wareneingang als Barcode und QR-Code dargestellt werden. Die Codes können direkt mit Handscannern erfasst werden und unterstützen so die Warenvereinnahmung und Identifikation von Artikeln.

Dadurch lassen sich Artikel schneller den entsprechenden Beständen, Bestellungen oder Folgeprozessen zuordnen.

Was ist ein ITEM-Code?

ITEM-Code: Eindeutiger Identifikator eines Artikels, Materials oder einer Belegposition in einem Logistik- oder ERP-System. Der ITEM-Code dient der eindeutigen Zuordnung und Verarbeitung von Produkten oder Positionen entlang der Beschaffungs-, Lager- und Lieferprozesse.

Fachlicher Mehrwert

Ausgangssituation

Im Wareneingang muss jede eingehende Artikelposition identifiziert und dem richtigen Bestand, der passenden Bestellung oder dem korrekten Folgeprozess zugeordnet werden.

Viele Unternehmen verwenden hierfür eine eigene Artikelnummer des Empfängers, den sogenannten ITEM-Code. Dieser dient als eindeutiger Identifikator eines Artikels, Materials oder einer Belegposition im ERP- bzw. Logistiksystem des Warenempfängers.

Ohne maschinelle Erfassung müssen Mitarbeitende diese Nummern manuell eingeben oder visuell abgleichen. Dies kostet Zeit und erhöht das Risiko von Eingabefehlern.

Was das Feature leistet

Cloud4Log Addons erkennt die Artikelnummer des Empfängers (ITEM-Code) aus dem Lieferschein oder aus bereitgestellten ASN-Daten und stellt diese direkt als scanbaren Barcode (CODE128) sowie als QR-Code in der Artikeldetailansicht bereit.

Mitarbeitende im Wareneingang können die Codes mit einem Handscanner erfassen und den Artikel ohne manuelle Dateneingabe weiterverarbeiten.

Mehrwert für das Unternehmen

• Schnellere Artikelidentifikation: Der ITEM-Code ist unmittelbar scanbar und muss nicht manuell eingetippt werden.
• Weniger Erfassungsfehler: Maschinelles Scannen reduziert Tipp- und Übertragungsfehler bei der Zuordnung von Artikeln zu Bestellungen oder Lagerplätzen.
• Nahtlose ERP-Integration: Der gescannte ITEM-Code kann direkt im ERP- oder Warenwirtschaftssystem verarbeitet werden.
• Flexible Datenquelle: Der angezeigte ITEM-Code wird aus mehreren Quellen ermittelt und priorisiert, sodass stets der bestmögliche Wert verwendet wird.

---

Information für Frontend-Nutzer

So funktioniert es im Wareneingang

1. Öffnen Sie eine Mappe und wechseln Sie zur Artikelliste eines Lieferscheins.
2. Öffnen Sie die Artikeldetailansicht eines Artikels.
3. Ist ein ITEM-Code vorhanden, erscheint oberhalb der Artikeldetails ein Bereich mit scanbaren Codes.
4. Über den Schieberegler „QR Code / Bar Code“ können Sie zwischen QR-Code und Barcode-Darstellung umschalten.
5. Unterhalb des Codes wird die Bezeichnung „Art-Nr. Empfänger“ angezeigt.
6. Scannen Sie den dargestellten Code mit einem Handscanner, um den ITEM-Code direkt in Ihr Zielsystem zu übernehmen.

Hinweise

• Sind sowohl eine ASN-Kennung als auch ein ITEM-Code vorhanden, werden beide Codes nebeneinander dargestellt:
  • ASN links
  • ITEM-Code rechts
• Der Barcode wird im Format CODE128 erzeugt und ist mit gängigen Handscannern kompatibel.
• Ist das Feature nicht aktiviert, erscheint anstelle des Codes ein entsprechender Hinweis.

---

Information für API-Anbindung (fachliche Aspekte)

Der ITEM-Code wird im API-Modell als sellableCode beziehungsweise customerArticleNumber geführt.

Betroffene Endpunkte (API v3)

Methode	Endpunkt	Relevanz
POST	/organization-sites/{organizationSiteKey}/consignee/advanced-shipping-notes	ITEM-Code als sellableCode hochladen
GET	/organization-sites/{organizationSiteKey}/consignee/advanced-shipping-notes	Gespeicherte ASN-Daten inklusive sellableCode abrufen
GET	/organization-sites/{organizationSiteKey}/consignee/delivery-notes	Lieferscheine inklusive customerArticleNumber und ASN-Metadaten abrufen
GET	/organization-sites/{organizationSiteKey}/consignee/delivery-note-bundles	Mappen inklusive Lieferscheinen und Artikeldaten abrufen

Datenfluss

1. Der ITEM-Code wird beim ASN-Upload im Feld sellableCode übertragen.
2. Cloud4Log Addons ordnet ASN-Einträge über die Kombination aus articleOrderNumber und sellableCode den passenden Artikelpositionen zu.
3. In den Lieferscheinantworten erscheint die Empfänger-Artikelnummer:
   • Direkt im Feld customerArticleNumber
   • Optional zusätzlich in den ASN-Metadaten als sellableCode

Prioritätslogik der Anzeige (Fallback-Kette)

Die Anzeige des ITEM-Codes erfolgt nach folgender Priorität:

1. metaData[type=ASN].item (ITEM-Code aus ASN-Daten)
2. customerArticleNumber (bearbeiteter Wert)
3. customerArticleNumber (Originalwert aus dem Lieferschein)

---

Hinweise für Entwickler

Feature-Flag

consigneeShowItemQRCode

Das Feature muss für das Unternehmen aktiviert sein.

ITEM-Code per ASN-API bereitstellen

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

[
  {
    "advancedShippingNotice": "ASN-99821",
    "articleOrderNumber": "ART-552",
    "sellableCode": "EAN-123456",
    "quantity": 10
  }
]

Die Zuordnung zum Lieferscheinartikel erfolgt serverseitig automatisch anhand von:

articleOrderNumber + sellableCode

Abgeglichen wird gegen:

customerArticleNumber
articleNumber

ITEM-Code aus Lieferscheinantwort auslesen

Jeder Artikel enthält folgende relevante Felder:

Feld	Beschreibung
customerArticleNumber	Artikelnummer des Empfängers direkt aus dem Lieferschein
metaData[]	ASN-Metadaten inklusive sellableCode aus den ASN-Daten

Empfohlene Priorität für eigene Frontends

1. metaData[type="ASN"].item
2. customerArticleNumber (bearbeiteter Wert)
3. customerArticleNumber (Originalwert)

Barcode-Generierung

• Barcode-Format: CODE128
• QR-Code: Standard-QR-Code mit Error-Correction-Level L
• Beide Darstellungsformen sind mit gängigen Handscannern kompatibel.

Maximale Feldlänge

Feld	Maximale Länge
sellableCode	1024 Zeichen
customerArticleNumber	1024 Zeichen