API – Финансовая отчетность

Финансовая (бухгалтерская) отчетность российских организаций по данным сервиса ГИР БО от Федеральной Налоговой Службы и Федеральной службы государственной статистики.




Формат запроса

Используются GET- или POST-запросы следующего вида

https://api.ofdata.ru/alpha/json
  ?object=fin
  &key={ваш API-ключ}
  &ogrn={ОГРН организации}
  &inn={ИНН организации}
  &kpp={КПП организации}


Параметр запроса Описание
object
Обязательный параметр, указывающий на конкретный интерфейс API, в данном случае принимает значение
fin
.
key
Обязательный параметр, ваш API-ключ. Получается автоматически после регистрации.
ogrn
Рекомендуемый параметр, ОГРН организации, 13 цифр. Служит уникальным идентификатором для всех организаций.
inn
Если вы не указали ОГРН, вы можете указать ИНН организации. В случае определения нескольких юридческих лиц с указанным ИНН (такое бывает, например, если у организации есть филиалы), будет возвращена информация по головной организации.
kpp
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию.



Формат ответа

{
  "data": {
Основная информация ответа
    "entity": {
Организация, определенная по ОГРН или ИНН
      "ogrn": <STRING>,
ОГРН
      "inn": <STRING>,
ИНН
      "kpp": <STRING>,
КПП
      "okpo_code": <STRING>,
Код ОКПО
      "name": <STRING>,
Сокращенное наименование
      "full_name": <STRING>,
Полное наименование
      "region_code": <STRING>,
Код региона
      "legal_address": <STRING>,
Юридический адрес
      "ogrn_date": <STRING>,
Дата присвоения ОГРН
      "liquidation_date": <STRING>
Дата ликвидации юридического лица
    },
    "accounting": {
Данные финансовой отчетности организации
      "2012": {
Год отчетности, принимает значения от
2012
до
2019
        "1100": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        "1110": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        "1120": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        ...
        ...
        "6400": <INTEGER>
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
      },
      ...
      ...
      "2019": {
Год отчетности, принимает значения от
2012
до
2019
        "1100": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        "1110": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        "1120": <INTEGER>,
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
        ...
        ...
        "6400": <INTEGER>
Сумма, указанная в соответствующей строке формы бухглатерской отчетности, руб.
      }
    }
  },
  "meta": {
Информация о результате запроса
    "status": <STRING>,
Статус ответа, принимает значения
ok
или
error
    "message": <STRING>,
Сообщение, поясняющее результат запроса, не указывается в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
    "today_request_count": <INTEGER>
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
  }
}


Примечания


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

Коды строк в формах годовой бухгалтерской отчетности организации описаны в Приложении № 4 Приказа Минфина РФ от 2 июля 2010 г. № 66Н "О формах бухгалтерской отчетности организаций". В нашем API используются следующие коды строк



Если у вас есть идеи по улучшению API или какие-либо вопросы — пишите нам на [email protected] или оставьте сообщение через форму обратной связи. Мы постоянно совершенствуем наши сервисы и с удовольствием рассмотрим все ваши предложения.