Организация по ИНН или ОГРН. Dadata opencart
hflabs/suggestions-opencart - Libraries.io
Описание
Модуль выводит подсказки по ФИО и почтовому адресу, а также автоматически определяет почтовый индекс на странице регистрации и оформления заказа в OpenCart при помощи сервиса "Подсказки" [DaData.ru] (https://dadata.ru).
По отзывам интернет-магазинов, модуль значительно повышает качество получаемых от пользователей данных. Клиенты начинают указывать почтовые адреса для доставки, разбитые по КЛАДР, без опечаток и с квартирами, индекс определяется автоматически. ФИО вводят без опечаток и с полом.
OpenCart 1.5.6.x. OcStore 1.5.5.x.
Установка
1. Установите модуль
Прежде всего, скачайте дистрибутив, распакуйте его, и скопируйте файлы из каталога upload в корень opencart-магазина.
Для замены регионов России на корректные значения из КЛАДР выполните SQL-скрипт zone.sql над БД магазина через phpMyAdmin либо из консоли:
$ mysql opencart -u opencart -p < zone.sql
2. Включите подсказки в настройках
Модуль настраивается в админке по адресу: Дополнения > Модули > DaData.
API-ключ — необходимо получить в личном кабинете DaData.ru.
Количество возвращаемых подсказок — количество подсказок, которое демонстрируется пользователю.
Оставшиеся поля настройки (автоматическое исправление по мере ввода, показывать дополнительные поля адреса, показывать пол) управляют поведением подсказок. Вы можете включить их по необходимости.
Статус – показывает статус работы модуля: «включено» – подсказки работают, «отключено» – подсказки не работают.
Версия подсказок — какой сервис использовать при работе (подробнее см. [Версии подсказок] (https://dadata.ru/suggestions/#pricing)).
После заполнения всех полей необходимо сохранить настройки.
Настройки для работы с модулем simple checkout
Для корректного выбора региона - установите Российскую федерацию в качестве страны по умолчанию в настройках модуля Simple Checkout > Поля > country_id > Значение по умолчанию
libraries.io
Организация по ИНН
Что умеет
Находит компанию или ИП по ИНН или ОГРН. Возвращает все доступные сведения о компании, в отличие от метода suggest, который возвращает только базовые поля.
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и получите ключ
URL:
https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/partyПример запроса:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "7719402047" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/partyИли:
curl -X POST \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -d '{ "query": "1157746078984" }' \ https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/partyЕсли у компании есть филиалы, запрос вернёт несколько объектов. Если нужна только головная организация, укажите дополнительный параметр branch_type:
{ "query": "7707083893", "branch_type": "MAIN" }Однозначно найти конкретный филиал с помощью этого метода не получится, так как у филиалов нет уникальных идентификаторов.
Чтобы искать только среди юрлиц, либо только среди индивидуальных предпринимателей, укажите параметр type:
# Юрлица { "query": "7719402047", "type": "LEGAL" } # Индивидуальные предприниматели { "query": "784806113663", "type": "INDIVIDUAL" }Пример ответа
{ "suggestions": [ { "value": "ПАО СБЕРБАНК", "unrestricted_value": "ПАО СБЕРБАНК", "data": { "kpp": "773601001", "capital": { "type": "УСТАВНЫЙ КАПИТАЛ", "value": 67760844000 }, "management": { "name": "Греф Герман Оскарович", "post": "Президент, председатель правления" }, "founders": [ { "ogrn": null, "inn": "7702235133", "name": "ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ", "hid": "33b78a80c782d847d02a7e7a53d3aa17a5dff9a1cb5ec73d0311423dcc065a89", "type": "LEGAL", "share": null } ], "managers": [ { "inn": "770303580308", "fio": { "surname": "Греф", "name": "Герман", "patronymic": "Оскарович", "gender": "MALE", "source": "ГРЕФ ГЕРМАН ОСКАРОВИЧ", "qc": null }, "post": "Президент, председатель правления", "hid": "8aca73ef155e20b8ba6687d23521630e8fbe9b505b388cb9cb12eb1c43b68253", "type": "EMPLOYEE" } ], "branch_type": "MAIN", "branch_count": 93, "source": null, "qc": null, "hid": "145a83ab38c9ad95889a7b894ce57a97cf6f6d5f42932a71331ff18606edecc6", "type": "LEGAL", "state": { "status": "ACTIVE", "actuality_date": 1521590400000, "registration_date": 677376000000, "liquidation_date": null }, "opf": { "type": "2014", "code": "12247", "full": "Публичное акционерное общество", "short": "ПАО" }, "name": { "full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"СБЕРБАНК РОССИИ\"", "short_with_opf": "ПАО СБЕРБАНК", "latin": null, "full": "СБЕРБАНК РОССИИ", "short": "СБЕРБАНК" }, "inn": "7707083893", "ogrn": "1027700132195", "okpo": null, "okved": "64.19", "okveds": [ { "main": true, "type": "2014", "code": "64.19", "name": "Денежное посредничество прочее" } ], "authorities": { "fts_registration": { "type": "FEDERAL_TAX_SERVICE", "code": "7700", "name": "Управление Федеральной налоговой службы по г.Москве", "address": "125284, г.Москва, Хорошевское ш., 12А" }, "fts_report": { "type": "FEDERAL_TAX_SERVICE", "code": "7736", "name": "Инспекция Федеральной налоговой службы № 36 по г.Москве", "address": null }, "pf": { "type": "PENSION_FUND", "code": "087705", "name": "Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы", "address": null }, "sif": { "type": "SOCIAL_INSURANCE_FUND", "code": "7706", "name": "Филиал №6 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации", "address": null } }, "documents": { "fts_registration": { "type": "FTS_REGISTRATION", "series": "77", "number": "4856976", "issue_date": 1029456000000, "issue_authority": "7700" }, "pf_registration": { "type": "PF_REGISTRATION", "series": null, "number": "087705007215", "issue_date": 1283472000000, "issue_authority": "087705" }, "sif_registration": { "type": "SIF_REGISTRATION", "series": null, "number": "770600307277061", "issue_date": 978566400000, "issue_authority": "7706" } }, "licenses": [ { "series": null, "number": "045-02894-100000", "issue_date": 975283200000, "issue_authority": "Центральный банк Российской Федерации", "suspend_date": null, "suspend_authority": null, "valid_from": 1444089600000, "valid_to": null, "activities": [ "Брокерская деятельность" ], "addresses": [ "Г. МОСКВА" ] }, ... ], "address": { "value": "г Москва, ул Вавилова, д 19", "unrestricted_value": "г Москва, Академический р-н, ул Вавилова, д 19", "data": { ... } }, "phones": null, "emails": null, "ogrn_date": 1029456000000, "okved_type": "2014" } }, ... ] }
Поля в ответе
| Базовые поля, заполняются для всех тарифов | |
| value | Наименование компании одной строкой (как показывается в списке подсказок) |
| unrestricted_value | Наименование компании одной строкой (полное) |
| data.address | Адрес |
| └ value | — адрес одной строкой:
|
| └ unrestricted_value | — адрес одной строкой (полный, от региона)стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
| └ data | — гранулярный адрес. Может отсутствовать |
| └ data.source | — адрес одной строкой как в ЕГРЮЛ |
| data.branch_count | Количество филиалов |
| data.branch_type | Тип подразделения MAIN — головная организация BRANCH — филиал |
| data.inn | ИНН |
| data.kpp | КПП |
| data.ogrn | ОГРН |
| data.ogrn_date | Дата выдачи ОГРН |
| data.hid | Уникальный идентификатор в Дадате |
| data.management | Руководитель |
| └ name | — ФИО руководителя |
| └ post | — должность руководителя |
| data.name | Наименование |
| └ full_with_opf | — полное наименование с ОПФ |
| └ short_with_opf | — краткое наименование с ОПФ |
| └ latin | — наименование на латинице (не заполняется) |
| └ full | — полное наименование |
| └ short | — краткое наименование |
| data.okpo | Код ОКПО (не заполняется) |
| data.okved | Код ОКВЭД |
| data.okved_type | Версия справочника ОКВЭД (2001 или 2014) |
| data.opf | Организационно-правовая форма |
| └ code | — код ОКОПФ |
| └ full | — полное название ОПФ |
| └ short | — краткое название ОПФ |
| └ type | — версия справочника ОКВЭД (2001 или 2014) |
| data.state | Состояние |
| └ actuality_date | — дата актуальности сведений |
| └ registration_date | — дата регистрации |
| └ liquidation_date | — дата ликвидации |
| └ status | — статус организации ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией |
| data.type | Тип организации LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель |
| Дополнительные поля, заполняются в зависимости от тарифаЗаполняются при выборе конкретной подсказки. До этого они пустые. | |
| Тарифы «Расширенный» и «Всё включено» | |
| data.okveds[ ] | Коды ОКВЭД дополнительных видов деятельности |
| └ main | — основной или нет (true / false) |
| └ type | — версия справочника ОКВЭД (2001 или 2014) |
| └ code | — код по справочнику |
| └ name | — наименование по справочнику |
| data.authorities | Сведения о налоговой, ПФР и ФСС |
| data.authorities.fts_registration | ИФНС регистрации |
| └ type | — код гос. органа |
| └ code | — код отделения |
| └ name | — наименование отделения |
| └ address | — адрес отделения одной строкой |
| data.authorities.fts_report | ИФНС отчётности,структура аналогична fts_registration |
| data.authorities.pf | Отделение Пенсионного фонда,структура аналогична fts_registration |
| data.authorities.sif | Отделение Фонда соц. страхования,структура аналогична fts_registration |
| data.citizenship | Гражданство ИП |
| └ code.numeric | — числовой код страны по ОКСМ |
| └ code.alpha_3 | — трехбуквенный код страны по ОКСМ |
| └ name.full | — полное наименование страны |
| └ name.short | — краткое наименование страны |
| «Всё включено» | |
| data.founders[ ] | Учредители компании |
| └ ogrn | — ОГРН учредителя (для юрлиц) |
| └ inn | — ИНН учредителя |
| └ name | — наименование учредителя (для юрлиц) |
| └ fio | — ФИО учредителя (для физлиц) |
| └ hid | — внутренний идентификатор |
| └ type | — тип учредителя (LEGAL / PHYSICAL) |
| data.managers[ ] | Руководители компании |
| └ ogrn | — ОГРН руководителя (для юрлиц) |
| └ inn | — ИНН руководителя |
| └ name | — наименование руководителя (для юрлиц) |
| └ fio | — ФИО руководителя (для физлиц) |
| └ post | — должность руководителя (для физлиц) |
| └ hid | — внутренний идентификатор |
| └ type | — тип руководителя EMPLOYEE — сотрудник FOREIGNER — иностранный гражданин LEGAL — юрлицо |
| data.capital | Уставной капитал компании |
| └ type | — тип капитала |
| └ value | — размер капитала |
| data.documents | Документы |
| data.documents.fts_registration | Свидетельство о регистрации в налоговой |
| └ type | — тип документа (= FTS_REGISTRATION) |
| └ series | — серия документа |
| └ number | — номер документа |
| └ issue_date | — дата выдачи |
| └ issue_authority | — код подразделения |
| data.documents.pf_registration | Свидетельство о регистрации в Пенсионном фонде,структура аналогична fts_registration |
| data.documents.sif_registration | Свидетельство о регистрации в Фонде соц. страхования,структура аналогична fts_registration |
| data.licenses[ ] | Лицензии |
| └ series | — серия документа |
| └ number | — номер документа |
| └ issue_date | — дата выдачи |
| └ issue_authority | — название выдавшего органа |
| └ suspend_date | — дата приостановки |
| └ suspend_authority | — название приостановившего органа |
| └ valid_from | — дата начала действия |
| └ valid_to | — дата окончания действия |
| └ activities[ ] | — перечень лицензируемых видов деятельности |
| └ addresses[ ] | — перечень адресов, по которым действует лицензия |
| Не используются | |
| data.founders[ ].share | |
| data.phones[ ] | |
| data.emails[ ] | |
| data.source | |
| data.qc | |
Стоимость
Метод бесплатный до 10 тысяч запросов в день. Больше — в составе годовой подписки на Подсказки.
dadata.ru
Как подключить подсказки
Как сделать всякое
Как сделать гранулярные подсказки по адресу? Чтобы отдельно город, улица, дом?
Как разложить адрес по полям? Индекс, регион, город, улица, дом, квартира?
Как подсказывать только внутри конкретного города или области?
Как заставить подсказки учитывать местонахождение пользователя?
Подсказки делают это «из коробки»: определяют город пользователя по IP-адресу и подсказывают ближайшие варианты.
Как отключить геолокацию?
Как подсказывать только город?
Почему не так, как ожидалось
Почему индекс неправильный — не такой, как у Почты России?
Если получили от Дадаты неправильный индекс — отправьте адрес через специальную форму. Мы исправляем ошибки ежемесячно.
Дадата работает по объединенному справочнику налоговой службы (ФИАС) и Почты России. В нем исправлены более 7 000 некорректных и отсутствующих индексов.
К сожалению, справочник индексов Почты детализирован только до населенных пунктов. Привязки к улицам и домам нет. Поэтому все-все индексы исправить не удалось, однако исправляем их по обращениям. Позаботимся и о вашем случае.
Почему подсказки не возвращают геокоординаты и район города?
Подсказки возвращают геокоординаты и район после того, как человек выбрал конкретный адрес из списка.
В API это запрос с параметром count = 1.
Почему подсказки не возвращают площадь квартиры, ближайшее метро и часовой пояс?
Эти поля возвращаются только для тарифа «Всё включено».
Причём после того, как человек выбрал конкретный адрес из списка. В API это запрос с параметром count = 1.
Почему подсказки не возвращают коды качества?
Подсказки в принципе не возвращают коды качества, потому что не занимаются разбором адресов. Для этого есть стандартизация.
Почему на картах дом есть, а в подсказках — нет?
Подсказки используют справочник адресов налоговой службы (ФИАС). В нем нет некоторых реально существующих домов и строений. К сожалению, более полной базы, чем ФИАС, просто не существует.
Почему вернулся неправильный КЛАДР-код дома?
Подсказки работают по справочнику адресов налоговой службы (ФИАС).В ФИАС нет кодов КЛАДР для домов.
Поэтому код дома (последние четыре цифры в коде КЛАДР) подсказки берут из поля «Счетчик записей домов для КЛАДР 4» (COUNTER). Эти коды часто отличаются от указанных в КЛАДРе.
Впрочем, в самом КЛАДРе с каждым обновлением базы коды домов меняются, поэтому использовать их в качестве «постоянного» идентификатора адреса невозможно.
Мы рекомендуем для идентификации адреса использовать код ФИАС до улицы + дом + квартиру.
Подробности в статье на Хабре
Подсказки не работают: ошибка 403 Forbidden
Скорее всего, вы не подтвердили адрес эл. почты. Проверьте почтовый ящик и папку «спам» — там должно быть письмо от Дадаты. Пройдите по ссылке в письме, и вы в игре.
Прочее
Что будет, если превысить 10 000 бесплатных запросов в день?
Подсказки перестанут подсказывать :–) До начала нового дня, затем снова заработают.
10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки и емейлы.
Как защитить API-ключ от злоумышленников?
Если вы используете jQuery-плагин Подсказок, то API-ключ виден в исходном коде страниц вашего сайта. Чтобы злоумышленник не мог воспользоваться вашим ключом, можно привязать его к конкретному домену.
Например, если вы владелец интернет-магазина myshop.ru, то привязка ключа к этому домену запретит пользоваться им на всех остальных сайтах.
Если хотите включить привязку API-ключа к своему домену, напишите приватное сообщение в службу поддержки.
Есть ли подсказки по адресам Украины, Белоруссии и Казахстана?
Пока нет. Возможно, в будущем появятся, но сроков пока нет.
Как часто обновляется справочник адресов (ФИАС)?
В течение двух дней после выхода обновления в налоговой. При условии, что в налоговой ничего не разломали (это случается).
dadata.ru
