Квартплата+ ELS 账单、EPD 与抄表数据 API
Квартплата+ оплата ЖКХ онлайн 是 Квартплата+ 推出的家庭账单缴费应用,面向在俄罗斯管理住房和公用事业(ЖКХ)费用的居民。用户可以按街道地址或统一个人账户号(ЕЛС)查找账单,提交水表、电表和热能表读数,缴纳幼儿园费用,还能直接扫描纸质缴费单(квитанция,kvitantsiya)上的二维码,省去手工输入收款信息。合并结算让家庭可以把多笔费用一次付清,支持已绑定银行卡以及 Google Pay / Apple Pay 付款,缴费记录与收据则帮助用户核对哪些费用已经付过。这款俄语应用在 Google Play 上评分 4.6,约有 16.1 万条评价,面向希望用一款专门应用取代银行账单支付或各家公用事业供应商单独应用的家庭。
ELS 账户下的供应商费用把 elsAccount 和 addressId 与 paymentId、providerName、period 和 amount 关联起来。统一缴费单(EPD)汇总表在此基础上增加 DEBT、PaymentUin 和 accrualBanStatus,供应商身份则由 inn 与 recipient 标明。物业管理后台可以借助这些关系,把家庭账单与供应商账户逐一匹配,并把欠款与当期费用分开。
表计记录把 counterId、serialNumber 和 unit 与 prevValue、newIndication 和 indicationDate 对应起来;确认 status 与历史读数支撑抄表台的对账工作。缴费二维码中的详情为租户入驻工具提供 ls、PaymentUin 和应付 amount,无需依赖手工录入账户。
结算篮子把 selectedPaymentIdList 与 payToken、addressAmount、commissionSum、paymentsCommissionSum 和 minSum 关联在一起。结合 withoutCommission 与最终产生的 operationId,这些字段让缴费对账人员能够比对手续费合计、结算状态和收据引用。openData Studio 把这套家庭账单、表计与支付数据变成可调用的开放数据,供上述集成使用。
应用截图
API 端点一览
以下端点与请求/响应示例均依据应用界面推导重构,为示意说明,并非实际抓包。
发送登录验证码
POST
/v1/access/sms-challengesosint向已登记的手机发送一次性短信验证码,以便下一次调用换取会话。
认证方式: 无需鉴权。手机号会收到用于建立会话的短信验证码。
- phone
- telephoneNumber
- deviceId
- clientVersion
- locale
- otpId
- otpTimeout
- status
- success
POST /v1/access/sms-challenges HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Application-Id: <example-application-id> { "phone": "<example-phone>", "telephoneNumber": "<example-phone>", "deviceId": "<example-device-id>", "clientVersion": "1.0-example", "locale": "ru" }{ "success": true, "otpId": "otp-example-01", "otpTimeout": 60, "phone": "<example-phone>", "status": "SENT" }确认验证码并建立会话
POST
/v1/access/verified-sessionsosint用短信验证码换取会话令牌,该令牌控制 ELS 查询、EPD、表计和结算相关调用。
认证方式: 本次调用无需鉴权。phone 加上 otp 和 otpId 可换得后续调用使用的 token / userAccountToken。
- phone
- otp
- otpId
- deviceId
- token
- userAccountToken
- userId
- userPhone
- fio
- sessionTimeout
- success
POST /v1/access/verified-sessions HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example { "phone": "<example-phone>", "otp": "<example-otp>", "otpId": "otp-example-01", "deviceId": "<example-device-id>" }{ "success": true, "token": "<example-session-token>", "userAccountToken": "<example-account-token>", "userId": "user-example-01", "userPhone": "<example-phone>", "fio": "Пример Пользователя", "sessionTimeout": 3600 }按 ELS 查询账单
POST
/v1/household-bills/account-lookupopendata按统一个人账户 ELS(единый лицевой счёт)查询可缴纳的 ЖКХ 账单,并返回各供应商的 amount、period 和个人账户号 ls。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- elsAccount
- els
- city
- region
- address
- payments
- paymentId
- providerName
- serviceType
- period
- amount
- commission
- ls
- identifier
- categoryId
- DEBT
- PaymentUin
- total
- success
POST /v1/household-bills/account-lookup HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Application-Id: <example-application-id> X-Client-Sign: <example-signature> { "elsAccount": "ELS-EXAMPLE-01", "els": "ELS-EXAMPLE-01", "city": "Москва", "region": "Москва" }{ "success": true, "elsAccount": "ELS-EXAMPLE-01", "address": "ул. Тверская, д. 7, кв. 12", "payments": [ { "paymentId": "invoice-example-01", "providerName": "Example Utility", "serviceType": "heating", "period": "2026-09", "amount": 4520.35, "commission": 0, "ls": "account-example-01", "identifier": "ELS-EXAMPLE-01", "categoryId": "heat", "DEBT": 0, "PaymentUin": null } ], "total": 1 }按地址查询账单
GET
/v1/household-bills/location-lookupopendata当缴费人按地址而非 ELS 查询时,把城市、街道、门牌和房号解析为该家庭的账单。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- city
- street
- house
- flat
- apartment
- postalCode
- addressId
- elsAccount
- payments
- paymentId
- providerName
- amount
- period
- ls
- success
GET /v1/household-bills/location-lookup?city=%D0%9C%D0%BE%D1%81%D0%BA%D0%B2%D0%B0&street=%D0%A2%D0%B2%D0%B5%D1%80%D1%81%D0%BA%D0%B0%D1%8F&house=7&flat=12&apartment=12 HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "addressId": "address-example-01", "city": "Москва", "street": "Тверская", "house": "7", "flat": "12", "apartment": "12", "postalCode": "125009", "elsAccount": "ELS-EXAMPLE-01", "payments": [ { "paymentId": "invoice-example-01", "providerName": "Example Utility", "amount": 4520.35, "period": "2026-09", "ls": "account-example-01" } ] }读取统一 EPD 费用
GET
/v1/household-bills/consolidated-statementopendata返回家庭的统一缴费单(ЕПД):周期合计、欠款、禁止计费标志和各供应商行项目。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- elsAccount
- addressId
- period
- amount
- DEBT
- accrualBanStatus
- banOnAccrual
- items
- paymentId
- providerName
- serviceType
- PaymentUin
- orgInfo
- inn
- recipient
- success
GET /v1/household-bills/consolidated-statement?elsAccount=ELS-EXAMPLE-01&addressId=address-example-01 HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "elsAccount": "ELS-EXAMPLE-01", "addressId": "address-example-01", "period": "2026-09", "amount": 12840.50, "DEBT": 0, "accrualBanStatus": false, "banOnAccrual": false, "items": [ { "paymentId": "invoice-example-01", "providerName": "Example Utility", "serviceType": "heating", "amount": 4520.35, "PaymentUin": "0", "orgInfo": { "inn": "0000000000", "recipient": "Example Utility" } } ] }供应商机构信息列表
GET
/v1/household-bills/suppliersopendata列出与该地址关联的住房服务供应商,含 INN、收款方名称和个人账户号 ls。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- items
- orgInfo
- inn
- recipient
- providerName
- categoryId
- serviceType
- ls
- success
GET /v1/household-bills/suppliers?addressId=address-example-01 HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "items": [ { "orgInfo": { "inn": "0000000000", "recipient": "Example Utility", "providerName": "Example Utility" }, "categoryId": "heat", "serviceType": "heating", "ls": "account-example-01" } ] }按地址列出表计
GET
/v1/household-meters/locations/:addressIdopendata返回该地址的全部表计,含类型、序列号、单位和最近一次已受理读数。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- addressId
- counters
- counterId
- counterType
- serialNumber
- unit
- prevValue
- prevIndication
- indicationDate
- groupId
- groupName
- success
GET /v1/household-meters/locations/address-example-01 HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "addressId": "address-example-01", "counters": [ { "counterId": "meter-water-example", "counterType": "coldWater", "serialNumber": "serial-water-example", "unit": "m3", "prevValue": 112.3, "prevIndication": 112.3, "indicationDate": "2026-08-25", "groupId": "water", "groupName": "Вода" }, { "counterId": "meter-power-example", "counterType": "electricity", "serialNumber": "serial-power-example", "unit": "kWh", "prevValue": 5401, "indicationDate": "2026-08-25" } ] }提交表计读数
POST
/v1/household-meters/reading-batchesopendata提交家庭当期的水、电、热表计读数。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- addressId
- indicationDate
- indications
- counterId
- newIndication
- prevValue
- unit
- status
- currentIndications
- success
POST /v1/household-meters/reading-batches HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature> { "addressId": "address-example-01", "indicationDate": "2026-09-25", "indications": [ { "counterId": "meter-water-example", "newIndication": 118.7, "prevValue": 112.3, "unit": "m3" } ] }{ "success": true, "status": "ACCEPTED", "indicationDate": "2026-09-25", "currentIndications": [ { "counterId": "meter-water-example", "newIndication": 118.7, "status": "CONFIRMED" } ] }表计读数历史
GET
/v1/household-meters/reading-recordsopendata分页返回某只表计此前已受理的读数,方便家庭回看已提交的内容。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- counterId
- serialNumber
- items
- indicationDate
- newIndication
- prevValue
- status
- success
GET /v1/household-meters/reading-records?addressId=address-example-01&counterId=meter-water-example HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "counterId": "meter-water-example", "serialNumber": "serial-water-example", "items": [ { "indicationDate": "2026-09-25", "newIndication": 118.7, "prevValue": 112.3, "status": "CONFIRMED" }, { "indicationDate": "2026-08-25", "newIndication": 112.3, "prevValue": 107.1, "status": "CONFIRMED" } ] }准备合并结算
POST
/v1/bill-checkouts/basketsopenfinance构建多账单结算篮子,生成 payToken,并返回手续费合计与最低可付金额。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- addressId
- selectedPaymentIdList
- kindergarten
- payToken
- groupId
- addressAmount
- commissionSum
- allCommissionSum
- paymentsCommissionSum
- minSum
- withoutCommission
- success
POST /v1/bill-checkouts/baskets HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature> { "addressId": "address-example-01", "selectedPaymentIdList": ["invoice-example-01", "invoice-example-02"], "kindergarten": false }{ "success": true, "payToken": "basket-example-01", "groupId": "group-example-01", "addressAmount": 8730.80, "commissionSum": 0, "allCommissionSum": 0, "paymentsCommissionSum": 0, "minSum": 1, "withoutCommission": true, "selectedPaymentIdList": ["invoice-example-01", "invoice-example-02"] }银行卡支付
POST
/v1/bill-checkouts/card-settlementsopenfinance用所选已绑定银行卡为已准备好的篮子扣款,并返回用于获取收据的操作 ID。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- payToken
- cardId
- amount
- commissionSum
- binding
- operationId
- status
- receipt
- success
POST /v1/bill-checkouts/card-settlements HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature> { "payToken": "basket-example-01", "cardId": "card-example-01", "amount": 8730.80, "commissionSum": 0, "binding": true }{ "success": true, "operationId": "settlement-example-01", "status": "PAID", "amount": 8730.80, "commissionSum": 0, "payToken": "basket-example-01", "receipt": true }使用 Google Pay / Apple Pay 支付
POST
/v1/bill-checkouts/wallet-settlementsopenfinance使用 3DS 加密凭证和已配置的商户标识,通过 Google Pay 或 Apple Pay 完成已准备好的篮子。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- payToken
- googlePay
- applePay
- CRYPTOGRAM_3DS
- merchantId
- gatewayMerchantId
- amount
- operationId
- xPayStatus
- status
- success
POST /v1/bill-checkouts/wallet-settlements HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature> { "payToken": "basket-example-01", "googlePay": true, "applePay": false, "CRYPTOGRAM_3DS": "<example-wallet-cryptogram>", "merchantId": "<example-merchant-id>", "gatewayMerchantId": "<example-merchant-id>", "amount": 8730.80 }{ "success": true, "operationId": "settlement-example-02", "xPayStatus": "PAID", "status": "PAID", "amount": 8730.80, "payToken": "basket-example-01" }支付操作列表
GET
/v1/bill-ledger/entriesopenfinance分页返回家庭已完成和处理中的账单支付,含金额、周期和供应商。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- page
- limit
- total
- hasMore
- items
- operationId
- status
- amount
- commissionSum
- period
- providerName
- elsAccount
- date
- success
GET /v1/bill-ledger/entries?page=0&limit=20 HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "page": 0, "limit": 20, "total": 2, "hasMore": false, "items": [ { "operationId": "settlement-example-01", "status": "PAID", "amount": 8730.80, "commissionSum": 0, "period": "2026-09", "providerName": "Example Utility", "elsAccount": "ELS-EXAMPLE-01", "date": "2026-09-26T10:14:00+03:00" } ] }获取操作收据
GET
/v1/bill-ledger/entries/:operationId/proofopenfinance返回单笔操作已付款的缴费单(kvitantsiya)收据,包括 PDF 文档引用和 UIN。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- operationId
- receipt
- amount
- commissionSum
- period
- elsAccount
- providerName
- PaymentUin
- url
- success
GET /v1/bill-ledger/entries/settlement-example-01/proof HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "operationId": "settlement-example-01", "receipt": true, "amount": 8730.8, "commissionSum": 0, "period": "2026-09", "elsAccount": "ELS-EXAMPLE-01", "providerName": "Example Utility", "PaymentUin": "0", "url": "/v1/bill-documents/settlement-example-01/receipt.pdf" }已绑定银行卡列表
GET
/v1/bill-checkouts/saved-instrumentsopenfinance列出家庭已绑定、可用于 ЖКХ 一键结算的银行卡。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- cards
- cardId
- binding
- isDefault
- title
- success
GET /v1/bill-checkouts/saved-instruments HTTP/1.1 X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature>{ "success": true, "cards": [ { "cardId": "card-example-01", "binding": true, "isDefault": true, "title": "Visa •• 4412" } ] }解析缴费二维码
POST
/v1/bill-imports/qr-detailsopendata把纸质缴费单(kvitantsiya)或 ГИБДД 二维码解码为供应商、金额、UIN 和个人账户字段,可直接用于结算。
认证方式: 手机验证码会话,使用 token / userAccountToken,并带有签名的客户端请求头 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。
- qr
- providerName
- recipient
- inn
- amount
- PaymentUin
- period
- ls
- success
POST /v1/bill-imports/qr-details HTTP/1.1 Content-Type: application/json X-Device-Id: <example-device-id> X-Client-Version: 1.0-example X-Client-Sign: <example-signature> { "qr": "ST00012|Name=Example Utility|PersonalAcc=EXAMPLE|BankName=Example Bank|BIC=EXAMPLE|PayeeINN=0000000000|Sum=452035|Purpose=Отопление 09.2026" }{ "success": true, "qr": "ST00012|...", "providerName": "Example Utility", "recipient": "Example Utility", "inn": "0000000000", "amount": 4520.35, "PaymentUin": "0", "period": "2026-09", "ls": "account-example-01" }
数据类别
- 公用事业账单
- ELS 统一个人账户
- EPD 统一缴费单费用
- 表计读数
- 支付
- 已绑定银行卡
- 收据
- 地址
数据使用场景与案例
物业管理方的 ЖКХ 对账
住房运营后台每晚拉取 ELS 账单与统一 EPD 行项目(amount、period、PaymentUin、DEBT),并与楼宇的供应商合同及个人账户 ls 编号进行匹配。
抄表台读数录入
抄表台按 counterId 读取 serialNumber、prevValue 和 indicationDate,再提交家庭的 newIndication 批次,让下一个 EPD 周期按实际用量而非定额计费。
缴费手续费审计
支付对账人员监控 payToken 结算篮子(addressAmount、commissionSum、minSum、withoutCommission)以及随后的 operationId 状态,让幼儿园零手续费活动和供应商手续费记入正确的账本。
缴费单二维码入户
租户入驻流程把纸质账单上的二维码解析为 providerName、inn、recipient、amount 和 PaymentUin,再把结果挂到家庭的 addressId 下,而不必手工输入 ELS。
常见问题
家庭公用事业账单与 EPD 账单如何识别?
账单可以通过统一 ELS 号(对应 elsAccount)、城市、街道、门牌与房号来定位,也可以从纸质账单上的缴费二维码中取得 providerName、recipient、inn、amount、PaymentUin、period 和 ls。地址查询会返回 addressId,也可能带出关联的 ELS 账户;供应商账单带有 paymentId、period、amount 和个人账户号 ls。合并后的 EPD 缴费文件再补充账单周期、家庭应付金额和 DEBT,其中 PaymentUin 标识付款引用,orgInfo 包含 inn 与 recipient,accrualBanStatus 或 banOnAccrual 记录对新增计费的限制。租户入驻工具可据二维码字段,在结算前把费用关联到对应的家庭账户。
有哪些表计读数数据?
与地址关联的表计包含 counterId、counterType、serialNumber、unit 和 prevValue。读数提交把 newIndication 与 indicationDate 配对;确认 status 以及已受理读数的历史,可用于和以往账单周期比较。
结算手续费和收据如何关联?
已选账单的篮子带有 payToken、addressAmount、commissionSum、paymentsCommissionSum、minSum 和 withoutCommission。银行卡或移动钱包完成支付后会产生 operationId 和支付状态;对应收据包含 amount、供应商、period 和 PaymentUin。这些关联支撑手续费与结算对账。
这个示意 API 代表哪种认证方式?
手机验证码验证会为家庭会话建立 token 和 userAccountToken。后续请求使用带签名的客户端请求头,包括 X-Device-Id、X-Client-Version、X-Application-Id 和 X-Client-Sign。此处展示的路径、令牌值和文档引用均为示意示例,并非生产环境连接说明。
与 Квартплата+ оплата ЖКХ онлайн 相似的应用
- Госуслуги Дом — Госуслуги Дом 是基于国家住房公用事业信息系统(GIS ЖКХ)的免费应用:用已核验的 Госуслуги 账号登录后会自动载入房产,居民可提交表计读数、缴纳公用事业费、向管理公司发申请、参加业主大会投票并接听对讲。
- Оплата ЖКХ: за газ, свет, воду — Оплата ЖКХ: за газ, свет, воду 是面向全俄的 GIS ЖКХ 缴费应用,可缴燃气、电费和水费、提交表计读数并使用统一个人账户;商店说明写明它不是 GIS 或部委的官方应用。
- Платосфера - оплата ЖКХ — Платосфера 是 Новосибирскэнергосбыт 的住房公用事业缴费应用,用手机号注册后可缴水、热、电等费用,并支持一次结清多个地址的账单。
- Квартплата.Онлайн — Квартплата.Онлайн 是 kvartplata.online 的手机端:可添加多套住房、查看应缴与欠费、在线提交水电表读数,并用俄罗斯发行的 Visa、Mastercard、Maestro 或 Mir 卡缴费。
- Госуслуги — Госуслуги 是俄罗斯数字发展部的电子政务应用,可缴纳罚款和规费、向各部门提交申请,并保存个人证件。
- Мой Мосэнергосбыт — Мой Мосэнергосбыт 是 Мосэнергосбыт 的用户端,覆盖莫斯科地区供电以及 MosOblEIRTS 统一缴费单(ЕПД)上的公用事业费用,并会提醒提交电表读数和缴账单。
- ЖКХ: Личный кабинет — ЖКХ: Личный кабинет 是居民个人账户,可查看计费记录并用二维码或收款方明细缴纳公用事业费;完整功能需管理公司或业主协会接入该应用后才开放。
相关主题
- kvartplata plus 数据 api
- Квартплата+ ЖКХ
- 俄罗斯公用事业账单数据
- ELS 账户查询
- EPD 账单字段
- 家庭表计读数
- 公用事业缴费对账
- 缴费二维码信息
- 公用事业结算手续费
- kvitantsiya 缴费收据
- 统一个人账户 ЕЛС
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业