Kompatibilitätsdaten verstehen

FitmentPro verwendet eine strukturierte Fahrzeughierarchie zur Organisation der Kompatibilitätsdaten. Das Verständnis dieser Hierarchie ist der Schlüssel zur effektiven Nutzung der App.

Die Fahrzeughierarchie (5 Stufen)

Jedes Fahrzeug in der Datenbank wird über fünf Ebenen klassifiziert:

Marke (320+ Marken) — Der Hersteller (z.B. BMW, Toyota, Volkswagen)
Modell (6.700+ Modelle) — Die Modellreihe (z.B. 3er Reihe, Corolla, Golf)
Variante (35.000+ Varianten) — Die spezifische Variante (z.B. 320i, 1.8 VVT-i, GTI)
Plattform (28.500+ Plattformen) — Der technische Plattformcode (z.B. F30, E210, MK8)
Baujahr (48.000+ Einträge) — Der Produktionszeitraum (z.B. 2019–2023)

Was ist eine Kompatibilitätsregel?

Eine Kompatibilitätsregel ist ein einzelner Datensatz, der besagt: „Dieses Produkt ist kompatibel mit diesem Fahrzeug." Jede Regel enthält:

Marke, Modell, Variante und Plattform-Informationen
Baujahr-Bereich (von/bis)
Motordetails (Hubraum, Leistung, Kraftstoffart)
KType-Nummer (TecDoc-Referenz)
Optionale HSN/TSN (deutsche Fahrzeugschein-Nummern)

Wie Regeln gespeichert werden

FitmentPro speichert Kompatibilitätsdaten in Shopify-Metafeldern auf jedem Produkt:

vehicle_fitment.rules — Die vollständigen Kompatibilitätsdaten im JSON-Format (werden von Theme-Blöcken zur Anzeige verwendet)
vehicle_fitment.search — Indexierte Werte für Shopifys native Suche (damit Kunden z.B. „BMW 3er" suchen und passende Produkte finden)
Filter-Metafelder — Separate Metafelder für Marke, Modell, Variante, Plattform, Baujahr_min und Baujahr_max (für Shopify-Kollektionsfilter)

Große Kompatibilitätslisten

Produkte mit vielen kompatiblen Fahrzeugen (350+ Regeln) werden automatisch auf mehrere Metafeld-Chunks aufgeteilt (rules, rules_2, rules_3 usw.), um innerhalb des 60KB-Limits von Shopify zu bleiben. Dies geschieht transparent — Sie müssen es nicht manuell verwalten.

Die TecDoc-Datenbank

Die Fahrzeugdatenbank von FitmentPro stammt aus TecDoc, dem Branchenstandard der Automobilindustrie. Jedes Fahrzeug hat eine eindeutige KType-Nummer, die eine spezifische Fahrzeugkonfiguration präzise identifiziert. Die Datenbank enthält 55.647 einzigartige KType-Datensätze.