Vindec — décodeur VIN pour le catalogue FAPI par marque

Catalogue par marque — désormais par VIN

Vindec est une API qui transforme un VIN en identifiant de véhicule dans le catalogue FAPI par marque. Le catalogue s’ouvre directement sur la bonne modification, sans l’étape manuelle « marque → modèle → modification » dans la vitrine.

Ce qu’il y a dedans

VIN à 17 caractères en entrée, JSON en sortie.
La réponse contient le constructeur, la modification (moteur + année + carrosserie), la puissance (kW), la cylindrée (cm³), le type de carburant, le type de carrosserie, la transmission, la boîte de vitesses, ainsi que les identifiants de modèle et de modification pour l’entrée directe dans le catalogue.
Niveau de confiance dans chaque réponse : exact / partial / brand_only / unknown. Si nous ne sommes pas sûrs, nous le disons.
Stockage local des données de référence du catalogue — les modèles et types de véhicules sont chez nous, pas de requêtes réseau à chaque appel.

Exemple de réponse

Requête : 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"
  }
}

La décomposition WMI/VDS/VIS selon ISO 3779 se fait à l’intérieur de Vindec ; le consommateur reçoit une modification prête plus une paire d’identifiants pour entrer directement dans le catalogue FAPI par marque. Quand le VIN ne se décode que partiellement (par exemple le WMI est sans ambiguïté mais la modification non), confidence renvoie brand_only ou partial — c’est un signal pour l’UI : afficher un sélecteur manuel de modification, ne pas deviner.

À qui c’est destiné

Le service est conçu pour les clients du catalogue FAPI par marque.

Vous avez déjà acheté le catalogue — Vindec s’intègre dans votre vitrine ou votre front 1C comme un autre point d’entrée : au lieu de choisir manuellement la marque/le modèle, le client saisit un VIN.
Vous envisagez d’acheter le catalogue — Vindec fonctionne en tandem avec lui, il est donc logique de commencer par le catalogue lui-même.
Sans catalogue FAPI par marque — pas encore utile : Vindec renvoie un identifiant de catalogue, qu’il faut interroger quelque part.

Où ça s’intègre

Trois scénarios typiques — chacun a son interface, la partie commune est la même : au lieu de « marque → modèle → modification » saisi à la main, le client ou le spécialiste passe un VIN et le catalogue s’ouvre sur la bonne ligne.

Vitrine d’un magasin de pièces. Un champ « VIN » à côté du sélecteur de marque habituel. Le client copie 17 caractères depuis la carte grise ou le pare-brise — le catalogue se positionne directement sur le bon moteur et la bonne génération. Quand le décodage est partiel (partial / brand_only), la vitrine montre ce qui a correspondu et laisse le chemin manuel ouvert pour le reste. Sur les voitures couvertes — zéro erreur « mauvaise modification ».

Logiciel de spécialiste de comptoir (basé sur 1C). Le partseller prend un appel : « Skoda Octavia 2011, j’ai besoin de plaquettes de frein. » Relance : « Pouvez-vous me lire le VIN ? » — et une seconde plus tard l’écran est sur la bonne modification, sans A5 contre A7 manuel, pré- contre post-facelift, 1.6 MPI contre 1.4 TSI. Le scénario s’accélère 3-5× ; les erreurs de pièce sont filtrées dès la saisie.

Réception mobile en station-service. Le réceptionnaire scanne le code-barres VIN sous le capot avec un téléphone, récupère la modification et voit immédiatement les éléments d’entretien (huile, filtres, courroies) dans le catalogue FAPI par marque. Fonctionne hors ligne dans l’habitacle : les données de référence du catalogue vivent localement, seul l’appel à Vindec passe par le réseau.

Pourquoi une API, pas un sélecteur manuel

Vitesse. Un partseller passe des secondes au lieu de minutes à naviguer marque → modèle → modification → moteur. Sur une file d’appels, ce sont des dizaines d’heures économisées par mois.
Précision de la modification. Un VIN code de manière unique le moteur, l’année de fabrication et la finition. La sélection manuelle repose sur la mémoire du client (« la mienne est de 2014… je crois 1.6… ») — le chemin vers les mauvais articles et les retours.
Seuil d’intégration. Un vendeur moins expérimenté sans années sur une marque précise fait quand même des sélections correctes : le décodeur VIN gère ce qu’un spécialiste chevronné garde en tête.
Traçabilité d’audit. La commande conserve le VIN d’origine — un retour contesté se règle sur fait, pas sur « il me l’a dit, j’ai choisi ».

Statut : bêta fermée

Depuis le 2026-05-16, l’accès anticipé est ouvert aux clients existants du catalogue. La bêta signifie :

La capacité est limitée ; l’accès est délivré par lots.
Le pilot pricing est négocié individuellement avec les participants et fixé pour la durée du contrat.
Le feedback des premiers utilisateurs alimente directement la roadmap.

Inscription à la waitlist

E-mail : fapi@iisis.ru, objet Vindec beta. Dans le corps — entreprise, si vous avez déjà le catalogue, volume de requêtes VIN prévu.
Canal Telegram des mises à jour : @database_auto_parts — annonces des nouveaux lots d’accès.

Techniquement

API REST, JSON.
Service en Go, stockage PostgreSQL plus données de référence en lecture seule du catalogue FAPI par marque (MariaDB).
Déploiement : géré chez nous ou self-hosted chez vous (discuté avec les participants à la bêta).
Documentation et Swagger remis après l’ouverture de l’accès.

Questions fréquentes

Pour quelles marques cela fonctionne-t-il ?
L’API fonctionne pour toutes les marques et tous les modèles présents dans notre catalogue FAPI par marque.

Et les limites pendant la bêta ?
Négociées individuellement. Si votre cas d’usage est d’intégrer Vindec dans une vitrine avec des milliers de requêtes par jour, dites-le à l’inscription pour que nous planifiions correctement la capacité.

Est-ce un remplacement du catalogue ?
Non. Vindec ne livre pas de pièces et ne construit pas la hiérarchie marque/modèle. Il renvoie un identifiant de véhicule — un point d’entrée dans le catalogue FAPI par marque que vous avez déjà.

Quand la sortie générale ?
Après la fin de la bêta. Nous n’annonçons pas de dates pour ne pas diviser l’attention entre « promesses » et travail avec les premiers clients.

Et si un VIN ne se décode pas complètement ?
Vindec renvoie confidence: partial ou brand_only et remplit les champs qu’il a pu établir (par exemple, seulement le constructeur via le WMI). C’est un signal explicite pour votre UI : afficher un sélecteur manuel de modification, ne pas substituer aveuglément des numéros d’article. Vindec ne renvoie pas de suppositions — nous n’inventons pas ce qui n’est pas codé.

Et les voitures JDM sans VIN et les premières VAZ soviétiques ?
Les voitures JDM avec un numéro de carrosserie au format XXX-1234567 et les premiers numéros VAZ soviétiques ne sont pas décrits par ISO 3779 — Vindec renvoie confidence: unknown pour elles, et le flux doit revenir à la saisie manuelle. Sur le marché RU, c’est une part notable ; il est important que l’UI ne plante pas dans ces cas mais dégrade proprement vers l’ancien chemin.

Quelle est la latence de réponse ?
Des dizaines de millisecondes pour le décodage plus une recherche locale dans les données de référence MariaDB. Pas d’API externes dans le chemin chaud — tout est readonly-local. Cela permet d’intégrer Vindec directement dans input-onChange d’un formulaire web sans latence perçue par l’utilisateur.

Confidentialité du VIN ?
Un VIN en soi n’est pas une donnée personnelle — il identifie le véhicule, pas le propriétaire. Mais nous ne stockons pas les VIN bruts de vos requêtes : uniquement des statistiques d’usage agrégées (nombre de requêtes, distribution de confiance, WMI fréquents). En cas de besoin de conformité, c’est écrit séparément dans le contrat.

Le self-hosted est-il supporté ?
Discuté avec les participants à la bêta. Architecturalement, Vindec est un binaire Go unique + PostgreSQL + un réplica readonly des données de référence du catalogue FAPI ; se déploie en Docker en une heure. Pour les exigences on-premise (banques, secteur public) — c’est un chemin supporté.