ЕАИСТО интеграция и API ЕАИСТО-М

Как оформить карту в ЕАИСТО · программа ПТО · WEB-DK

Если вы ведёте учёт в программе для ПТО или в личном кабинете WEB-DK и оформляете диагностические карты в ЕАИСТО-М — обычно достаточно расширения EAISTO.helper в браузере. Оно переносит данные карты из вашей учётной системы в ЕАИСТО и возвращает готовую печатную форму обратно в программу ПТО или кабинет WEB-DK.

Установить из Chrome Web Store Скачать ZIP (ручная установка) Программа для ПТО Фото для техосмотра Связаться по Client Agent Рекомендуем установку из магазина — так работают автообновления. ZIP — запасной вариант, если маркет долго обновляется

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 (если маркет ещё не обновился)
  1. Скачайте архив EAISTO.helper с этого сайта.
  2. Распакуйте ZIP в любую постоянную папку на компьютере (не удаляйте её после установки).
  3. Откройте страницу расширений браузера:
    • Chrome / Chromium: адрес chrome://extensions
    • Яндекс Браузер: адрес browser://tune → «Дополнения» или меню → «Дополнения»
  4. Включите режим разработчика (переключатель вверху справа).
  5. Нажмите «Загрузить распакованное расширение» и укажите папку, в которой лежит файл manifest.json.
  6. Готово. Чтобы поставить более новую ручную сборку позже — снова скачайте 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 агент ещё не раздаём клиентам для повседневной работы — можно написать нам, когда будете готовы к подключению.

Два режима работы

  1. API-мост к ЕАИСТО. Любое стороннее приложение (1С, программа ПТО, своя разработка) обращается к локальному API агента на компьютере — агент общается с ЕАИСТО и возвращает результат. Ниже описаны методы этого режима (версия в доке: v0.2.32).
  2. Автоматическая обработка очереди. Агент сам забирает очередь карт из внешнего сервиса по 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. Проверка состояния агента (без авторизации)

GET http://localhost:8080/api5/ecp1c/status

Возвращает JSON

  • версия агента, статус сервиса, EAISTO, подписки и обновлений
  • метод доступен без accesstoken

1. Инициализация сессии и получение картинки с капчей

GET http://localhost:8080/api5/ecp1c/captcha?accesstoken=API_КЛЮЧ

Возвращает JSON

  • captcha — base64 картинки капчи
  • EAISTO_SESSION — идентификатор сессии ЕАИСТО
  • jwtToken — токен, который необходимо подписать и отправить в параметре sign метода send

2. Отправка черновика

POST 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. Подписание карты и получение печатной формы и номера ЕАИСТО

POST 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

5. Получение карты или PDF по номеру / id

POST http://localhost:8080/api5/ecp1c/get-by-id?accesstoken=API_КЛЮЧ&EAISTO_SESSION=сессия_еаисто

Вспомогательные методы

1. Отправляет сообщение в WhatsApp на указанный номер

POST https://web-dk.ru/api4/wa/send?access-token=

Параметры

  • phone — обязательный
  • message — обязательный
Продолжая использовать https://web-dk.ru, вы подтверждаете, что согласны с Политикой конфиденциальности, в том числе, с порядком использования cookie-файлов. OK