EML_NL-koppeling laten maken
EML_NL is de Nederlandse standaard van de Kiesraad voor kandidaat- en uitslaggegevens bij verkiezingen. Hij is gebaseerd op de Election Markup Language van OASIS, aangepast aan het Nederlandse kiesrecht, en staat voor overheden op de 'pas toe of leg uit'-lijst. De Kiesraad publiceert de bestanden na verkiezingen ook als open data. Appfront bouwt koppelingen die EML_NL-bestanden lezen, controleren en verwerken, bijvoorbeeld voor uitslagen op een website, een dashboard of een eigen analyse.
Wat is een EML_NL-koppeling?
Een EML_NL-koppeling maakt de kandidaat- en uitslaggegevens van Nederlandse verkiezingen bruikbaar in uw eigen systemen. EML_NL is volgens Forum Standaardisatie een Nederlands toepassingsprofiel op de Election Markup Language. De Kiesraad beheert het en publiceert de schemadefinities op code.overheid.nl: een aangepaste versie van EML 5.0 van OASIS, aangepast, uitgebreid en beperkt voor het Nederlandse kiesrecht. Per soort bericht zijn er aparte beperkingen, aangeduid met een nummer zoals 110, 110a of 210, en daarnaast eigen versies van de standaarden voor namen en adressen.
Forum Standaardisatie heeft EML_NL op 28 november 2013 op de 'pas toe of leg uit'-lijst gezet, voor de definitie en uitwisseling van kandidaatgegevens en uitslaggegevens bij verkiezingen onder de Kieswet. Het gaat om gegevens die tussen politieke partijen, gemeentelijke stembureaus, hoofdstembureaus en het centraal stembureau worden uitgewisseld om stemmen op te tellen en de uitslag vast te stellen. Op de lijst staat versie 1.0. Het Forum heeft de Kiesraad gevraagd in de documentatie te vermelden dat de standaard niet geschikt is om het papieren proces voor de wettelijke vaststelling van de uitslag te vervangen. Een koppeling werkt dus met de digitale gegevens naast dat proces.
Na verkiezingen publiceert de Kiesraad de EML-bestanden ook als open data, bijvoorbeeld voor de gemeenteraadsverkiezingen van 2026: verkiezingsdefinities, kandidatenlijsten en telling- en resultaatbestanden, gedeeld door de gemeenten als centraal stembureau, met een open licentie. De Kiesraad vermeldt daarbij dat hij geen ondersteuning biedt voor het gebruik van het formaat. Wij bouwen maatwerk omdat het lezen van die bestanden kennis van de schema's vraagt, en omdat elke verkiezing andere kieskringen, lijsten en kandidaten heeft. De koppeling valideert elk bestand tegen de XSD's van de release die u gebruikt, legt de relaties tussen lijsten, kandidaten en tellingen vast en levert de gegevens in de vorm die uw website of analyse verwacht.
Leesbaar
Uitslagen uit EML_NL ontsloten.
Gecontroleerd
Elk bestand tegen het schema.
Herbruikbaar
Elke verkiezing dezelfde koppeling.
Hoe wij uw EML_NL-koppeling bouwen
We beginnen bij uw doel: welke verkiezingen en gegevens u nodig hebt, of u eigen bestanden verwerkt of de open data van de Kiesraad, en waar de gegevens terecht moeten komen. Daarna kiezen we samen de release van de schema's waartegen we valideren en bouwen we het inlezen van één verkiezing, met kandidatenlijsten en uitslagen. U controleert de uitkomst tegen de officieel vastgestelde uitslag. Daarna volgen andere verkiezingen en de weergave of export die u nodig hebt. Als de Kiesraad een nieuwe release van de schema's publiceert, werken we de koppeling bij.
Verkiezingen, bronnen, afnemers.
Lijsten en uitslagen ingelezen.
Vergeleken met de vastgestelde uitslag.
Livegang, bewaking, en beheer bij nieuwe releases.
Wat een EML_NL-koppeling concreet doet
De onderdelen hieronder komen in vrijwel elke EML_NL-koppeling terug. Welke u nodig hebt, hangt af van uw rol en van wat u met de gegevens wilt doen.
Inlezen
Bestanden per bericht-ID.
Validatie
Tegen de XSD's van de Kiesraad.
Kandidaten
Lijsten en volgorde eenduidig.
Uitslagen
Tellingen per niveau.
Export
Naar website, dashboard of CSV.
Logboek
Elke verwerking terug te vinden.
Voor wie wij een EML_NL-koppeling bouwen
De koppeling is bedoeld voor organisaties die verkiezingsgegevens structureel willen gebruiken, en niet bij elke verkiezing opnieuw bestanden met de hand willen omzetten.
Gemeenten
Uitslagen op uw eigen site.
Partijen
Kandidaten en uitslagen.
Media en onderzoek
Open data geanalyseerd.
Softwarebouwers
EML_NL in uw pakket.
Technologie en koppelingen
Deze pagina gaat over koppelingen met gegevens in EML_NL van Nederlandse verkiezingen onder de Kieswet. Zoekt u software om stemmingen binnen een vereniging, ondernemingsraad of organisatie te houden, kijk dan naar verkiezingssoftware laten maken. Voor koppelingen met de burgerzakensoftware van een gemeente is er onze pagina over de iBurgerzaken-koppeling, en voor bredere toepassingen onze pagina over software voor gemeenten. Onze werkwijze leest u op software laten maken.
Waarom Appfront voor uw EML_NL-koppeling?
Uitslagen die per verkiezing met de hand uit XML worden overgenomen, een kandidaat die bij het omzetten op de verkeerde lijst belandt, of een bestand dat stil niet wordt ingelezen omdat het schema afwijkt, ondermijnt het vertrouwen in de cijfers. Daar bouwen we op: validatie tegen de officiële schema's, controle tegen de vastgestelde uitslag en een logboek per bestand.
Volgens het schema
Validatie tegen de XSD's.
Gecontroleerd
Naast de vastgestelde uitslag.
Herbruikbaar
Voor elke volgende verkiezing.
Security en privacy bij een EML_NL-koppeling
Kandidatenlijsten bevatten persoonsgegevens, zoals namen en woonplaatsen van kandidaten. Ook als ze openbaar zijn gemaakt, geldt de AVG voor wat u ermee doet. De koppeling verwerkt alleen de gegevens die voor uw doel nodig zijn en legt elke verwerking met tijd en resultaat vast. Voor uitslagen die nog niet officieel zijn vastgesteld, maken we vooraf afspraken over wie ze mag zien en wanneer ze worden getoond.
De koppeling draait in een Europees datacenter, met versleutelde verbindingen en opslag. Toegang tot niet-openbare bestanden is per rol geregeld, en sleutels en wachtwoorden zijn niet zichtbaar voor medewerkers. De koppeling vervangt geen onderdeel van het wettelijke proces voor de vaststelling van de uitslag.
Veelgestelde vragen over een EML_NL-koppeling
Vragen die gemeenten, partijen, onderzoekers en softwareleveranciers stellen voordat ze hiermee beginnen.
EML_NL is de Nederlandse toepassing van de Election Markup Language voor kandidaat- en uitslaggegevens bij verkiezingen. Het is gebaseerd op EML 5.0 van OASIS en aangepast aan het Nederlandse kiesrecht. De Kiesraad beheert de standaard.
Voor overheden en de (semi-)publieke sector staat EML_NL sinds 28 november 2013 op de 'pas toe of leg uit'-lijst van Forum Standaardisatie, voor de definitie en uitwisseling van kandidaat- en uitslaggegevens bij verkiezingen onder de Kieswet.
De Kiesraad publiceert de XSD's van EML_NL op code.overheid.nl. Volgens de Kiesraad kan de hoofdtak wijzigingen bevatten die pas in een volgende versie gelden; gebruik daarom de laatste release. Daartegen valideren we de bestanden.
Ja. De Kiesraad publiceert na verkiezingen EML-bestanden met verkiezingsdefinities, kandidatenlijsten en telling- en resultaatbestanden als open data, vaak ook als CSV. De Kiesraad biedt geen ondersteuning bij het gebruik van het formaat, en daar helpt een koppeling bij.
Nee. Forum Standaardisatie heeft de Kiesraad gevraagd te vermelden dat EML_NL niet geschikt is om het papieren proces voor de wettelijke vaststelling van de uitslag te vervangen. Een koppeling werkt met de digitale gegevens naast dat proces.
Verkiezingssoftware is bedoeld om zelf stemmingen te houden, bijvoorbeeld in een vereniging of ondernemingsraad. Een EML_NL-koppeling verwerkt de gegevens van verkiezingen onder de Kieswet, zoals kandidatenlijsten en uitslagen.
Voor organisaties die bij elke verkiezing uitslagen of kandidaten willen tonen, analyseren of doorgeven, of die EML_NL in een eigen pakket willen ondersteunen. Hebt u eenmalig een overzicht nodig, dan volstaat vaak de CSV die de Kiesraad bij de open data levert.
Verkiezingsgegevens uit EML_NL gebruiken?
Vertel ons welke verkiezingen en gegevens u nodig hebt en waar ze terecht moeten komen. We laten zien hoe een koppeling dat bij elke verkiezing regelt.