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

Ajouter des données de consommation

Mise à jour le 30 juin 2024

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

27.0

Méthode HTTP

POST

URL de la ressource

/meter/(meterId)/consumptionData

En-tête

Nom du champ Valeur Commentaires
Authorization Basic authentifiant
Content-Type 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/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>

Exemple de réponse

L’exemple suivant indique que les données de consommation ont été ajoutées au compteur avec succès et que cette facture de services publics porte l’identifiant 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>
     </meterConsumption>
</meterData>
ENVIRONNEMENT D'ESSAI