Partilhar os meus dados com terceiros

De forma a cumprir a atual norma de autorização da North American Energy Standards Board (NAESB) Energy Service Provider Interface (ESPI), a PG&E implementou a estrutura de autorização OAuth 2.0 para autorizar o acesso aos dados. O diagrama abaixo ilustra como os clientes iniciam a autorização, escolhem os parâmetros do âmbito e depois enviam a sua autorização.

Material de referência adicional além das informações abaixo:

Faça o download do diagrama de sequência ESPI OAuth 2.0 (PDF, 193 KB)
Ver o SDK de dados Green Button em Github

Nota: Para Agregadores de Escolhas Comunitárias, apenas o client_access_token é necessário para solicitar dados (via 2-Legged OAuth) e o seguinte não se aplica.

Autorizações iniciadas no local do terceiro

Para iniciar uma autorização de um site de terceiros, conforme ilustrado no primeiro diagrama acima, é feito um pedido de código de autorização redirecionando o navegador do cliente do seu site de terceiros para o AuthorizationServer Authorization Endpoint URL da PG&E com os parâmetros de pedido adequados, conforme exemplo abaixo. Após o redirecionamento, será apresentada ao cliente uma página de início de sessão da PG&E para autenticação, seguida de uma página de autorização para autorizar o acesso aos dados do seu terceiro:

authorizationServerAuthorizationEndpoint URI (com parâmetros de solicitação)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}& response_type=code&state de opcionalState}

• Parâmetros de Pedido Obrigatório:
  • client_id = ID de cliente dos seus marcos de registo de Partilhar Os Meus Dados (ou seja, par client_id/client_secret).
  • redirect_uri = redirecionar URL que especificou no seu registo Partilhar os Meus Dados (os URL devem corresponder).
    Nota: recomendamos que a codificação URL seja aplicada ao redirect_uri conforme o exemplo abaixo.
  • response_type = código (valor estático)
• Parâmetro(s) de solicitação opcional:
  • estado = parâmetro de estado opaco opcional conforme permitido pelo padrão OAuth 2.0 que é devolvido com o código de autorização para ajudar a manter o estado. Por exemplo, o parâmetro de estado pode ser utilizado por terceiros para identificar exclusivamente a origem do cliente e para evitar a falsificação entre locais.
  • início de sessão de 300%} Disponibilize a opção de um terceiro redirecionar os clientes para o início de sessão My Energy da PG&E ou para o separador Acesso de Convidado como parte do fluxo de autorização online.

EXEMPLO: Pedido de código de autenticação

OBTENÇÃO: https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri=https%3A%2F%2Fthirdparty.com%2FredirectUrl&response_type=code&state=pge12advertisement

Nota: o exemplo do parâmetro redirect_uri acima tem a codificação de URL aplicada (ou seja, a codificação de URL de https://thirdparty.com/redirectUrl)

Se fizer um pedido válido conforme acima, e o cliente autenticar e autorizar com sucesso, o cliente será subsequentemente redirecionado para o seu redirect_uri com o código de autorização, parâmetro de âmbito (autorizado) e parâmetro de estado opcional (se fornecido como parte do pedido de autorização), conforme exemplo abaixo:

https://thirdparty.com/redirectUrl?authorization_code=7afc7c4f-778a-4ad8-8337-5e19218a2219&scope=FB=1_3_8_13_14_18_19_31_32_35_37_ 38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength de 3P Registado historic length};AccountCollection de SAs autorizados};BR de IDTerceiro};dataCustodianId=PGE &state=pge12publicidade

Nota: o Código de Autorização tem uma curta duração (expira em 600 segundos) e tem de ser posteriormente trocado por um par de token de acesso/token de atualização para concluir a autorização e permitir o acesso contínuo aos dados. Consulte a secção seguinte (Secção 2) para obter detalhes sobre o pedido de Token de Acesso/Tópico de Atualização.

O parâmetro de escopo (autorizado) exemplificado acima é retornado como parte das respostas ao Pedido de Código de Autorização, ao Pedido de Token de Acesso, bem como à API de Autorização. Este parâmetro de âmbito permite comunicar o âmbito final da autorização do cliente. Em particular, o parâmetro de escopo inclui um valor de "Escopo Adicional" que mapeia para as seleções de autorização de clientes suportadas pela PG&E de grupos de dados (por exemplo, "Uso", "Faturamento", "Básico", "Conta", "Inscrição no Programa"). Os valores dos parâmetros do escopo são ainda capturados de acordo com a seguinte documentação de referência:Descarregar mapeamento de cadeias de escopo do bloco de funções suportado Clique em Thru 2.0 (PDF, 222 KB).

Cenários de erro

Erros de Implementação de Terceiros: Se os parâmetros de pedido necessários de client_id ou redirect_uri forem inválidos ou estiverem em falta ao solicitar um código de autorização, será apresentada ao cliente uma mensagem explicativa juntamente com o erro padrão da série HTTP 400. Da mesma forma, se o parâmetro de pedido necessário de response_type estiver em falta ou for inválido, o cliente será redirecionado para o seu redirect_uri com o parâmetro de erro "invalid_request" definido pelo OAuth 2.0, bem como o parâmetro de estado opcional, se fornecido pela primeira vez como parte do pedido de código de autorização original.

Clientes que recusam autorizar: após um terceiro redirecionar um cliente para autorizar com a PG&E, um cliente tem a opção de recusar através de um botão "cancelar" na página de início de sessão e na página de autorização. Nesses casos, o cliente será redirecionado de volta para o seu redirect_uri com o parâmetro de erro OAuth 2.0 definido "access_denied" anexado para indicar que o cliente recusou autorizar. Além disso, o parâmetro de estado opcional será devolvido se for fornecido pela primeira vez como parte do pedido de código de autorização original.

Autorizações Iniciadas na PG&E

Quando os clientes começam no portal web do cliente da PG&E, "A sua conta", e depois navegam para a página inicial Partilhar os meus dados, são apresentados um menu pendente de terceiros registados e visíveis. Conforme ilustrado no segundo diagrama acima, após um cliente selecionar um terceiro da lista de terceiros registados e selecionar “Seguinte”, o cliente será redirecionado para o “URI do Portal de Terceiros” registado do terceiro, altura em que os clientes podem prosseguir com o processo OAuth iniciado por terceiros descrito na secção anterior.

Nota: Alguns terceiros perguntaram como simplificar a experiência do cliente para este caso de utilização (ou seja, autorizações iniciadas no site da PG&E) de modo a que ao cliente pareça que são levados diretamente para uma página de autorização ao selecionar um terceiro no menu suspenso. Para facilitar essa experiência do cliente, terceiros podem optar por definir o seu “URI do Portal de Terceiros” (através da página de gestão de registo Partilhar Os Meus Dados) para um ponto final que redireccione automaticamente o cliente de volta para a PG&E como parte de um pedido de código de autorização. Após o reencaminhamento automático para o Endpoint de Autorização de Servidor da PG&E, o cliente irá saltar a página de início de sessão do cliente (uma vez que já tem sessão iniciada) e irá diretamente para a página de autorização. Para alguns terceiros que se tenham registado antes da versão Partilhar os Meus Dados Clique em Thru 2.0 no final de junho de 2018, isto pode ser conseguido bastando definir o URI do Portal de Terceiros para igualar o URI "Ecrã de Seleção de Âmbito de Terceiros" (campo a ser retirado numa versão futura).

Em contrapartida, alguns terceiros podem querer primeiro envolver e examinar os clientes do seu lado quando os clientes são redirecionados para o seu URI "Portal de Terceiros" antes de solicitar um código de autorização, por isso a abordagem acima é apenas uma sugestão.

Para obter um Token de Acesso, use o Código de Autorização recebido e ligue para o ponto final abaixo com os parâmetros de solicitação conforme descrito abaixo. Conforme descrito acima, o Código de Autorização é de curta duração, expirando após 10 minutos (600 segundos), por isso certifique-se de que o Token de Acesso é prontamente solicitado após a receção de um Código de Autorização.

authorizationServerAuthorizationEndpoint:https://api.pge.com/datacustodian/oauth/v2/token

• Parâmetros de Pedido Obrigatório:
  • subvenção_tipo = código_autorização (valor estático)
  • código = código de autorização recebido em resposta ao pedido de código de autorização
  • redirect_uri = redirecionar URL que especificou no seu registo Partilhar os Meus Dados (os URL devem corresponder).
    Nota: Tal como no pedido de código de autorização, recomendamos que a codificação URL seja aplicada ao redirect_uri.

EXEMPLO: Pedido de Token de Acesso
POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri desviar_uri}

Adicionar parâmetro básico de cabeçalho de Autorização com codificação Base64 aplicada "clientID:clientSecret"

Nota: Os valores clientId:clientSecret correspondem aos valores clientID fornecidos nos seus marcos de registo Partilhar Os Meus Dados.
O parâmetro do cabeçalho estará no seguinte formato:
Nome do parâmetro: Autorização
Valor do parâmetro: "Cadeia codificada base64" básica

Uma resposta bem-sucedida terá o seguinte aspeto:

774ff105-7ad5-40c8-a6ec-f60675dc0e41
3600
998c6654-5b3b-4385-af4f-4e5c46c1bb04
scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength 3P Registered historic length};AccountCollection de SAs autorizados};BR deThirdPartyID};dataCustodianId=PGE
resourceURI:{ResourceURI} por exemplo: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
autorizaçãoURI:{AuthorizationURI} por exemplo: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
CustomerResourceURI:{customerResourceURI} por exemplo:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Portador

Nota: Um Token de Acesso expira em 3600 seg. (1 hora), enquanto o Token de Atualização correspondente expira em 1 ano. Consulte a próxima secção 3 para obter detalhes sobre a aquisição de um novo par de Token de Acesso/ Token de Atualização.

Guarde o par de tokens de acesso e atualização.
Para solicitar dados históricos iniciais e dados diários em curso,visite o acesso aos dados .

De acordo com as melhores práticas, o Token de Acesso é um token de curta duração (1 hora) enquanto o Token de Atualização correspondente é um token de longa duração (1 ano) que pode utilizar para adquirir um novo par de Token de Acesso/ Token de Atualização quando o Token de Acesso expirar. Para obter um novo Token de Acesso e um par de Token de Atualização para autorizações existentes não expiradas, use o " Token de Atualização atual" e ligue para o ponto final abaixo com os parâmetros descritos abaixo.

authorizationServerAuthorizationEndpoint:https://api.pge.com/datacustodian/oauth/v2/token ?grant_type= refresh_token&refresh_token de despedida escriturada escriturada escriturada em 2017

EXEMPLO: Pedido de atualização de token
CORREIO: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token de

Adicionar parâmetro básico de cabeçalho de Autorização com codificação Base64 aplicada "clientID:clientSecret"

Nota: Os valores clientId:clientSecret correspondem aos valores clientID fornecidos nos seus marcos de registo Partilhar Os Meus Dados.
O parâmetro do cabeçalho estará no seguinte formato:
Nome do parâmetro: Autorização
Valor do parâmetro: "Cadeia codificada base64" básica

Uma resposta bem-sucedida terá o seguinte aspeto:
{
"token_acesso": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"tipo_token": "Portador",
"vence_em": 3600,
"refresh_token": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"âmbito": "scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_
ProgramaInscrição;IntervaloDuração=900_3600;Duraçãodo Bloco=Diariamente;ComprimentoHistórico de 3P Comprimento histórico registado};Coleção deContas de SAs autorizados};BR de IDTerceiro};dadosIDCustodian=PGE",
"resourceURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test",
"autorizaçãoURI": "https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/test"
}

Nota: Da mesma forma, o Token de Acesso do Cliente é um token de curta duração (1 hora) enquanto o Token de Atualização correspondente é um token de longa duração (1 ano) que pode utilizar para adquirir um novo par de Token de Acesso do Cliente/ Token de Atualização quando o Token de Acesso do Cliente expirar. Para obter um novo par de Token de Acesso de Cliente/ Token de Atualização, consulte os mesmos passos descritos acima.

Os clientes poderão atualizar as suas autorizações fazendo o seguinte:

• Remover IDs de Serviço das suas autorizações
• Prolongamento da data final do período de autorização
• Cancelar a autorização

Nota: os clientes só poderão fazer alterações às suas autorizações iniciando sessão na sua conta PG&E online e seguindo os passos necessários. Se alguma destas ações for tomada, iremos notificá-lo através do URI de Notificação que forneceu durante o registo.

Existem opções para gerir e visualizar detalhes das autorizações dos seus clientes:

• Pode ligar para a API de autorização (operação http GET) utilizando o seu client_access_token ao nível de terceiros (para obter detalhes sobre todas as autorizações) em https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization ou ao nível de autorização individual do cliente em https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Separadamente, também pode ver os detalhes da autorização individual manualmente iniciando sessão na sua conta Partilhar os Meus Dados através do portal de terceiros e introduzindo o ID de Subscrição da autorização que procura.

Se já não quiser aceder a dados associados a uma autorização, existem métodos opcionais para cancelar uma autorização:

• Pode ligar para a API de revogação de autorização (operação http DELETE) utilizando o seu client_access_token em https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Em alternativa, pode cancelar manualmente uma autorização iniciando sessão na sua conta Partilhar os Meus Dados através do portal de terceiros e introduzindo a ID de Subscrição da autorização que pretende cancelar.

Nota: o cliente será notificado de que optou por cancelar a respetiva autorização. Além disso, uma vez cancelada uma autorização, a ação não pode ser revertida.

• A PG&E enviará notificações para o seu URI de notificação fornecido durante o registo. As notificações incluem URIs correspondentes a dados já pré-embalados prontos para regressar e solicitar nos URLs fornecidos. Os dados são pré-embalados e as notificações são enviadas nos dois cenários seguintes: (1) selecionou “Notificar-me quando os dados estiverem prontos” no seu perfil de registo, caso em que iremos empacotar os dados diários mais recentes com quaisquer correções para datas passadas, ou (2) fez um pedido assíncrono ad hoc anterior para o qual os dados solicitados estão agora prontos.
• O Cenário 1 é ilustrado sob o "ACESSO A DADOS: SUBSCRIÇÃO DIÁRIA" dos diagramas de Métodos de Acesso a Dados abaixo e Cenário 2 é ilustrado sob o "ACESSO A DADOS: PEDIDO AD HOC (ASINCRONIZADO)" dos mesmos diagramas abaixo.

Lembre-se do tempo de vida do token dos Tokens de Acesso, Token de Acesso do Cliente e seus correspondentes Tokens de Atualização utilizados nas solicitações de dados. De acordo com as melhores práticas, o Token de Acesso é um token de curta duração (1 hora) enquanto o token de atualização é um token de longa duração (1 ano) que pode usar para adquirir um novo par de Token de Acesso/ Token de Atualização quando o Token de Acesso expirar. Do mesmo modo, o Token de Acesso do Cliente é um token de curta duração (1 hora) enquanto o Token de Atualização correspondente é um token de longa duração (1 ano) que pode utilizar para adquirir um novo par de Token de Acesso do Cliente/ Token de Atualização quando o Token de Acesso do Cliente expirar. Para obter mais detalhes sobre como obter um novo par de tokens, consulte o Passo 3, Solicitar um novo token de acesso, no nosso separador de detalhes de autorização. Ir para detalhes da autorização

Se o Cliente estiver autorizado pelo Cliente a receber "Informações de Conta" (ID de Conta, ID de Contrato de Serviço e datas de início de serviço) e/ou "Informações Básicas" (ou seja, nome do cliente e endereço de serviço), pode solicitar essas informações do cliente através das APIs de Cliente de Retalho definidas pela ESPI para as quais os dados estão em conformidade com o esquema, retalhoCliente.xsd, fornecidas acima.

Síncrono (terceiros Standard e EEF)

Uma abordagem para solicitar dados de clientes é usar a API síncrona para solicitar informações de clientes para uma única autorização de cliente para dados de clientes (ou seja, Cliente de retalho):

Exemplo de URL de pedido síncrono:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID que recebeu no final da sequência de autorização OAuth para obter um token de acesso. O CustomerID de Retalho faz parte do parâmetro do caminho doResourceUri do cliente na resposta do token. (IDClienteVarejo=IDSubscrição)

Cabeçalho HTTP = Autorização:Portador {token de acesso para esta autorização}

Resposta = obterá os dados de forma sincronizada para essa ID de Cliente de Retalho. Os dados estão em conformidade com o retailCustomer.xsd

Nota: a API do Cliente de Retalho síncrono está ao nível do Cliente de Retalho individual que corresponde a uma única autorização do cliente.

Para referência: o diagrama hierárquico abaixo mostra a hierarquia de relacionamento para os elementos de dados ESPI na modelagem de dados de clientes PG&E.

Também pode solicitar dados de clientes através da API assíncrona para solicitar informações de clientes para todas as suas autorizações de clientes para dados de clientes (ou seja, Clientes de retalho).

Para suportar pedidos Assíncronos, a sua candidatura terá de suportar Pós-Notificações que lhe enviaremos (de acordo com o URL de Notificação que forneceu durante o registo).

Exemplo de URL de pedido assíncrono:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID fornecido no Recurso de informação da aplicação recuperado durante o teste de registo. (ID do grupo=ID do cliente)

Cabeçalho HTTP = Autorização:Portador {token de acesso do cliente recuperar durante o teste de registo}

Resposta = código de estado HTTP 202 (Este é um pedido assíncrono onde a resposta será publicada no URL de notificação quando os dados estiverem prontos). Assim que os dados estiverem prontos, PUBLICARemos uma notificação para o URI de notificação fornecido com um payload de URLs que a sua aplicação pode regressar para obter o pré-embalado. A amostra de pós-notificação tem o aspeto abaixo

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID descerelationID descerelationID descera/ns0:resources>

Execute GET no URL acima com o token de Acesso do Cliente para obter os dados.

Para referência: o diagrama hierárquico abaixo mostra a hierarquia de relacionamento para os elementos de dados ESPI na modelagem de dados de clientes PG&E.

Por último, pode obter as informações mais recentes do cliente diariamente utilizando o modelo de subscrição diária (ou seja, selecionando a caixa de verificação "Notifique-me quando os dados estiverem prontos (diariamente)" durante o registo).

Para suportar o modelo de subscrição diária, a sua candidatura terá de suportar as Notificações Pós-aviso que lhe enviaríamos (de acordo com o URL de Notificação que forneceu durante o registo).

Assim que os dados estiverem prontos, PUBLICARemos uma notificação para o URI de notificação fornecido com um payload de URLs que a sua aplicação pode regressar para obter o pré-embalado. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID descerelationID descerelationID descera/ns0:resources>

Execute GET no URL acima com o token de Acesso do Cliente para obter os dados.

Para referência, o diagrama hierárquico abaixo mostra a hierarquia de relacionamento para os elementos de dados ESPI na modelagem de dados de clientes PG&E.

Se estiver autorizado pelo cliente a receber "Informações de Utilização" e/ou "Informações de Faturação", pode solicitar estes dados através das API de subscrição para as quais os dados estão em conformidade com o esquema, espiDerived.xsd, fornecido acima.

Pedidos Ad Hoc síncronos (terceiros Standard e EEF)

Para solicitar dados históricos (para dados de utilização de intervalos e dados de fatura), uma abordagem é utilizar as API síncronas com a inclusão de parâmetros de pedido de data de início e de fim adequados no tempo Zulu.

Exemplo de URL de pedido síncrono:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min escrituração em data de início}&published-max escrituração em data de fim}

publicado-min = data de início que será aplicada a este pedido de extração de dados. A data está na hora Zulu de aaaa-MM-ddTHH:mm:ssZ (formato IETC RFC 3339)

published-max = data de fim que será aplicada a este pedido de extração de dados. A data está na hora Zulu de aaaa-MM-ddTHH:mm:ssZ (formato IETC RFC 3339)

Nota: para pedidos API que aceitem parâmetros publicados-máx e publicados-data-mín., a predefinição é T-1 (data do pedido menos 1 dia). Para pedidos de resumo de utilização (por exemplo, .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary), sugerimos que forneça um intervalo de 30 dias ou mais para garantir que existe uma fatura disponível que se sobreponha a esse período, caso contrário não serão devolvidos dados.

Subscription ID = SubscriptionID que você recebeu no final da sequência de autorização OAuth para obter um token de acesso. A ID de subscrição faz parte do parâmetro resourceURI na resposta do token. (ID de Subscrição=ID de Cliente de Retalho)

UsagePointID = UsagePoint sob a ID de subscrição acima. Pode obter todos os pontos de utilização para uma determinada Subscrição ligando para o URL da API abaixo e fornecendo o token de acesso para essa subscrição no cabeçalho da autorização: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

Cabeçalho HTTP = Autorização:Portador {token de acesso para esta Subscrição}

Resposta = irá obter os dados de forma sincronizada para esse ponto de utilização para o período solicitado. Terá dados de utilização de intervalos () e dados de faturação ().

As API de utilização síncrona (conforme indicado pela construção do URL que termina com a ID do Ponto de Utilização) estão ao nível do Ponto de Utilização individual (ou seja, nível do Contrato de Serviço), pelo que uma aplicação iria fazer circular os pedidos através de cada uma das ID do Ponto de Utilização pertencentes a uma determinada autorização do cliente (ou seja, subscrição).

A resposta aos pedidos síncronos devolve os dados de intervalo (em) associados ao intervalo de datas solicitado, bem como quaisquer totais de utilização mensais e faturas que se sobreponham ao intervalo de datas solicitado (em ).

• IntervalReading contém dados de uso de gás com intervalo (15 min/hora) e intervalo (diário) de uso de gás
• O Resumo de Utilização contém os totais de utilização mensais e os detalhes da fatura (se autorizado)

Dentro da resposta encontrará elementos de dados correspondentes à nossa tabela de mapeamento de elementos de dados ESPI

Para referência, o diagrama hierárquico abaixo mostra a hierarquia de relacionamento para os elementos de dados ESPI na modelagem de dados de clientes PG&E.

Seguem-se alguns esclarecimentos importantes sobre estes elementos de dados:

• O bloqueio de intervalo é para 1 dia
• A leitura de intervalo (por baixo do bloco de intervalo) contém os valores reais de uso elétrico de 15 minutos/hora e os valores diários de uso de gás
• Para clientes elétricos com geração no local (por exemplo, Solar), o elemento de direção de fluxo indica os dados de utilização entregues (fornecimento) e recebidos (geração). Para clientes com medidores configurados para ler apenas a utilização líquida (ou seja, sem geração no local), o elemento de direção de fluxo indica que a utilização é um montante líquido (diferença entre a entrega menos recebida):
  • Sentido do fluxo de 1 = fornecido (energia fornecida ao cliente)
  • Sentido de fluxo de 19 = recebido (geração líquida a fluir de volta para a grelha PG&E). (Nota: os valores são absolutos)
  • Direcção do fluxo de 4 = líquido (entregue menos – recebido)
• Preste especial atenção à potência de dez multiplicadores e Unidade de Medida (uom) de modo a garantir uma leitura de utilização correta

Subscrição Batch (terceiros Standard e EEF)

Também pode solicitar dados de utilização através da API assíncrona para todos os Pontos de Utilização pertencentes a uma única autorização de cliente para dados de utilização/faturação (ou seja, Subscrição).

Para suportar os pedidos Assíncronos Ad Hoc (ou seja, para mais do que um único Ponto de Utilização de cada vez), a sua aplicação terá de suportar as Notificações Pós-aviso que lhe enviaríamos (de acordo com o URL de Notificação que forneceu durante o registo)

Exemplo de URL de pedido assíncrono
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min de despoletarDate}&published-max de desfazimentoDate}

Subscription ID = SubscriptionID que recebeu no final da sequência OAuth para obter um token de acesso. O ID de subscrição faz parte do parâmetro resourceURI na resposta do token

publicado-min = data de início que será aplicada a este pedido de extração de dados. (RFC 3339 formato zulu tempo. aaaa-MM-ddTHH:mm:ssZ)

published-max = data de fim que será aplicada a este pedido de extração de dados. (RFC 3339 formato zulu tempo. aaaa-MM-ddTHH:mm:ssZ)

Cabeçalho HTTP = Autorização:Portador {token de acesso para esta Subscrição}

Resposta = código de estado HTTP 202 (este é um pedido assíncrono onde a resposta será publicada no URL de notificação quando os dados estiverem prontos)

Assim que os dados estiverem prontos, PUBLICARemos uma notificação para o URI de notificação fornecido com um payload de URLs que a sua aplicação pode voltar para obter o pré-embalado. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?correlationID descerelationID descerelationID descere/ns0:resources>

Execute GET no URL acima com o token de Acesso para obter os dados. Isto irá conter dados de utilização de intervalos () bem como informações de faturação () para o período solicitado.

Subscrição Batch (terceiros Standard e EEF)
Também pode solicitar informações de utilização e faturação através da API assíncrona de lote para todas as autorizações do seu cliente para dados de utilização/faturação (ou seja, Subscrições).

Exemplo de URL de pedido de lote em massa
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?publicado-mín. de deslocaçãoData}&publishedmax deslocaçãoData}

BulkID = BulkID fornecido no Recurso de informação da aplicação recuperado durante o teste de registo. (ID de grupo=ID de cliente)

publicado-min = data de início que será aplicada a este pedido de extração de dados. (RFC 3339 formato zulu tempo. aaaa-MM-ddTHH:mm:ssZ)

published-max = data de fim que será aplicada a este pedido de extração de dados. (RFC 3339 formato zulu tempo. aaaa-MM-ddTHH:mm:ssZ)

Cabeçalho HTTP = Autorização:Portador {token de acesso do cliente}

Resposta = código de estado HTTP 202 (este é um pedido assíncrono onde a resposta será publicada no URL de notificação quando os dados estiverem prontos)

Assim que os dados estiverem prontos, PUBLICARemos uma notificação para o URI de notificação fornecido com um payload de URLs que a sua aplicação pode voltar para obter o pré-embalado. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID descerelationID descerelationID des. /ns0:resources>

Execute GET no URL acima com o token de Acesso para obter os dados. Isto irá conter dados de utilização de intervalos () bem como informações de faturação () para o período solicitado.

Por último, pode obter as informações de utilização e faturação mais recentes, incluindo correções para datas passadas dentro dos períodos de autorização do cliente diariamente utilizando o modelo de subscrição diária (ou seja, selecionando a caixa de verificação "Notifique-me quando os dados estiverem prontos (diariamente)" durante o registo).

Para suportar o modelo de subscrição diária, a sua candidatura terá de suportar as Notificações Pós-aviso que lhe enviaríamos (de acordo com o URL de Notificação que forneceu durante o registo).

Assim que os dados estiverem prontos, PUBLICARemos uma notificação para o URI de notificação fornecido com um payload de URLs que a sua aplicação pode voltar para obter o pré-embalado. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID descerelationID descerelationID des. /ns0:resources>

Execute GET no URL acima com o token de Acesso para obter os dados. Isto irá conter dados de utilização de intervalos () bem como informações de faturação () para o período solicitado.

20 de junho de 2024

A Plataforma Partilhar Os Meus Dados (SMD) da PG&E para Partilha de Dados Autorizados pelo Cliente com Prestadores de Serviços terceiros lançou a Fase 2 do nosso Melhoramento da ID do Medidor, permitindo a identificação da ID do Medidor individual associada aos dados do medidor de intervalo elétrico.  

Esta melhoria é particularmente útil para cenários de utilizador em que vários medidores estão associados a um contrato de serviço.

Fase 1:  Lançado em março de 2023 - Modificado as APIs afetadas para começar a adicionar um valor juntamente com o valor na resposta devolvida, sob a tag . Existe uma correspondência de um para um entre o valor do número de série e o valor do númeroutc.

Esta informação permite que os fornecedores que utilizam estas API criem uma loja de registos com o utcNumber, juntamente com o valor do número de série associado a um determinado medidor para a sua base de clientes antes de a melhoria da Fase 2 ser lançada.

Fase 2: Lançado a 20 de junho de 2024 - Substitui os valores MeterReadingID do formato encode64 atual dos valores descritivos do medidor pelo utcNumber. Assim que estas alterações estiverem totalmente implementadas, os utilizadores de Partilhar os Meus Dados terão uma capacidade melhorada de se ligarem a uma utilização específica do intervalo de medidores, nos casos em que existam vários medidores da mesma mercadoria ligados a um único contrato de serviço no local, à ID específica do medidor que gerou a utilização. 

As seguintes API são afetadas pelas alterações da Fase 2

API afetada:

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock

.../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading/{MeterReadingID}/IntervalBlock/{IntervalBlockID}

Todas as outras API com leituras de intervalos permanecem inalteradas e representam a SOMA dos intervalos do medidor em ambas as direções de fluxo e com todos os medidores ao abrigo de um contrato de serviço.

Antes do lançamento, o campo MeterReadingID era codificado com Base64 e o valor devolvido mostra o seguinte:

ID de leitura do medidor= TnpJNmJuVnNiRG96TmpBd09qRT06MTox

Descodificado do formato Base64 como:  NzI6bnVsbDozNjAwOjE =:1:1

Isto mostra leituraTypeID:rownum:count e leituraO valor deTypeID é descodificado de Base64 novamente como:

72:nulo:3600:1 onde os valores são uom:fase:intervaloComprimento:fluxoDir

UOM=72, fase=nulo, intervaloComprimento=3600 e fluxoDir=1 (entregue)

Na Fase 2, o campo MeterReadingID é anexado com caracteres adicionais e, após passar por uma descodificação inicial, retornará os seguintes resultados de exemplo

MeterReadingID=TnpJNmJuVnNiRG96TmpBd09qRT06MToxOjQ0MTEzMTA1NDYgICAgICAgICAg

Descodificado a partir da Base64 uma vez:  NzI6bnVsbDozNjAwOjE =:1:1:4411310546, 

Isto mostra meter_UUID é 4411310546 e este valor deve corresponder ao valor disponível na API de Cliente de Retalho sob a etiqueta .

O valor de “NzI6bnVsbDozNjAwOjE=:1:1:” é a leituraTypeID:rownum:count, ou seja, o número da linha é 1 e a contagem é 1 relacionada com os registos internos da base de dados da PG&E. A leituraTypeID é novamente descodificada como:

72:nulo:3600:1, em que os valores são uom:fase:intervaloComprimento:fluxoDir

UOM=72, fase=nulo, intervaloComprimento=3600 e fluxoDir=1 (entregue)

Esta alteração permite aos utilizadores especificar o medidor físico e a direção do fluxo de interesse nas leituras de intervalo. Note que todos os ficheiros XML irão agora conter os novos valores MeterReadingID e irão aplicar a nova forma de codificação da Fase 2. Partilhar Os Meus Dados aconselha todos os fornecedores que utilizam qualquer chamada API utilizando o MeterReadingID, fazer a seguinte chamada API para obter o novo MeterReadingID: .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/MeterReading

20 de março de 2023

Novidades:

1. Lançamento de um novo código de resposta HTTP da API (204) para chamadas síncronas e assíncronas da API para indicar quando não estão disponíveis dados para o intervalo solicitado.
2. Suportar uma etiqueta de cabeçalho de transação x que suporte a capacidade de associar a resposta da PG&E a chamadas API assíncronas específicas, devolvendo este valor juntamente com uma ID de correlação quando o ficheiro solicitado estiver pronto.
3. Melhor granularidade de dados adicional para a API UsagePoint/MeterReadingID, fornecendo dados de intervalo elétrico para vários medidores para cenários de Contrato de Serviço único.
4. Forneceu clareza adicional aos valores do indicador de qualidade de leitura para dados de intervalo ESTIMADOS para descrever o tipo de estimativa utilizada para esse intervalo. Os novos valores que indicam que a lógica de estimativa foi aplicada são os seguintes:
   
   

5. Valor e descrição de RQI

   0 - Válido: dados que passaram por todas as verificações de validação necessárias e passaram por todas ou foram verificados

   7 - Editado manualmente: substituído ou aprovado por um homem

   8 - Estimado utilizando dia de referência: o valor dos dados foi substituído por um valor calculado da máquina com base na análise de dados históricos utilizando o mesmo tipo de medição

   9 - Estimado utilizando interpolação linear: o valor dos dados foi calculado utilizando interpolação linear com base nas leituras antes e depois

   10 - Questionável: dados que falharam uma ou mais verificações

   11 - Derivado: dados que foram calculados (utilizando operações lógicas ou matemáticas), não necessariamente medidos diretamente

   12 - Projetado (previsão): dados que foram calculados como projeção ou previsão de leituras futuras

   13 - Misto: indica que a qualidade desta leitura tem características mistas

   14 - Bruto: dados que não passaram pelo processo de validação, edição e estimativa. NOTA O indicador RQI de MV90 metros permanecerá em 14 como estado RQ final

   15 - Normalizado para o clima: os valores foram ajustados para contabilizar o clima, comparar o uso em diferentes climas

   16 - Outro: especifica que uma característica se aplica diferente daquelas definidas

   17 - Validado: dados que foram validados e possivelmente editados e/ou estimados de acordo com procedimentos aprovados

   18 - Verificado: dados que falharam pelo menos uma das verificações de validação necessárias, mas que foram determinados como representando a utilização real

   19 - Qualidade da receita: válida e aceitável para fins de cobrança [possível extensão para o padrão ESPI, e não parte do ESPI original]

    

6. Lançamento das métricas de utilização da API do fornecedor no portal Partilhar os Meus Dados de Terceiros.

15 de novembro de 2018

Novidades:

1. O Indicador de Classe do Cliente foi adicionado. Cada DISPOSTO autorizado será identificado como RES, AGR, COM/IND ou Outro.
2. As APIs de Faturação e Utilização serão atualizadas para aceitar parâmetros de consulta atualizados-máx e atualizados-mín. (como uma alternativa a publicação-mín. e publicação-máx.). Os dados devolvidos serão todas as alterações que ocorreram dentro dos parâmetros máximo e mínimo atualizados.
3. Substituir a utilização da ID de 5 dígitos em massa de terceiros pela ID de cliente de terceiros para o fluxo de autorização online.
4. Disponibilizar a opção de um terceiro redirecionar os clientes para o início de sessão na conta da PG&E ou para o separador Acesso de Convidado como parte do fluxo de autorização online.
5. Melhorar o painel de controlo Partilhar os Meus Dados do cliente da PG&E para facilitar aos clientes a visualização de todas as suas autorizações de partilha de dados existentes com terceiros.

27 de setembro de 2018

Novidades:

A PG&E adicionou novos elementos de dados ao conjunto de dados da Regra 24 como parte do projeto de Conjunto de Dados Expandido (EDS) da PG&E, e os novos elementos de dados correspondentes são introduzidos no conjunto de dados da Regra 25. Os elementos de dados específicos que compreendem os dados expandidos da Regra 25 da PG&E são definidos abaixo com a designação EDS:

Elementos de Dados da Regra 25

Notas
Elementos da conta
Nome da conta
Endereço da conta
ID da conta
EDS: Bloqueio de interrupção
Elementos de serviço
PG&E UUID
ID de serviço
Alterações futuras ao estado de serviço
Estado de SA
Data de início do serviço
Endereço do serviço
Tarifa de serviço atual
Tarifa de serviço faturada histórica
Opções de Tarifa (Base Médica, CARE, FERA, TBS, CCA_TBS, Escolha Solar
Tensão de serviço atual e tensão de serviço faturada histórica de mercadorias
Número do medidor de serviço
Número de medidores de serviço
Tipo de medidor
Ciclo de leitura do medidor de corrente
Ciclo de leitura do contador faturado histórico
Opção de taxa de espera atual se indicador de geração no local
Opção de taxa de espera faturada histórica
EDS: Indicador de classe do cliente
Elementos históricos de faturação
Data de início da fatura
Data de fim da fatura
Faturar custos totais($)
Faturar total kWh
EDS: Nome do Prestador de Serviços
Discriminação do nível da conta histórica (se houver)
EDS: Período de Faturação de Item de Linha
EDS: Nome (Acima da Situação Basal 1%-30%)
EDS: Volume (1234,2)
EDS: Taxa ($0,032/kWh)
EDS: Custo ($100,23)
Discriminação de kWh da fatura histórica (exceto para ABS-TX faturado)
EDS: Período de Faturação de Item de Linha (para avaria de TOU)
EDS: Nome (da cobrança de TOU)
EDS: Volume (1234,2)
EDS: Taxa ($0,032/kWh)
EDS: Custo ($100,23)
Discriminação histórica da procura de faturas
EDS: Período de Faturação de Item de Linha (para discriminação da Procura)
EDS: Nome
EDS: Volume (1234,2)
EDS: Taxa ($0,032/kWh)
EDS: Custo ($100,23)
Itens de linha de histórico de contas
EDS: Período de Faturação de Item de Linha
EDS: Nome da cobrança (DWR Bond Charge)
EDS: Volume (1234,2)
EDS: Unidade (kWh)
EDS: Taxa ($0,032/kWh)
EDS: Custo ($100,23)
Intervalos de utilização do histórico
Início da utilização do intervalo
Duração predefinida do intervalo (em segundos)
Volume de utilização do intervalo (1234.2)
Unidade (kWh/Termas)
Programas de resposta à procura de serviços públicos
Nome do programa (DR)
Data de Rescisão Primeira sem Obrigação Financeira
Data da Rescisão Primeira, independentemente da Obrigação Financeira
Estado do programa DR
Data de inscrição no programa DR
Data de cancelamento da inscrição no programa DR
Elementos de dados
Mercadoria
Parâmetros de hora local (detalhes DST)
Qualidade de dados predefinida
Direção da energia
Potência de dez multiplicadores (para valores de utilização de intervalo)
Poder de dez multiplicadores (para demanda faturada)
Potência de dez multiplicadores (para utilização total faturada)
Duração do intervalo(da leitura de utilização)
Moeda do custo total da fatura
Indicadores TOU de intervalo elétrico

28 de junho de 2018

Como parte do projeto Click-Through e das melhorias contínuas na Plataforma Share My Data, a PG&E lançou a Fase 2 Click-Through a 28 de junho de 2018.

Novidades:

As alterações mais críticas que afetam terceiros são as alterações em conformidade com o protocoloOAuth 2.0 (PG&E eliminou a série inicial de redirecionamentos). Encontre os detalhes abaixo.

IMPORTANTE: Os terceiros sãoOBRIGATÓRIOS a fazer alterações à sua implementação OAuth existente. As alterações de Fase 2 Click-Through da PG&E NÃO são retrocompatíveis, pelo que é necessário que terceiros implementem alterações em simultâneo com a implementação da PG&E. Sem implementação, o processo atual de autorização do cliente deixará de funcionar na data limite de 29 de junho de 2018. As autorizações existentes, no entanto, não são afetadas.

1. Para estar em conformidade com o protocolo OAuth 2.0, a PG&E reduziu o número de passos de redirecionamento para autorização. O redirecionamento inicial para a PG&E para que os clientes iniciem sessão e enviem uma autorização foi combinado com o pedido de código de autorização da seguinte forma:
   • Como mostrado no exemplo abaixo, as solicitações de código de autorização de terceiros agora compreendem um redirecionamento do navegador do cliente para a nova authorizationServerAuthorizationEndpoint URI, juntamente com os parâmetros de solicitação apropriados:
     OBTENHA https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}& response_type=code&state desportivo opcionalEstado}
   • O seguinte parâmetro de avaliação foi retirado: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. Novas mensagens de tratamento de erros para pedidos de código de autorização com parâmetros de âmbito em falta ou inválidos da seguinte forma:
   • Se os parâmetros client_id ou redirect_uri necessários estiverem em falta ou forem inválidos, é apresentado ao cliente um erro (http 400) com mensagem explicativa
   • Se o parâmetro response_type necessário estiver em falta ou for inválido, o cliente será redirecionado de volta para o redirect_uri do terceiro com um parâmetro de erro "invalid_request" (anexado ao redirect_uri)
     
3. Para clientes com uma autorização online existente, a capacidade de um terceiro solicitar um novo par access_token/refresh_token como parte de uma nova autorização que substitui a existente (ou seja, autorização online do mesmo terceiro e combinação de cliente). Esta funcionalidade aborda cenários de terceiros que perdem um par access_token/refresh_token ou que precisam de alterar o âmbito da autorização original de acordo com a aprovação do cliente.
   • Para pedidos de reautorização, o cliente vê a nova página de autorização em vez da página “gerir autorização” quando redirecionado por um terceiro para a PG&E para autorização
   • Após autorização do cliente, os terceiros recebem uma notificação para o URL de notificação registado de que a ID de subscrição antiga foi cancelada (a notificação inclui o ponto final de URL da API de autorização para a ID de subscrição antiga)
     
4. A capacidade de um cliente sair através de um botão "cancelar" na página de autenticação ou na página de autorização com redirecionar para o redirect_uri do terceiro com um parâmetro de erro "access_denied" (anexado ao redirect_uri)
5. Para terceiros que se registem com a definição de “visibilidade” e que sejam, portanto, incluídos na lista de terceiros registados, os clientes verão quando irem à sua conta online da PG&E e navegarem para a página inicial Partilhar os Meus Dados:
   • Para clientes que iniciem sessão na sua conta online da PG&E e naveguem para a página inicial Partilhar os Meus Dados, sendo depois redirecionados para o "URI do Portal de Terceiros" registado de terceiros ao selecionar um terceiro da lista de terceiros registados. Nessa altura, os clientes podem prosseguir com o processo OAuth iniciado por terceiros. Ao percorrer este caminho, os clientes deixarão de ver a página de autorização ao selecionar um terceiro na lista pendente de terceiros, mas serão redirecionados para o "URI do Portal de Terceiros" registado do terceiro, onde podem iniciar o processo OAuth iniciado pelo terceiro
   • Nota: Alguns terceiros questionaram sobre como simplificar a experiência do cliente para este caso de utilização (ou seja, autorizações iniciadas no site da PG&E) de modo a que ao cliente pareça que são levados diretamente para uma página de autorização ao selecionar um terceiro no menu suspenso. Para facilitar essa experiência do cliente, os terceiros podem optar por definir o seu "URI do Portal de Terceiros" (através da página de gestão de registo Partilhar Os Meus Dados) para um ponto final que redireciona automaticamente o cliente de volta para a PG&E como parte de um pedido de código de autorização. Após o reencaminhamento automático de volta para a authorizationServerAuthorizationEndpoint , o cliente irá saltar a página de início de sessão do cliente (uma vez que já tem sessão iniciada) e irá diretamente para a página de autorização. Para alguns terceiros que se tenham registado antes da versão Partilhar os Meus Dados Clique através de 2.0, isto pode ser conseguido definindo simplesmente o URI do Portal de Terceiros para igualar o "Ecrã de Seleção de Âmbito de Terceiros" utilizado (campo antigo Registo SMD a ser retirado numa versão futura).
     Pelo contrário, alguns terceiros podem querer, em vez disso, envolver e examinar os clientes do seu lado quando os clientes são redirecionados para o seu URI "Portal de Terceiros" antes de solicitar um código de autorização, por isso a abordagem acima é apenas uma sugestão.
     
6. O SMD irá agora fornecer detalhes dos parâmetros do Âmbito melhorados como parte das respostas ao Pedido de Código de Autorização, ao Pedido de Token de Acesso e à API de Autorização. O parâmetro de âmbito melhorado permite comunicar o âmbito final da autorização do cliente. Em particular, o parâmetro de escopo inclui um valor de "Escopo Adicional" que mapeia para as seleções de autorização de clientes suportadas pela PG&E de grupos de dados (por exemplo, "Uso", "Faturamento", "Básico", "Conta", "Inscrição no Programa"). Os valores dos parâmetros do escopo são ainda capturados de acordo com a seguinte documentação:Faça download do mapeamento de cadeias de escopo do bloco de funções suportado Clique em Thru 2.0 (PDF)
   
   Um exemplo de resposta do Token abaixo ilustra alguns valores possíveis dos parâmetros do escopo.
   • Exemplo de resposta de token:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     scope=FB=1_3_8_13_14_18_19_31_32_35_37_38_39_40_4_5_10_15_16_46_47;AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;IntervalDuration=900_3600;BlockDuration=Daily;HistoryLength de 3P Registered historic length};AccountCollection de SAs autorizados};BR de ThirdPartyID};dataCustodianId=PGE
     recursoURI:{ResourceURI} por exemplo: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     autorizaçãoURI:{AuthorizationURI} por exemplo: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     CustomerResourceURI:{customerResourceURI} por exemplo:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Portador
     
     
     
7. Os terceiros podem agora registar-se para receber informações de Inscrição no Programa autorizadas através do novo grupo de dados "Inscrição no Programa". Tanto os clientes com medição de intervalocomo os clientes com medição sem intervalo serão elegíveis para autorizar a partilha de dados para a Fase 2 de Retrocessão de SMD. Um resumo de alto nível dos elementos de dados recentemente disponíveis fornecidos pelo grupo de dados da Inscrição no Programa é o seguinte:
   • Inscrição no Programa (nome/estado do programa de Resposta à Procura PG&E e informações CAISO):
   • (Faturação) Endereço da conta
   • Estado do Contrato de Serviços
   • Tarifa de serviço (atual)
   • (Corrente) Tensão de serviço (apenas elétrica)
   • Número do medidor de serviço (se houver)
   • Tipo de medidor
   • Ciclo de leitura do medidor (atual)
   • Opção de taxa de espera (atual) se indicador de geração no local
   • (utilização do intervalo predefinido) Duração (duração em segundos)
   • Nome do Programa (Resposta à Procura PG&E Inscrita) (se aplicável)
   • Data de Rescisão Primeira do Programa de Resposta à Procura (DR) inscrito na PG&E sem Obrigação Financeira
   • Data de Rescisão Primeira do Programa de Resposta à Procura (DR) inscrito na PG&E, independentemente da Obrigação Financeira
   • Estado do Programa de Resposta à Procura (DR) da PG&E (inscrição)
   • Data de inscrição no Programa de Resposta à Procura (DR) da PG&E
   • Data de cancelamento da inscrição do programa de resposta à procura (DR) da PG&E
   • O mapeamento Atom XML XSD (XML Schema Definition) para estes novos elementos de dados é capturado de acordo com a seguinte documentação:
     Faça download dos elementos de dados suportados (PDF)
   • O modelo de hierarquia de dados relacionais associado é descrito de acordo com o seguinte:
     Descarregar o modelo de dados PGE ESPI (PDF)
   • Ponto de utilização (também conhecido como UUID SA)
     • ServiceDeliveryPoint\tariffProfile(calendário atual de tarifas de AKA, incluindo Opção de Tarifa de Standby, se aplicável)
     • readCycle (ciclo de leitura do medidor atual)UsageSummary
     • readCycle (ciclo de serviço de faturação)
     • Mercadorias (inclui o nível de tensão faturado para eletricidade)
     • TarifaPerfil (tarifa de serviço faturada, incluindo opção de Taxa de Espera, se aplicável
   • Tipo de leitura
     • Mercadoria (inclui o nível de tensão de corrente para elétrica e prefixo para a Opção de Taxa de Standby, quando aplicável)
   • Conta de cliente
     • (Endereço de faturação da conta):
     • principalEndereço/ruaDetalhe...
     • principalEndereço/cidadeDetalhe...
     • principalEndereço/código postal...
   • Contrato do cliente
     • estado\valor (Estado SA
   • Programa de resposta à demanda
     • Nome do programa
     • Estado de inscrição
     • ProgramaData/programaData
     • ProgramaData/programaDataDescrição
   • Contador
     • Número de série (ID do medidor)
     • tipo (tipo de medidor)
     • Intervalo (atual)Comprimento
   • As definições mais recentes de esquema de xml ESPI (XSD) utilizadas para estes novos elementos de dados são descritas de acordo com o seguinte:
     Transferir XSD (ZIP)
     Nota: os XSD são compatíveis com versões anteriores.
   • Os terceiros poderão alterar o seu registo para permitir que os clientes selecionem este grupo de dados durante o período de autorização através do portal de terceiros em gerir registo >Editar > secção: Indique as informações do cliente de que necessita", selecione a caixa de verificação Inscrição no Programa.
   • Nota:isto só se aplicará a autorizações de novos clientes.
     
   • Estão disponíveis novas API para recuperar informações da Inscrição DR ao nível de terceiros em massa, bem como ao nível de autorização individual do cliente (nível de ID de Cliente de retalho), delineado de acordo com o seguinte:
     Descarregue as novas API suportadas pela PGE (PDF)
   • API assíncrona para solicitar informações de inscrição DR para todas as autorizações a terceiros
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • API síncrona para solicitar informações de inscrição DR ao nível de autorização individual do cliente
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{IDClienteRetalho}

Nota: Além das alterações ao processo de autorização do cliente, outras alterações também são retrocompatíveis e são melhorias voluntárias que terceiros podem optar por apoiar.

Se tiver alguma dúvida ou precisar de apoio adicional, não hesite em enviar um e-mail para sharemydata@pge.com.

Novidades:

1. Os clientes podem agora beneficiar do processo simplificado de autorização Click-Through.
   • Atualizámos os detalhes sobre como um cliente pode agora partilhar dados com a sua empresa.
     Saiba como os clientes partilham dados com uma empresa
     
     Nota: Estas alterações, particularmente melhorias à nossa IU de autorização, foram otimizadas para dispositivos móveis (por exemplo, telefones ou tablets).
   • Foram feitas alterações ao processo de gestão de autorização acessível aos clientes através da sua conta online PG&E:
     • Um cliente pode ainda remover os DIVIDOS de uma autorização existente, prolongar a data de fim da autorização e/ou cancelar a autorização a qualquer momento. No entanto, para adicionar SAIDs adicionais e/ou alterar elementos de dados autorizados, a autorização existente tem de ser cancelada e tem de ser criada uma nova autorização.
2. Se desejado, terceiros podem agora usar esta API para revogar autorizações de clientes individuais usando o seu Token de Acesso de Cliente de terceiros (fornecido durante o processo inicial de registo de terceiros SMD) através de uma operação DELETE: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   Nota 1:Para a implementação da PG&E, o parâmetro AuthorizationID é o mesmo valor que o SubscriptionID.
   
   Nota 2:A nova API fornece a terceiros a capacidade de revogar (cancelar) uma autorização. No entanto, apenas os próprios clientes podem remover IDs de SA e/ou atualizar a data de fim da autorização através das nossas páginas de autorização de gestão SMD.
   
   Lembrete:Tal como acontece com todos os pedidos de dados API, os terceiros devem primeiro solicitar um novo Par de Tokens (Acesso de Cliente + Atualizar Token) utilizando os seus Tokens de Atualização mais recentes.
   
   Lembrete de Períodos de Validade do Token:
   • Token de acesso:1h
   • Token de Acesso do Cliente: 5 min
   • Tokens de atualização correspondentes: 1Yr
3. Os terceiros podem agora criar vários registos Partilhar os Meus Dados (SMD) utilizando o mesmo nome de empresa e ID Fiscal, se necessário. No entanto, o nome de exibição (que os clientes veem ao autorizar) ainda precisa ser único.
   
   Nota:Todas as alterações acima são compatíveis com versões anteriores e são melhorias voluntárias que terceiros podem optar por apoiar. Transferir documentos de apoio para esta versão:
   
   SUPORTADO_APIS.SMD_CLIQUE_1.0 (PDF)
   
   SUPORTE_ELEMENTOS_DADOS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DADOS_MODELO.SMD_CLICK-THRU_1.0 (PDF)
   
   ELEMENTOS_DE_DADOS_SUPORTADOS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

20 de dezembro de 2015

Alterações necessárias:as seguintes atualizações do SMD 2.0 requerem alterações por parte de terceiros.

1. Tendo em consideração terceiros com implementações GBCMD (Green Button Connect My Data) em vários utilitários, além da PG&E, iremos devolver os dadosCustodianID (ou seja, dadosCustodianID=PGE) no redirecionamento para terceiroPartyScopeSelectionScreenURI durante a sequência de autorização OAuth.
2. As solicitações de API que aceitam parâmetros de data (por exemplo, solicitação de lote), devem usar parâmetros de dados Zulu (por exemplo, publicado-máx/ publicado-mín). Não serão suportados outros formatos de data para os parâmetros de data em pedidos de API.
   • As API que aceitam parâmetros de data são documentadas de acordo com as API suportadas.xlsx
3. Indicadores TOU de intervalo incluídos com dados de utilização elétrica medidos em intervalos (conforme aplicável, indicador do período TOU a que cada intervalo corresponde)
   • Consulte os Mapeamentos estáticos de ID do Programa detalhando a que corresponde cada enumeração TOU de intervalo (por exemplo, 1 = Pico de Verão, etc.). (Ver anexo,Elementos de dados suportados.xlsx )
4. O ID_cliente, conforme encontrado nos dadosCustodianScopeSelectionScreenURI (utilizado para OAuth iniciada por terceiros) e fornecido no pedido de Recursos de Informação da Aplicação de terceiros durante o Teste de Registo, está a ser atualizado para 5 dígitos se ainda não estiver (por exemplo, adicionar zeros iniciais, etc.). Além disso, o URL já não inclui "&verified=true" no final. Os terceiros terão de atualizar os seus URL em conformidade.
   • Para elaborar, os dadosCustodianScopeSelectionScreenURI têm o seguinte aspeto: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX é a ID de cliente)
   • Assim, uma ID de cliente atual de 123 mudará para algo como 00123, o que significa que os seus novos dadosCustodianScopeSelectionScreenURI serão os seguintes:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (o URL antigo é o seguinte: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. Terceiros registados como "ESP" ou "Fornecedor de Serviços de Energia" estão a mudar para o Tipo de Utilizador Padrão. Não existem alterações funcionais, apenas no título do tipo de utilizador. Distinguir o tipo de utilizador ESP (do tipo de utilizador padrão) é uma diferenciação desnecessária, causando confusão durante o processo de registo sem fornecer qualquer funcionalidade diferenciada, pelo que está a ser retirada.

Melhorias opcionais: As seguintes alterações são retrocompatíveis e são melhorias voluntárias que terceiros podem optar por apoiar.

1. Os terceiros terão a capacidade de alterar/atualizar automaticamente os seus certificados SSL que forneceram originalmente durante o registo (por exemplo, quando os certificados estiverem prestes a expirar) através do portal de terceiros em gerir registo >Editar > nova secção: Informações do certificado SSL (opção de atualização).
2. Os terceiros podem se registrar para receber informações de cobrança básicas autorizadas, informações do cliente e dados de gás.  Tanto os clientes com medição de intervalocomo os clientes com medição sem intervalo serão elegíveis para autorizar a partilha de dados para SMD 2.0. Um resumo de alto nível dos elementos de dados recentemente disponíveis é o seguinte:
   • Informações de faturação: (para SA com medição de intervalo e sem intervalo)
     • Tabela de preços, totais de faturação de $, utilização por níveis (conforme aplicável), Procura (conforme aplicável), totais de TOU (conforme aplicável)
     • Nota: Para clientes com medições não relacionadas com intervalos autorizados, terceiros apenas receberão totais de utilização de faturação (ou seja, no Resumo de Utilização) e nenhuma leitura de utilização de intervalo (por exemplo, leituras horárias/diárias, uma vez que não estão disponíveis)
   • Informações do cliente: (para SAs com e sem intervalos)
     • Nome do Cliente, Endereço do Serviço, ID da Conta, ID do Contrato de Serviço, Data de Início do Serviço do Contrato de Serviço,
   • Dados de uso de gás de intervalo: (somente SAs de gás medidos por intervalo)
     • Leituras de gás de intervalo (ou seja, diárias)
   • Os novos elementos de dados são traçados de acordo com o anexo,Elementos de dados suportados.xlsx
   • A hierarquia de dados relacionais associada é descrita no Modelo de Dados PGE ESPI.xlsx
   • As definições mais recentes de esquema de xml ESPI (XSDs) usadas para esses novos elementos de dados estão de acordo com os XSDs anexados. Nota:os XSDs são compatíveis com versões anteriores:
     • espiDerived.xsd (Informação de utilização e faturação)
     • retailcustomer.xsd (informações do cliente)

Caso tenha quaisquer dúvidas ou necessite de apoio adicional, não hesite em contactar-nos através do e-mail ShareMyData@pge.com.

18 de dezembro de 2015
 

Alterações necessárias: as seguintes atualizações do SMD 2.0 requerem alterações por parte dos utilizadores que acedem aos seus próprios dados:

1. As solicitações de API que aceitam parâmetros de data (por exemplo, solicitação de lote), devem usar parâmetros de dados Zulu (por exemplo, publicado-máx/ publicado-mín). Não serão suportados outros formatos de data para os parâmetros de data em pedidos de API.
   • As API que aceitam parâmetros de data são documentadas de acordo com as API suportadas.xlsx
2. Indicadores de Tempo de Utilização do Intervalo (TOU) incluídos com dados de utilização elétrica medidos em intervalos (conforme aplicável, indicador do período TOU a que cada intervalo corresponde)
   • Consulte os Mapeamentos estáticos de ID do programa detalhando a que corresponde cada enumeração TOU de intervalo (por exemplo, 1 = Pico de verão, etc.). (Ver anexo,Elementos de dados suportados.xlsx )

Melhorias opcionais: As seguintes alterações são retrocompatíveis e são melhorias voluntárias que terceiros podem optar por apoiar.

1. Os utilizadores de Auto-acesso terão a capacidade de alterar/atualizar automaticamente os seus certificados SSL que forneceram originalmente durante o registo (por exemplo, quando o certificado estiver prestes a expirar) através do portal de terceiros em gerir registo > Editar > nova secção: Informações do certificado SSL (opção de atualização)
2. Os registos do utilizador de Auto-acesso serão atualizados para incluir informações de faturação básicas autorizadas, informações do cliente e dados de gás. Tanto os Acordos de Serviço de medição de intervalo como os Acordos de Serviço de medição não-intervalo serão elegíveis para (auto)autorização para SMD 2.0 Um resumo de alto nível dos elementos de dados recentemente disponíveis é o seguinte:
   • Informações de faturação: (para SAs com medição de intervalo e sem intervalo)
     • Tabela de preços, totais de faturação de $, utilização por níveis (conforme aplicável), Procura (conforme aplicável), totais de TOU (conforme aplicável)
     • Nota: Para clientes com medições não intercalares autorizados, terceiros apenas receberão totais de utilização de faturação (ou seja, no Resumo de Utilização) e nenhuma leitura de utilização de intervalo (por exemplo, leituras horárias/diárias, uma vez que não estão disponíveis)
   • Informações do cliente: (para SA com medição de intervalo e sem intervalo)
     • Nome do Cliente, Endereço do Serviço, ID da Conta, ID do Contrato de Serviço, Data de Início do Serviço do Contrato de Serviço,
   • Dados de uso de gás de intervalo: (somente SAs de gás medidos por intervalo)
     • Leituras de gás de intervalo (ou seja, diárias)
   • Os novos elementos de dados são traçados de acordo com o anexo,Elementos de dados suportados.xlsx
   • A hierarquia de dados relacionais associada é descrita no Modelo de Dados PGE ESPI.xlsx em anexo
   • As definições mais recentes de esquema de xml ESPI (XSD) utilizadas para estes novos elementos de dados estão de acordo com os XSD anexos. Nota:os XSDs são compatíveis com versões anteriores:
     • espiDerived.xsd (Informação de utilização e faturação)
     • retailcustomer.xsd (informações do cliente)

Caso tenha quaisquer dúvidas ou necessite de apoio adicional, não hesite em contactar-nos através do e-mail ShareMyData@pge.com.

18 de dezembro de 2015
 

Alterações necessárias: as seguintes atualizações do SMD 2.0 requerem alterações por parte das implementações do CCA.

1. Os pedidos ad hoc (por exemplo, para dados históricos) devem ser feitos usando os parâmetros de data de hora Zulu. Não serão suportados outros formatos de data para os parâmetros de data em pedidos de API.
2. O feed diário de utilização em massa começará a incluir informações básicas de faturação, enquanto o feed diário de clientes em massa incluirá informações adicionais do cliente. Estes novos dados serão fornecidos tanto para clientes com medição de intervalo para os quais recebem dados atualmente, como para clientes com medição não de intervalo no seu território para os quais não recebem dados atualmente. Por último, os valores de utilização de intervalo fornecidos no feed de utilização diária em massa incluirão indicadores de TOU de intervalo, quando aplicável. O resumo de alto nível dos novos elementos de dados é o seguinte:
   • Informações de faturação: (para SAs com medição de intervalo e sem intervalo)
     • Tabela de preços, totais de faturação de $, utilização por níveis (conforme aplicável), Procura (conforme aplicável), totais de TOU (conforme aplicável)
   • (Adicional) Informações do Cliente: (tanto para SAs com medições de intervalo como sem intervalos)
     • Nome do cliente, Endereço do serviço, Data de início do serviço do contrato de serviço, ID da conta
   • Indicadores TOU de intervalo incluídos com dados de utilização elétrica medidos em intervalos (conforme aplicável, indicador do período TOU a que cada intervalo corresponde)
     • Consulte os Mapeamentos estáticos de ID do programa detalhando a que corresponde cada enumeração TOU de intervalo (por exemplo, 1 = Pico de verão, etc.). (Ver anexo,Elementos de dados suportados.xlsx )
   • As definições mais recentes de esquema de xml ESPI (XSD) utilizadas para estes novos elementos de dados estão de acordo com os XSD anexos. Note que os XSD são compatíveis com versões anteriores:
     • espiDerived.xsd (Informação de utilização e faturação)
     • retailcustomer.xsd (Informações do cliente)
   • Os novos elementos de dados são traçados de acordo com o anexo,Elementos de dados suportados.xlsx
   • A hierarquia de dados relacionais associada é descrita no Modelo de Dados PGE ESPI.xlsx em anexo

Melhorias opcionais: As seguintes alterações são retrocompatíveis e são melhorias voluntárias que terceiros podem optar por apoiar.

1. Os CCA podem fazer pedidos ad hoc de informações do cliente em: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (devolve o último instantâneo das informações do cliente no momento do pedido), além da notificação diária recebida.
2. Os CCA terão a capacidade de alterar automaticamente o seu certificado SSL que forneceram originalmente durante o registo (por exemplo, quando o certificado estiver prestes a expirar) através do portal de terceiros, em gerir registo > Editar > nova secção: Informações do certificado SSL (opção de atualização)

Caso tenha quaisquer dúvidas ou necessite de apoio adicional, não hesite em contactar-nos através do e-mail ShareMyData@pge.com.

21 de agosto de 2015
 

Novidades:

1. Alterações de URI de recursos e parâmetros de estado nas respostas Oauth
   • Como parte do pedido de código de autorização OAuth, o terceiro tem a opção de enviar um parâmetro de estado que a PG&E enviaria de volta ao terceiro. A PG&E também enviará o código de autorização após a conclusão bem-sucedida da autorização. Este parâmetro de estado opcional pode ser utilizado para ajudar o terceiro a identificar onde o pedido foi iniciado e para associar o pedido às autorizações que iniciaram.
   • Como parte da conclusão bem-sucedida do pedido de token, partilhamos recursos de voltaURI e autorizaçãoURI separadamente das informações do token. Atualmente estas URI são invertidas e como parte desta versão iremos corrigir isso.

Defeitos fixos:

1. Datas predefinidas publicadas-máx e publicadas-mín
   Atualmente, a PG&E obriga o terceiro a enviar em períodos de segundos os parâmetros de publicação-mín e publicação-máx para cada pedido de dados, para informar a PG&E da duração para a qual está a solicitar dados. Estamos a implementar uma alteração para lidar com pedidos para os seguintes cenários:
   • valores publicados mínimos e máximos estão em falta
   • Os valores publicados mínimos e máximos estão em UTC
   • Os valores publicados mínimos e máximos estão em períodos de segundos
   Caso os parâmetros estejam em falta, a PG&E devolverá as datas predefinidas, ao contrário das mensagens de erro devolvidas antes desta alteração. A predefinição, no nosso caso, são os dados de um dia para a data T-2. Se os parâmetros estiverem presentes e formatados correctamente, continuaremos a honrar os parâmetros.
2. Corrigir datas em autorização xml
   Atualmente no xml de autorização partilhamos a data publicada e a data de autorização. Estas datas são em milésimos de segundo em vez de segundos, o que é o padrão. Estamos corrigindo para ser enviado de volta em períodos de segundos em vez de milissegundos.
3. XML incorreto devolvido para /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Actualmente, estamos a devolver uma resposta incorrecta para o GET ao nível dos recursos acima, onde a estrutura do XML está incorrecta e estamos a repetir entradas para cada intervalo em vez de criar um único bloco de intervalo durante 24 horas.
   
   Isto está a ser corrigido e apenas um único bloco de intervalo será devolvido para um bloco de intervalo de 24.

Dúvidas ou preocupações? ContacteShareMyData@pge.com.

• Os clientes autorizam-no a aceder aos seus dados através de My Energy, a sua conta online PG&E. Para obter uma visão geral detalhada de como os clientes podem autorizar terceiros ou outras entidades a aceder aos seus dados, consulte Partilhar os Meus Dados Visão Geral de Terceiros.

Ir para detalhes da autorização

• Atualmente, não há limite.

• Os clientes podem escolher um período de tempo específico para o qual pode aceder aos seus dados ou podem deixar o período de autorização aberto.
• A sua candidatura pode verificar a data de fim de uma autorização de cliente juntamente com outros detalhes de autorização ligando para as API de recursos de autorização (por exemplo, .../espi/1_1/resource/Authorization e/ou.../espi/1_1/resource/Authorization/{AuthorizationID}).
• Em alternativa, pode verificar manualmente as datas de fim da autorização iniciando sessão na sua conta e selecionando Gerir autorizações.

• Se um cliente escolher um período de autorização definido, a sua autorização expira no final desse período de tempo. Se cancelarem a autorização, a sua autorização expira no dia seguinte ao cancelamento da autorização.
• Se um cliente escolher Indefinido como o seu período de autorização, então a sua autorização não expira. Tenha em atenção que, tendo em conta os Provedores de Resposta à Procura da Regra 24 e outros programas que utilizam Partilhar os Meus Dados, podem ser fornecidas correções após o facto para intervalos de datas previamente autorizados a terceiros até três anos após a expiração da autorização.
• Consulte "Como serão tratadas as correções de dados?" para mais detalhes sobre como receber correções.

• Qualquer cliente da PG&E com uma ID de Serviço atualmente ativa para serviços a gás ou elétricos pode autorizá-lo a aceder aos seus dados usando a nova ferramenta Partilhar Os Meus Dados.

• Os clientes interessados em participar na partilha dos seus dados através do programa Partilhar os Meus Dados são altamente encorajados a registar-se numa conta My Energy. Isto tornará todo o processo mais eficiente e também lhes dará a capacidade de gerir as suas autorizações online.
• Os clientes podem inscrever-se numa conta My Energy durante o processo de autorização.
• Existe um processo manual disponível para os clientes obterem online um Formulário de Autorização de Partilha dos Meus Dados e enviarem o formulário preenchido por e-mail.
• Para mais informações sobre o processo manual, contacte-nos através do e-mail ShareMyData@pge.com.

• Os clientes são obrigados a fazer as suas próprias autorizações online através da sua conta online PG&E. No entanto, se preencherem e assinarem o formulário Partilhar a minha autorização de dados, pode enviá-lo para a PG&E em seu nome.

Transferir o formulário Partilhar os meus dados Autorização de cliente ou revogação de autorização (PDF, 308 KB)

• Pode atualizar os seus URI OAuth iniciando sessão na sua conta, navegando para Gerir Registo > Editar > e atualizando os campos na secção Informações OAuth 2.0.

• Pode atualizar o seu URI de Notificação iniciando sessão na sua conta, navegando para Gerir Registo > Editar > e atualizando os campos na secção Informações de Acesso a Dados.

• Pode atualizar o seu certificado SSL iniciando sessão na sua conta, navegando em Gerir registo > Editar > e selecionando "Atualizar" na secção Informações do certificado SSL. Tenha em atenção que, para carregamentos de novos certificados, pode demorar vários dias a atualizar os sistemas da PG&E com o novo certificado.  
• Será enviado um e-mail de confirmação da equipa de Partilhar os Meus Dados quando o novo certificado tiver sido aplicado.

• Depois de receber um e-mail a indicar que o seu registo foi aceite, poderá iniciar sessão na sua conta Partilhar os Meus Dados e transferir o nosso Certificado SSL através da página Transferir Certificado SSL da PG&E.

Iniciar sessão para partilhar os meus dados

• Partilhar Os meus dados segue o Botão verde Ligar os meus acordos de implementação de dados. O Share My Data também utiliza o OAuth 2.0 para autorização, o Transport Layer Security (TLS) 1.2 e o conjunto mínimo de protocolos de cibersegurança aprovados pelo NIST (National Institute of Standards and Technology) para que nenhuma informação seja trocada de forma clara.

• Proteger as informações dos clientes é uma das principais prioridades da PG&E. A PG&E trata as informações sobre os seus clientes, incluindo informações pessoais, como confidenciais, consistentes com todos os requisitos legais e regulamentares, incluindo os estabelecidos pela Comissão de Serviços Públicos da Califórnia e outros.  
• Durante mais de duas décadas, a PG&E e outras companhias elétricas detidas por investidores na Califórnia estão sujeitas a regulamentos CPUC muito rigorosos que os proíbem de divulgar informações específicas do cliente, como dados de faturação, a terceiros sem o consentimento expresso do cliente.  
• Quando um cliente autoriza a divulgação de dados, é da responsabilidade do cliente e de terceiros proteger esses dados.
• Um cliente pode optar por parar de partilhar dados com terceiros a qualquer momento, iniciando sessão na sua conta online da PG&E e cancelando a sua autorização. A política de privacidade completa da PG&E e o Aviso de Acesso, Recolha, Armazenamento, Utilização e Divulgação de Informações sobre Utilização de Energia estão disponíveis empge.com/privacy.

• No âmbito do programa Partilhar os Meus Dados, os Terceiros estão sujeitos às Regras de Proteção e Privacidade de Dados do Cliente especificadas nos termos e condições da plataforma Partilhar os Meus Dados e aos requisitos incluídos na Tarifa de Acesso aos Dados do Cliente.
• Os terceiros também estão sujeitos a todas as outras leis e regulamentos aplicáveis relacionados com a proteção da privacidade do cliente, incluindo, mas não se limitando às Regras Relativas à Proteção da Privacidade e Segurança para Dados de Utilização de Energia adotadas pelo CPUC como Anexo D à Decisão 11-07-056 (Elétrica), também resumidas na Regra Elétrica N.o 27 da PG&E, e na Secção 1798.80 – 1798.84 do Código Civil da Califórnia.
• Para mais informações, selecione as ligações abaixo:
  Partilhar os termos e condições dos meus dados (PDF, 190 KB)
  Regra elétrica n.o 27 (PDF, 1,6 MB)
  Anexo D à Decisão 11-07-056 (PDF)
  Encontre mais informações:Código Civil da Califórnia Secção 1798.80 – 1798.84

• Consulte a ligação abaixo para obter uma lista detalhada dos elementos de dados que são suportados.

Obtenha mais informações sobre o acesso a dados

• Ocasionalmente, os dados de utilização de intervalos estão em falta porque os nossos processos de validação de dados a montante consideram que existem leituras de dados em falta ou incorretas que podem exigir processamento adicional (edição e/ou estimativa).
• Para clientes com fatura de intervalo (por exemplo, clientes com considerações de faturação de Tempo de Utilização), estas instâncias são corrigidas a tempo para garantir o cálculo preciso da fatura na sua próxima fatura mensal.

• Se pretender receber correções de dados, certifique-se de que marca a caixa de verificação Notificar-me como Dados prontos durante o registo ou iniciando sessão na sua conta online e selecionando esta caixa de verificação em Editar perfil. Iremos então incluir correções de dados que foram capturadas pelo nosso sistema durante as 24 horas anteriores, como parte do feed de utilização diária, para quaisquer dados a que esteja autorizado a aceder.
• As correções de dados irão abranger quaisquer alterações durante o período autorizado, até um máximo de três anos.

Nota: Tendo em conta os Fornecedores de Resposta à Procura da Regra 24 e outros programas que utilizam Partilhar os Meus Dados, podem ser fornecidas correções após o facto para intervalos de datas previamente autorizados a terceiros até três anos após o termo da autorização.

• Se aplicável, a PG&E enviará notificações para o seu URL de notificação fornecido durante o registo. As notificações incluem URLs correspondentes a dados já pré-embalados prontos para que volte e solicite nos URLs fornecidos. Os dados são pré-embalados e as notificações são enviadas nos dois cenários seguintes: (1) selecionou "Notificar-me quando os dados estiverem prontos" no seu perfil de registo, caso em que iremos empacotar os dados diários mais recentes com quaisquer correções para datas passadas, ou (2) fez um pedido assíncrono ad hoc anterior para o qual os dados solicitados estão agora prontos. O Cenário 1 é ilustrado sob o "ACESSO A DADOS: SUBSCRIÇÃO DIÁRIA" dos diagramas de Métodos de Acesso a Dados na Página de Acesso a Dados e cenário 2 é ilustrado sob o "ACESSO A DADOS: PEDIDO AD HOC (ASINCRONÓTICO)" dos mesmos diagramas também na Página de Acesso aos Dados.

Acesso aos dados da consulta acima

• Os dados de utilização elétrica fornecidos por Partilhar Os Meus Dados não são Dados do Medidor de Qualidade de Liquidação (SQMD), conforme especificado pelo Operador Independente do Sistema da Califórnia (CAISO). O SQMD é gerado multiplicando os Dados do Medidor da Qualidade da Receita (RQMD) pelo Fator de Perda de Distribuição (DLF) aplicável ao nível de tensão desse cliente para esse intervalo, convertendo os intervalos medidos para o período de intervalo exigido pelo CAISO e, em seguida, somando os resultados de cada intervalo para o nível agregado exigido pelo CAISO.
  
• A PG&E está a implementar sinalizadores do tipo "Qualidade de Leitura" (QOR) fornecido pela norma ESPI para comunicar se os dados são de Qualidade de Receita. O Tipo QOR captura diferentes valores de qualidade possíveis para dados de utilização, incluindo um valor explícito para “Dados do Medidor de Qualidade de Receitas” ou “RQMD”. A PG&E utilizará este Tipo QOR na sua transmissão de dados da seguinte forma:
  • A PG&E suporta a classe "UsageSummary" fornecida pelo ESPI, que será usada para identificar as datas pelas quais um contrato de serviço é faturado, o valor de utilização faturado e a qualidade dos dados de utilização no momento do pedido. O UsageSummary será preenchido assim que a fatura estiver disponível para os dados solicitados e incluirá dois sinalizadores (elementos) do Tipo QOR:
    • O elemento UsageSummary.QualityOfReading (ao nível do UsageSummary) indica a qualidade no momento do pedido dos últimos valores de utilização de intervalo fornecidos, mais correções correspondentes às datas UsageSummary.billingPeriod.
    • O elemento de qualidadepadrão para OverallConsumptionLastPeriod (como parte de UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) indicando a qualidade da utilização total faturada.
  • A PG&E também comunicará a qualidade dos dados de utilização ao nível do intervalo no momento do pedido utilizando o elemento IntervalReading.ReadingQuality.Quality.

• Durante o registo, pode selecionar a quantidade de dados históricos de que necessita, 24, 36 ou 48 meses, no menu pendente "Quantos dados históricos são solicitados".
• Como parte da autorização de um cliente que lhe permite aceder aos seus dados, o período histórico de autorização será predefinido para a sua seleção de registo para os IDs de Serviço (pontos de utilização) incluídos na autorização.
• Pode atualizar os seus dados históricos solicitados, iniciando sessão na sua conta, navegando para Gerir registo > Editar > e selecionando a partir do menu suspenso rotulado "Quantos dados históricos são solicitados".
• Tenha em atenção que os dados fornecidos no pedido histórico irão começar com a data em que o cliente faz a autorização, em oposição à data em que faz o pedido à API.

Nota: as alterações aos seus dados históricos solicitados apenas afetam as autorizações de novos clientes, enquanto as autorizações de clientes anteriores irão refletir a sua seleção no momento da autorização.

• De acordo com a norma ESPI, a resposta utiliza a Norma de Publicação Atom. Selecione a ligação abaixo para ver uma lista completa das API que são suportadas, juntamente com os elementos de dados disponíveis.

Obtenha mais informações sobre o acesso a dados

• As IDs de Serviço de eletricidade e gás ativas instaladas e lidas pela PG&E são elegíveis para autorização através da plataforma Partilhar Os Meus Dados.
• Se a ID de Serviço associada a uma autorização mudar devido a um dos seguintes motivos, a autorização irá transitar para a nova ID de Serviço e o acesso aos dados históricos de utilização do intervalo irá continuar:
  • Encerramento temporário devido a não pagamento
  • Mover para Facturação de Intervalo
  • Troca de medidor
  • Alteração de taxa
• Outros cenários que resultem numa alteração na ID de serviço, tais como mudança de local ou a alteração de uma empresa, irão terminar o acesso. Além disso, se uma conta for desvinculada da sua conta My Energy, todas as IDs de Serviço subjacentes que foram autorizadas através de Partilhar Os Meus Dados não serão autorizadas como resultado.

• Para determinar a granularidade dos dados de intervalo autorizados, consulte o elemento Comprimento do intervalo conforme fornecido pela norma ESPI.
• A PG&E está a fornecer dados de utilização de intervalos com a mesma granularidade que os recolhidos para fins de faturação, que geralmente é de hora a hora ou de 15 minutos para dados elétricos e diariamente para dados de gás para os clientes com medidores de intervalos. Embora possa variar de acordo com o cliente, a utilização de contadores de intervalos elétricos está geralmente disponível ao nível da hora para a maioria dos clientes residenciais e ao nível de intervalos de 15 minutos para a maioria dos clientes comerciais, e a utilização de contadores de intervalos de gás está geralmente disponível ao nível diário para a maioria dos clientes.
• Para medidores sem intervalo, os dados serão fornecidos quando disponíveis.

• Para a grande maioria dos clientes da PG&E com um Smart Meter instalado, os dados de utilização de intervalos elétricos e de gás estão disponíveis no final do dia seguinte através da plataforma Partilhar Os Meus Dados.
• A pequena porção de clientes elétricos da PG&E com medidores MV90 instalados com base em operadora de linha elétrica pode exigir tempo adicional para que os dados estejam disponíveis.

• Embora não possamos suportar diretamente a configuração das suas API, temos vários recursos disponíveis para ajudar os seus recursos técnicos e de TI no processo de desenvolvimento. Consulte a nossa página de Documentação API para saber mais. Não hesite em contactarShareMyData@pge.comcom quaisquer questões adicionais.

Para mais informações, visite a interface de programação da aplicação (API)