Агент5. Честный знак

Что это за приложение

Агент5. Проверка «Честный Знак» — приложение для Bitrix24, которое по ИНН компании проверяет, зарегистрирована ли она в государственной системе маркировки товаров «Честный Знак», и автоматически заполняет информацию о подключенных товарных группах прямо в карточке компании CRM.

Это полезно для продавцов, поставщиков и дистрибьюторов, которые работают с маркированными товарами и хотят быстро понять, с кем из клиентов можно вести оборот маркировки.

Ключевое преимущество: никаких токенов и УКЭП не нужно — приложение использует открытый реестр участников оборота маркировки.

Возможности

• Проверка в один клик. Прямо из карточки компании. Результат сохраняется в ее пользовательские поля.
  
• Главная страница со списком. Все компании с ИНН в одной таблице: фильтры, статусы, массовые действия.
  
• Массовая проверка. Фоновая очередь обрабатывает тысячи компаний: ~3 000 в час.
  
• Умный кэш. Результаты кэшируются на 30 дней — повторные проверки ИНН мгновенны.
  
• Гибкий источник ИНН. По умолчанию — реквизиты RQ_INN, опционально — любое пользовательское поле.
  
• Много порталов. Одна установка обслуживает любое число порталов Bitrix24 через локальные приложения или OAuth.
  

Как пользоваться

Главная страница приложения

Откройте приложение из левого меню Bitrix24 — там, где все установленные приложения.

1. Список всех компаний с ИНН.
В таблице — только те компании, у которых заполнен ИНН. Компании без ИНН скрыты — проверять их бесполезно.

2. Фильтры и поиск.
Вверху: поиск по названию, по ИНН, фильтр по статусу (Все / Проверенные / Непроверенные / В очереди).

3. Кнопка «Проверить».
Напротив каждой непроверенной компании. Проверка занимает 1–2 секунды, результат сразу записывается в карточку компании.

4. Массовые действия.
Отметьте галочками нужные строки (или «Выбрать все на странице») и нажмите «Проверить выбранные». Компании добавятся в фоновую очередь.

5. Ссылки на карточки.
Название и ИНН компании в таблице — кликабельные. Нажатие открывает карточку компании поверх приложения.

Проверка в карточке компании

Откройте карточку любой компании — сбоку появится вкладка «Честный Знак».

1. Перейдите на вкладку
Если ИНН у компании заполнен — кнопка «Проверить Честный Знак» активна.

2. Нажмите кнопку
Приложение отправит запрос в реестр Честного Знака по ИНН и через пару секунд покажет результат.

3. Посмотрите данные
Статус подключения (✓ Подключён / ✗ Не подключён), количество категорий, список категорий, дата проверки — все сохраняется в поля компании.

4. Обновите при необходимости
Кнопка «Обновить данные» заставит приложение заново запросить информацию (с игнорированием кэша).

Если ИНН не заполнен — вы увидите предупреждение. Заполните ИНН в реквизитах компании, и проверка станет доступна.

Массовая проверка

Когда компаний много — проверяйте их все сразу.

1. Три способа запустить:

• Из списка (до 50): выберите галочками компании → «Проверить выбранные». До 50 штук — проверка идет сразу, результат виден через несколько секунд.
• Из списка (51+): те же галочки, но компании отправляются в фоновую очередь. Можно закрыть вкладку, работа продолжится сама.
• Все сразу: кнопка «Проверить все непроверенные» — в очередь ставятся все компании с ИНН, которые еще ни разу не проверялись.

2. Прогресс-бар

Над списком появится индикатор: «Проверено X из Y · осталось ~Z часов». Обновляется каждые 5 секунд. Можно спокойно закрыть вкладку и зайти позже — прогресс продолжится.

3. Остановить в любой момент

Кнопка «Очистить очередь» рядом с прогресс-баром. Уже проверенные компании останутся с результатами — отменится только то, что еще не успело обработаться.

Скорость и лимиты

Параметр	Значение
Один батч (50 компаний)	Обработка ~1 минута
Скорость проверки	~50 компаний в минуту = 3 000 в час
За сутки непрерывной работы	До 72 000 компаний
Портал на ~100 000 компаний	Полный прогон ~35 часов
Портал на ~150 000 компаний	Полный прогон ~50 часов

Хорошая новость: все ИНН хранятся в общем кэше 30 дней. Если другой портал уже недавно проверял такой же ИНН — результат берется мгновенно. При повторных запусках (например, ежемесячных) работа идет в несколько раз быстрее — большинство ИНН попадают в кэш.

Права доступа: что видит проверка

Приложение работает с компаниями в пределах прав того сотрудника, кто его открывает. Если у вас настроено ограничение «пользователь видит только своих клиентов» — проверка коснется только их.

• Открыли приложение как Ирина → проверка идет только по компаниям, доступным Ирине.
  
• Тот же портал открывает Артем → он увидит свой список. Проверки друг друга не пересекаются.
  
• Массовая проверка в фоне работает с правами того, кто устанавливал приложение (обычно администратор портала).
  
• Если компания в принципе недоступна никому (например, удален ответственный) — она автоматически помечается ошибкой «Нет прав на компанию» без повторных попыток.
  

Статусы в очереди

Статус в строке	Что это значит
Не проверена	Компания еще ни разу не проверялась или результат устарел
В очереди	Компания поставлена в фоновую очередь — подождите, результат появится без действий
Проверена (Подключен)	Компания найдена в реестре Честного Знака — видны подключенные товарные группы
Проверена (Не подключен)	Компания зарегистрирована, но на маркировку еще не подключена

Что защищает от проблем

• Сбои интернета/серверов: если один запрос не прошел, он автоматически повторяется до 3 раз. Если и это не помогло — помечается ошибкой и не мешает другим.
  
• Дубликаты: если вы запустили проверку дважды — компании, которые уже в очереди или уже проверены, пропускаются.
  
• Закрытая вкладка: процесс живет в фоне на сервере. Даже если ноутбук выключить — при следующем открытии приложения прогресс-бар снова появится с актуальными числами.
  
• Отмена: «Очистить очередь» удаляет только то, что не успели обработать. Уже проверенные компании сохраняют результаты.