idealo CSV-Feed: Pflichtfelder und Format für Shopify-Händler

Ein idealo-Feed scheitert selten an der Technik, sondern an einzelnen Spalten: eine Lieferzeit, die idealo nicht akzeptiert, ein Preis ohne Umsatzsteuer, ein Link, der die falsche Variante öffnet. Dieser Artikel geht die Spalten des idealo CSV-Formats durch und zeigt, woher die Werte in Shopify kommen.

Grundlage ist die offizielle CSV-Dokumentation von idealo. idealo ändert sie gelegentlich; prüfen Sie dort den aktuellen Stand, bevor Sie Ihren Feed umbauen.

Die Formatregeln

• Eine Zeile pro Angebot, jede Variante also eine eigene Zeile.
• UTF-8, Komma als Spaltentrennzeichen, Punkt als Dezimaltrennzeichen.
• Mehrere Werte in einer Spalte mit Semikolon trennen.
• Spaltenreihenfolge beliebig, die Datei darf als ZIP oder gZIP komprimiert sein.

Pflichtfelder

Spalte	Was idealo erwartet	Woher in Shopify
sku	Eindeutige Artikelnummer des Angebots	SKU der Variante, sonst eine eindeutige ID
title	Produktname, bei Varianten mit Größe, Farbe usw.	Produkttitel plus Optionswerte
url	Link zur Produktseite, die gewählte Variante muss vorausgewählt sein	Produkt-URL mit Varianten-Parameter
price	Endpreis inklusive Umsatzsteuer, ohne Währungszeichen	Euro-Preis der Variante für den Markt
delivery	Lieferzeit, möglichst in Werktagen	Ihre eigene Angabe, Shopify hat kein Feld dafür
deliveryCosts_<Versanddienstleister>	Mindestens eine Spalte; 0.00, wenn kein Versand anfällt	Ihre Versandpreise
paymentCosts_<Zahlungsart>	Mindestens eine Zahlungsart mit ihren Kosten	Ihre Zahlungsarten
basePrice	Grundpreis, Pflicht für grundpreispflichtige Waren	Einheitspreis der Variante

Für Multipacks verlangt idealo zusätzlich packagingUnit, die Anzahl der Einheiten im Paket.

url: die richtige Variante

idealo verlangt, dass der Link genau das Angebot öffnet, also die Variante mit Größe und Farbe aus dieser Zeile. In Shopify öffnet die Produkt-URL mit dem Parameter ?variant= und der Varianten-ID die passende Variante. Ein Link auf die Produktseite ohne Parameter zeigt dagegen die erste Variante und passt dann nicht zu Preis und Titel der Zeile.

price: Euro, inklusive Umsatzsteuer

Der Preis ist der Endpreis inklusive Umsatzsteuer, mit Punkt als Dezimaltrennzeichen und ohne Euro-Zeichen, also 24.90. Pflegen Sie Ihre Preise in Shopify ohne Steuer, muss der Feed die Umsatzsteuer aufschlagen. Verkaufen Sie mit Shopify Markets nach Deutschland und Österreich, kann der Preis je Markt verschieden sein.

delivery: was nicht erlaubt ist

idealo empfiehlt eine Lieferzeit in Werktagen, etwa „1-3 Werktage“. Angaben wie „versandfertig“, „lieferbar“, „voraussichtlich“ oder „in der Regel“ sind laut Dokumentation nicht zulässig. Die Versandkosten sind ein eigenes Thema: Versandkosten und Lieferzeit im idealo-Feed.

paymentCosts_…: mindestens eine Zahlungsart

Jede Zahlungsart, die Sie anbieten, bekommt eine Spalte, etwa paymentCosts_paypal oder paymentCosts_invoice, mit dem Aufschlag in Euro oder 0.00. Die möglichen Namen stehen in der idealo-Dokumentation.

basePrice: Grundpreis nach PAngV

Wer Waren nach Gewicht, Volumen, Länge oder Fläche anbietet, muss neben dem Gesamtpreis den Grundpreis angeben (§ 4 PAngV), bezogen auf 1 kg, 1 l, 1 m, 1 m² oder 1 m³ (§ 5 PAngV). In Shopify pflegen Sie dafür den Einheitspreis der Variante (Einheitspreise). Ob Ihr Produkt grundpreispflichtig ist, klären Sie im Zweifel rechtlich.

Empfohlene Felder

Diese Spalten sind keine Pflicht, helfen idealo aber, Ihr Angebot dem richtigen Produkt zuzuordnen:

• brand: Marke, in Shopify meist der Hersteller (Vendor).
• eans: mindestens eine EAN/GTIN, in Shopify das Feld Barcode. Mehrere EANs mit Semikolon trennen. Prüfen Sie die Prüfziffer, Tippfehler sind häufig.
• categoryPath: Ihr Kategoriepfad, etwa aus dem Produkttyp.
• description: reiner Text, höchstens 1000 Zeichen, also ohne HTML aus der Produktbeschreibung.
• imageUrls: Bild-URLs (PNG, JPG oder WebP, bis 3 MB). Laut idealo werden Bilder mit weißem Hintergrund bevorzugt.
• size und colour: aus den Variantenoptionen.

Daneben gibt es optionale Felder wie formerPrice (früherer Preis, in Shopify der Vergleichspreis) oder deliveryComment (bis 150 Zeichen).

Häufige Fehler vor dem ersten Import

1. Varianten in einer Zeile. Jede Größe und Farbe braucht eine eigene Zeile mit eigener SKU.
2. Doppelte SKUs. Zwei Varianten mit derselben SKU sind für idealo dasselbe Angebot.
3. Preise ohne Umsatzsteuer oder mit Komma statt Punkt.
4. Lieferzeit als „lieferbar“ statt in Werktagen.
5. Keine Versandkosten-Spalte oder keine Zahlungsart.
6. HTML in der Beschreibung, weil die Shopify-Beschreibung ungefiltert übernommen wurde.
7. Ausverkaufte oder nicht veröffentlichte Produkte im Feed, deren Seite niemand kaufen kann.

Feedora: CSV Feed for idealo füllt die Spalten aus Shopify

Feedora: CSV Feed for idealo ist eine Shopify-App, die diesen Feed für idealo.de und idealo.at aus Ihren Produkten baut. Sie ist nicht mit idealo verbunden oder von idealo autorisiert; idealo entscheidet, welche Angebote es listet.

• Pflichtfelder aus Shopify: SKU (oder Varianten-ID), Titel mit Optionswerten, Link mit vorausgewählter Variante, Euro-Preis des Markts mit Umsatzsteuer, Grundpreis aus dem Einheitspreis, Lieferzeit je Markt.
• Versandkosten und Zahlungsarten: Versandkosten je Versanddienstleister und Markt, Zahlungsarten mit ihren Gebühren in den Einstellungen.
• Feldzuordnung: Standardwerte sind Hersteller als Marke und Barcode als EAN (mit Prüfziffer-Kontrolle) und die Beschreibung als reiner Text bis 1000 Zeichen. Jede Spalte lässt sich auf ein anderes Shopify-Feld, eine Variantenoption oder ein Metafeld umstellen.
• Prüfbericht: welche Varianten fehlen und warum (zum Beispiel ausverkauft, Preis 0.00, keine Versandkosten) und welche Angaben fehlen (keine EAN, falsche Prüfziffer, keine Marke, kein Bild, doppelte SKU).

Mehr zu Feedora: CSV Feed for idealo (Seite auf Englisch).

FAQ

Ist die EAN bei idealo Pflicht?

Nach der CSV-Dokumentation ist eans ein empfohlenes Feld, kein Pflichtfeld. Ohne EAN fällt es idealo aber schwerer, Ihr Angebot dem richtigen Produkt zuzuordnen.

Darf ich XML statt CSV liefern?

idealo nimmt laut Dokumentation CSV, TXT oder XML an. Dieser Artikel beschreibt das CSV-Format.

Was trage ich bei delivery ein, wenn ich aus dem Lager sofort versende?

Eine Angabe in Werktagen, etwa „1-2 Werktage“. „Sofort lieferbar“ oder „versandfertig“ sind nicht zulässig.

Braucht jede Variante eine eigene URL?

Ja, in dem Sinn, dass der Link die Variante vorauswählen muss. In Shopify reicht dafür die Produkt-URL mit ?variant= und der Varianten-ID.