GGN und Herkunftsland je Artikelposition

GGN und Herkunftsland im Check-In

Im Check-In können Mitarbeitende im Wareneingang je Artikelposition die GGN sowie das Herkunftsland einsehen und sortieren. Die Angaben werden entweder per KI aus dem Lieferschein extrahiert oder über die strukturierten Artikeldaten per API bereitgestellt.

So lassen sich herkunfts- und qualitätsrelevante Informationen direkt im Wareneingang prüfen und bei Bedarf für nachgelagerte Prozesse weiterverwenden.

Fachlicher Mehrwert

Im Reiter „Artikel & Abweichungen“ werden in der Artikelliste die GGN (GLOBALG.A.P.-Nummer) und das Herkunftsland pro Artikelposition angezeigt, sofern diese über die KI-Auslesung oder strukturierte Daten des Warenversenders erfasst wurden.

Was das Feature bietet

• Anzeige der GGN (GLOBALG.A.P. Number), einer 13-stelligen Zertifizierungsnummer zur eindeutigen Identifikation eines Erzeugers in der GLOBALG.A.P.-Datenbank
• Anzeige des Herkunftslands pro Artikelposition
• Korrektur von GGN und Herkunftsland durch den Warenempfänger, wenn die Werte durch die KI nicht korrekt erkannt oder vom Warenversender unvollständig bereitgestellt wurden
• Historisierung aller Korrekturen inklusive Originalwert, korrigiertem Wert, Bearbeiter und Zeitstempel

Datenquellen

• KI-Extraktion: Die KI erkennt GGN und Herkunftsland automatisch aus dem PDF-Lieferschein (ggn als nullable String, countryOfOrigin als ISO-3166-1-Alpha-2-Code)
• Strukturierter Upload durch Warenversender: Beide Felder können beim Upload der Artikeldaten per API übermittelt werden
• Korrektur durch Warenempfänger: Beide Felder können über den Bearbeitungsdialog oder per API korrigiert werden

Mehrwert

• Prüfrelevante Herkunftsangaben stehen direkt in der Wareneingangskontrolle zur Verfügung, ohne manuelles Nachschlagen im Papierlieferschein
• Unterstützung der Bio-Kontrolle, da das Herkunftsland eine Pflichtangabe für verpackte Bio-Lebensmittel ist
• Die GGN ermöglicht eine Rückverfolgbarkeit bis zum Erzeuger und ist insbesondere für Obst-, Gemüse- und Aquakulturprodukte relevant
• Beide Felder sind sortierbar, sodass Positionen gleicher Herkunft oder desselben Erzeugers gruppiert werden können

Information für Frontend-Nutzer

In der Artikeltabelle stehen zwei zusätzliche Spalten zur Verfügung:

• GGN – Zeigt die 13-stellige GLOBALG.A.P.-Nummer des Erzeugers an
• Herkunft – Zeigt das Herkunftsland der Artikelposition an

Funktionen

• Beide Spalten sind per Klick auf die Spaltenüberschrift sortierbar
• Beide Spalten können über den Dialog „Spalten ein-/ausblenden“ individuell ein- oder ausgeblendet werden
• Die Position der Spalten kann per Drag-and-Drop angepasst werden
• Wurde ein Wert vom Warenempfänger korrigiert, wird der korrigierte Wert angezeigt. Der Originalwert bleibt in der Historie erhalten.

Bearbeitung

• Über das Aktionsmenü (Drei-Punkte-Symbol) → „Bearbeiten“ können GGN und Herkunftsland im Bearbeitungsdialog erfasst oder korrigiert werden
• Die GGN muss entweder leer sein oder genau 13 Ziffern enthalten

Information für API-Anbindung (fachliche Aspekte)

GGN und Herkunftsland werden als Bestandteil der Artikeldaten über die bestehenden Artikel-Endpunkte bereitgestellt und bearbeitet. Es gibt keine separaten Endpunkte für E18.

Methode	Pfad	Beschreibung
GET	.../delivery-notes/{deliveryNoteKey}/articles	Artikelpositionen abrufen (inkl. ggn und countryOfOrigin)
PATCH	.../consignee/articles/{articleKey}/edit	GGN und Herkunftsland korrigieren (Feature-Flag: consigneeArticlesEditing)

Die vollständige API-Spezifikation ist in der Swagger-Dokumentation unter Cloud4Log Addons API-Dokumentation einsehbar.

Datenmodell

Feld	Typ	Beschreibung
ggn	string, nullable	13-stellige GLOBALG.A.P.-Nummer des Erzeugers
countryOfOrigin	string, nullable	Herkunftsland gemäß ISO 3166-1 Alpha-2 (z. B. DE, ES, NL)

Bei korrigierten Werten enthält das edits-Objekt die Änderungen:

{
  "edits": {
    "ggn": {
      "value": "4049929000002",
      "editedBy": "...",
      "editedOn": 1718900000000
    },
    "countryOfOrigin": {
      "value": "ES",
      "editedBy": "...",
      "editedOn": 1718900000000
    }
  }
}

Fachliche Einsatzmöglichkeiten in eigenen Systemen

• Rückverfolgbarkeit: Automatische Übernahme der GGN in QM-Systeme zur lückenlosen Erzeugeridentifikation
• Herkunftsprüfung: Automatischer Abgleich des Herkunftslandes mit Bestellvorgaben (z. B. nur EU-Ware oder definierte Ursprungsländer)
• Bio-Compliance: Automatisierte Erfassung und Archivierung des Herkunftslandes als Pflichtangabe für Bio-Lebensmittel

Hinweise für Entwickler

GGN und Herkunftsland korrigieren

curl -X PATCH \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"ggn":"4049929000002","countryOfOrigin":"ES"}' \
  "