## Документация API api-assist.com bo.nalog.gov.ru (Бухгалтерская (финансовая) отчетность)

Сервис помогает автоматизировать получение бухгалтерской (финансовой) отчетности организаций, опубликованной на портале ФНС России https://bo.nalog.gov.ru/

Сервис поддерживает два типа запросов:

1. **Поиск организаций** — поиск по наименованию, ИНН или ОГРН.
2. **Получение детальной информации** — получение полной бухгалтерской отчетности организации по внутреннему ID, полученному при поиске.

Все запросы требуют указания ключа доступа (`key`).

---

### 1. Поиск организаций

Для поиска организаций используйте следующий запрос:

```
https://service.api-assist.com/parser/nalog_bo_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА
```

**Параметры поиска:**

- **query** — наименование организации (поиск по названию)
- **inn** — ИНН организации
- **ogrn** — ОГРН организации
- **page** — номер страницы (нумерация с 1, по умолчанию 1)

**Обязательно должен быть указан хотя бы один параметр:** `query`, `inn` или `ogrn`.

**Примеры поисковых запросов:**

Поиск по наименованию:
```
https://service.api-assist.com/parser/nalog_bo_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА&query=Газпром
```

Поиск по ИНН:
```
https://service.api-assist.com/parser/nalog_bo_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА&inn=7736050003
```

Поиск по ОГРН:
```
https://service.api-assist.com/parser/nalog_bo_api/search?key=ВАШ_КЛЮЧ_ДОСТУПА&ogrn=1027700070518
```

**Пример ответа на поисковый запрос:**

```json-toggle
{
  "success": 1,
  "count": 814, // общее количество найденных организаций
  "pages": 41, // общее количество страниц
  "page": 1, // текущая страница
  "items": [
    {
      "id": 6622458, // внутренний ID организации (используется для запроса детальной информации)
      "inn": "7736050003", // ИНН
      "ogrn": "1027700070518", // ОГРН
      "short_name": "ПАО \"ГАЗПРОМ\"", // краткое наименование
      "status": "Действующая", // статус организации (Действующая, Недействующая, В стадии ликвидации, В стадии реорганизации)
      "status_date": "2002-08-02", // дата присвоения статуса
      "index": "197229", // почтовый индекс
      "region": "САНКТ-ПЕТЕРБУРГ", // регион
      "district": null, // район
      "city": null, // город
      "settlement": null, // населенный пункт
      "street": "ЛАХТИНСКИЙ", // улица
      "house": "2", // дом
      "building": "3", // корпус/строение
      "office": null, // офис
      "okved2": "46.71", // код ОКВЭД2
      "okopf": 12247, // код ОКОПФ
      "bfo": { // сводка по последней бухгалтерской отчетности
        "period": "2025", // отчетный период (год)
        "actual_bfo_date": "2026-03-16", // дата актуальной отчетности
        "gain_sum": 5846351786, // выручка (тыс. руб.)
        "knd": "0710099", // код формы по КНД
        "has_az": true, // наличие аудиторского заключения
        "has_ks": false, // наличие консолидированной отчетности
        "actual_correction_number": 0, // номер корректировки
        "actual_correction_date": "2026-03-16", // дата корректировки
        "is_cb": false // является ли отчетность ЦБ
      }
    }
  ]
}
```

---

### 2. Получение детальной информации

Для получения детальной информации используйте следующий запрос:

```
https://service.api-assist.com/parser/nalog_bo_api/details?key=ВАШ_КЛЮЧ_ДОСТУПА&id=ID_ОРГАНИЗАЦИИ
```

**Параметры:**

- **id** — внутренний ID организации, полученный из результатов поиска (обязательный).

**Пример запроса:**

```
https://service.api-assist.com/parser/nalog_bo_api/details?key=ВАШ_КЛЮЧ_ДОСТУПА&id=6622458
```

**Пример ответа на запрос детальной информации:**

Ответ содержит общие сведения об организации и полную бухгалтерскую отчетность за все доступные на источнике годы.

```json-toggle
{
  "success": 1,
  "organization": { // сведения об организации
    "id": 6622458, // внутренний ID
    "inn": "7736050003", // ИНН
    "kpp": "781401001", // КПП
    "ogrn": "1027700070518", // ОГРН
    "short_name": "ПАО \"ГАЗПРОМ\"", // краткое наименование
    "full_name": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"ГАЗПРОМ\"", // полное наименование
    "status": "Действующая", // статус организации (Действующая, Недействующая, В стадии ликвидации, В стадии реорганизации)
    "status_date": "1993-02-25", // дата присвоения статуса
    "registration_date": "1993-02-25", // дата регистрации
    "authorized_capital": 118367564500, // уставный капитал (руб.)
    "index": "197229", // почтовый индекс
    "region": "САНКТ-ПЕТЕРБУРГ", // регион
    "district": null, // район
    "city": null, // город
    "settlement": null, // населенный пункт
    "street": "ЛАХТИНСКИЙ", // улица
    "house": "2", // дом
    "building": "3", // корпус/строение
    "office": null, // офис
    "okved2": { // ОКВЭД2
      "id": "46.71", // код
      "name": "Торговля оптовая твердым, жидким и газообразным топливом и подобными продуктами" // наименование
    },
    "okopf": { // ОКОПФ
      "id": 12247, // код
      "name": "Публичные акционерные общества" // наименование
    },
    "okfs": { // ОКФС (если доступно)
      "id": 41, // код
      "name": "Смешанная российская собственность с долей федеральной собственности" // наименование
    },
    "okpo": "00040778", // ОКПО
    "location": { // сведения о регистрирующем налоговом органе
      "name": "Инспекция ФНС России № 28 по г.Москве", // наименование
      "code": 7728 // код
    }
  },
  "reports": [ // массив отчетов за все доступные годы
    {
      "period": "2025", // отчетный период (год)
      "detail_id": 54366105, // ID корректировки (используется для скачивания PDF файлов)
      "actual_bfo_date": "2026-03-16", // дата актуальной отчетности
      "gain_sum": 5846351786, // выручка (тыс. руб.)
      "actives": 25736328136, // активы (тыс. руб.)
      "knd": "0710099", // код формы по КНД
      "correction_number": 0, // номер корректировки
      "correction_date": "2026-03-16", // дата корректировки
      "published_date": "2026-03-17", // дата публикации
      "required_audit": 1, // обязательный аудит (1 — да, 0 — нет)
      "date_present": "2026-03-16T18:51:12", // дата представления отчетности
      "organization_info": { // сведения об организации из БФО
        "full_name": "Публичное акционерное общество \"Газпром\"", // полное наименование
        "inn": "7736050003", // ИНН
        "kpp": "997250001", // КПП
        "address": "197229, Санкт-Петербург, Лахтинский пр-кт, д.2, к.3, стр.1", // адрес
        "okopf": { "id": 12247, "name": "Публичные акционерные общества" },
        "okfs": { "id": 41, "name": "Смешанная российская собственность с долей федеральной собственности" },
        "okpo": "00040778" // ОКПО
      },
      "url": "https://bo.nalog.gov.ru/download/bfo/pdf/6622458?period=2025&detailId=54366105", // прямая ссылка на скачивание PDF всей отчетности за период

      "balance": [], // бухгалтерский баланс (см. структуру ниже)
      "financial_result": [], // отчет о финансовых результатах (см. структуру ниже)
      "capital_change": [], // отчет об изменениях капитала (см. структуру ниже)
      "funds_movement": [], // отчет о движении денежных средств (см. структуру ниже)
      "targeted_funds_using": [], // отчет о целевом использовании средств (см. структуру ниже)
      "audit_report": {}, // аудиторское заключение (см. структуру ниже)
      "clarification": {} // пояснения к балансу (см. структуру ниже)
    }
  ]
}
```

---

### 2.1. Бухгалтерский баланс (`balance`)

Содержит данные по строкам бухгалтерского баланса за три периода: текущий (`current`), предыдущий (`previous`) и предшествующий предыдущему (`before_previous`). Все суммы в тысячах рублей.

**Раздел I. Внеоборотные активы:**
**Раздел II. Оборотные активы:**
**Раздел III. Капитал и резервы:**
**Раздел IV. Долгосрочные обязательства:**
**Раздел V. Краткосрочные обязательства:**

**Структура поля `balance`:**

Поле `balance` содержит массив объектов. Каждый объект — строка баланса с полями `code`, `name` и значениями за три периода. Для строк, имеющих расшифровку, доступна детализация в поле `details` — массив подстрок.

```json-toggle
{
  "balance": [
    {
      "code": 1110, // код строки
      "name": "Нематериальные активы", // наименование строки
      "current": 32601871, // значение на отчетную дату текущего периода (тыс. руб.)
      "previous": 26164163, // значение на 31 декабря предыдущего года (тыс. руб.)
      "before_previous": 24427548 // значение на 31 декабря года, предшествующего предыдущему (тыс. руб.)
    },
    {
      "code": 1150,
      "name": "Основные средства",
      "current": 14718905656,
      "previous": 14557202840,
      "before_previous": 14596295034,
      "details": [ // детализация строки (при наличии расшифровки)
        {
          "code": 115001, // код подстроки
          "name": "объекты основных средств", // наименование
          "current": 12241946225,
          "previous": 12184641603,
          "before_previous": 11760797370
        },
        {
          "code": 115002,
          "name": "капитальные вложения",
          "current": 2466095677,
          "previous": 2355674632,
          "before_previous": 2812591439
        },
        {
          "code": 115003,
          "name": "права пользования активами",
          "current": 10863754,
          "previous": 16886605,
          "before_previous": 22906225
        }
      ]
    },
    {
      "code": 1170,
      "name": "Финансовые вложения",
      "current": 5099511964,
      "previous": 5593699027,
      "before_previous": 6186461518,
      "details": [
        {
          "code": 117001,
          "name": "инвестиции в дочерние организации",
          "current": 4105533441,
          "previous": 4780577605,
          "before_previous": 5635622392
        },
        {
          "code": 117002,
          "name": "инвестиции в зависимые организации",
          "current": 43137107,
          "previous": 43137107,
          "before_previous": 40223271
        }
        // ... остальные строки
      ]
    },
    {
      "code": 1250,
      "name": "Денежные средства и денежные эквиваленты",
      "current": 432590853,
      "previous": 267111585,
      "before_previous": 321536303,
      "details": [
        {
          "code": 125001,
          "name": "расчетные счета",
          "current": 387600638,
          "previous": 265402852,
          "before_previous": 249726832
        }
        // ... остальные строки
      ]
    },
    {
      "code": 1520,
      "name": "Кредиторская задолженность",
      "current": 1172282674,
      "previous": 1473867679,
      "before_previous": 1324091821,
      "details": [
        {
          "code": 152001,
          "name": "поставщики и подрядчики",
          "current": 922186131,
          "previous": 984862338,
          "before_previous": 803337387
        },
        {
          "code": 152002,
          "name": "задолженность перед персоналом организации",
          "current": 1342836,
          "previous": 1222982,
          "before_previous": 1111697
        }
        // ... остальные строки
      ]
    },
    {
      "code": 1600,
      "name": "Баланс (актив)",
      "current": 25736328136,
      "previous": 26162827395,
      "before_previous": 26347838009
    }
    // ... остальные строки баланса
  ]
}
```

---

### 2.2. Отчет о финансовых результатах (`financial_result`)

Содержит данные по строкам отчета о финансовых результатах за два периода: текущий (`current`) и предыдущий (`previous`). Все суммы в тысячах рублей.

**Структура поля `financial_result`:**

Поле `financial_result` содержит массив объектов. Для строк, имеющих расшифровку (например, 2110 — выручка по видам деятельности, 2120 — себестоимость по видам деятельности), доступна детализация в поле `details`.

```json-toggle
{
  "financial_result": [
    {
      "code": 2110, // код строки
      "name": "Выручка", // наименование строки
      "current": 5846351786, // значение за отчетный период (тыс. руб.)
      "previous": 6256625972, // значение за аналогичный период предыдущего года (тыс. руб.)
      "details": [ // детализация строки (при наличии расшифровки)
        {
          "code": 211001,
          "name": "продажа газа",
          "current": 3674478562,
          "previous": 3889517030
        },
        {
          "code": 211002,
          "name": "предоставление имущества в аренду",
          "current": 1121202369,
          "previous": 1113171404
        }
        // ... остальные строки
      ]
    },
    {
      "code": 2120,
      "name": "Себестоимость продаж",
      "current": 4125098051,
      "previous": 4812318011,
      "details": [
        {
          "code": 212001,
          "name": "продажа газа",
          "current": 1841131430,
          "previous": 2449790184
        }
        // ... остальные подстроки
      ]
    },
    {
      "code": 2400,
      "name": "Чистая прибыль (убыток)",
      "current": 11284564,
      "previous": -1076329869
    },
    {
      "code": 2900,
      "name": "Базовая прибыль (убыток) на акцию (руб. коп.)",
      "current": 0.48,
      "previous": -45.47
    }
    // ... остальные строки
  ]
}
```

---

### 2.3. Отчет об изменениях капитала (`capital_change`)

Содержит данные по строкам отчета об изменениях капитала. Каждая строка имеет разбивку по столбцам капитала.

**Столбцы капитала:**

- `authorized` — уставный капитал
- `redeemed` — собственные акции, выкупленные у акционеров
- `additional` — добавочный капитал
- `reserve` — резервный капитал
- `unallocated` — нераспределенная прибыль (непокрытый убыток)
- `revaluation` — накопленная дооценка внеоборотных активов
- `total` — итого

**Структура поля `capital_change`:**

Поле `capital_change` содержит массив объектов. Для строк, имеющих расшифровку (например, 3230, 3240, 3330, 3340), доступна детализация в поле `details`.

```json-toggle
{
  "capital_change": [
    {
      "code": 3100, // код строки
      "name": "Величина капитала на 31 декабря года, предшествующего предыдущему", // наименование строки
      "authorized": 118367564, // уставный капитал
      "redeemed": null, // собственные акции
      "additional": 228765559, // добавочный капитал
      "reserve": 8636001, // резервный капитал
      "unallocated": 17059695671, // нераспределенная прибыль
      "revaluation": null, // переоценка
      "total": 17415464795 // итого
    },
    {
      "code": 3240,
      "name": "Иные изменения — всего",
      "authorized": 0,
      "redeemed": null,
      "additional": 24717964,
      "reserve": null,
      "unallocated": -33924831,
      "revaluation": null,
      "total": -9206867,
      "details": [ // детализация строки (при наличии расшифровки)
        {
          "code": 324001,
          "name": "операции, связанные с бессрочными облигациями и займами",
          "authorized": 0,
          "redeemed": null,
          "additional": 24717964,
          "reserve": null,
          "unallocated": -33924831,
          "revaluation": null,
          "total": -9206867
        },
        {
          "code": 324002,
          "name": "прочее",
          "authorized": 0,
          "redeemed": null,
          "additional": null,
          "reserve": null,
          "unallocated": null,
          "revaluation": null,
          "total": 0
        }
      ]
    },
    {
      "code": 3300,
      "name": "Величина капитала на отчетную дату",
      "authorized": 118367564,
      "redeemed": null,
      "additional": 205771762,
      "reserve": 8636001,
      "unallocated": 16099447559,
      "revaluation": null,
      "total": 16432222886
    },
    {
      "code": 3330,
      "name": "Иные изменения за счет операций с собственниками (за исключением дивидендов) — всего",
      "authorized": 0,
      "redeemed": 153,
      "additional": null,
      "reserve": null,
      "unallocated": 100367522,
      "revaluation": null,
      "total": 100367675,
      "details": [
        {
          "code": 333001,
          "name": "прочее",
          "authorized": 0,
          "redeemed": 153,
          "additional": null,
          "reserve": null,
          "unallocated": 100367522,
          "revaluation": null,
          "total": 100367675
        }
      ]
    }
    // ... остальные строки
  ]
}
```

---

### 2.4. Отчет о движении денежных средств (`funds_movement`)

Содержит данные по строкам отчета о движении денежных средств за два периода: текущий (`current`) и предыдущий (`previous`). Все суммы в тысячах рублей.

**Раздел I. Денежные потоки от текущих операций:**
**Раздел II. Денежные потоки от инвестиционных операций:**
**Раздел III. Денежные потоки от финансовых операций:**

**Структура поля `funds_movement`:**

Поле `funds_movement` содержит массив объектов. Для строк, имеющих расшифровку (например, 4314, 4323), доступна детализация в поле `details`.

```json-toggle
{
  "funds_movement": [
    {
      "code": 4110, // код строки
      "name": "Поступления — всего", // наименование строки
      "current": 7566949191, // значение за отчетный период (тыс. руб.)
      "previous": 7431051822 // значение за аналогичный период предыдущего года (тыс. руб.)
    },
    {
      "code": 4100,
      "name": "Сальдо денежных потоков от текущих операций",
      "current": 884442699,
      "previous": 178913208
    },
    {
      "code": 4314,
      "name": "от выпуска облигаций, векселей и других долговых ценных бумаг",
      "current": 0,
      "previous": null,
      "details": [ // детализация строки (при наличии расшифровки)
        {
          "code": 431401,
          "name": "от бессрочных облигаций и займов",
          "current": 0,
          "previous": null
        }
      ]
    },
    {
      "code": 4323,
      "name": "в связи с погашением (выкупом) векселей и других долговых ценных бумаг, возврат кредитов и займов",
      "current": 9623730,
      "previous": 9253975,
      "details": [
        {
          "code": 432301,
          "name": "связанные с бессрочными облигациями и займами",
          "current": 9623730,
          "previous": 9253975
        }
      ]
    },
    {
      "code": 4500,
      "name": "Остаток денежных средств и денежных эквивалентов на конец отчетного периода",
      "current": 432590853,
      "previous": 267111585
    }
    // ... остальные строки
  ]
}
```

---

### 2.5. Отчет о целевом использовании средств (`targeted_funds_using`)

Содержит данные о целевом использовании средств за два периода: текущий (`current`) и предыдущий (`previous`). Заполняется некоммерческими организациями. Все суммы в тысячах рублей.

**Структура поля `targeted_funds_using`:**

Поле `targeted_funds_using` содержит массив объектов.

```json-toggle
{
  "targeted_funds_using": [
    {
      "code": 6100, // код строки
      "name": "Остаток средств на начало отчетного года", // наименование строки
      "current": 0, // значение за отчетный период (тыс. руб.)
      "previous": 0 // значение за аналогичный период предыдущего года (тыс. руб.)
    },
    {
      "code": 6200,
      "name": "Всего поступило средств",
      "current": 0,
      "previous": 0
    }
    // ... остальные строки
  ]
}
```

---

### 2.6. Аудиторское заключение (`audit_report`)

Содержит сведения об аудиторе и ссылку на скачивание PDF-файла аудиторского заключения (при наличии).

```json-toggle
{
  "audit_report": {
    "auditor_inn": "7701017140", // ИНН аудитора
    "auditor_ogrn": "1027700058286", // ОГРН аудитора
    "auditor_name": "Общество с ограниченной ответственностью \"Финансовые и бухгалтерские консультанты\"", // наименование аудитора
    "is_organization": true, // аудитор является организацией
    "file_name": "NO_BUHAZ_...pdf", // оригинальное имя файла
    "file_url": "https://bo.nalog.gov.ru/download/audit/54366105" // прямая ссылка на скачивание PDF
  }
}
```

Если аудиторское заключение отсутствует, поле `audit_report` будет равно `null`.

---

### 2.7. Пояснения к бухгалтерскому балансу (`clarification`)

Содержит ссылку на скачивание PDF-файла пояснений (при наличии).

```json-toggle
{
  "clarification": {
    "file_name": "NO_BUHPZ_...pdf", // оригинальное имя файла
    "file_url": "https://bo.nalog.gov.ru/download/clarification/54366105" // прямая ссылка на скачивание PDF
  }
}
```

Если пояснения отсутствуют, поле `clarification` будет равно `null`.

---

### Интерпретация ответа и обработка ошибок

**Общие рекомендации:**
- Если поле `success = 1` — перед вами успешный ответ, с которым можно работать. Только такие запросы учитываются в статистике и расходуют оплаченный лимит.
- Иначе, если поле `error` заполнено — запрос требует вашего внимания. Текст ошибки рекомендуется сохранить или отправить для дальнейшего анализа.
- Иначе, если поле `error` не заполнено — это ошибка, связанная со стабильностью источника. В таком случае мы рекомендуем игнорировать ответ и повторить запрос.

В данном разделе описаны возможные коды ответов сервиса и их значения. Каждый код ответа сопровождается пояснением и примером JSON-ответа.

#### 1. Код ответа - 200

- Поле `success = 1` - удалось получить информацию от источника. Такие и только такие запросы можно запускать в дальнейшую обработку. Примеры ответов см. выше.
- Поле `success = 0` - не удалось получить информацию от источника. Запрос не будет учтен в статистике. Необходимо повторить запрос.

#### 2. Код ответа - 403

Выдается сервисом в случае невозможности обработки запроса из-за ограничения доступа: закончилась подписка, превышен лимит и так далее. Причины ошибок отражены в поле `error` ответа. Ниже приведен список возможных ошибок с их описанием и кодами:

- **Invalid access key**
  `error_code = 40301`
  Указанный ключ доступа недействителен или отсутствует.

- **The subscription period has expired**
  `error_code = 40302`
  Доступ к сервису истек, требуется продление.

- **Invalid IP**
  `error_code = 40303`
  Запрос выполнен с IP-адреса, который не разрешён для доступа.

- **Day limit of requests exceeded**
  `error_code = 40304`
  Достигнут оплаченный лимит запросов на день.

- **Month limit of requests exceeded**
  `error_code = 40305`
  Достигнут оплаченный лимит запросов на месяц.

**Пример ответа:**
```json
{
  "error": "Invalid access key",
  "error_code": 40301
}
```

#### 3. Код ответа - 400

Выдается сервисом в случае невозможности обработки запроса из-за ошибки валидации запроса, неверного или отсутствующего значения какого-либо поля. Поле `error_code` всегда равно `40001`, подробности доступны в поле `error`.

**Примеры ответов:**

Пустой запрос:
```json
{
  "error": "Empty request. Please provide query, inn or ogrn",
  "error_code": "40001"
}
```

Невалидный ID:
```json
{
  "error": "Invalid organization id",
  "error_code": "40001"
}
```