Личный кабинет

Главная → Блог → Проверка авто по VIN в автосалоне и трейд-ин: как автоматизировать через API АвтоВинКод

Автосалоны и трейд-ин

Проверка авто по VIN в автосалоне и трейд-ин: как автоматизировать через API АвтоВинКод

· Редакция AvtoVinCod · 8 мин чтения

Проверка авто по VIN в автосалоне и трейд-ин: как автоматизировать через API АвтоВинКод

Автоматизировать проверку авто по VIN в трейд-ине лучше каскадом: сначала дешёвые методы (госномер в VIN, краткие данные, ограничения), затем дорогие только для машин, прошедших первый фильтр. Оценщик вводит VIN или госномер в CRM, а сервис АвтоВинКод по одному Bearer-токену возвращает JSON, по которому система выдаёт статус "выкупаем / доосмотр / отказ". Так себестоимость отчёта в среднем снижается, а решение принимается за минуты.

Где в трейд-ине теряются деньги без автоматической проверки

Типовой набор потерь знаком каждому, кто выкупал машины потоком. Автомобиль с запретом на регистрационные действия: купили, а поставить на учёт и продать нельзя. Активный залог в реестре ФНП: банк имеет право на машину, и ваша сделка превращается в спор. Скрытое ДТП, о котором клиент "забыл". Скрученный пробег: по ЕАИСТО 180 тысяч, в объявлении 95. Бывшее такси или каршеринг, которое по рынку уходит с заметным дисконтом, а вы заплатили как за обычную машину.

Один такой промах легко съедает маржу с нескольких удачных сделок. А ручная проверка в нескольких окнах и сервисах не выдерживает потока: оценщик копирует VIN в один сайт, госномер в другой, склеивает результаты в заметках. При десяти заявках в день это терпимо, при пятидесяти начинаются пропуски и расхождения, а решение клиенту задерживается на часы.

Разовые веб-отчёты для частных покупателей дают красивую страницу для человека, но не встраиваются в процесс. API проверки авто отдаёт данные ГИБДД и других государственных реестров в JSON, и CRM сама решает, что делать дальше. А общий перечень того, что смотреть при выкупе, собран в чек-листе проверки машины для автосалона и выкупа.

Вход: VIN или госномер

Клиент по телефону или в форме на сайте чаще называет только госномер. VIN он обычно не помнит. Поэтому первый вызов в цепочке - VIN по госномеру: GET /gos2vin?plate= возвращает VIN, номер кузова или шасси, СТС, марку, модель, год, мощность и признак такси. Дальше все методы работают уже по VIN. Подробный разбор сценария есть в статье про проверку по госномеру.

Обратный путь тоже пригодится: GET /vin2gos?vin= даёт действующий госномер (по базовой цене 6 рублей за запрос), а GET /autopark?vin= - номер двигателя, если нужно сверить его с документами при приёмке. Ответ /autopark приходит за доли секунды, и платно только если номер найден.

Для автозаполнения заявки берём GET /brief (марка, модель, год, мощность, тип и объём двигателя, руль, масса) и GET /decode (поколение, кузов, коробка, привод, страна и завод сборки). Оценщику не нужно набирать характеристики руками, а расхождение между словами клиента и данными по VIN видно сразу.

Интеграцию можно отладить без затрат: тестовый VIN X7TEST00000000001 и госномер Т000ТТ00 работают бесплатно, образцы JSON приходят в том же формате, что и боевые ответы.

Каскад проверок: порядок и стоимость

Идея простая: не тратить рубли на глубокую проверку машины, которую можно отсеять за двадцать. Каскад из трёх шагов выглядит так.

Шаг 1. Дешёвый отсев

/brief подтверждает, что машина вообще та, о которой говорит клиент. /score возвращает запреты на регистрационные действия (тип, основание, регион, исполнительное производство), розыск и периоды владения. Об этом подробно в материале про проверку ограничений ГИБДД. /pledge показывает, действует ли залог в реестре ФНП, это разобрано в статье про проверку залога.

Если /score или /pledge нашли стоп-фактор, машина получает "отказ" и каскад на ней заканчивается. Метод /enforcement (0,65 рубля) в обязательный отсев не входит, его вызывают точечно. Первый случай: в /score есть ограничение с номером исполнительного производства (enforcement_number), и нужно узнать сумму долга. Если долг мелкий и клиент готов погасить его на месте, заявку можно вернуть из "отказа" в работу. Второй случай: владелец - организация, и вы проверяете долги по ИНН (?inn=) или по названию, а для физлица по ФИО и дате рождения.

Шаг 2. Основная история

Если стоп-факторов нет, добираем картину: /gibdd (периоды владения, ПТС и СТС), /probeg (диагностические карты ЕАИСТО и пробег), /osago-history (все полисы, цель использования, тип собственника), /taxi, /sharing, /lizing. Отдельно о двух последних: проверка каршеринга и проверка лизинга.

Шаг 3. Для дорогих и спорных машин

Здесь запросы дороже, и вызываем их выборочно: /accidents-rt (ДТП по базе ГИБДД с 2015 года, асинхронно), /hidden-damage (события, которых нет в ГИБДД), /europrotocol (ДТП без вызова ГИБДД), /customs-fts (таможенный выпуск и утильсбор). Для импорта из США или Канады сначала дешёвый /vin-precheck: он за 0,2 рубля показывает, есть ли вообще записи CARFAX и AutoCheck, и только потом имеет смысл заказывать /usa-history за 389 рублей. Для ввозных машин полезны и данные о растаможке. Про ДТП и розыск при выкупе есть отдельная статья: проверка ДТП и розыска при выкупе.

ШагМетодыЦена за запрос, руб.Итого на машину, руб.
Вход/gos2vin88
1. Отсев/brief 1, /score 20, /pledge 2,41 + 20 + 2,423,4
2. История/probeg 3,5, /osago-history 1,9, /taxi 1,8, /sharing 5,4, /lizing 2,2, /offers 1,5, /price 0,53,5 + 1,9 + 1,8 + 5,4 + 2,2 + 1,5 + 0,516,8
3. Глубокая/accidents-rt 19, /hidden-damage 8, /europrotocol 5,5, /customs-fts 7,519 + 8 + 5,5 + 7,540

Цены указаны базовые, за запрос. Метод /gibdd в шаге 2 я не включил в сумму, потому что /score уже отдаёт периоды владения; если нужны полные характеристики и данные ПТС и СТС, добавьте 12 рублей. /enforcement в таблицу не попал по той же причине, что и в тексте: он точечный, 0,65 рубля за вызов. Ошибки и сбои источника не списываются, а у ряда методов платно только найденное: /autopark, /europrotocol, /hidden-damage, /plate-history, /gibdd-archive (NOT_FOUND бесплатно). Это важно для расчёта: часть запросов шага 3 на чистой машине стоит ноль.

Правила принятия решения в коде

Разделите факторы на два класса. Стоп-факторы дают автоматический "отказ": запрет на регистрационные действия, активный залог (status и active_count в ответе /pledge), розыск, арбитражные дела по машине (/lawsuits: споры о собственности, лизинг, банкротство). Факторы снижения цены переводят заявку в "доосмотр" или корректируют предложение: такси, каршеринг, лизинг в прошлом, ДТП, расхождение пробега.

Пробег сверяйте в двух местах. История пробега ЕАИСТО даёт последнюю зафиксированную цифру на дату диагностической карты, а /offers показывает пробег в прошлых объявлениях. Если клиент заявляет 90 тысяч, а в карте двухлетней давности было 140, система ставит флаг. Целевую цену сверяйте с рыночной оценкой: средняя, минимальная и максимальная цена плюс число предложений.

Запрос выглядит так:

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

В ответе нас интересуют found (1 - данные есть, 0 - VIN не найден в базе ГИБДД) и массив ограничений. Каркас решения:

status = "buy"
r = score(vin)
if r.found == 0: status = "manual"
if r.restrictions.length > 0 or r.wanted:
 # по желанию: enforcement(r.restrictions[i].enforcement_number),
 # чтобы узнать сумму долга и решить, гасить ли его на месте
 return "reject"
p = pledge(vin)
if p.active_count > 0: return "reject"
h = collect(probeg, osago_history, taxi, sharing, lizing)
if h.taxi or h.sharing or h.leasing: status = "recheck"
if mileage_gap(h.probeg, offers, claimed) > 0.15: status = "recheck"
return status

Порог расхождения пробега (здесь 15 процентов) подберите по своим данным, универсального значения нет. Названия полей сверяйте с документацией каждого метода.

Интеграция в CRM и процесс оценщика

Часть методов асинхронная: /accidents-rt возвращает задачу, и опрашивать её нужно раз в 30 секунд (до 40 минут), CARFAX и AutoCheck отдают taskId и ждут опроса ?task=, обычно 5-15 минут. /osago-history отвечает за 15-60 секунд. Не блокируйте интерфейс: показывайте оценщику результаты шагов 1 и 2 сразу, а тяжёлые блоки дорисовывайте по мере готовности.

Чтобы не платить дважды, кэшируйте ответ по связке "VIN + метод" на время сделки и не повторяйте вызов при повторном открытии карточки. Подключите мониторинг: доля ошибок по методам, время ответа, остаток депозита (он действует 90 дней).

Сохраняйте полный JSON в карточке сделки вместе с датой запроса. Через месяц клиент скажет, что залога не было, а вы покажете, что на дату оценки он был. Для архивных отчётов в ответе есть checkedAt, дату актуальности данных тоже стоит хранить.

На приёмке пригодятся методы по фото. POST /photo-plate распознаёт госномер, марку, модель и цвет по снимку, стоит 0,1 рубля и списывается только при успехе: оценщик фотографирует машину, а поле заявки заполняется само. Перед публикацией в объявлении снимки прогоняют через POST /plate-hide (размытие, мозаика, заливка или ваш логотип на табличке), за 0,09 рубля на фото.

Экономика и запуск

Считаем на сотню заявок. Вход по госномеру и шаг 1 обходятся в 31,4 рубля на заявку (8 + 23,4). Допустим, 30 из 100 машин отсеялись на запретах, залогах и розыске. Остальные 70 идут на шаг 2 (ещё 16,8 рубля). Из них 20 дорогие или спорные и получают шаг 3 (до 40 рублей). Итого: 100 x 31,4 + 70 x 16,8 + 20 x 40 = 3140 + 1176 + 800 = 5116 рублей на сто заявок, около 51 рубля на заявку. Если выкуплено 25 машин, на выкупленную приходится порядка 205 рублей. Для сравнения: полный набор для всех ста заявок обошёлся бы в 100 x 88,2 = 8820 рублей. Точечные вызовы /enforcement по 0,65 рубля на эту сумму почти не влияют. Цифры иллюстративные, ваша доля отсева будет другой, а методы вы вольны выбирать под свои правила.

Запуск занимает день:

  1. Зарегистрируйтесь в кабинете avtovincod.ru/lk и получите токен: регистрация занимает минуту.
  2. Пополните баланс от 100 рублей картой (чек на email) или по счёту для юрлиц с актом и актом сверки в конце месяца. Договор не нужен.
  3. Прогоните тестовые VIN X7TEST00000000001 и госномер Т000ТТ00, получите образцы JSON.
  4. Реализуйте шаги 1 и 2, правила "buy / recheck / reject".
  5. Добавьте асинхронный шаг 3 и сохранение отчёта в сделку.
  6. Запустите на потоке с ручным контролем оценщика на первую неделю.

Тем, кто пока не пишет код, подойдёт консоль проверки в кабинете: те же данные по VIN, номеру кузова или госномеру в читаемом виде. Остальное делает сервис АвтоВинКод через API.

Частые вопросы

Можно ли проверять авто в трейд-ине только по госномеру?

Да. Метод /gos2vin по госномеру возвращает VIN, номер кузова или шасси, СТС, марку и модель, после чего остальные проверки идут уже по VIN. Часть методов (/probeg, /osago, /taxi, /sharing) принимают и сам госномер.

Чем API проверки отличается от разовых веб-отчётов для частников?

Веб-отчёт - это страница для человека. API АвтоВинКод отдаёт данные ГИБДД и других государственных реестров в JSON, их можно встроить в CRM, запускать автоматически и применять правила решения без ручного копирования.

Сколько стоит полная проверка одной машины в трейд-ине?

По базовым ценам вход по госномеру и шаги 1-2 в примере выше обходятся примерно в 48 рублей, с глубоким шагом 3 около 88 рублей, без CARFAX и аукционных отчётов. Итог зависит от набора методов, а ошибки и сбои источника не списываются.

Как не платить за проверку заведомо неподходящих машин?

Строить каскад: сначала /brief, /score, /pledge, и при стоп-факторе (запрет, залог, розыск) останавливаться. Дорогие методы вызываются только для машин, прошедших отсев. У ряда методов платно лишь найденное.

Когда в каскаде нужен метод /enforcement?

Точечно, а не для каждой машины. Он нужен, когда в /score найдено ограничение с номером исполнительного производства и надо узнать сумму долга (например, если клиент готов погасить небольшой долг на месте), а также при проверке юрлица по ИНН или физлица по ФИО и дате рождения.

Как протестировать интеграцию без затрат?

Используйте тестовые значения: VIN X7TEST00000000001 и госномер Т000ТТ00. Для фото-методов есть параметр ?test=1, а для приставов тестовые ?number=00000/00/00000-ИП и ?inn=0000000000.

Проверка автомобилей через API

Без договора и долгих согласований: пополните баланс от 100 ₽ и проверяйте реальные машины. Тестовые значения бесплатно, документация с примерами на популярных языках.

Получить токен   Документация API

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