Если вы работаете с юридическими лицами, то вам постоянно приходится заполнять реквизиты контрагентов. И скорей всего мечтаете о волшебной кнопочке, которая заполнит все за вас. В данной статье я расскажу как реализовать автоматическое заполнение реквизитов по ИНН или любым другим данным организации.
Есть замечательный сервис DaData.ru, который умеет не только исправлять контактные данные типа ФИО, адреса, телефона и т.п., удалять дубликаты, но и ищет реквизиты организаций и ИП.
Данный сервис предоставляет доступ к API и дает бесплатно до 10 тыс. запросов в день по API-ключу. Этим мы и воспользуемся, чтобы реализовать автоматическое заполнение реквизитов по ИНН.
Получение API-ключа на Dadata.ru
Для начала необходимо зарегистрироваться на сервисе DaData. После регистрации в личном кабинете можно увидеть ваш API-ключ, который будет использоваться для запросов к сервису. А еще вам будет бонус 10 рублей на счет за использование API.
Ну а теперь можем приступить к написанию скрипта для отправки запроса и обработки ответа. Напоминаю, что писать код мы будем на Javascript.
Javascript для получения и заполнение реквизитов по ИНН
Создаем форму, в которой будет происходить заполнение реквизитов:
<div class="well well-sm col-md-6"> <div class="view"> </div> <div class="view"><p>Пожалуйста, заполняйте поля как можно более подробней. Это поможет нам быстрее и точнее отреагировать на ваше сообщение.</p></div> <form action="/ method="POST"> <div class="form-group"> <label for="company">Название компании* (реквизиты заполнятся автоматически):</label> <input class="form-control" type="text" name="company" id="company" value="" placeholder="Введите название, адрес, ИНН или ОГРН" required /> </div> <div class="form-group"> <label for="inn">ИНН:</label> <input class="form-control" type="text" name="inn" id="inn" value="" placeholder="Например, 1111111111" readonly required /> </div> <div class="form-group"> <label for="kpp">КПП:</label> <input class="form-control" type="text" name="kpp" id="kpp" value="" placeholder="Например, 111111111" readonly /> </div> <div class="form-group"> <label for="ogrn">ОГРН:</label> <input class="form-control" type="text" name="ogrn" id="ogrn" value="" placeholder="Например, 1111111111111" readonly required /> </div> <div class="form-group"> <label for="address">Адрес:</label> <input class="form-control" type="text" name="address" id="address" value="" placeholder="Невский пр., 1" required /> </div> <div class="form-group"> <label for="tel">Телефон для связи*:</label> <input class="form-control" type="text" name="tel" id="tel" value="" placeholder="Например, +7 812 111 1111" required /> </div> <div class="form-group"> <label for="email">Ваш email*:</label> <input class="form-control" type="text" name="email" id="email" value="" placeholder="Например, [email protected]" required /> </div> <div class="form-group"> <label for="url">Сайт:</label> <input class="form-control" type="text" name="url" id="url" value="" placeholder="Например, pogrommist.ru" /> </div> <div class="form-group"> <label for="comment">Дополнительные сведения:</label> <textarea class="form-control" type="text" name="comment" id="comment" rows="4" /></textarea> </div> <div class="form-group"> <div class="g-recaptcha" data-sitekey="тут ключ для капчи"></div> </div> <div class="form-group"> <button type="submit" name="addevent" class="btn btn-default">Отправить</button> </div> </form> </div>
Выглядеть наша форма будет примерно так:
Также нам понадобятся дополнительные стили и библиотеки:
<link href="https://cdn.jsdelivr.net/jquery.suggestions/17.2/css/suggestions.css" type="text/css" rel="stylesheet" /> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script> <!--[if lt IE 10]> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery-ajaxtransport-xdomainrequest/1.0.1/jquery.xdomainrequest.min.js"></script> <![endif]--> <script type="text/javascript" src="https://cdn.jsdelivr.net/jquery.suggestions/17.2/js/jquery.suggestions.min.js"></script>
Теперь пишем код, который будет отправлять запросы по мере заполнения первой графы и обрабатывать ответы.
<script>
function join(arr) {
var separator = arguments.length > 1 ? arguments[1] : ", ";
return arr.filter(function(n){return n}).join(separator);
}
function typeDescription(type) {
var TYPES = {
'INDIVIDUAL': 'Индивидуальный предприниматель',
'LEGAL': 'Организация'
}
return TYPES[type];
}
function showSuggestion(suggestion) {
console.log(suggestion);
var data = suggestion.data;
if (!data)
return;
$("#type").text(
typeDescription(data.type) + " (" + data.type + ")"
);
if (data.name)
//$("#company").val(join([data.opf && data.opf.short || "", data.name.short || data.name.full], " "));
$("#inn").val(data.inn);
$("#kpp").val(data.kpp);
$("#ogrn").val(data.ogrn);
if (data.address)
$("#address").val(data.address.value);
}
$("#company").suggestions({
token: "Здесь должен быть ваш API-ключ",
type: "PARTY",
count: 5,
onSelect: showSuggestion
});
</script>
При заполнении первой графы будут предложены 5 подсказок, за это отвечает переменная «count». Максимально можно выводить до 20 подсказок. При выборе одной из них в нашем варианте будут заполняться поля «Название компании», «ИНН», «ОГРН» и «адрес».
Какие данные еще можно получить?
| Название | Описание |
|---|---|
| value | Наименование компании одной строкой (как показывается в списке подсказок) |
| unrestricted_value | Наименование компании одной строкой (полное) |
| data.address.value | Адрес одной строкой:
Стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
| data.address.unrestricted_value | Адрес одной строкой (полный, от региона) Стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
| data.address.data | Гранулярный адрес. Может отсутствовать |
| data.address.data.source | Адрес одной строкой как в ЕГРЮЛ |
| data.branch_count | Количество филиалов |
| data.branch_type | Тип подразделения
MAIN — головная организация BRANCH — филиал |
| data.inn | ИНН |
| data.kpp | КПП |
| data.ogrn | ОГРН |
| data.ogrn_date | Дата выдачи ОГРН |
| data.hid | Уникальный идентификатор в Дадате |
| data.management.name | ФИО руководителя |
| data.management.post | Должность руководителя |
| data.name.full_with_opf | Полное наименование с ОПФ |
| data.name.short_with_opf | Краткое наименование с ОПФ |
| data.name.latin | Наименование на латинице |
| data.name.full | Полное наименование |
| data.name.short | Краткое наименование |
| data.okpo | Код ОКПО (не заполняется) |
| data.okved | Код ОКВЭД |
| data.okved_type | Версия справочника ОКВЭД (2001 или 2014) |
| data.okveds | Коды ОКВЭД дополнительных видов деятельности (не заполняется) |
| data.opf.code | Код ОКОПФ |
| data.opf.full | Полное название ОПФ |
| data.opf.short | Краткое название ОПФ |
| data.opf.type | Не используется |
| data.state.actuality_date | Дата актуальности сведений |
| data.state.registration_date | Дата регистрации |
| data.state.liquidation_date | Дата ликвидации |
| data.state.status | Статус организации
ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована |
| data.type | Тип организации
LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель |
| data.capital | Уставной капитал, для организаций (не заполняется) |
| data.citizenship | Гражданство, для ИП (не заполняется) |
| data.authorities | Руководители, доверенные лица, управляющие организации (не заполняется) |
| data.documents | Документы (не заполняется) |
| data.licenses | Лицензии (не заполняется) |
| data.phones | Телефоны (не заполняется) |
| data.emails | Адреса эл. почты (не заполняется) |
| data.source | Не используется |
| data.qc | Не используется |
Данный сервис можно использовать для заполнения реквизитов контрагентов в 1С. Возможно в будущем я опишу как это реализовать в 1С:Бухгалтерия 3.0.
Автоматическое заполнение реквизитов организации прямо в вашей системе
Для демонстрации работы
введите ИНН любой организации
или
смотрите пример
Демодоступ закончился, смотрите примеры
реальных организаций или отправьте заявку
на полный доступ
Отправить заявку
Смотрите примеры реальных
организаций или отправьте заявку
на демо-доступ
Заполнение реквизитов по ИНН позволит экономить время каждый раз, когда вы создаете нового контрагента, например, в 1С или любой другой системе
Список
источников информации
Источники информации
Фокус берет данные из официальных источников: ФНС, Росстат, ФССП, ЕФРСБ, ЦБ, ТПП, Роспатент, Генпрокуратура, Арбитражные суды, Контур.Справочник, Лицензирующие органы, Федеральное казначейство.
API Фокуса отдает следующие сведения:
- ЕГРЮЛ и ЕГРИП
- Сообщения о банкротствах
- Исполнительные производства
- Арбитражные дела
- Бухгалтерская отчетность
- Государственные контракты (44, 223 ФЗ)
- Товарные знаки
- Лицензии
- Реестры особых адресов ФНС
- Дополнительные контакты из открытых источников
Аналитический отчет прямо в карточке контрагента
После выбора организации будет
доступен запрос и ответ к Фокус API
Вы всё ещё думаете? Просто попробуйте
Какие варианты заполнения реквизитов компаний и ИП встречаются в практике?
- Вручную, как у кого получится, лишь бы что было записано в карточке.
- Полуавтоматически по исторически сложившемуся стандарту и с помощью штатного ПО Битрикс24.CRM.
- В автоматическом режиме по стандарту ФНС и 1С с помощью специальных приложений.
В настоящее время в Интернете предоставлен широкий выбор баз данных, содержащих информацию о потенциальных клиентах на любой вкус. Как правило все базы данных содержат информации о ИНН, реже регионам и так далее. Часто клиенты задают вопрос как можно массово обновить и наполнить актуальными данными свою базу CRM если они обладают корректной информацией в основном только о ИНН?
Приложение «Быстрое заполнение реквизитов компаний и банка [INN.FIX4.ORG]» помогает Битрикс24 наполнять карточки данными компаний по названию компании или по ИНН как новых, так и уже находящихся в базе данных компаний. При использовании отпадает необходимость заполнять вручную поля реквизитов компании, что сокращает время заполнения карточки и исключает возникновение ошибки заполнения по причине человеческого фактора. Все поля заполняются в полном соответствии с требованиями официальной переписки и не требуют корректировки.
Что умеет приложение и для кого предназначено?
Помогает соблюдать стандарт ФНС России, 1С: Бухгалтерии
Единообразное написание названий компаний, правильное заполнение банковских реквизитов в бухгалтерских документах с соблюдением всех стандартных требований и регистрационных данных в реестре налогоплательщиков.
Может сохранять название компании без указания организационной формы в поле «Очищенное название»
Поле с названием компании без ОПФ может использоваться в оповещениях и уведомлениях, а так же при генерации документов по шаблонам.
Записывает точное наименование должности руководителя компании
Есть возможность использовать нестандартные названия должности руководителя организации, например, Президент, Председатель, Секретарь, церковные должности и использовать их при генерации документов по шаблонам.
Получает точный юридический адрес компании, сохраняет в реквизитах компании и карточке компании
Возможность зафиксировать обязательную по требованиям действующего законодательства информацию о наименовании района, магистрали, номере дома, корпуса, комнаты и офиса.
Позволяет склонять ФИО руководителя в родительном падеже
Возможность использования таких данных для подстановки в шаблоны документов.
Проверяет компании на дубликаты
Полученные результаты могут использоваться для дальнейшей обработки и автоматизации процесса, например передать обращение с дубликатом менеджеру, который уже работает с этим клиентом или закрыть все дубликаты и оставить только первый или последний.
Может загружать дополнительные сведения и данные по компаниям
При использовании платной версии сервиса daData можно дополнительно получать такие данные как: телефон, email, обороты, ОКВЭД, о численности персонала и т.д.
Приложение подойдет для всех компаний и отделов, желающих чтобы их менеджеры:
- Заполняли контактные данные любой компании в один клик по ИНН, единообразно с соблюдением всех стандартных требований и регистрационных данных в реестре налогоплательщиков;
- Заполняли реквизиты банка клиента в один клик по номеру БИК или названию банка в полном соответствии с учетными данными банковской карточки.
Почему штатного функционала Битрикс24 не достаточно?
НАПИСАНИЕ НАЗВАНИЯ КОМПАНИИ С УКАЗАНИЕМ СНАЧАЛА ОПФ ОБЕСЦЕНИВАЮТ РАБОТУ С ФИЛЬТРАМИ, БЫСТРЫМ ПОИСКОМ И УСЛОЖНЯЮТ СТРУКТУРУ ХРАНЕНИЯ ПАПОК.
Так как в начале идет ОПФ (организационно-правовая форма), то и сортировка осуществляется по ней же. Например, при автоматическом создании рабочих папок на облачном общем диске портала, компании располагаются не в алфавитном порядке по названию компании, а разбросаны, что неудобно.
ВСЕ ДАННЫЕ КОТОРЫЕ ПЕРЕНОСЯТСЯ В КАРТОЧКУ КОМПАНИИ ЗАПИСАНЫ ЗАГЛАВНЫМИ БУКВАМИ.
При автоматической генерации счетов, актов, договоров переменные данные написанные заглавными буквами бросаются в глаза, выбиваются из общепринятого делового стиля, вызывают неудобства, требуют муторной ручной корректировки в каждой карточке и вызывают раздражение пользователей.
ШАБЛОН НАПИСАНИЯ В БИТРИКС24.CRM (КРАТКАЯ ОПФ +НАЗВАНИЕ + ИНН) ОТЛИЧАЕТСЯ ОТ ПРИНЯТОГО СТАНДАРТА 1С.
В 1С обратный порядок — сначала пишется название компании, а в конце указывается ОПФ.В случае обмена данными это вызывает дополнительную путаницу и сложности.
ТРЕБУЕТСЯ ОБЯЗАТЕЛЬНОЕ ОБУЧЕНИЕ СОТРУДНИКОВ И КОНТРОЛЬ ЗА СОБЛЮДЕНИЕМ ИМИ РЕГЛАМЕНТА ПО НАПИСАНИЮ НАЗВАНИЙ.
Как правило, написание названий не регламентируется и зависит от фантазии сотрудников, администратора и разработчика портала.
НЕТ ВОЗМОЖНОСТИ ЗАПОЛНЯТЬ ДАННЫЕ БАНКОВСКИХ РЕКВИЗИТОВ ПО БАНК-КЛИЕНТУ
Каждое поле банковских реквизитов в карточке компании загружается вручную.Для заполнения реквизитов компании приходится совершать достаточно много действий. Это достаточно длительная процедура, требующая внимательности и зависящая от человеческого фактора.
ЮРИДИЧЕСКИЙ АДРЕС ДЛЯ КОМПАНИЙ И ИП НЕ ПОДКАЧИВАЕТСЯ.
Отсутствует обязательная по требованиям действующего законодательства информация о наименовании района, магистрали, номере дома, корпуса, комнаты и офиса.
Как работает приложение?
Менеджер открывает вкладку «компании» и если менеджер не знает ИНН компании которое он может записать вместо его названия, то вручную пишет условное название и сохраняет новую учетную запись-карточку.
Дальше менеджер открывает вкладку старта приложения «Автореквизиты» и в поисковой строке начинает набирать название компании. Система сама выведет список совпадений и предложит менеджеру выбрать нужную компанию из ограниченного списка. Если название компании уникальное, то в списке будет содержаться только одна запись.
Если при добавлении новой компании вместо названия сразу указывать ИНН компании, то произойдет автоматическое определение компании и загрузка данных без дальнейших усилий.
В таблице совпадений система отображает полное название юридического лица, ИНН и юридический адрес регистрации.
В результате все регистрационные данные заполняются в соответствующее поля карточки компании клиента. После завершения работы приложения не забудьте обновить ваш экран.
В случае с получением данных для индивидуального предпринимателя, согласно действующему Законодательству, не будут отображаться данные места жительства физического лица, которым по факту является ИП. Но в приложение есть возможность указать адрес с данными о подъездах, корпусах, строениях, квартирах и прописать его полностью в отдельном поле чтобы соответствовать данным по договору. Также дополнить деталями можно и фактический адрес.
Соответствующие юридическому адресу данные: город, улица, дом, строение, квартира, относящиеся к клиенту автоматически скачиваются приложением DaData из доступных источников ФМС России и так же остаются не заполненными.
Можно выставить опцию «Не перезаписывать пустые данные из DaData», чтобы при обновлении реквизитов из сервиса не затереть данные, которые добавили вручную.
Следующий шаг — это заполнение банковских реквизитов, необходимо указать два обязательных параметра:
- Номер расчетного счета (у компании клиента их может быть несколько, выбор остается за вами).
- БИК или название банка.
В результате после обновления экрана все разрешенные поля будут заполнены актуальной информацией.
При необходимости смена расчетного счета осуществляется непосредственно из приложения или в соответствующем разделе карточки клиента.
Приложение может создавать дополнительные поля карточки компании, которые можно использовать в документах, бизнес-процессах, письмах, sms, роботах и т.д
Стоимость приложения?
- Приложение входит в подписку Битрикс24.Маркет Плюс.
- Если у вас уже есть оформленная подписка, то приложение для вашего портала бесплатное и не требует дополнительной оплаты.
- Если у вас нет подписки — установите приложение на 2 недели абсолютно бесплатно.
- Приложение доступно на всех Российских тарифах облачных и коробочных версиях Битрикс24.
- Приложение использует сервис DaData.ru, у которого есть бесплатный тариф для работы, который подходит 99% компаниям.
Настройки приложения
После установки в левом главном меню будет доступна вкладка «Быстрое заполнение реквизитов компаний и банка». Также приложение можно найти через верхний глобальный поиск, начав набирать слово «быстрое».
После установки откроется форма, в которой нужно прописать API ключ сервиса DaData. Более 90% пользователей устраивает бесплатный тариф, позволяющий предоставлять данные по 10 000 запросов в день. Этого с запасом хватит для тестирования и небольших компаний, но в случае перехода на его платную версию, приложение позволяет получать дополнительный и расширенный пакет данных о клиенте.
Подробная инструкция о том где получить этот ключ и дальнейшие действия расположены в конце экрана приложения.
Далее потребуется сопоставить шаблоны для Организации и ИП.
Настройка и выбор дополнительных полей интуитивно проста и осуществляется по Вашему желанию.
Приложение работает не только с сущностью Компании, но и с сущностью Контакты. Для каждой можно задать свои настройки:
- Название вкладки — то как отображается ссылка на приложение в карточке Компании;
- Дополнительные поля — при активации данного поля, приложение устанавливает дополнительные поля в сущность компании: ИНН, название компании, ФИО, должность, полный адрес и так далее. Отличительной чертой таких полей является префикс [INN.FIX4.ORG] в названии поля. Деактивация опции — удаляет поля и данные в компаниях;
- Очищенное название компании — активация данной опции сохраняет в отдельно поле название компании без ОПФ;
- Использовать «Полное наименование организации» — если выбрано «Использовать», реквизит компании будет писаться ОПФ без сокращений;
- Включить переименование названия компании, как в ФНС — если опция включена, тогда название компании будет сохранено как в ФНС. Есть возможность с помощью шорт-тегов менять порядок и вид отображения;
- Создавать компанию из названия, если там ИНН — активация данной опции говорит приложению искать ИНН в названии компании для обновления реквизитов. Позволит быстро создавать компании из лидов используя только ИНН;
- Склонять должность руководителя в род. падеж — активация данной опции будет склонять должность руководителя и сохранять данные в отдельно поле в карточке компании;
- Дополнительные данные из DaData.ru — активация данной опции говорит приложению собирать данные с платной версии ключа DaData, плюс создаются новые поля;
- Сохранять детальные данные адреса для корректной работы ЭДО — данная опция создаст новые поля в карточке компании, для корректной работы EDO.FIX4.ORG. Поля: Индекс, Код региона, Город, Населенный пункт, Район, Улица, Квартира, Корпус, Дом;
- Поиск дубликатов компаний по ИНН — если включить опцию, мы будем показывать найденные дубликаты по ИНН, и не будем автоматически записывать реквизиты.
- Адаптация юр. адреса под обмен с 1С — важная опция, которая позволяет адаптировать юридический адрес под формат 1С. Детализирует улицы, дома, этажи т.д.
Настройки сущности «КОМПАНИЯ»
Настройки сущности «КОНТАКТ»
Разделение выполнено для удобства работы менеджеров и корректного обмена с 1С, так как эта система в большинстве версий приравнивает ИП к физическим лицам и не содержит отдельного шаблона для таких юр.лиц и хранит данные в контактах.
Не выходя из настроек приложения есть возможность создать новую компанию или контакт заполнив необходимые поля.
Больше деталей и новостей можно узнать на наших каналах:
- Телеграм: https://CRM4.org/t/
- RuTube : https://CRM4.org/r/
- Вконтакте: https://CRM4.org/v/
- Яндекс.Дзен: https://CRM4.org/d/
С уважением, Лаборатория автоматизации «LOG [IN] OFF»
Заполнить по ИНН
С помощью опции Заполнить по ИНН можно автоматически заполнять данные контрагентов по ИНН, а реквизиты банка по БИК.
- Опция является платной, см. тарифы «Выставить счет».
Дополнительные возможности с опцией «Заполнить по ИНН»
- Заполнять реквизиты по ИНН / ОГРН
- Заполнять данные по БИК
Заполнить по ИНН / ОГРН
Укажите только ИНН (или ОГРН / ОГРНИП) и нажмите «Заполнить по ИНН«, данные контрагента заполнятся автоматически.
Какие реквизиты заполнятся автоматически?
Для юридического лица:
- Полное наименование организации;
- Сокращенное наименование организации;
- ОГРН — основной государственный регистрационный номер;
- ИНН — идентификационный номер налогоплательщика;
- КПП — код причины постановки на учет в налоговых органах;
- Должность руководителя организации;
- ФИО руководителя организации;
- Адрес организации;
- Телефон;
- О компании (основной вид деятельности);
- ОКПО, ОКАТО, ОКТМО, ОКФС, ОКОПФ, ОКОГУ.
Для индивидуального предпринимателя:
- ФИО индивидуального предпринимателя;
- ОГРНИП — основной государственный регистрационный номер индивидуального предпринимателя;
- ИНН — идентификационный номер налогоплательщика;
- О компании (основной вид деятельности);
- ОКПО, ОКАТО, ОКТМО, ОКФС, ОКОПФ, ОКОГУ.
Телефон и коды статистики ОКПО, ОКАТО, ОКТМО, ОКФС, ОКОПФ, ОКОГУ отображаются не у всех контрагентов.
Заполнить по БИК
Укажите полностью или частично БИК банка. В выпадающем меню выберите необходимый банк и реквизиты заполнятся автоматически.
Реквизиты по БИК:
- БИК;
- Наименование банка;
- Город банка;
- Кор. счет.
Как подключить платные услуги?
Параметры
| наименование | описание | требование |
|---|---|---|
| id | id документа, предварительно можно получить из результатов метода search. По факту id должен быть ИНН | обязательно |
| bik | Банковский идентификационный код (БИК) | обязательно |
| rs | Рассчетный счет компании | опционально |
Пример:
Запрос:
https://zachestnyibiznesapi.ru/paid/data/requisites?id=7719418209&bik=044525555&api_key=YOUR_API_KEY
Метод имеет возможность поиска только по ИНН.
Ответ:
JSON (и только JSON)
{
"status":"200",
"message":"Запрос выполнен успешно",
"body":{
"Юридический адрес":"105187, г Москва, улица Кирпичная, дом 32 КОРПУС 24",
"Фактический адрес":"105187, г Москва, улица Кирпичная, дом 32 КОРПУС 24",
"ОГРН":"1157746608645",
"ИНН":"7719418209",
"КПП":"771901001",
"ОКПО":"18980223",
"ОКВЭД":"62.01",
"БИК":"044525555",
"Корреспондентский счет":"30101810400000000555",
"Наименование банка":"ПАО "ПРОМСВЯЗЬБАНК"",
"Руководитель":"Русанов Сергей Владимирович",
"Должность":"Генеральный Директор"
}
}