Налоги ФЛ 图标

Nalogi FL 纳税人账户数据 API

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

Налоги ФЛ(Nalogi FL)是俄罗斯联邦税务局(ФНС России)为个人纳税人推出的官方移动个人账户。它是 FNS 个人纳税人网页账户的手机版,用户可用 Gosuslugi(ESIA)账号或 INN 登录。首页 Taxes 界面展示俄罗斯自 2023 年起实行的统一税收账户(ENS),包括当前余额以及溢缴或欠税。在 Debts 界面,一笔欠税可以直接生成缴款文书;Claims 清单与账户历史时间线则记录税务机关的追缴与入账。Incomes 界面汇集雇主开具的 2-NDFL 收入证明,并可下载为 PDF。My Property 列出作为不动产税、土地税与交通税计税依据的公寓、地块与车辆。Deductions 目录涵盖社会、不动产、IIS 与慈善扣除,并提供简化的 3-NDFL 申报。预约向导可在当地税务局订好面谈时段,并生成 PDF 预约票。此外还有行政罚款、为退税与自动缴款登记的银行账户,以及可设置密语的个人资料页。它面向全俄罗斯缴纳个人所得税、不动产税或交通税的个人。FNS 还为其他群体另设应用:面向自雇人士的 Мой налог,以及面向自动化简化税制的 АУСН。Gosuslugi、Сбербанк Онлайн 与 Т-Банк 也内置缴税服务,可凭 INN 缴税而无需打开账户。

统一税收账户(ENS)余额位于每位纳税人 FNS 记录的最上层。ensBalance、accrualsAmountAll、overpayment 与 ensArrears 在一张快照里给出纳税人的整体状况。快照之下是欠税行、追缴清单(taxClaims)与操作台账(historyOperations)。其中每一行都带有预算分类代码 kbk、市政区划代码 oktmo 与缴款识别号 uin,以及 accrualAmount、taxName 与 year。

纳税人卡片补充 inn、snils、全名、birthDate、citizenship,以及 email 与 phone 联系方式。每张雇主开具的 2-NDFL 收入证明按 year 提供 employerInn、income 与 taxBase。不动产登记对象带有 objectType、cadastralNumber、cadastralCost、address 与 regionCode。税收扣除给出 deductionType、deductionAmount 与尚未用完的 remainder。行政罚款附带 protocol 与 decisionDate。已登记的退税账户保存 accountNumber、bik 与 bankName。稽查员预约记录 appointmentDate、appointmentTime 与税务局代码 ifns。

记账机器人把快照与逐税种的 kbk/oktmo/uin 行送入中小企业薪酬与 ERP 系统,无需打开账户即可把 FNS 追缴与已入账缴款对账。借贷方用纳税人卡片加不动产登记对象建立 KYC 档案,作为纸质 2-NDFL 材料包的第一方替代。按揭部门把雇主 2-NDFL 收入证明及其 PDF 附入信贷档案。退税部门把溢缴款退回纳税人已在 FNS 登记的卢布账户。openData Studio 把这些账户数据变成可调用的开放数据,供这些集成使用。

应用截图

  • Налоги ФЛ 应用截图 1
  • Налоги ФЛ 应用截图 2
  • Налоги ФЛ 应用截图 3
  • Налоги ФЛ 应用截图 4
  • Налоги ФЛ 应用截图 5
  • Налоги ФЛ 应用截图 6

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"
    }
  • 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
    }
  • 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
        }
      ]
    }
  • 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"
        }
      ]
    }
  • 纳税人收入数据 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"
    }
  • 在册俄罗斯银行账户

    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
        }
      ]
    }
  • 稽查员预约时段

    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"
        }
      ]
    }
  • 行政罚款

    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"
        }
      ]
    }

数据类别

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

数据使用场景与案例

  • 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 或护照查询个人税款与欠费,并跳转缴费。

相关主题

  • Nalogi FL API
  • FNS 纳税人账户
  • ENS 统一税收账户
  • 2-NDFL 收入证明清单
  • 俄罗斯税务欠税
  • INN SNILS 纳税人资料
  • 不动产登记对象
  • 稽查员预约时段

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

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

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

获取报价