Главная → Блог → VIN по госномеру и госномер по VIN: двусторонняя конвертация в вашей CRM

VIN по госномеру и госномер по VIN: двусторонняя конвертация в вашей CRM

19 октября 2026 · Редакция AvtoVinCod · 8 мин чтения

VIN по госномеру в CRM получают одним запросом GET /gos2vin?plate=: в ответе VIN, номер кузова или шасси, СТС, марка, модель, год и мощность. Обратное преобразование делает GET /vin2gos?vin=, а номер двигателя по VIN возвращает GET /autopark?vin= за доли секунды. Проверить всю цепочку можно бесплатно на тестовых значениях X7TEST00000000001 и Т000ТТ00.

Зачем бизнесу конвертация госномера в VIN и обратно

Клиент почти всегда называет госномер. Он у него на виду, в приложении страховой, в объявлении, в голове. А вот большинство проверок и документов требуют VIN: залоги в реестре ФНП ищутся по VIN, номеру кузова или шасси, история регистрации тоже строится от VIN. В договоре купли-продажи, акте приёма и лизинговой заявке нужны ещё номер двигателя и СТС.

Типичные ситуации из практики:

• трейд-ин и выкуп: менеджер вносит в CRM госномер со слов клиента, а оценщику нужен полный набор данных для акта;
• лизинг: в заявке указан только номер, а андеррайтеру требуется VIN для проверки обременений;
• страховая: при андеррайтинге надо сверить заявленные характеристики с тем, что записано по VIN;
• доска объявлений: продавец ввёл номер, а карточку нужно заполнить маркой, моделью, годом и мощностью без ручного ввода;
• автопарк: в учёте есть номера, а для сервиса и страхования нужны VIN и номер двигателя.

На выходе нужен стабильный набор: VIN, кузов или шасси, СТС, номер двигателя. Дальше о том, как получить его тремя методами. Общую картину по интеграции данных ГИБДД мы описывали в материале API ГИБДД для бизнеса.

VIN по госномеру: GET /gos2vin

API поиска VIN по госномеру принимает параметр plate. Авторизация - Bearer-токен из личного кабинета. Цена метода 8 ₽ за запрос.

Пример на cURL с тестовым номером:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/gos2vin?plate=Т000ТТ00"

То же на Python:

import requests

r = requests.get(
 "https://api.avtovincod.ru/gos2vin",
 params={"plate": "Т000ТТ00"},
 headers={"Authorization": "Bearer ВАШ_ТОКЕН"},
 timeout=30,
)
data = r.json()
if data.get("success") == 1:
 vin = data.get("vin")

В ответе приходят VIN, номер кузова или шасси, СТС, марка, модель, год выпуска, мощность и признак такси. Последний полезен сразу: автомобиль с такси в прошлом лучше пометить в карточке до осмотра. Точные имена полей сверяйте со схемой в документации, в примере выше имя vin показано для наглядности.

success 1 и success 0

Логика простая. success: 1 - проверка выполнена, запрос тарифицируется. success: 0 - проверка не выполнена или данных нет, запрос бесплатный. Ошибки и сбои источника тоже не списываются. Поэтому в коде не нужно городить компенсации: ветка "не нашли" ничего не стоит.

Учёт расходов в CRM

В каждом ответе, записанном в историю запросов, есть блок billing: charged, currency, billed, balance, requestId. Те же значения приходят в заголовках X-Charged, X-Balance и X-Request-Id. Сохраняйте requestId и сумму списания рядом с карточкой автомобиля: тогда в конце месяца видно, сколько стоила проверка каждой сделки. Если блока billing нет, запрос не списан. По balance удобно сделать уведомление в CRM о низком остатке, чтобы интеграция не встала посреди рабочего дня.

Госномер по VIN: GET /vin2gos

Обратная задача возникает не реже. VIN лежит в договоре, ПТС или объявлении, а в карточке нужен действующий номер: для штрафов, парковки, въезда на территорию, поиска машины на площадке. API госномера по VIN принимает vin и возвращает действующий госномер, а также марку, модель, год, мощность, номер кузова, шасси и, при наличии СТС, поле sts. Цена 6 ₽ за запрос.

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/vin2gos?vin=X7TEST00000000001"

Метод отдаёт текущий номер. Если нужно знать, какие номера были у машины раньше (перерегистрация, смена региона, утерянные знаки), используйте историю госномеров автомобиля: GET /plate-history?vin= или ?body=. Он возвращает список номеров от последнего к первому, без дат, стоит 1,5 ₽ и списывается только если найдено больше одного номера (found >= 2). Один номер или ни одного - found: 0, бесплатно. Как читать смену владельцев и номеров в связке, написано в статье история регистрации и смена госномеров.

Номер двигателя по VIN: GET /autopark

Номер двигателя нужен там, где есть бумага: договор, акт приёма-передачи, сверка с документами при выкупе. Номер двигателя по VIN через API принимает vin, body или chassis и возвращает номер двигателя, марку, модель и год выпуска. Ответ приходит за доли секунды, поэтому метод можно вызывать прямо при открытии карточки, не выносить в фоновую очередь.

Платно только если номер найден. Цена 0,8 ₽. Нашли - заполнили поле, не нашли - ничего не потеряли, менеджер вводит значение вручную с шильдика.

Вся цепочка живёт в одном сервисе с одним токеном. Связка /gos2vin + /autopark закрывает данные от госномера до номера двигателя за два запроса и 8,8 ₽ на машину по базовым ценам. Если нужно ещё и автозаполнение характеристик, добавьте /brief за 1 ₽: получится 9,8 ₽ за три запроса. Запрашивать для одной машины ещё и /vin2gos не нужно: номер у вас уже есть, он и был исходной точкой.

Мотоциклы, техника и авто без VIN

Мотоцикл и другая техника устроены капризнее легковушки. Метод вернёт то, что есть в источнике по этому номеру: иногда это VIN, иногда только номер рамы или шасси. Если записи нет, придёт success: 0. Это не ошибка интеграции, а штатный исход, и его нужно обработать: показать менеджеру поле для ручного ввода и пометить карточку "VIN не определён". Деньги за такой запрос не списываются.

С японскими автомобилями, у которых VIN в привычном виде нет, работайте через номер кузова. В методах, которые это поддерживают, есть параметры body и chassis. Например, номер двигателя запрашивается как GET /autopark?body=... или ?chassis=..., а историю регистрации можно получить через GET /body?body=. Для спецтехники и прицепов используйте chassis.

Честно об ограничениях: данные зависят от наличия записи в источнике. Свежая регистрация, редкий тип ТС или нестандартный номер могут дать пустой ответ. Закладывайте ручной ввод как запасной путь, а не как исключение.

Готовая схема для CRM

Рабочий алгоритм получается коротким:

1. Нормализуйте госномер: верхний регистр, без пробелов, кириллица вместо латиницы там, где буквы визуально совпадают. Менеджеры вводят "a123bc77" латиницей чаще, чем кажется.
2. Вызовите /gos2vin. При success: 1 сохраните VIN, кузов или шасси, СТС и характеристики.
3. Вызовите /autopark по полученному VIN и запишите номер двигателя.
4. Если нужно автозаполнение, добавьте краткие данные ТС (1 ₽) или расшифровку VIN (1,6 ₽): поколение, кузов, двигатель, коробка, привод. Подробности в материале про автозаполнение карточки авто по VIN.

Кэширование, таймауты, повторы

VIN автомобиля не меняется, поэтому после первого успешного ответа храните его в карточке и не запрашивайте повторно. Это экономит деньги и время. Госномер, наоборот, может смениться, так что связку "номер - VIN" лучше помечать датой получения.

Различайте два случая. Сетевая ошибка или таймаут - повторите запрос с паузой, например три попытки с нарастающим интервалом. Ответ success: 0 - это уже результат, бессмысленно долбить тот же номер десять раз подряд; повторите разве что через день, если источник мог не успеть обновиться. Таймаут на клиенте ставьте около 30 секунд.

Списки машин

Для пакета в сотни номеров хватит цикла по списку с одним токеном: пауза между запросами, ограничение параллельности, лог requestId. Если программировать не хочется, есть массовая проверка автомобилей в кабинете: список до 100 машин файлом Excel, CSV или вставкой текста, расчёт "не больше" до запуска и итоговая таблица с выгрузкой в Excel. О готовности придёт сообщение на почту и в Telegram. Оплата, как и в API, только за полученные ответы.

AI-агенты и no-code

Если логику строите в no-code платформе или даёте её AI-агенту, подключите MCP-сервер: https://api.avtovincod.ru/mcp, авторизация Bearer-токеном. Вызов инструмента тарифицируется как запрос к соответствующему методу.

Что проверить дальше, когда VIN получен

VIN в руках - это только начало. Короткая матрица следующих шагов:

Как собрать из этого сценарий для площадки или салона, описано в статье проверка авто по госномеру для автосалона и площадки. А чтобы не опрашивать список вручную, подключите мониторинг автомобилей: он сообщает только об изменениях (новый штраф, залог, запрет, смена собственника или госномера) в Telegram, на почту или вебхуком.

Тест и подключение

Протестировать интеграцию можно без оплаты. Тестовые значения: VIN X7TEST00000000001, госномер Т000ТТ00 (или T000TT00). Любой метод отвечает образцом по своей схеме, бесплатно, с полем "testMode": true. Токен при этом нужен.

Регистрация занимает минуту, токен выдаётся сразу. Пополнение от 100 ₽ картой, юрлицам доступен счёт с актом и актом сверки в конце месяца. Договор не нужен, бесплатного пробного периода нет, зато нет и согласований. Депозит действует 90 дней. Примеры кода на cURL, PHP, Python, JavaScript, Go, Java, C#, Ruby и 1С лежат на странице каждого метода в документации API, уже с тестовыми значениями. Прогоните цепочку /gos2vin, /autopark, /vin2gos на тесте, убедитесь, что поля ложатся в вашу схему, и переключайтесь на боевые данные.

Читайте также

Поиск запчастей по VIN коду: интеграция через API в магазин

Бот для проверки авто в Telegram на API: за вечер

Проверить техосмотр по базе ЕАИСТО через API: гос номер и VIN