Compartir mis datos con terceros

Para cumplir con el estándar actual de autorización de la Interfaz de proveedor de servicios de energía (Energy Service Provider Interface, ESPI) de la Junta de Normas de Energía de América del Norte (North American Energy Standards Board, NAESB), PG&E ha implementado el marco de autorización OAuth 2.0 para autorizar el acceso a los datos. El siguiente diagrama ilustra cómo los clientes inician la autorización, eligen los parámetros del alcance y luego envían su autorización.

Material de referencia adicional más allá de la información a continuación:

Descargue el diagrama de secuencia de ESPI OAuth 2.0 (PDF, 193 KB)
Ver el SDK de datos del botón verde en Github

Nota: Para los agregadores de Community Choice, solo se necesita client_access_token para solicitar datos (a través de 2-Legged OAuth) y no se aplica lo siguiente.

Autorizaciones iniciadas en el sitio de terceros

Para comenzar una autorización de un sitio de terceros como se ilustra en el primer diagrama anterior, se realiza una solicitud de código de autorización redirigiendo el navegador del cliente desde su sitio de terceros a la URL del punto final de autorización del servidor de autorización de PG&E con los parámetros de solicitud adecuados como se muestra a continuación. Tras la redirección, se le presentará al cliente una página de inicio de sesión de PG&E para la autenticación, seguida de una página de autorización para autorizar el acceso a los datos a su tercero:

authorizationServerAuthorizationEndpoint URI (con parámetros de solicitud)
https://sharemydata.pge.com/myAuthorization?client_id=A1b2C3&redirect_uri={redirect_uri}&response_type=code&state={optionalState}

• Parámetros de solicitud obligatoria:
  • client_id = ID de cliente de sus hitos de registro de Compartir mis datos (es decir, par client_id/client_secret).
  • redirect_uri = URL de redireccionamiento que especificó en su registro de Compartir mis datos (las URL deben coincidir).
    Nota: Recomendamos aplicar la codificación de URL al redirect_uri según el ejemplo a continuación.
  • response_type = código (valor estático)
• Parámetro(s) de solicitud opcional:
  • estado = parámetro de estado opaco opcional según lo permitido por el estándar OAuth 2.0 que se devuelve con el código de autorización para ayudar a mantener el estado. Por ejemplo, el parámetro de estado puede ser utilizado por un tercero para identificar de manera única la creación del cliente y evitar la falsificación entre sitios.
  • login={guest} Proporcione la opción de que un tercero redirija a los clientes al inicio de sesión de My Energy de PG&E o a la pestaña Guest Access como parte del flujo de autorización en línea.

EJEMPLO: Solicitud de código de autorización

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

Nota: el parámetro de ejemplo redirect_uri anterior tiene codificación de URL aplicada (es decir, codificación de URL de https://thirdparty.com/redirectUrl)

Si realiza una solicitud válida como se indica anteriormente, y el cliente autentica y autoriza con éxito, el cliente será redirigido posteriormente a su redirect_uri con el código de autorización, el parámetro de alcance (autorizado) y el parámetro de estado opcional (si se proporciona como parte de la solicitud de autorización) como se muestra a continuación:

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={3P Registered Historical Length};AccountCollection={count of authorizedSAs};BR={ThirdPartyID};dataCustodianId=PGE &state=pge12advertisement

Nota: El código de autorización es de corta duración (vence en 600 segundos) y debe intercambiarse posteriormente por un token de acceso/par de token de actualización para completar la autorización y permitir el acceso continuo a los datos. Consulte la siguiente sección (Sección 2) para obtener detalles sobre la solicitud de token de acceso/token de actualización.

El parámetro de alcance (autorizado) que se muestra anteriormente se devuelve como parte de las respuestas a la solicitud de código de autorización, la solicitud de token de acceso, así como la API de autorización. Este parámetro de alcance permite comunicar el alcance final de la autorización del cliente. En particular, el parámetro de alcance incluye un valor de “Alcance adicional” que se asigna a las selecciones de autorización de clientes compatibles de PG&E de grupos de datos (p. ej., “Uso”, “Facturación”, “Básico”, “Cuenta”, “Inscripción al programa”). Los valores de los parámetros de alcance se capturan además según la siguiente documentación de referencia:Descargar asignación de cadena de alcance de bloque de función compatible Haga clic en 2.0 (PDF, 222 KB).

Escenarios de error

Errores de implementación de terceros: si los parámetros de solicitud requeridos de client_id o redirect_uri no son válidos o faltan al solicitar un código de autorización, se mostrará al cliente un mensaje explicativo junto con el error estándar de la serie HTTP 400. De manera similar, si el parámetro de solicitud requerido de response_type falta o no es válido, el cliente será redirigido nuevamente a su redirect_uri con el parámetro de error definido como "invalid_request" de OAuth 2.0, así como el parámetro de estado opcional si se proporciona por primera vez como parte de la solicitud del código de autorización original.

Clientes que se niegan a autorizar: cuando un tercero redirige a un cliente para autorizar con PG&E, un cliente tiene la opción de rechazar a través de un botón de “cancelar” tanto en la página de inicio de sesión como en la página de autorización. En tales casos, el cliente será redirigido nuevamente a su redirect_uri con el parámetro de error definido como "access_denied" OAuth 2.0 adjunto para indicar que el cliente se negó a autorizar. Además, el parámetro de estado opcional se devolverá si se proporciona por primera vez como parte de la solicitud del código de autorización original.

Autorizaciones iniciadas en PG&E

Cuando los clientes comienzan en el portal web de clientes de PG&E, “Su cuenta”, y luego navegan a la página de inicio Compartir mis datos, se les presenta un menú desplegable de terceros registrados y visibles. Como se ilustra en el segundo diagrama anterior, cuando un cliente selecciona a un tercero de la lista de terceros registrados y selecciona "Siguiente", el cliente será redirigido al "URI del portal de terceros" registrado del tercero, momento en el cual los clientes pueden proceder con el proceso OAuth iniciado por el tercero descrito en la sección anterior.

Nota: Algunos terceros han consultado sobre cómo optimizar la experiencia del cliente para este caso de uso (es decir, autorizaciones iniciadas en el sitio de PG&E) de manera que al cliente parece que se los lleva directamente a una página de autorización al seleccionar un tercero del menú desplegable. Para facilitar dicha experiencia del cliente, los terceros pueden elegir configurar su "URI del portal de terceros" (a través de la página de registro de gestión de Compartir mis datos) en un punto final que redirige automáticamente al cliente de vuelta a PG&E como parte de una solicitud de código de autorización. Tras el redireccionamiento automático de vuelta al punto final de autorización del servidor de PG&E, el cliente omitirá la página de inicio de sesión del cliente (ya que ya ha iniciado sesión) y pasará directamente a la página de autorización. Para algunos terceros que se han registrado antes del lanzamiento de Share My Data Click Thru 2.0 a fines de junio de 2018, esto se puede lograr simplemente definiendo el URI del Portal de terceros para que sea igual al URI de la “Pantalla de selección de alcance de terceros” que ya no se utiliza (campo que se retirará en un lanzamiento futuro).

Por el contrario, algunos terceros pueden querer involucrar y seleccionar a los clientes de su lado cuando los clientes son redirigidos a su URI del “Portal de terceros” antes de solicitar un código de autorización, por lo que el enfoque anterior es solo una sugerencia.

Para obtener un token de acceso, utilice el código de autorización recibido y llame al siguiente punto final con los parámetros de solicitud que se describen a continuación. Como se describió anteriormente, el Código de autorización es de corta duración y vence después de 10 minutos (600 segundos), así que asegúrese de que el token de acceso se solicite de inmediato al recibir un Código de autorización.

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

• Parámetros de solicitud obligatoria:
  • grant_type = código_autorización (valor estático)
  • código = código de autorización recibido en respuesta a la solicitud del código de autorización
  • redirect_uri = URL de redireccionamiento que especificó en su registro de Compartir mis datos (las URL deben coincidir).
    Nota: Al igual que con la solicitud del código de autorización, recomendamos aplicar la codificación de URL al redirect_uri.

EJEMPLO: Solicitud de
token de acceso PUBLICADO: https://api.pge.com/datacustodian/oauth/v2/token?grant_type=authorization_code&code={authorizationcode}&redirect_uri={redirect_uri}

Agregar parámetro de encabezado de autorización básico con codificación Base64 aplicada "clientID:clientSecret"

Nota: Los valores clientId:clientSecret corresponden a los valores clientID proporcionados en sus hitos de registro de Compartir mis datos.
El parámetro del encabezado tendrá el siguiente formato:
Nombre del parámetro: Valor del parámetro de autorización
: "cadena codificada base64" básica

Una respuesta exitosa se verá así:

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_476AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;Duración del intervalo=900_3600;BlockDuration=Diariamente;HistoryLength={3P Longitud histórica registrada};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
resourceURI:{RecursoURI} p. ej.: https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
autorizaciónURI:{AutorizaciónURI} p. ej.: https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
customerResourceURI:{customerResourceURI} p. ej.:https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
Bearer

Nota: Un token de acceso vence en 3600 segundos (1 hora), mientras que el token de actualización correspondiente vence en 1 año. Consulte la siguiente sección 3 para obtener detalles sobre la adquisición de un nuevo par de token de acceso/token de actualización.

Guarde el par de tokens de acceso y actualización.
Para solicitar datos históricos iniciales y datos diarios en curso,visite Acceso a datos .

Según la mejor práctica, el token de acceso es un token de corta duración (1 hora) mientras que el token de actualización correspondiente es un token de larga duración (1 año) que puede utilizar para adquirir un nuevo par de token de acceso/token de actualización cuando vence el token de acceso. Para obtener un nuevo par de token de acceso y token de actualización para autorizaciones existentes no vencidas, utilice el "token de actualización actual" y llame al siguiente punto final con los parámetros que se describen a continuación.

authorizationServerAuthorizationEndpoint :https://api.pge.com/datacustodian/oauth/v2/token ?grant_type= refresh_token&refresh_token={current_refresh_token}

EJEMPLO: Actualizar solicitud
de token POST: https://api.pge.com/datacustodian/oauth/v2/token?grant_type= refresh_token&refresh_token={current_refresh_token}

Agregar parámetro de encabezado de autorización básico con codificación Base64 aplicada "clientID:clientSecret"

Nota: Los valores clientId:clientSecret corresponden a los valores clientID proporcionados en sus hitos de registro de Compartir mis datos.
El parámetro del encabezado tendrá el siguiente formato:
Nombre del parámetro: Valor del parámetro de autorización
: "cadena codificada base64" básica

Una respuesta exitosa se verá así:
{
"access_token": "677e6ef8-1e1a-43f0-85b8-5692fcbc72b2",
"token_type": "Bearer",
"vence_en": 3600,
"token_actualizado": "0eef9a9f-60c6-40bb-b33f-910e322c0298",
"alcance": "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_
ProgramaInscripción;Duración del intervalo=900_3600;BlockDuration=Diariamente;HistoryLength={3P Longitud histórica registrada};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE",
"resourceURI": "https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/test ",
"autorizaciónURI": "https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Authorization/test "
}

Nota: Del mismo modo, el token de acceso del cliente es un token de corta duración (1 hora), mientras que su token de actualización correspondiente es un token de larga duración (1 año) que puede utilizar para adquirir un nuevo par de token de acceso del cliente/token de actualización cuando vence el token de acceso del cliente. Para obtener un nuevo par de token de acceso de cliente/token de actualización, consulte los mismos pasos descritos anteriormente.

Los clientes podrán actualizar sus autorizaciones haciendo lo siguiente:

• Eliminar identificaciones de servicio de sus autorizaciones
• Extender la fecha de finalización del período de autorización
• Cancelación de la autorización

Nota: Los clientes solo podrán realizar cambios en sus autorizaciones iniciando sesión en su cuenta de PG&E en línea y siguiendo los pasos requeridos. Si se toma alguna de estas medidas, le notificaremos a través del URI de notificación que proporcionó durante el registro.

Existen opciones para administrar y ver los detalles de sus autorizaciones de clientes:

• Puede llamar a la API de autorización (operación http GET) utilizando su client_access_token ya sea a nivel de terceros (para obtener detalles sobre todas las autorizaciones) en https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization o a nivel de autorización de cliente individual en https://api.pge.com/GreenButtonConnect /espi/1_1/resource/Authorization/{AuthorizationID}.
• Por separado, también puede ver los detalles de la autorización individual manualmente iniciando sesión en su cuenta Share My Data a través del portal de terceros e ingresando la ID de suscripción para la autorización que está buscando.

Si ya no desea acceder a los datos asociados con una autorización, existen métodos opcionales para cancelar una autorización:

• Puede llamar a la API de revocación de autorización (operación http DELETE) utilizando su client_access_token en https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}.
• Como alternativa, puede cancelar manualmente una autorización iniciando sesión en su cuenta Share My Data a través del portal de terceros e ingresando el ID de suscripción para la autorización que desea cancelar.

Nota: Se notificará al cliente que usted ha elegido cancelar su autorización. Además, una vez que se cancela una autorización, la acción no puede revertirse.

• PG&E enviará notificaciones a su URI de notificación proporcionado durante el registro. Las notificaciones comprenden los URI correspondientes a datos ya preenvasados listos para que regrese y solicite en las URL proporcionadas. Los datos están preempaquetados y las notificaciones se envían en los siguientes dos escenarios: (1) ha seleccionado "Notifíqueme ya que los datos están listos" en su perfil de registro, en cuyo caso empacaremos los datos diarios más recientes con cualquier corrección para fechas pasadas, o (2) ha realizado una solicitud asincrónica ad hoc anterior para la cual los datos solicitados ahora están listos.
• El Escenario 1 se ilustra en la sección “DATA ACCESS: SUSCRIPCIÓN DIARIA" de los diagramas de Métodos de acceso a datos a continuación y el Escenario 2 se ilustra en la sección “DATA ACCESS: SOLICITUD DE AD HOC (ASINCRONOSO)" de los mismos diagramas a continuación.

Tenga en cuenta la vida útil del token de los tokens de acceso, el token de acceso del cliente y sus tokens de actualización correspondientes utilizados en las solicitudes de datos. Según la mejor práctica, el token de acceso es un token de corta duración (1 hora), mientras que el token de actualización es un token de larga duración (1 año) que puede usar para adquirir un nuevo par de token de acceso/token de actualización cuando vence el token de acceso. Del mismo modo, el token de acceso del cliente es un token de corta duración (1 hora), mientras que su token de actualización correspondiente es un token de larga duración (1 año) que puede utilizar para adquirir un nuevo par de token de acceso del cliente/token de actualización cuando expire el token de acceso del cliente. Para obtener más detalles sobre cómo obtener un nuevo par de tokens, consulte el Paso 3, Solicitud de un nuevo token de acceso, en nuestra pestaña de detalles de autorización. Ir a detalles de autorización

Si el cliente lo autoriza a recibir “Información de cuenta” (Id. de cuenta, Id. de acuerdo de servicio y fechas de inicio del servicio) y/o “Información básica” (es decir, nombre del cliente y dirección del servicio), puede solicitar dicha información del cliente a través de las API de cliente minorista definidas por ESPI para las cuales los datos cumplen con el esquema, retailCustomer.xsd, proporcionado anteriormente.

Sincrónico (terceros estándar y EEF)

Un enfoque para solicitar datos del cliente es utilizar la API sincrónica para solicitar información del cliente para una autorización de cliente único para datos del cliente (es decir, cliente minorista):

Ejemplo de URL de solicitud sincrónica:https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}

RetailCustomerID = RetailCustomerID que recibió al final de la secuencia de autorización de OAuth para obtener un token de acceso. RetailCustomerID es parte del parámetro de ruta customerResourceUri en la respuesta de token. (ID del cliente minorista=ID de suscripción)

Encabezado HTTP = Autorización:Bearer {token de acceso para esta autorización}

Respuesta = recuperará los datos sincrónicamente para esa ID de cliente minorista. Los datos cumplen con retailCustomer.xsd

Nota: La API sincrónica de cliente minorista está a nivel de cliente minorista individual que corresponde a una autorización de cliente único.

Como referencia: el siguiente diagrama jerárquico muestra la jerarquía de relaciones para los elementos de datos de ESPI en el modelado de datos de clientes de PG&E.

También puede solicitar datos de clientes a través de la API asíncrona para solicitar información de clientes para todas sus autorizaciones de clientes para datos de clientes (es decir, clientes minoristas).

Para admitir solicitudes asíncronas, su aplicación deberá admitir notificaciones posteriores que le enviaremos (según la URL de notificación que proporcionó durante el registro).

Ejemplo de URL de solicitud asíncrona:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}

BulkID = BulkID proporcionado en el Recurso de información de la aplicación recuperado durante la prueba de registro. (ID a granel=ID de cliente)

Encabezado HTTP = Autorización:Bearer {token de acceso del cliente recuperado durante la prueba de registro}

Respuesta = código de estado HTTP 202 (Esta es una solicitud asíncrona donde la respuesta se publicará en la URL de notificación cuando los datos estén listos). Una vez que los datos estén listos, PUBLICAREMOS una notificación a su URI de notificación proporcionada con una carga de URL que su aplicación puede regresar para obtener el preempaquetado. La muestra posterior a la notificación se ve como se muestra a continuación

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID={correlationID}

Realice GET en la URL anterior con el token de acceso del cliente para obtener los datos.

Como referencia: el siguiente diagrama jerárquico muestra la jerarquía de relaciones para los elementos de datos de ESPI en el modelado de datos de clientes de PG&E.

Por último, puede obtener la información más reciente del cliente diariamente utilizando el modelo de suscripción diaria (es decir, seleccionando la casilla de verificación "Notificarme ya que los datos están listos (diariamente)" durante el registro).

Para admitir el modelo de suscripción diaria, su aplicación deberá admitir las notificaciones posteriores que le enviaremos (según la URL de notificación que proporcionó durante el registro).

Una vez que los datos estén listos, PUBLICAREMOS una notificación a su URI de notificación proporcionada con una carga de URL que su aplicación puede regresar para obtener el preempaquetado. La muestra posterior a la notificación se ve de la siguiente manera:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailCustomerInfo/{BulkID}?correlationID={correlationID}

Realice GET en la URL anterior con el token de acceso del cliente para obtener los datos.

Como referencia, el siguiente diagrama jerárquico muestra la jerarquía de relaciones para los elementos de datos de ESPI en el modelado de datos de clientes de PG&E.

Si el cliente lo autoriza a recibir “Información de uso” o “Información de facturación”, puede solicitar estos datos a través de las API de suscripción para las cuales los datos se ajustan al esquema, espiDerived.xsd, proporcionado anteriormente.

Solicitudes Ad Hoc sincrónicas (terceros estándar y EEF)

Para solicitar datos históricos (tanto para los datos de uso de intervalo como para los datos de facturación), un enfoque es utilizar las API sincrónicas con la inclusión de los parámetros de solicitud de fecha de inicio y finalización adecuados en la hora Zulu.

Ejemplo de URL de solicitud síncrona:
https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}?published-min={startDate}&published-max={endDate}

publicado-min = fecha de inicio que se aplicará a esta solicitud para extraer datos. La fecha está en hora Zulu de aaaa-MM-ddTHH:mm:ssZ (formato IETC RFC 3339)

publicado-máx = fecha de finalización que se aplicará a esta solicitud de extracción de datos. La fecha está en hora Zulu de aaaa-MM-ddTHH:mm:ssZ (formato IETC RFC 3339)

Nota: Para las solicitudes de API que aceptan los parámetros de publicación máxima y de publicación mínima, el valor predeterminado es T-1 (fecha de la solicitud menos 1 día). Para solicitudes de resumen de uso (p. ej., .../espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint/{UsagePointID}/UsageSummary), sugerimos proporcionar un rango de 30 días o más para garantizar que haya una factura disponible que se superponga con ese período; de lo contrario, no se devolverán datos.

ID de suscripción = ID de suscripción que recibió al final de la secuencia de autorización OAuth para obtener un token de acceso. El ID de suscripción es parte del parámetro resourceURI en la respuesta de token. (ID de suscripción=ID de cliente minorista)

UsagePointID = UsagePoint bajo la ID de suscripción anterior. Puede obtener todos los puntos de uso para una determinada suscripción llamando a la siguiente URL de API y suministrando el token de acceso para esa suscripción en el encabezado de autorización: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Subscription/{SubscriptionID}/UsagePoint

Encabezado HTTP = Autorización:Bearer {token de acceso para esta suscripción}

Respuesta = recuperará los datos sincrónicamente para ese punto de uso para el período solicitado. Tendrá datos de uso de intervalo () y datos de factura ().

Las API de uso sincrónico (según lo indicado por la construcción de la URL que termina con la ID de punto de uso) están en el nivel de punto de uso individual (es decir, nivel de acuerdo de servicio), por lo que una aplicación ciclaría las solicitudes a través de cada una de las ID de punto de uso que pertenecen a una autorización de cliente determinada (es decir, suscripción).

La respuesta a las solicitudes sincrónicas devuelve tanto los datos de intervalo (bajo) asociados al intervalo de fechas solicitado como cualquier total de uso mensual y facturas que se superpusieron con el intervalo de fechas solicitado (bajo ).

• IntervalReading contiene datos de uso de gas de intervalo (15 minutos/hora) y uso de electricidad de intervalo (diario)
• El resumen de uso contiene los totales de uso mensual y los detalles de la factura (si está autorizado)

Dentro de la respuesta encontrará elementos de datos correspondientes a nuestra tabla de mapeo de elementos de datos ESPI

Como referencia, el siguiente diagrama jerárquico muestra la jerarquía de relaciones para los elementos de datos de ESPI en el modelado de datos de clientes de PG&E.

Las siguientes son algunas aclaraciones clave sobre estos elementos de datos:

• El bloqueo de intervalo es para 1 día
• IntervalReading (debajo del bloqueo de intervalo) contiene los valores reales de uso de electricidad de 15 minutos/hora y los valores diarios de uso de gas
• Para los clientes de electricidad con generación en el sitio (p. ej., solar), el elemento flowDirection indica los datos de uso entregados (suministro) y recibidos (generación). Para los clientes con medidores configurados para leer solo el uso neto (es decir, sin generación en el sitio), el elemento flowDirection indica que el uso es un monto neto (diferencia de entregado menos recibido):
  • Dirección de flujo de 1 = administrada (energía suministrada al cliente)
  • Dirección de flujo de 19 = recibido (generación neta que regresa a la cuadrícula de PG&E). (Nota: los valores son absolutos)
  • Dirección de flujo de 4 = neto (entregado menos – recibido)
• Preste especial atención al poder de diez multiplicadores y a la unidad de medida (uom) para garantizar una lectura de uso correcta.

Suscripción por lotes (terceros estándar y EEF)

También puede solicitar datos de uso a través de la API asíncrona para todos los puntos de uso pertenecientes a una autorización de un solo cliente para datos de uso/facturación (es decir, suscripción).

Para admitir las solicitudes asíncronas ad hoc (es decir, para más de un Punto de uso a la vez), su aplicación deberá admitir Notificaciones posteriores que le enviaremos (según la URL de notificación que proporcionó durante el registro).

Ejemplo de URL
de solicitud asíncrona https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?published-min={startDate}&published-max={endDate}

ID de suscripción = ID de suscripción que recibió al final de la secuencia OAuth para obtener un token de acceso. El ID de suscripción es parte del parámetro resourceURI en la respuesta de token

publicado-min = fecha de inicio que se aplicará a esta solicitud de extracción de datos. (formato RFC 3339, hora del zulu. aaaa-MM-ddTHH:mm:ssZ)

publicado-máx = fecha de finalización que se aplicará a esta solicitud de extracción de datos. (formato RFC 3339, hora del zulu. aaaa-MM-ddTHH:mm:ssZ)

Encabezado HTTP = Autorización:Bearer {token de acceso para esta suscripción}

Respuesta = código de estado HTTP 202 (esta es una solicitud asíncrona donde la respuesta se publicará en la URL de notificación cuando los datos estén listos)

Una vez que los datos estén listos, PUBLICAREMOS una notificación a su URI de notificación proporcionada con una carga de URL que su aplicación puede regresar para obtener el preempaquetado. La muestra posterior a la notificación se ve de la siguiente manera:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Subscription/{SubscriptionID}?correlationID={correlationID}

Realice GET en la URL anterior con token de acceso para obtener los datos. Esto contendrá tanto los datos de uso del intervalo () como la información de la factura () para el período solicitado.

Suscripción por lotes (terceros estándar y EEF)
También puede solicitar información de uso y facturación a través de la API asíncrona masiva por lotes para todas las autorizaciones de sus clientes para datos de uso/facturación (es decir, Suscripciones).

Ejemplo de URL
de solicitud masiva por lote https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?published-min={startDate}&publishedmax={endDate}

BulkID = BulkID proporcionado en el Recurso de información de la aplicación recuperado durante la prueba de registro. (ID a granel=ID de cliente)

publicado-min = fecha de inicio que se aplicará a esta solicitud de extracción de datos. (formato RFC 3339, hora del zulu. aaaa-MM-ddTHH:mm:ssZ)

publicado-máx = fecha de finalización que se aplicará a esta solicitud de extracción de datos. (formato RFC 3339, hora del zulu. aaaa-MM-ddTHH:mm:ssZ)

Encabezado HTTP = Autorización:Bearer {token de acceso de cliente}

Respuesta = código de estado HTTP 202 (esta es una solicitud asíncrona donde la respuesta se publicará en la URL de notificación cuando los datos estén listos)

Una vez que los datos estén listos, PUBLICAREMOS una notificación a su URI de notificación proporcionada con una carga de URL que su aplicación puede regresar para obtener el preempaquetado. La muestra posterior a la notificación se ve de la siguiente manera:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID={correlationID}

Realice GET en la URL anterior con token de acceso para obtener los datos. Esto contendrá tanto los datos de uso del intervalo () como la información de la factura () para el período solicitado.

Por último, puede obtener la información más reciente sobre el uso y la facturación, incluidas las correcciones de fechas pasadas dentro de los períodos de autorización del cliente, todos los días utilizando el modelo de suscripción diaria (es decir, seleccionando la casilla de verificación “Notifíqueme si los datos están listos (diariamente)” durante el registro).

Para admitir el modelo de suscripción diaria, su aplicación deberá admitir las notificaciones posteriores que le enviaremos (según la URL de notificación que proporcionó durante el registro).

Una vez que los datos estén listos, PUBLICAREMOS una notificación a su URI de notificación proporcionada con una carga de URL que su aplicación puede regresar para obtener el preempaquetado. La muestra posterior a la notificación se ve de la siguiente manera:

https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/Bulk/{BulkID}?correlationID={correlationID}

Realice GET en la URL anterior con token de acceso para obtener los datos. Esto contendrá tanto los datos de uso del intervalo () como la información de la factura () para el período solicitado.

20 de marzo de 2023

Novedades:

1. Liberación de un nuevo código de respuesta HTTP de API (204) para llamadas API síncronas y asíncronas para indicar cuando no hay datos disponibles para el rango solicitado.
2. Admite una etiqueta de encabezado de transacción x que admite la capacidad de vincular la respuesta de PG&E a llamadas de API asíncronas específicas al devolver este valor junto con una ID de correlación cuando el archivo solicitado está listo.
3. Se mejoró la granularidad de datos adicionales a la API UsagePoint/MeterReadingID al proporcionar datos de intervalos eléctricos para varios medidores en escenarios de acuerdos de servicio individuales.
4. Se proporcionó claridad adicional a los valores del indicador de calidad de lectura para los datos del intervalo ESTIMADO para describir el tipo de estimación utilizada para ese intervalo. Los nuevos valores que indican que se ha aplicado la lógica de estimación son los siguientes:
   
   

5. Valor y descripción del RQI

   0 - Válido: datos que han pasado por todas las verificaciones de validación requeridas y que las aprobaron todas o se verificaron

   7 - Editado manualmente: reemplazado o aprobado por un humano

   8 - Estimado usando el día de referencia: el valor de los datos se reemplazó por un valor computado por la máquina basado en el análisis de los datos históricos usando el mismo tipo de medición

   9 - Estimado usando interpolación lineal: el valor de los datos se calculó usando interpolación lineal en función de las lecturas antes y después

   10 - Cuestionable: datos que han fallado en una o más verificaciones

   11 - Derivado: datos que se han calculado (mediante operaciones lógicas o matemáticas), no necesariamente medidos directamente

   12 - Proyectado (previsión): datos que se han calculado como una proyección o pronóstico de lecturas futuras

   13 - Mezclado: indica que la calidad de esta lectura tiene características mixtas

   14 - Sin procesar: datos que no han pasado por el proceso de validación, edición y estimación. NOTA El indicador RQI de los medidores MV90 permanecerá en 14 como estado RQ final

   15 - Normalizado para el clima: los valores se han ajustado para tener en cuenta el clima, para comparar el uso en diferentes climas

   16 - Otro: especifica que se aplica una característica distinta de las definidas

   17 - Validado: datos que han sido validados y posiblemente editados y/o estimados de acuerdo con los procedimientos aprobados

   18 - Verificado: datos que fallaron al menos una de las verificaciones de validación requeridas, pero se determinó que representaban el uso real

   19 - Calidad de los ingresos: válido y aceptable para fines de facturación [posible extensión para el estándar ESPI y que no forme parte del ESPI original]

    

6. Lanzamiento de métricas de uso de API de proveedores en el portal de proveedores de Share My Data Third Party.

15 de noviembre de 2018

Novedades:

1. Se agregó el indicador de clase de cliente. Cada SAID autorizado se identificará como RES, AGR, COM/IND u otro.
2. Las API de facturación y uso se actualizarán para aceptar los parámetros de consulta actualizados-máx y actualizados-mín (como alternativa a los parámetros publicados-mín y publicados-máx). Los datos devueltos serán todos los cambios que se hayan producido dentro de los parámetros actualizados-máx. y actualizados-mín.
3. Reemplazar el uso de la identificación masiva de 5 dígitos de un tercero con la identificación de cliente del tercero para el flujo de autorización en línea.
4. Proporcionar la opción de que un tercero redirija a los clientes al inicio de sesión de la cuenta de PG&E o a la pestaña Acceso de invitado como parte del flujo de autorización en línea.
5. Mejorar el panel de control de clientes de Share My Data de PG&E para facilitar a los clientes la visualización de todas sus autorizaciones de intercambio de datos existentes con terceros.

27 de septiembre de 2018

Novedades:

PG&E agregó nuevos elementos de datos al conjunto de datos de la Regla 24 como parte del proyecto de conjunto de datos expandidos (EDS) de PG&E, y los nuevos elementos de datos correspondientes se introducen en el conjunto de datos de la Regla 25. Los elementos de datos específicos que comprenden el conjunto de datos ampliados de la Regla 25 de PG&E se establecen a continuación con la designación EDS:

Elementos de datos de la Regla 25

Elementos de
la cuenta de Notes
Nombre
de la cuenta Dirección
de la cuenta ID
de la cuenta EDS: Elementos de servicio de bloqueo
de
corte ID
de servicio de PG&E UUID
Cambios futuros en el estado del servicio
Estado del
servicio SA Fecha
de inicio del servicio Dirección
del servicio Tarifa
de servicio actual Servicio histórico facturado Opciones de
tarifa (Medical Baseline, CUIDADO, FERA, TBS, CCA_TBS, Voltaje de servicio de corriente de elección
solar y producto básico Voltaje
de servicio histórico facturado Número
de medidores
de servicio Tipo
de medidor de corriente Ciclo
de lectura Medidor histórico de facturación Ciclo
de lectura Opción de tasa de espera de corriente si el indicador
de generación en el sitio Opción
de tasa de espera histórica de facturación EDS: Indicador de
clase de cliente Elementos históricos de facturación Fecha
de inicio de la factura Fecha de
finalización de la factura Cargos
totales de la factura($)
Total de la factura kWh
EDS: Nombre del proveedor
de servicios Desglose histórico del nivel de facturación (si corresponde)
EDS: Período de facturación de
partidas individuales EDS: Nombre (sobre el inicio 1 %-30 %)
EDS: Volumen (1234.2)
EDS: Tarifa ($0.032/kWh)
EDS: Costo ($100.23)
Desglose histórico de TOU kWh de facturación (excepto para ABS-TX facturado)
EDS: Período de facturación de la partida individual (para desglose de TOU)
EDS: Nombre (del cargo de TOU)
EDS: Volumen (1234.2)
EDS: Tarifa ($0.032/kWh)
EDS: Costo ($100.23)
Desglose
histórico de la demanda de facturas EDS: Período de facturación de elementos de línea (para desglose de demanda)
EDS: Nombre
EDS: Volumen (1234.2)
EDS: Tarifa ($0.032/kWh)
EDS: Costo ($100.23)
Elementos
históricos de la línea de facturación EDS: Período
de facturación de partidas individuales EDS: Nombre del cargo (cargo de bono DWR)
EDS: Volumen (1234.2)
EDS: Unidad (kWh)
EDS: Tarifa ($0.032/kWh)
EDS: Costo ($100.23)
Intervalos
de uso históricos Intervalo de uso Inicio de
uso Duración del intervalo predeterminado (en segundos)
Volumen de uso del intervalo (1234.2)
Unidad (kWh/Therms)
Programas
de respuesta a la demanda de servicios públicos (DR) Nombre
del programa Fecha de finalización más temprana sin obligación financiera Fecha de
finalización más temprana independientemente de la obligación
financiera Estado
del programa DR Fecha
de inscripción del programa DR Fecha
de desafiliación Elementos de

datos Parámetros de tiempo local (detalles de DST)
Datos predeterminados Calidad
Energía Dirección
Potencia de diez multiplicador (para valores de uso de intervalo)
Potencia de diez multiplicador (para demanda facturada)
Potencia de diez multiplicador (para uso total facturado)
Duración del intervalo(de lectura de uso)
Moneda del costo
total de factura Indicadores de TOU Intervalo eléctrico

28 de junio de 2018

Como parte del proyecto Click-Through y las mejoras continuas a la plataforma Share My Data, PG&E lanzó la fase 2 de Click-Through el 28 de junio de 2018.

Novedades:

Los cambios más críticos que afectan a terceros son los cambios para cumplir con el protocolo OAuth 2.0 (PG&E eliminó la serie inicial de redireccionamientos). Encuentre los detalles a continuación.

IMPORTANTE: Se REQUIERE que los terceros realicen cambios en su implementación OAuth existente. Los cambios de la Fase 2 de Click-Through de PG&E NO son compatibles con versiones anteriores, por lo que es necesario que terceros implementen cambios concurrentes con la implementación de PG&E. Sin implementación, el proceso actual de autorización del cliente dejará de funcionar en la fecha de corte del 29 de junio de 2018. Sin embargo, las autorizaciones existentes no se ven afectadas.

1. Para cumplir con el protocolo OAuth 2.0, PG&E ha reducido la cantidad de pasos de redireccionamiento para la autorización. La redirección inicial a PG&E para que los clientes inicien sesión y envíen una autorización se ha combinado con la solicitud del código de autorización de la siguiente manera:
   • Como se muestra en el ejemplo a continuación, las solicitudes de código de autorización de terceros ahora comprenden un redireccionamiento del navegador del cliente a la nueva authorizationServerAuthorizationEndpoint URI, junto con los parámetros de solicitud adecuados:
     OBTENGA https://sharemydata.pge.com/myAuthorization?client_id=xxxxx&redirect_uri={redirect_uri}&response_type=code&state={optionalState}
   • Se ha retirado el siguiente criterio de valoración: https://api.pge.com/datacustodian/oauth/v2/authorize...
     
2. Nuevos mensajes de manejo de errores para solicitudes de código de autorización con parámetros de alcance faltantes o no válidos de la siguiente manera:
   • Si faltan los parámetros client_id o redirect_uri requeridos o no son válidos, se muestra un error (http 400) con un mensaje explicativo al cliente
   • Si falta el parámetro response_type requerido o no es válido, el cliente será redirigido nuevamente al redirect_uri del tercero con un parámetro de error "invalid_request" (anexado al redirect_uri)
     
3. Para los clientes con una autorización en línea existente, la capacidad de un tercero de solicitar un nuevo par access_token/refresh_token como parte de una nueva autorización que reemplaza a la existente (es decir, autorización en línea de la misma combinación de tercero y cliente). Esta funcionalidad aborda situaciones en las que terceros pierden un par access_token/refresh_token o necesitan cambiar el alcance de la autorización original según la aprobación del cliente.
   • Para las solicitudes de reautorización, el cliente ve la nueva página de autorización en lugar de la página de "administrar autorización" cuando un tercero la redirige a PG&E para su autorización
   • Tras la autorización del cliente, los terceros reciben una notificación a su URL de notificación registrada de que se cancela la ID de suscripción anterior (la notificación comprende el punto final de la URL de la API de autorización para la ID de suscripción anterior)
     
4. La capacidad de un cliente de salir a través de un botón "cancelar" en la página de autenticación o en la página de autorización con redirección de regreso al redirect_uri del tercero con un parámetro de error "access_denied" (adjunto al redirect_uri)
5. Para terceros que se registran con la configuración de "visibilidad" en y, por lo tanto, se incluyen en la lista de terceros registrados, los clientes verán cuando vayan a su cuenta en línea de PG&E y naveguen a la página de inicio de Compartir mis datos:
   • Para los clientes que inician sesión en su cuenta en línea de PG&E y navegan a la página de inicio Compartir mis datos y luego son redirigidos a la "URI del portal de terceros" registrada de terceros al seleccionar un tercero de la lista de terceros registrados. En ese momento, los clientes pueden continuar con el proceso OAuth iniciado por terceros. Al atravesar esta ruta, a los clientes ya no se les mostrará la página de autorización al seleccionar un tercero de la lista desplegable de terceros, sino que se los redirigirá al "URI del portal de terceros" registrado del tercero, donde pueden comenzar el proceso OAuth iniciado por el tercero.
   • Nota: Algunos terceros han preguntado sobre cómo optimizar la experiencia del cliente para este caso de uso (es decir, autorizaciones iniciadas en el sitio de PG&E) de manera que al cliente parece que se lo lleva directamente a una página de autorización al seleccionar un tercero del menú desplegable. Para facilitar dicha experiencia del cliente, los terceros pueden elegir configurar su "URI del portal de terceros" (a través de la página de registro de gestión de Compartir mis datos) en un punto final que redirige automáticamente al cliente de vuelta a PG&E como parte de una solicitud de código de autorización. Tras el redireccionamiento automático de vuelta a authorizationServerAuthorizationEndpoint de PG&E, el cliente omitirá la página de inicio de sesión del cliente (ya que ya inició sesión) y pasará directamente a la página de autorización. Para algunos terceros que se han registrado antes de la versión Compartir mis datos Haga clic en 2.0, esto se puede lograr simplemente definiendo el URI del portal de terceros para que sea igual a la “Pantalla de selección de alcance de terceros” ya no utilizadaURI (el campo de registro SMD anterior se retirará en una versión futura).
     Por el contrario, es posible que algunos terceros quieran primero involucrar y seleccionar a los clientes de su lado cuando los clientes sean redirigidos a su URI del “Portal de terceros” antes de solicitar un código de autorización, por lo que el enfoque anterior es solo una sugerencia.
     
6. SMD ahora proporcionará detalles mejorados del parámetro Alcance como parte de las respuestas a la Solicitud de código de autorización, la Solicitud de token de acceso y la API de autorización. El parámetro de alcance mejorado permite comunicar el alcance final de la autorización del cliente. En particular, el parámetro de alcance incluye un valor de “Alcance adicional” que se asigna a las selecciones de autorización de clientes compatibles de PG&E de grupos de datos (p. ej., “Uso”, “Facturación”, “Básico”, “Cuenta”, “Inscripción en programas”). Los valores de los parámetros de alcance se capturan adicionalmente según la siguiente documentación:Descargar asignación de cadena de alcance de bloque de función compatible Haga clic en 2.0 (PDF)
   
   Un ejemplo de respuesta de token a continuación ilustra algunos valores posibles de parámetros de alcance.
   • Ejemplo de respuesta 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_476AdditionalScope=Usage_Billing_Basic_Account_ProgramEnrollment;Duración del intervalo=900_3600;BlockDuration=Diariamente;HistoryLength={3P Longitud histórica registrada};AccountCollection={count of authorized SAs};BR={ThirdPartyID};dataCustodianId=PGE
     resourceURI:{RecursoURI} p. ej.: https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Subscription/{subscriptionID}
     autorizaciónURI:{AutorizaciónURI} p. ej.: https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Authorization/{authorizationID}
     customerResourceURI:{customerResourceURI} p. ej.:https://api.pág.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailCustomer/{RetailCustomerID}
     Bearer
     
     
     
7. Los terceros ahora pueden registrarse para recibir información autorizada sobre la inscripción en el programa a través del nuevo grupo de datos “Inscripción en el programa”. Tanto los clientes con medidor de intervalo como los clientes sin medidor de intervalo serán elegibles para autorizar el intercambio de datos para la Fase 2 de clics en SMD. A continuación, se presenta un resumen de alto nivel de los elementos de datos recientemente disponibles proporcionados por el grupo de datos de inscripción en el programa:
   • Inscripción en el programa (nombre/estado del programa de respuesta a la demanda de PG&E e información de CAISO):
   • (Facturación) Dirección de la cuenta
   • Estado del acuerdo de servicio
   • Tarifa de servicio (actual)
   • (corriente) Voltaje de servicio (solo eléctrico)
   • Número de medidor de servicio (si corresponde)
   • Tipo de medidor
   • Ciclo de lectura del medidor (corriente)
   • (Actual) Opción de tasa de espera si el indicador de generación en el sitio
   • (uso del intervalo predeterminado) Duración (longitud en segundos)
   • (Respuesta a la demanda de PG&E inscrita) Nombre del programa (si corresponde)
   • Fecha de finalización más temprana del Programa de respuesta a la demanda (Demand Response, DR) inscrito en PG&E sin obligación financiera
   • Fecha de finalización más temprana del programa de respuesta a la demanda (Demand Response, DR) inscrito en PG&E, independientemente de la obligación financiera
   • Estado (inscripción) del Programa de respuesta a la demanda (Demand Response, DR) de PG&E
   • Fecha de inscripción en el programa de respuesta a la demanda (Demand Response, DR) de PG&E
   • Fecha de desafiliación del programa de respuesta a la demanda (Demand Response, DR) de PG&E
   • La asignación de XML XSD (Definición de esquema XML) de Atom para estos nuevos elementos de datos se captura de acuerdo con la siguiente documentación:
     Descargar elementos de datos compatibles (PDF)
   • El modelo de jerarquía de datos relacionales asociados se describe de acuerdo con lo siguiente:
     Descargar el modelo de datos de PGE ESPI (PDF)
   • Punto de uso (también conocido como SA UUID)
     • ServiceDeliveryPoint\tariffProfile(tarifa de servicio actual, también conocida como lista de tarifas, incluida la opción de tarifa en espera, si corresponde)
     • readCycle (ciclo de lectura del medidor actual)UsoResumen
     • readCycle (ciclo de servicio de facturación)
     • Producto básico (incluye el nivel de voltaje facturado para electricidad)
     • TarifaPerfil (tarifa de servicio facturada, incluida la opción de tarifa en espera, si corresponde
   • Tipo de lectura
     • Producto básico (incluye el nivel de voltaje de corriente para electricidad y prefijo para la opción de tasa de espera cuando corresponda)
   • Cuenta del cliente
     • (Dirección de facturación de cuenta):
     • principalDirección/calleDetalle...
     • principalDirección/puebloDetalle...
     • principalDirección/código postal...
   • Acuerdo del cliente
     • estado\valor (estado de SA
   • Programa de respuesta a la demanda
     • programName
     • inscripciónEstado
     • programDate/programDate
     • programDate/programDateDescription
   • Medidor
     • número de serie (id. del medidor)
     • tipo (tipo de medidor)
     • Intervalo (actual)Duración
   • Las últimas definiciones de esquema de ESPI xml (XSD) utilizadas para estos nuevos elementos de datos se describen a continuación:
     Descargue XSD (ZIP, 49 KB)ZIP. Se abre en una ventana nueva.
     Nota: los XSD son compatibles con versiones anteriores.
   • Los terceros tendrán la capacidad de cambiar su registro para permitir que los clientes seleccionen este grupo de datos durante el tiempo de autorización a través del portal de terceros en Administrar registro >Editar > sección: Indique la información del cliente que necesita", seleccione la casilla de verificación Inscripción en el programa.
   • Nota:esto solo se aplicará a las autorizaciones de nuevos clientes.
     
   • Las nuevas API para recuperar la información de inscripción de DR están disponibles a nivel de terceros masivos, así como a nivel de autorización de cliente individual (nivel de ID de cliente minorista), según se describe a continuación:
     Descargar nuevas API compatibles con PGE (PDF)
   • API asíncrona para solicitar información de inscripción en DR para todas las autorizaciones a un tercero
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/BulkRetailDRPrgInfo/{BulkID}
   • API síncrona para solicitar información de inscripción de DR a nivel de autorización de cliente individual
     • https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Batch/RetailDRPrgInfo/{RetailCustomerID}

Tenga en cuenta que: Además de los cambios en el proceso de autorización del cliente, otros cambios también son compatibles con versiones anteriores y son mejoras voluntarias que los terceros pueden elegir respaldar.

Si tiene alguna pregunta o necesita apoyo adicional, no dude en enviar un correo electrónico a sharemydata@pge.com.

Novedades:

1. Los clientes ahora pueden beneficiarse del proceso simplificado de autorización de clics.
   • Hemos actualizado los detalles sobre cómo un cliente ahora puede compartir datos con su empresa.
     Conozca cómo los clientes comparten datos con una empresa
     
     Nota: Estos cambios, particularmente las mejoras a nuestra UI de autorización, se han optimizado para dispositivos móviles (p. ej., teléfonos o tabletas).
   • Se han realizado cambios en el proceso de gestión de autorización accesible para los clientes a través de su cuenta en línea de PG&E:
     • Un cliente aún puede eliminar SAID de una autorización existente, extender la fecha de finalización de la autorización y/o cancelar la autorización en cualquier momento. Sin embargo, para agregar SAID adicionales y/o cambiar elementos de datos autorizados, la autorización existente debe cancelarse y debe crearse una nueva autorización.
2. Si lo desea, los terceros ahora pueden utilizar esta API para revocar autorizaciones de clientes individuales utilizando su token de acceso de cliente de terceros (proporcionado durante el proceso inicial de registro de terceros SMD) a través de una operación DELETE: https://api.pge.com/GreenButtonConnect/espi/1_1/resource/Authorization/{AuthorizationID}
   
   Nota 1:Para la implementación de PG&E, el parámetro ID de autorización es el mismo valor que el ID de suscripción.
   
   Nota 2:La nueva API proporciona a terceros la capacidad de revocar (cancelar) una autorización. Sin embargo, solo los clientes mismos pueden eliminar las identificaciones de SA y/o actualizar la fecha de finalización de la autorización a través de nuestras páginas de administración de autorización de SMD.
   
   Recordatorio:Al igual que con todas las solicitudes de datos de API, los terceros primero deben solicitar un nuevo par de tokens (Acceso de cliente + Actualizar token) utilizando sus últimos tokens de actualización.
   
   Recordatorio de períodos de vencimiento de tokens:
   • Token de acceso:1 hora
   • Token de acceso del cliente: 5 min
   • Tokens de actualización correspondientes: 1Yr
3. Los terceros ahora pueden crear múltiples registros de Compartir mis datos (SMD) utilizando el mismo nombre de empresa e identificación fiscal si es necesario. Sin embargo, el nombre de visualización (que los clientes ven cuando autorizan) aún debe ser único.
   
   Nota:Todos los cambios anteriores son compatibles con versiones anteriores y son mejoras voluntarias que los terceros pueden elegir respaldar. Descargue los documentos de respaldo para esta versión:
   
   COMPATIBLE_APIS.SMD_CLICK-THRU_1.0 (PDF)
   
   COMPATIBLE_DATA_ELEMENTS_RETAILCUSTOMER.SMD_CLICK_THRU_1.0 (PDF)
   
   PGE_ESPI_DATA_MODEL.SMD_CLICK-THRU_1.0 (PDF)
   
   COMPATIBLE_DATA_ELEMENTS_ESPIDERIVED.SMD_CLICK_THRU_1.0 (PDF)
   
   ESPI_XSDS (ZIP)

20 de diciembre de 2015

Cambios requeridos:las siguientes actualizaciones de SMD 2.0 requieren cambios por parte de terceros.

1. En consideración de las implementaciones de terceros con GBCMD (Green Button Connect My Data) en múltiples utilidades además de solo PG&E, devolveremos los datosCustodianID (es decir, dataCustodianID=PGE) en la redirección a thirdPartyScopeSelectionScreenURI durante la secuencia de autorización OAuth.
2. Las solicitudes de API que acepten parámetros de fecha (p. ej., solicitud de lote) deben usar parámetros de datos de Zulu (p. ej., publicado-máx./publicado-mín.). No se admitirán otros formatos de fecha para los parámetros de fecha en las solicitudes de API.
   • Las API que aceptan parámetros de fecha se documentan según las API admitidas.xlsx adjuntas
3. Indicadores de TOU de intervalo incluidos con los datos de uso de electricidad medidos por intervalo (según corresponda, indicador de a qué período de TOU corresponde cada intervalo)
   • Consulte las asignaciones estáticas de ID de programa que detallan a qué corresponde cada enumeración de TOU de intervalo (p. ej., 1 = Pico de verano, etc.). (Ver adjunto,Elementos de datos compatibles.xlsx )
4. La Id._cliente que se encuentra en los datosCustodianScopeSelectionScreenURI (utilizada para OAuth iniciado por terceros) y proporcionada en la solicitud de terceros del Recurso de información de la aplicación durante la Prueba de registro se actualiza a 5 dígitos si aún no lo está (p. ej., agregar ceros iniciales, etc.). Además, la URL ya no incluye '&verified=true' al final. Los terceros deberán actualizar sus URL en consecuencia.
   • Para elaborar, los datosCustodianScopeSelectionScreenURI se ven de la siguiente manera: https://sharemydataqa.pge.com/myAuthorization/?clientId=XXXX (XXXX es el clientID)
   • Por lo tanto, una identificación de cliente actual de 123 cambiará a algo como 00123, lo que significa que sus nuevos datosCustodianScopeSelectionScreenURI serán los siguientes:
     https://sharemydataqa.pge.com/myAuthorization/?clientId=00123 (la URL anterior es la siguiente: https://sharemydataqa.pge.com/myAuthorization/?clientId=00123&verified=true)
5. Los terceros registrados como "ESP" o "Proveedor de servicios de energía" cambiarán a Tipo de usuario estándar. No hay cambios funcionales, solo en el título del tipo de usuario. Distinguir el tipo de usuario ESP (del tipo de usuario estándar) es una diferenciación innecesaria, lo que causa confusión durante el proceso de registro sin proporcionar ninguna funcionalidad diferenciada, por lo que se está retirando.

Mejoras opcionales: Los siguientes cambios son compatibles con versiones anteriores y son mejoras voluntarias que los terceros pueden elegir respaldar.

1. Los terceros tendrán la capacidad de cambiar/actualizar automáticamente sus certificados SSL que proporcionaron originalmente durante el registro (p. ej., cuando el certificado se acerque al vencimiento) a través del portal de terceros en Administrar registro >Editar > sección nueva: Información del certificado SSL (opción Actualizar).
2. Los terceros pueden registrarse para recibir información de facturación básica autorizada, información del cliente y datos de gas.  Tanto los clientes con medidor de intervalo como los clientes sin medidor de intervalo serán elegibles para autorizar el intercambio de datos para SMD 2.0. A continuación se presenta un resumen de alto nivel de los elementos de datos recientemente disponibles:
   • Información de facturación: (para SA medidos con intervalo y sin intervalo)
     • Lista de tarifas, totales de facturación de $, uso escalonado (según corresponda), demanda (según corresponda), totales de TOU (según corresponda)
     • Nota: Para los clientes autorizados con medidor sin intervalo, los terceros solo recibirán totales de uso de facturación (es decir, en Resumen de uso) y lecturas de uso sin intervalo (p. ej., lecturas por hora/diarias, ya que no están disponibles)
   • Información del cliente: (para SA medidos con intervalo y sin intervalo)
     • Nombre del cliente, dirección del servicio, identificación de la cuenta, identificación del acuerdo de servicio, fecha de inicio del servicio del acuerdo de servicio,
   • Datos de uso de gas de intervalo: (solo SA de gas medido de intervalo)
     • Lecturas de gas de intervalo (es decir, diarias)
   • Los nuevos elementos de datos se diagraman según el documento adjunto,Elementos de datos compatibles.xlsx
   • La jerarquía de datos relacionales asociados se describe en el documento adjunto,PGE ESPI Data Model.xlsx
   • Las últimas definiciones de esquema de ESPI xml (XSD) utilizadas para estos nuevos elementos de datos son según las XSD adjuntas. Nota:los XSD son compatibles con versiones anteriores:
     • espiDerived.xsd (Información sobre el uso y la facturación del intervalo)
     • retailcustomer.xsd (información del cliente)

Si tiene alguna pregunta o necesita apoyo adicional, no dude en comunicarse con nosotros a ShareMyData@pge.com.

18 de diciembre de 2015

Cambios requeridos: las siguientes actualizaciones de SMD 2.0requieren cambios por parte de aquellos usuarios que acceden a sus propios datos:

1. Las solicitudes de API que acepten parámetros de fecha (p. ej., solicitud de lote) deben usar parámetros de datos de Zulu (p. ej., publicado-máx./publicado-mín.). No se admitirán otros formatos de fecha para los parámetros de fecha en las solicitudes de API.
   • Las API que aceptan parámetros de fecha se documentan según las API admitidas.xlsx adjuntas
2. Indicadores de tiempo de uso (TOU) del intervalo incluidos con los datos de uso de electricidad medidos del intervalo (según corresponda, indicador de a qué período de TOU corresponde cada intervalo)
   • Consulte las asignaciones estáticas de ID de programa que detallan a qué corresponde cada enumeración de TOU de intervalo (p. ej., 1 = Pico de verano, etc.). (Ver adjunto,Elementos de datos compatibles.xlsx )

Mejoras opcionales: Los siguientes cambios son compatibles con versiones anteriores y son mejoras voluntarias que los terceros pueden elegir respaldar.

1. Los usuarios de Self Access tendrán la capacidad de cambiar/actualizar automáticamente sus certificados SSL que proporcionaron originalmente durante el registro (p. ej., cuando el certificado se acerque al vencimiento) a través del portal de terceros en Administrar registro > Editar > sección nueva: Información del certificado SSL (opción Actualizar)
2. Los registros de usuarios de Autoacceso se actualizarán para incluir información básica de facturación autorizada, información del cliente y datos de gas. Ambos acuerdos de servicio medidos por intervalo como acuerdos de servicio medidos sin intervalo serán elegibles para la autorización (auto) para SMD 2.0. A continuación se presenta un resumen de alto nivel de los elementos de datos recientemente disponibles:
   • Información de facturación: (para SA medidos con intervalo y sin intervalo)
     • Lista de tarifas, totales de facturación de $, uso escalonado (según corresponda), demanda (según corresponda), totales de TOU (según corresponda)
     • Nota: Para los clientes autorizados con medidor sin intervalo, los terceros solo recibirán totales de uso de facturación (es decir, en Resumen de uso) y lecturas de uso sin intervalo (p. ej., lecturas por hora/diarias, ya que no están disponibles)
   • Información del cliente: (para SA medidos con intervalo y sin intervalo)
     • Nombre del cliente, dirección del servicio, identificación de la cuenta, identificación del acuerdo de servicio, fecha de inicio del servicio del acuerdo de servicio,
   • Datos de uso de gas de intervalo: (solo SA de gas medido de intervalo)
     • Lecturas de gas de intervalo (es decir, diarias)
   • Los nuevos elementos de datos se diagraman según el documento adjunto,Elementos de datos compatibles.xlsx
   • La jerarquía de datos relacionales asociados se describe en el documento adjunto,PGE ESPI Data Model.xlsx
   • Las últimas definiciones de esquema de ESPI xml (XSD) utilizadas para estos nuevos elementos de datos son según las XSD adjuntas. Nota:los XSD son compatibles con versiones anteriores:
     • espiDerived.xsd (Información sobre el uso y la facturación del intervalo)
     • retailcustomer.xsd (información del cliente)

Si tiene alguna pregunta o necesita apoyo adicional, no dude en comunicarse con nosotros a ShareMyData@pge.com.

18 de diciembre de 2015

Cambios requeridos: las siguientes actualizaciones de SMD 2.0requieren cambios por parte de las implementaciones de CCA.

1. Las solicitudes ad hoc (p. ej., para datos históricos) deben realizarse utilizando parámetros de fecha y hora de Zulu. No se admitirán otros formatos de fecha para los parámetros de fecha en las solicitudes de API.
2. La alimentación diaria de uso masivo comenzará a incluir información básica de facturación, mientras que la alimentación diaria masiva del cliente incluirá información adicional del cliente. Estos nuevos datos se proporcionarán tanto para los clientes con medidor de intervalo para los que reciben datos actualmente, como para los clientes sin medidor de intervalo en su territorio para los que no reciben datos actualmente. Por último, los valores de uso del intervalo proporcionados en la alimentación diaria de uso a granel incluirán indicadores de TOU del intervalo cuando corresponda. El resumen de alto nivel de los nuevos elementos de datos es el siguiente:
   • Información de facturación: (para SA medidos con intervalo y sin intervalo)
     • Lista de tarifas, totales de facturación de $, uso escalonado (según corresponda), demanda (según corresponda), totales de TOU (según corresponda)
   • (adicional) Información del cliente: (para SA medidos con intervalo y sin intervalo)
     • Nombre del cliente, dirección del servicio, fecha de inicio del servicio del acuerdo de servicio, ID de cuenta
   • Indicadores de TOU de intervalo incluidos con los datos de uso de electricidad medidos por intervalo (según corresponda, indicador de a qué período de TOU corresponde cada intervalo)
     • Consulte las asignaciones estáticas de ID de programa que detallan a qué corresponde cada enumeración de TOU de intervalo (p. ej., 1 = Pico de verano, etc.). (Ver adjunto,Elementos de datos compatibles.xlsx )
   • Las últimas definiciones de esquema de ESPI xml (XSD) utilizadas para estos nuevos elementos de datos son según las XSD adjuntas. Tenga en cuenta que los XSD son compatibles con versiones anteriores:
     • espiDerived.xsd (uso de intervalos e información de facturación)
     • retailcustomer.xsd (Información del cliente)
   • Los nuevos elementos de datos se diagraman según el documento adjunto,Elementos de datos compatibles.xlsx
   • La jerarquía de datos relacionales asociados se describe en el documento adjunto,PGE ESPI Data Model.xlsx

Mejoras opcionales: Los siguientes cambios son compatibles con versiones anteriores y son mejoras voluntarias que los terceros pueden optar por respaldar.

1. Los CCA pueden realizar solicitudes ad hoc de información del cliente en: https://api.pge.com/GreenButtonConnect/espi/1_1/Batch/BulkRetailCustomerInfo/{BulkID} (devuelve la última instantánea de información del cliente en el momento de la solicitud), además de la notificación diaria recibida.
2. Los CCA tendrán la capacidad de cambiar automáticamente su certificado SSL que proporcionaron originalmente durante el registro (p. ej., cuando el certificado se acerque a su vencimiento) a través del portal de terceros, bajo administrar registro > Editar > nueva sección: Información del certificado SSL (opción Actualizar)

Si tiene alguna pregunta o necesita ayuda adicional, no dude en comunicarse con nosotros a ShareMyData@pge.com.

21 de agosto de 2015

Novedades:

1. Cambios de parámetros estatales y URI de recursos en las respuestas de Oauth
   • Como parte de la solicitud del código de autorización OAuth, el tercero tiene la opción de enviar un parámetro de estado que PG&E enviaría de vuelta al tercero. PG&E también enviará el código de autorización cuando se complete correctamente la autorización. Este parámetro estatal opcional se puede utilizar para ayudar al tercero a identificar dónde se inició la solicitud y para vincular la solicitud con las autorizaciones que inició.
   • Como parte de la finalización exitosa de la solicitud de token, compartimos el recursoURI y la autorizaciónURI por separado de la información del token. Actualmente, estas URI se voltean y, como parte de este lanzamiento, lo corregiremos.

Defectos fijos:

1. Las fechas predeterminadas publicadas-máx. y publicadas-mín
   . Actualmente PG&E exige que el tercero envíe parámetros publicados-mín. y publicados-máx. en segundos de época para cada solicitud de datos para informar a PG&E la duración por la que solicita datos. Estamos implementando un cambio para manejar las solicitudes para los siguientes escenarios:
   • faltan los valores de mín. publicado y máx. publicado
   • los valores publicados-mín y publicados-máx están en UTC
   • los valores de mín. y máx. publicados están en segundos de época
   En caso de que falten los parámetros, PG&E devolverá las fechas predeterminadas, en lugar de los mensajes de error que se devolvieron antes de este cambio. El valor predeterminado, en nuestro caso, son los datos de un día para la fecha T-2. Si los parámetros están presentes y formateados correctamente, continuaremos respetando los parámetros.
2. Corregir las fechas en autorización xml
   Actualmente en la autorización xml compartimos la fecha publicada y la fecha de autorización. Estas fechas están en milisegundos en lugar de segundos, que es el estándar. Lo estamos arreglando para que se envíe en segundos en lugar de milisegundos.
3. XML incorrecto devuelto para /resource/Subscription/{id}/UsagePoint/{id}/MeterReading/{id}/IntervalBlock
   Actualmente estamos devolviendo una respuesta incorrecta para el nivel de recurso anterior GET cuando la estructura del XML es incorrecta y estamos repitiendo entradas para cada intervalo en lugar de crear un solo bloque de intervalo para una duración de 24 horas.
   
   Esto se está fijando y solo se devolverá un bloque de intervalo único para un bloque de intervalo de 24.

¿Tiene preguntas o inquietudes? Comuníquese con ShareMyData@pge.com.

• Los clientes le autorizan a acceder a sus datos a través de My Energy, su cuenta en línea de PG&E. Para obtener una descripción general detallada de cómo los clientes pueden autorizar a terceros u otras entidades a acceder a sus datos, consulte la Descripción general de terceros de Compartir mis datos.

Ir a detalles de autorización

• Actualmente, no hay límite.

• Los clientes pueden elegir una cantidad específica de tiempo durante el cual puede acceder a sus datos o pueden dejar abierto el período de autorización.
• Su solicitud puede verificar la fecha de finalización de la autorización de un cliente junto con otros detalles de autorización llamando a las API de recursos de autorización (p. ej., .../espi/1_1/resource/Authorization y/o.../espi/1_1/resource/Authorization/{AuthorizationID}).
• Como alternativa, puede verificar manualmente las fechas de finalización de la autorización iniciando sesión en su cuenta y seleccionando Administrar autorizaciones.

• Si un cliente elige un período de autorización definido, entonces su autorización vence al final de ese período. Si cancelan la autorización, su autorización vence el día posterior a la cancelación de la autorización.
• Si un cliente elige Indefinite como su período de autorización, entonces su autorización no vence. Tenga en cuenta que, en consideración de los Proveedores de respuesta a la demanda de la Regla 24 y otros programas que utilizan Compartir mis datos, las correcciones posteriores a los hechos para los rangos de fechas previamente autorizados pueden proporcionarse a terceros durante un máximo de tres años después del vencimiento de la autorización.
• Consulte “¿Cómo se manejarán las correcciones de datos?” para obtener más detalles sobre cómo recibir correcciones.

• Cualquier cliente de PG&E con una identificación de servicio actualmente activa para servicio de gas o electricidad puede autorizarlo a acceder a sus datos utilizando la nueva herramienta Compartir mis datos.

• Se recomienda encarecidamente a los clientes interesados en compartir sus datos a través del programa Compartir mis datos que se registren en una cuenta de My Energy. Esto hará que todo el proceso sea más eficiente y también les dará la capacidad de administrar sus autorizaciones en línea.
• Los clientes pueden inscribirse en una cuenta My Energy durante el proceso de autorización.
• Hay un proceso manual disponible para los clientes para obtener un Formulario de autorización para compartir mis datos en línea y enviar el formulario completo por correo electrónico.
• Para obtener más información sobre el proceso manual, comuníquese con nosotros a ShareMyData@pge.com.

• Los clientes deben hacer sus propias autorizaciones en línea a través de su cuenta en línea de PG&E. Sin embargo, si completan y firman el formulario de autorización para compartir mis datos, puede enviarlo a PG&E en su nombre.

Descargar el formulario de autorización o revocación de autorización del cliente para compartir mis datos (PDF, 308 KB)

• Puede actualizar sus URI de OAuth iniciando sesión en su cuenta, navegando a Administrar registro > Editar > y actualizando los campos en la sección Información de OAuth 2.0.

• Puede actualizar su URI de notificación iniciando sesión en su cuenta, navegando a Administrar registro > Editar > y actualizando los campos en la sección Información de acceso a datos.

• Puede actualizar su certificado SSL iniciando sesión en su cuenta, navegando a Administrar registro > Editar > y seleccionando "Actualizar" en la sección Información del certificado SSL. Tenga en cuenta que para las nuevas cargas de certificados, puede llevar varios días actualizar los sistemas de PG&E con el nuevo certificado.  
• Se enviará un correo electrónico de confirmación del equipo de soporte de Compartir mis datos cuando se haya aplicado el nuevo certificado.

• Una vez que reciba un correo electrónico que indique que su registro ha sido aceptado, podrá iniciar sesión en su cuenta Share My Data y descargar nuestro certificado SSL a través de la página Descargar certificado SSL de PG&E.

Iniciar sesión para compartir mis datos

• Compartir mis datos sigue los acuerdos de implementación de Green Button Connect My Data. Share My Data también emplea OAuth 2.0 para la autorización, Seguridad de la capa de transporte (Transport Layer Security, TLS) 1.2 y el conjunto mínimo de protocolos de seguridad cibernética aprobados por el Instituto Nacional de Estándares y Tecnología (National Institute of Standards and Technology, NIST) para que no se intercambie información de manera clara.

• Proteger la información del cliente es una prioridad principal para PG&E. PG&E trata la información sobre sus clientes, incluida la información personal, como confidencial, de acuerdo con todos los requisitos legales y reglamentarios, incluidos los establecidos por la Comisión de Servicios Públicos de California y otros.  
• Durante más de dos décadas, PG&E y otros servicios públicos propiedad de inversionistas en California han estado sujetos a regulaciones muy estrictas de la CPUC que les prohíben divulgar información específica del cliente, como datos de facturación, a terceros sin el consentimiento expreso del cliente.  
• Una vez que un cliente autoriza la divulgación de datos, es responsabilidad del cliente y del tercero proteger esos datos.
• Un cliente puede optar por dejar de compartir datos con un tercero en cualquier momento iniciando sesión en su cuenta en línea de PG&E y cancelando su autorización. La política de privacidad completa de PG&E y el Aviso de acceso, recopilación, almacenamiento, uso y divulgación de información sobre el uso de energía están disponibles en pge.com/privacy.

• Dentro del alcance del programa Compartir mis datos, los terceros están sujetos a las Reglas de privacidad y protección de datos del cliente especificadas en los términos y condiciones de la plataforma Compartir mis datos y a los requisitos incluidos en la Tarifa de acceso a datos del cliente.
• Los terceros también están sujetos a todas las demás leyes y reglamentaciones aplicables relacionadas con la protección de la privacidad del cliente, incluidas, entre otras, las Reglas sobre las protecciones de privacidad y seguridad para los datos de uso de energía adoptadas por la CPUC como Anexo D de la Decisión 11-07-056 (Electrónica), también resumidas en la Regla Eléctrica n.o 27 de PG&E y la Sección 1798.80 – 1798.84 del Código Civil de California.
• Para obtener más información, seleccione los siguientes enlaces:
  Compartir Mis términos y condiciones de datos (PDF, 190 KB)
  Regla eléctrica n.o 27 (PDF, 1.6 MB)
  Anexo D a la decisión 11-07-056 (PDF)
  Encuentre más información:Código Civil de California, Sección 1798.80 – 1798.84

• Consulte el enlace a continuación para obtener una lista detallada de los elementos de datos compatibles.

Obtenga más información sobre el acceso a los datos

• En ocasiones, faltan datos de uso de intervalo porque nuestros procesos de validación de datos ascendentes descubren que hay lecturas de datos faltantes o incorrectas que pueden requerir un procesamiento adicional (edición o estimación).
• Para los clientes facturados por intervalo (p. ej., clientes con consideraciones de facturación por tiempo de uso), estas instancias se corrigen a tiempo para garantizar un cálculo preciso de la factura en su próxima factura mensual.

• Si desea recibir correcciones de datos, asegúrese de marcar la casilla de verificación Notificarme como datos listos durante el registro o iniciando sesión en su cuenta en línea y seleccionando esta casilla de verificación en Editar perfil. Luego incluiremos correcciones de datos que hayan sido capturadas por nuestro sistema durante las 24 horas anteriores, como parte de la alimentación de uso diario, para cualquier dato al que esté autorizado a acceder.
• Las correcciones de datos cubrirán cualquier cambio para el período autorizado, hasta un máximo de tres años.

Nota: En consideración de los Proveedores de respuesta a la demanda de la Regla 24 y otros programas que utilizan Compartir mis datos, las correcciones posteriores a los hechos para los rangos de fechas previamente autorizados pueden proporcionarse a terceros durante un máximo de tres años después del vencimiento de la autorización.

• Si corresponde, PG&E enviará notificaciones a su URL de notificación proporcionada durante el registro. Las notificaciones comprenden URL correspondientes a datos ya preenvasados listos para que regrese y solicite en las URL proporcionadas. Los datos están preempaquetados y las notificaciones se envían en los siguientes dos escenarios: (1) ha seleccionado "Notifíqueme ya que los datos están listos" en su perfil de registro, en cuyo caso empacaremos los datos diarios más recientes con cualquier corrección para fechas pasadas, o (2) ha realizado una solicitud asíncrona ad hoc anterior para la cual los datos solicitados ahora están listos. El Escenario 1 se ilustra en la sección “DATA ACCESS: SUSCRIPCIÓN DIARIA" de los diagramas de Métodos de Acceso a Datos en la Página de Acceso a Datos y el escenario 2 se ilustra en la sección "DATA ACCESS: SOLICITUD DE AD HOC (ASINCRONOSO)" de los mismos diagramas también en la página de acceso a datos.

Acceso a los datos de la visita anterior

• Los datos de uso de electricidad proporcionados por Share My Data no son datos del medidor de calidad de liquidación (SQMD) según lo especificado por el operador del sistema independiente de California (CAISO). El SQMD se genera multiplicando los datos del medidor de calidad de ingresos (RQMD) por el factor de pérdida de distribución (DLF) aplicable al nivel de voltaje de ese cliente para ese intervalo, convirtiendo los intervalos medidos al período de intervalo requerido por el CAISO y luego sumando los resultados de cada intervalo al nivel agregado requerido por el CAISO.
  
• PG&E está implementando banderas del tipo "QualityOfReading" (QOR) proporcionadas por el estándar ESPI para comunicar si los datos son de calidad de ingresos. El tipo de QOR captura diferentes valores de calidad posibles para los datos de uso, incluido un valor explícito para “Datos del medidor de calidad de ingresos” o “RQMD”. PG&E utilizará este tipo de QOR en su transmisión de datos de la siguiente manera:
  • PG&E admite la clase de “Resumen de uso” proporcionada por ESPI, que se utilizará para identificar las fechas para las cuales se factura un acuerdo de servicio, el monto de uso facturado y la calidad de los datos de uso en el momento de la solicitud. El resumen de uso se completará una vez que la factura esté disponible para los datos solicitados e incluirá dos indicadores (elementos) del tipo QOR:
    • El elemento UsageSummary.QualityOfReading (en el nivel UsageSummary) que indica la calidad en el momento de la solicitud de los últimos valores de uso de intervalo proporcionados más las correcciones correspondientes a las fechas UsageSummary.billingPeriod.
    • El elemento PredeterminadoCalidad para TotalConsumoÚltimoPeríodo (como parte de UsageSummary.OverallConsumptionLastPeriod.ReadingTypeRef) indica la calidad del uso total facturado.
  • PG&E también comunicará la calidad de los datos de uso a nivel de intervalo en el momento de la solicitud utilizando el elemento IntervalReading.ReadingQuality.Quality.

• Durante el registro, puede seleccionar cuántos datos históricos necesita, ya sea 24, 36 o 48 meses en el menú desplegable "Cuántos datos históricos se solicitan".
• Como parte de la autorización de un cliente que le permite acceder a sus datos, el período histórico de autorización se establecerá de forma predeterminada en su selección de registro para las identificaciones de servicio (puntos de uso) incluidas en la autorización.
• Puede actualizar los datos históricos solicitados iniciando sesión en su cuenta, navegando a Administrar registro > Editar > y seleccionando en el menú desplegable "Cuántos datos históricos se solicitan".
• Tenga en cuenta que los datos proporcionados en la solicitud histórica comenzarán con la fecha en que el cliente realiza la autorización, en lugar de la fecha en que usted realiza la solicitud a la API.

Nota: Los cambios en los datos históricos solicitados solo afectan las autorizaciones de los clientes nuevos, mientras que las autorizaciones de los clientes anteriores reflejarán su selección en el momento de la autorización.

• Según el estándar ESPI, la respuesta utiliza el estándar de publicación de Atom. Seleccione el enlace a continuación para ver una lista completa de las API compatibles, junto con los elementos de datos disponibles.

Obtenga más información sobre el acceso a los datos

• Las identificaciones de servicio eléctrico y de gas activas instaladas y leídas por PG&E son elegibles para autorización a través de la plataforma Share My Data.
• Si la identificación del servicio asociada con una autorización cambia debido a uno de los siguientes motivos, la autorización pasará a la nueva identificación del servicio y continuará el acceso a los datos históricos de uso del intervalo:
  • Apagado temporal debido a falta de pagos
  • Mover a facturación de intervalo
  • Intercambio de medidor
  • Cambio de tarifa
• Otros escenarios que resulten en un cambio en la identificación del servicio, como el traslado de ubicaciones o el cambio de una compañía, terminarán el acceso. Además, si una cuenta está desvinculada de su cuenta de My Energy, todas las identificaciones de servicio subyacentes que fueron autorizadas a través de Share My Data no estarán autorizadas como resultado.

• Para determinar la granularidad de los datos del intervalo autorizado, consulte el elemento Longitud del intervalo según lo dispuesto por el estándar ESPI.
• PG&E proporciona datos de uso de intervalo con la misma granularidad que se recopila para fines de facturación, que generalmente es por hora o 15 minutos para datos eléctricos y diariamente para datos de gas para aquellos clientes con medidores de intervalo. Mientras que puede variar según el cliente, el uso del medidor de intervalo eléctrico generalmente está disponible a nivel por hora para la mayoría de los clientes residenciales y a nivel de intervalo de 15 minutos para la mayoría de los clientes comerciales, y el uso del medidor de intervalo de gas generalmente está disponible a nivel diario para la mayoría de los clientes.
• En el caso de los medidores sin intervalo, los datos se proporcionarán cuando estén disponibles.

• Para la gran mayoría de los clientes de PG&E con un medidor inteligente instalado, los datos de uso de intervalos eléctricos y de gas están disponibles al final del día siguiente a través de la plataforma Share My Data.
• La pequeña parte de los clientes de electricidad de PG&E con medidores MV90 basados en el portador de líneas eléctricas instalados puede requerir tiempo adicional para que los datos estén disponibles.

• Si bien no podemos respaldar directamente la configuración de sus API, tenemos una serie de recursos disponibles para ayudar a sus recursos técnicos y de TI en el proceso de desarrollo. Consulte nuestra página Documentación de API para obtener más información. También no dude en comunicarse conShareMyData@pge.com si tiene alguna pregunta adicional.

Para obtener más información, visite la interfaz de programación de aplicaciones (API)