Documentation de service Web / Catégories / Services de compteur / Ajouter des données de consommation

Ajouter des données de consommation

Mise à jour le 28 juin 2021

Description

Ce service Web ajoute les données de consommation à un compteur spécifique en fonction de l'information fournie dans la demande XML. Il retourne l'identifiant unique de chaque entrée de données de consommation et un lien vers le service Web correspondant pour le récupérer. Le compteur doit déjà être partagé avec vous et vous devez y avoir accès en écriture. Ce service Web prend en charge tous les types de compteur (électrique, gaz naturel, eau, TI, etc.). L'information sur l'énergie verte peut aussi être ajoutée pour les compteurs d'énergie renouvelable. Le suivi de la demande est également disponible pour les compteurs de l'électricité achetée du réseau. Un maximum de 120 fiches de consommation est permis.

Version

22.0

Méthode HTTP

POST

URL de la ressource

/meter/(meterId)/consumptionData

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
meterId	Identifiant du compteur

Schémas XML

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

Exemples de demande

L'exemple suivant montre l'ajout de données de consommation au compteur dont l'identifiant correspond à 500.

POST  /meter/500/consumptionData

<?xml version="1.0" encoding="UTF-8"?>
<meterData>
    <meterConsumption>
        <usage>639573</usage>
        <startDate>2011-01-01</startDate>
        <endDate>2011-01-31</endDate>
    </meterConsumption>
    <meterConsumption>
        <usage>613123</usage>
        <startDate>2011-02-01</startDate>
        <endDate>2011-02-28</endDate>
    </meterConsumption>
</meterData>

L'exemple suivant montre l'ajout de données d'énergie verte au compteur dont l'identifiant correspond à 501.

POST  /meter/501/consumptionData

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

L'exemple suivant montre l'ajout de données de consommation et de demande au compteur dont l'identifiant correspond à 502.

POST  /meter/502/consumptionData

<?xml version="1.0" encoding="UTF-8"?>
<meterData>
    <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>
</meterData>

L'exemple suivant ajoute des données de consommation qui spécifient l'arbitrage pour un compteur solaire électrique sur place dont l'identifiant est 512.

POST  /meter/512/consumptionData

<?xml version="1.0" encoding="UTF-8"?>
<meterData>
     <meterConsumption estimatedValue="false">
          <startDate>2000-03-01</startDate>
          <endDate>2000-04-01</endDate>
          <energyExportedOffSite>22</energyExportedOffSite>
          <RECOwnership>Arbitrage</RECOwnership>
          <greenPower>
               <generationLocation>
                    <generationPlant>2</generationPlant>
               </generationLocation>
          </greenPower>
          <usage>222</usage>
     </meterConsumption>
     <meterConsumption estimatedValue="false">
          <startDate>2000-04-01</startDate>
          <endDate>2000-05-01</endDate>
          <energyExportedOffSite>11</energyExportedOffSite>
          <RECOwnership>Arbitrage</RECOwnership>
          <greenPower>
               <generationLocation>
                    <eGridSubRegion>AKGD</eGridSubRegion>
               </generationLocation>
          </greenPower>
          <usage>111</usage>
     </meterConsumption>
     <links/>
</meterData>

Exemple de réponse

L'exemple suivant indique que l'ajout des données de consommation au compteur a été réussi avec succès et que l'identifiant de la facture de services publics correspond à 745.

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

header.banner.text