Partilhar os meus dados com terceiros

Para 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:

Transferir o diagrama de sequência ESPI OAuth 2.0 (PDF, 193 KB)
Ver o SDK de dados Green Button em Github

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

Autorizações iniciadas no centro de terceiros

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 pedido)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state de URIopcionalEstado}

• Parâmetros de Pedido Obrigatório:
  • client_id = ID de cliente dos seus marcos de registo Partilhar Os Meus Dados (ou seja, par client_id/client_secret).
  • redirect_uri = redireccionar URL que especificou no seu registo Partilhar os Meus Dados (os URL têm de 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 evitar a falsificação entre locais.
  • início de sessão de despedido} Ofereça 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

OBTENHA: 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 capturados adicionalmente 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 de volta 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, em seguida, 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 questionaram 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 o 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 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 simplesmente definindo o URI do Portal de Terceiros para igualar o URI "Ecrã de Seleção de Âmbito de Terceiros" já não utilizado (campo a ser retirado numa versão futura).

Por outro lado, 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 o recebimento de um Código de Autorização.

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

• Parâmetros de Pedido Obrigatório:
  • grant_type = 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 = redireccionar URL que especificou no seu registo Partilhar os Meus Dados (os URL têm de 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 desordem_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 Share My Data.
O parâmetro do cabeçalho estará no seguinte formato:
Nome do parâmetro: Valor do parâmetro de autorização
: "Cadeia codificada base64" básica

Uma resposta bem-sucedida será a seguinte:

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;DuraçãoIntervalo=900_3600;Duração do bloco=Diariamente;HistorialComprimento 3P Comprimento histórico registado};Colheita de Contas . Contagem de SAs autorizados};BR de IDTerceiro};dadosIDCustodian=PGE
recursoURI:{ResourceURI} por exemplo: https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
authorizationURI:{AutorizaçãoURI} por exemplo: https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
clienteResourceURI:{clienteResourceURI} por exemplo:https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

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 despedida despedida descontínua

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

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: Valor do parâmetro de autorização
: "Cadeia codificada base64" básica

Uma resposta bem-sucedida terá este aspecto:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"token_type": "Portador",
"expira_em": 3600,
"atualizar_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_
_Inscrição;DuraçãoIntervalo=900_3600;Duração do bloco=Diariamente;HistorialComprimento 3P Comprimento histórico registado};Colheita de Contas . Contagem de SAs autorizados};BR de IDTerceiro};dadosIDCustodian=PGE",
"resourceURI": "https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ",
"URI de autorização": "https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Authorization/test "
}

Nota: 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 um novo par de Token de Acesso do Cliente/Kon 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 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 a 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: A seção SUBSCRIÇÃO DIÁRIA” dos diagramas de Métodos de Acesso a Dados abaixo e Cenário 2 é ilustrada na seção “ACESSO A DADOS: PEDIDO AD HOC (ASINCRONIZADO)" dos mesmos diagramas abaixo.

Lembre-se da vida útil 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. 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 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 do cliente é usar a API síncrona para solicitar informações do cliente para uma única autorização do cliente para dados do cliente (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 = irá 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 Notificações Pós-Serviço 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/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID fornecido na aplicaçãoRecurso de informação recuperado durante o teste de registo. (ID de 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 a pré-embalagem. 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-Serviço que lhe enviaremos (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 a pré-embalagem. 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 de deslocaçãoData}&published-max de deslocaçãoData}

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. O ID de subscrição faz parte do parâmetro resourceURI na resposta do token. (ID da subscrição=ID do clientede 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 ().

As API de utilização síncronas (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, o nível do Contrato de Serviço), pelo que uma aplicação iria percorrer 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 e faturas mensais que se sobrepuseram ao intervalo de datas solicitado (em ).

• A leitura de intervalocontém dados de uso de gás de 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 de menos entregue 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)
  • Direçã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 deslocaçãoData}&published-max de deslocaçãoData}

Subscription ID = SubscriptionID que você 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 hora. 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 hora. 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 regressar para obter a pré-embalagem. 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 des e 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 em lote (terceiros Standard e EEF)
Também pode solicitar informações de utilização e faturação através da API assíncrona em lote para todas as suas autorizações de 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}?published-min de desencadearData}&publishedmax deencadearData}

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

publicado-min = data de início que será aplicada a este pedido de extração de dados. (RFC 3339 formato zulu hora. 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 hora. 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 regressar para obter a pré-embalagem. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID desfraldeID descorrelationID desfralde/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-Serviço que lhe enviaremos (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 a pré-embalagem. A amostra de pós-notificação tem o seguinte aspeto:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID desfraldeID descorrelationID desfralde/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 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 usada 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 uma 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 padrão ESPI, e não parte do ESPI original]

    

6. Lançamento de 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 DISSO autorizado será identificado como RES, AGR, COM/IND ou Outro.
2. As API 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 aos publicados-mín. e publicados-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
EDS: Elementos de
Serviço de Bloqueio
de Interrupção UUID
PG&E ID
de Serviço Alterações Futuras ao Estado do Serviço
Estado
SA Data
de Início do Serviço Endereço
do Serviço Tarifa
Atual Serviço Histórico Faturado Opções de Tarifa
de Serviço (Base Médica, CUIDADOS, FERA, TBS, CCA_TBS, Tensão de Serviço de Corrente de Escolha
Solar e Mercadoria Histórico Tensão
de Serviço Faturada Número
do Medidor de Serviço Número de Medidores
de Serviço Tipo
de Medidor de Corrente Ciclo
de Leitura do Medidor Histórico do Ciclo de
Leitura da Corrente de Faturação Opção de Taxa de Espera se Indicador de
Geração no Local Histórico Opção
de Taxa de Espera Faturada EDS: Indicador de
classe do cliente Elementos
históricos de faturação Data de
início da fatura Data de
fim da fatura Custos totais da fatura ($)
kWh
total EDS: Nome do fornecedor
de serviços Historical Bill Tier Breakdown (se houver)
EDS: EDS do Período
de Faturação do Item de Linha: 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 do histórico da fatura (exceto para ABS-TX faturado)
EDS: Período de Faturação do 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)
EDS histórico de quebra de
demanda de contas: Período de Faturação do 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 históricos da fatura EDS: EDS do período
de faturação do item de linha: Nome da cobrança (DWR Bond Charge)
EDS: Volume (1234.2)
EDS: Unidade (kWh)
EDS: Taxa ($0.032/kWh)
EDS: Custo ($100.23)
Intervalos
históricos de utilização Intervalo de utilização Início
de utilização Duração predefinida do intervalo (em segundos)
Volume de utilização do intervalo (1234.2)
Nome
do programa de resposta à demanda (DR)
da unidade (kWh/Therms) Nome do
programa Primeira data de rescisão sem obrigação
financeira Primeira data de rescisão independentemente da obrigação
financeira Estado
do programa DR Data
de inscrição do programa DR Data
de cancelamento do registro do programa Data do item
de dados Parâmetros de hora local da mercadoria
(detalhes DST)
Predefinição Qualidade
de dados Direção de energia
de dez multiplicadores (para valores de uso de intervalo)
Potência de dez multiplicadores (para demanda faturada)
Potência de dez multiplicadores (para uso total faturado)
Duração do intervalo (de leitura de uso)
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 Partilhar Os Meus Dados, a PG&E lançou a Fase 2 de Click-Through a 28 de junho de 2018.

Novidades:

As alterações mais críticas que afetam terceiros são alterações para estar 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 clientedeixará 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 de opcionalState}
   • O seguinte parâmetro de avaliação foi reformado: 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 e sejam 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 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 o cliente pareça que são levados diretamente para uma página de autorização ao selecionar um terceiro no menu pendente. 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 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 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:Download Supported Function Block Scope String Mapping Click Thru 2.0 (PDF)
   
   Um exemplo de resposta Token abaixo ilustra alguns valores possíveis de parâmetros de escopo.
   • Exemplo de resposta de token:
     
     774ff105-7ad5-40c8-a6ec-f60675dc0e41
     3600
     998c6654-5b3b-4385-af4f-4e5c46c1bb04
     
     recursoURI:{ResourceURI} por exemplo: https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     authorizationURI:{AutorizaçãoURI} por exemplo: https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     clienteResourceURI:{clienteResourceURI} por exemplo:https://api.fls.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Os terceiros podem agora registar-se para receber informações de Inscrição no Programa autorizadas através do novo grupo de dados de "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 Clique 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 Espera, 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 a opção 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 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ódigopostal...
   • Contrato do cliente
     • estado\valor (Estado SA
   • Programa de resposta à demanda
     • Nome do programa
     • Estado de inscrição
     • programDate/programDate
     • programDate/programDateDescriçã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:
     Faça download do código postal XSDs (ZIP, 49 KB). Abre numa nova janela.
     Nota: os XSD são compatíveis com versões anteriores.
   • Os terceiros terão a capacidade de 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 de Inscrição DR ao nível de terceiros a granel, bem como ao nível de autorização do cliente individual (nível de ID de Cliente de retalho), delineadas 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 + Token de Atualização) utilizando os seus Tokens de Atualização mais recentes.
   
   Lembrete de períodos de expiração 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 retrocompatíveis e são melhorias voluntárias que terceiros podem optar por apoiar. Transferir documentos de apoio para esta versão:
   
   SUPORTADO_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   SUPORTE_ELEMENTOS_DADOS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DADOS_MODELO.SMD_CLIQUE_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 API.
   • As API que aceitam parâmetros de data são documentadas de acordo com as API.xlsx suportadas em anexo
3. Indicadores TOU de intervalo incluídos com dados de utilização elétrica medidos em intervalo (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 Recurso de Informação da Aplicação, o pedido 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 será 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 de 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 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 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 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 de 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,Supported Data Elements.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 (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 questões 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 API.
   • As API que aceitam parâmetros de data são documentadas de acordo com as API.xlsx suportadas em anexo
2. Indicadores do Tempo de Utilização do Intervalo (TOU) incluídos com os dados de utilização elétrica do Intervalo medido (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 de utilizador de Auto-acesso serão atualizados para incluir informações de faturação básicas autorizadas, informações de cliente e dados de gás. Tanto os Acordos de Serviço com medição de intervalos como os Acordos de Serviço com medição sem intervalos 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 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 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 de 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,Supported Data Elements.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 (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 questões 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.0requerem 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 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 sem intervalo no seu território para os quais não recebem dados atualmente. Por fim, 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: (para SAs com e 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 os dados de utilização elétrica medidos em intervalo (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

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)

Se tiver alguma dúvida ou precisar 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 vincular o pedido às autorizações que iniciaram.
   • Como parte da conclusão bem-sucedida do pedido de token, partilhamos o recurso de voltaURI e o authorizationURI 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 parâmetros publicados-mín e publicados-máx em períodos de segundos 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, em oposição às mensagens de erro como 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 as datas no xml de autorização
   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 oposição a segundos, 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
   Atualmente, estamos a devolver uma resposta incorreta para o nível de recurso GET acima, onde a estrutura do XML está incorreta 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 bloco de intervalo único será devolvido para um bloco de intervalo de 24.

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

• Os clientes autorizam-no a aceder aos seus dados através de My Energy, a sua conta online da 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 aplicação 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 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 durante 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 de gás ou elétricos pode autorizar que aceda 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. Note 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 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 outros serviços públicos detidos por investidores na Califórnia têm sido sujeitos 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)
  Encontrar mais informações:Califórnia Código Civil 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 assinala a caixa de verificação Notificar-me quando os dados estiverem 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 para 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 URL de notificação fornecido durante o registo. As notificações incluem URLs 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 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á utilizada para identificar as datas pelas quais um contrato de serviço é faturado, o montante 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 valores de utilização de intervalo mais recentes fornecidos, mais correções correspondentes às datas do UsageSummary.billingPeriod.
    • O elemento DefaultQuality 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 uso no nível de intervalo no momento da solicitação usando 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

• Os IDs de Serviços ativos de eletricidade e gás instalados e lidos 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 Faturação em 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 cliente para cliente, a utilização de conta-intervalos elétricos está geralmente disponível a nível horário para a maioria dos clientes residenciais e a nível de intervalo de 15 minutos para a maioria dos clientes comerciais, e a utilização de conta-intervalos de gás está geralmente disponível a 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 até ao 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 baseados em operadora de linha elétrica instalados 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)