VIN-запрос - запрос автодеталей

VIN-запрос — описание и инструкция

Плагин «VIN-запрос» добавляет на сайт форму запроса запчастей по VIN-коду, хранит заявки в базе и отправляет

уведомления на e‑mail и в Telegram. Есть выгрузка в CSV и интеграция с Bitrix24.

Что умеет плагин

Форма VIN-заявки : VIN-код, марка/модель/год, список запчастей, контакты, способ связи и страница

Хранение заявок : все заявки сохраняются в базу и доступны в бекенде.

Уведомления : письмо на e‑mail и сообщение в Telegram (по желанию).

Выгрузка CSV : экспорт заявок с выбором кодировки и разделителя.

Bitrix24 : создание лида и, при необходимости, контакта/компании.

Расширенные возможности

Глубина выбора авто до 5 уровней : 2 (Марка/Модель), 3 (Марка/Модель/Год), 4 и 5 — дополнительные подкатегории каталога, управляется настройкой «Ограничить число выводимых подкатегорий».

Настраиваемые заголовки полей : для уровней 1–3 (Марка, Модель, Год выпуска) и дополнительно для уровней 4–5.

Фронтенд‑форма с каскадными списками : выпадающие списки автоматически подгружают варианты на каждом уровне; если вариантов нет, показывается «Нет данных».

Сохранение всех данных : в БД добавлены поля level4 и level5 , значения отправляются с формы и записываются вместе с VIN, Маркой, Моделью и Годом.

Отображение в админке : список заявок показывает «Марка/Модель/Год/4/5», карточка заявки по клику включает уровни 4 и 5 (если заполнены).

Уведомления и интеграции : Email и Telegram содержат уровни 4/5; в Bitrix24 уровни 4/5 добавляются в комментарии лида.

Все перечисленное работает без учета каких‑либо флагов; управление глубиной происходит через настройку в разделе VIN.

Где найти заявки

Админка → Магазин → слева в меню появится пункт «Заявки по VIN» . Прямая ссылка:

/webasyst/shop/?plugin=vinzapros

Там же доступны удалённые заявки и страница экспорта (кнопки вверху).

Как встроить на сайт (интеграция в тему)

Подключите стили и скрипты плагина в index.html вашей темы перед :

{if $wa->shop}{shopVinzaprosPlugin::head()}{/if}

Выведите форму VIN-заявки в том месте, где хотите её показать (например, перед или на любую страницу):

{if $wa->shop}{shopVinzaprosPlugin::displayVin()}{/if}

Примечания:

Форма отправляет данные AJAX‑запросом, поэтому ничего вручную подключать дополнительно не нужно.

Список марок может заполняться автоматически из категорий (см. настройки ниже).

Админка → Магазин → Настройки → Вкладка «VIN-запрос». Включите плагин и при необходимости задайте цели метрики.

2. Уведомления

E‑mail : адрес отправителя и получателя, тема письма, HTML‑шаблон и текст «Спасибо».

Telegram (опционально): включите переключатель, укажите chat_id и bot token . После

сохранения тестируйте отправкой формы.

3. VIN-настройки

ID категорий марок : введите через запятую ID категорий вашего каталога, из которых нужно показать

список «Марка»

Можно указать сами категории марок или их родительские — плагин подхватит дочерние.

Способы связи : отметьте, какие варианты показывать (Телефон/WhatsApp/Telegram/Макс).

Текст «Спасибо» : HTML‑текст, который увидит пользователь после успешной отправки.

4. Интеграция с Bitrix24 входит в премиум версию

Включите интеграцию, укажите: домен ( ваш_домен ), ID пользователя ( 1 по умолчанию),

вебхук и источник ( WEB по умолчанию).

Выберите: создавать контакт и/или компанию автоматически.

В заявку (лид) передаются все данные формы: VIN , марка/модель/год , запчасти ,

контакты , способ связи , страница .

Как работает внутри

Уведомления

E‑mail : отправляется на адрес, указанный в «Уведомления → E‑mail получателя». Шаблон письма

настраивается там же.

Telegram : если включено и заданы chat_id / token , приходит читабельное сообщение вида:

VIN-заявка - Название сайта

VIN: WVWZZZ...

Марка/Модель/Год: ...

Запчасти: ...

Контакт: Имя, +7..., email

Связь: Телефон/WhatsApp/Telegram (Ник)

Со страницы: https://...

Почему не появляются марки в списке? Проверьте, что в «VIN-настройках» указаны корректные ID

категорий (или их родителей) из вашего каталога, и что категории/подкатегории реально существуют.

Не приходят уведомления в Telegram. Проверьте, что в «Уведомлениях» включен Telegram и верно

проставлены chat_id и bot token . Затем отправьте тестовую заявку.

Где изменить текст «Спасибо» после отправки? В «VIN-настройках» отредактируйте поле «Текст спасибо».

Как перенести форму в другое место на странице? Перенесите вызов

{if $wa->shop}{shopVinzaprosPlugin::displayVin()}{/if} в нужный

шаблон/позицию.