Главная → Блог → Проверка растаможки авто по VIN через API: сценарий для импортёров и площадок

Проверка растаможки авто по VIN через API: сценарий для импортёров и площадок

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

Растаможку по VIN проверяют методом GET /customs?vin=: ответ показывает, ввозился ли автомобиль из-за рубежа, дату выпуска в свободное обращение и таможенные сведения. Одного метода мало для решения: его сверяют с ЭПТС (/elpts), ограничениями (/score) и характеристиками (/brief), и так получается автоматический вердикт для импортёра или площадки. Проверка стоит 1 ₽ за запрос, подключение от 100 ₽ без договора, тест бесплатно на VIN X7TEST00000000001.

Что подтверждает проверка растаможки и чего она не покажет

Метод проверки растаможки /customs принимает VIN и возвращает три группы сведений: признак того, что автомобиль ввозился из-за рубежа, дату выпуска в свободное обращение и таможенные данные по ввозу. Это ответ на вопрос "как машина попала в страну и когда была оформлена".

История регистрации отвечает на другой вопрос: кто и когда владел машиной после постановки на учёт. Там нет таможенной стороны. Поэтому для импортного авто один отчёт по регистрациям растаможку не заменяет, а растаможка не заменяет владельцев и ограничения.

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

Сценарий для импортёра: проверка партии перед постановкой на учёт

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

Шаг 1. Расшифровка VIN

Расшифровка VIN (/decode?vin=) даёт модель, поколение, кузов, двигатель, годы выпуска, страну и завод сборки. Сопоставьте страну сборки и год с тем, что указано в документах на партию. Если по документам машина 2021 года, а VIN говорит о другом поколении, дальше можно не идти.

Шаг 2. Растаможка

/customs?vin=: есть ли сведения о ввозе и дата выпуска в свободное обращение. Дата должна логично стыковаться с датой выпуска машины и с вашими документами.

Шаг 3. Электронный ПТС

Проверка электронного ПТС (/elpts?vin=) возвращает страну, тип ТС, утилизационный сбор, статус ограничений и таможенных ограничений, последнее регистрационное действие. Здесь видно, не висят ли на ПТС таможенные ограничения.

Шаг 4. Ограничения и розыск

Ограничения и розыск (/score?vin=): запреты на регистрационные действия с типом, основанием, регионом и данными исполнительного производства, а также розыск. Подробнее о разборе этого ответа - в материале проверка ограничений ГИБДД через API.

Пример запроса

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

На тестовом VIN вернётся образец по схеме метода с полем "testMode": true. Списания нет, токен при этом нужен. Реальные значения полей смотрите в ответе и в документации метода: схема одна, и ваш код можно отладить до первого платного вызова.

Правила вердикта

Три исхода, и их лучше зафиксировать в коде, а не в голове менеджера:

• Пропустить: /customs вернул данные о выпуске в свободное обращение, в /elpts нет таможенных ограничений, в /score чисто, страна сборки из /decode сходится с документами.
• На ручную проверку: /customs вернул success: 0, либо даты не стыкуются, либо характеристики расходятся с документами.
• Отказать: в /elpts есть таможенные ограничения, в /score запрет на регистрационные действия или розыск.

Сценарий для площадки и автосалона

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

Если авто импортное, сопоставьте краткие данные ТС (марка, модель, год, мощность, тип и объём двигателя, руль, масса) или расшифровку VIN с тем, что вписал продавец. Расхождение по мощности или году - частый признак перебитых данных или ошибки в документах.

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

Для полного допуска к публикации добавьте реестр залогов и проверку лизинга: машина может быть чисто растаможена и при этом в залоге у банка. Итог выводится бейджем на карточке: например, "проверено: ввоз, ограничения, залог". Бейдж ставьте только если все нужные проверки действительно выполнены, иначе он вводит покупателя в заблуждение. Как собрать всё в один набор, описано в статье про сводный отчёт по VIN для бизнеса.

Авто из Белоруссии и без VIN

Запрос "проверка растаможки в Белоруссии" встречается часто. Мы не обещаем доступа к белорусским базам. Что можно сделать по VIN через наши методы: расшифровать его, посмотреть /customs, проверить ЭПТС, ограничения и залоги. Если по машине есть данные, вы их получите; если нет - получите бесплатный success: 0 и отправите случай на ручную проверку документов.

Для автомобилей без VIN, например японских, вместо него работает номер кузова. История регистрации по номеру кузова: GET /body?body=. Ограничения - GET /score-body?body=. Залоги - /pledge?body=.

Если на руках есть номер электронного ПТС, используйте /elpts?pts=: VIN для этого не нужен.

Если машина уже зарегистрирована в России, /vin2gos вернёт действующий госномер по VIN, а /plate-history покажет прежние госномера списком от последнего к первому (платно только когда найдено больше одного номера).

Код: цепочка вызовов и учёт стоимости

Базовые цены за запрос: /customs - 1 ₽, /elpts - 1 ₽, /decode - 1,6 ₽, /score - 20 ₽. Полная цепочка - 23,6 ₽ на машину. Самый дорогой шаг - /score, поэтому его вызываем только если первые проверки пройдены.

import requests

BASE = "https://api.avtovincod.ru"
HEADERS = {"Authorization": "Bearer ВАШ_ТОКЕН"}

def call(method, vin):
 r = requests.get(f"{BASE}/{method}", params={"vin": vin},
 headers=HEADERS, timeout=60)
 data = r.json()
 return data

def check(vin):
 spent = 0.0
 result = {"vin": vin, "verdict": "review"}

 for method in ("decode", "customs", "elpts"):
 data = call(method, vin)
 result[method] = data
 spent += (data.get("billing") or {}).get("charged", 0)

 if result["customs"].get("success") != 1:
 return result, spent # на ручную проверку, score не тратим

 score = call("score", vin)
 result["score"] = score
 spent += (score.get("billing") or {}).get("charged", 0)
 # дальше ваши правила: ограничения, розыск, таможенные ограничения
 return result, spent

Что здесь важно. Всегда проверяйте success: единица значит, что проверка выполнена и тарифицируется, ноль - данных нет, бесплатно. Реальную стоимость берите из блока billing (поля charged, balance, requestId), он же дублируется в заголовках X-Charged, X-Balance, X-Request-Id. Нет блока - запрос не списан. Сохраняйте requestId рядом с решением по машине: пригодится при разборе спорных случаев.

Для отладки используйте тестовые значения: ответы приходят с testMode: true и ничего не стоят. Примеры на других языках (PHP, JavaScript, Go, Java, C#, Ruby, 1С) есть на странице каждого метода.

Партии и контроль после ввоза

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

После постановки на учёт машины никуда не исчезают. Мониторинг автомобилей регулярно проверяет список по данным реестров и сообщает только об изменениях: залог, запрет на регистрационные действия, арест, розыск, смена собственника или госномера. Каналы - Telegram, почта и вебхук (POST JSON с подписью X-AVC-Signature, события monitor.change и другие). Это не GPS, а именно слежение по реестрам.

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

Как подключиться

Регистрация в личном кабинете занимает минуту, токен выдаётся сразу. Пополнение от 100 ₽ банковской картой, для юрлиц по счёту с актом. Договор не нужен, бесплатного периода нет, зато тестовые значения работают без пополнения. Начните с VIN X7TEST00000000001, прогоните цепочку целиком, затем переключайтесь на реальные VIN. Документация: /customs и общий раздел docs.

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

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

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

Проверить обременение на автомобиль: залог через API ФНП