Guide d implémentation du flux URM de relèves

Transcription

1 Guide d implémentation du flux URM de relèves Versions : Nom Version Date Modifications YBO /08/2007 Création du document YBO /05/2009 Mise à jour du document suite au déploiement portail V8 KBO /09/2015 Mise à jour du document pour BT+ et HTA

2 Table des Matières Guide d implémentation du flux relèves Préambule Définitions Caractéristiques du fichier Normes appliquées Occurrence d'une Classe Statut de la Classe Statut de l'attribut Format de l'attribut Règle de nommage du fichier Description détaillée du flux Entete... Erreur! Signet non défini Corps... 7 Guide implémentation flux URM relèves v / 17

3 Guide d implémentation du flux relèves 1 PREAMBULE Ce document présente une description du flux de relèves au format URM échangé entre URM et un acteur du marché. Avertissement : Les informations contenues dans ce guide sont publiées à titre d information et ne peuvent être assimilées à des règles contractuelles. Guide implémentation flux URM relèves v / 17

4 2 DEFINITIONS Le paragraphe ci-dessous donne quelques définitions de termes utilisés dans ce document : Espace De Livraison (EDL): il porte l'adresse géographique de l'endroit physique où est livrée l'énergie. Adresse géographique : combinaison de données géographiques. Point De Service (PDS) : il représente l'installation technique en place sur cet Espace De Livraison pour permettre la livraison d'une énergie donnée. Il porte les réglages mis en œuvre sur cette installation technique. Un PDS comporte un EDL. Un PDS concerne une Relève. Relève : elle décrit les conditions selon lesquelles ont été relevées et calculées les grandeurs physiques représentant les consommations d'énergie sur le Point De Service. Elle porte les informations sur les dates des index encadrant les consommations, sur la période couverte par ces consommations, sur la nature et le contexte de génération de cette relève. Une Relève contient des Grandeurs Physiques Générales. Calendriers distributeur et fournisseur : une Relève peut contenir un calendrier distributeur et un calendrier fournisseur. Abonnement cyclique de relève : permet de porter l abonnement dans le cas des relèves cycliques Modèle d'abonnement cyclique de relève : modèle d'abonnement cyclique de relève dans le cas des relèves cycliques. Grandeurs Physiques (GP) : la relève est référencée par autant de Grandeurs Physiques que de valeurs relevées et calculées sur l'installation de comptage du Point De Service. Une Grandeur Physique correspond à un modèle de grandeur physique. Modèle De Grandeur Physique (MGP) : il représente la définition de chaque Grandeur Physique (énergie, puissance, poste horosaisonnier, etc.) Grandeur courbe : une Grandeur Physique Générale peut contenir une Grandeur Courbe. Guide implémentation flux URM relèves v / 17

5 3 CARACTERISTIQUES DU FICHIER 3.1 NORMES APPLIQUEES Le fichier est écrit avec le langage XML. La notation utilisée pour nommer les Classes et les Attributs est conforme aux recommandations UMM. Pour chaque champ de type énuméré ou rempli avec des codes, le fichier donne l'identifiant de l'autorité de codification de référence OCCURRENCE D'UNE CLASSE Le nombre d'occurrence d'une Classe au sein de la transaction est : Soit "1" ; la Classe est unique dans la transaction, Soit "n" compris entre 2 à 9999 ; la Classe est multiple au sein de la transaction STATUT DE LA CLASSE Le statut d'une Classe au sein de la transaction est : "O" = Obligatoire, la classe est obligatoire dans la transaction "F" = Facultatif, la classe est optionnelle, elle dépend d'une règle de gestion STATUT DE L'ATTRIBUT Le statut d'un attribut au sein d'une classe est : "O" = Obligatoire, l'attribut est obligatoire au sein de la classe "F" = Facultatif, la présence de l'attribut est optionnelle FORMAT DE L'ATTRIBUT La notation du format d'un attribut est la notation Edifact. 3.2 REGLE DE NOMMAGE DU FICHIER La règle suivante est appliquée pour nommer les fichiers : R-EDK_AAAAMMJJHHMMSS_00001.zip où : AAAAMMJJ correspond à la date de création du fichier HHMMSS correspond à l heure de création du flux est une séquence qui s incrémente de 1 en 1 pour chaque flux publié avec le même préfixe (R-EDK_AAAAMMJJHHMMSS) Guide implémentation flux URM relèves v / 17

6 3.3 DESCRIPTION DETAILLEE DU FLUX ENTETE Niveau Objets/Attributs Cardinalité Caractère (O/F) Format Description Exemples de valeurs 1 <entete> 1 Objet 2 <identifiantflux> O String Code interne efluid.net R-EDK 2 <recepteur id="xxx" type="acteurechange" > 1 O Objet 3 <reference> O String code EIC de l'acteur récepteur 3 <libelle> F String nom de l'acteur récepteur acteurechange.acteurpub.nom 3 <type> F Integer fonction du récepteur 0 = GRD / 1 = Fournisseur 2 <emetteur id="xxx" type="acteurechange"> 1 O Objet 3 <reference> O String code EIC de l'acteur émetteur 3 <libelle> F String nom de l'acteur émetteur 3 <type> F Integer fonction du émetteur 2 <libelleflux> F String description du flux / texte libre "Publication exterme relève" 2 <datecreation> O DateTime date de génération du flux "04/12/ :48:14" 2 <formatmessage> O String norme appliquée pour "UEM" (en dur comme dans l'organisation des données MessageUEMMailMapper) 2 <versionmessage> O Integer "1" (en dur comme dans MessageUEMMailMapper) 2 <libellemodeleechange> F String type d'échange "REL Pub ext relèves GRD pour FR (mail EDK)" Guide implémentation flux URM relèves v / 17

7 3.3.2 CORPS Niveau Objets/Attributs Cardinalité Caractère (O/F) Format Description Exemples de valeurs 1 <releve> 1,n O Objet 2 <reference> O String Référence unique de la relève ex : "a7c8" 2 <datereleve> O DateTime Date de mesure de la relève (précision ex : 03/02/ :16:00 seconde) ex : "01/02/ :01:00" 2 <datereleveprecedente> F DateTime Date de mesure la relève précédente ex : "01/02/ :01:00" indique pour information la position de la 2 <sequence> F Integer relève dans le chainage des relèves ex : "1" enregistrées sur cette installation 2 <dureeperiodereleve> F Decimal Nombre de jours de la période de relève (concerne uniquement les grandeurs physiques qui ne se calculent pas par ex : "25.56" jours différence d'index) 2 <statutreleve> O Integer Statut de validation de la relève. - 1 : valide - 2 : invalide - 3 : en cours de traitement 2 <naturereleve> O Integer définit la qualité réelle ou estimé des grandeurs mesurées et donc de la relève 2 <typereleve> O Integer indique le processus générateur - 1 : réelle - 2 : estimée suite à absence client - 3 : estimé entre 2 relèves réelles - 7 : absence à la relève - 9 : estimé - 1 : récurrente - 21 : de régulation avec index - 22 : de régulation sans index - 3 : sur événement Guide implémentation flux URM relèves v / 17

8 2 <typeevenement> O Integer Guide implémentation flux URM relèves v / 17 précise le contexte ayant donné lieu à la génération de la relève - 1 : Souscription - 2 : Cessation - 3 : Modification contrat - 4 : Reprise - 5 : Sans objet - 6 : Souscription libre service - 7 : Cessation libre service - 8 : Souscription Changement de Fournisseur - 9 : Cessation Changement de Fournisseur - 10 : Modification contrat Changement de Fournisseur - 11 : Reprise Changement de Fournisseur - 12 : Rectification - 13 : Mise en service - 14 : Coupure pour non paiement - 15 : Prépose de matériel - 16 : Lecture d'index - 17 : Echange - 18 : Vérification - 19 : Mesurage - 20 : Replombage - 21 : Dépose - 22 : Raccordement d'asservissement - 23 : Raccordement de téléreport - 24 : Mise à jour heure légale - 25 : Mise hors service - 26 : Mise en service suite à coupure - 27 : Enquête - 28 : Contrôle qualité tension - 29 : Dépannage - mise hors service - 30 : Dépannage - échange - 31 : Dépannage - 33 : Intervention sur télérelève - 35 : Coupure technique

9 2 <rupture> F Integer 2 <technologiereleve> O Integer 2 <autoreleve> O Integer 2 <confiance> O Integer 2 <libelleconfigurationmaterielle> F String 2 <structurehorosaisonniere> O String 2 <calendrierdistributeur> 0,1 F Objet 3 <reference> O String 3 <libelle> O String 2 <calendrierfournisseur> 0,1 F Objet 3 <reference> O String 3 <libelle> O String 2 <pointdeservice type="yyy"> 1 O Objet 3 <reference> F String 3 <referenceexterne> O String Indique si la relève marque un changement dans la situation technique et/ou contractuelle dans la vie du point avec ou sans une rupture dans les mesures de cadrans. Indique que la relève a été fournie par un tiers et non par un agent de l'entreprise utilisatrice. Indique que la relève a été fournie par le client dans le cadre du service "Relevé Confiance" qu'il a souscrit pour être facturé sur la base d'une relève réelle, au moment d'une facturation estimée. contient la description de l'installation matérielle en place sur le point pour fournir la relève libellé du découpage horosaisonnier mis en œuvre par la configuration matérielle en place sur le PDS. Reference identifiant le calendrier de manière unique Contient le libellé du calendrier défini par le GRD Reference identifiant le calendrier de manière unique Contient le libellé du calendrier défini par le Fournisseur Référence unique interne du point de service. Référence externe du point de service partagé par les acteurs du marché 3 <activite> O Integer Définit le fluide délivré. - 1 : Début - 2 : Fin - 3 : Transition - 4 : Aucun 0 : La relève n'a pas été fournie par un tiers. 1 : La relève a été fournie par un tiers. 0 : La relève n'est pas issue du service "Relevé Confiance". 1 : La relève a été fournie par le client dans le cadre du service "Relevé Confiance".. ex : Heures plaines / Heures Creuses - 0 : Electricité - 1 : Gaz Guide implémentation flux URM relèves v / 17

10 3 <nature> O Integer 3 <etat> F Integer 3 <dateetat> F DateTime 3 <pdsregroupementpadt> F Integer 3 <sousetatelec> O Integer 3 <coupeelectricite> O String 3 <niveautension> O Integer 3 <typetension> O Integer Indique s'il s'agit de consommation ou de production. Détermine l'état du point de service pour qualifier la disponibilité d'un produit. Précise, à partir des interventions, la date de dernier changement du couple état/sousétat. Indique si le PDS correspond à l'installation technique prise en référence pour la fourniture des données de mesures et la gestion du contrat soumis à facturation de l'acheminement Précise l'état du PDS par rapport aux abonnements et aux matériels, spécifiquement pour l'électricité. Précise que le PDS est hors-service par coupure volontaire. Permet de spécifier le régime de livraison du produit. Indique le type de tension : mono ou triphasée. - 1 : Consommation - 2 : Production - 1 : Ne peut être mis en service - 3 : Hors service - 4 : En service - 5 : Supprimé 0 : il ne s'agit pas de l'installation de référence pour l'application du contrat. Ce PDS ne porte pas de contrat. 1 : il s'agit de l'installation de référence pour l'application du contrat. - 1 : Actif - 2 : Libre service - 3 : Déposé - 4 : Débranché - 5 : Débranché au branchement - 6 : Sans objet - 7 : Débranché au CCPI 0 : Le PDS n'est pas hors-service par coupure volontaire. 1 : Le PDS est hors-service par coupure volontaire. - 0 : HTB - 1 : HTA - 2 : BT+ - 3 : BT - 1 : Monophasé - 2 : Triphasé Guide implémentation flux URM relèves v / 17

11 3 <reglageprotection unit="a"> F Decimal 3 <typeprotection> F Integer Définit le réglage du disjoncteur ou du fusible en fonction de la puissance souscrite dans le contrat. Définit le type de protection électrique en place en tête de l'installation privée. 3 <modereleve> F Integer Définit le mode de relève appliqué au PDS Date approximative correspondant à la 3 <dateprochainereleve> O DateTime prochaine relève réelle. 3 <espacedelivraison> 1 O Objet 4 <reference> F String Référence unique de l'edl 4 <typeespace> F Integer Permet de spécifier la nature de l'espace et de différencier l'individuel du collectif. ex : : inconnu - 2 : aucun - 3 : fusible - 4 : disjoncteur - 5 : disjoncteur UL - 6 : sectionneur EP Exemples de valeurs possibles : - 1 : Normale - 2 : Télereport - 3 : Télérelève - 0 : Zone - 1 : Immeuble (collectif) - 2 : Individuel Guide implémentation flux URM relèves v / 17

12 4 <utilisation> O Integer Décrit l'utilisation qui est faite du local 4 <libelle> F String 4 <entree> F String 4 <niveau> F String 4 <situationsurniveau> F String Permet d attribuer un nom parlant à l espace de livraison, à la construction Permet d'identifier l'entrée d'un lieu à plusieurs accès, pour une adresse donnée. Permet d'identifier l'étage, le palier ou niveau où se trouve l'edl (cas des immeubles) Précise la situation de l'edl sur le niveau ou le palier. 4 <appartement> F String Permet d'identifier l'edl dans un ensemble d'edl. 4 <complementlocalisation> F String Complète l'adresse géographique du lieu - 0 : foire caravane - 1 : mobilier urbain - 2 : éclairage public - 3 : local technique - 4 : pompage trait. eaux - 5 : atelier dépôt - 6 : industrie - 7 : grande surface - 8 : commerce - 9 : administration - 10 : tertiaire service - 11 : établissement scolaire - 12 : habitation - 13 : installations sportives - 14 : communs - 15 : usage communal - 16 : santé - 17 : chantier - 18 : autres Exemple de valeurs possibles : - 1 : 1-2 : : rez-de-chaussée : droite - 2 : face - 3 : gauche Guide implémentation flux URM relèves v / 17

13 4 <adresse L'adresse géographique est formée d'une 1 O Objet type="donneegeographique"> cascade de données géographiques. 5 <numero> F String Correspond au numéro dans la voie et au complément du numéro (bis, ter, quater ) 5 <voie> O String Correspond à l'information suivante : type de voie / libellé de la voie. 5 <lieudit> F String Correspond au complément de localisation : hameau et lieu-dit sur une commune. 5 <commune> O String Correspond à l'information suivante : Commune ou bureau distributeur / Division territoriale. 5 <codeinseecommune> O Integer Confirme la commune par son code INSEE 3 <abonnementcycliquereleve> 0,1 F 4 <referenceexterneabonnement> O String Indique le libellé de l'acr dans le système externe abonnementcycliquereleve.referencesiamm 4 <jourdereleve> F Integer Indique le jour de relève associé à l'abonnement Entier entre 0 et 31 5 <modeleabonnementcycliquereleve> 1 O Objet 4 <type> 1 O Decimal Indique si le type du modèle d'abonnement cyclique est optionnel ou facturier. 2 <grandeursphysiques> 1 O Objet 3 <grandeurphysiquegenerale> 1,n O Objet 4 <valeur> O Decimal Indique la valeur de la grandeur physique issue de la relève référencée. 4 <valeurprecedente> F Decimal Valeur précédente de la grandeur physique (uniquement pour les modèles de grandeur physique structurées en index) 4 <referencecompteur> O String Précise la référence du compteur ayant fournit la valeur mesurée, ce qui permet de gérer des installations à plusieurs compteurs 4 <coefficientdelecture> F Integer Indique le coefficient de lecture valable pour ce cadran à appliquer dans le cas de grandeur index pour obtenir un volume. 4 <passageazero> F Integer Indique si le cadran est passé par 0 depuis le 0 : Le cadran n'est pas passé par 0. dernier relevé. 1 : Le cadran est passé par 0. 4 <nombredechiffrescompteur> O Integer Indique le nombre de chiffres du cadran sur lequel a été saisi l'index, ce qui est éncessaire Guide implémentation flux URM relèves v / 17

14 pour les calculs des volumes. 4 <grandeurcourbe> 0,1 F Objet 5 <basetemps> 1 O Objet 6 pastempsvaleurs O Integer Indique le délai entre 2 mesures successifs 5 <periode> 1 O Objet 6 <debut> O DateTime Début de la grandeur Mappé sur periode.startofperiod. 6 <fin> O DateTime Fin de la grandeur. Mappé sur periode.endofperiod. 5 <valeurs> 1 O Objet 6 <valeurtemporalisee> 1,n O Objet Date 7 <date> O ecore définit la date de la mesure du point (précision ex : 03/02/ : minute + timezone) 7 <valeur> O Decimal Indique la valeur du point relevé 4 <modelegrandeurphysique> 1 O Objet 5 <libelle> F String résume par un libellé la description de la grandeur mesurée 0-10 min 1-30 min 2- Horaire 3 - journalier 4 - mensuel 5 - trimestriel 6 - semestriel 7 - annuel 8 - hebdomadaire 9 - bi mensuel 10-1 min 11 - deux heures 12 - quatre heures 13 - huit heures Ex : "05/12/ :00:00" ex : indes énergie active HC Guide implémentation flux URM relèves v / 17

15 5 <releveoucalcule> O Integer 5 <type> O Integer Indique si la grandeur physique correspondante est issue d'une relève ou d'un calcul. distingue les énergies, des puissances, des indicateurs, etc - 0 : relève - 1 : calculé - 6 : Adapté - 1 : énergie - 2 : dépassement de puissance - 3 : puissance - 4 : durée - 5 : coefficient - 6 : tangente - 7 : indicateur - 8 : pertes - 9 : intensité - 10 : code - 11 : volume Guide implémentation flux URM relèves v / 17

16 5 <soustype> O Integer précise le type de grandeur 5 <structureinformation> O Integer indique si la valeur prend la forme d'un index, d'une grandeur remise à zéro à chaquie mesure, ou d'une courbe - 1 : active - 2 : active de dépassement - 3 : apparente - 4 : réactive - 5 : réactive à facturer - 6 : dépassement quadratique - 7 : nombre de dépassements - 8 : maximale atteinte - 9 : réglée - 10 : de dépassement - 11 : de fonctionnement - 12 : de pertes fer - 13 : de pertes joule - 14 : correction tangente phi - 15 : phi - 16 : ouverture capot - 17 : vraisemblance - 18 : programmation - 19 : mot état - 20 : actives fer - 21 : actives joules - 22 : actives totales - 23 : maximale - 24 : PDS borne poste - 25 : PDS avec condensateur - 26 : mono phase 1-27 : mono phase 2-28 : mono phase 3-29 : max phase 1-30 : max phase 2-31 : max phase 3-32 : réglée - 33 : dénivelé - 34 : active joule dépassement - 1 : Index - 2 : Valeur physique - 3 : Courbe de charge Guide implémentation flux URM relèves v / 17

17 5 <brutounet> F Integer 5 <origine> O Integer indique si la grandeur physique inclut des pertes ou non, ou cette notion n'est pas concernée par des pertes 5 <unite> O Integer Unité de la grandeur. 5 <sensdemesure> O Integer 5 <numerogroupe> O Integer 5 <postehorosaisonnier> F String 5 <mnemopostehorosaisonnier> O String Précise à partir de quelle structure de grandeur mesurée a été calculée la grandeur physique Désigne le sens d'écoulement de l'énergie : consommation ou production. définit l'ensemble cohérent de grandeurs, par exemple issues d'un même compteur de la configuration matérielle en place ou d'un même calendrier libellé du poste horosaisonnier dans lequel est comptée et mesurée la grandeur physique Si on a une etiquette, alors prend la valeur de libelleetiquette. Sinon prend la valeur de postehorosaisonnier.libelle comme avant. code du poste horosaisonnier dans lequel est comptée et mesurée la grandeur physique Si on a une etiquette, alors prend la valeur de mnemoetiquette. Sinon prend la valeur de postehorosaisonnier.mnemo comme avant. - 1 : Brut - 2 : Nette - 3 : Blanc - 4 : Corrigé - 0 : index - 1 : courbe - 2 : commun - 0 : kwh - 1 : kvarh - 2 : kw - 3 : kva - 4 : heure - 5 : minute - 6 : sans objet - 7 : Ampère - 0 : consommation - 1 : production ex : heures creuses ex : HC Guide implémentation flux URM relèves v / 17