Handleiding leveranciers
Marktstatistieken over huishoudelijke afnemers Handleiding - Leveranciers
Page 1 of 13
Handleiding leveranciers
Table of Contents 1. Introductie............................................................................................................................ 3 2. Werking van de Website....................................................................................................... 3 2.1 Inlog procedure ............................................................................................................... 3 2.2
Opladen van bestanden .................................................................................................... 4
3. Werking van de BI toepassing.............................................................................................. 6 3.1 Oplevering van bestanden................................................................................................. 6 3.1.1
Oplevering maandelijks Leverancier ................................................................................... 6
3.1.2
Oplevering maandelijks Standaard Leverancier ................................................................... 8
3.1.3
Oplevering kwartaal Leverancier ........................................................................................ 9
3.1.4
Oplevering jaarlijks Leverancier ....................................................................................... 11
3.2
Validatie van bestanden .................................................................................................. 13
3.3
Bekijken van bestanden .................................................................................................. 13
Page 2 of 13
Handleiding leveranciers 1.
Introductie Dit document bevat de handleiding van het MS BI Project voor de automatisering van de marktstatistieken bij VREG. In dit document staat uitgelegd wat de nieuwe functionaliteiten van de website zijn met name de inlogprocedure en het opladen van de bestanden.
2. Werking van de Website Om bestanden te kunnen opladen via de website moet men eerst toegang krijgen tot de website. Indien u geen login hebt, neem dan contact op met de Vreg om een nieuwe gebruiker en paswoord te bekomen.
2.1
Inlog procedure
Als u een gebruiker en paswoord hebt surft u naar http://www.vreg.be/ U kan inloggen links onderaan de pagina:
Indien u dit niet ziet klikt u op de knop ‘Sector’ bovenaan de pagina:
Na het inloggen krijgt u een scherm waar je bestanden kan opladen.
Page 3 of 13
Handleiding leveranciers
2.2
Opladen van bestanden
Nadat u een bestand hebt opgeladen en op de knop ‘Bevestigen’ hebt geklikt moet u ook nog meegeven voor welk bestandtype en periode het is. Men heeft de keuze om een periode kiezen van het huidige jaar of 5 jaar in de toekomst.
Page 4 of 13
Handleiding leveranciers De volgende stap is het selecteren van het juiste bestandtype en juiste periode. Voor het bestandtype heb je keuzes tussen: Maandelijkse marktrapportering Leverancier Maandelijkse marktrapportering Standaard Leverancier Aantal afnemers per product Leverancier Jaarlijkse rapportering i.k.v. SODV Leverancier Voor het bestandtype heb je keuzes tussen maandelijks, 3 maandelijks en jaarlijks Na dat er een bestand opgeladen is krijgt men een overzicht van welke bestanden er recent zijn opgeladen.
Als u een nieuw bestand wil opladen drukt u op de knop ‘Extranet’.
Page 5 of 13
Handleiding leveranciers
3. Werking van de BI toepassing Er zijn verschillende stappen die moeten doorlopen worden vóór dat de rapporten gemaakt kunnen worden. • Eerst en vooral moeten de leveranciers en netbeheerders via de website op een maandelijkse, drie maandelijkse of jaarlijkse basis bestanden opleveren. • Tijdens het opladen van de bestanden wordt er al een eerste controle uitgevoerd of de bestanden een correct formaat hebben, de periode correct is ingevuld en of er geen slechte GLN Nummers zijn ingevuld. • Nadien kan de Vreg de bestanden nogmaals openen en bekijken alvorens ze in te laden in de datawarehouse. • Als alle stappen goed zijn doorlopen kunnen de rapporten gemaakt worden.
3.1
Oplevering van bestanden
Voor het opleveren van een bestand moet de leverancier of netbeheerder eerst inloggen via de website van de Vreg. Na het inloggen kan via het extranet een bestand opladen voor een bepaalde periode en een bepaald type bestand. Eén van de volgende bestanden dienen als input voor een bepaald type rapportering: • Maandelijks Leverancier • Maandelijkse Standaard Leverancier • Kwartaal Leverancier • Jaarlijks Leverancier (SODV rapportering)
3.1.1 Oplevering maandelijks Leverancier Deze flow bevat de rapportering van maandelijkse switchgegevens door de leveranciers (Leveranciers #toegangspunten gewonnen of verloren). Er worden 2 bestandformaten ondersteunt: CSV en XML. Een heel belangrijk punt is dat het scheidingsteken in de csv bestanden ; moet zijn en geen , Als de csv opgemaakt wordt via Excel moet er ook voor gezorgd worden dat de formatering van de gln nummers een nummer is. Anders is het mogelijk dat de waarde van een gln nummer 5,42501E+12 is ipv 5425010539961 wat een probleem zal geven bij de verwerking.
Page 6 of 13
Handleiding leveranciers
Algemene opmerkingen •
• • • •
ContactPersoon, EmailContactPersoon, TelContactPersoon, FaxContactPersoon zijn optionele velden. Als deze niet ingevuld zijn dan worden vorige waarden in het systeem behouden. Zijn ze wel ingevuld dan worden de nieuwe waarden opgeladen LeverancierNaam is louter informatief. De gegevens worden geladen op basis van GLN nummer Periode wordt genoteeerd JJJJMMDD, bijvoorbeeld oktober 2008 wordt 20081001 EnergieType: Elektriciteit of Gas MeetwaardeType: Gewonnen of Verloren
CSV Layout De eerste rij van het bestand bevat de kolom titels: Er wordt geen text qualifier gebruikt Voorbeeld layout LeverancierGLNNummer;LeverancierNaam;ContactPersoon;EmailContactPersoon;TelContactPersoon;FaxCont actPersoon;Periode;EnergieType;MeetwaardeType;AMR;MMR;JGH;JGNH 5425012011007;Nuon Belgium;Ben Weerts;
[email protected]; +32 (0)2 290.96.29;0;200811;Elektriciteit;Gewonnen;7;1;1210;75 5425012011007;Nuon Belgium;Ben Weerts;
[email protected]; +32 (0)2 290.96.29;0;200811;Elektriciteit;Verloren;8;2;1323;124 5425012014008;Nuon Belgium;Ben Weerts;
[email protected]; +32 (0)2 290.96.29;0;200811;Gas;Gewonnen;0;3;1175;48 5425012014008;Nuon Belgium;Ben Weerts;
[email protected]; +32 (0)2 290.96.29;0;200811;Gas;Verloren;0;1;878;92
…..
XML Layout De XML definitie is beschreven in een XSD schema: (MaandelijkseRapporteringSwitchGegevensLeverancier.xsd) Voorbeeld layout <MaandelijkseRapporteringSwitchGegevensLeverancier>
Page 7 of 13
Handleiding leveranciers
3.1.2 Oplevering maandelijks Standaard Leverancier Deze flow bevat de rapportering van maandelijkse switchgegevens door de leveranciers (Standaard Leveranciers #toegangspunten). Er worden 2 bestandformaten ondersteunt: CSV en XML. Een heel belangrijk punt is dat het scheidingsteken in de csv bestanden ; moet zijn en geen , Als de csv opgemaakt wordt via Excel moet er ook voor gezorgd worden dat de formatering van de gln nummers een nummer is. Anders is het mogelijk dat de waarde van een gln nummer 5,42501E+12 is ipv 5425010539961 wat een probleem zal geven bij de verwerking.
Algemene opmerkingen •
• • • •
ContactPersoon, EmailContactPersoon, TelContactPersoon, FaxContactPersoon zijn optionele velden. Als deze niet ingevuld zijn dan worden vorige waarden in het systeem behouden. Zijn ze wel ingevuld dan worden de nieuwe waarden opgeladen LeverancierNaam is louter informatief. De gegevens worden geladen op basis van GLN nummer Periode wordt genoteeerd JJJJMMDD, bijvoorbeeld oktober 2008 wordt 20081001 EnergieType: Elektriciteit of Gas MeetwaardeType: Gewonnen, Verloren, Contract, Standaard
CSV Layout De eerste rij van het bestand bevat de kolom titels: Er wordt geen text qualifier gebruikt Voorbeeld layout LeverancierGLNNummer;LeverancierNaam;ContactPersoon;EmailContactPersoon;TelContactPersoon;FaxCont actPersoon;Periode;EnergieType;MeetwaardeType;AMR;MMR;JGH;JGNH 5499760912404;EBEM;Werner Pas;
[email protected];014/43.10.31;0;200811;Elektriciteit;Gewonnen;0;0;18;154 5499760912404;EBEM;Werner Pas;
[email protected];014/43.10.32;0;200811;Elektriciteit;Verloren;0;0;7;28 5499760912404;EBEM;Werner Pas;
[email protected];014/43.10.32;0;200811;Elektriciteit;Contract;10;13;632;4285 5499760912404;EBEM;Werner Pas;
[email protected];014/43.10.32;0;200811;Elektriciteit;Standaard;0;12;401;2465
Page 8 of 13
Handleiding leveranciers 5425012960039;EBEM;Werner 5425012960039;EBEM;Werner 5425012960039;EBEM;Werner 5425012960039;EBEM;Werner
Pas;
[email protected];014/43.10.33;0;200811;Gas;Gewonnen;0;1;31;344 Pas;
[email protected];014/43.10.34;0;200811;Gas;Verloren;0;0;5;14 Pas;
[email protected];014/43.10.32;0;200811;Gas;Contract;0;21;569;7416 Pas;
[email protected];014/43.10.32;0;200811;Gas;Standaard;0;0;0;0
…..
XML Layout De XML definitie is beschreven in een XSD schema: (MaandelijkseRapporteringSwitchGegevensStandaardLeverancier.xsd) Voorbeeld layout <MaandelijkseRapporteringSwitchGegevensStandaardLeverancier> <StandaardLeverancier LeverancierNaam="EBEM" ContactPersoon="Ben Weerts" EmailContactPersoon="
[email protected]" TelContactPersoon=" +32 (0)2 290.96.29" FaxContactPersoon ="0"/>
3.1.3 Oplevering kwartaal Leverancier Deze flow bevat de rapportering van kwartaal switchgegevens door de leveranciers (Leveranciers #toegangspunten). Er worden 2 bestandformaten ondersteunt: CSV en XML. Een heel belangrijk punt is dat het scheidingsteken in de csv bestanden ; moet zijn en geen , Als de csv opgemaakt wordt via Excel moet er ook voor gezorgd worden dat de formatering van de gln nummers een nummer is. Anders is het mogelijk dat de waarde van een gln nummer 5,42501E+12 is ipv 5425010539961 wat een probleem zal geven bij de verwerking.
Page 9 of 13
Handleiding leveranciers
Algemene opmerkingen • • • • •
Productnaam wordt gebruikt in het systeem en is niet informatief. Nieuwe producten worden per Leverancier en Categorie bijgehouden en toegevoegd. NetbeheerderNaam en LeverancierNaam zijn louter informatief. De gegevens worden geladen op basis van GLN nummer Periode wordt genoteeerd JJJJMMDD, bijvoorbeeld oktober 2008 wordt 20081001 EnergieType: Elektriciteit of Gas Categorie: H of NH
CSV Layout De eerste rij van het bestand bevat de kolom titels: Er wordt geen text qualifier gebruikt Voorbeeld layout LeverancierGLNNummer;LeverancierNaam;Periode;EnergieType;NetbeheerderGLNNummer;NetbeheerderNaam;P roductNaam;Categorie;Aantal;Actief 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus als standaardleverancier;H;0;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus standaard;H;2251;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus Actief;H;9688;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;euNeed-It (Euphony);H;1725;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus Budget;H;70;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus Direct;H;133;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus groen;H;1;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Luminus vast elektriciteit;H;347;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Sociaal Tarief;H;467;1 5425010539954;Luminus;200810;Elektriciteit;5414488000905;Gaselwest;Andere (bvb City Power, personeel, leegstand, ...);H;0;1
…..
XML Layout De XML definitie is beschreven in een XSD schema: (KwartaalRapporteringAantalToegangspuntenPerProductLeverancier.xsd) Voorbeeld layout
Page 10 of 13
Handleiding leveranciers KwartaalRapporteringAantalToegangspuntenPerProductPerNetbeheerder >
3.1.4 Oplevering jaarlijks Leverancier Deze flow bevat de rapportering voor de Jaarlijkse Leveranciers. Er worden 2 bestandformaten ondersteunt: CSV en XML. Een heel belangrijk punt is dat het scheidingsteken in de csv bestanden ; moet zijn en geen , Als de csv opgemaakt wordt via Excel moet er ook voor gezorgd worden dat de formatering van de gln nummers een nummer is. Anders is het mogelijk dat de waarde van een gln nummer 5,42501E+12 is ipv 5425010539961 wat een probleem zal geven bij de verwerking.
Algemene opmerkingen • •
De VraagOmschrijving is louter informatief. De Vraag wordt bepaald door de VraagID. De postcode of gemeente is niet verplicht. Voor de verwerking van de gemeente zijn er meerdere scenario’s: o Als de postcode ingevuld is met bijvoorbeeld 9200 en de gemeente met “Dendermonde”. Dan zullen de gegevens op de correcte gemeente terecht komen. o Als enkel de postcode ingevuld is met bijvoorbeeld 9200 en de gemeente met “”. Dan zullen de gegevens op de eerste gemeente terechtkomen die het systeem vind met als postcode 9200, dus dit zal in dit voorbeeld Appels zijn. o Als de postcode ingevuld is met bijvoorbeeld 9200 en een verkeerde gemeente of verkeerd getypt zoals “Dendrmond”. Dan zullen de gegevens ook op de eerste gemeente terechtkomen die het systeem vind met als postcode 9200.
Page 11 of 13
Handleiding leveranciers
Vullen ze geen enkele van de 2 velden in, dan zullen de gegevens op de gemeente ‘Onbekend’ (-1) terechtkomen. Ook als de postcode in combinatie met de gemeente niet correct is zal dit ook op Onbekend’ (-1) terechtkomen. LeverancierNaam is louter informatief. De gegevens worden geladen op basis van GLN nummer Periode wordt genoteeerd JJJJMMDD, bijvoorbeeld 2009 wordt 20090101 EnergieType: Elektriciteit of Gas De waardes voor Beschermde of Niet_Beschermde moet ingevuld zijn. Indien dit niet beschikbaar is moet er een koppelteken ingevuld worden. o
• • • •
CSV Layout De eerste rij van het bestand bevat de kolom titels: Er wordt geen text qualifier gebruikt Voorbeeld layout LeverancierGLNNummer;LeverancierNaam;Postcode;Gemeente;VraagID;VraagOmschrijving;Periode;Bescherm de;Niet_Beschermde 5414489001307;Electrabel NV;;;1000;Aantal aansluitingen waarvoor door de leverancier in het rapporteringsjaar een herinneringsbrief werd verstuurd: (1);20070101;22219;461262 5414489001307;Electrabel NV;;;1010;Aantal aansluitingen waarvoor door de leverancier in het rapporteringsjaar een ingebrekestelling werd verstuurd: (1);20070101;3069;78437 5414489001307;Electrabel NV;;;1020;Aantal door de leverancier toegestane betalingsplannen in het rapporteringsjaar:;20070101;4915;42469 5414489001307;Electrabel NV;;;1030;Gemiddelde betalingsbedrag per maand van in het rapporteringsjaar lopende betalingsplannen, uitgedrukt in € (2 cijfers na komma): (2);20070101;73,57;122,72 5414489001307;Electrabel NV;;;1040;Aantal niet-nageleefde betalingsplannen in het rapporteringsjaar: (3);20070101;645;4264 5414489001307;Electrabel NV;;;1050;Aantal dossiers dat door de leverancier in het rapporteringsjaar werd doorgestuurd naar het OCMW: (4) ;20070101;1179;1451 5414489001307;Electrabel NV;;;1060;Aantal dossiers dat door de leverancier in het rapporteringsjaar werd doorgestuurd naar een erkende instelling voor schuldbemiddeling: (4);20070101;11;26 5414489001307;Electrabel NV;;;1070;Aantal aansluitingen waarvan de bewoner heeft aangetoond recht te hebben op het specifiek sociaal tarief - situatie op 31 december van het rapporteringsjaar;20070101;78039;-
…..
XML Layout De XML definitie is beschreven in een XSD schema: (JaarlijkseRapporteringSwitchGegevensLeverancier.xsd) Voorbeeld layout Page 12 of 13
Handleiding leveranciers <JaarlijkseSODVRapporteringLeverancier> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1000" VraagOmschrijving="Aantal aansluitingen waarvoor door de leverancier in het rapporteringsjaar een herinneringsbrief werd verstuurd: (1)" Beschermde="22219" Niet_Beschermde="461262" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1010" VraagOmschrijving="Aantal aansluitingen waarvoor door de leverancier in het rapporteringsjaar een ingebrekestelling werd verstuurd: (1)" Beschermde="3069" Niet_Beschermde="78437" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1020" VraagOmschrijving="Aantal door de leverancier toegestane betalingsplannen in het rapporteringsjaar:" Beschermde="4915" Niet_Beschermde="42469" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1030" VraagOmschrijving="Gemiddelde betalingsbedrag per maand van in het rapporteringsjaar lopende betalingsplannen, uitgedrukt in € (2 cijfers na komma): (2)" Beschermde="73.57" Niet_Beschermde="122.72" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1040" VraagOmschrijving="Aantal nietnageleefde betalingsplannen in het rapporteringsjaar: (3)" Beschermde="645" Niet_Beschermde="4264" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1050" VraagOmschrijving="Aantal dossiers dat door de leverancier in het rapporteringsjaar werd doorgestuurd naar het OCMW: (4) " Beschermde="1179" Niet_Beschermde="1451" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1060" VraagOmschrijving="Aantal dossiers dat door de leverancier in het rapporteringsjaar werd doorgestuurd naar een erkende instelling voor schuldbemiddeling: (4)" Beschermde="11" Niet_Beschermde="26" /> <SODV_Leverancier Postcode="0" Gemeente="" VraagID="1070" VraagOmschrijving="Aantal aansluitingen waarvan de bewoner heeft aangetoond recht te hebben op het specifiek sociaal tarief - situatie op 31 december van het rapporteringsjaar" Beschermde="78039" Niet_Beschermde="-" />
3.2 Validatie van bestanden Tijdens het opladen van een bestand wordt er een validatie uitgevoerd om te controleren of de GLN nummers correct zijn en of de periode die is ingevuld via de website wel degelijk klopt het de periode die in het bestand staat vermeld.
Een tweede controle dat uitgevoerd wordt is dat de inhoud van een XML bestand voldoet aan een voorgedefinieerd formaat. Dit word met een XSD bestand wordt vergeleken.
3.3 Bekijken van bestanden De bestanden die men net heeft opgeladen kunnen in het overzicht scherm geopend worden , en eventueel ook terug verwijderd worden.
Page 13 of 13