„Warum werden unsere Inserate nicht übernommen?“ – diesen Satz hören wir bei Never Code Alone regelmäßig, wenn Autohäuser ihre erste Schnittstellen-Anbindung zu mobile.de einrichten. Die offizielle CSV-Dokumentation ist umfangreich, aber der Weg von der Spezifikation zum funktionierenden Import ist steinig. Nach über 15 Jahren Spezialisierung auf Softwarequalität, Open Source und Remote Consulting zeigen wir euch, wie ihr die mobile.de CSV-Schnittstelle fehlerfrei implementiert.

Was macht die mobile.de CSV-Schnittstelle so komplex?

Ihr kennt das Szenario: Das DMS exportiert eine CSV-Datei, ihr ladet sie per FTP hoch, und dann kommt die Fehlermeldung. Fahrzeug wird nicht eingetragen. Keine Details, welches Feld das Problem verursacht hat. Die Fehlersuche beginnt in einer Datei mit bis zu 200 Spalten pro Zeile.

Die mobile.de CSV-Schnittstelle ist historisch gewachsen. Das Basis-Format umfasst aktuell rund 230 Felder, die erweiterte Version (Extended CSV) mittlerweile über 640 Felder. Jedes Feld hat spezifische Formatierungsanforderungen, Abhängigkeiten zu anderen Feldern und Validierungsregeln, die nicht immer offensichtlich sind.

Das Extended Format wird kontinuierlich aktualisiert – allein zwischen 2024 und Ende 2025 kamen über 50 neue Felder hinzu, darunter erweiterte WLTP-Verbrauchsangaben, ABO-Informationsfelder und neue Ausstattungsmerkmale für Elektrofahrzeuge.

Welches CSV-Format brauche ich für mein Autohaus?

Mobile.de bietet zwei Hauptformate an, wobei die meisten Dealer Management Systeme das Extended Format nutzen. Das Basis-Format eignet sich für einfache Anwendungsfälle mit wenigen Fahrzeugen und grundlegenden Attributen. Das Extended Format deckt sämtliche Ausstattungsmerkmale, Finanzierungsoptionen, WLTP-Daten und Händler-spezifische Felder ab.

Basis-Format: Rund 230 Felder, deckt PKW, Motorräder und Nutzfahrzeuge ab. Ausreichend für grundlegende Inserate mit Standardinformationen zu Marke, Modell, Preis, Kilometerstand und den wichtigsten Ausstattungsmerkmalen.

Extended Format: Über 640 Felder im aktuellen Stand (Dezember 2025), enthält zusätzlich Qualitätssiegel verschiedener Hersteller, detaillierte Finanzierungsmodelle, erweiterte Kostenangaben nach WLTP, Standort-Informationen und viele Händler-spezifische Erweiterungen.

Wenn ihr mit einem DMS wie eAutoSeller, Autrado oder pixelconcept arbeitet, nutzt ihr in der Regel automatisch das Extended Format. Die Investition in die vollständige Implementierung lohnt sich, da eure Inserate mit mehr Attributen besser in den Suchergebnissen performen.

Welche Pflichtfelder müssen bei jedem Fahrzeug ausgefüllt sein?

Die Semantik-Überprüfung von mobile.de lehnt Fahrzeuge mit unvollständigen oder widersprüchlichen Daten ab. Diese Pflichtfelder müssen immer korrekt befüllt sein:

Immer erforderlich:

• interne_nummer (Spalte B): Eindeutige Kennung eures Fahrzeugs, maximal 40 Zeichen, nur a-z, A-Z, 0-9, Bindestrich und Unterstrich erlaubt
• kategorie (Spalte C): Kombination aus Fahrzeugklasse und Kategorie
• marke (Spalte D): Muss einem gültigen Markenschlüssel entsprechen
• modell (Spalte E): Sollte mit einer gültigen Modellbezeichnung beginnen
• mwst (Spalte L): 0 für ausweisbar, 1 für nicht ausweisbar
• beschaedigtes_fahrzeug (Spalte P): 0 oder 1
• jahreswagen (Spalte U): 0 oder 1
• neufahrzeug (Spalte V): 0 oder 1
• metallic (Spalte AB): 0 oder 1
• garantie (Spalte AE): 0 oder 1
• vorfuehrfahrzeug (Spalte AY): 0 oder 1

Bedingt erforderlich:

• kilometer (Spalte J): Pflicht bei gebrauchten PKW, Motorrädern, LKW und Bussen
• ez (Spalte I): Erstzulassung im Format mm.jjjj oder tt.mm.jjjj

Die häufigste Fehlerquelle: Felder werden leer gelassen statt explizit mit 0 befüllt. Ein leeres Feld bedeutet „keine Angabe“, was bei Pflichtfeldern zum Ablehnung führt.

Wie formatiere ich die CSV-Datei korrekt für mobile.de?

Das CSV-Format von mobile.de verwendet Semikolon als Trennzeichen – nicht Komma, wie der Name „Comma Separated Values“ suggerieren würde. Textfelder müssen in Anführungszeichen stehen, und hier liegt die häufigste Stolperfalle.

Zeichensatz: ISO-8859-15 ist vorgeschrieben. UTF-8 funktioniert nicht zuverlässig und führt zu kaputten Umlauten oder Import-Abbrüchen.

Anführungszeichen maskieren: Enthält ein Textfeld selbst Anführungszeichen, müssen diese verdoppelt werden. Aus 17" Felgen wird in der CSV "17"" Felgen". Ein einzelnes nicht maskiertes Anführungszeichen zerstört die gesamte Zeilenstruktur und macht die Datei unlesbar.

Zeilenumbrüche: Innerhalb von Feldern sind Zeilenumbrüche nicht erlaubt. Die Bemerkungsfelder müssen einzeilig bleiben, auch wenn das die Lesbarkeit im Quelltext erschwert.

Dezimaltrennzeichen: Bei Zahlen mit Nachkommastellen (Verbrauchswerte, Zinssätze) wird der Punkt als Dezimaltrennzeichen verwendet, nicht das deutsche Komma.

Praxis-Tipp aus dem Consulting: Validiert eure CSV vor dem Upload mit einem Parser, der die mobile.de-Regeln kennt. Ein einzelner Formatierungsfehler in Zeile 847 kann den Import aller 1.000 Fahrzeuge blockieren.

Welche Semantik-Regeln prüft mobile.de bei der Datenübernahme?

Die Semantik-Überprüfung geht weit über reine Formatvalidierung hinaus. Mobile.de prüft logische Zusammenhänge zwischen Feldern und lehnt widersprüchliche Angaben ab. Diese Regeln kennt nicht jedes DMS automatisch:

Datum und Zustand:

• Die Erstzulassung kann nicht in der Zukunft liegen
• HU und AU können nicht vor der Erstzulassung sein
• Ein Neuwagen darf keine Erstzulassung und nicht mehr als 500 Kilometer haben
• Ein Oldtimer kann nicht erst vor zwei Jahren zugelassen worden sein
• Ein Jahreswagen kann seine Erstzulassung nicht vor mehr als 15 Monaten haben

Preis und Status:

• Der Händlerpreis darf nicht höher sein als der Endkundenpreis
• Ein Jahreswagen kann nicht gleichzeitig Neuwagen oder Oldtimer sein
• Eine Tageszulassung kann kein Neuwagen sein

EnVKV-Konformität:

• Ist das envkv-Feld gesetzt, müssen Verbrauchswerte, Emissionswerte und Kraftstoffart angegeben sein
• Bei Elektrofahrzeugen werden klassische Verbrauchswerte automatisch ignoriert

Finanzierung:

• Der Gesamtwert des Finanzierungsmodells muss mindestens dem Endkundenpreis entsprechen
• Lieferdatum und Lieferfrist dürfen nicht gleichzeitig angegeben werden
• Lieferfristen sind nur bei Neufahrzeugen erlaubt

Diese Regeln können sich ändern. Mobile.de behält sich explizit vor, die Semantik-Prüfungen jederzeit zu erweitern.

Wie funktioniert die Bilderzuordnung bei der CSV-Schnittstelle?

Die Bilderverwaltung ist technisch getrennt von den Fahrzeugdaten, aber eng mit ihnen verknüpft. Bilder werden im selben ZIP-Archiv wie die CSV-Datei übertragen und über die Bild-ID den Fahrzeugen zugeordnet.

Benennungslogik: Bilder heißen [bild_id]_1.jpg bis [bild_id]_15.jpg. Pro Fahrzeug sind maximal 15 Bilder möglich, jedes maximal 500 KB groß. Die optimale Auflösung liegt bei 640 x 480 Pixel, das Format muss JPEG sein.

Zuordnungsprinzip: Wenn das Feld bild_id (Spalte AA) befüllt ist, wird diese für die Bildzuordnung verwendet. Ist es leer, greift die interne_nummer aus Spalte B. Die Bild-ID hat Priorität.

Erlaubte Zeichen: Zahlen, Buchstaben A-Z und a-z, Leerzeichen und Bindestrich. Unterstriche funktionieren, werden aber nicht empfohlen. Umlaute und Sonderzeichen sind verboten.

Kritischer Punkt: Wenn ihr Bilder aktualisieren wollt, müsst ihr den gesamten Bildersatz für das Fahrzeug neu senden. Nicht erneut gesendete Bilder werden gelöscht. Das ermöglicht das gezielte Entfernen einzelner Bilder, kann aber bei unvollständigen Updates versehentlich Bilder löschen.

Alle Bilder löschen: Setzt den Wert delete-images im Feld bild_id, um alle Bilder eines Inserats zu entfernen.

Welche Upload-Methoden unterstützt die mobile.de Schnittstelle?

Ihr habt mehrere Optionen für die Datenübertragung, wobei FTP die zuverlässigste für automatisierte Workflows ist.

FTP-Upload: Die Standardmethode für DMS-Integrationen. Die Verbindung erfolgt im Passive Mode mit Binary Transfer. Die erstmalige Aktivierung erfordert eine TAN-Authentifizierung, sofern ihr nicht über einen Datendienstleister arbeitet.

HTTP-Upload: Maximal 50 MB pro ZIP-Archiv. Für manuelle Uploads oder kleinere Bestände geeignet.

Sammelaccount für Datendienstleister: Wenn ihr einen externen Dienstleister mit der Datenübertragung beauftragt, nutzt dieser einen eigenen FTP-Account. Die Zuordnung der Fahrzeuge zu eurem Händler-Account erfolgt über die Kundennummer in der ersten Spalte.

Die Aktivierung und Konfiguration der Schnittstelle findet ihr im mobile.de Händlerbereich unter „Verkaufen“ → „Datenexport, Datenimport“ → „Inserats-Einbindung“.

Wie unterscheiden sich Kraft- und Antriebsarten in der CSV-Spezifikation?

Die Kraftstoffart (Spalte DF, Feldnummer 109) verwendet numerische Codes, die ihr korrekt zuordnen müsst:

Code	Kraftstoffart
1	Benzin
2	Diesel
3	Autogas (LPG)
4	Erdgas (CNG)
6	Elektro
7	Hybrid (Benzin)
8	Wasserstoff
9	Ethanol
10	Hybrid-Diesel
11	Bi-Fuel
0	Andere

Bei Elektrofahrzeugen werden die Verbrauchsfelder für innerorts und außerorts ignoriert. Der kombinierte Verbrauch wird in kWh/100km angegeben. Emissionswerte werden automatisch auf 0 gesetzt.

Die Getriebearten (Spalte DG, Feldnummer 110) sind: 0 für keine Angabe, 1 für Schaltgetriebe, 2 für Halbautomatik, 3 für Automatik.

Welche Besonderheiten gelten für Nutzfahrzeuge und Motorräder?

Die CSV-Spezifikation enthält zahlreiche Felder, die nur für bestimmte Fahrzeugkategorien relevant sind. Bei falscher Befüllung ignoriert mobile.de diese Felder oder generiert Fehler.

Nur Motorräder:

• antrieb (Spalte AZ): 1=Kette, 2=Kardan, 3=Riemen
• katalysator, kickstarter, estarter (Spalten AV-AX)
• koffer, sturzbuegel, scheibe (Spalten DT-DV)

Nur Nutzfahrzeuge:

• tragkraft, nutzlast, gesamtgewicht (Spalten BB-BD)
• betriebsstunden (Spalte BH)
• kabinenart, achsen, radformel (Spalten BK, BL, CA)
• retarder_intarder, luftfederung, ladebordwand (Spalten BT, CF, BX)

Nur Wohnmobile:

• schlafplaetze (Spalte EJ)
• fahrzeuglaenge, fahrzeugbreite, fahrzeughoehe (Spalten EK-EM)
• etagenbett, festbett, heckgarage, markise (Spalten DZ-EC)

Achtet bei der Kategorie-Zuordnung darauf, dass die richtigen Felder befüllt sind. Ein LKW mit Motorrad-Attributen führt zu Validierungsfehlern oder falschen Inseraten.

Wie integriere ich Finanzierungsangebote korrekt in die CSV?

Ab Feldnummer 149 beginnen die Finanzierungsfelder, die für die Darstellung von Finanzierungsvorschlägen im Inserat genutzt werden. Die Felder müssen konsistent befüllt sein.

Grundlegende Finanzierungsfelder:

• effektiver_jahreszins (Spalte ET)
• monatliche_rate (Spalte EU)
• laufzeit (Spalte EV): Nur bestimmte Werte erlaubt (12, 24, 36, 48, 60, 72, 84 oder 96 Monate)
• anzahlung (Spalte EW)
• schlussrate (Spalte EX)
• finanzierungsfeature (Spalte EY): 0 oder 1

Erweiterte Felder ab 2024:

• bruttokreditbetrag (Spalte FE)
• abschlussgebuehren (Spalte FF)
• ratenabsicherung (Spalte FG)
• nettokreditbetrag (Spalte FH)
• anbieterbank (Spalte FI): Text, maximal 150 Zeichen
• soll-zinssatz (Spalte FJ)
• art_des_soll-zinssatzes (Spalte FK): 1=gebunden, 2=veränderlich, 3=kombiniert

Die Summe aus Anzahlung, allen Monatsraten und Schlussrate muss mindestens dem Fahrzeugpreis entsprechen. Abweichungen führen zur Ablehnung des Finanzierungsangebots.

Euer nächster Schritt mit der mobile.de CSV-Integration

Die mobile.de CSV-Schnittstelle bietet enorme Möglichkeiten zur Automatisierung eurer Fahrzeugvermarktung. Die initiale Implementierung erfordert sorgfältige Arbeit an den Details, zahlt sich aber durch reduzierte Standzeiten und konsistente Inseratsqualität aus.

Was ihr jetzt tun könnt:

1. Prüft euer DMS auf die unterstützte Format-Version – Basis oder Extended
2. Implementiert eine Validierungsschicht vor dem Upload, die Semantik-Regeln prüft
3. Testet mit einem kleinen Fahrzeugbestand, bevor ihr den Vollimport startet

Ihr braucht Unterstützung bei der Integration? Bei Never Code Alone sind wir seit über 15 Jahren auf Softwarequalität, Open Source und Remote Consulting spezialisiert. Wir helfen euch von der Schnittstellenanalyse bis zur fehlerfreien Produktion.

Schreibt uns einfach eine E-Mail an roland@nevercodealone.de – wir freuen uns auf euer Projekt!