Главная → Блог → Как проверить машину на штрафы и долги через API: контроль автопарка и лизингового портфеля

Автопарки и лизинг

Как проверить машину на штрафы и долги через API: контроль автопарка и лизингового портфеля

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

Проверить машину на штрафы в автоматическом режиме можно методом GET /fines по номеру СТС: в ответе сумма, дата, подразделение, скидка со сроком и статус оплаты. Стоимость запроса 0,9 ₽, поэтому парк из сотен машин удобно опрашивать по расписанию и передавать новые начисления в учётную систему. Перед сделкой или выдачей в лизинг к штрафам добавляют проверку залогов, ограничений и судебных дел.

Зачем бизнесу автоматический контроль штрафов

В автопарке штраф почти всегда прилетает не вовремя. Водитель получил камерное постановление, уведомление ушло собственнику, а бухгалтерия узнала о нём через три недели. Скидка за раннюю оплату к этому моменту сгорела, и вместо суммы со скидкой компания платит полную. На парке в 300 машин это превращается в постоянную статью потерь, а не разовую неприятность.

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

В выкупе и трейд-ине долги нужно знать до оценки. Клиент говорит "всё чисто", а в базе три неоплаченных штрафа. Если выяснить это после расчёта, разницу вы уже отдали.

Ручная проверка по одной машине на сайте работает, пока машин десять. На сотнях она превращается в чью-то ежедневную рутину с ошибками и пропусками. API убирает человека из этой цепочки: система сама спрашивает, сама сравнивает с прошлым результатом и сообщает только о новом.

Что умеет метод /fines

Метод принимает один из трёх параметров. Выбор зависит от того, что у вас есть и что нужно узнать.

sts - номер свидетельства о регистрации. Основной сценарий для парка: все начисления по машине.
driverLicense - номер водительского удостоверения. Нужен, когда контролируется водитель, а не машина.
numPost - УИН конкретного постановления. Подходит для уточнения статуса известного штрафа.

В ответе по каждому начислению приходят сумма, дата, подразделение, скидка и срок её действия, статус оплаты. Для системы уведомлений этого хватает: по сроку скидки можно приоритизировать оплату, по подразделению понять происхождение штрафа.

Важная деталь тарификации. Это реестровая проверка, и она списывается при успешном выполнении, даже если штрафов нет (found: 0). Пустой ответ - тоже результат, за который заплачено. Полное описание полей и схем смотрите в документации метода штрафов ГИБДД, здесь я не буду её пересказывать.

Пример запроса и разбор ответа

Начните с тестовых значений: они бесплатны, но токен нужен.

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

Ответ приходит в JSON, с полем "testMode": true и образцом по схеме метода. В боевом режиме структура та же: success, данные по начислениям и блок billing с полями charged, currency, billed, balance, requestId. Те же сведения дублируются в заголовках X-Charged, X-Balance, X-Request-Id. Нет блока billing - запрос не списан.

Теперь главное, на чём спотыкаются при первой интеграции: как отличить "штрафов нет" от "проверка не выполнена".

success: 1 и found: 0 - проверка выполнена, начислений нет. Запрос тарифицируется.
success: 1 и список начислений - проверка выполнена, есть что показывать.
success: 0 - проверка не выполнена или данных нет. Бесплатно, и это не значит, что штрафов нет.

Если в коде success: 0 трактуется как "чисто", вы получите ложное спокойствие в тот день, когда источник даст сбой. Храните состояние "не проверено" отдельно.

Ошибки и что с ними делать

Формат ошибки: {"success":0,"error":"текст","code":"КОД"}.

400 - неверный формат параметра. Повторять бессмысленно, исправляйте данные (чаще всего это лишние пробелы или буквы в номере СТС).
401 - проблема с токеном. Повтор не поможет, проверьте заголовок.
402 - не хватает баланса. Остановите очередь и уведомите ответственного, иначе получите тысячи одинаковых ошибок.
403 - доступ или ограничение по IP.
429 - превышены лимиты. Повторяйте с нарастающей задержкой.
503 - источник недоступен. Повторяйте позже, запрос не тарифицируется.

Как получить СТС и VIN для парка

Типичная ситуация: в учёте у парка только госномера. Для /fines нужен СТС, и его нужно получить один раз. Метод получить VIN и СТС по госномеру (GET /gos2vin?plate=) возвращает VIN, номер кузова или шасси, СТС, марку, модель, год и мощность. Стоимость 8 ₽ за машину.

Обратный случай: есть VIN, а госномера нет. Тогда госномер по VIN (GET /vin2gos?vin=) даёт действующий номер и СТС, если он есть в данных. Цена 6 ₽.

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

Архитектура ежедневного мониторинга

Расписание. Для активных машин хватает одного опроса в сутки. За несколько дней до окончания скидки по известному штрафу можно опрашивать чаще, но только по тем машинам, где такой штраф есть. Это точечная, а не массовая нагрузка.

Хранение. Сохраняйте снимок прошлого ответа и сравнивайте с новым по УИН. Уведомление отправляйте только о новых начислениях и об изменении статуса оплаты. Иначе ответственные быстро научатся игнорировать рассылку.

Очередь и лимиты. Не запускайте 500 запросов одновременно. Поставьте задачи в очередь с ограничением параллелизма, а на 429 отвечайте повтором с растущей паузой. На 503 откладывайте машину в конец очереди и пробуйте снова позже. Ошибки 400 складывайте в отдельный список на ручной разбор.

Бюджет. По базовым ценам: 500 машин × 0,9 ₽ × 30 дней = 13 500 ₽ в месяц при ежедневном опросе. Если опрашивать через день, выйдет вдвое меньше. Для сравнения, одна пропущенная скидка по крупному штрафу легко стоит дороже. Фактическую стоимость каждого запроса всегда видно в блоке billing.

Сценарий для лизинга: штрафы плюс залоги и ограничения

Перед выдачей. Штрафы здесь вторичны, главное - чистота предмета лизинга. Проверяйте реестр залогов ФНП (2,4 ₽), ограничения и розыск (20 ₽, включает запреты на регистрационные действия и периоды владения) и судебные дела по автомобилю (3 ₽). Если машина уже в залоге или под запретом, выдавать её в лизинг поздно разбираться.

В период договора. /fines по расписанию, как описано выше. В своей системе привяжите каждое начисление к договору и лизингополучателю по дате нарушения, чтобы выставлять требования без ручной сверки.

При возврате. Перед реализацией сделайте проверку долгов ещё раз и сравните с историей начислений за период договора. Всё, что вылезло после возврата, нужно успеть предъявить до продажи.

Сами договоры лизинга по конкретному автомобилю проверяются отдельным методом: проверка договоров лизинга по VIN. Он нужен, если вы принимаете в работу машину с неизвестной историей.

Сценарий для выкупа и трейд-ина

Здесь важна скорость. Менеджер на площадке вводит госномер, система через /gos2vin получает VIN и СТС, запрашивает /fines и /score, и ещё до оценки у сотрудника есть список долгов и ограничений. На всё уходят секунды.

Дальше долги учитываются в цене выкупа: сумма неоплаченных штрафов вычитается из предложения или закрывается из расчёта с клиентом по согласованию. Для оценки добавляется /price (0,5 ₽): средняя, минимальная и максимальная цена, динамика и число предложений. Цепочка из трёх-четырёх лёгких запросов стоит единицы рублей против десятков тысяч рублей возможной ошибки.

Подключение и тест

Регистрация в личном кабинете занимает минуту, токен выдаётся сразу. Пополнение от 100 ₽ банковской картой (чек на email). Договора нет, бесплатного периода тоже нет, но есть тестовый режим. Депозит действует 90 дней.

Тест бесплатный: используйте тестовые значения, например VIN X7TEST00000000001 и СТС 0000000000. Ответ придёт с "testMode": true, баланс не изменится. Можно отладить весь конвейер - очередь, сравнение снимков, обработку ошибок - до первого рубля.

Юрлицам доступна оплата по счёту с актом и актом сверки в конце месяца. Общий обзор можно посмотреть на странице API ГИБДД для бизнеса.

Если у вас есть ИИ-агент, подключите MCP-сервер: адрес https://api.avtovincod.ru/mcp, авторизация Bearer-токеном, инструмент fines_check делает ту же проверку, а вызов тарифицируется как запрос к методу.

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

Можно ли проверить штрафы только по госномеру или VIN?

Метод /fines принимает СТС, номер водительского удостоверения или УИН постановления, но не госномер и не VIN. Если в учёте только они, сначала получите СТС через /gos2vin (по госномеру) или /vin2gos (по VIN), сохраните в своей базе и дальше опрашивайте штрафы по СТС.

Сколько стоит проверка штрафов одной машины через API?

Базовая цена запроса к /fines - 0,9 ₽. Фактическое списание видно в блоке billing каждого ответа и в заголовке X-Charged. Актуальные цены всех методов опубликованы в prices.json.

Как часто опрашивать штрафы по автопарку?

Для большинства парков достаточно одного опроса в сутки. Чаще имеет смысл проверять только машины с известным штрафом в последние дни действия скидки. Парк из 500 машин при ежедневном опросе обойдётся в 13 500 ₽ в месяц по базовой цене.

Списываются ли деньги, если штрафов нет?

Да. Это реестровая проверка: если она выполнена (success: 1), запрос тарифицируется, даже когда начислений нет (found: 0). Если проверка не выполнена (success: 0) или источник недоступен (503), деньги не списываются.

Как проверить штрафы по водительскому удостоверению?

Передайте номер удостоверения в параметре driverLicense: GET /fines?driverLicense=... Так можно контролировать конкретных водителей, например в такси или логистике, независимо от машины.

Что делать, если источник ГИБДД недоступен?

Вы получите ошибку 503, она не тарифицируется. Отложите машину в конец очереди и повторите запрос позже с задержкой. Не трактуйте такой ответ как отсутствие штрафов: помечайте машину как "не проверено".

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

Используйте тестовые значения, например СТС 0000000000. Ответ придёт образцом по схеме метода с полем testMode: true, без списания и без пополнения баланса. Токен нужен, получить его можно сразу после регистрации.

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

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

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