Featureinformationen
Strukturierte Rückmeldung aus dem Wareneingang
Erfahren Sie sofort und strukturiert, was bei der Warenannahme passiert ist: Über die API rufen Sie alle im Wareneingang dokumentierten Abweichungen auf Artikelebene ab – zusammen mit den vollständigen Artikeldaten des jeweiligen Lieferscheins.
So können Sie Überlieferungen, Unterlieferungen, nicht avisierte Artikel und Annahmeverweigerungen direkt in Ihr ERP- oder Reklamationsmanagement übernehmen, ohne auf manuelle Berichte oder Rückrufe warten zu müssen.
Fachlicher Mehrwert
Der an der Lieferkette beteiligte Warenversender (WA) kann die vom Wareneingang (WE) erfassten strukturierten Artikeldaten sowie die dort dokumentierten Abweichungen auf Artikelebene per API abrufen und in seinen eigenen IT-Systemen weiterverarbeiten.
Der Warenversender kann bereits über die Basis-API Lieferschein-Metadaten (LS-Nummer, avisiertes Datum, Status), Ladungsträger und Abweichungen auf Lieferscheinebene abrufen. Mit Feature A17 erhält der Warenversender darüber hinaus Zugriff auf die strukturierten Artikelpositionen und Abweichungen auf Artikelebene — also die vom Wareneingang erfassten Einzelpositionen mit konkreter Zuordnung zu Artikelnummer, Menge und Abweichungsgrund.
Reklamationsmanagement: Abweichungen (Überlieferung, Unterlieferung, Annahmeverweigerung, nicht avisierte Ware) werden pro Artikelposition strukturiert bereitgestellt — der Warenversender kann diese Daten direkt in sein ERP- oder Reklamationssystem übernehmen, ohne manuelle Nacherfassung. Qualitätskontrolle: Der Warenversender sieht, welche Artikelpositionen vom Wareneingang als geprüft markiert wurden und welche Abweichungen dabei festgestellt wurden — inklusive Mengenangabe, Einheit und Freitextnotiz. Lieferqualität verbessern: Durch die systematische Auswertung der Abweichungsdaten über alle Lieferungen hinweg kann der Warenversender seine Lieferqualität kontinuierlich verbessern (z.B. häufige Unterlieferungen bei bestimmten Artikeln erkennen). Automatisierung: Alle Daten sind maschinenlesbar über die API verfügbar — eine manuelle Sichtung von PDFs oder Rückfragen beim Empfänger entfällt.
Information für Frontend-Nutzer
Diese Funktion ist ein reines API-Feature für den Warenversender. Es gibt aktuell keine dedizierte Frontend-Ansicht für den Warenversender, um die Abweichungen auf Artikelebene einzusehen. Die Daten werden ausschließlich über die API bereitgestellt und sind für die Integration in eigene IT-Systeme des Warenversenders vorgesehen.
Information für API-Nutzer
Voraussetzung: Der Standort des Warenversenders benötigt das Feature-Flag consignorArticlesRead (CONSIGNOR_ARTICLES_READ).
Betroffene API-Endpunkte
Artikeldaten lesen (v2):
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles |
Ruft alle Artikelpositionen eines Lieferscheins als strukturierte Artikeldaten ab. |
Dieser Endpunkt ist rollenunabhängig. Der Zugriff wird intern anhand des Feature-Flags consignorArticlesRead und der Standortrolle consignor geprüft. [5] Artikeldaten sind erst verfügbar, wenn der Lieferschein in einer Mappe mit Status sent oder closed ist — im Status open hat nur der Consignor (als Ersteller) Zugriff.
Abweichungen auf Artikelebene lesen (v2):
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies |
Alle Abweichungen zu einem Artikel abrufen. |
| GET | /v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies/{discrepancyKey} |
Eine einzelne Abweichung zu einem Artikel anhand der Abweichungs-ID abrufen. |
Artikelnotizen (v3):
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| POST | /v3/organization-sites/{siteKey}/consignor/delivery-notes/{dnKey}/articles/{articleKey}/notes |
Erstellt eine Notiz zu einer Artikelposition (Feature-Flag: consignorArticlesEditing). |
| GET | `/v3/organization-sites/{siteKey}/delivery-notes/{dnKey}/article |
Hinweise für Entwickler
Anbindung in 3 Schritten:
Schritt 1 — Lieferscheine des Standorts abrufen Zunächst die Lieferscheine des eigenen WA-Standorts abfragen, z.B. über die v3-Pagination: GET /v3/organization-sites/{siteKey}/consignor/delivery-notes
Schritt 2 — Artikeldaten je Lieferschein laden GET /v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles Im Response-Array hat jeder Artikel das Feld hasDiscrepancy. Nur für Artikel mit hasDiscrepancy: true müssen Abweichungen abgefragt werden.
Schritt 3 — Abweichungen je Artikel abrufen GET /v2/organization-sites/{siteKey}/delivery-notes/{dnKey}/articles/{articleKey}/discrepancies Liefert ein Array aller Abweichungen mit reason, number, unit und note.
Hinweise:
- Artikeldaten sind erst abrufbar, wenn der Lieferschein in einer versendeten oder geschlossenen Mappe liegt (Status sent oder closed). Im Status open sind die Daten nur für den Ersteller (Consignor) sichtbar, aber Abweichungen entstehen erst nach dem Checkin am WE.
- Das Feld isAutomatic in der Abweichung zeigt an, ob die Abweichung automatisch durch den Warenvereinnahmungs-Abgleich (Articles Compare) erstellt wurde oder manuell durch den MA am WE.
- Das Feld isAI am Artikel kennzeichnet KI-erkannte Positionen. Diese können vom WE manuell korrigiert worden sein — die aktuellen Werte im Response spiegeln immer den finalen Stand wider.
- Authentifizierung erfolgt per API-Key des WA-Standorts. Der Standort muss die Rolle consignor und das Feature-Flag consignorArticlesRead aktiviert haben.