Интеграция Импакт в 1С Бухгалтерия КОРП

Интеграция сервиса «Импакт» в 1С бухгалтерию

1. Что такое Импакт?

Импакт — сервис анализа криминальных рисков, проверки водителей, поставщиков и транспорта. Позволяет выявлять мошенничество на ранних этапах.

Сервис предоставляет:

• Многоуровневую верификацию водителя, ТС и компании;
• Коммерческую осмотрительность;

Доступная информация включает:

• участие в схемах налоговой оптимизации;
• задолженности по налогам;
• дробление бизнеса;
• скрытую аффилированность;
• использование технических компаний.

2. Зачем была нужна интеграция?

Сотрудники вводили данные дважды — в 1С и на сайте Импакт, что увеличивало нагрузку. Решение — автоматизировать проверку через API прямо в 1С.

3. Как должен был выглядеть процесс?

1. Заведение водителя.
2. Создание заявки.
3. Проверка в Импакт одной кнопкой.
4. Просмотр отчёта.
5. Принятие решения.

4. Проектирование решения

По API: сначала авторизация — получение токена. Потом — инициация проверки («билет»), который активирует все 13 проверок.

5. Разработка

Получение данных

Запросы отправлялись из 1С через HTTP-интерфейс. Пример:

Хранение данных

Выбран периодический Регистр сведений с измерением «Водитель». В ресурсы помещены результаты 13 проверок + дополнительные поля.

Интерфейс

На форму добавлены кнопки и поля: дата проверки, пользователь, корректность данных.

Обработка в фоне

Запросы вынесены в фоновый процесс, чтобы не зависал сеанс. Добавлен прогресс-бар.

Отчёты

Кнопка «Печать Импакт» открывает форму выбора отчётов. Из документа — данные по текущей заявке, из справочника — все проверки водителя.

Интеграция сервиса Импакт в 1С позволила сократить время сотрудников, исключить двойной ввод данных, снизить риски ошибок и повысить скорость принятия решений.

Описание API информационной системы ИМПАКТ

Перед запуском проверок необходимо пройти этап аутентификации, затем инициировать проверку, получив «билет». При получении билета с баланса списывается 1 кредит. Каждый билет позволяет выполнить каждый тип проверки (водитель, транспорт, компания и др.) один раз.

1. Аутентификация

1.1. Получение токена

Параметры:

Параметр	Тип	Описание
username	string	Имя пользователя ИМПАКТ
password	string	Пароль пользователя

Ответ:

{
  "access": "строка",
  "refresh": "строка"
}
  

Срок жизни токенов:

• access — 30 минут
• refresh — 14 дней

1.2. Обновление токена

Параметры:

Параметр	Тип	Описание
token	string	Refresh-токен

Ответ:

{
  "access": "строка",
  "refresh": "строка"
}
  

Авторизация в последующих запросах

Authorization: Bearer <access_token>
  

2. Проверки

2.1.1. Получение билета на выполнение проверок

Результат выполнения:

Код	Описание
200	OK — {"ticket": строка, "credits": остаток кредитов}
402	Лимит запросов исчерпан

Билет действителен 5 минут.
Каждый тип проверки можно выполнить один раз на билет.

2.1.2. Количество оставшихся проверок

Ответ:

{"credits": число}
  

2.2. Проверка участия в инцидентах утраты груза

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/risk

JSON-параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Номер билета
ogrn	string	Нет	ОГРН
inn	string	Нет	ИНН
externalId	string	Нет	Код АТИ
autoGos	string	Нет	Госномер тягача
autoVin	string	Нет	VIN тягача
trailerGos	string	Нет	Госномер прицепа
trailerVin	string	Нет	VIN прицепа

Ответ (JSON):

{
  "resultCode": 0,
  "resultMessage": "...",
  "list": [...]
}
  

Атрибуты записи БД КонтролРиск:

Поле	Описание
autoGos	Госномер автомобиля
autoVin	VIN автомобиля
trailerGos	Госномер прицепа
trailerVin	VIN прицепа
ogrn	Список ОГРН/ОГРНИП
externalId	Коды АТИ
judNum	Номер судебного решения
smiDate	Дата упоминания в СМИ

2.3. Проверка задолженности по ФССП

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/fssp

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Номер билета
lastName	string	Да	Фамилия
firstName	string	Да	Имя
midName	string	Да	Отчество
birthDate	string	Да	Дата рождения ДД.ММ.ГГГГ

Ответ:

{
  "resultCode": 0,
  "resultMessage": "...",
  "found": true/false,
  "data": [...]
}
  

Объект исполнительного документа включает:

Поле	Описание
debtor	Информация о должнике
executiveProcessings	Номер и дата исполнительного производства
executiveDocument	Реквизиты производства
date	Дата прекращения/окончания
reason	Причина
subject	Предмет исполнения
sum	Сумма задолженности
department	Отдел судебных приставов
executor	Пристав-исполнитель
region	Регион

2.4. Проверка страхового полиса ОСАГО

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/osago

JSON-параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Номер билета
licensePlate	string	Нет	Госномер
vin	string	Нет	VIN

Должно быть заполнено хотя бы одно: licensePlate или vin.

Ответ:

{
  "resultCode": 0,
  "resultMessage": "...",
  "policyList": [...]
}
  

Информация о полисе ОСАГО

Поле	Описание
companyName	Страховая компания
policySerial	Серия полиса
policyNumber	Номер полиса
vin	VIN автомобиля
policyIsRestrict	1 — ограниченный, 0 — без ограничений
regNumber	Госномер
bodyNumber	Номер кузова
mark	Марка
model	Модель
owner	Владелец ТС
insurantName	Страхователь
kbm	Коэффициент бонус-малус

2.4. Проверка водительского удостоверения (ГИБДД)

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/driver

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Номер билета
drivingLicenseNumber	string	Да	Номер ВУ
drivingLicenseDate	string	Да	Дата выдачи ДД.ММ.ГГГГ

Ответ:

{
  "resultCode": 0,
  "personBirthDate": "...",
  "drivingLicenseIssueDate": "...",
  "drivingLicenseExpiryDate": "...",
  "drivingLicenseCategory": "...",
  "wanted": "...",
  "decisionList": [...]
}
  

Решения о лишении ВУ

Поле	Описание
state	Статус
date	Дата вступления
period	Период
birthPlace	Место рождения

2.5. Комплексная проверка паспорта

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/passport_complex

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
lastName	string	Да	Фамилия
firstName	string	Да	Имя
midName	string	Да	Отчество
birthDate	string	Да	Дата рождения
passportNumber	string	Да	Серия + номер без пробелов
issueDate	string	Да	Дата выдачи

Ответ:

{
  "resultCode": 0,
  "score": 100,
  "description": "..."
}
  

Таблица результатов:

Значение	Описание
100	Паспорт действителен, связка ФИО+Дата+Номер подтверждена
80	Ошибка в ФИО или дате рождения, но паспорт действителен
50	Записи не найдены, но номер и дата выдачи корректны
0	Паспорт недействителен

2.6. Связка ФИО — телефон

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/phone

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
lastName	string	Да	Фамилия
firstName	string	Да	Имя
midName	string	Да	Отчество
birthDate	string	Нет	Дата рождения
phone	string	Да	Телефон
passportNumber	string	Да	Паспорт без пробелов

Ответ:

{
  "resultCode": 0,
  "operationResult": "success | fail",
  "operationMessage": "..."
}
  

2.7. Сверка фотографии водителя

Метод: multipart POST
URL: https://online.impact.ru.com/api/v1/impact/verification/check_face

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
file	file	Да	JPEG-фото

Ответ:

{
  "uploaded_face": "base64",
  "matches": [
    {
      "score": 0.97,
      "face": "base64"
    }
  ]
}
  

2.8. Поиск дел в судах общей юрисдикции

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/sud

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
lastName	string	Да	Фамилия
firstName	string	Да	Имя
midName	string	Нет	Отчество
passportNumber	string	Да	Паспорт без пробелов

Ответ:

{
  "resultCode": 0,
  "count": 2,
  "cases": [
    {
      "number": "...",
      "date": "...",
      "description": "...",
      "result": "...",
      "sides": [...],
      "url": "...",
      "courtName": "...",
      "category": "...",
      "article": "..."
    }
  ]
}
  

2.9. Определение кода АТИ по ИНН

Метод: GET
URL: https://online.impact.ru.com/api/v1/impact/verification/find_ati_su_id?inn=<ИНН>

Ответ при наличии:

{"ati_su_id": число}
  

Если не найдено:

{}
  

2.10. Участие физлица в эпизодах утери груза

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/participation

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
firstName	string	Да	Имя
midName	string	Да	Отчество
lastName	string	Да	Фамилия
passportNumber	string	Да	Паспорт без пробелов

Ответ:

{
  "found": true | false
}
  

2.11. Информация о компании

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/reputation

Параметры:

Параметр	Тип	Обяз.	Описание
ticket	string	Да	Билет
inn	string	Да	ИНН

Ответ:

{
  "TotalItems": 1,
  "Items": [
     {
       "Name": "...",
       "Inn": "...",
       "Ogrn": "...",
       "Founders": "...",
       "EmployeesCount": 50,
       "Phones": [...],
       "Sites": [...]
     }
  ]
}
  

2.12. Коммерческая осмотрительность в логистике

Метод: POST
URL: https://online.impact.ru.com/api/v1/impact/verification/prudence

Параметры: (должен быть указан один из трёх: inn, ogrn, externalId):

Параметр	Тип	Описание
inn	string	ИНН
ogrn	string	ОГРН
externalId	string/number	Код АТИ

Ответ:

{
  "data": [
    {
      "case_id": "...",
      "url": "...",
      "amount": 1200000,
      "description": "...",
      "plaintiff_inn": "...",
      "defendant_inn": "...",
      "customer_inns": [...]
    }
  ]
}
  

2.13. Оценка уровня риска по результатам проверок

Метод: GET
URL: https://online.impact.ru.com/api/v1/impact/verification/risk_level?ticket=<ticket>

Ответ:

level	Описание
-1	Недостаточно данных
1	Низкий риск
2	Средний риск — рекомендована дополнительная проверка
3	Высокий риск

3. HTTP-коды возврата

Код	Описание
403	Неверный логин/пароль; нет доступа к проверке
402	Закончились проверки
400	Bad request — неверные или неполные параметры
200	Успешное выполнение

Блок-схема решения

Кликните для увеличения: