iisis.ru

Vindec — VIN-декодер для Каталога по маркам FAPI

Каталог по маркам — теперь по VIN

Vindec — VIN-декодер для Каталога по маркам FAPI

Vindec — API, который по VIN возвращает идентификатор машины в Каталоге по маркам FAPI. Каталог открывается сразу на нужной модификации, без ручного шага «марка → модель → модификация» в витрине.

Анонс закрытой беты Vindec и запись в waitlist — iisis.ru/vindec-beta.

Что внутри

  • 17-символьный VIN на вход, JSON на выход.
  • В ответе — производитель, модификация (двигатель + год + кузов), мощность (кВт), объём (см³), тип топлива, кузова, привода, КПП, плюс идентификаторы модели и модификации для прямого входа в Каталог.
  • Confidence-уровень в каждом ответе: exact / partial / brand_only / unknown. Если уверенности нет — это явно помечено.
  • Локальное хранение справочников Каталога — модели и типы машин лежат у нас, не запрашиваются по сети на каждый запрос.

Пример ответа

Запрос: 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"
  }
}

WMI/VDS/VIS-разбор по ISO 3779 — внутри Vindec, наружу выводится уже готовая модификация и пара идентификаторов для входа в Каталог по маркам FAPI. Если расшифровка VIN неполная (например, по WMI понятен только производитель), confidence будет brand_only или partial — это сигнал интерфейсу: показать диалог выбора модификации руками, не угадывать.

Кому

Сервис рассчитан на клиентов Каталога по маркам FAPI.

  • Уже купили Каталог — Vindec встраивается в вашу витрину или 1С-фронт как ещё одна точка входа: вместо ручного выбора марки/модели клиент вводит VIN.
  • Рассматриваете покупку Каталога — Vindec работает в связке с ним, поэтому имеет смысл начать с самого Каталога.
  • Без купленного Каталога по маркам FAPI — пока нет смысла: Vindec возвращает идентификатор Каталога, который надо во что-то запрашивать.

Куда встраивается

Три типичных сценария — у каждого свой интерфейс, общая часть одна: вместо «марка → модель → модификация» руками клиент или специалист передаёт VIN, и Каталог открывается на нужной строке.

Витрина магазина запчастей. Поле «VIN» рядом с привычным селектором марки. Клиент скопировал 17 символов из ПТС или с лобового стекла — каталог сам прокидывает его на нужный двигатель и поколение. Если расшифровка частичная (partial / brand_only), витрина показывает то, что точно совпало, и оставляет ручной шаг для непокрытых случаев. На покрытых машинах — это ноль ошибок «выбрал не ту модификацию».

Программное обеспечение специалиста по подбору. Парт-сейлер за стойкой принимает звонок: «Skoda Octavia 2011, нужны колодки». Уточняющий вопрос — «VIN сможете продиктовать?» — и через секунду экран уже на нужной модификации, без ручного перебора A5 vs A7, рестайла vs дорестайла, 1.6 MPI vs 1.4 TSI. Сценарий ускоряется в 3-5 раз; ошибочный артикул отсекается на этапе ввода.

Mobile-приёмка на СТО. Приёмщик сканирует VIN со штрих-кода под капотом телефоном, получает модификацию и сразу видит позиции на ТО (масло, фильтры, ремни) в Каталоге по маркам FAPI. Это работает офлайн в кабине автомобиля: справочники Каталога лежат локально, сетевой запрос идёт только на сам Vindec.

Почему API, а не ручной выбор

  • Скорость. Парт-сейлер тратит секунды вместо минут на навигацию марка → модель → модификация → двигатель. На потоке звонков это десятки сэкономленных часов в месяц.
  • Точность модификации. VIN однозначно кодирует конкретный двигатель, год выпуска и комплектацию. Ручной выбор полагается на память клиента («у меня 2014 год… вроде 1.6…») — это путь к неправильному артикулу и возврату.
  • Уровень входа в работу. Менее опытный продавец без многолетнего опыта по конкретной марке делает корректный подбор: VIN-декодер закрывает то, что у спеца со стажем сидит в голове.
  • Аудиторская трассируемость. В заказе хранится исходный VIN — спорный возврат разбирается по факту, а не «он мне сказал, я выбрал».

Статус: закрытая бета

С 2026-05-16 открыт ранний доступ для существующих клиентов Каталога. Бета — это значит:

  • Capacity ограничена, доступ выдаётся партиями.
  • Pilot pricing обсуждается индивидуально с участниками и фиксируется на время контракта.
  • Обратная связь от первых пользователей идёт прямо в roadmap.

Запись в waitlist

  • Email: fapi@iisis.ru, тема Vindec beta. В теле — компания, есть ли уже Каталог, какой объём VIN-запросов планируется.
  • Telegram-канал обновлений: @database_auto_parts — анонсы новых партий доступа.

Технически

  • REST API, JSON.
  • Сервис на Go, хранилище PostgreSQL + readonly-справочники Каталога по маркам FAPI (MariaDB).
  • Развёртывание: managed у нас или self-hosted у вас (обсуждается с beta-участниками).
  • Документация и Swagger выдаются после открытия доступа.

Часто задаваемые вопросы

Для каких марок работает?
API работает для всех марок и моделей, по которым есть данные в нашем Каталоге по маркам FAPI.

Что с лимитами на этапе беты?
Согласовываются индивидуально. Если ваш use case — встроить в витрину с тысячами запросов в день, скажите при записи, чтобы мы корректно спланировали capacity.

Это замена Каталога?
Нет. Vindec не отдаёт запчасти и не строит иерархию марок. Он отдаёт идентификатор машины — точку входа в Каталог по маркам FAPI, который у вас уже есть.

Когда общий доступ?
После выхода из беты — даты не объявляем, чтобы не делить внимание между «обещаниями» и работой с первыми клиентами.

Что если VIN не расшифровывается полностью?
Vindec возвращает confidence: partial или brand_only и заполняет те поля, которые удалось установить (например, по WMI — только производитель). Это явный сигнал клиенту вашего интерфейса: показать диалог выбора модификации руками, не подставлять артикулы наугад. Гипотезы Vindec не возвращает — мы не угадываем, что не закодировано.

А что с японскими машинами без VIN и старыми ВАЗами?
JDM-машины с номером кузова в формате XXX-1234567 и советские/ранние ВАЗ-номера не описаны стандартом ISO 3779 — для них Vindec вернёт confidence: unknown, и поток должен уходить в ручной выбор. На рынке РФ это заметная доля; интерфейсу важно не упасть на таких случаях, а аккуратно деградировать к старому пути.

Какая задержка ответа?
Десятки миллисекунд на расшифровку + одна локальная выборка справочников из MariaDB. Никаких внешних API в горячем пути — всё readonly-локально. Это позволяет встраивать Vindec прямо в input-onChange веб-формы без user-perceived лага.

Что с приватностью VIN?
VIN сам по себе не персональные данные — он идентифицирует машину, не владельца. Но мы не храним сырые VIN от ваших запросов: только агрегированную статистику использования (число запросов, распределение confidence, частые WMI). Если у вас compliance-задача — это пишется отдельным пунктом в контракт.

Self-hosted поддерживается?
Обсуждается с beta-участниками. Архитектурно Vindec — это один Go-бинарь + PostgreSQL + readonly-реплика справочников Каталога; разворачивается в Docker за час. Если у вас on-prem требования (банки, гос-сектор) — это поддерживаемый путь.