ASN-Import und Scan-Codes für Artikelpositionen

ASN-Import und Scan-Codes

Standort- und Unternehmensadministratoren können ASN-Daten über eine Excel-Datei im Admin Panel hochladen. Neben der ASN (Advanced Shipping Notice) können auch avisierte Liefermengen und Lagerorte bereitgestellt werden.

Cloud4Log Addons ordnet die hochgeladenen ASN-Daten anhand von Bestellnummer und ITEM-Code automatisch den Artikelpositionen zu. Die ASN kann anschließend als Barcode und QR-Code im Wareneingang angezeigt und mit einem Handscanner erfasst werden.

So stehen wichtige Informationen zur erwarteten Lieferung direkt am Artikel zur Verfügung und unterstützen einen effizienten Wareneingangsprozess.

Fachlicher Mehrwert

Mehrwert

• Einfacher Import ohne IT-Anbindung: Lieferavis-Daten können als Excel-Datei hochgeladen werden, ohne Programmierkenntnisse oder eine ERP-Anbindung. Dies bietet eine Alternative zur automatisierten API-Integration.
• Automatische Zuordnung zu Artikelpositionen: Die Zuordnung zu Lieferscheinpositionen erfolgt automatisch anhand der Bestellnummer (PO-Nummer) und der Empfänger-Artikelnummer (Item-Code/Sellable-Code).
• Scan-Codes für die Warenvereinnahmung: ASN-Kennung und Empfänger-Artikelnummer werden als Strichcode (CODE128) und QR-Code dargestellt und können per Handscanner erfasst werden.
• Grundlage für QS-Ampel und Lagerort: Avisierte Mengen werden für den QS-Abgleich verwendet. Optional übermittelte Lagerorte werden direkt in der Artikelansicht angezeigt.
• Umschaltbar zwischen Strichcode und QR-Code: Im Artikeldialog kann zwischen Strichcode- und QR-Code-Anzeige gewechselt werden.

In welcher Form müssen die Daten bereitgestellt werden?

Die Daten werden als Excel-Datei (.xlsx oder .xls) bereitgestellt. Verarbeitet wird das erste Tabellenblatt. Die Schreibweise der Spaltennamen ist flexibel, Groß- und Kleinschreibung wird ignoriert.

Pflichtfelder

Spaltenname (Varianten)	Beschreibung	Beispiel
DC, dcNumber, distributionCenter, Lager	Nummer des Distributionszentrums bzw. Lagers. Wird intern auf einen Standort gemappt.	4711
ASN, advancedShippingNotice	Eindeutige ASN-Kennung (Lieferavis-Nummer)	ASN-2026-001
PO, PONumber, purchaseOrder, Bestellnummer, articleOrderNumber	Bestellnummer (PO-Nummer)	PO-12345
quantity	Avisierte Bestellmenge (ganze Zahl > 0)	100

Optionale Felder

Spaltenname (Varianten)	Beschreibung	Beispiel
sellableCode	Empfänger-Artikelnummer (Item-Code)	4711
consigneeOrderNumber	Bestellnummer des Empfängers	C-1002
storageLocation, Regal, Lagerort	Lagerort	Lager-Süd-A1
description, Beschreibung, Text	Artikelbeschreibung	Bio-Äpfel 1kg

Verarbeitungsregeln

• Zeilen mit fehlender DC-Nummer, PO-Nummer, ASN-Kennung oder ungültiger Menge werden übersprungen.
• Doppelte Kombinationen aus ASN, PO und Sellable-Code innerhalb einer Datei werden dedupliziert.
• Die Daten werden nach DC-Nummer gruppiert und in Paketen mit maximal 500 Datensätzen verarbeitet.
• Die DC-Nummer wird über eine interne Zuordnungstabelle auf den jeweiligen Cloud4Log-Standort aufgelöst.

Information für Frontend-Nutzer

Excel-Upload (Standort- oder Unternehmensadministrator)

1. Navigieren Sie zum Admin-Panel.
2. Auf dem Dashboard finden Sie die Karte für den ASN-Upload (nur sichtbar, wenn das Feature aktiviert ist).
3. Öffnen Sie die Upload-Seite.
4. Wählen Sie eine Excel-Datei (.xlsx oder .xls) mit Ihren Lieferavis-Daten aus.
5. Nach dem Upload werden die Daten automatisch verarbeitet. Anschließend wird eine Statistik mit verarbeiteten Zeilen, übersprungenen Einträgen und erfolgreichen API-Aufrufen angezeigt.

Scan-Codes in der Artikelansicht

Im Reiter „Artikel & Abweichungen“ können Sie über das Aktionsmenü eines Artikels den Artikeldialog öffnen. Dort steht der Reiter „CODES“ zur Verfügung.

ASN-Strichcode bzw. ASN-QR-Code

• Die ASN-Kennung wird als CODE128-Strichcode oder QR-Code dargestellt.
• Über einen Schieberegler kann zwischen beiden Darstellungsformen umgeschaltet werden.

Item-Code-Strichcode bzw. Item-Code-QR-Code

• Die Empfänger-Artikelnummer (Item-Code) wird ebenfalls als Barcode oder QR-Code angezeigt, sofern vorhanden.

Lagerort und ASN-Details

Unterhalb der Codes werden zusätzliche Informationen angezeigt:

• ASN-Kennung
• Lagerort
• Weitere Metadaten

Die dargestellten Codes können mit einem Handscanner erfasst werden, um die Warenvereinnahmung zu beschleunigen.

Information für API-Anbindung (fachliche Aspekte)

ASN-Import per Excel und API

Der Excel-Upload verwendet intern dieselben API-Endpunkte wie die automatisierte Übernahme von Lieferavis-Daten per API.

Betroffene Endpunkte

Methode	Endpunkt	Beschreibung
POST	/api/v3/.../consignee/advanced-shipping-notes	Lieferavis-Daten importieren (Upsert)
GET	/api/v3/.../consignee/advanced-shipping-notes	Gespeicherte Lieferavis-Daten abrufen
PUT	/api/v2/.../consignee/advancedShippingNotes	Lieferavis-Daten vollständig ersetzen (veraltet)

Die vollständige API-Dokumentation ist über die Cloud4Log Addons API-Dokumentation verfügbar.

Benötigtes Feature-Flag

Feature-Flag	Funktion
advancedShippingNotice	Import und Verarbeitung von Lieferavis-Daten

Fachliche Einsatzmöglichkeiten

• Manuelle Bereitstellung per Excel: Geeignet für Standorte oder Lieferanten ohne direkte ERP-Anbindung.
• Scan-Code-Integration: ASN-Kennung und Item-Code stehen als Barcode und QR-Code zur Verfügung und können in eigene Frontends integriert werden.
• Kombination beider Importwege: Excel-Upload und API-Import können parallel genutzt werden. Die Daten werden per Upsert zusammengeführt.

Hinweise für Entwickler

Lieferavis-Daten übermitteln

POST /api/v3/.../consignee/advanced-shipping-notes

[
  {
    "advancedShippingNotice": "ASN-2026-001",
    "articleOrderNumber": "PO-12345",
    "sellableCode": "4711",
    "quantity": 100,
    "storageLocation": "Lager-Süd-A1"
  }
]

Pflichtfelder

• advancedShippingNotice
• articleOrderNumber
• sellableCode
• quantity

Optionale Felder

• consigneeOrderNumber
• storageLocation
• description

Weitere Regeln

• Maximal 500 Einträge pro Request
• Upsert-Verarbeitung auf Basis von advancedShippingNotice
• Erfolgreiche Verarbeitung liefert 204 No Content
• Doppelte Kombinationen aus articleOrderNumber und sellableCode innerhalb eines Requests führen zu 400 Bad Request

Gespeicherte Daten abrufen

GET /api/v3/.../consignee/advanced-shipping-notes

Der Response enthält alle Lieferavis-Datensätze inklusive:

• dateCreated
• dateUpdated

(beides als UNIX-Timestamp in Millisekunden)

Zuordnung zu Artikelpositionen

Die Zuordnung erfolgt automatisch beim Abruf der Artikeldaten über:

• articleOrderNumber
• sellableCode

mit Fallback auf:

• articleNumber

Folgende Informationen werden anschließend im Artikel-Response bereitgestellt:

• expectedQuantity (avisierte Menge)
• qsStatus (QS-Ampel)
• metaData (z. B. ASN-Kennung und Lagerort)

Scan-Code-Darstellung

• Strichcode: ngx-barcode6 (CODE128, Breite 2 px, Höhe 100 px)
• QR-Code: ng-qrcode (QrCodeComponent)
• Darstellung im Artikeldialog unter dem Reiter „CODES“
• Umschaltung zwischen Barcode und QR-Code per Slide-Toggle
• Angezeigte Werte:
  • advancedShippingNotice
  • sellableCode

Die API-Endpunkte sind vollständig in der Cloud4Log Addons API-Dokumentation dokumentiert.