Nalogi FL 纳税人账户数据 API

ФНС России · 身份

Налоги ФЛ 是俄罗斯联邦税务局面向个人的纳税人账户——纳税人个人中心的移动对应物，可通过 Gosuslugi（ESIA）登录或 INN 账号登录。俄罗斯人在这里查看自己的欠税与收入：统一税收账户、不动产税与交通税、收入证明、税收扣除，以及与当地税务稽查局的预约。

作为数据源，该账户开放已登录纳税人的台账与身份：统一账户由 ensBalance、ensArrears 与 overpayment 描述；每笔未清款项携带 kbk、oktmo 与 uin；资料卡片带来 inn、snils 与 birthDate；收入证明则补充 employerInn 与 taxBase。薪酬与 ERP 机器人把这些字段与已入账缴款对账，借贷方据此填充 KYC 档案，退税部门把溢缴路由到已登记账户。

Nalogi FL（Налоги ФЛ）是俄罗斯联邦税务局面向个人纳税人的官方移动账户，可通过 Gosuslugi（ESIA）或 INN 加密码登录。它服务俄罗斯所有缴纳收入税、不动产税或交通税的劳动人口，集中呈现统一税收账户（ENS）余额、欠税与应缴款项、雇主开具的 2-NDFL 收入证明、不动产登记、已登记银行账户、税收扣除与稽查员预约时段。对集成方而言，它是纳税人身份、负债与收入数据的第一方来源：记账系统据已入账缴款核对计提，借贷方预填 KYC 档案，退税部门把溢缴退回纳税人已登记的账户。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

签发 OAuth 令牌
POST /v1/oauth/token opendata
签发 OAuth2 access 与 refresh 令牌，账户把它们作为 Bearer 凭证附加到之后每一个纳税人、税收账户与预约调用。
认证方式：移动客户端的 OAuth2 客户端凭证（password 或 refresh_token 授权）。返回的 access_token 在后续账户调用中以 Authorization: Bearer 附加；Cookie 会话还携带 CSRF 令牌头。
- access_token
- refresh_token
- tokenType
- grant_type
- client_id
```
POST /v1/oauth/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=password&client_id=mobile-client&username=770000000000&password=******
```
```
{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "refresh_token": "def50200...",
  "tokenType": "Bearer",
  "grant_type": "password"
}
```
- 依据应用的登录与令牌刷新流程重建
- 字段名称与会话启动模型一致

纳税人个人资料

GET /v1/taxpayer/profile osint

返回已登录个人的纳税人卡片——INN、SNILS、姓名、出生日期、联系方式与国籍——供 Profile 与个人信息界面渲染。

认证方式： OAuth 令牌调用签发的 Bearer access token；可选 CSRF 令牌头。

inn
snils
lastName
firstName
middleName
patronymic
fullName
birthDate
email
phone
gender
citizenship
taxpayerId
isReadOnly
avatar

GET /v1/taxpayer/profile HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "inn": "770000000000",
  "snils": "000-000-000 00",
  "lastName": "Иванов",
  "firstName": "Иван",
  "middleName": "Иванович",
  "patronymic": "Иванович",
  "fullName": "Иванов Иван Иванович",
  "birthDate": "1985-03-12",
  "email": "[email protected]",
  "phone": "+79001234567",
  "gender": "M",
  "citizenship": "RU",
  "taxpayerId": "fl-770000000000",
  "isReadOnly": false,
  "avatar": null
}

依据资料界面的渲染模型重建
线上字段名称与个人信息表单一致

纳税人信息 v2

GET /v1/account/overview osint

加载登录后使用的账户信封，用于门控资料编辑、密语标志与联系渠道。

认证方式： OAuth 令牌调用签发的 Bearer access token。

inn
kpp
snils
fullName
email
phone
codeWord
isReadOnly

GET /v1/account/overview HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "inn": "770000000000",
  "kpp": "",
  "snils": "000-000-000 00",
  "fullName": "Иванов Иван Иванович",
  "email": "[email protected]",
  "phone": "+79001234567",
  "codeWord": false,
  "isReadOnly": false
}

依据登录后的启动序列重建

ENS 统一税收账户
GET /v1/tax-account/summary openbanking
读取首页 Taxes 界面展示的统一税收账户（ENS）快照——当前余额、计提总额、溢缴与欠税。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- ensBalance
- accrualsAmountAll
- amountAll
- overpayment
- accrualAmount
- ensArrears
- snu
```
GET /v1/tax-account/summary HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "ensBalance": 12540.50,
  "accrualsAmountAll": 18700.00,
  "amountAll": 18700.00,
  "overpayment": 0.00,
  "accrualAmount": 18700.00,
  "ensArrears": 6160.00,
  "snu": "7700"
}
```
- 依据首页 Taxes 界面的数据加载重建
- 金额字段与余额组件一致

ENS 欠税 v2

GET /v1/tax-account/arrears openbanking

按税种、KBK、OKTMO 与 UIN 列出统一账户的未清欠税，使 Debts 界面可以驱动缴款文书。

认证方式： OAuth 令牌调用签发的 Bearer access token。

arrears
taxCode
taxName
kbk
oktmo
uin
accrualAmount
year
ensArrears

GET /v1/tax-account/arrears HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "arrears": [
    {
      "taxCode": "2010201",
      "taxName": "Транспортный налог",
      "kbk": "18210604012021000110",
      "oktmo": "45348000",
      "uin": "18207725000000000001",
      "accrualAmount": 4200.00,
      "year": 2025
    }
  ],
  "ensArrears": 6160.00
}

依据 Debts 界面及其缴款文书交接重建

ENS 税务追缴

GET /v1/tax-account/claims openfinance

返回计入统一账户的税务机关追缴款项——Payments 与 Claims 界面分页浏览的追缴清单。

认证方式： OAuth 令牌调用签发的 Bearer access token。

taxClaims
snu
kbk
oktmo
uin
accrualAmount
year

GET /v1/tax-account/claims HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "taxClaims": [
    {
      "snu": "7700",
      "kbk": "18210604012021000110",
      "oktmo": "45348000",
      "uin": "18207725000000000001",
      "accrualAmount": 4200.00,
      "year": 2025
    }
  ]
}

依据 Claims 清单分页重建

ENS 操作历史

GET /v1/tax-account/history openbanking

分页返回统一账户的计提与抵销台账，支撑账户历史时间线。

认证方式： OAuth 令牌调用签发的 Bearer access token。

historyOperations
kbk
oktmo
uin
accrualAmount
year
taxName

GET /v1/tax-account/history HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "historyOperations": [
    {
      "kbk": "18210604012021000110",
      "oktmo": "45348000",
      "uin": "18207725000000000002",
      "accrualAmount": 4200.00,
      "year": 2025,
      "taxName": "Транспортный налог"
    }
  ]
}

依据账户历史时间线及其筛选器重建

2-NDFL 证明清单
GET /v1/income/certificates opendata
按年份、雇主 INN 与税基列出雇主开具的 2-NDFL 收入证明；配套文书接口提供证明 PDF。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- year
- employerInn
- taxBase
- income
- declarationId
- certificate
```
GET /v1/income/certificates HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "certificates": [
    {
      "year": 2024,
      "employerInn": "7707083893",
      "taxBase": 980000.00,
      "income": 980000.00,
      "declarationId": "2ndfl-2024-01"
    }
  ]
}
```
- 依据 Incomes 界面的证明清单与下载动作重建
纳税人收入数据 v2
GET /v1/income/summary opendata
返回汇总收入记录（工资、存款、保险税），为 Incomes 与累进税率公式界面供数。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- year
- income
- taxBase
- employerInn
- declarationId
```
GET /v1/income/summary HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "year": 2024,
  "income": 980000.00,
  "taxBase": 980000.00,
  "employerInn": "7707083893",
  "declarationId": "inc-2024"
}
```
- 依据 Incomes 各界面展示的收入汇总重建
在册俄罗斯银行账户
GET /v1/banking/accounts openbanking
列出纳税人在 FNS 登记的俄罗斯卢布账户（账号、BIK、银行名称、可选别名），用于退税与自动缴款。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- accountNumber
- bik
- bankName
- cardId
- pseudonym
```
GET /v1/banking/accounts HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "accounts": [
    {
      "accountNumber": "40817810100000000001",
      "bik": "044525225",
      "bankName": "ПАО Сбербанк",
      "cardId": "ba-001",
      "pseudonym": "Зарплатная"
    }
  ]
}
```
- 依据退税账户选择器及其表格导出重建
不动产对象分页
GET /v1/property/objects opendata
分页返回绑定到纳税人的不动产登记对象（公寓、土地、车辆）——驱动不动产税、土地税与交通税计提的对象。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- propertyObjects
- objectType
- cadastralNumber
- cadastralCost
- address
- regionCode
- taxBase
```
GET /v1/property/objects HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "propertyObjects": [
    {
      "objectType": "FLAT",
      "cadastralNumber": "77:01:0001001:1001",
      "cadastralCost": 8500000.00,
      "address": "г. Москва, ул. Тверская, д. 1",
      "regionCode": "77",
      "taxBase": 8500000.00
    }
  ]
}
```
- 依据 My Property 界面的分页对象清单重建

稽查员预约时段

GET /v1/appointments/slots opendata

返回所选税务局与服务下可预订的稽查员时段；单独的预订调用确认时段，文书接口提供预约票 PDF。

认证方式： OAuth 令牌调用签发的 Bearer access token。

appointmentNumber
appointmentDate
appointmentTime
ifns
torm
serviceId

GET /v1/appointments/slots?office=7700&department=7701&serviceId=consult HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json

{
  "slots": [
    {
      "appointmentNumber": "A-7700-20260929-14",
      "appointmentDate": "2026-10-03",
      "appointmentTime": "14:00",
      "ifns": "7700",
      "torm": "7701",
      "serviceId": "consult"
    }
  ]
}

依据预约向导的税务局/服务/时段选择器重建

税收扣除目录
GET /v1/deductions openfinance
列出社会、不动产、IIS 与慈善扣除及剩余额度；简化的 3-NDFL 申报挂载在同一目录上。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- deductionType
- deductionAmount
- remainder
- year
- declarationId
```
GET /v1/deductions HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "deductions": [
    {
      "deductionType": "PROPERTY",
      "deductionAmount": 260000.00,
      "remainder": 180000.00,
      "year": 2024,
      "declarationId": "3ndfl-2024"
    }
  ]
}
```
- 依据 Deductions 目录与简化 3-NDFL 申报流程重建
行政罚款
GET /v1/fines opendata
返回 Fines 界面展示的行政违法罚款（决定书编号、决定日期、金额、UIN），另有详情调用提供单笔罚款的附加信息。
认证方式： OAuth 令牌调用签发的 Bearer access token。
- administrativeFines
- protocol
- decisionDate
- accrualAmount
- uin
- kbk
```
GET /v1/fines HTTP/1.1
Authorization: Bearer eyJhbGciOiJSUzI1NiIs...
Accept: application/json
```
```
{
  "administrativeFines": [
    {
      "protocol": "00АА000000",
      "decisionDate": "2026-02-11",
      "accrualAmount": 500.00,
      "uin": "18207725000000000999",
      "kbk": "18211601000010000140"
    }
  ]
}
```
- 依据 Fines 界面及其单笔罚款详情视图重建

数据类别

纳税人资料
统一税收账户
欠税
税务追缴
收入证明
银行账户
不动产登记
税收扣除
稽查员预约
行政罚款

数据使用场景与案例

ENS 欠税与 ERP 对账
记账机器人拉取统一账户快照中的 ensBalance 与 overpayment，再分页读取欠税 feed 中逐税种的 kbk/oktmo/uin 行，使中小企业薪酬系统无需打开账户即可把 FNS 追缴与已入账缴款核对。
基于纳税人卡片的借贷 KYC
借贷方从纳税人资料调用中填充 INN、SNILS、FIO 与 birthDate，并叠加不动产登记对象（cadastralNumber、cadastralCost、address），作为纸质 2-NDFL 材料包的第一方替代。
按揭档案的收入证明采集
按揭部门列出收入证明 feed（year、employerInn、taxBase、income），并跟随配套的 PDF 下载，把雇主开具的 2-NDFL 收入证明附加到信贷档案。
经登记银行账户路由退税
退税部门读取已登记账户清单中的 accountNumber、bik 与 bankName，使溢缴退回到纳税人已在 FNS 登记的同一卢布账户。

常见问题

Nalogi FL 如何认证纳税人？

客户端在 POST /v1/oauth/token 以移动 client_id 请求 OAuth2 access_token——INN 登录后走 password 授权，或经 ESIA/Gosuslugi 中转登录。后续账户调用发送 Authorization: Bearer，并附带可选的 CSRF 令牌头。

哪个接口返回统一税收账户余额？

GET /v1/tax-account/summary 返回已登录 INN 的 ensBalance、accrualsAmountAll、overpayment 与 ensArrears。随后 GET /v1/tax-account/arrears 逐行列出未清款项，含 taxCode、kbk、oktmo、uin 与 accrualAmount。

我可以列出 2-NDFL 证明与不动产对象吗？

可以。GET /v1/income/certificates 返回每张证明的 year、employerInn、taxBase 与 income，GET /v1/property/objects 分页返回 cadastralNumber、cadastralCost、address 与 objectType。

稽查员预约如何预订？

预约 API 先解析税务局、部门与服务，然后 GET /v1/appointments/slots 返回含 appointmentDate 与 appointmentTime 的空闲时段；预订调用确认时段，文书接口提供预约票 PDF。

与 Налоги ФЛ 相似的应用

Мой налог — 俄罗斯联邦税务局面向自雇人士的官方应用，适用职业收入税：登记自雇身份、开具收款凭证，并按 4-6% 税率自动计税，无需申报。
АУСН ФНС России — 俄罗斯联邦税务局针对自动化简化税制（АУСН）的官方应用：由税务机关依据银行与收银数据直接算税，纳税人无需自行申报。
Госуслуги — 俄罗斯国家服务门户应用，其官方帮助中心提供按 INN 查询并缴纳个人欠税的指引；Налоги ФЛ 本身也通过 Gosuslugi（ESIA）账号登录。
Сбербанк Онлайн — 俄罗斯联邦储蓄银行的手机银行内置 FNS 缴税服务，可按 INN 或文书编号查询并缴纳个人税款，无需打开纳税人账户。
Т-Банк — T-Bank 支持客户在应用内直接缴税，并发布指引说明统一税收账户（ENS）如何改变俄罗斯人的缴税方式。
РосНалог — RuStore 列为同类替代品的第三方应用，可凭 INN 或护照查询个人税款与欠费，并跳转缴费。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Nalogi FL 纳税人账户数据 API

应用截图

API 端点一览

签发 OAuth 令牌

纳税人个人资料

纳税人信息 v2

ENS 统一税收账户

ENS 欠税 v2

ENS 税务追缴

ENS 操作历史

2-NDFL 证明清单

纳税人收入数据 v2

在册俄罗斯银行账户

不动产对象分页

稽查员预约时段

税收扣除目录

行政罚款

数据类别

数据使用场景与案例

ENS 欠税与 ERP 对账

基于纳税人卡片的借贷 KYC

按揭档案的收入证明采集

经登记银行账户路由退税

常见问题

与 Налоги ФЛ 相似的应用

更多身份类应用

Microsoft Authenticator

Pak Identity

相关主题

需要集成这个 App 的数据 API？

Nalogi FL 纳税人账户数据 API

应用截图

API 端点一览

签发 OAuth 令牌

纳税人个人资料

纳税人信息 v2

ENS 统一税收账户

ENS 欠税 v2

ENS 税务追缴

ENS 操作历史

2-NDFL 证明清单

纳税人收入数据 v2

在册俄罗斯银行账户

不动产对象分页

稽查员预约时段

税收扣除目录

行政罚款

数据类别

数据使用场景与案例

ENS 欠税与 ERP 对账

基于纳税人卡片的借贷 KYC

按揭档案的收入证明采集

经登记银行账户路由退税

常见问题

相关应用

与 Налоги ФЛ 相似的应用

更多身份类应用

Microsoft Authenticator

Pak Identity

相关主题

需要集成这个 App 的数据 API？