Documentation de service Web / Catégories / Services de compteur / Modifier les données de consommation du compteur

Modifier les données de consommation du compteur

Mise à jour le 28 juin 2021

Description

Ce service Web effectue la mise à jour d'une fiche spécifique de données de consommation de compteur en fonction de l'information fournie dans la demande XML. Le compteur correspondant doit déjà être partagé avec vous et vous devez y avoir l'accès en écriture.

Version

22.0

Méthode HTTP

PUT

URL de la ressource

/consumptionData/(consumptionDataId)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant
Type de contenu application/xml

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
consumptionDataId Identifiant des données de consommation du compteur

Schémas XML

Demande/réponse Nom de schéma
Demande meterConsumptionData.xsd
Réponse response.xsd

Exemples de demande

L'exemple suivant montre la mise à jour d'une fiche existante de données de consommation de compteur dont l'identifiant correspond à 711.

PUT  /consumptionData/711

<?xml version="1.0" encoding="UTF-8"?> <meterConsumption> <usage>12345</usage> <startDate>2011-01-01</startDate> <endDate>2011-01-31</endDate> </meterConsumption>

L'exemple suivant montre la mise à jour d'une fiche existante de données de consommation d'un compteur en énergie verte. Pour enlever l'énergie verte d'une fiche de consommation existante, supprimer les données sur l'énergie verte de l'XML.

PUT  /consumptionData/712

<?xml version="1.0" encoding="UTF-8"?> <meterConsumption estimatedValue="false"> <usage>1000</usage> <startDate>2010-03-15</startDate> <endDate>2010-04-14</endDate> <greenPower> <generationLocation> <generationPlant>56859</generationPlant> </generationLocation> <sources> <solarPct>20.0</solarPct> <windPct>20.0</windPct> <geothermalPct>20.0</geothermalPct> <smallHydroPct>20.0</smallHydroPct> <biomassPct>0.0</biomassPct> <biogasPct>20.0</biogasPct> </sources> <value>99</value> </greenPower> </meterConsumption>

L'exemple suivant montre la mise à jour d'une fiche de données de consommation d'un compteur avec des données de demande. Pour enlever les données de demande d'une fiche de consommation existante, supprimer les données de demande de l'XML. Les données de demande s'appliquent uniquement aux compteurs d'électricité achetée du réseau.

PUT  /consumptionData/713

<?xml version="1.0" encoding="UTF-8"?> <meterConsumption estimatedValue="false"> <usage>1000</usage> <startDate>2010-03-15</startDate> <endDate>2010-04-14</endDate> <demandTracking> <demand>99</demand> <demandCost>5859</demandCost> </demandTracking> </meterConsumption>

L’exemple suivant permet de mettre à jour la consommation d’un compteur existant en supprimant la valeur de coût correspondant. Pour mettre à jour la valeur de la consommation du compteur existant sans préserver le coût existant, il suffit d’omettre les données sur les coûts du fichier XML.

PUT  /consumptionData/713

<?xml version="1.0" encoding="UTF-8"?> <meterConsumption estimatedValue="false"> <usage>1000</usage> <startDate>2010-03-15</startDate> <endDate>2010-04-14</endDate> <cost/> </meterConsumption>

L'exemple suivant montre la mise à jour une consommation de compteur existante qui spécifie l'arbitrage.

PUT  /consumptionData/7132

<?xml version="1.0" encoding="UTF-8"?> <meterConsumption estimatedValue="false"> <startDate>2000-04-01</startDate> <endDate>2000-05-01</endDate> <energyExportedOffSite>11111</energyExportedOffSite> <RECOwnership>Arbitrage</RECOwnership> <greenPower> <generationLocation> <eGridSubRegion>AKGD</eGridSubRegion> </generationLocation> </greenPower> <usage>111111</usage> </meterConsumption>

Exemple de réponse

L'exemple suivant indique que la mise à jour des données de consommation du compteur a été réussie avec succès.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
    <id>711</id>
    <links>
        <link httpMethod="GET" link="/meter/1/consumptionData" linkDescription="This is the GET url for this Meter Consumption Data."/>
    </links>
</response>
ENVIRONNEMENT D'ESSAI