EAN-codeboek-integratie laten bouwen
In het EAN-codeboek zoekt u de EAN-code van een elektriciteits- of gasaansluiting op, samen met de netbeheerder die erbij hoort. Het codeboek wordt aangeboden door EDSN, de organisatie die de netbeheerders hebben opgericht voor de uitwisseling van energiedata. EDSN publiceert er ook een API voor, beschreven met een OpenAPI-specificatie. Appfront bouwt de koppeling die die zoekfunctie in uw eigen systemen gebruikt, zodat medewerkers en klanten EAN-codes niet meer met de hand opzoeken en overtypen.
Wat is een koppeling met het EAN-codeboek?
Een koppeling met het EAN-codeboek haalt bij een adres de EAN-code van de elektriciteits- of gasaansluiting op, met de netbeheerder die erbij hoort. Elke aansluiting op het energienet heeft zo'n code, en wie een aansluiting wil overzetten, aanmelden of beheren, heeft die nodig. Het codeboek wordt aangeboden door EDSN, Energie Data Services Nederland, in 2007 opgericht door de netbeheerders om energiedata toegankelijk en uitwisselbaar te maken. Op de website van EDSN staat dat u in het EAN-codeboek de gegevens van een energieaansluiting en de netbeheerder kunt opzoeken.
Naast de website is er de EANCodeBoek API. Volgens de OpenAPI-beschrijving van EDSN is die bedoeld om te zoeken via een API in plaats van de website te scrapen. U kunt netbeheerders opvragen die op een postcode actief zijn, met hun EAN-code en of ze elektriciteit, gas of beide leveren. U kunt aansluitingen zoeken op product en postcode, eventueel met huisnummer en toevoeging. Per aansluiting komen onder meer de EAN-code, het adres, het product, de netbeheerder, het netgebied, het BAG-id en een eventueel gekoppelde hoofdaansluiting terug. Voor de voorwaarden verwijst de beschrijving naar de disclaimer van EDSN, die geen garantie geeft op juistheid, volledigheid of actualiteit. Meetstanden en verbruik staan niet in het codeboek.
Wij bouwen maatwerk omdat de vraag zelden bij de zoekopdracht ophoudt. Een adres in uw CRM is anders geschreven dan in het codeboek, een pand heeft meerdere aansluitingen, of er komt bij een postcode niets terug. De koppeling normaliseert het adres, kiest bij meerdere resultaten de juiste aansluiting of legt de keuze voor aan een medewerker, en zet de EAN-code en netbeheerder op de juiste plek in uw systeem. Een zoekvraag die niets oplevert, komt in een lijst met de reden erbij, zodat niemand een code verzint.
Bij het adres
EAN-code automatisch gevonden.
Met netbeheerder
Netgebied en product erbij.
Gecontroleerd
Twijfel naar een medewerker.
Hoe wij uw koppeling met het EAN-codeboek bouwen
We beginnen bij uw proces: waar EAN-codes nu worden opgezocht, door wie, in welk systeem ze terechtkomen en wat er misgaat als een code niet klopt. Daarna bouwen we de koppeling met de EANCodeBoek API en testen we die met een reeks echte adressen uit uw bestand, ook de lastige: nieuwbouw, appartementen, bedrijfspanden met meerdere aansluitingen. We bouwen eerst het opzoeken bij één proces, bijvoorbeeld een aanvraag of een nieuwe klant, en laten u de resultaten beoordelen. Andere processen volgen als dat goed loopt. Daarna bewaken we de koppeling op wijzigingen in de API van EDSN.
Waar codes nu vandaan komen.
Met echte adressen.
Aanvraag of nieuwe klant.
Livegang, bewaking, en beheer bij wijzigingen.
Wat een koppeling met het EAN-codeboek concreet doet
De onderdelen hieronder komen in vrijwel elke koppeling met het EAN-codeboek terug. Welke u nodig hebt, hangt af van uw processen en van de systemen waarin de codes terecht moeten komen.
Zoeken
Op postcode en huisnummer.
Netbeheerder
Per postcode en product.
Adrescontrole
Schrijfwijzen gelijkgetrokken.
Keuze
Meerdere aansluitingen voorgelegd.
Opslag
Code op de juiste plek.
Logboek
Elke zoekvraag terug te vinden.
Voor wie wij een koppeling met het EAN-codeboek bouwen
De koppeling is bedoeld voor organisaties die regelmatig EAN-codes van aansluitingen nodig hebben en die nu met de hand opzoeken. Hoe meer adressen en hoe meer processen, hoe meer het oplevert.
Energieleveranciers
Code bij het aanmelden.
Installateurs
Netbeheerder bij de aanvraag.
Coöperaties
Aansluitingen van leden.
Softwarebouwers
Opzoeken in uw pakket.
Technologie en koppelingen
Deze pagina gaat over het opzoeken van EAN-codes en netbeheerders in het EAN-codeboek. Bouwt u een volledig systeem voor energielevering, kijk dan naar onze pagina over energie-software; voor coöperaties met leden en projecten is er software voor energiecoöperaties, en voor inzicht in verbruik die over energiemanagement. Omdat de API met een OpenAPI-specificatie is beschreven, past ook onze OpenAPI-koppeling erbij. Onze werkwijze leest u op software laten maken.
Waarom Appfront voor uw koppeling met het EAN-codeboek?
Een EAN-code die verkeerd is overgetypt, een aanvraag bij de verkeerde netbeheerder, of een medewerker die bij elke nieuwe klant de website van het codeboek opent, kost tijd en levert vertraging op bij aanmelden en overzetten. Daar bouwen we op: opzoeken vanuit uw eigen systeem, controle bij twijfel en een logboek waarin u terugziet waar een code vandaan komt.
Juist
Code uit de bron, niet overgetypt.
Snel
Opzoeken zonder schakelen.
Navolgbaar
Herkomst van elke code.
Security en privacy bij een koppeling met het EAN-codeboek
De koppeling zoekt op adres en verwerkt adressen van uw klanten of leden. Die adressen zijn persoonsgegevens als ze bij een persoon horen, en dan geldt de AVG. De koppeling stuurt alleen de gegevens mee die de API vraagt, zoals postcode en huisnummer, slaat de resultaten op bij het juiste record en legt elke zoekvraag vast met tijd en resultaat.
De koppeling draait in een Europees datacenter, met versleutelde verbindingen en opslag. Omdat EDSN geen garantie geeft op juistheid en actualiteit, toont de koppeling bij twijfel de bron en de datum van opzoeken, en kan een medewerker een code bevestigen of corrigeren. Wie in uw organisatie codes mag wijzigen, stemmen we vooraf met u af.
Veelgestelde vragen over een koppeling met het EAN-codeboek
Vragen die energieleveranciers, installateurs en softwareleveranciers stellen voordat ze hiermee beginnen.
Een openbare zoekfunctie waarmee u de EAN-code van een elektriciteits- of gasaansluiting en de bijbehorende netbeheerder opzoekt. Het wordt aangeboden door EDSN, de organisatie die de netbeheerders hebben opgericht voor de uitwisseling van energiedata.
Ja. EDSN publiceert de EANCodeBoek API, beschreven met een OpenAPI-specificatie. Volgens die beschrijving is de API bedoeld om te zoeken zonder de website te scrapen. U zoekt netbeheerders op postcode en aansluitingen op product, postcode en eventueel huisnummer.
Per aansluiting onder meer de EAN-code, het adres, of het om elektriciteit of gas gaat, de netbeheerder, het netgebied, het BAG-id en een eventueel gekoppelde hoofdaansluiting. Meetstanden en verbruik horen daar niet bij.
De beschrijving van de API verwijst voor voorwaarden en licentie naar de disclaimer van EDSN. Daarin staat onder meer dat EDSN geen garantie geeft op de juistheid, volledigheid of actualiteit van de informatie. Voor vragen over gebruik is de servicedesk van EDSN het aanspreekpunt.
Dan zet de koppeling het adres in een lijst met de reden erbij, bijvoorbeeld een afwijkende schrijfwijze of een adres dat nog niet in het codeboek staat. Een medewerker kan het adres controleren en opnieuw laten zoeken. Een code wordt nooit geraden.
Energie-software is een volledig systeem voor bijvoorbeeld levering, facturatie of klantbeheer. Een koppeling met het EAN-codeboek is één onderdeel: het betrouwbaar opzoeken van EAN-codes en netbeheerders. Die koppeling kan in een bestaand systeem worden ingebouwd.
Voor organisaties die vaak EAN-codes nodig hebben, bijvoorbeeld bij elke nieuwe klant, aanvraag of installatie, of die codes in meerdere systemen gebruiken. Zoekt u af en toe een code op, dan volstaat de website van het EAN-codeboek.
EAN-codes opzoeken vanuit uw eigen systemen?
Vertel ons waar u EAN-codes nu opzoekt en in welk systeem ze terechtkomen. We laten zien hoe een koppeling met het EAN-codeboek dat overneemt.