Enel São Paulo 数据 API:电费单、抄表与停电工单
Enel São Paulo 是 ENEL BRASIL SA 圣保罗配电特许区的客户服务应用,面向巴西最大都市圈市场的电力用户。合同持有人凭 CPF 与户号登录后,可查看并用 PIX 缴纳电费单、通过自助抄表(autoleitura)让计费基于真实用量、借助引导式问卷上报停电(falta de energia)并获得带恢复供电预计时间的工单号,还能跟踪未结应急工单、匿名举报窃电。
作为数据源,应用呈现了每个用电户号的账单与服务记录:以 OPBEL、EXBEL 为键的账单行携带 BILLING_PERIOD 与 VALOR_CM,每张账单对应 PIX 支付串 pixCopiaCola,抄表读数含 leituraKwh,停电工单返回 E_PROTOCOLO 与恢复供电预计时间 E_PREVISAO,未结应急工单以 NumEmergencia 与 Estado 列出,另有随账单给出的 ANEEL 连续性指标 DIC、FIC、DMIC。市政停电值班台、家庭理财应用与监管仪表盘基于这条数据流对账缴费、绘制工单地图并跟踪供电质量。
Enel São Paulo 是 ENEL BRASIL SA 为其圣保罗配电特许区推出的客户服务应用:用户用 PIX 缴纳电费单、自助抄表上报读数,并报修停电故障、获取带工单号的受理回执。它服务巴西最大的都市圈电网之一,围绕每个用电户号沉淀了电费单与 PIX 支付串、抄表读数、停电问卷与应急工单,以及 ANEEL DIC/FIC/DMIC 供电质量指标等数据。集成方用它驱动停电值班看板、对账家庭电费缴纳,并绘制供电连续性合规图表。
应用截图
API 端点一览
请求/响应示例为依据应用界面重构的示意示例,并非实时抓包。
Create customer session
POST
/v1/customer/sessionopendataExchanges the holder's CPF and installation number for a ZINT-channel session and the SAP contract keys used on every subsequent call.
认证方式: None on this call. CPF of the contract holder plus número da instalação mint a session token (I_SSO_GUID) used as Authorization: Bearer on later ZINT-channel calls. Biometric unlock reuses the stored session.
- cpf
- instalacao
- I_CANAL
- I_AUTENTICACAO
- E_RESULT
- E_MSG
- I_SSO_GUID
- I_ANLAGE
- I_PARTNER
- I_VERTRAG
- I_VKONT
- sessionToken
- biometricEnabled
POST /v1/customer/session HTTP/1.1 Content-Type: application/json { "cpf": "12345678901", "instalacao": "47303913", "I_CANAL": "ZINT", "I_AUTENTICACAO": "LG" }{ "E_RESULT": "0", "E_MSG": "", "I_SSO_GUID": "aea96790-0952-11ee-a7eb-02d7cf5235a0", "I_ANLAGE": "0047303913", "I_PARTNER": "0011592481", "I_VERTRAG": "0003365857", "I_VKONT": "100006470226", "sessionToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session", "biometricEnabled": true }应用内出处
inferred from CPF + número da instalação login and the biometric / USE_BIOMETRIC permission on MainActivityI_AUTENTICACAO=LG, I_CANAL=ZINT and I_SSO_GUID appear on every authenticated fixture payload
Current installation snapshot
GET
/v1/installations/currentopendataReturns the signed-in supply point, business partner, contract and contract-account keys plus the service address shown on the Instalação screen.
认证方式: Bearer session token from POST /v1/customer/session. Scoped to the signed-in I_ANLAGE / I_PARTNER / I_VERTRAG / I_VKONT.
- I_ANLAGE
- I_PARTNER
- I_VERTRAG
- I_VKONT
- I_ENDERECO.CEP
- I_ENDERECO.RUA
- I_ENDERECO.BAIRRO
- I_ENDERECO.CIDADE
- I_ENDERECO.ESTADO
- Suministro
- E_RESULT
- E_MSG
GET /v1/installations/current HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session X-Canal: ZINT{ "E_RESULT": "0", "E_MSG": "", "I_ANLAGE": "0047303913", "I_PARTNER": "0011592481", "I_VERTRAG": "0003365857", "I_VKONT": "100006470226", "I_ENDERECO": { "CEP": "01310100", "RUA": "AV PAULISTA", "BAIRRO": "BELA VISTA", "CIDADE": "SAO PAULO", "ESTADO": "SP", "STREETCODE": "" }, "Suministro": "47303913" }应用内出处
inferred from the Instalação home screen and installationNumber.png / knowYourMeter.png assetsI_ANLAGE, I_PARTNER, I_VERTRAG, I_VKONT and I_ENDERECO are the identity block on validateblackoutauthenticated and registerblackoutauthenticated fixtures
List electricity bills
GET
/v1/billsopenfinancePages the contract-account fatura history used by Segunda via / Sua última conta, keyed by SAP print document OPBEL and external bill EXBEL.
认证方式: Bearer session token from POST /v1/customer/session.
- I_VKONT
- OPBEL
- EXBEL
- BILLING_PERIOD
- MES_REFERENCIA
- VALOR_CM
- VALOR_ITEM
- status
- E_RESULT
- E_MSG
GET /v1/bills?I_VKONT=100006470226&limit=12 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session X-Canal: ZINT{ "E_RESULT": "0", "E_MSG": "", "I_VKONT": "100006470226", "faturas": [ { "OPBEL": "509779709717", "EXBEL": "B-2302-484604235", "BILLING_PERIOD": "2023/02", "MES_REFERENCIA": "DEZ 22", "VALOR_CM": 60.07, "VALOR_ITEM": 0, "status": "ABERTA" } ] }应用内出处
inferred from Segunda via / Sua última conta screensOPBEL, EXBEL, BILLING_PERIOD, MES_REFERENCIA and VALOR_CM are the invoice rows in assets/fixtures/get_indicadores.json
PIX copy for a bill
GET
/v1/bills/{opbel}/pixopenfinanceReturns the PIX copia-e-cola payload for a selected fatura so the holder can pay from any Brazilian bank app.
认证方式: Bearer session token from POST /v1/customer/session.
- OPBEL
- EXBEL
- VALOR_CM
- pixCopiaCola
- beneficiario
- txid
- E_RESULT
- E_MSG
GET /v1/bills/509779709717/pix HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session X-Canal: ZINT{ "E_RESULT": "0", "E_MSG": "", "OPBEL": "509779709717", "EXBEL": "B-2302-484604235", "VALOR_CM": 60.07, "pixCopiaCola": "00020126580014br.gov.bcb.pix0136enel-sp-qr-payload5204000053039865802BR5925ENEL DISTRIBUICAO SAO PAULO", "beneficiario": "Enel Distribuição São Paulo", "txid": "B2302484604235" }应用内出处
inferred from PIX payment on the fatura screen and PIX plus Brazilian bank brand icons (banco-do-brasil, bradesco, btg-pactual, amex) in enel_global_package
Submit meter self-read
POST
/v1/meter/autoleituraopendataAccepts the digits on the meter plus an optional photo so the next fatura is billed on a real reading instead of the average.
认证方式: Bearer session token from POST /v1/customer/session.
- I_ANLAGE
- I_CANAL
- leituraKwh
- fotoMedidor
- dataLeitura
- E_PROTOCOLO
- E_RESULT
- E_MSG
- status
POST /v1/meter/autoleitura HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_ANLAGE": "0047303913", "I_CANAL": "ZINT", "leituraKwh": 18452, "fotoMedidor": "data:image/jpeg;base64,/9j/4AAQ...", "dataLeitura": "2026-09-22" }{ "E_RESULT": "0", "E_MSG": "Leitura registrada com sucesso", "E_PROTOCOLO": "0958950021", "I_ANLAGE": "0047303913", "leituraKwh": 18452, "status": "ACEITA" }应用内出处
inferred from Serviços > Autoleitura / Envio de leitura and meter.png, knowYourMeter.png, medidores.jpg, autolettura.svg assets
Validate outage questionnaire
POST
/v1/outages/validateblackoutauthenticatedopendataLoads the branching falta-de-energia questionnaire (breaker check, internal defect, affected rooms) before a ticket is opened, including Salesforce-routing hints in E_SF.
认证方式: Bearer session token from POST /v1/customer/session. Body carries I_ANLAGE and I_PARTNER of the signed-in supply.
- I_ANLAGE
- I_CANAL
- I_PARTNER
- I_VERTRAG
- I_VKONT
- I_SSO_GUID
- E_ANLAGE
- E_SF.DELAY
- E_SF.CANAL
- ET_PERGUNTAS.ID_PERGUNTA
- ET_PERGUNTAS.TEXTO
- ET_PERGUNTAS.TIPO
- ET_RESPOSTAS.ID_RESPOSTA
- ET_RESPOSTAS.IMPEDIMENTO
- ET_RESPOSTAS.SUBMOTIVO
- ET_AVISOS
POST /v1/outages/validateblackoutauthenticated HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_ANLAGE": "0047303913", "I_CANAL": "ZINT", "I_PARTNER": "0011592481", "I_VERTRAG": "0003365857", "I_VKONT": "100006470226", "I_SSO_GUID": "aea96790-0952-11ee-a7eb-02d7cf5235a0" }{ "E_ANLAGE": "0047303913", "E_RESULT": "", "E_MSG": "", "E_SF": { "DELAY": "7", "DESTINO": "2", "TENTATIVAS": "4", "CANAL": "BRAV" }, "ET_PERGUNTAS": [ { "COD_CAN_ATD": "ZINT", "ID_PERGUNTA": "001", "TEXTO": "Os disjuntores do quadro de distribuição do imóvel e a caixa do medidor foram verificadas?", "TIPO": "SN", "ICONE": "disjuntor-medidor-interno-externo" } ], "ET_RESPOSTAS": [ { "ID_PERGUNTA": "001", "ID_RESPOSTA": "002", "TEXTO": "Sim", "IMPEDIMENTO": "", "PROX_PERGUNTA": "002", "SUBMOTIVO": "114" } ], "ET_AVISOS": [] }应用内出处
inferred from Serviços > Informar Falta de Energiaassets/fixtures/validateblackoutauthenticated_response.json (ET_PERGUNTAS, ET_RESPOSTAS, E_ANLAGE, E_SF)
Register outage ticket
POST
/v1/outages/registerblackoutauthenticatedopendataOpens a falta-de-energia protocol from the answered questionnaire, or returns E_IMPEDIMENTO when the defect is classified as internal and should not dispatch a crew.
认证方式: Bearer session token from POST /v1/customer/session.
- I_ANLAGE
- I_CANAL
- I_PARTNER
- I_VERTRAG
- I_VKONT
- I_GERA_PROTOCOLO
- I_CONTATO.NOME_COMP
- I_CONTATO.CELULAR
- IT_RESPOSTAS.ID_PERGUNTA
- IT_RESPOSTAS.ID_RESPOSTA
- E_IDACESSO
- E_IMPEDIMENTO
- E_PREVISAO
- E_PROTOCOLO
- E_NOTA
- PROCESS_TYPE
- CODE_GROUP
- ET_OFERTAS
POST /v1/outages/registerblackoutauthenticated HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_ANLAGE": "0047303913", "I_CANAL": "ZINT", "I_PARTNER": "0011592481", "I_VERTRAG": "0003365857", "I_VKONT": "100006470226", "I_GERA_PROTOCOLO": "X", "I_AUTENTICACAO": "LG", "I_CONTATO": { "NOME_COMP": "MARIA SILVA", "TELEFONE": "1134567890", "CELULAR": "11987654321", "PONTO_REF": "", "OBS": "", "PRIORIDADE": "", "TERCEIRO": "" }, "IT_RESPOSTAS": [ { "COD_CAN_ATD": "ZINT", "ID_PERGUNTA": "001", "ID_RESPOSTA": "002", "TEXTO": "Sim" } ] }{ "E_IDACESSO": "000000076888059", "E_IMPEDIMENTO": "", "E_MSG": "", "E_NOTA": "", "E_PREVISAO": "2026-09-29T18:30:00-03:00", "E_PROTOCOLO": "0958950021", "E_RESULT": "0", "ET_OFERTAS": [], "IT_RESPOSTAS": [ { "ID_PERGUNTA": "001", "PROCESS_TYPE": "ZEME", "CODE_GROUP": "2E65", "SUBMOTIVO": "114" } ] }应用内出处
inferred from Informar Falta de Energia submit + real-time crew tracking copyassets/fixtures/registerblackoutauthenticated_response_not_registered.json (E_PROTOCOLO, E_IMPEDIMENTO, I_CONTATO, IT_RESPOSTAS, PROCESS_TYPE=ZEME)
List open emergency cases
POST
/v1/cases/getcaseauthenticatedopendataLists open emergency cases for the supply so the app can show ticket status (NumEmergencia, Motivo, Estado) after a blackout is registered.
认证方式: Bearer session token from POST /v1/customer/session.
- SOAId
- NumEmergencia
- Motivo
- Sub-Motivo
- Estado
- Suministro
- CodigoError
- MensajeError
- E_MSG
- E_RESULT
POST /v1/cases/getcaseauthenticated HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_ANLAGE": "0047303913", "I_CANAL": "ZINT", "I_PARTNER": "0011592481" }{ "SOAHeaderResponse": { "SOAId": "dfd221d0-0953-11ee-9ddb-06e0338904ee" }, "GetCasosIVRORQMsgResponse": { "ListadoEmergencias": { "Emergencia": [ { "NumEmergencia": "139531288", "Motivo": "MOT001", "Sub-Motivo": "114", "Estado": "ESTA002", "Suministro": "47303913" } ] }, "ErrorHeader": { "Error": [ { "CodigoError": "0", "MensajeError": "Servicio ejecutado correctamente" } ] } }, "E_MSG": "", "E_RESULT": "" }应用内出处
inferred from Acompanhar solicitações / falta-de-energia statusassets/fixtures/getcaseauthenticated_response.json (GetCasosIVRORQMsgResponse.ListadoEmergencias.Emergencia)
Create emergency case
POST
/v1/cases/createcaseauthenticatedopendataCreates an emergency ORQ case and returns NumEmergencia, the ticket id shown while crews restore supply.
认证方式: Bearer session token from POST /v1/customer/session.
- SOAId
- NumEmergencia
- Motivo
- Sub-Motivo
- CodigoError
- MensajeError
- E_MSG
- E_RESULT
POST /v1/cases/createcaseauthenticated HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_ANLAGE": "0047303913", "I_CANAL": "ZINT", "I_PARTNER": "0011592481", "Motivo": "MOT001", "Sub-Motivo": "114" }{ "SOAHeaderResponse": { "SOAId": "aea96790-0952-11ee-a7eb-02d7cf5235a0" }, "CrearEmergenciaORQMsgResponse": { "NumEmergencia": "139531288", "ErrorHeader": { "Error": [ { "CodigoError": "0", "MensajeError": "Servicio ejecutado correctamente" } ] } }, "E_MSG": "", "E_RESULT": "" }应用内出处
inferred from outage-ticket creation after the questionnaireassets/fixtures/createcaseauthenticated_response_success.json (CrearEmergenciaORQMsgResponse.NumEmergencia)
ANEEL quality indicators
POST
/v1/quality/get_indicadoresopendataReturns per-bill ANEEL continuity indicators (DIC duration, FIC frequency, DMIC max interruption) and critical-customer flags used on the quality / compensation screen.
认证方式: Bearer session token from POST /v1/customer/session.
- I_COD_SERV
- I_PARTNER
- I_VERTRAG
- I_VKONT
- OPBEL
- EXBEL
- BILLING_PERIOD
- MES_REFERENCIA
- CJTO_ANEEL
- DESCRICAO
- DIC
- DIC_MES
- FIC
- FIC_MES
- DMIC
- DMIC_MES
- VALOR_CM
- DICRIV
- DICRIP
- PENAL_CALC
POST /v1/quality/get_indicadores HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_CANAL": "ZINT", "I_COD_SERV": "EI", "I_PARTNER": "0011592481", "I_VERTRAG": "0003365857", "I_VKONT": "100006470226", "I_GUID": "" }{ "E_MSG": "", "E_RESULT": "", "ET_INDICADORES": [ { "OPBEL": "509779709717", "EXBEL": "B-2302-484604235", "BILLING_PERIOD": "2023/02", "MES_REFERENCIA": "DEZ 22", "CJTO_ANEEL": "333", "DESCRICAO": "VARGINHA", "DIC": 0.47, "DIC_MES": 7, "FIC": 1, "FIC_MES": 4, "DMIC": 0.47, "DMIC_MES": 5, "VALOR_CM": 60.07, "VALOR_ITEM": 0 } ], "ET_CRITICOS": [ { "BILLING_PERIOD": "2023/02", "DICRIV": 0, "DICRIP": 13, "PENAL_CALC": 0 } ] }应用内出处
inferred from Indicadores de qualidade / compensação screensassets/fixtures/get_indicadores.json (ET_INDICADORES DIC/FIC/DMIC, ET_CRITICOS, I_COD_SERV=EI)
Report energy theft
POST
/v1/fraud/denunciafraudeopendataFiles a confidential energy-theft report (meter tampering, neighbour irregular connection, or direct tap on the pole) with optional photos and an anonymity flag.
认证方式: Bearer session token from POST /v1/customer/session. Reporter identity is omitted when I_FLAG_ANONIMO is true.
- I_TIPO_OCORRENCIA
- I_OBSERVACOES
- I_FLAG_ANONIMO
- I_ENDERECO.CEP
- I_ENDERECO.RUA
- I_ENDERECO.BAIRRO
- I_NOME
- I_TELEFONE
- I_CELULAR
- IT_ANEXOS.NOME_ARQUIVO
- IT_ANEXOS.ARQUIVO
- E_PROTOCOLO
- E_RESULT
- E_MSG
POST /v1/fraud/denunciafraude HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session Content-Type: application/json { "I_CANAL": "ZINT", "I_TIPO_OCORRENCIA": "03", "I_OBSERVACOES": "Ligação direta no poste em frente ao 1200", "I_FLAG_ANONIMO": true, "I_ENDERECO": { "CEP": "01310100", "RUA": "AV PAULISTA", "BAIRRO": "BELA VISTA", "CIDADE": "SAO PAULO", "ESTADO": "SP" }, "IT_ANEXOS": [ { "NOME_ARQUIVO": "poste.jpg", "ARQUIVO": "data:image/jpeg;base64,/9j/4AAQ..." } ] }{ "E_RESULT": "0", "E_MSG": "Denúncia registrada", "E_PROTOCOLO": "0958950021", "I_TIPO_OCORRENCIA": "03", "I_FLAG_ANONIMO": true }应用内出处
inferred from Denúncia de Fraude wizard (tipo da ocorrência, endereço, anexos, dados do denunciante)assets/fixtures/denuncia_fraude.json endPoint denunciafraude with models I_TIPO_OCORRENCIA, I_OBSERVACOES, I_FLAG_ANONIMO, IT_ANEXOS, I_ENDERECO
Lookup address by CEP
GET
/v1/address/cep/{cep}opendataResolves a Brazilian CEP into street, neighbourhood, city and state for the Denúncia de Fraude and outage address forms.
认证方式: Bearer session token from POST /v1/customer/session. Used by the fraud and outage address pickers.
- CEP
- RUA
- BAIRRO
- CIDADE
- ESTADO
- STREETCODE
- E_RESULT
- E_MSG
GET /v1/address/cep/01310100 HTTP/1.1 Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.session X-Canal: ZINT{ "E_RESULT": "0", "E_MSG": "", "I_ENDERECO": { "CEP": "01310100", "RUA": "AV PAULISTA", "BAIRRO": "BELA VISTA", "CIDADE": "SAO PAULO", "ESTADO": "SP", "STREETCODE": "" } }应用内出处
inferred from the endereço component on Denúncia de Fraude (config useFindaddresscep, validateCep, model I_ENDERECO)
数据类别
- installations
- bills
- payments
- meter readings
- outages
- quality indicators
- fraud reports
数据使用场景与案例
Outage-desk feed
A municipal operations bot posts /v1/outages/validateblackoutauthenticated then /v1/cases/getcaseauthenticated and joins NumEmergencia, Estado and E_PREVISAO onto a map of open Enel São Paulo tickets for the signed-in supply.
Fatura and PIX reconciliation
A household-finance app pages /v1/bills for OPBEL, EXBEL, BILLING_PERIOD and VALOR_CM, then pulls /v1/bills/{opbel}/pix so the holder can settle the same print document from any PIX wallet.
ANEEL continuity dashboard
A regulator-facing spreadsheet calls /v1/quality/get_indicadores and charts DIC, FIC and DMIC against DIC_MES / FIC_MES limits, flagging ET_CRITICOS rows where PENAL_CALC is non-zero.
Anonymous theft intake
A neighbourhood-watch form posts /v1/fraud/denunciafraude with I_TIPO_OCORRENCIA, I_ENDERECO and I_FLAG_ANONIMO=true so the reporter never appears on the protocol.
常见问题
Enel São Paulo 如何验证合同持有人身份?
POST /v1/customer/session 接收持有人的 CPF 与安装号(número da instalação),返回 I_SSO_GUID 及 SAP 键 I_ANLAGE、I_PARTNER、I_VERTRAG、I_VKONT。后续调用以 Bearer token 形式在 I_CANAL=ZINT 通道上携带该会话;生物识别解锁复用已存会话。
哪些端点覆盖停电场景?
POST /v1/outages/validateblackoutauthenticated 返回分支问卷 ET_PERGUNTAS;POST /v1/outages/registerblackoutauthenticated 开立 E_PROTOCOLO(内部故障则置 E_IMPEDIMENTO);POST /v1/cases/createcaseauthenticated 生成 NumEmergencia;POST /v1/cases/getcaseauthenticated 列出未结紧急工单及 Motivo、Sub-Motivo、Estado。
账单与供电质量返回哪些字段?
GET /v1/bills 暴露 OPBEL、EXBEL、BILLING_PERIOD、MES_REFERENCIA、VALOR_CM;POST /v1/quality/get_indicadores 附加每张账单的 ANEEL DIC、FIC、DMIC 指标及补偿用 ET_CRITICOS(DICRIV、DICRIP、PENAL_CALC)。
能否匿名举报窃电?
可以。POST /v1/fraud/denunciafraude 接受 I_FLAG_ANONIMO=true,此时 I_NOME / I_TELEFONE / I_CELULAR 置空,但仍保存 I_TIPO_OCORRENCIA、I_ENDERECO 与可选附件 IT_ANEXOS。
相关主题
- Enel São Paulo 数据 API
- 电费账单 OPBEL
- PIX 电费缴纳
- 停电报修 protocolo
- ANEEL DIC FIC DMIC 指标
- 电表自助抄表
- 窃电举报 denunciafraude
- SAP I_ANLAGE I_VKONT 键
需要集成这个 App 的数据 API?
我们可为任意指定 App 交付定制集成——源码交付 USD 500 起,或托管 API 按调用计费。告诉我们您需要的数据即可。
- 每个项目均签 NDA 与 SOW
- 3–7 天交付
- 验收通过后才付款
- 仅在授权范围内作业