Catalogo per marca — adesso tramite VIN
Vindec è un’API che trasforma un VIN in un identificativo di veicolo all’interno del catalogo FAPI per marca. Il catalogo si apre direttamente sulla giusta modifica, senza il passaggio manuale «marca → modello → modifica» nella vetrina.
Cosa c’è dentro
- VIN da 17 caratteri in ingresso, JSON in uscita.
- La risposta include il costruttore, la modifica (motore + anno + carrozzeria), la potenza (kW), la cilindrata (cm³), il tipo di carburante, il tipo di carrozzeria, la trazione, il cambio, oltre agli identificativi di modello e di modifica per l’ingresso diretto nel catalogo.
- Livello di confidenza in ogni risposta:
exact/partial/brand_only/unknown. Se non siamo sicuri, lo diciamo apertamente. - Archiviazione locale dei riferimenti del catalogo — modelli e tipi di veicoli sono presso di noi, nessuna richiesta di rete a ogni chiamata.
Esempio di risposta
Richiesta: 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 scomposizione WMI/VDS/VIS secondo ISO 3779 avviene all’interno di Vindec; il consumer riceve una modifica già pronta più una coppia di ID per entrare direttamente nel catalogo FAPI per marca. Quando il VIN si decodifica solo parzialmente (per esempio il WMI è univoco ma la modifica no), confidence restituisce brand_only o partial — è un segnale per la UI: mostrare un selettore manuale di modifica, non indovinare.
Per chi
Il servizio è destinato ai clienti del catalogo FAPI per marca.
- Avete già acquistato il catalogo — Vindec si integra nella vostra vetrina o nel front 1C come un ulteriore punto di accesso: invece di scegliere manualmente marca/modello, il cliente inserisce un VIN.
- Considerate l’acquisto del catalogo — Vindec funziona in tandem con esso, quindi conviene partire dal catalogo stesso.
- Senza catalogo FAPI per marca — per ora non ha senso: Vindec restituisce un identificativo del catalogo, che dev’essere interrogato da qualche parte.
Dove si integra
Tre scenari tipici — ognuno ha la sua UI, la parte comune è la stessa: invece di «marca → modello → modifica» inserito a mano, il cliente o lo specialista passa un VIN e il catalogo si apre sulla riga giusta.
Vetrina di un negozio di ricambi. Un campo «VIN» accanto al consueto selettore di marca. Il cliente copia 17 caratteri dal libretto o dal parabrezza — il catalogo si posiziona direttamente sul motore e sulla generazione giusti. Quando la decodifica è parziale (partial / brand_only), la vetrina mostra ciò che ha corrispondenza e lascia aperto il percorso manuale per il resto. Sulle auto coperte — zero errori «modifica sbagliata».
Software di specialista del banco (basato su 1C). Il partseller risponde a una chiamata: «Skoda Octavia 2011, mi servono pastiglie freno.» Domanda di rilancio: «Può leggermi il VIN?» — e un secondo dopo lo schermo è sulla modifica giusta, senza A5 vs A7 manuale, pre- vs post-restyling, 1.6 MPI vs 1.4 TSI. Lo scenario va 3-5× più veloce; gli errori di articolo si filtrano già in fase di inserimento.
Accettazione mobile in officina. L’addetto all’accettazione scansiona il codice a barre VIN sotto il cofano con il telefono, riceve la modifica e vede subito gli articoli di manutenzione (olio, filtri, cinghie) nel catalogo FAPI per marca. Funziona offline nell’abitacolo: i dati di riferimento del catalogo vivono localmente, solo la chiamata a Vindec passa per la rete.
Perché un’API e non un selettore manuale
- Velocità. Un partseller spende secondi invece di minuti per navigare marca → modello → modifica → motore. Su una coda di chiamate, sono decine di ore risparmiate al mese.
- Precisione della modifica. Un VIN codifica in modo univoco il motore, l’anno di costruzione e l’allestimento. La selezione manuale si affida alla memoria del cliente («la mia è del 2014… credo 1.6…») — strada verso articoli sbagliati e resi.
- Soglia di ingresso. Un venditore meno esperto, senza anni su una marca specifica, fa comunque selezioni corrette: il decodificatore VIN copre ciò che uno specialista navigato tiene a mente.
- Tracciabilità di audit. L’ordine conserva il VIN originale — un reso contestato si risolve sui fatti, non su «me l’ha detto lui, ho scelto io».
Stato: beta chiusa
Dal 2026-05-16 è aperto l’accesso anticipato per i clienti esistenti del catalogo. Beta significa:
- La capacità è limitata; l’accesso viene rilasciato a lotti.
- Il pilot pricing è negoziato individualmente con i partecipanti e fissato per la durata del contratto.
- Il feedback dei primi utenti confluisce direttamente nella roadmap.
Iscriversi alla waitlist
- E-mail:
fapi@iisis.ru, oggettoVindec beta. Nel corpo — azienda, se avete già il catalogo, volume previsto di richieste VIN. - Canale Telegram degli aggiornamenti: @database_auto_parts — annunci di nuovi lotti di accesso.
Tecnicamente
- API REST, JSON.
- Servizio in Go, archiviazione PostgreSQL più dati di riferimento in sola lettura del catalogo FAPI per marca (MariaDB).
- Deployment: gestito da noi o self-hosted da voi (discusso con i partecipanti alla beta).
- Documentazione e Swagger consegnati dopo l’apertura dell’accesso.
Domande frequenti
Per quali marche funziona?
L’API funziona per tutte le marche e i modelli presenti nel nostro catalogo FAPI per marca.
E i limiti durante la beta?
Negoziati individualmente. Se il vostro caso d’uso è integrare Vindec in una vetrina con migliaia di richieste al giorno, ditelo all’iscrizione così pianifichiamo correttamente la capacità.
È un sostituto del catalogo?
No. Vindec non spedisce ricambi e non costruisce la gerarchia marca/modello. Restituisce un identificativo di veicolo — un punto di accesso al catalogo FAPI per marca che avete già.
Quando l’accesso generale?
Dopo la chiusura della beta. Non annunciamo date per non dividere l’attenzione tra «promesse» e il lavoro con i primi clienti.
E se un VIN non si decodifica completamente?
Vindec restituisce confidence: partial o brand_only e riempie i campi che è riuscito a stabilire (per esempio, solo il costruttore dal WMI). È un segnale esplicito per la vostra UI: mostrare un selettore manuale di modifica, non sostituire numeri di articolo alla cieca. Vindec non restituisce ipotesi — non inventiamo ciò che non è codificato.
E le auto JDM senza VIN e le prime VAZ sovietiche?
Le auto JDM con numero di carrozzeria nel formato XXX-1234567 e i primi numeri VAZ sovietici non sono descritti dall’ISO 3779 — Vindec restituisce confidence: unknown per loro, e il flusso deve tornare all’inserimento manuale. Sul mercato RU è una quota considerevole; è importante che la UI non vada in crash in questi casi ma degradi pulitamente al percorso vecchio.
Qual è la latenza di risposta?
Decine di millisecondi per la decodifica più una lookup locale sui dati di riferimento MariaDB. Nessuna API esterna nel percorso caldo — tutto è readonly-locale. Questo rende Vindec sicuro da integrare direttamente in input-onChange di un form web senza lag percepito dall’utente.
Privacy del VIN?
Un VIN di per sé non è un dato personale — identifica il veicolo, non il proprietario. Ma non memorizziamo i VIN grezzi delle vostre richieste: solo statistiche d’uso aggregate (numero di richieste, distribuzione della confidenza, WMI frequenti). In caso di esigenze di compliance, viene scritto separatamente nel contratto.
Self-hosted è supportato?
Discusso con i partecipanti alla beta. Architettonicamente Vindec è un singolo binario Go + PostgreSQL + una replica readonly dei dati di riferimento del catalogo FAPI; si distribuisce in Docker entro un’ora. In caso di requisiti on-premise (banche, settore pubblico) — è un percorso supportato.