Für große Sortimente

GARAN-Labels für ein großes Sortiment erzeugen: CSV oder API

Sie wollen GARAN-Labels für einige hundert oder einige tausend Produkte in Serie erzeugen und brauchen vorher drei Antworten: Schafft das Tool mein Sortiment, was kostet es und wie lange dauert es? Diese Seite beantwortet alle drei mit konkreten Zahlen.

Welche Methode passt zu Ihrem Sortiment?

Die passende Methode hängt von zwei Dingen ab: Wie viele Produkte brauchen ein Label, und wie oft ändern sich diese Daten?

Methode	Sortimentsgröße	Änderungshäufigkeit	Geeignet für
Manuelle Eingabe	Weniger als 10 Labels	Selten	Kleine Shops, eine Handvoll Produkte mit Garantie, gelegentliche Ergänzungen.
CSV-Upload	10 bis 10.000 Labels	Weitgehend statisch, alle paar Monate eine Aktualisierung	Händler und Marken mit großem, aber stabilem Sortiment. Ohne Programmierung.
API	Jede Größe	Häufige Änderungen, jede Woche neue Produkte	Shops mit PIM oder Warenwirtschaft im Hintergrund, Agenturen, alle, die Labels automatisch beim Anlegen eines Produkts erzeugen wollen.

Die Methoden lassen sich kombinieren: Die meisten großen Sortimente starten mit einem CSV-Lauf für den Bestand und wechseln für neue Produkte zur API. Die technischen Details zu beiden stehen auf der API- & CSV-Referenzseite.

Erst filtern, dann erzeugen: Welche Artikel brauchen überhaupt ein Label?

Der wirksamste Hebel für die Kosten eines Serienlaufs liegt vor dem Upload. Das GARAN-Label ist nur für Produkte erforderlich, für die ein Hersteller eine kostenlose Haltbarkeitsgarantie über das gesamte Produkt mit einer Laufzeit von mehr als zwei Jahren anbietet. Alle anderen Produkte brauchen das kostenlose Gewährleistungslabel, aber kein GARAN-Label.

Prüfen Sie Ihren Produktexport anhand von drei Fragen:

Ist es eine physische Ware? Digitale Inhalte und Dienstleistungen sind nicht betroffen.
Gibt es eine Herstellergarantie von mehr als zwei Jahren? Eine Garantie von genau zwei Jahren oder weniger löst keine Labelpflicht aus.
Ist sie kostenlos und gilt sie für das ganze Produkt? Kostenpflichtige Garantieverlängerungen und Garantien auf einzelne Bauteile zählen nicht.

In der Praxis schrumpft ein Sortiment mit 5.000 Artikeln oft auf einige hundert Produkte, die tatsächlich in Frage kommen. Alles andere streichen Sie vor dem Upload aus der CSV. Details dazu, für wen die Pflicht gilt →

Was Sie pro Artikel brauchen: Marke, Modell, Garantiedauer

Das Label selbst ist einfach. Es trägt drei Werte, und genau diese drei Spalten braucht die CSV:

brand

Die Marke, wie sie auf dem Produkt steht.

model

Die Modellbezeichnung. Varianten mit derselben Bezeichnung teilen sich das Label.

duration

Die Garantiedauer in Jahren, ganz oder halb, zum Beispiel 3 oder 2.5.

Der ehrliche Knackpunkt: die Garantiedauer

Marke und Modell gibt es in jedem Shopsystem. Die Garantiedauer des Herstellers meist nicht. Die meisten Produktdatenbanken haben bestenfalls ein Feld „Garantie", und darin stehen oft die eigenen Bedingungen des Händlers statt der Herstellergarantie. Wo die Daten üblicherweise stecken:

In Lieferanten-Preislisten und Produktdatenblättern, oft als Freitext-Bemerkung.
In den Garantiebedingungen auf der Herstellerwebsite oder in der Packungsbeilage.
In einem PIM- oder ERP-Attribut, das einmal für ein paar Marken gefüllt und nie gepflegt wurde.

Praktische Abkürzung: Hersteller legen die Dauer selten pro Artikel fest. Sie ist meist pro Marke oder Produktserie konstant. Erfassen Sie die Dauer einmal pro Marke und Serie und verknüpfen Sie sie mit Ihrem Artikelexport. Aus einer Recherche über tausende Zeilen wird so eine Liste mit ein paar Dutzend Einträgen.

Rechenbeispiel: ein Sortiment mit 1.000 Artikeln

Die Zahlen unten sind eine Illustration mit runden Werten, keine Messung bei einem bestimmten Kunden. Sie zeigen, wie die Rechnung funktioniert, damit Sie Ihr eigenes Sortiment einsetzen können.

Artikel im Shop	1.000	Vollständiger Export, alle Kategorien.
Artikel mit Herstellergarantie über zwei Jahre	380	Nach den drei Filterfragen oben. Die übrigen 620 brauchen nur das kostenlose Gewährleistungslabel.
Eindeutige Kombinationen aus Marke + Modell + Dauer	240	Größen und Farben teilen sich eine Modellbezeichnung und damit ein Label.
Verbrauchte Credits	240	Ein Credit pro gerendertem Label. Zeilen mit doppelter Kombination nutzen das vorhandene Label.
Credit-Paket	500 Credits für 49 €	Lässt 260 Credits für neue Produkte übrig. Alternativ zwei 100er-Pakete für 38 €, wenn das Sortiment nicht wächst.
Ihr Zeitaufwand	Ein halber Tag	Fast alles davon geht in die Recherche der Garantiedauern. Der Upload dauert Minuten, die Erzeugung läuft unbeaufsichtigt.

Das Ergebnis ist eine Datei mit einer Zeile pro Eingabezeile und der URL des passenden Labels. Anschließend laden Sie die Bilder herunter und hinterlegen sie im Shop, siehe unten.

Die CSV-Datei vorbereiten

Jedes Tabellenprogramm kann die Datei erzeugen. Worauf es ankommt:

Spalten: brand, model, duration und optional force_regeneration (1 erzwingt eine Neuerzeugung, leer oder 0 verwendet ein vorhandenes Label).
Trennzeichen: Komma oder Semikolon. Der Upload erkennt anhand der Kopfzeile, welches Sie verwendet haben.
Zeichensatz: UTF-8, damit Umlaute, Akzente und Sonderzeichen in Marken- und Modellnamen unverändert ankommen.
Zeilen- und Dateigrößenlimit: keines. Die Datei wird Zeile für Zeile eingelesen, egal wie groß sie ist.
Format: Vor dem Upload wählen Sie PNG, EPS oder PDF für die gesamte Datei. PNG brauchen Sie für den Shop, EPS und PDF sind für den Druck.
Verarbeitung: läuft im Hintergrund mit Fortschrittsanzeige. Sie können den Tab schließen, sich abmelden und später wiederkommen; der Auftrag läuft weiter.

brand;model;duration;force_regeneration
Bosch;GSR 18V-55;3;
Bosch;GSR 18V-55;3;
Makita;DHP486;3;
Miele;W1 WCD 120;5;

Die beiden Bosch-Zeilen sind Absicht: Sie zeigen, was die Deduplizierung tut. Beide Zeilen erhalten dieselbe Label-URL, nur ein Credit wird verbraucht.

Eingabe: eine Zeile pro Produkt oder pro Modell.

Ergebnisdatei eines GARAN-Label-Serienlaufs mit zusätzlicher Spalte Label-URL pro Zeile

Ausgabe: dieselben Zeilen plus die Label-URL zu jeder.

Deduplizierung: der Kostenhebel bei Serienläufen

Ein Credit bezahlt ein gerendertes Label, nicht eine Zeile in Ihrer Datei. Die Regel ist einfach: identische Marke + Modell + Dauer ergibt ein Label, egal wie viele Zeilen oder Produktvarianten darauf zeigen. Drei Folgen für ein großes Sortiment:

Varianten sind kostenlos. Zehn Farbvarianten eines Modells verbrauchen einen Credit.
Dieselbe Datei erneut hochzuladen kostet nichts, solange die Labels noch auf unserem Server liegen. Sie erhalten die vorhandenen URLs zurück.
Nur echte Änderungen kosten Credits. Eine geänderte Garantiedauer ist eine neue Kombination und damit ein neues Label. Auch force_regeneration mit 1 rendert neu und verbraucht einen Credit, lassen Sie das Feld also leer, solange Sie keine frische Datei brauchen.

Die Rechnung aus dem Beispiel oben: 1.000 Zeilen, 240 eindeutige Kombinationen, 240 Credits. Abgerechnet wird pro gerendertem Label, nicht pro Monat und nicht pro Nutzerplatz. Ein Sortiment, das sich nicht ändert, kostet also nicht laufend Geld.

Credit-Pakete

Credits	Preis	Preis pro Label
100	19,00 €	0,19 €
500	49,00 €	0,10 €
2.000	144,00 €	0,07 €
10.000	569,00 €	0,06 €

Alle Preise zzgl. gesetzlicher Umsatzsteuer. 1 Credit entspricht 1 neu erzeugtem Label. Identische Wiederholungen (gleiche Marke, gleiches Modell, gleiche Garantiedauer) kosten kein zusätzliches Credit. Kein Abo, keine Mindestabnahme.

Die Dateien in den Shop bringen: gehostete URLs oder Self-Hosting

Jedes erzeugte Label ist über die URL in Ihrer Ergebnisdatei erreichbar. Für ein großes Sortiment gibt es zwei Wege, sie zu nutzen:

Gehostete URL (kurzfristig)

Das Bild direkt verlinken. Gut zum Testen und zum schnellen Befüllen des Shops, aber Labels werden 30 Tage nach der Erzeugung archiviert. Danach bricht der Link, und ein erneuter Abruf rendert das Label neu und verbraucht einen Credit.

Self-Hosting (empfohlen)

Laden Sie die Bilder innerhalb der 30 Tage herunter, legen Sie sie in Ihrer eigenen Medienbibliothek oder auf Ihrem CDN ab und ordnen Sie sie über Artikelnummer oder Modell den Produkten zu. Das ist einmalige Arbeit, und das Label bleibt so lange online, wie Sie es brauchen.

Wie die Zuordnung funktioniert, hängt von Ihrer Plattform ab: ein Metafield in Shopify, ein Produktattribut in Magento 2, ein Custom Field in WooCommerce. Jede Anleitung beschreibt den Weg für große Mengen. Anleitungen nach Verkaufskanal →

Fehler und Sonderfälle in großen Dateien

Situation	Was passiert	Was zu tun ist
Eine Zeile hat kein Modell (oder keine Marke oder keine Dauer)	Nur diese Zeile wird in der Ergebnisdatei als Fehler markiert. Alle anderen Zeilen werden verarbeitet.	Zeile korrigieren und in einer kleinen Nachzügler-Datei erneut hochladen.
In der Kopfzeile fehlt eine Pflichtspalte	Der gesamte Auftrag stoppt mit der Meldung „Missing required column".	Spaltennamen prüfen: exakt `brand`, `model`, `duration`.
Die Kopfzeile sieht richtig aus, trotzdem fehlt angeblich die Spalte `brand`	Die Datei beginnt sehr wahrscheinlich mit einer unsichtbaren Byte-Order-Markierung. Excel fügt sie beim Speichern als „CSV UTF-8" ein.	Als einfache CSV speichern oder die Markierung mit einem Texteditor entfernen. Die Spaltennamen müssen am allerersten Byte beginnen.
Zeilen mit einer Dauer von zwei Jahren oder weniger	Sie werden wie jede andere Zeile erzeugt und verbrauchen einen Credit. Das Tool entscheidet nicht für Sie, ob ein Label erforderlich ist.	Vor dem Upload herausfiltern; diese Produkte brauchen kein GARAN-Label.
Größen und Farben als eigene Zeilen	Zeilen mit gleicher Marke, gleichem Modell und gleicher Dauer teilen sich ein Label und einen Credit.	Nichts. Behalten Sie die Zeilen, wenn sich das Ergebnis so leichter Ihren Artikelnummern zuordnen lässt.
Kommas oder Semikolons im Modellnamen	Es gilt die übliche CSV-Quotierung.	Wert in doppelte Anführungszeichen setzen, wie es jedes Tabellenprogramm automatisch tut.
Umlaute und Akzente sehen im Label falsch aus	Die Datei wurde in einem veralteten Zeichensatz gespeichert.	Als UTF-8 speichern und für die betroffenen Zeilen mit `force_regeneration` gleich `1` erneut hochladen.

Testen Sie zuerst die Dateistruktur: Der Sandbox-Modus funktioniert auch für CSV-Uploads und rendert PNG-Muster mit Wasserzeichen, ohne Credits zu verbrauchen.

Bereit, Ihr gesamtes Sortiment zu kennzeichnen?

Kostenlos registrieren, eine Testdatei im Sandbox-Modus hochladen und das Ergebnis prüfen, bevor Sie einen einzigen Credit kaufen.

Kostenlos testen

Sie brauchen die technischen Parameter und Beispielcode? API- & CSV-Referenz →

Wer das GARAN-Label überhaupt braucht →
Einbindungs-Anleitungen nach Verkaufskanal →

FAQ

Fragen zur Massenerstellung von GARAN-Labels

Wie lange dauert es, 1.000 GARAN-Labels zu erzeugen?

Etwa zwei bis vier Minuten. Sie laden die Datei einmal hoch, die Erzeugung läuft auf unseren Servern im Hintergrund in Paketen weiter, auch wenn Sie den Browser schließen. Danach laden Sie die Ergebnisdatei herunter. Bei einem Sortiment dieser Größe planen Sie einen Nachmittag für die Datenaufbereitung ein, nicht für die Erzeugung selbst.

Gibt es ein Zeilen- oder Größenlimit für den CSV-Upload?

Nein, weder für die Zeilenzahl noch für die Dateigröße. Die Datei wird Zeile für Zeile eingelesen und im Hintergrund verarbeitet, sehr große Sortimente funktionieren also ohne Aufteilen der Datei. Wer mag, lädt trotzdem eine Datei pro Marke oder Lieferant hoch, damit die Ergebnisdateien überschaubar bleiben.

Zahle ich für jede Zeile in meiner CSV?

Nein. Ein Credit wird nur verbraucht, wenn ein Label tatsächlich gerendert wird. Zeilen mit identischer Kombination aus Marke, Modell und Garantiedauer teilen sich ein Label, und eine Zeile, die ein vorhandenes Label innerhalb seiner 30-Tage-Frist nur erneut abruft, kostet nichts.

Braucht jede Variante wie Größe oder Farbe ein eigenes Label?

In der Regel nicht. Das Label zeigt Marke, Modell und Garantiedauer. Teilen sich Ihre Varianten dieselbe Modellbezeichnung und dieselbe Garantie, deckt ein Label alle ab. Genau hier spart die Deduplizierung Credits.

Was unterscheidet diese Seite von der API-Seite?

Diese Seite hilft bei der Entscheidung, wie Sie ein großes Sortiment kennzeichnen und was das kostet. Die API-Seite ist die technische Referenz mit Parametern und Beispielcode für cURL, PHP, Python und Node.js. API- & CSV-Referenz →

Weitere Fragen? Alle FAQs ansehen →