Войти
Назад

Получить сведения о справках по форме 2-НДФЛ

link
Скопировать прямую ссылку на статью

Дата актуализации 24.02.2026


Назначение

Получение сведений всех документов гражданина по идентификатору пользователя (oid) и типу документа (doc_type)

Тип запроса

GET

Path

/digital/api/public/{version}/pso/{oid}/doc/INCOME_REFERENCE

Авторизация

Указать в заголовке запроса поле «Authorization» с полученным маркером доступа, содержащим информацию о действующем согласии

Параметры запроса

– version – версия API (текущая версия – v1);

– oid – уникальный идентификатор пользователя;

– doc_type – INCOME_REFERENCE;

– test={id}, где id – порядковый номер тестового ответа для конкретного сведения. 

Модель документа Сведения о справке по форме 2-НДФЛ
 Пример base64   Скачать

Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v1/pso/2080086398/doc/INCOME_REFERENCE'

--header 'Authorization: Bearer token'

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


Пример ответ с данными

[
    {
        "oid": "2080086398",
        "id": "a7992891-49d3-4801-a5d6-b68c7472b21b",
        "version": 1,
        "createdOn": 1748582060431,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1748582060431,
        "validateDateDoc": 1748582060425,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "ndflNotFound",
        "year": "2023",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080257392",
        "id": "cbcb66e7-58e6-46c9-bb63-4326f0cb2e2c",
        "version": 1,
        "createdOn": 1748436598785,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1748436598785,
        "validateDateDoc": 1748436598778,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "year": "2024",
        "data": [
            {
                "orgInfo": {
                    "fullName": "АО "РТ ЛАБС"",
                    "inn": "5047053920",
                    "kpp": "631145001"
                },
                "incInfo": [
                    {
                        "rate": "13",
                        "income": "123491.18",
                        "tax": "7983"
                    },
                    {
                        "rate": "29",
                        "income": "108253.46",
                        "tax": "12157"
                    },
                    {
                        "rate": "29",
                        "income": "58107.48",
                        "tax": "3484"
                    },
                    {
                        "rate": "13",
                        "income": "118080.11",
                        "tax": "5583"
                    },
                    {
                        "rate": "29",
                        "income": "88314.11",
                        "tax": "8719"
                    },
                    {
                        "rate": "13",
                        "income": "123491.18",
                        "tax": "6585"
                    },
                    {
                        "rate": "29",
                        "income": "118529.81",
                        "tax": "17162"
                    }
                ],
                "files": [
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.xml",
                        "metadata": "application/xml",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    },
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.pdf",
                        "metadata": "application/pdf",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    }
                ]
            },
            {
                "orgInfo": {
                    "fullName": "АО «ТИНЬКОФФ БАНК»",
                    "inn": "7710140679",
                    "kpp": "771301001"
                },
                "incInfo": [
                    {
                        "rate": "13",
                        "income": "905696.49",
                        "tax": "13449"
                    }
                ],
                "files": [
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.xml",
                        "metadata": "application/xml",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    },
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.pdf",
                        "metadata": "application/pdf",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    }
                ]
            },
            {
                "orgInfo": {
                    "fullName": "ООО ИК "ФРИДОМ ФИНАНС"",
                    "inn": "7705934210",
                    "kpp": "770301001"
                },
                "incInfo": [
                    {
                        "rate": "13",
                        "income": "686017.05",
                        "tax": "5203"
                    }
                ],
                "files": [
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.xml",
                        "metadata": "application/xml",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    },
                    {
                        "createdOn": 1748436598785,
                        "updatedOn": 1749033787000,
                        "file": "Справка (XML  или PDF), закодированная  в формате BASE64",
                        "name": "epgu_2ndfl_20200428_a70844e3-892a-11ea-9715-001a4a1662e8.pdf",
                        "metadata": "application/pdf",
                        "sign": "Файл p7s-подписи к файлу, переданному в параметре file, закодированный в BASE64"
                    }
                ]
            }
        ],
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080002695",
        "id": "210e6898-de2c-473b-b720-0ab5277b831c",
        "version": 1,
        "createdOn": 1743773013162,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1743773013162,
        "validateDateDoc": 1743773013160,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "MksRequestErrorEnum.ndfl.not.found",
        "year": "2023",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080044535",
        "year": "2022",
        "requestId": "110001465011"
    }
]

Пример ответа - Данные отсутствуют

[
    {
        "oid": "2080086398",
        "id": "a7992891-49d3-4801-a5d6-b68c7472b21b",
        "version": 1,
        "createdOn": 1748582060431,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1748582060431,
        "validateDateDoc": 1748582060425,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "ndflNotFound",
        "year": "2022",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080086398",
        "id": "a7992891-49d3-4801-a5d6-b68c7472b22b",
        "version": 1,
        "createdOn": 1748582060431,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1748582060431,
        "validateDateDoc": 1748582060425,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "ndflNotFound",
        "year": "2023",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080086398",
        "id": "a7992891-49d3-4801-a5d6-b68c7472b23b",
        "version": 1,
        "createdOn": 1748582060431,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1748582060431,
        "validateDateDoc": 1748582060425,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "ndflNotFound",
        "year": "2024",
        "type": "INCOME_REFERENCE"
    }
]

Пример ответа - Запрос сведений в ФНС
[
    {
        "oid": "2080086398",
        "year": "2024",
        "requestId": "110000952748"
    },
    {
        "oid": "2080086398",
        "year": "2023",
        "requestId": "110000952746"
    },
    {
        "oid": "2080086398",
        "year": "2022",
        "requestId": "110000952747"
    }
]
Пример ответа - Ошибка при запросе в СМЭВ3

[
    {
        "oid": "2080086398",
        "id": "210e6898-de2c-473b-b720-0ab5277b831c",
        "version": 1,
        "createdOn": 1743773013162,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1743773013162,
        "validateDateDoc": 1743773013160,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "MksRequestErrorEnum.ndfl.not.found",
        "year": "2022",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080086398",
        "id": "210e6898-de2c-473b-b720-0ab5277b832c",
        "version": 1,
        "createdOn": 1743773013162,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1743773013162,
        "validateDateDoc": 1743773013160,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "MksRequestErrorEnum.ndfl.not.found",
        "year": "2023",
        "type": "INCOME_REFERENCE"
    },
    {
        "oid": "2080086398",
        "id": "210e6898-de2c-473b-b720-0ab5277b833c",
        "version": 1,
        "createdOn": 1743773013162,
        "updatedOn": 1749033787000,
        "receiptDocDate": 1743773013162,
        "validateDateDoc": 1743773013160,
        "relevance": "actual",
        "status": "verified_by_request",
        "departmentDoc": "Федеральная налоговая служба",
        "error": "MksRequestErrorEnum.ndfl.not.found",
        "year": "2024",
        "type": "INCOME_REFERENCE"
    }
]


Тестирование

Также для сведений реализована возможность получения предопределенных, тестовых ответов, «заглушек» в интеграционной среде ЕСИА и ЦП (https://esia-portal1.test.gosuslugi.ru/). Для того, чтобы при вызове метода возвращались тестовые данные, необходимо дополнительно указывать в запросе параметр test={id}, где id – порядковый номер тестового ответа для конкретного сведения
Curl

--location 'https://esia-portal1.test.gosuslugi.ru/digital/api/public/v1/pso/2181502158/doc/INCOME_REFERENCE?test=1'

--header 'Authorization: Bearer token'


Параметр Описание
 ?test=1  Справка по гражданину, который работал в ЮЛ и у ФЛ
Авторизуйтесь, чтобы оставить комментарий к статье