API.Картотека
8 (800) 100-85-50
Звонок по России бесплатный!
Внимание!
Сообщаем Вам о прекращении поддержки API версии 1.0. Версия API 2.0 с 01.01.2016 более не обновляется и в будущем её поддержка может быть прекращена после соответствующего уведомления, рекомендуем пользоваться новой версией API 3.0.

Метод getCardInfo

Краткое описание

Метод получения основной информации об организации, индивидуальном предпринимателе, физическом лице, иностранной организации.
Входные параметры:

  • идентификатор сессии (передается в заголовке SOAP- запроса),
  • идентификатор карточки (передается в теле SOAP- запроса).
Выходные параметры:

  • основная информация.
Данный метод доступен для следующих типов карточек:

  • карточка организации,
  • карточка физического лица,
  • карточка индивидуального предпринимателя,
  • карточка иностранной организации.

Шаблон SOAP-запроса

POST /search/v1/soap/ HTTP/1.1
Content-Type: text/xml;charset=UTF-8
SOAPAction: "Card#getCardInfo"
Content-Length: 293
Host: api.kartoteka.ru

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://api.kartoteka.ru/search/v1/">
    <soapenv:Header>
       <sessionId><!--идентификатор сессии--></sessionId>
    </soapenv:Header>
    <soapenv:Body>
       <v1:getCardInfo>
          <hash><!--идентификатор карточки--></hash>
        </v1:getCardInfo>
    </soapenv:Body>
 </soapenv:Envelope> 
  

Шаблон SOAP-ответа

 
  <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
       <SOAP-ENV:getCardInfoResponse>
          <info>
             <!-- основная информации об организаций/ИП/ФЛ -->
          </info>
       </SOAP-ENV:getCardInfoResponse>
    </SOAP-ENV:Body>
 </SOAP-ENV:Envelope> 
 

Входные параметры

Идентификатор сессии

Для выполнения метода необходимо получить идентификатор сессии с помощью метода login и поместить его в заголовок SOAP-запроса в элемент sessionId.
Состав и структура заголовка SOAP-запроса описана в таблице 2.1.4.1.

Идентификатор карточки

Идентификатор карточки можно получить с помощью функции searchByRequisite, в элементе hash записей результатов поиска.
Таблица 2.1.4.1.1. Состав и структура запроса (getCardInfo)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Идентификатор карточки hash П T О

Выходные параметры

Основная информация

Каждый тип карточки имеет свой формат основной информации (рис. 2.1.4.1.1).
Формат основной информации
Рис. 2.1.4.1.1. Формат основной информации
Таблица 2.1.4.1.4. Состав и структура типового элемента (info)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Карточка организации orgCard С Н Типовой элемент (orgCard ) (Таблица 2.1.4.1.5.)
Карточка индивидуального предпринимателя ipCard С Н Типовой элемент (ipCard) (Таблица 2.1.4.1.8.)
Карточка физического лица flCard С Н Типовой элемент (flCard) (Таблица 2.1.4.1.9.)
Карточка иностранной организации foreignOrgCard С Н Типовой элемент (foreignOrgCard) (Таблица 2.1.4.1.11.)

Карточка организации показан на рисунке 2.1.4.1.2.
Формат карточки организации
Рис. 2.1.4.1.2. Формат карточки организации
Таблица 2.1.4.1.5. Состав и структура типового элемента (orgCard)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
ОГРН ogrn П N(13) Н
ИНН inn П N(10) Н
ОКПО okpo П N(8) Н
КПП kpp П N(9) Н
БИК bik П N(9) Н
Статус status
Является ли текущая организация учатником системы страхования вкладов isSsvMember П B Н
Присутствует ли связь с адресом (местом нахождения), указанном в ЕГРЮЛ isEgrulAndressLink П B Н
Полное наименование fullName П Т Н
Сокращенное наименование shortName П Т Н
Наименование на английском языке englishName П Т Н
Юридический адрес address П Т О
Уставной капитал capital П Т Н
Телефоны phones П Т Н
Регистрационный орган regOrg П Т Н
Дата регистрации regDate П Н date
Дата прекращения деятельности endDate П Н date
Код ПФР pfr П N(12) Н
код ФСС fss П N(15) Н Код в фонде социального страхования
Наименование организации, которая является держателем реестра акционеров reestrHolderName П Т Н
Запись в общероссийском классификаторе административно - территориального деления ОК 019-95 okato С Н Типовой элемент ( okato) (Таблица 2.1.3.1.16.)
Запись в общероссийском классификаторе форм собственности ОК 027-99 okfs С Н Типовой элемент (okfs) (Таблица 2.1.4.1.6.)
Запись в общероссийском классификаторе органов государственной власти и управления ОК 006-2011 okogu С Н Типовой элемент (okogu) (Таблица 2.1.4.1.7.)
Запись в общероссийском классификаторе организационно-правовых форм ОК 028-99 okopf99 С Н Типовой элемент (okopf99) (Таблица 2.1.3.1.15.)
Запись в общероссийском классификаторе организационно-правовых форм ОК 028-2012 okopf2012 С Н Типовой элемент (okopf2012) (Таблица 2.1.3.1.14.)

Таблица 2.1.4.1.6. Состав и структура типового элемента (okfs)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код code П N(2) О
Наименование name П N(10) О
Таблица 2.1.4.1.7. Состав и структура типового элемента (okogu)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код code П N(7) О
Наименование name П N(10) О

Карточка индивидуального предпринимателя
Формат карточки индивидуального предпринимателя показан на рисунке 2.1.4.1.3.
Формат карточки индивидуального предпринимателя
Рис. 2.1.4.1.3. Формат карточки индивидуального предпринимателя
Таблица 2.1.4.1.8. Состав и структура типового элемента (ipCard)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
ОГРН ИП ogrnip П N(15) Н
ИНН ФЛ inn П N(12) Н
ОКПО okpo П N(10) Н
ФИО fio П Т Н
Статус status П Т Н
Дата регистрации regDate П Н date
Дата прекращения деятельности endDate П Н date
Код ПФР pfr П N(12) Н
код ФСС fss П N(15) Н Код в фонде социального страхования
Запись в общероссийском классификаторе административно - территориального деления ОК 019-95 okato С Н Типовой элемент ( okato) (Таблица 2.1.3.1.16.)
Запись в общероссийском классификаторе форм собственности ОК 027-99 okfs С Н Типовой элемент (okfs) (Таблица 2.1.4.1.6.)
Запись в общероссийском классификаторе органов государственной власти и управления ОК 006-2011 okogu С Н Типовой элемент (okogu) (Таблица 2.1.4.1.7.)
Запись в общероссийском классификаторе организационно-правовых форм ОК 028-99 okopf99 С Н Типовой элемент (okopf99) (Таблица 2.1.3.1.15.)
Запись в общероссийском классификаторе организационно-правовых форм ОК 028-2012 okopf2012 С Н Типовой элемент (okopf2012) (Таблица 2.1.3.1.14.)

Карточка физического лица
Формат карточки физического лица показан на рисунке 2.1.4.1.4.
Формат карточки физического лица
Рис. 2.1.4.1.4. Формат карточки физического лица
Таблица 2.1.4.1.9. Состав и структура типового элемента (flCard)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
ИНН ФЛ inn П N(12) Н
ФИО fio П Т Н
Код и название страны по ОКСМ , гражданином которой физическое лицо является nationality С Н Типовой элемент (oksm) (Таблица 2.1.4.1.10.)
Дата рождения birthDate П Н date
Место рождения birthPlace П Т Н
Таблица 2.1.4.1.10. Состав и структура типового элемента (nationality)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код code П N(1-3) О Запись в общероссийском классификаторе стран мира ОК 027-99
Наименование name П N(10) О

Карточка иностранной организации
Формат карточки иностранной организации показан на рисунке 2.1.4.1.5.
Формат карточки иностранной организации
Рис. 2.1.4.1.5. Формат карточки иностранной организации
Таблица 2.1.4.1.11. Состав и структура типового элемента (foreignOrgCard)

Наименование элемента Сокращённое наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Наименование организации name П Т О
Адрес address П Т Н
Код и название страны по ОКСМ oksm С Н Типовой элемент (oksm) (Таблица 2.1.4.1.10.)
Дата регистрации regDate П Н date

Примеры

Пример №1

Получить основную информацию об индивидуальном предпринимателе (с идентификатором карточки «a1593d7b38b419569a66694788f96ece»)
SOAP-запрос
POST /search/v1/soap/ HTTP/1.1
Content-Type: text/xml;charset=UTF-8
SOAPAction: "Card#getCardInfo"
Content-Length: 293
Host: api.kartoteka.ru

 <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://api.kartoteka.ru/search/v1/">
    <soapenv:Header>
       <sessionId>5h2usar23pk9ad8bpdmkbr9t80</sessionId>
    </soapenv:Header>
    <soapenv:Body>
       <v1:getCardInfo>
          <hash>a1593d7b38b419569a66694788f96ece</hash>
        </v1:getCardInfo>
    </soapenv:Body>
 </soapenv:Envelope> 
 
SOAP-ответ:
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
       <SOAP-ENV:getCardInfoResponse>
          <info>
             <ipCard>
                <okpo>175103585</okpo>
                <inn>500110474504</inn>
                <fio>Иванов Иванов Иванович</fio>
                <ogrnip>310500130500062</ogrnip>
                <regDate>2010-11-01</regDate>
                <pfr>60001021602</pfr>
                <okato>
                   <code>46204501000</code>
                   <name>Московская область, Балашихинский район, Балашиха</name>
                </okato>
                <okfs>
                   <code>16</code>
                   <name>Частная собственность</name>
                </okfs>
                <okogu>
                   <code>49015</code>
                   <name>Индивидуальные предприниматели</name>
                </okogu>
                <okopf2012>
                   <code>50102</code>
                   <name>Индивидуальные предприниматели</name>
                </okopf2012>
             </ipCard>
          </info>
       </SOAP-ENV:getCardInfoResponse>
    </SOAP-ENV:Body>
 </SOAP-ENV:Envelope> 
    

Печать