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

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 долго появляется обновление, а вам уже нужна свежая сборка.

Для ежедневной работы пункта с WEB-DK и программой ПТО этого достаточно. Если нужна полная автоматизация (госпошлина, подпись, очередь карт без ручной работы на сайте ЕАИСТО) — смотрите раздел про EAISTO Client Agent ниже или напишите нам; старую программу EAISTO.connector больше не поддерживаем.

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

EAISTO Client Agent — полная автоматизация

EAISTO Client Agent — программа на компьютере пункта для полной автоматизации работы с ЕАИСТО-М: от передачи данных карты (в том числе сведений о госпошлине и её проверки) до электронной подписи и получения готовой карты с PDF. Без ручного заполнения сайта ЕАИСТО. Подпись — через КриптоПро на ПК агента. Закрытый бета-тест: скачивание и доступ открываем по заявке — запросите доступ в личном кабинете.

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

1. API-мост к ЕАИСТО. Стороннее приложение (1С, программа ПТО, ЛК WEB-DK в браузере) вызывает локальный HTTP API агента — агент сам логинится в ЕАИСТО, решает капчу, подписывает и возвращает результат. Ниже — актуальный контракт этого режима.
2. Очередь WEB-DK (portal queue). Агент сам забирает готовые карты из https://web-dk.ru/api/v7/dk/, проводит P1 → интервал → P2 → подпись и возвращает номер/PDF в кабинет — без кликов оператора на каждом шаге.

После установки укажите в агенте API-ключ из личного кабинета web-dk.ru и запустите сервис. Базовый адрес локального API: http://127.0.0.1:8080/api/ (порт можно изменить). Авторизация — query-параметр access-token (тот же ключ, что в кабинете).

Рекомендуемый префикс — /api/. Для совместимости со старыми клиентами 1С агент также отвечает на /api5/ecp1c/; устаревший параметр accesstoken (без дефиса) может приниматься, но в новых интеграциях используйте только access-token. Версию агента смотрите в ответе GET /api/status — в доке номер сборки не фиксируем.

Типовой порядок (API-мост)

1. status — проверка, что агент запущен.
2. captcha с autoCaptcha=1 и certThumbprint — вход в ЕАИСТО и решение капчи внутри агента.
3. send (фаза P1) — черновик + image1 (старт интервала диагностики).
4. Ожидание минимального интервала между фото.
5. send (фаза P2) — image2 + id черновика ЕАИСТО.
6. sign — подпись через КриптоПро в агенте, номер карты и PDF.

Фото готовьте в «Фото для техосмотра» — на ПК любым удобным способом (облако, почта, локальная сеть; WEB-DK.Sync — если интернет ограничен). В ЛК WEB-DK тот же сценарий вызывается кнопками «Выгрузить в ЕАИСТО» / «Завершить в ЕАИСТО» на карте.

Общие query-параметры локального API

• access-token — API-ключ из кабинета (обязателен для captcha / send / sign).
• autoCaptcha=1 — агент сам решает капчу; клиенту не нужно показывать картинку и слать код вручную.
• certThumbprint — отпечаток сертификата эксперта (КриптоПро); агент выбирает нужный сертификат для подписи.
• iddk — опционально, id карты во внешней системе (в WEB-DK — id диагностической карты); помогает сопоставлять черновик.

Методы локального API (режим моста)

{
  "diagnosticStart": "2026-07-30T14:10:00",
  "diagnosticFinish": "2026-07-30T14:45:00",
  "toOperator": "краткое имя оператора",
  "expert": "Иванов Иван Иванович",
  "expertForConnector": "",
  "expertTelegramCode": "",
  "eaistoId": null,
  "ExtSystem": "WEBDK",
  "ExtSystemID": "12345",
  "card": {
    "VehicleCategory2": "M1",
    "VehicleCategory": "B",
    "Vin": "VIN",
    "RegistrationNumber": "А123ВС777",
    "Year": "2018",
    "Killometrage": "120000",
    "EmptyMass": "1200",
    "MaxMass": "1800",
    "Tyres": "модель шин",
    "Fuel": "Petrol",
    "BrakingSystem": "Hydraulic",
    "diagnosticType": "первичная",
    "comment": "",
    "transportTypeName": "Легковые автомобили",
    "Vehicle": { "Make": "марка", "Model": "модель" },
    "RegistrationDocument": {
      "DocumentType": "RegTalon",
      "Series": "серия",
      "Number": "номер",
      "Organization": "кем выдан",
      "Date": "2020-01-15",
      "Foreign": "N"
    },
    "Tachograph": { "Brand": "", "Model": "", "SerialNumber": "" },
    "gbo": {
      "hasGasEquipment": false,
      "noGasBottle": false,
      "gasBottles": []
    },
    "paymentInfo": {
      "paymentId": "УИН госпошлины",
      "paymentDate": "2026-07-30",
      "preferentialInn": "",
      "preferentialKpp": ""
    },
    "diagnosticResults": [
      {
        "number": "1",
        "failed": false,
        "result": "Соответствует"
      }
    ]
  }
}

Очередь WEB-DK (portal queue)

Базовый URL: https://web-dk.ru/api/v7/dk/. Auth: query access-token. Нужна ветка portal_queue (GET /api/v7/dk/access; не путать с connector_api / галкой Client Agent).

Типовой цикл агента:

1. GET orders?status=READY — FIFO-очередь готовых карт.
2. POST claim — захват карты (agentId, certThumbprint).
3. GET order с photoFormat=base64 — получить ptoPayload для локального /api/send.
4. Локально: captcha → send (P1) → ожидание интервала → send (P2) → sign.
5. POST status — промежуточные статусы (EAISTO_SEND_P1, WAITING_INTERVAL, …).
6. POST complete — номер, PDF, срок; либо POST release при ошибке.

Карта попадает в READY при заполненных эксперте, фото и УИН госпошлины. Payload для send — схема eaisto-connector-1.0 (тот же JSON, что в API-мосте выше). Полный контракт методов, ошибок и recovery — во внутренней спецификации для разработчиков агента; интеграторам 1С обычно достаточно локального API-моста.

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