ЕАИСТО интеграция и API ЕАИСТО-М
Если вы ведёте учёт в программе для ПТО или в личном кабинете WEB-DK и оформляете диагностические карты в ЕАИСТО-М — обычно достаточно расширения EAISTO.helper в браузере. Оно переносит данные карты из вашей учётной системы в ЕАИСТО и возвращает готовую печатную форму обратно в программу ПТО или кабинет WEB-DK.
EAISTO.helper — как работать с ЕАИСТО из WEB-DK и ПТО
EAISTO.helper — бесплатное расширение для браузеров на движке Chromium (Chrome, Chromium GOST, Яндекс Браузер и аналоги). Оно связывает вашу учётную систему с ЕАИСТО-М: переносит данные карты из программы ПТО или кабинета WEB-DK на сайт ЕАИСТО и возвращает готовую карту обратно в учётную программу или кабинет. Отдельную Windows-программу «коннектор» ставить не нужно.
Разработчики ЕАИСТО рекомендуют Chromium, но на практике сайт ЕАИСТО-М сегодня стабильно работает и в Яндекс Браузере — многие пункты оформляют карты именно в нём. Helper ставится из Chrome Web Store и в Яндекс Браузере тоже (раздел расширений / установка из магазина Chrome).
Что умеет расширение
- Перенести данные из учёта в ЕАИСТО. Карту готовите в своей программе или в WEB-DK, копируете данные, открываете ЕАИСТО-М и нажимаете Ctrl+Shift+Y — поля на сайте ЕАИСТО заполняются из вашей учётной системы, без ручного набора.
- Вернуть готовую карту в учёт. После регистрации в ЕАИСТО расширение передаёт PDF, номер карты и срок действия обратно в программу ПТО или кабинет WEB-DK — карта в учёте отмечается как оформленная.
- Фото с телефона. Снимки удобно делать в приложении «Фото для техосмотра» — на компьютер их можно передать несколькими способами (облако, почта, локальная сеть и др.). Один из вариантов — WEB-DK.Sync, когда обычный интернет ограничен. Фото участвуют в оформлении вместе с данными из учёта.
Сколько это стоит
Установка и обновление расширения — бесплатно. Платите только за действия, которые реально выполняете при оформлении карты: например, отправка черновика в ЕАИСТО, капча и связанные шаги — сумма списывается с лицевого счёта в личном кабинете WEB-DK (обычно несколько рублей за операцию). Пополнить счёт можно в кабинете, когда понадобится.
Как установить
Рекомендуемый способ — установить из Chrome Web Store (или кнопка «Chrome Web Store» в личном кабинете WEB-DK). Так расширение получает обновления автоматически.
Лучше всегда ставить из магазина: при ручной установке из ZIP автообновления не работают — новую версию нужно скачивать и подключать вручную. ZIP с сайта нужен только если в Chrome Web Store долго появляется обновление, а вам уже нужна свежая сборка.
Ручная установка из ZIP (если маркет ещё не обновился)
- Скачайте архив EAISTO.helper с этого сайта.
- Распакуйте ZIP в любую постоянную папку на компьютере (не удаляйте её после установки).
- Откройте страницу расширений браузера:
- Chrome / Chromium: адрес
chrome://extensions - Яндекс Браузер: адрес
browser://tune→ «Дополнения» или меню → «Дополнения»
- Chrome / Chromium: адрес
- Включите режим разработчика (переключатель вверху справа).
- Нажмите «Загрузить распакованное расширение» и укажите папку, в которой лежит файл
manifest.json. - Готово. Чтобы поставить более новую ручную сборку позже — снова скачайте ZIP, замените файлы в папке и нажмите «Обновить» на карточке расширения.
Когда обновление появится в Chrome Web Store, лучше перейти на установку из магазина и удалить вручную загруженную копию — так снова заработают автообновления.
Для ежедневной работы пункта с WEB-DK и программой ПТО этого достаточно. Если нужна полная автоматизация (госпошлина, подпись, очередь карт без ручной работы на сайте ЕАИСТО) — смотрите раздел про EAISTO Client Agent ниже или напишите нам; старую программу EAISTO.connector больше не поддерживаем.
Частые вопросы
Как сейчас оформлять карты в ЕАИСТО вместе с WEB-DK?
Ведёте карту в своей учётной системе (WEB-DK или программа ПТО), устанавливаете EAISTO.helper, переносите данные в ЕАИСТО-М горячей клавишей, завершаете регистрацию на сайте ЕАИСТО — готовая карта (PDF, номер, срок) возвращается в учёт или кабинет WEB-DK.
Как установить EAISTO.helper вручную, если в магазине ещё старая версия?
Лучше ставить из Chrome Web Store — тогда расширение обновляется само. Если маркет долго публикует обновление, скачайте ZIP с сайта и установите вручную: режим разработчика → «Загрузить распакованное расширение» (подробные шаги — в разделе «Как установить» выше). Когда версия появится в магазине, перейдите на установку из маркета и удалите ручную копию.
Чем расширение отличается от локального агента?
EAISTO.helper — мост в браузере: вы переносите данные из учёта на сайт ЕАИСТО и возвращаете готовую карту обратно. EAISTO Client Agent — программа на компьютере для полной автоматизации без ручной работы на сайте ЕАИСТО: от передачи данных (в том числе о госпошлине и её проверке) до подписи и получения карты. Агент ещё готовим к запуску у клиентов; для текущей работы используйте helper. Старый Windows-коннектор ставить не нужно.
В каком браузере работать с ЕАИСТО?
Официально для ЕАИСТО часто рекомендуют Chromium (в том числе Chromium GOST). На практике сейчас хорошо заходит и Яндекс Браузер — многие эксперты оформляют карты в нём без проблем. EAISTO.helper ставится из Chrome Web Store и в Chrome, и в Яндекс Браузере.
Нужен ли отдельный вход в ЕАИСТО?
Да. Карты по-прежнему регистрируются в системе ЕАИСТО-М под вашим экспертом и сертификатом. WEB-DK и программа ПТО (например 1С:ПТО) хранят учёт пункта; фото делает приложение «Фото для техосмотра»; helper связывает это с сайтом ЕАИСТО.
Куда деваются фото с телефона?
Снимки с геометками делаете в приложении «Фото для техосмотра». На компьютер их можно передать по-разному: Google Диск, Яндекс.Диск, email, USB, Wi‑Fi/FTP, API — в этом и удобство приложения. WEB-DK.Sync — относительно новый способ для ситуаций, когда в регионе режут интернет (белые списки, отключения): фото уходят на ПК по локальной сети или через сервисы WEB-DK, без привычных облаков. Дальше снимки используются при оформлении карты в ЕАИСТО.
За что именно списываются деньги?
Не за установку расширения, а за отдельные шаги работы с ЕАИСТО через сервисы WEB-DK: отправка черновика карты, капча и похожие операции. Каждая операция — небольшая сумма с лицевого счёта; без работы по картам ничего не списывается.
EAISTO Client Agent — полная автоматизация
EAISTO Client Agent — программа на компьютере пункта для полной автоматизации работы с ЕАИСТО-М: от передачи данных карты (в том числе сведений о госпошлине и её проверки) до электронной подписи и получения готовой карты с PDF. Без ручного заполнения сайта ЕАИСТО. Подпись — через КриптоПро. На июль 2026 агент ещё не раздаём клиентам для повседневной работы — можно написать нам, когда будете готовы к подключению.
Два режима работы
- API-мост к ЕАИСТО. Любое стороннее приложение (1С, программа ПТО, своя разработка) обращается к локальному API агента на компьютере — агент общается с ЕАИСТО и возвращает результат. Ниже описаны методы этого режима (версия в доке: v0.2.32).
- Автоматическая обработка очереди. Агент сам забирает очередь карт из внешнего сервиса по API (например, из WEB-DK), последовательно передаёт их в ЕАИСТО и возвращает готовые карты обратно в сервис — без участия оператора на каждом шаге.
После установки укажите в агенте API-ключ из личного кабинета web-dk.ru и запустите сервис.
Адрес локального API по умолчанию: http://localhost:8080/api5/ecp1c/ (порт можно изменить).
В запросах передаётся параметр accesstoken — тот же ключ, что в кабинете.
Типовой порядок в режиме API-моста: captcha — картинка с капчей, send — черновик в ЕАИСТО и первое фото (старт таймера), send — второе фото, sign — подпись и PDF карты. Фото готовьте в «Фото для техосмотра» — на ПК любым удобным способом из приложения (облако, почта, локальная сеть; WEB-DK.Sync — если интернет ограничен).
Два варианта адреса: старый /api5/ecp1c/ (как в 1С) и новый /api/.
Пример: /api5/ecp1c/captcha и /api/captcha — одно и то же.
Методы локального API (режим моста)
0. Проверка состояния агента (без авторизации)
http://localhost:8080/api5/ecp1c/status
Возвращает JSON
- версия агента, статус сервиса, EAISTO, подписки и обновлений
- метод доступен без
accesstoken
1. Инициализация сессии и получение картинки с капчей
http://localhost:8080/api5/ecp1c/captcha?accesstoken=API_КЛЮЧ
Возвращает JSON
captcha— base64 картинки капчиEAISTO_SESSION— идентификатор сессии ЕАИСТОjwtToken— токен, который необходимо подписать и отправить в параметреsignметода send
2. Отправка черновика
http://localhost:8080/api5/ecp1c/send?EAISTO_SESSION=сессия_еаисто&captcha=код_каптчи&accesstoken=API_КЛЮЧ
Параметры
- json — обязательный, данные карты в виде json
- sign — обязательный, строка возвращаемая методом CAdESCOM.CadesSignedData.SignCades, в качестве подписываемых данных выступает jwtToken (Base64.Encode)
- image1 — обязательный, при начале диагностики, файл фото в начале осмотра в виде строки base64
- image2 — обязательный, при завершении диагностики, файл фото в конце осмотра в виде строки base64
- id — обязательный, идентификатор в ЕАИСТО, если новая карта, то 0
Параметр json
{
"operator": "номер оператора техосмотра по реестру",
"card": {
"BodyNumber": "номер кузова",
"RegistrationNumber": "рег знак",
"VehicleCategory2": "категория, например, M1",
"VehicleCategory": "категория, например, B",
"RegistrationDocument": {
"DocumentType": "тип документа: RegTalon - СТС, PTS - ПТС, EPTS - ЭПТС",
"Series": "серия документа",
"Number": "номер документы",
"Organization": "кем выдан документ",
"Date": "дата выдачи в формате, 2004-01-01",
"Foreign": "если иностранец, то Y, иначе N"
},
"Killometrage": "пробег",
"Fuel": "топливо: Petrol, Diesel, PressureGas, LiquefiedGas, None",
"BrakingSystem": "тормозная система: Hydraulic, Mechanical, Pneumatic, Combined",
"Vehicle": {
"Make": "марка",
"Model": "модель"
},
"Vin": "VIN номер",
"Year": "год выпуска",
"FrameNumber": "номер рамы",
"EmptyMass": "масса без нагрузки",
"MaxMass": "максимальная масса",
"Tyres": "модель шин",
"Tachograph": {
"Brand": "марка тахографа",
"Model": "модель тахографа",
"SerialNumber": "serийный номер тахографа"
},
"comment": "примечание",
"diagnosticType": "вид проверки: первичная или повторная",
"parentCardId": "идентификатор карты первичного осмотра в ЕАИСТО",
"gibddEmployeeCode": "код инспектора ГИБДД для автобусов",
"specialAppointment": "",
"diagnosticResults": [
{
"number": "номер пункта ДК, по которому установлена неисправность",
"failed": true,
"razdel": "порядковый номер раздела диагностической карты, от 0 до 6",
"predmet": "предмет проверки диагностической карты",
"bottom": "нижнее допустимое значение проверяемого параметра",
"top": "верхнее допустимое значение проверяемого параметра",
"result": "результат проверки параметра"
}
],
"gbo": {
"hasGasEquipment": true,
"gasEquipmentTestNumber": "1233333",
"gasEquipmentTestNextDate": "2021-05-03",
"noGasBottle": false,
"gasBottleSerialNumber": "1234",
"gasBottleTestDate": "2021-05-06",
"gasBottleTestNextDate": "2021-05-06",
"gasBottleYear": "2005"
}
}
}
Возвращает JSON
id— идентификатор созданной карты в ЕАИСТОdigest— хэш для подписания картыEAISTO_SESSION— идентификатор сессии ЕАИСТОdata— json с данными карты из ЕАИСТОts— timestamp из ЕАИСТО
3. Подписание карты и получение печатной формы и номера ЕАИСТО
http://localhost:8080/api5/ecp1c/sign?id=id_карты&EAISTO_SESSION=сессия_еаисто&ts=таймстамп&accesstoken=API_КЛЮЧ
Параметры
- id — обязательный, идентификатор карты в ЕАИСТО
- EAISTO_SESSION — обязательный, идентификатор сессии в ЕАИСТО
- ts — обязательный, временная метка из метода send
- sign — обязательный, подпись digest через CAdESCOM
Возвращает JSON
id— идентификатор созданной карты в ЕАИСТОvalidity— срок действия картыnumber— 15-ти значный номер в ЕАИСТОpdf— base64 PDF
4. Поиск диагностической карты в ЕАИСТО
http://localhost:8080/api5/ecp1c/search?accesstoken=API_КЛЮЧ&EAISTO_SESSION=сессия_еаисто
Параметры (тело запроса или query)
- cardNumber — номер диагностической карты (15 цифр)
- registrationMark — регистрационный номер
- vin — VIN
- bodyNumber — номер кузова
5. Получение карты или PDF по номеру / id
http://localhost:8080/api5/ecp1c/get-by-id?accesstoken=API_КЛЮЧ&EAISTO_SESSION=сессия_еаисто
Вспомогательные методы
1. Отправляет сообщение в WhatsApp на указанный номер
https://web-dk.ru/api4/wa/send?access-token=
Параметры
- phone — обязательный
- message — обязательный