openData StudioEnglish
Saudi Energy 图标

Saudi Energy 数据 API：账单、电量与停电

Saudi Energy · 效率工具

在 Google Play 中打开

Saudi Energy 是沙特电力公司（SEC）面向消费者的品牌 Saudi Energy 的官方自助服务应用，服务沙特全国的居民、商业与工业用电账户持有人。用户凭身份证号或居留证（iqama）通过 Rayah 验证码登录——之后的会话可用 Face ID 或指纹解锁——首页会列出该业务伙伴名下的全部合同账户；随后可以用 PayFort 或 Apple Pay 缴纳后付费账单、为预付费电表充值、用 Hasibati 做周期中途估算、通过 GPS 上报停电、开立 Tawasul 工单、提交投诉、申请增容负荷，或查询福利退款。访客缴费只需合同账户号即可结清账单，无需完整登录。界面支持阿拉伯语和英语；这是覆盖全国的官方客户端，与 SADAD 账单支付和 Absher 并存，而不是与之竞争的电力服务商。

Hasibati 估算把 contractAccountID 与 meterNumber 绑定，并针对同一组 Vkont / PartnerNo 键——每个后付费账户都由它们标识——返回 ForecastBillAmount。仪表盘行带有 totalDueAmount、BilledAmount 与 LastPaymentDate；用电历史把用量拆分为 currentMeterRead / previousMeterRead，以及以 halalah/kWh 计价的电价阶梯，预付费账户则提供 PrepaidBalance 与 LastRechargeDate。停电与 Tawasul 工单增加 ticketNumber；PayFort 结账返回以 fortId 和 hash 为键的支付链接。

账单台与 ERP 团队对账以沙特里亚尔（SAR）计的应付金额和预付费充值，运维团队消费停电与投诉工单状态，能效工具读取 kWh 阶梯与 Hasibati 估算。openData Studio 把这些字段变成可调用的开放数据。

应用截图

  • Saudi Energy 应用截图 1
  • Saudi Energy 应用截图 2
  • Saudi Energy 应用截图 3
  • Saudi Energy 应用截图 4
  • Saudi Energy 应用截图 5
  • Saudi Energy 应用截图 6
  • Saudi Energy 应用截图 7

API 端点一览

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

  • 发送 Rayah 登录验证码

    POST /v1/electricity/auth/otp osint

    向身份证号或居留证（iqama）登记的手机号发送 Rayah 一次性验证码，以便下一次调用换取会话。

    认证方式： 无。由身份证号或居留证加手机号确认持有人；短信验证码由 POST /v1/electricity/auth/session 消费。

    • nationalId
    • IdNumber
    • IdType
    • iqamaNumber
    • mobileNumber
    • lang
    • status
    • message
    POST /v1/electricity/auth/otp HTTP/1.1
Content-Type: application/json

{
  "nationalId": "1087654321",
  "IdNumber": "1087654321",
  "IdType": "NATIONAL_ID",
  "iqamaNumber": null,
  "mobileNumber": "966501234567",
  "lang": "en"
}
    {
  "status": "OK",
  "mobileNumber": "966501234567",
  "IdNumber": "1087654321",
  "IdType": "NATIONAL_ID",
  "message": "OTP sent"
}

  • 校验 Rayah 登录验证码

    POST /v1/electricity/auth/session osint

    用身份证号或居留证与 Rayah 验证码换取 SAP 业务伙伴与合同账户键（PartnerNo、Vkont、accountID），后续每次调用都会用到。

    认证方式： 此调用无需认证。身份证号或居留证加来自 POST /v1/electricity/auth/otp 的短信验证码，换取后续调用使用的会话 cookie。

    • nationalId
    • IdNumber
    • IdType
    • OTP
    • mobileNumber
    • lang
    • status
    • PartnerNo
    • partnerNo
    • accountID
    • accountId
    • Vkont
    • iqamaNumber
    POST /v1/electricity/auth/session HTTP/1.1
Content-Type: application/json

{
  "nationalId": "1087654321",
  "IdNumber": "1087654321",
  "IdType": "NATIONAL_ID",
  "OTP": "482193",
  "mobileNumber": "966501234567",
  "lang": "en"
}
    {
  "status": "OK",
  "PartnerNo": "0011592481",
  "partnerNo": "0011592481",
  "accountID": "100006470226",
  "accountId": "100006470226",
  "Vkont": "100006470226",
  "mobileNumber": "966501234567",
  "iqamaNumber": null
}

  • 获取账户持有人详情

    GET /v1/electricity/account/profile osint

    返回已登录业务伙伴的资料：合同账户、显示名称、身份证号或居留证、手机、邮箱，以及账户页展示的增值税号。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • accountID
    • PartnerNo
    • Vkont
    • contractAccount
    • contractAccountFullName
    • nationalId
    • iqamaNumber
    • mobileNumber
    • emailAddress
    • vatNumber
    GET /v1/electricity/account/profile?accountID=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "accountID": "100006470226",
  "PartnerNo": "0011592481",
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "contractAccountFullName": "AHMED ALQAHTANI",
  "nationalId": "1087654321",
  "iqamaNumber": null,
  "mobileNumber": "966501234567",
  "emailAddress": "[email protected]",
  "vatNumber": "300123456700003"
}

  • 仪表盘合同账户列表

    GET /v1/electricity/accounts opendata

    列出已登录业务伙伴名下的全部合同账户，含别名、预付费标志与应付金额，供首页账户切换器使用。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PartnerNo
    • contractAccount
    • Vkont
    • alias
    • isPrePay
    • totalDueAmount
    GET /v1/electricity/accounts?PartnerNo=0011592481 HTTP/1.1
Cookie: se-session=…
    {
  "PartnerNo": "0011592481",
  "accounts": [
    {
      "contractAccount": "31001234567",
      "Vkont": "100006470226",
      "alias": "Home - Riyadh",
      "isPrePay": false,
      "totalDueAmount": 412.75
    },
    {
      "contractAccount": "31009876543",
      "Vkont": "10009876543",
      "alias": "Shop - Jeddah",
      "isPrePay": true,
      "totalDueAmount": 0
    }
  ]
}

  • 业务伙伴应付总额

    GET /v1/electricity/billing/due openfinance

    以沙特里亚尔（SAR）读取已登录合同账户的 SAP 业务伙伴应付总额，即首页余额卡片上的数字。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PartnerNo
    • Vkont
    • totalDueAmount
    • dueAmount
    • currency
    • dueDate
    • contractAccount
    GET /v1/electricity/billing/due?PartnerNo=0011592481&Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "PartnerNo": "0011592481",
  "Vkont": "100006470226",
  "totalDueAmount": 412.75,
  "dueAmount": 412.75,
  "currency": "SAR",
  "dueDate": "2026-10-18",
  "contractAccount": "31001234567"
}

  • 仪表盘账单结果集

    GET /v1/electricity/billing/bills openfinance

    分页返回合同账户的仪表盘账单列表，含账单金额、最近付款日期、下次账单日期与预付费标志。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • Vkont
    • contractAccount
    • BilledAmount
    • dueDate
    • LastPaymentDate
    • isPrePay
    • NextBillDate
    GET /v1/electricity/billing/bills?Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "bills": [
    {
      "BilledAmount": 387.40,
      "dueDate": "2026-09-18",
      "LastPaymentDate": "2026-09-10",
      "isPrePay": false,
      "NextBillDate": "2026-10-01"
    },
    {
      "BilledAmount": 412.75,
      "dueDate": "2026-10-18",
      "LastPaymentDate": null,
      "isPrePay": false,
      "NextBillDate": "2026-11-01"
    }
  ]
}

  • 账单历史用电量

    GET /v1/electricity/usage/history opendata

    返回账单历史图表背后的月度 kWh 用电量，附当前与上次电表读数。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • meterNumber
    • MeterSerialNumber
    • consumption
    • currentMeterRead
    • previousMeterRead
    • BilledAmount
    • NumberOfDays
    GET /v1/electricity/usage/history?contractAccount=31001234567&meterNumber=052184736 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "meterNumber": "052184736",
  "MeterSerialNumber": "052184736",
  "months": [
    {
      "consumption": 1840,
      "currentMeterRead": 91240,
      "previousMeterRead": 89400,
      "BilledAmount": 387.40,
      "NumberOfDays": 30
    },
    {
      "consumption": 1965,
      "currentMeterRead": 93205,
      "previousMeterRead": 91240,
      "BilledAmount": 412.75,
      "NumberOfDays": 31
    }
  ]
}

  • 用电阶梯电价档位

    GET /v1/electricity/usage/tariff-bands opendata

    把计费周期按 SEC 电价阶梯拆分，给出各档 kWh 以及账单所用的每 kWh 哈拉拉（halalah）费率。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • tariff
    • efficientConsumption
    • kwh
    • halalah
    • consumption
    • BilledAmount
    GET /v1/electricity/usage/tariff-bands?contractAccount=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "tariff": "RESIDENTIAL",
  "efficientConsumption": true,
  "slabs": [
    {"kwh": 1965, "halalah": 18, "consumption": 1965, "BilledAmount": 353.70},
    {"kwh": 0, "halalah": 30, "consumption": 0, "BilledAmount": 0}
  ]
}

  • Hasibati 账单估算

    GET /v1/electricity/usage/bill-estimate opendata

    根据在 Hasibati 估算器中输入的当前电表读数预测下期账单，含已用 kWh 与能效标志。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。另有以合同账户号为键、无需登录的访客版本。

    • contractAccountID
    • contractAccount
    • contractAccountFullName
    • meterNumber
    • currentMtrRead
    • previousMeterRead
    • ForecastBillAmount
    • consumption
    • efficientConsumption
    • currency
    GET /v1/electricity/usage/bill-estimate?contractAccountID=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccountID": "31001234567",
  "contractAccount": "31001234567",
  "contractAccountFullName": "AHMED ALQAHTANI",
  "meterNumber": "052184736",
  "currentMtrRead": 93205,
  "previousMeterRead": 91240,
  "ForecastBillAmount": 428.10,
  "consumption": 2040,
  "efficientConsumption": false,
  "currency": "SAR"
}

  • PayFort 支付链接

    GET /v1/electricity/payments/checkout-link openfinance

    生成 PayFort 托管收银台链接、fortId 与请求 hash，供客户用银行卡支付应付金额。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。访客结账使用 /v1/electricity/guest/checkout-link?token=。

    • token
    • PaymentURL
    • fortId
    • hash
    • merchant_identifier
    • access_code
    • refNumber
    • isPrePay
    • lang
    GET /v1/electricity/payments/checkout-link?token=se-sess-7f3a1c HTTP/1.1
Cookie: se-session=…
    {
  "PaymentURL": "https://payments.example.com/hosted-checkout",
  "fortId": "169000000012345678",
  "hash": "a3f1c9e0b21d7a55",
  "merchant_identifier": "UTILITYMERCH",
  "access_code": "<access-code>",
  "refNumber": "SE-41275-100006470226",
  "isPrePay": false,
  "lang": "en"
}

  • 预付费账户快照

    GET /v1/electricity/prepaid/snapshot openfinance

    返回预付费电表账户的剩余额度、最近一次充值与已用 kWh。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • isPrePay
    • meterNumber
    • PrepaidBalance
    • currency
    • RechargeAmount
    • LastRechargeDate
    • consumption
    GET /v1/electricity/prepaid/snapshot?contractAccount=31009876543&isPrePay=true HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31009876543",
  "isPrePay": true,
  "meterNumber": "088441122",
  "PrepaidBalance": 86.50,
  "currency": "SAR",
  "RechargeAmount": 100.00,
  "LastRechargeDate": "2026-09-28",
  "consumption": 412
}

  • 创建停电报修

    POST /v1/electricity/outages opendata

    为合同账户开立停电工单并返回 ticketNumber，持有人可据此跟踪供电恢复进度。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。访客提交使用 POST /v1/electricity/guest/outages。

    • partnerNo
    • Vkont
    • meterNumber
    • fromNotification
    • message
    • lang
    • ticketNumber
    • refNumber
    • status
    POST /v1/electricity/outages HTTP/1.1
Cookie: se-session=…
Content-Type: application/json

{
  "partnerNo": "0011592481",
  "Vkont": "100006470226",
  "meterNumber": "052184736",
  "fromNotification": false,
  "message": "No supply since 21:10",
  "lang": "en"
}
    {
  "ticketNumber": "OUT-2026-441902",
  "refNumber": "SR-889120",
  "status": "OPEN",
  "partnerNo": "0011592481",
  "Vkont": "100006470226"
}

  • Tawasul 工单状态

    GET /v1/electricity/support/ticket-status opendata

    读取已登录合同账户某张 Tawasul CRM 工单的类别与状态。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • ticketNumber
    • requestType
    • ReqCat
    • status
    • PartnerNo
    • refNumber
    GET /v1/electricity/support/ticket-status?ticketNumber=TW-2026-11820 HTTP/1.1
Cookie: se-session=…
    {
  "ticketNumber": "TW-2026-11820",
  "requestType": "BILLING_INQUIRY",
  "ReqCat": "BILLING",
  "status": "IN_PROGRESS",
  "PartnerNo": "0011592481",
  "refNumber": "SR-774310"
}

  • 提交投诉

    POST /v1/electricity/support/complaints opendata

    提交账单或服务类投诉，并返回投诉页显示的工单号。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • Vkont
    • message
    • lang
    • ticketNumber
    • refNumber
    • status
    POST /v1/electricity/support/complaints HTTP/1.1
Cookie: se-session=…
Content-Type: application/json

{
  "contractAccount": "31001234567",
  "Vkont": "100006470226",
  "message": "High bill vs prior month",
  "lang": "en"
}
    {
  "ticketNumber": "CMP-2026-22011",
  "refNumber": "SR-22011",
  "status": "OPEN",
  "contractAccount": "31001234567"
}

  • 智能电表用电概览

    GET /v1/electricity/meters/summary opendata

    返回消费分析页使用的智能电表头信息：最新读数、下次抄表日期与断路器容量。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • Vkont
    • meterNumber
    • MeterSerialNumber
    • currentMeterRead
    • NextMeterReadDate
    • consumption
    • BillBreakerCapacity
    GET /v1/electricity/meters/summary?Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "Vkont": "100006470226",
  "meterNumber": "052184736",
  "MeterSerialNumber": "052184736",
  "currentMeterRead": 93205,
  "NextMeterReadDate": "2026-10-31",
  "consumption": 1965,
  "BillBreakerCapacity": 60
}

  • 增容负荷预测账单

    GET /v1/electricity/demand-load/forecast opendata

    预测所申请的额外增容负荷对合同账户账单的影响。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • ConsumptionLoad
    • DemandLoad
    • ForecastBillAmount
    • tariff
    • currency
    GET /v1/electricity/demand-load/forecast?contractAccount=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "ConsumptionLoad": 9,
  "DemandLoad": 15,
  "ForecastBillAmount": 640.20,
  "tariff": "RESIDENTIAL",
  "currency": "SAR"
}

  • 福利退款

    GET /v1/electricity/billing/welfare-refund openfinance

    检查福利退款资格，以及接收该笔退款的 IBAN。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • partnerNo
    • eligible
    • iBAN
    • status
    • currency
    GET /v1/electricity/billing/welfare-refund?partnerNo=0011592481 HTTP/1.1
Cookie: se-session=…
    {
  "partnerNo": "0011592481",
  "eligible": true,
  "iBAN": "SA0380000000608010167519",
  "status": "AVAILABLE",
  "currency": "SAR"
}

  • 合同账户电表

    GET /v1/electricity/accounts/meters opendata

    列出合同账户下的电表，含序列号、最新读数、预付费标志与断路器容量。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • Vkont
    • contractAccount
    • meterNumber
    • MeterSerialNumber
    • currentMeterRead
    • currentMtrRead
    • isPrePay
    • BillBreakerCapacity
    GET /v1/electricity/accounts/meters?Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "meters": [
    {
      "meterNumber": "052184736",
      "MeterSerialNumber": "052184736",
      "currentMeterRead": 93205,
      "currentMtrRead": 93205,
      "isPrePay": false,
      "BillBreakerCapacity": 60
    }
  ]
}

  • 访客合同账户查询

    GET /v1/electricity/guest/bill-lookup openfinance

    为访客缴费查询应付金额与账户显示名称，无需 Rayah 会话。

    认证方式： 无。合同账户号是唯一标识；访客刷卡结账随后走 /v1/electricity/guest/checkout-link。

    • contractAccount
    • contractAccountFullName
    • totalDueAmount
    • dueAmount
    • dueDate
    • isPrePay
    • currency
    GET /v1/electricity/guest/bill-lookup?contractAccount=31001234567 HTTP/1.1
    {
  "contractAccount": "31001234567",
  "contractAccountFullName": "AHMED ALQAHTANI",
  "totalDueAmount": 412.75,
  "dueAmount": 412.75,
  "dueDate": "2026-10-18",
  "isPrePay": false,
  "currency": "SAR"
}

  • 打印账单 PDF

    GET /v1/electricity/billing/document opendata

    返回账单详情页所示付款计划/发票 id 对应的可打印账单 PDF。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PaymentPlanID
    • contractAccount
    • BilledAmount
    • contentUrl
    • MeterSerialNumber
    GET /v1/electricity/billing/document?PaymentPlanID=PP-31001234567-202610 HTTP/1.1
Cookie: se-session=…
    {
  "PaymentPlanID": "PP-31001234567-202610",
  "contractAccount": "31001234567",
  "BilledAmount": 412.75,
  "contentUrl": "https://cdn.example.com/bills/PP-31001234567-202610.pdf",
  "MeterSerialNumber": "052184736"
}

  • 预付费充值记录

    GET /v1/electricity/prepaid/recharges openfinance

    列出预付费电表的充值发票，含金额、日期、剩余额度以及每次充值的参考号。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • isPrePay
    • RechargeAmount
    • LastRechargeDate
    • PrepaidBalance
    • currency
    • refNumber
    GET /v1/electricity/prepaid/recharges?contractAccount=31009876543 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31009876543",
  "isPrePay": true,
  "invoices": [
    {
      "RechargeAmount": 100.00,
      "LastRechargeDate": "2026-09-28",
      "PrepaidBalance": 86.50,
      "currency": "SAR",
      "refNumber": "PR-889120"
    },
    {
      "RechargeAmount": 50.00,
      "LastRechargeDate": "2026-08-14",
      "PrepaidBalance": 12.10,
      "currency": "SAR",
      "refNumber": "PR-774310"
    }
  ]
}

  • 账单支付记录

    GET /v1/electricity/billing/payments openfinance

    分页返回合同账户已结清的后付费付款，含账单金额、付款日期与付款计划 id。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • Vkont
    • BilledAmount
    • LastPaymentDate
    • PaymentPlanID
    • currency
    • refNumber
    GET /v1/electricity/billing/payments?contractAccount=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "Vkont": "100006470226",
  "payments": [
    {
      "BilledAmount": 387.40,
      "LastPaymentDate": "2026-09-10",
      "PaymentPlanID": "PP-31001234567-202609",
      "currency": "SAR",
      "refNumber": "SADAD-441902"
    }
  ]
}

  • 增容资格

    GET /v1/electricity/demand-load/eligibility opendata

    判断合同账户能否申请增容负荷，并附当前用电负荷与断路器容量。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • Vkont
    • DemandLoad
    • ConsumptionLoad
    • eligible
    • BillBreakerCapacity
    GET /v1/electricity/demand-load/eligibility?contractAccount=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "Vkont": "100006470226",
  "DemandLoad": 15,
  "ConsumptionLoad": 9,
  "eligible": true,
  "BillBreakerCapacity": 60
}

  • 按手机号追踪请求

    GET /v1/electricity/support/requests opendata

    列出与某手机号关联的 Tawasul / 服务请求，持有人无需选择合同账户即可跟踪工单。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。访客按手机号追踪使用 /v1/electricity/guest/requests?mobileNumber=。

    • mobileNumber
    • ticketNumber
    • requestNumber
    • refNumber
    • ReqCat
    • status
    GET /v1/electricity/support/requests?mobileNumber=966501234567 HTTP/1.1
Cookie: se-session=…
    {
  "mobileNumber": "966501234567",
  "requests": [
    {
      "ticketNumber": "TW-2026-11820",
      "requestNumber": "SR-774310",
      "refNumber": "SR-774310",
      "ReqCat": "BILLING",
      "status": "IN_PROGRESS"
    }
  ]
}

  • Qitaf 积分兑换报价

    GET /v1/electricity/loyalty/redemption-quote openfinance

    报价已登录业务伙伴可用 STC Qitaf 积分抵扣当前电费的数量，并给出对应的 SAR 金额。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PartnerId
    • Vkont
    • QitafReedemPoint
    • qitafAmountPaidFromQitaf
    • QitafReferenceNo
    • currency
    GET /v1/electricity/loyalty/redemption-quote?PartnerId=0011592481&Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "PartnerId": "0011592481",
  "Vkont": "100006470226",
  "QitafReedemPoint": 4200,
  "qitafAmountPaidFromQitaf": 42.00,
  "QitafReferenceNo": "QT-889120",
  "currency": "SAR"
}

  • PayFort Apple Pay 扣款

    POST /v1/electricity/payments/wallet-charge openfinance

    把 Apple Pay 令牌提交给 PayFort，无需托管银行卡页面即可扣收应付金额（或预付费充值）。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。访客 Apple Pay 使用 /v1/electricity/guest/wallet-charge。

    • applePayToken
    • paymentData
    • Vkont
    • isPrePay
    • lang
    • fortId
    • refNumber
    • status
    • hash
    POST /v1/electricity/payments/wallet-charge HTTP/1.1
Cookie: se-session=…
Content-Type: application/json

{
  "applePayToken": "tok_apple_7f3a1c",
  "paymentData": "eyJ2ZXJzaW9uIjoiRUNfdjEiLCJkYXRhIjoiLi4uIn0=",
  "Vkont": "100006470226",
  "isPrePay": false,
  "lang": "en"
}
    {
  "fortId": "169000000012345678",
  "refNumber": "SE-41275-100006470226",
  "status": "SUCCESS",
  "hash": "a3f1c9e0b21d7a55",
  "isPrePay": false
}

  • 待处理房产申报

    GET /v1/electricity/property/declarations/pending opendata

    列出业务伙伴名下待处理的房产/电表申报，供持有人完成 SPL 国家地址确认。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PartnerId
    • PartnerNo
    • nationalAddress
    • status
    • contractAccount
    GET /v1/electricity/property/declarations/pending?PartnerId=0011592481 HTTP/1.1
Cookie: se-session=…
    {
  "PartnerId": "0011592481",
  "PartnerNo": "0011592481",
  "nationalAddress": "RRRD7856",
  "status": "PENDING",
  "contractAccount": "31001234567"
}

  • 已保存的 PayFort 卡片

    GET /v1/electricity/payments/saved-cards openfinance

    列出合同账户上经 PayFort 令牌化的银行卡，使缴费页无需重新输入 PAN 即可复用默认卡。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • accountId
    • cardToken
    • CardNumber
    • CardExpiry
    • expiryDate
    • defaultCard
    • isDefault
    GET /v1/electricity/payments/saved-cards?accountId=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "accountId": "100006470226",
  "cards": [
    {
      "cardToken": "tok_pf_441902",
      "CardNumber": "****4242",
      "CardExpiry": "09/28",
      "expiryDate": "2028-09",
      "defaultCard": true,
      "isDefault": true
    }
  ]
}

  • 外出模式时段详情

    GET /v1/electricity/away-mode/details opendata

    返回已登录合同账户的外出模式时段：冻结日期、通知频率，以及房屋空置期间 kWh 是否激增。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • awayModeID
    • AwayModeID
    • Vkont
    • contractAccount
    • AwayModeNotificationFrequency
    • awayModeFreezedDates
    • IsConsumptionHigherWhileAway
    • HighestSurgeDuringAwayMode
    • PreviousPeriodConsumption
    GET /v1/electricity/away-mode/details?Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "awayModeID": "AM-2026-11820",
  "AwayModeID": "AM-2026-11820",
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "AwayModeNotificationFrequency": "WEEKLY",
  "awayModeFreezedDates": ["2026-08-01", "2026-08-31"],
  "IsConsumptionHigherWhileAway": false,
  "HighestSurgeDuringAwayMode": 2.4,
  "PreviousPeriodConsumption": 1840
}

  • 账单分期计划

    GET /v1/electricity/billing/installment-plan openfinance

    读取生效中的电费账单分期计划：剩余应付、增值税，以及分期卡片所用的付款计划 id。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • contractAccount
    • Vkont
    • InstallmentPlanInforce
    • InvoiceDate
    • InvoiceType
    • TotalInstallmentAmount
    • TotalDueAmount
    • VATAmount
    • TotalAmountBeforeTax
    • PaymentPlanID
    GET /v1/electricity/billing/installment-plan?contractAccount=31001234567 HTTP/1.1
Cookie: se-session=…
    {
  "contractAccount": "31001234567",
  "Vkont": "100006470226",
  "InstallmentPlanInforce": true,
  "InvoiceDate": "2026-09-18",
  "InvoiceType": "INSTALLMENT",
  "TotalInstallmentAmount": 1238.25,
  "TotalDueAmount": 412.75,
  "VATAmount": 53.66,
  "TotalAmountBeforeTax": 1184.59,
  "PaymentPlanID": "PP-31001234567-202610"
}

  • 当前抄表计费合同

    GET /v1/electricity/meter-read/contract opendata

    返回当前抄表页使用的计费合同，以及最新/上次电表读数。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • billingContract
    • Vkont
    • contractAccount
    • meterNumber
    • currentMeterRead
    • previousMeterRead
    • PreviousReadingDate
    • consumption
    GET /v1/electricity/meter-read/contract?Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "billingContract": "31001234567",
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "meterNumber": "052184736",
  "currentMeterRead": 93205,
  "previousMeterRead": 91240,
  "PreviousReadingDate": "2026-09-01",
  "consumption": 1965
}

  • 账户概览集

    GET /v1/electricity/accounts/overview opendata

    加载已登录业务伙伴的 SAP 账户概览快照：所选 Vkont 上的预付费标志、应付金额与电表。

    认证方式： 已登录会话 cookie，来自 POST /v1/electricity/auth/session。

    • PartnerNo
    • Vkont
    • contractAccount
    • isPrePay
    • totalDueAmount
    • meterNumber
    • currency
    GET /v1/electricity/accounts/overview?PartnerNo=0011592481&Vkont=100006470226 HTTP/1.1
Cookie: se-session=…
    {
  "PartnerNo": "0011592481",
  "Vkont": "100006470226",
  "contractAccount": "31001234567",
  "isPrePay": false,
  "totalDueAmount": 412.75,
  "meterNumber": "052184736",
  "currency": "SAR"
}

数据类别

  • 合同账户
  • 账单
  • 用电量
  • 支付
  • 停电
  • 投诉
  • 电表读数
  • 预付费
  • 积分
  • 已保存卡片
  • 外出模式
  • 分期付款

数据使用场景与案例

  • 账单台 SAR 对账

    ERP 或催收机器人每晚拉取 GetBPTotalDueAmount 与 GetDashboardBillsResultSet，按 Vkont 把以 SAR 计的 totalDueAmount、BilledAmount 和 LastPaymentDate 与 SADAD 及银行回单进行匹配。

  • 停电、Tawasul 与投诉信息流

    NOC 看板订阅 CreateOutage 的 ticketNumber 行，以及 TawasulTicketStatusSet / SubmitComplaintRequest 的状态，使外勤班组在同一 PartnerNo 下看到未结停电与账单咨询。

  • kWh 阶梯与 Hasibati 估算器

    能效工具读取 GetBillHistoryConsumptionData 与 GetConsumptionSlabSetData，再用 currentMtrRead 调用 GetBillEstimateSet，向家庭展示周期中途读数会如何落到 ForecastBillAmount。

  • 预付费充值与 PayFort 结账

    钱包或家庭支付应用借助 PrepaidAccountSet 的 PrepaidBalance 和 GetPayFortPaymentURL 的 fortId/hash（或访客合同账户查询）为电表充值或结清后付费 dueAmount，且无需保存银行卡数据。

常见问题

Saudi Energy 如何认证账户持有人？

身份证号或居留证之后走 Rayah 验证码：POST /v1/electricity/auth/otp，再 POST /v1/electricity/auth/session。响应中的 PartnerNo、Vkont 与 accountID 加上会话 cookie 控制后续调用。访客缴费无需登录，仅通过 /v1/electricity/guest/bill-lookup 以 contractAccount 为键。

哪些字段承载电费应付金额？

GET /v1/electricity/billing/due 针对 PartnerNo + Vkont 组合返回以 SAR 计的 totalDueAmount / dueAmount。账单列表 /v1/electricity/billing/bills 列出各周期的 BilledAmount、LastPaymentDate 与 NextBillDate，并用 isPrePay 标记预付费电表。

除余额外，还能读取用电量和停电工单吗？

可以。/v1/electricity/usage/history 返回含 currentMeterRead / previousMeterRead 的月度用电量，/v1/electricity/usage/tariff-bands 给出以 halalah/kWh 计价的电价阶梯，Hasibati 估算 /v1/electricity/usage/bill-estimate 依据 currentMtrRead 预测 ForecastBillAmount，POST /v1/electricity/outages 与 /v1/electricity/support/ticket-status 则暴露 ticketNumber。

银行卡支付如何发起？

GET /v1/electricity/payments/checkout-link 生成带 fortId、hash、merchant_identifier 与 access_code 的 PayFort 托管收银台链接。Apple Pay 提交到 /v1/electricity/payments/wallet-charge；访客在合同账户查询后调用 /v1/electricity/guest/checkout-link。

与 Saudi Energy 相似的应用

  • National Water — National Water 是沙特国家水务公司的自助应用，提供三十多项用水账户服务，常与电费自助一起使用。
  • eMarafiq — eMarafiq 是 Marafiq 的电子服务应用，用于查看公用事业账户、跟踪用量与账单，并接收该公司通知。
  • Absher — Absher 是沙特内政部面向公民、居民和访客的官方个人电子服务应用，Google Play 将其列在与 Saudi Energy 相似的应用中。
  • Nafath — Nafath（نفاذ）是国家数字身份应用，用于核验用户身份，并让其接受来自政府和私营服务的登录请求。
  • DEWA — DEWA Smart App 是迪拜水电局面向用电和用水账户的客户应用，可查看用量并缴纳账单。
  • SEWA — SEWA 应用是沙迦电力、水务与天然气局的公用事业客户端，用于账户管理、用量图表和账单支付，并支持 UAE Pass 与面容登录。
  • PLN Mobile — PLN Mobile 是印尼国家电力公司 PLN 的用电自助应用，可购买预付费电表充值、缴电费、投诉报修，以及申请新装或增容。
  • Enel São Paulo — Enel São Paulo 是 ENEL BRASIL 面向圣保罗配电特许区的客户应用，提供账单二联单、缴费、停电报修、复电和自助抄表。

更多效率工具类应用

相关主题

  • Saudi Energy API
  • 沙特电力公司
  • SEC 账单 API
  • 合同账户 Vkont
  • Hasibati 账单估算
  • Tawasul 工单
  • PayFort 电费支付
  • 沙特预付费电表

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

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

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

获取报价