iisis.ru

Vindec — VIN-Decoder für den FAPI-Katalog nach Fahrzeugmarke

Katalog nach Fahrzeugmarke — jetzt per VIN

Vindec — VIN-Decoder für den FAPI-Katalog nach Fahrzeugmarke

Vindec ist eine API, die aus einer VIN eine Fahrzeug-ID im FAPI-Katalog nach Fahrzeugmarke erzeugt. Der Katalog öffnet sich direkt auf der richtigen Modifikation, ohne den manuellen Schritt «Marke → Modell → Modifikation» im Shopfront.

Was drin ist

  • 17-stellige VIN als Eingabe, JSON als Ausgabe.
  • Die Antwort enthält Hersteller, Modifikation (Motor + Jahr + Karosserie), Leistung (kW), Hubraum (cm³), Kraftstoffart, Karosserietyp, Antrieb, Getriebe sowie Modell- und Modifikations-IDs für den direkten Einstieg in den Katalog.
  • Confidence-Level in jeder Antwort: exact / partial / brand_only / unknown. Wenn wir uns nicht sicher sind, sagen wir es.
  • Katalog-Referenzdaten lokal gespeichert — Fahrzeugmodelle und -typen liegen bei uns, keine Netzwerkanfragen pro Request.

Beispielantwort

Anfrage: GET /v1/decode?vin=WVWZZZ1JZXW000010

{
  "confidence": "exact",
  "vin": "WVWZZZ1JZXW000010",
  "manufacturer": "Volkswagen",
  "model": "Golf IV",
  "modification": "1.6 (AKL, AEH)",
  "year_from": 1997,
  "year_to": 2006,
  "body_type": "Hatchback",
  "engine_kw": 74,
  "engine_cc": 1595,
  "fuel": "petrol",
  "drive": "FWD",
  "gearbox": "MT",
  "catalog": {
    "model_id": "20210",
    "type_id": "1041"
  }
}

Die WMI/VDS/VIS-Aufschlüsselung nach ISO 3779 läuft innerhalb von Vindec; der Consumer bekommt eine fertige Modifikation plus ein Paar IDs für den direkten Einstieg in den FAPI-Katalog nach Fahrzeugmarke. Wenn die VIN nur teilweise dekodiert wird (z. B. WMI ist eindeutig, die Modifikation nicht), liefert confidence den Wert brand_only oder partial — ein Signal an die UI: Modifikations-Auswahl manuell anzeigen, nicht raten.

Für wen

Der Dienst richtet sich an Kunden des FAPI-Katalogs nach Fahrzeugmarke.

  • Sie haben den Katalog bereits — Vindec lässt sich in Ihr Shopfront oder 1C-Frontend einbinden als weitere Eingangsstelle: statt Marke/Modell manuell auszuwählen, gibt der Kunde eine VIN ein.
  • Sie erwägen den Kauf des Katalogs — Vindec funktioniert im Verbund mit ihm, also fangen Sie mit dem Katalog selbst an.
  • Kein FAPI-Katalog nach Fahrzeugmarke vorhanden — vorerst nicht nützlich: Vindec liefert eine Katalog-ID, die irgendwo abgefragt werden muss.

Wo es eingebunden wird

Drei typische Szenarien — jedes hat seine eigene UI, der gemeinsame Teil ist gleich: Statt «Marke → Modell → Modifikation» von Hand übergibt der Kunde oder Mitarbeiter eine VIN, und der Katalog öffnet sich auf der richtigen Zeile.

Shopfront eines Teilehändlers. Ein VIN-Feld neben dem üblichen Markenwähler. Der Kunde kopiert 17 Zeichen aus dem Fahrzeugschein oder von der Windschutzscheibe — der Katalog springt direkt auf den richtigen Motor und die richtige Generation. Bei teilweiser Dekodierung (partial / brand_only) zeigt das Shopfront, was übereinstimmte, und hält den manuellen Pfad für den Rest offen. Bei abgedeckten Fahrzeugen — null «falsche-Modifikation»-Fehler.

Frontend eines Teile-Spezialisten (1C-basiert). Der Partseller nimmt einen Anruf entgegen: «Skoda Octavia 2011, Bremsbeläge gesucht.» Rückfrage: «Können Sie mir die VIN vorlesen?» — und eine Sekunde später ist der Bildschirm auf der richtigen Modifikation, ohne manuelles A5 vs. A7, Vor- vs. Nach-Facelift, 1.6 MPI vs. 1.4 TSI. Das Szenario läuft 3-5× schneller; falsche Artikelfehler werden bereits beim Input ausgefiltert.

Mobile Annahme an einer Werkstatt. Der Annahmemitarbeiter scannt den VIN-Strichcode unter der Motorhaube mit dem Handy, erhält die Modifikation und sieht sofort die Wartungspositionen (Öl, Filter, Riemen) im FAPI-Katalog nach Fahrzeugmarke. Funktioniert offline in der Fahrzeugkabine: Die Katalog-Referenzdaten liegen lokal, nur der Vindec-Aufruf geht über das Netz.

Warum eine API, nicht ein manueller Wähler

  • Geschwindigkeit. Ein Partseller verbringt Sekunden statt Minuten mit der Navigation Marke → Modell → Modifikation → Motor. Bei einer Anrufwarteschlange sind das Dutzende eingesparte Stunden pro Monat.
  • Modifikations-Genauigkeit. Eine VIN codiert eindeutig den Motor, das Baujahr und die Ausstattung. Die manuelle Auswahl verlässt sich auf das Gedächtnis des Kunden («Meiner ist 2014… ich glaube 1.6…») — der Weg zu falschen Artikeln und Rücksendungen.
  • Onboarding-Schwelle. Ein weniger erfahrener Verkäufer ohne jahrelange Praxis bei einer bestimmten Marke trifft trotzdem korrekte Auswahl: Der VIN-Decoder erledigt, was ein erfahrener Spezialist im Kopf hat.
  • Audit-Nachvollziehbarkeit. Die Bestellung speichert die ursprüngliche VIN — eine strittige Rücksendung wird sachlich geklärt, nicht «er sagte es mir, ich habe ausgewählt».

Status: Closed Beta

Seit 2026-05-16 ist der frühe Zugang für bestehende Katalogkunden geöffnet. Beta bedeutet:

  • Capacity ist begrenzt; Zugang wird in Chargen vergeben.
  • Pilot-Pricing wird individuell mit den Teilnehmern verhandelt und für die Vertragslaufzeit festgehalten.
  • Feedback der ersten Nutzer fließt direkt in die Roadmap.

Auf die Waitlist setzen

  • E-Mail: fapi@iisis.ru, Betreff Vindec beta. Im Text — Firma, ob Sie den Katalog bereits einsetzen, geplantes VIN-Abfragevolumen.
  • Telegram-Update-Kanal: @database_auto_parts — Ankündigungen neuer Zugangschargen.

Technisch

  • REST API, JSON.
  • Service in Go, Speicherung in PostgreSQL plus Readonly-Referenzdaten aus dem FAPI-Katalog nach Fahrzeugmarke (MariaDB).
  • Deployment: managed bei uns oder self-hosted bei Ihnen (mit Beta-Teilnehmern besprochen).
  • Dokumentation und Swagger werden nach Zugangsfreigabe ausgegeben.

Häufige Fragen

Für welche Marken funktioniert es?
Die API funktioniert für alle Marken und Modelle, für die in unserem FAPI-Katalog nach Fahrzeugmarke Daten vorhanden sind.

Was ist mit Rate-Limits in der Beta?
Werden individuell vereinbart. Wenn Ihr Use Case darin besteht, Vindec in ein Shopfront mit Tausenden Anfragen pro Tag einzubinden, sagen Sie es bei der Anmeldung, damit wir die Capacity richtig planen.

Ist das ein Ersatz für den Katalog?
Nein. Vindec liefert keine Ersatzteile und baut keine Marken/Modell-Hierarchie. Er liefert eine Fahrzeug-ID — einen Einstiegspunkt in den FAPI-Katalog nach Fahrzeugmarke, den Sie bereits haben.

Wann kommt der allgemeine Zugang?
Nach Ende der Beta. Wir kündigen keine Daten an, um die Aufmerksamkeit nicht zwischen «Versprechen» und der Arbeit mit den ersten Kunden zu teilen.

Was, wenn eine VIN nicht vollständig dekodiert wird?
Vindec gibt confidence: partial oder brand_only zurück und füllt die Felder, die ermittelt werden konnten (z. B. nur den Hersteller aus dem WMI). Das ist ein explizites Signal an Ihre UI: einen manuellen Modifikations-Wähler anzeigen, keine Artikelnummern blind einsetzen. Vindec liefert keine Vermutungen — wir erfinden nicht, was nicht codiert ist.

Was ist mit JDM-Fahrzeugen ohne VIN und frühen sowjetischen VAZ?
JDM-Fahrzeuge mit Karosserienummern im Format XXX-1234567 und frühe sowjetische/frühe VAZ-Nummern sind nicht durch ISO 3779 beschrieben — Vindec gibt für sie confidence: unknown zurück, und der Ablauf muss auf manuelle Eingabe zurückfallen. Auf dem RU-Markt ist das ein spürbarer Anteil; wichtig ist, dass die UI bei diesen Fällen nicht abstürzt, sondern sauber auf den alten Pfad degradiert.

Wie lang ist die Antwortlatenz?
Zehn Millisekunden für die Dekodierung plus eine lokale Abfrage der MariaDB-Referenzdaten. Keine externen APIs im Hot Path — alles ist readonly-lokal. Damit kann Vindec sicher direkt in input-onChange eines Webformulars eingebettet werden, ohne wahrnehmbare Verzögerung.

Wie steht es um den Schutz der VIN?
Eine VIN ist für sich genommen kein personenbezogenes Datum — sie identifiziert das Fahrzeug, nicht den Halter. Aber wir speichern keine rohen VINs aus Ihren Anfragen: nur aggregierte Nutzungsstatistik (Anzahl Anfragen, Confidence-Verteilung, häufige WMIs). Bei Compliance-Anforderungen wird das gesondert in den Vertrag aufgenommen.

Wird Self-Hosting unterstützt?
Wird mit Beta-Teilnehmern besprochen. Architektonisch ist Vindec ein einzelnes Go-Binary + PostgreSQL + Readonly-Replikat der FAPI-Katalog-Referenzdaten; läuft in Docker innerhalb einer Stunde. Bei On-Premise-Anforderungen (Banken, öffentlicher Sektor) — das ist ein unterstützter Pfad.