Documentation de service Web / Catégories / Services de compteur / Modifier les données de consommation du compteur
Mise à jour le 28 juin 2021
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.
22.0
PUT
/consumptionData/(consumptionDataId)
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant | |
Type de contenu | application/xml |
Oui
Nom du paramètre | Description |
---|---|
consumptionDataId | Identifiant des données de consommation du compteur |
Demande/réponse | Nom de schéma |
---|---|
Demande | meterConsumptionData.xsd |
Réponse | response.xsd |
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>
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>