Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
ПолеТип данныхОписание
value
Наименование организации одной строкой (как показывается в списке подсказок
string(1000)Краткое наименование организации (data.name.short_with_opf). Если краткое наименование не указано — полное наименование (data.name.full_with_opf)
unrestricted_value
Наименование компании одной строкой (полное)
string(1000)= value

data.address

.valueАдрес организации одной строкойdata.address.unrestricted_value= data.address.value


Адрес
└ valuestring(1000)

— адрес одной строкой:

  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.

стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ unrestricted_value

string(1000)

— адрес одной строкой (полный, от региона)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ

└ data

гранулярный адрес

└ data.source

string(1000)

— исходный адрес одной строкой как в ЕГРЮЛ

└ data.qcstring(10)

— код качества адреса (19.1+)

  • 0 – Адрес распознан уверенно
  • 1 – Остались «лишние» части. 
  • 3 – Есть альтернативные варианты.
data.address.dataНе заполняется
data.branch_countunsignedShortКоличество филиалов
data.branch_typestring(50)

Тип подразделения

  • MAIN — головная организация
;
  • BRANCH — филиал

data.fio

└ surname

└ name

└ patronymic

└ gender

└ source

└ qc


string(100)

string(100)

string(100)

Имя ИП ( 21.3+)

— фамилия

— имя 

— отчество

не заполняется 

не заполняется 

не заполняется 

data.innstring(20)ИНН
data.kppstring(10)КПП
data.
management.nameФИО руководителяdata.management.postДолжность руководителяdata.name.fullПолное наименованиеdata.name.latinНаименование на латиницеdata.name.shortКраткое наименованиеdata.ogrnОГРНdata.okpoКод ОКПОdata.okvedКод ОКВЭДdata.opf.codeКод ОКОПФdata.opf.fullПолное название ОПФdata.opf.shortКраткое название ОПФdata.state.registration_dateДата регистрацииdata.state.liquidation_dateДата ликвидацииdata.state.status

Статус организации

  • ACTIVE — действующая;
  • LIQUIDATING — ликвидируется;
  • LIQUIDATED — ликвидирована.
data.type

Тип организации

  • LEGAL — юридическое лицо;
  • INDIVIDUAL — индивидуальный предприниматель
    ogrnstring(20)ОГРН
    Для представительств иностранных компаний — номер записи об аккредитаци
    data.ogrn_datelongДата выдачи ОГРН
    data.hidstring(100)Внутренний идентификатор

    data.management

    └ name

    └ post

    disqualified


    string(200)

    string(500)

    boolean

    Руководитель

    — ФИО руководителя

    — должность руководителя

    — true, если в состав руководства входят дисквалифицированные лица (19.7+)

    data.name

    └ full_with_opf

    └ short_with_opf

    └ full


    └ short
     

    └ latin


    string(1000)

    string(1000)

    string(1000)

    string(1000)

    Наименование

    — полное наименование

    — краткое наименование

    — полное наименование без ОПФ
    генерируется на основе full_with_opf, может содержать ошибки

    — краткое наименование без ОПФ
    генерируется на основе short_with_opf, может содержать ошибки

    — не заполняется

    data.okatostring(20)Код ОКАТО (20.9+)
    data.oktmostring(20)Код ОКТМО (20.9+)
    data.okpostring(10)Код ОКПО
    data.okogustring(10)Код ОКОГУ (20.9+)
    data.okfsstring(10)Код ОКФС (20.9+)
    data.okvedstring(10)Код ОКВЭД
    data.okved_typestring(10)

    Версия справочника ОКВЭД (2001 или 2014)

    data.opf

    └ code

    └ full

    └ short

    └ type


    string(10)

    string(1000)

    string(1000)

    string(10)

    Организационно-правовая форма

    — код ОКОПФ

    — полное название ОПФ

    — краткое название ОПФ

    — версия справочника ОКОПФ

    data.state

    └ actuality_date

    └ registration_date

    └ liquidation_date

    └ code

    └ status


    long

    long

    long

    string(10)

    string(50)

    Состояние

    — дата актуальности сведений

    — дата регистрации

    — дата ликвидации

    детальный статус (c декабря 2020)

    — статус организации

    Блок кода
    ACTIVE        действующая
    LIQUIDATING   ликвидируется
    LIQUIDATED    ликвидирована
    REORGANIZING  в процессе присоединения к другому юрлицу,
                  с последующей ликвидацией
    BANKRUPT      банкрот (с февраля 2021)
    data.typestring(50)

    Тип организации

    Блок кода
    LEGAL       юридическое лицо
    INDIVIDUAL  индивидуальный предприниматель
    data.employee_countintКоличество сотрудников (19.7+)
    Дополнительные поля, заполняются в зависимости от тарифа «Дадаты» *
    Заполняются при выборе конкретной подсказки в jQuery плагине или через метод API  findById . До этого они пустые.
    Тарифы «Расширенный» и «Максимальный»

    data.okveds[ ]

    └ main

    └ type

    └ code

    └ name


    boolean

    string(10)

    string(10)

    string(1000)

    Коды ОКВЭД дополнительных видов деятельности

    — основной или нет (true / false)

    — версия справочника ОКВЭД (2001 или 2014)

    — код по справочнику

    — наименование по справочнику

    data.authorities


    Сведения о налоговой, ПФР и ФСС

    data.authorities.fts_registration

    └ type

    └ code

    └ name

    └ address


    string(50)

    string(20)

    string(500)

    string(500)

    ИФНС регистрации

    — код гос. органа

    — код отделения

    — наименование отделения

    — адрес отделения одной строкой

    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


    unsignedShort

    string(10)

    string(1000)

    string(1000)

    Гражданство ИП

    — числовой код страны по ОКСМ

    — трехбуквенный код страны по ОКСМ

    — полное наименование страны

    — краткое наименование страны

    Тариф «Максимальный»
    data.address.invalidityobjectнедостоверность сведений об адресе

    data.founders[ ]

    └ ogrn

    └ inn

    └ name

    └ fio

    └ hid

    └ type

    └ invalidity


    string(20)

    string(20)

    string(1000)

    object

    string(100)

    string(50)

    object

    Учредители компании

    — ОГРН учредителя (для юрлиц)

    — ИНН учредителя

    — наименование учредителя (для юрлиц)

    — ФИО учредителя (для физлиц)

    — внутренний идентификатор

    — тип учредителя (LEGAL / PHYSICAL)

    недостоверность сведений об учредителе

    data.founders[ ].share

    └ type

    └ value

    └ numerator

    └ denominator


    string(50)

    decimal

    long

    long

    Доля учредителя (справочники от 05.06.2020 и новее):

    — тип значения (PERCENT / DECIMAL / FRACTION)

    — значение (для type = PERCENT и type = DECIMAL)

    — числитель дроби (для type = FRACTION)

    — знаменатель дроби (для type = FRACTION)

    типы:

    Блок кода
    PERCENT   процент (46)
    DECIMAL   десятичная дробь (3.14)
    FRACTION  обычная дробь (3/4)

    data.managers[ ]

    └ ogrn

    └ inn

    └ name

    └ fio

    └ post

    └ hid

    └ type

    └ invalidity


    string(20)

    string(20)

    string(1000)

    object

    string(500)

    string(100)

    string(50)

    object

    Руководители компании

    — ОГРН руководителя (для юрлиц)

    — ИНН руководителя

    — наименование руководителя (для юрлиц)

    — ФИО руководителя (для физлиц)

    — должность руководителя (для физлиц)

    — внутренний идентификатор

    — тип руководителя

    недостоверность сведений о руководителе

    типы:

    Блок кода
    EMPLOYEE   сотрудник
    FOREIGNER  иностранный гражданин
    LEGAL      юрлицо

    data.predecessors[]

    └ ogrn

    └ inn

    └ name


    string(20)

    string(20)

    string(1000)

    Правопредшественники, только для юрлиц (20.10+)

    — ОГРН предшественника

    — ИНН предшественники

    — наименование предшественника

    data.successors[]

    └ ogrn

    └ inn

    └ name


    string(20)

    string(20)

    string(1000)

    Правопреемники, только для юрлиц (20.10+)

    — ОГРН преемника

    — ИНН преемника

    — наименование преемника

    data.capital

    └ type

    └ value


    string(50)

    decimal

    Уставной капитал компании

    — тип капитала

    — размер капитала

    data.finance

    └ tax_system

    └ income

    └ expense

    └ revenue

    └ year

    └ debt

    └ penalty


    string(50)

    decimal

    decimal

    decimal

    int

    decimal

    decimal

    Финансовая информация (19.7+)

    — система налогообложения организации

    доходы по данным бухгалтерской отчетности

    расходы по данным бухгалтерской отчетности

    — выручка по данным бухгалтерской отчетности (23.8+)

    — год бухгалтерской отчестности (21.3+)

    задолженность по налоговым платежам за позапрошлый год

    — наложенные штрафы за позапрошлый год



    Документы

    data.documents.fts_registration

    └ type

    └ series

    └ number

    └ issue_date

    └ issue_authority


    string(50)

    string(20)

    string(20)

    long

    string(500)

    Свидетельство о регистрации в налоговой

    — тип документа (= FTS_REGISTRATION)

    — серия документа

    — номер документа

    — дата выдачи

    — код подразделения

    data.documents.fts_report
    Сведения об учете в налоговом органе,структура аналогична fts_registration (21.7+)

    data.documents.pf_registration


    Свидетельство о регистрации в Пенсионном фонде,структура аналогична fts_registration

    data.documents.sif_registration


    Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration

    data.documents.smb

    └ type

    └ category

    └ issue_date


    string(50)

    string(50)

    long

    Запись в реестре малого и среднего предпринимательства (19.6+)

    — тип документа (= SMB)

    категория (MICRO, SMALL, MEDIUM)

    дата включения организации в реестр

    категории:

    Блок кода
    MICRO   микро-предприятие
    SMALL   малое предприятие
    MEDIUM  среднее предприятие

    data.licenses[ ]

    └ series

    └ number

    └ issue_date

    └ issue_authority

    └ suspend_date

    └ suspend_authority

    └ valid_from

    └ valid_to

    └ activities[ ]

    └ addresses[ ]


    string(100)

    string(100)

    long

    string(1000)

    long

    string(1000)

    long

    long

    string[](1000)

    string[](1000)

    Лицензии

    — серия документа

    — номер документа

    — дата выдачи

    — название выдавшего органа

    — дата приостановки

    — название приостановившего органа

    — дата начала действия

    — дата окончания действия

    — перечень лицензируемых видов деятельности

    — перечень адресов, по которым действует лицензия

    data.phones[ ]

    value

    unrestricted_value


    string(1000)

    string(1000)

    Телефоны

    — телефон одной строкой

    — телефон одной строкой

    data.phones[ ]. data.contact

    └ type

    └ name


    string(50)

    string(1000)

    Контактное лицо

    — тип

    — имя

    типы:

    Блок кода
    MANAGING_PARTY     управляющая организация
    TRUSTED_EMPLOYEE   сотрудник
    TRUSTED_FOREIGNER  иностранный гражданин

    data.phones[ ]. data

    └ source

    └ type

    └ number 

    └ extension

    └ provider

    └ country

    └ region

    └ city

    └ timezone

    └ country_code

    └ city_code

    └ qc_conflict

    └ qc


    string(250)

    string(50)

    string(10)

    string(10)

    string(100)

    string(50)

    string(100)

    string(100)

    string(50)

    string(10)

    string(10)

    Гранулярные поля телефона

    — телефон, указанный в ЕГРЮЛ

    — тип телефона

    локальный номер телефона

    — добавочный номер 

    — оператор связи (только для России) 

    — страна

    регион (только для России) 

    город (только для стационарных телефонов)

    — часовой пояс города для России, часовой пояс страны — для иностранных телефонов 

    — код страны  

    — код города  

    не заполняется 

    не заполняется

    типы телефонов:

    Блок кода
    Мобильный         +7 911 243-45-68
    Стационарный      +7 495 456-55-77
    Прямой мобильный  +7 495 243-45-68
    Колл-центр        8 800 222-12-22
    Неизвестный       +7 333 1111112

    data.emails[ ]

    value

    unrestricted_value


    string(1000)

    string(1000)

    Адреса эл. почты

    —  адрес эл. почты одной строкой

    —  адрес эл. почты одной строкой

    data.emails[ ].data

    └ local

    └ domain

    └ source

    └ type

    └ qc


    string(100)

    string(100)

    string(250)

    Гранулярные поля  эл. почты

    — именная часть

    — доменная часть

    — адрес эл. почты , указанный в ЕГРЮЛ

    не заполняется 

    не заполняется 

    data.invalidbooleanНедостоверность сведений о компании
    Не используются
    data.source

    data.qc

    * Для «коробки» возвращаются все дополнительные поля.

    Доходы и расходы

    Показатели рассчитываются по «Отчету о финансовых результатах» (форма по ОКУД 0710002):

    • Доходы = сумма по кодам 2110, 2310, 2320, 2340
    • Расходы = сумма по кодам 2120, 2210, 2220, 2330, 2350

    Доходы:

    Блок кода
    2110 Выручка
    2310 Доходы от участия в других организациях
    2320 Проценты к получению
    2340 Прочие доходы

    Расходы:

    Блок кода
    2120 Себестоимость продаж
    2210 Коммерческие расходы
    2220 Управленческие расходы
    2330 Проценты к уплате
    2350 Прочие расходы

    Доходы и расходы заполнены примерно у 60% действующих компаний (такая полнота данных в налоговой).

    Недостоверные сведения об организации

    Налоговая может признать сведения об учредителе, руководителе или адресе организации недостоверными. Тогда в ответе будут заполнены соответствующие поля:

    Блок кода
    data.founders[ ].invalidity
    data.managers[ ].invalidity
    data.address[ ].invalidity

    Поле invalidity — это объект с такими свойствами:

    ПолеТип данныхОписание
    codestring(50)

    код причины недостоверности

    Блок кода
      PARTY  — обращение лица или организации
      FTS    — проверка налоговой
      COURT  — решение суда
      OTHER  — прочие причины

    decision

    └ court_name

    └ number

    └ date

    object

    string(100)

    string(255)

    long

    решение суда (только для code = COURT)

    — наименование суда

    — номер судебного решения

    — дата судебного решения

    Если хотя бы один учредитель, руководитель или адрес организации признан недостоверным, для организации в целом вернется маркер data.invalid = true. Если недостоверных данных нет — будет data.invalid = null.

    Формат даты

    Даты регистрации и ликвидации — количество миллисекунд от 01.01.1970. Хранится в UTC.

    Для JavaScript преобразуется в дату так:

    Блок кода
    var ticks = 989784000000,;
       var date = new Date(ticks);
    

    Для PHP:

    ...

    Блок кода
    long ticks = 989784000000;
    DateTime date = (new DateTime(long.Parse1970, 1, 1)).AddMilliseconds(ticks));