-
Оценка
-
Установок86
-
РазработчикАО Русская Промышленная Компания
Описание
О Приложении
- работа с реквизитами и полями сущностей Битрикс24 на основе данных сервиса HFLabs DaData Подсказки (Россия/Беларусь/Казахстан).
- встраиваемое приложение для карточек сущностей Компания и/или Контакт.
Список задач
- создание/редактирование/удаление произвольного количества РЕКВИЗИТОВ и их дочерних сущностей - АДРЕСОВ и БАНКОВ, в режиме одного окна.
- работа с филиальной сетью юридических лиц, имеющих один общий ИНН
- заполнение/редактирование ПОЛЕЙ сущностей КОМПАНИЯ и КОНТАКТ
- получение данных от сервиса как для нескольких полей стразу так и персонально для выбранного, конкретного, поля
Особенности решения
- все блоки РЕКВИЗИТА представлены типовыми панелями, имеют список базовых пресетов (шаблонов) Битрикс24 и вариантов на их основе
- пресеты и типы адресов приведены к общему виду, могут иметь персональные наименования (кроме адресов)
- пресеты ограничены типом сущности (компаниям - Организация/ИП, контактам - Физ. лицо)
- варианты могут быть созданы/изменены/удалены без ограничений, авто обновление информации карточкивключено по умолчанию (отключено в настоящий момент, Б24 изменил логику работы данной функции)
- состав полей варианта зависит от выбранного пресета из настроек приложения
- пресеты и маппинг полей настраиваются в приложении на момент инсталляции на портале, доступно обновление по текущей информации Битрикс24 по шаблонам реквизитов и полям (в том числе кастомным)
*количество данных возвращаемое сервисом HFLabs DaData Подсказки превосходит данные реквизитов Битрикс24, приложение использует минимальный набор, ориентируясь на бесплатный тариф сервиса
- в качестве бонуса:
- редактирование наименования карточки Компании на основе данных сервиса
- работа с выбранными полями сущности Компания и Контакт
- создание/обновление контактного лица на основе данных сервиса для юридического лица
*описание работы в справке приложения
Пример настройки
Системные требования
- Битрикс24 Облако/Коробка (используется JS Bitrix24)
- Права - CRM/Встраиваемые приложения
- Язык Русский
Внешние сервисы
- HFLabs DaData Подсказки (Организации, Адреса, Банки, ФИО, код подразделения(Паспорт) + некоторые дополнительные методы и структуры данных поставщика (предназначенные в основном для машинной обработки)
Квалификация пользователей
-установка токена - административные права
-управление встройками - административные права
-настройка маппинга - административные права
-использование - все
- работа с реквизитами и полями сущностей Битрикс24 на основе данных сервиса HFLabs DaData Подсказки (Россия/Беларусь/Казахстан).
- встраиваемое приложение для карточек сущностей Компания и/или Контакт.
Список задач
- создание/редактирование/удаление произвольного количества РЕКВИЗИТОВ и их дочерних сущностей - АДРЕСОВ и БАНКОВ, в режиме одного окна.
- работа с филиальной сетью юридических лиц, имеющих один общий ИНН
- заполнение/редактирование ПОЛЕЙ сущностей КОМПАНИЯ и КОНТАКТ
- получение данных от сервиса как для нескольких полей стразу так и персонально для выбранного, конкретного, поля
Особенности решения
- все блоки РЕКВИЗИТА представлены типовыми панелями, имеют список базовых пресетов (шаблонов) Битрикс24 и вариантов на их основе
- пресеты и типы адресов приведены к общему виду, могут иметь персональные наименования (кроме адресов)
- пресеты ограничены типом сущности (компаниям - Организация/ИП, контактам - Физ. лицо)
- варианты могут быть созданы/изменены/удалены без ограничений, авто обновление информации карточки
- состав полей варианта зависит от выбранного пресета из настроек приложения
- пресеты и маппинг полей настраиваются в приложении на момент инсталляции на портале, доступно обновление по текущей информации Битрикс24 по шаблонам реквизитов и полям (в том числе кастомным)
*количество данных возвращаемое сервисом HFLabs DaData Подсказки превосходит данные реквизитов Битрикс24, приложение использует минимальный набор, ориентируясь на бесплатный тариф сервиса
- в качестве бонуса:
- редактирование наименования карточки Компании на основе данных сервиса
- работа с выбранными полями сущности Компания и Контакт
- создание/обновление контактного лица на основе данных сервиса для юридического лица
*описание работы в справке приложения
Пример настройки
Системные требования
- Битрикс24 Облако/Коробка (используется JS Bitrix24)
- Права - CRM/Встраиваемые приложения
- Язык Русский
Внешние сервисы
- HFLabs DaData Подсказки (Организации, Адреса, Банки, ФИО, код подразделения(Паспорт) + некоторые дополнительные методы и структуры данных поставщика (предназначенные в основном для машинной обработки)
Квалификация пользователей
-установка токена - административные права
-управление встройками - административные права
-настройка маппинга - административные права
-использование - все
История версий
Версия 18
- Исправлены ошибки конструктора запроса и начальной инициализации шаблонов для Беларуси и Казахстана.
- Исправлена ошибка обновления Реквизита если ранее он уже был создан через Адрес (роботами или вручную) (для старого функционала) флаг реквизита сбрасываем на "ADDRESS_ONLY": "N"
- Исправлена ограничение загрузки контактных лиц Компании если их более 50ти
- Изменены обработчики сущностей Компания и Контакт в связи переводом их методов на модель данных Б24 - `ЭЛЕМЕНТ CRM` (тоже самое вид сбоку но информация представлена по другому и ее больше)
- Добавлена обработка поля FM типа crm_multifield сущности ЭЛЕМЕНТ CRM - содержащая все контактные данные в массивах одного поля... (ранее для контактов использовались поля PHONE, MAIL и т.д. - сущностей Компания и Контакт)
- Разрешен смешанный режим работы виджетов
*в настройках полей для общего виджета можно использовать персональные виджеты для отдельных полей из общего набора (приоритетом обладает общий виджет)
- Help переписан в формате markdown
- Исправлена ошибка обновления Реквизита если ранее он уже был создан через Адрес (роботами или вручную) (для старого функционала) флаг реквизита сбрасываем на "ADDRESS_ONLY": "N"
- Исправлена ограничение загрузки контактных лиц Компании если их более 50ти
- Изменены обработчики сущностей Компания и Контакт в связи переводом их методов на модель данных Б24 - `ЭЛЕМЕНТ CRM` (тоже самое вид сбоку но информация представлена по другому и ее больше)
- Добавлена обработка поля FM типа crm_multifield сущности ЭЛЕМЕНТ CRM - содержащая все контактные данные в массивах одного поля... (ранее для контактов использовались поля PHONE, MAIL и т.д. - сущностей Компания и Контакт)
- Разрешен смешанный режим работы виджетов
*в настройках полей для общего виджета можно использовать персональные виджеты для отдельных полей из общего набора (приоритетом обладает общий виджет)
- Help переписан в формате markdown
10.03.2026
Версия 17
- Заложена возможность работы с несколькими поставщиками данных (пока отключена, по умолчанию поставщик один - Dadata).
- В маппинг добавлена возможность выбора 'ВСЕХ' (на 90%) методов и типов запрашиваемых данных согласно OpenAPI схемам поставщика. (ранее из методов например для Dadatra - использовался только 'suggest')
- Добавлена возможность работы с полями сущности (*пока без контроля типа данных). Дополнение неоднозначное - но может пригодиться для полей Компаний и Контактов при синхронизации с расширенными данными от Dadata на максимальном тарифе
- Поставщиком исправлены ошибки виджета Dadata (актуальная версия v26.1.0)
(если хотите сделайте текущий бэкап настроек приложения 16й версии - но только в ознакомительных целях, для 17й нужно будет повторить все настройки вновь - изменена структура данных)
12.02.2026
Версия 16
изменения от поставщика данных
1. Транспорт сервиса DaData HFLabs переведен с jQuery-плагина (более не поддерживается) на JavaScript-виджет
2. В интерфейс настроек приложения выведены некоторые настройки виджета
ps
требуется переустановка приложения
Для текущих пользователей - перед переустановкой приложения (чтобы не восстанавливать ранее сделанные настройки вручную)
- сделайте бэкап конфигурации через прочее/бэкап в настройках приложения
- переустановите приложение и восстановите его настройки из бэкапа.
1. Транспорт сервиса DaData HFLabs переведен с jQuery-плагина (более не поддерживается) на JavaScript-виджет
2. В интерфейс настроек приложения выведены некоторые настройки виджета
ps
требуется переустановка приложения
Для текущих пользователей - перед переустановкой приложения (чтобы не восстанавливать ранее сделанные настройки вручную)
- сделайте бэкап конфигурации через прочее/бэкап в настройках приложения
- переустановите приложение и восстановите его настройки из бэкапа.
17.11.2025
Версия 15
в коде приложения отключена функция: - BX24.reloadWindow();
(*с недавнего времени ~01/09/2025, после сохранения информации в БД Б24 - страница (закладка) приложения закрывалась и происходило переключение на закладку Общие)
Для текущих пользователей - перед обновлением приложения (чтобы не восстанавливать ранее сделанные настройки вручную)
- сделайте бэкап конфигурации через прочее/бэкап ... в настройках приложения, обновите приложение и восстановите его настройки из бэкапа
(*с недавнего времени ~01/09/2025, после сохранения информации в БД Б24 - страница (закладка) приложения закрывалась и происходило переключение на закладку Общие)
Для текущих пользователей - перед обновлением приложения (чтобы не восстанавливать ранее сделанные настройки вручную)
- сделайте бэкап конфигурации через прочее/бэкап ... в настройках приложения, обновите приложение и восстановите его настройки из бэкапа
12.10.2025
Версия 14
1. Исправлена интерфейсная ошибка (дублирование значений выпадающих списков адресов) при восстановлении настроек из бэкапа.
*для пользователей версии v1.1.13
- перед обновлением приложения: -сделайте бэкап
- после переустановки приложения: -восстановитесь из него (предупреждение о изменении версии игнорируйте - структура данных не менялась)
*для пользователей версии v1.1.13
- перед обновлением приложения: -сделайте бэкап
- после переустановки приложения: -восстановитесь из него (предупреждение о изменении версии игнорируйте - структура данных не менялась)
07.10.2024
Версия 13
юбилейная 13я версия))
1. Дополнительно к России - добавлена возможность получать данные по юр. лицам для Беларуси и Казахстана
(нужна настройка/выбор/создание реквизита Б24 по шаблону в настройках CRM/Шаблоны реквизитов)
2. По умолчанию данные по адресам также настроены на международные справочники
4. При создании нового реквизита добавлена возможность одновременного создания выбранного типа(типов) адреса.
(например - Вы создаете юр. адрес с разбивкой по полям, и адрес доставки - куда передаете адрес одной строкой)
ps
в связи с изменением структуры данных (в данной версии) - требуется полная переустановка приложения (не обновление).
pps
если в текущей версии у вас уже сделано много настроек в маппинге - просто сделайте бэкап (но не загружайте его в новую версию), и вручную скопируйте требуемы параметры из файла бекапа (*.json) в настройки маппинга новой версии
1. Дополнительно к России - добавлена возможность получать данные по юр. лицам для Беларуси и Казахстана
(нужна настройка/выбор/создание реквизита Б24 по шаблону в настройках CRM/Шаблоны реквизитов)
2. По умолчанию данные по адресам также настроены на международные справочники
4. При создании нового реквизита добавлена возможность одновременного создания выбранного типа(типов) адреса.
(например - Вы создаете юр. адрес с разбивкой по полям, и адрес доставки - куда передаете адрес одной строкой)
ps
в связи с изменением структуры данных (в данной версии) - требуется полная переустановка приложения (не обновление).
pps
если в текущей версии у вас уже сделано много настроек в маппинге - просто сделайте бэкап (но не загружайте его в новую версию), и вручную скопируйте требуемы параметры из файла бекапа (*.json) в настройки маппинга новой версии
03.10.2024
Версия 12
1. В настройке приложения, для совместимости с коробочной версией - добавлена функция BX24.installFinish() при настройке мест встроек placement_bind.
2. Запрещено восстановление настроек приложения из бэкапа от 'другой' (по домену) БД Б24.
(разные БД Б24 могут иметь разные ID пресетов реквизитов)
3. В обработчике приложения, в случае обнаружения варианта реквизита из пресета с несуществующим ID - вариант удаляется из БД Б24.
(ситуация возможна при загрузке 'исправленных/чужих' бэкапов см п.п.2 и созданных на их основе вариантов реквизитов)
ps
пожалуйста, работайте с бэкапами аккуратно (используйте только свои (по домену)).
В основном бэкапы предназначены для первоначальной настройки различных вариантов маппинга и быстрой загрузки своей конфигурации при полной переустановке приложения.
pps
В связи с изменением структуры настроек в данной версии - требуется полная переустановка приложения (не обновление).
2. Запрещено восстановление настроек приложения из бэкапа от 'другой' (по домену) БД Б24.
(разные БД Б24 могут иметь разные ID пресетов реквизитов)
3. В обработчике приложения, в случае обнаружения варианта реквизита из пресета с несуществующим ID - вариант удаляется из БД Б24.
(ситуация возможна при загрузке 'исправленных/чужих' бэкапов см п.п.2 и созданных на их основе вариантов реквизитов)
ps
пожалуйста, работайте с бэкапами аккуратно (используйте только свои (по домену)).
В основном бэкапы предназначены для первоначальной настройки различных вариантов маппинга и быстрой загрузки своей конфигурации при полной переустановке приложения.
pps
В связи с изменением структуры настроек в данной версии - требуется полная переустановка приложения (не обновление).
25.09.2024
Версия 11
1. Добавлена совместимость с коробочной версией Б24 (по просьбе пользователя Никиты Зеленко)
*все JS вызовы BX24.callMethod заменены на BX24.callBatch + добавлен контроль типов результатов запросов
2. Добавлен функционал локального Бэкапа настроек приложения
*при сохранении настроек - файл сохраняется браузером в каталог по умолчанию (для отображения диалога сохранения - установите в настройках браузера соответствующий параметр)
*все JS вызовы BX24.callMethod заменены на BX24.callBatch + добавлен контроль типов результатов запросов
2. Добавлен функционал локального Бэкапа настроек приложения
*при сохранении настроек - файл сохраняется браузером в каталог по умолчанию (для отображения диалога сохранения - установите в настройках браузера соответствующий параметр)
23.09.2024
Версия 10
1. Компания разработчик АО РПК стала партнером DaData: - на страницы приложения добавлены реферальные ссылки на сервис.
11.06.2024
Версия 9
ТРЕБУЕТСЯ ПОЛНАЯ ПЕРЕУСТАНОВКА ПРИЛОЖЕНИЯ
1. В инсталляции приложения - поправлена адаптивная верстка
2. В приложении
- исправлены неточности при работе с контактным лицом организации по данным сервиса
- исправлен доступ к настройкам реквизита типа Адрес на адресной панели приложения.
*(ранее настройки использовались только от фактического адреса)
- добавлена обработка ошибок (сообщения) прав доступа
3. В целом для приложения - частично изменена структура данных под возможную локализацию (i18n)
*(сервис DaData возвращает данные по России, Беларуси, Казахстану)
1. В инсталляции приложения - поправлена адаптивная верстка
2. В приложении
- исправлены неточности при работе с контактным лицом организации по данным сервиса
- исправлен доступ к настройкам реквизита типа Адрес на адресной панели приложения.
*(ранее настройки использовались только от фактического адреса)
- добавлена обработка ошибок (сообщения) прав доступа
3. В целом для приложения - частично изменена структура данных под возможную локализацию (i18n)
*(сервис DaData возвращает данные по России, Беларуси, Казахстану)
04.06.2024
Версия 8
1. Изменена структура данных приложения.
2. Все настройки, маппинг полей, и т.д. вынесены из кода в настройку приложения.
3. Сняты ограничения на кастомные реквизиты и поля данных (подробности в справке)
ТРЕБУЕТСЯ ПОЛНАЯ ПЕРЕУСТАНОВКА ПРИЛОЖЕНИЯ
2. Все настройки, маппинг полей, и т.д. вынесены из кода в настройку приложения.
3. Сняты ограничения на кастомные реквизиты и поля данных (подробности в справке)
ТРЕБУЕТСЯ ПОЛНАЯ ПЕРЕУСТАНОВКА ПРИЛОЖЕНИЯ
31.05.2024
Версия 7
1. исправлена ошибка (спасибо пользователю Виталию Алентьеву)
- в некоторых случаях, для пользователей (не администраторов)(при использовании приложение с первых версий + обновления) не формировался список пресетов/вариантов адресов
*добавлена более строгая проверка типов данных в js script обработчика
2. в поле RQ_COMPANY_REG_DATE - возвращается дата регистрации компании, ранее дата выдачи ОГРН
3. в полях input добавлена проверка специальных символов html (некорректно отображалось короткое наименование компании)
4. для реквизита компаний добавлена возможность создания(ФИО+Должность)/обновления(ФИО) контактного лица контрагента Б24 по данным сервиса
*контактное лицо сервиса и Б24 проверяется на схожесть (градиент от красного(не похожи) до зеленого(совпадают))
5. введена проверка на некорректные настройки прокси сервера (если используется) в плане авторизации на Dadata и фиксации ошибки err_tunnel_connection_failed
ps
на текущий момент в приложении обрабатываются все поля реквизитов из базовой поставки Б24, обработка кастомных полей не предусмотрена, приложение является простым, временным сервисом по быстрому заполнению данных из альтернативного источника, в преддверии дальнейшего развития Б24.
pps
большая просьба пользователям при обновлении приложения - сбрасывать кеш Б24, в браузерной и десктопной версии, для администраторов и пользователей. Или полностью удалять и устанавливать приложение вновь что гарантированно избавит Вас от проблем с кешем JS.
- в некоторых случаях, для пользователей (не администраторов)(при использовании приложение с первых версий + обновления) не формировался список пресетов/вариантов адресов
*добавлена более строгая проверка типов данных в js script обработчика
2. в поле RQ_COMPANY_REG_DATE - возвращается дата регистрации компании, ранее дата выдачи ОГРН
3. в полях input добавлена проверка специальных символов html (некорректно отображалось короткое наименование компании)
4. для реквизита компаний добавлена возможность создания(ФИО+Должность)/обновления(ФИО) контактного лица контрагента Б24 по данным сервиса
*контактное лицо сервиса и Б24 проверяется на схожесть (градиент от красного(не похожи) до зеленого(совпадают))
5. введена проверка на некорректные настройки прокси сервера (если используется) в плане авторизации на Dadata и фиксации ошибки err_tunnel_connection_failed
ps
на текущий момент в приложении обрабатываются все поля реквизитов из базовой поставки Б24, обработка кастомных полей не предусмотрена, приложение является простым, временным сервисом по быстрому заполнению данных из альтернативного источника, в преддверии дальнейшего развития Б24.
pps
большая просьба пользователям при обновлении приложения - сбрасывать кеш Б24, в браузерной и десктопной версии, для администраторов и пользователей. Или полностью удалять и устанавливать приложение вновь что гарантированно избавит Вас от проблем с кешем JS.
06.05.2024
Версия 6
1. исправлена ошибка (спасибо пользователю Алексею Байкалову)
- выпадающий список панели Реквизита НЕ формировался - если в одном из пресетов портала Б24 (CRM/Настройки CRM/Шаблоны реквизитов) значение XML_ID == null.
- значение XML_ID конкретного пресета должно содержать подстроку с одним из указателей типа - COMPANY / INDIVIDUAL / PERSON
* в настоящий момент XML_ID заполнено только у шаблонов для России (в том числе на чистой поставке Б24)
* если Вы хотите использовать другие системные пресеты - необходимо через RestAPI установить строковое значение данного поля.
* заявка на доработку функционала подана в Б24
2. введено ограничение на отбор пресетов по стране - только Россия (COUNTRY_ID==1)
3. поправлены стили оформления
4. поправлено соответствие возвращаемых данных адреса (DaData) полям пресета Б24
- выпадающий список панели Реквизита НЕ формировался - если в одном из пресетов портала Б24 (CRM/Настройки CRM/Шаблоны реквизитов) значение XML_ID == null.
- значение XML_ID конкретного пресета должно содержать подстроку с одним из указателей типа - COMPANY / INDIVIDUAL / PERSON
* в настоящий момент XML_ID заполнено только у шаблонов для России (в том числе на чистой поставке Б24)
* если Вы хотите использовать другие системные пресеты - необходимо через RestAPI установить строковое значение данного поля.
* заявка на доработку функционала подана в Б24
2. введено ограничение на отбор пресетов по стране - только Россия (COUNTRY_ID==1)
3. поправлены стили оформления
4. поправлено соответствие возвращаемых данных адреса (DaData) полям пресета Б24
08.04.2024
Версия 5
1. Все подключаемые js библиотеки сохранены локально
2. Для пресета ИП добавлено поле ОГРНИП
3. При выборе адреса - доступно открытие Яндекс карт с точкой геолокации (если есть данные)
2. Для пресета ИП добавлено поле ОГРНИП
3. При выборе адреса - доступно открытие Яндекс карт с точкой геолокации (если есть данные)
05.04.2024
Версия 4
1. Описание приложения вынесено на страницу настроек
2. Запрещено редактирование варианта реквизита без выбора пресета
2. Запрещено редактирование варианта реквизита без выбора пресета
01.04.2024
Версия 3
1. Добавлено разграничение прав на настройку приложения
- токен и встройки - административные права
- время показа оповещений - пользовательские
2. Добавлена проверка прав на создание/обновление/удаление реквизитов
3. Расширено количество данных возвращаемых в запросе к DaData c 7 до 20ти.
- токен и встройки - административные права
- время показа оповещений - пользовательские
2. Добавлена проверка прав на создание/обновление/удаление реквизитов
3. Расширено количество данных возвращаемых в запросе к DaData c 7 до 20ти.
21.03.2024
Версия 2
1. В настройки приложения добавлена возможность выбирать длительность показа оповещений (всплывающих окон)
2. При создании нового реквизита Компании (юр. лицо) - автоматически создается юридический адрес - если были использованы подсказки, если информация добавлялась вручную - нет.
3. Исправлены мелкие ошибки.
2. При создании нового реквизита Компании (юр. лицо) - автоматически создается юридический адрес - если были использованы подсказки, если информация добавлялась вручную - нет.
3. Исправлены мелкие ошибки.
18.03.2024
Подписка
Поиск дубликатов сущностей Лид/Компания/Контакт по телефону/email с целью ‘визуальной ‘ оценки: - почему поступающий Лид привязывается не туда, - куда Вы ожидали (новый/повторный). Встраиваемое приложение для контекстного меню списков Лид/Компания/Контакт. *Приложение полезно на начальном этапе внедрения Б24, - позволяет сэкономить массу нервов и недопониманий между пользователями и интеграторами.
