Documentation de service Web / Catégories / Services de signalement / Obtenir les raisons pour lesquelles une cote d'énergie n'est pas disponible

Obtenir les raisons pour lesquelles une cote d'énergie n'est pas disponible

Mise à jour le 1 septembre 2015

Description

Ce service Web récupère une liste des raisons pour lesquelles une propriété ne peut pas recevoir une cote ENERGY STAR pour une date de fin de période donnée. Si l'année et le mois ne soient pas fournis, on utilise la période d'énergie en cours. Veuillez consulter le Répertoire des alertes (en anglais seulement) pour la liste des raisons pouvant être fournies. Examinez tout particulièrement les alertes qui portent la mention « yes » dans la colonne des explications N/A; il s'agit d'alertes émis lorsqu'une mesure, p. ex., la cote ENERGY STAR, ne peut pas être calculée.

Version

22.0

Méthode HTTP

GET

URL de la ressource

/property/(propertyId)/reasonsForNoScore?year=(year)&month=(month)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
month Facultatif. Mois qui représente la date à laquelle la période sélectionnée se termine. Les valeurs valides sont 1 à 12, où 1 représente janvier et 12 représente décembre. Si vous ne précisez pas le mois et l'année, on utilisera la date à laquelle la période d'énergie en cours se termine.
propertyId Identifiant de la propriété
year Facultatif. Année qui représente la date à laquelle la période sélectionnée se termine. Si vous ne précisez pas le mois et l'année, on utilisera la date à laquelle la période d'énergie en cours se termine.

Schémas XML

Demande/réponse Nom de schéma
Demande Aucun
Réponse alerts.xsd

Exemples de demande

L'exemple qui suit récupère la liste des raisons pour lesquelles la propriété ne peut pas recevoir une cote ENERGY STAR pour la période se terminant le 12/31/2014.

GET  /property/712/reasonsForNoScore?year=2014&month=12

L'exemple qui suit récupère la liste des raisons pour lesquelles la propriété ne peut pas recevoir une cote ENERGY STAR pour la période d'énergie la plus récente. À noter que l'année et le mois ne sont pas tout les deux fournis.

GET  /property/712/reasonsForNoScore

Exemple de réponse

L'exemple qui suit présente la liste des raisons pour lesquelles la propriété 712 ne peut pas recevoir une cote ENERGY STAR.

<?xml version="1.0" encoding="UTF-8"?>
<alerts propertyId="712" month="12" year="2014">
    <alert>
        <name>Hours of Operation for Office are Out of Range</name>
        <description>An office must be open at least 30 hours per week to receive a score but the average hours
across all of your offices is only 25 hours: Office 1 (Open 20 hours); Office 2 (Open 30 hours)
        </description>
    </alert>
    <alert>
        <name>Meter has gaps</name>
        <description>The following meters have gaps between bills: Meter 1 (Gap from 4/1/2014 to 4/10/2014), 
Meter 2 (Gap from 6/4/2014 to 6/20/2014).
        </description>
    </alert>
</alerts>
ENVIRONNEMENT DE PRODUCTION