Automatische Bereitstellung von ASN-Daten

ASN-Daten automatisch bereitstellen

ASN-Daten (Advanced Shipping Notices) werden automatisch aus vorgelagerten Systemen übernommen und den Artikelpositionen im digitalen Lieferschein zugeordnet. Ein manueller Upload von Excel-Dateien ist dadurch nicht mehr erforderlich.

Anhand von Bestellnummer und Artikelnummer werden die avisierten Lieferdaten mit den tatsächlich gelieferten Artikeln abgeglichen. Abweichungen können direkt im Wareneingang erkannt und für die weitere Prüfung genutzt werden. Zusätzlich stehen die ASN-Informationen für Scan-Prozesse sowie für weiterführende Qualitäts- und Wareneingangsprüfungen zur Verfügung.

So können Wareneingänge bereits vor Eintreffen der Ware besser vorbereitet und Prüfprozesse effizienter durchgeführt werden.

Fachlicher Mehrwert

Mit der automatisierten Übernahme von Lieferavis-Daten (ASN – Advanced Shipping Notice) können Unternehmen ihre Bestelldaten aus dem eigenen ERP- oder Warenwirtschaftssystem per API an Cloud4Log Addons übermitteln. Cloud4Log Addons ordnet diese Daten automatisch den Artikelpositionen der Lieferscheine zu und stellt sie im Wareneingang bereit.

Mehrwert

• Automatische Zuordnung zu Lieferscheinpositionen: Die übermittelten Lieferavis-Daten werden anhand der Bestellnummer (PO-Nummer) und der Empfänger-Artikelnummer automatisch den passenden Artikelpositionen zugeordnet.
• Grundlage für die QS-Ampel: Die avisierte Bestellmenge wird mit der im Lieferschein ausgewiesenen Menge verglichen. Das Ergebnis wird als QS-Ampel (Grün, Gelb oder Rot) angezeigt.
• Lagerort je Artikelposition: Wird ein Lagerort übermittelt und kann die Position zugeordnet werden, wird dieser direkt in der Artikelansicht angezeigt.
• ASN als Strichcode und QR-Code: Die ASN-Kennung wird als Barcode und QR-Code dargestellt und kann mit Handscannern erfasst werden.
• Schrittweise Aktualisierung (Upsert): Über die API v3 können bestehende ASN-Daten aktualisiert und neue Einträge ergänzt werden, ohne den vollständigen Bestand neu zu übertragen.
• Nahtlose ERP-Integration: Lieferavis-Daten können automatisiert aus ERP- oder Warenwirtschaftssystemen an Cloud4Log Addons übertragen werden.

In welcher Form müssen die Daten bereitgestellt werden?

Die Daten werden als JSON-Array über die API übermittelt. Jeder Eintrag entspricht einer avisierten Artikelposition.

Pflichtfelder

Feld	Beschreibung	Beispiel
advancedShippingNotice	Eindeutige ASN-Kennung (Lieferavis-Nummer)	ASN-2026-001
articleOrderNumber	Bestellnummer (PO-Nummer)	PO-12345
sellableCode	Empfänger-Artikelnummer (Item-Code)	4711
quantity	Avisierte Bestellmenge (> 0)	100

Optionale Felder

Feld	Beschreibung	Beispiel
consigneeOrderNumber	Bestellnummer des Empfängers	C-1002
storageLocation	Lagerort	Lager-Süd-A1
description	Artikelbeschreibung	Bio-Äpfel 1kg

Weitere Regeln:

• Maximal 500 Einträge pro Request
• Die Kombination aus articleOrderNumber und sellableCode darf innerhalb eines Requests nicht mehrfach vorkommen

Information für Frontend-Nutzer

Voraussetzung

Das Feature muss für Ihren Standort aktiviert sein. Die Lieferavis-Daten müssen zuvor entweder per API oder per Excel-Import geladen worden sein.

Wo sehen Sie die Lieferavis-Daten?

Im Reiter „Artikel & Abweichungen“ wirken sich die importierten Daten auf mehrere Bereiche aus.

• Spalte „Lagerort“: Zeigt den aus den Lieferavis-Daten zugeordneten Lagerort an.
• Spalte „QS Status“: Zeigt den Mengenabgleich zwischen Lieferavis und Lieferschein.

QS-Ampel

• Grün: Mengen stimmen überein
• Gelb: Mengen weichen voneinander ab (Tooltip zeigt die erwartete Menge)
• Rot: Kein passender Lieferavis-Eintrag gefunden

ASN als Strichcode und QR-Code

Die ASN-Kennung kann als Barcode oder QR-Code dargestellt und mit einem Handscanner erfasst werden.

QS-Ampel auf übergeordneten Ebenen

Die QS-Ampel wird zusätzlich auf folgenden Ebenen als aggregierter Status dargestellt:

• Lieferschein
• Mappe
• Tour

Es gilt das Prinzip „Worst Wins“.

Hinweis

Lieferavis-Daten können alternativ auch per Excel-Datei importiert werden. Der API-Import eignet sich insbesondere für automatisierte ERP-Anbindungen.

Information für API-Anbindung (fachliche Aspekte)

Lieferavis-Daten importieren und abrufen

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	Bestehende Lieferavis-Daten vollständig ersetzen

Die vollständige API-Dokumentation finden Sie in der Cloud4Log Addons API-Dokumentation.

Benötigtes Feature-Flag

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

Unterschied zwischen API v2 und API v3

Eigenschaft	API v3	API v2
Schreibverhalten	Upsert (aktualisieren und ergänzen)	Vollständiges Ersetzen
Feld quantity	Pflichtfeld vorhanden	Nicht vorhanden
Zeitstempel	Automatisch durch Server erzeugt	Muss vom Client geliefert werden
Maximale Einträge	500 pro Request	Kein Limit

Fachliche Einsatzmöglichkeiten

• ERP-Anbindung: Automatische Übertragung von Bestell- und Lieferavis-Daten.
• Schrittweise Aktualisierung: Neue Positionen können ergänzt werden, ohne den gesamten Datenbestand neu zu senden.
• Handscanner-Integration: ASN-Kennungen können über Barcode oder QR-Code verarbeitet werden.

Hinweise für Entwickler

Lieferavis-Daten übermitteln (API v3)

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

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

Pflichtfelder

• advancedShippingNotice
• articleOrderNumber
• sellableCode
• quantity

Optionale Felder

• consigneeOrderNumber
• storageLocation
• description

Weitere Regeln

• Maximal 500 Einträge pro Request
• Erfolgreiche Requests liefern 204 No Content
• Bestehende Datensätze werden anhand von advancedShippingNotice aktualisiert
• Neue Datensätze werden ergänzt
• Doppelte Kombinationen aus articleOrderNumber und sellableCode führen zu einem Fehler 400 Bad Request

Gespeicherte Daten abrufen

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

Die Antwort enthält alle gespeicherten Einträge inklusive:

• dateCreated
• dateUpdated

(beides als UNIX-Timestamp in Millisekunden)

Zuordnung zu Artikelpositionen

Die Zuordnung erfolgt automatisch beim Abruf der Artikeldaten:

• Matching über articleOrderNumber und sellableCode
• Fallback auf articleNumber

Ergebnis im Artikel-Response:

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

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