Glossar

Fach- und technische Begriffe, denen Sie bei der Arbeit mit lebensmittel begegnen. Die Optionsreferenz finden Sie in der README, das vollständige Kochbuch in Usage.md.

Das Portal

lebensmittelwarnung.de. Das amtliche Portal Deutschlands für öffentliche Produktwarnungen, betrieben vom Bundesamt für Verbraucherschutz und Lebensmittelsicherheit (BVL) gemeinsam mit den sechzehn Ländern. Die zuständige Behörde jedes Landes veröffentlicht ihre eigenen Warnungen; das BVL betreibt Portal und App. Es ist die zentrale bundesweite Stelle, an der Rückrufe von Lebensmitteln und Verbraucherprodukten öffentlich bekannt gemacht werden.

BVL – Bundesamt für Verbraucherschutz und Lebensmittelsicherheit. Die Bundesbehörde, die das Portal betreibt und als Herausgeber für Warnungen mit dem Geltungsbereich „Deutschland“ (bundesweit) verantwortlich ist.

Warnungen

Warnung / Rückruf (warnings). Eine öffentliche Produktwarnung – meist ein Rückruf: der Hinweis, dass ein bestimmtes Produkt (nach Name, Charge und Mindesthaltbarkeit) ein Risiko darstellen kann und nicht verzehrt bzw. verwendet werden sollte. In dieser CLI ist jede Warnung ein Eintrag des RSS-Feeds.

Grund der Meldung (reason). Der Grund, aus dem die Warnung herausgegeben wurde, als Kategorie. Am 15.09.2026 verwendete der Live-Feed sieben: Allergene, Fremdkörper, Gesundheitsschädliche Substanz, Irreführung und Täuschung, Krankheitserreger (etwa Listerien oder Salmonellen, die der Feed nicht nennt), Rückstände und Kontaminanten und Sonstige Gründe. Eine Warnung kann mehrere tragen, verbunden mit , . Das nützlichste Feld für eine erste Einordnung.

Hersteller / Inverkehrbringer (manufacturer). Der Hersteller oder derjenige, der das Produkt in Verkehr gebracht hat. Der Feed enthält die vollständige Postanschrift; diese CLI fasst sie in einer Zeile zusammen.

Betroffene Bundesländer nach derzeitigem Stand (affectedStates). Die Liste der Länder, in denen das Produkt nach derzeitigem Kenntnisstand vertrieben wurde – sie wird im Lauf der Zeit aktualisiert, und ein Land kann sich nach der Veröffentlichung selbst hinzufügen oder austragen. Bereitgestellt als string[]. Der Feed-Filter --state wählt nach dieser Liste aus: Der Feed eines Landes enthält die Warnungen, deren affectedStates dieses Land nennen – gleich, wer sie herausgegeben hat.

Chargennummer / Los-Kennzeichnung (lotNumbers). Die Chargen- bzw. Loskennungen der betroffenen Einheiten – die Codes auf der Verpackung, an denen Sie erkennen, ob Ihr Exemplar betroffen ist.

Haltbarkeit (bestBefore). Angaben zur Haltbarkeit – ein Mindesthaltbarkeitsdatum (MHD) oder ein Verbrauchsdatum, ebenfalls zum Abgleich mit Ihrem Exemplar.

Verpackungseinheit (packaging). Die Verpackungseinheit bzw. -größe, z. B. „175 Gramm-Packung“.

Bildquelle. Der Bildnachweis für das Produktfoto (© beim Hersteller oder einer Agentur). Er steht in der allgemeinen Map fields. Die Bilder selbst (imageUrls) sind urheberrechtlich geschützt – siehe DATA_LICENSE.md.

Produkttypen (`--type` / `types`)

Der Feed-Filter type= akzeptiert fünf Slugs für Produktkategorien:

Slug	Bezeichnung	Umfang
`lebensmittel`	Lebensmittel	Lebensmittel und Getränke (der Großteil der Warnungen)
`kosmetischemittel`	Kosmetische Mittel	Kosmetik
`bedarfsgegenstaende`	Bedarfsgegenstände	Gegenstände mit Lebensmittelkontakt oder für den täglichen Gebrauch (Verpackungen, Küchenutensilien, Textilien, …)
`mittelzumtaetowieren`	Mittel zum Tätowieren	Tätowierfarben / -mittel
`babyundkinderprodukte`	Baby- und Kinderprodukte	Produkte für Babys und Kinder

Bundesländer (`--state` / `states`)

Der Feed-Filter state= akzeptiert sechzehn Slugs für die Bundesländer (kleingeschrieben, ohne Leerzeichen und Umlaute). Die maßgebliche Liste liefert lebensmittel states; die Zuordnung lautet:

Slug	Bundesland
`badenwuerttemberg`	Baden-Württemberg
`bayern`	Bayern
`berlin`	Berlin
`brandenburg`	Brandenburg
`bremen`	Bremen
`hamburg`	Hamburg
`hessen`	Hessen
`mecklenburgvorpommern`	Mecklenburg-Vorpommern
`niedersachsen`	Niedersachsen
`nordrheinwestfalen`	Nordrhein-Westfalen
`rheinlandpfalz`	Rheinland-Pfalz
`saarland`	Saarland
`sachsen`	Sachsen
`sachsenanhalt`	Sachsen-Anhalt
`schleswigholstein`	Schleswig-Holstein
`thueringen`	Thüringen

--state filtert nach der Vertriebsliste affectedStates, nicht nach dem Land, das die Warnung herausgegeben hat. Am 15.09.2026 lieferte --state thueringen genau die Warnungen, die „Thüringen“ in affectedStates nennen, und nur 4 dieser 179 stammten aus Thüringen. Ein Feld für die herausgebende Stelle hat der Feed nicht; die URL der Meldung enthält das herausgebende Land als Kürzel im Ordnernamen (siehe Usage.md).

Technische Begriffe

RSS 2.0. Das XML-Feedformat, das das Portal veröffentlicht. Jede Warnung ist ein <item> mit <title>, <link>, <pubDate> und einer HTML-<description> (in einem CDATA-Abschnitt). Diese CLI liest es mit einem selbst geschriebenen Parser ohne Abhängigkeiten.

pubDate / published. pubDate ist der RFC-822-Zeitstempel, wie er geliefert wird, in deutscher Zeit („Wed, 8 Jul 2026 16:00:00 +0200“); published ist derselbe Wert, normalisiert zu einem ISO-8601-String in UTC. --since filtert darauf, vergleicht aber Kalendertage in deutscher Zeit (Europe/Berlin): Eine Meldung mit dem Zeitstempel 00:00:00 +0200 zählt für ihren eigenen Tag, obwohl der Datumsteil von published der Vortag ist.

fields (Map Bezeichnung→Wert). Die vollständige Menge der Paare <b>Label:</b> value, die aus der Beschreibung gelesen werden, mit der deutschen Bezeichnung als Schlüssel (abschließender Doppelpunkt entfernt). Eine Obermenge der typisierten Accessoren – alles, was die CLI nicht eigens modelliert, steht trotzdem hier.

Alte JSON-API (außer Betrieb). Die frühere JSON-API unter megov.bayern.de (dokumentiert im Projekt bundesAPI / bund.dev), die diese Daten früher lieferte. Seit dem Relaunch des Portals liefert sie einen leeren Body und wird nicht verwendet – diese CLI bindet die RSS-Feeds ein. Siehe DEVELOPING.md.