Documentation de service Web / Catégories / Services de compteur / Ajouter l’achat d’énergie verte produite hors site

Ajouter l’achat d’énergie verte produite hors site

Mise à jour le 30 juin 2024

Description

Ce service Web ajoute un nouvel enregistrement d’achat d’énergie verte produite hors site à une propriété précise en fonction des renseignements fournis dans la demande du fichier XML. La propriété correspondante doit déjà être partagée avec vous et vous devez avoir un accès par écrit à la propriété.

Version

23.0

Méthode HTTP

POST

URL de la ressource

/property/(propertyId)/offsiteGreenPowerPurchases

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
propertyId	Identifiant de la propriété

Schémas XML

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

Exemple de demande

L’exemple suivant ajoute un enregistrement d’achat précis d’énergie verte produite hors site à une propriété ayant un numéro d’identification 841.

POST  /property/841/offsiteGreenPowerPurchases

<?xml version="1.0" encoding="UTF-8"?>
<offsiteGreenPowerPurchase>
     <recOwnedAndRetired>true</recOwnedAndRetired>
     <type>Unbundled RECs</type>
     <meetVintageRequirement>true</meetVintageRequirement>
     <startDate>2023-01-01</startDate>
     <endDate>2023-07-01</endDate>
     <amountPurchased>
          <percentage>
               <value>100</value>
               <includeAllMeters>false</includeAllMeters>
               <meters>
                    <id>1</id>
               </meters>
          </percentage>
     </amountPurchased>
     <estimate>false</estimate>
     <generationLocation>
          <eGridSubRegion>AKMS</eGridSubRegion>
     </generationLocation>
     <certifiedByGreene>true</certifiedByGreene>
     <provider>Renewable Systems</provider>
     <facilityName>Renewable Systems Premiere</facilityName>
     <fuelSources>
          <fuelSource>
               <type>Wind</type>
               <percentage>50</percentage>
          </fuelSource>
          <fuelSource>
               <type>Solar</type>
          </fuelSource>
     </fuelSources>
     <renewableGenerationTechnologies>
          <technology>Solar PV- Rooftop</technology>
     </renewableGenerationTechnologies>
     <ratedCapacity uom="kW">
          <value>1000</value>
     </ratedCapacity>
     <operationDate>2000-01-01</operationDate>
     <contractStartDate>2023-01-01</contractStartDate>
     <contractEndDate>2023-12-31</contractEndDate>
     <cost uom="kWh (thousand Watt-hours)">
          <value>12.34</value>
     </cost>
     <notes>This is an estimate.</notes>
</offsiteGreenPowerPurchase>

Exemple de réponse

L’exemple suivant montre le résultat de l’ajout d’un enregistrement d’achat d’énergie verte externe. Notez que l’attribut d’indication est défini sur le type d’énergie verte et les dates de début et de fin.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links>
          <link id="181" hint="Unbundled RECs (2023-01-01 - 2023-07-01)" linkDescription="This is the GET url for this Offsite Green Power Purchase." link="/offsiteGreenPowerPurchases/181" httpMethod="GET"/>
     </links>
</response>

header.banner.text