Что это за приложение
Агент5.Проверка «Честный Знак» — приложение для Bitrix24, которое по ИНН компании проверяет, зарегистрирована ли она в государственной системе маркировки товаров «Честный Знак», и автоматически заполняет информацию о подключённых товарных группах прямо в карточке компании CRM.
Это полезно для продавцов, поставщиков и дистрибьюторов, которые работают с маркированными товарами и хотят быстро понять, с кем из клиентов можно вести оборот маркировки.
Возможности
Проверка в один клик
Прямо из карточки компании. Результат сохраняется в её пользовательские поля.
Главная страница со списком
Все компании с ИНН в одной таблице: фильтры, статусы, массовые действия.
Массовая проверка
Фоновая очередь обрабатывает тысячи компаний: ~3 000 в час, повторные проверки — мгновенно из общего кеша.
Умный кеш
Результаты кешируются на 30 дней — повторные проверки ИНН мгновенны.
Гибкий источник ИНН
По умолчанию — реквизиты RQ_INN, опционально — любое пользовательское поле.
Много порталов
Одна установка обслуживает любое число порталов Bitrix24 через локальные приложения или OAuth.
📘 Как пользоваться
Всё, что нужно знать пользователю CRM.
Главная страница приложения
Откройте приложение из левого меню Bitrix24 — там, где все установленные приложения.
Список всех компаний с ИНН
В таблице — только те компании, у которых заполнен ИНН. Компании без ИНН скрыты — проверять их бесполезно.
Фильтры и поиск
Вверху: поиск по названию, по ИНН, фильтр по статусу (Все / Проверенные / Не проверенные / В очереди).
Кнопка «Проверить»
Напротив каждой непроверенной компании. Проверка занимает 1–2 секунды, результат сразу записывается в карточку компании.
Массовые действия
Отметьте галочками нужные строки (или «Выбрать все на странице») и нажмите «Проверить выбранные». Компании добавятся в фоновую очередь.
Ссылки на карточки
Название и ИНН компании в таблице — кликабельные. Нажатие открывает карточку компании поверх приложения.
Проверка в карточке компании
Откройте карточку любой компании — сбоку появится вкладка «Честный Знак».
Перейдите на вкладку
Если ИНН у компании заполнен — кнопка «Проверить Честный Знак» активна.
Нажмите кнопку
Приложение отправит запрос в реестр Честного Знака по ИНН и через пару секунд покажет результат.
Посмотрите данные
Статус подключения (✓ Подключён / ✗ Не подключён), количество категорий, список категорий, дата проверки — всё сохраняется в поля компании.
Обновите при необходимости
Кнопка «Обновить данные» заставит приложение заново запросить информацию (с игнором кеша).
Массовая проверка
Когда компаний много — проверяйте их все сразу.
Три способа запустить
• Из списка (до 50): выберите галочками компании → «Проверить выбранные». До 50 штук — проверка идёт сразу, результат виден через несколько секунд.
• Из списка (51+): те же галочки, но компании отправляются в фоновую очередь. Можно закрыть вкладку, работа продолжится сама.
• Всё сразу: кнопка «Проверить все непроверенные» — в очередь ставятся все компании с ИНН, которые ещё ни разу не проверялись.
Прогресс-бар
Над списком появится индикатор: «Проверено X из Y · осталось ~Z часов». Обновляется каждые 5 секунд. Можно спокойно закрыть вкладку и зайти позже — прогресс продолжится.
Остановить в любой момент
Кнопка «Очистить очередь» рядом с прогресс-баром. Уже проверенные компании останутся с результатами — отменится только то, что ещё не успело обработаться.
⚙️ Как работают фоновые проверки
Раздел для тех, кто хочет понять почему массовая проверка идёт именно столько времени и что происходит «за кулисами».
Что происходит после нажатия «Проверить все непроверенные»
1. Подсчёт (моментально)
Приложение спрашивает у Bitrix24 сколько компаний с ИНН ещё не проверены — это число сразу попадает в прогресс-бар как «Y».
2. Сканирование
Фоновый процесс (cron) постепенно перебирает все такие компании со страниц Bitrix, для каждой находит ИНН в реквизитах и кладёт в очередь.
3. Проверка батчами
Из очереди берутся по 50 ИНН за раз. Одним запросом они отправляются в реестр «Честного Знака», затем поля каждой компании в Bitrix24 обновляются.
4. Автоматическая балансировка
Когда в очереди уже накопилось достаточно (1000+ pending), сканирование «ставится на паузу» и все ресурсы идут на проверку. Как только очередь сокращается — сканер снова включается. Так проверка не простаивает.
Скорость и лимиты
Главное узкое место — не наш сервис, а ограничения Bitrix24. Платформа разрешает приложениям не больше ~2 запросов в секунду. Поэтому:
| Параметр | Значение |
|---|---|
| Один батч (50 компаний) | обрабатывается ~1 минута |
| Скорость проверки | ~50 компаний в минуту = 3 000 в час |
| За сутки непрерывной работы | до 72 000 компаний |
| Портал на ~100 000 компаний | полный прогон ~35 часов |
| Портал на ~150 000 компаний | полный прогон ~50 часов |
Хорошая новость: все ИНН хранятся в общем кеше 30 дней. Если другой портал уже недавно проверял такой же ИНН — результат берётся мгновенно. При повторных запусках (например, ежемесячных) работа идёт в несколько раз быстрее — большинство ИНН попадают в кеш.
Права доступа: что видит проверка
Приложение работает с компаниями в пределах прав того сотрудника, кто его открывает. Если у вас настроено ограничение «пользователь видит только своих клиентов» — проверка коснётся только их.
- Открыли приложение как Ирина → проверка идёт только по компаниям, доступным Ирине.
- Тот же портал открывает Артём → он увидит свой список. Проверки друг друга не пересекаются.
- Массовая проверка в фоне работает с правами того, кто устанавливал приложение (обычно администратор портала).
- Если компания в принципе недоступна никому (например, удалён ответственный) — она автоматически помечается ошибкой «Нет прав на компанию» без повторных попыток.
Статусы в очереди
| Статус в строке | Что это значит |
|---|---|
| Не проверена | Компания ещё ни разу не проверялась или результат устарел |
| В очереди | Компания поставлена в фоновую очередь — подождите, результат появится без действий |
| Проверена (Подключён) | Компания найдена в реестре Честного Знака — видны подключённые товарные группы |
| Проверена (Не подключён) | Компания зарегистрирована, но на маркировку ещё не подключена |
Что защищает от проблем
- Сбои интернета/серверов: если один запрос не прошёл, он автоматически повторяется до 3 раз. Если и это не помогло — помечается ошибкой и не мешает другим.
- Дубликаты: если вы запустили проверку дважды — компании, которые уже в очереди или уже проверены, пропускаются.
- Закрытая вкладка: процесс живёт в фоне на сервере. Даже если ноутбук выключить — при следующем открытии приложения прогресс-бар снова появится с актуальными числами.
- Отмена: «Очистить очередь» удаляет только то, что не успели обработать. Уже проверенные компании сохраняют результаты.
❓ Частые вопросы
Нужен ли токен или УКЭП для работы?
Нет. Приложение использует открытый реестр Честного Знака, доступный без авторизации.
Что, если ИНН у компании хранится не в реквизитах?
Откройте главную страницу приложения, разверните блок «Настройки», выберите «Пользовательское поле компании» и укажите системное имя этого поля (например UF_CRM_1581073179105).
Можно использовать в бизнес-процессах?
Да. Поля UF_CRM_TS_* доступны в условиях и действиях БП. Пример: «Если UF_CRM_TS_HAS_TRUE_SIGN = Да — назначить отдел маркировки».
Как часто обновляется реестр Честного Знака?
Оперативно, обычно в тот же день при подключении новой товарной группы. Приложение кеширует результаты на 30 дней — если нужен свежий результат, нажмите «Обновить данные» в карточке компании.
Что делать, если Честный Знак показал «Не подключён», хотя компания подключена?
Нажмите «Обновить данные» в карточке компании — будет сделан свежий запрос в реестр в обход кеша. Если результат тот же — данные пока не появились в открытом реестре (обновляется с небольшой задержкой).
Долго ли идёт проверка 50 000 компаний?
Примерно ~17 часов непрерывной работы. Это ограничение Bitrix24 — платформа не позволяет обновлять больше ~50 записей в минуту. Приложение работает в фоне, можно закрыть вкладку и зайти позже.
Можно ли запустить проверку вечером, чтобы утром всё было готово?
Да, в этом и суть фоновой очереди. Нажмите «Проверить все непроверенные», закройте вкладку. Cron-процесс продолжает работу круглосуточно. Утром откройте приложение — прогресс-бар покажет сколько осталось, а проверенные компании уже будут с заполненными полями.
Что если я случайно запустил массовую проверку и хочу её отменить?
В блоке с прогресс-баром есть красная кнопка «Очистить очередь». Нажмите — она удалит всё, что ещё не успело обработаться. Уже проверенные компании останутся с результатами.
Можно ли запустить несколько проверок одновременно?
Одна массовая проверка на портал. Если одна уже идёт — система не даст запустить вторую (вы увидите сообщение «Массовая проверка уже запущена»). Но одиночные кнопки «Проверить» в строке и карточке работают параллельно без ограничений.
Почему часть компаний помечена ошибкой «Нет прав»?
Так настроена CRM: пользователь, установивший приложение, не имеет доступа к этим компаниям (например, они принадлежат другому отделу). Решение — либо изменить ответственных в Bitrix24, либо попросить администратора переустановить приложение под учётной записью с полным доступом. Эти записи не мешают проверке остальных компаний.
Как часто обновляется кеш?
Кеш результатов хранится 30 дней. При одиночной проверке («Обновить данные») можно обойти кеш — будет сделан свежий запрос в CRPT. При массовой проверке все ИНН младше 30 дней берутся из кеша мгновенно.
Остались вопросы?
Напишите нам — ответим в течение рабочего дня