Hoofdinhoud

Digilevering is een dienst van Logius binnen het Stelsel van Basisregistraties. Met Digilevering ontvangen organisaties automatisch berichten wanneer gegevens in een basisregistratie wijzigen. 

Organisaties gebruiken gegevens uit basisregistraties, zoals de BRP, BAG en het Handelsregister, bij het uitvoeren van hun wettelijke taken. Het is daarom belangrijk dat zij beschikken over actuele informatie. Met Digilevering hoeft een organisatie niet steeds zelf te controleren of gegevens zijn gewijzigd. Wanneer er een wijziging plaatsvindt, ontvangt de organisatie automatisch een bericht met de nieuwe gegevens. Bijvoorbeeld wanneer iemand verhuist, een adres wordt gewijzigd of gegevens van een bedrijf veranderd. Zo beschikken organisaties snel over actuele informatie en kunnen zij hun werk efficiënter uitvoeren.

Digilevering aanvragen en in gebruik nemen

Voordat uw organisatie Digilevering kan gebruiken, moet deze worden aangesloten op de dienst. Tijdens het aansluitproces worden zowel de technische verbinding als de toegang voor gebruikers ingericht.
In dit hoofdstuk leest u welke voorbereidingen nodig zijn, wat Logius voor u regelt en hoe u toegang krijgt tot Digilevering.

Digilevering aanvragen

Om Digilevering aan te vragen, vult u het aanvraagformulier in. Na ontvangst van de aanvraag neemt Logius contact op met uw organisatie en begeleidt een aansluitcoördinator het aansluitproces.
Tijdens dit proces worden afspraken gemaakt over de aansluiting en de inrichting van de benodigde voorzieningen.

Wat heeft uw organisatie nodig?

Voordat Digilevering in gebruik kan worden genomen, moet uw organisatie beschikken over een aantal voorzieningen.

Organisatie-identificatienummer  (OIN)

Uw organisatie moet beschikken over een geldig Organisatie-identificatienummer (OIN). Het OIN wordt gebruikt om organisaties binnen de digitale overheid uniek te identificeren. Heeft uw organisatie nog geen OIN? Klik dan de volgende link: meer informatie OIN, voor meer informatie over een OIN en hoe deze kan worden aangevraagd. 

eHerkenning

Voor toegang tot Digilevering wordt gebruikgemaakt van eHerkenning. Zorg ervoor dat de medewerkers die Digilevering gaan gebruiken beschikken over een eHerkenningsmiddel met het vereiste betrouwbaarheidsniveau.

Technische koppeling

Om berichten te kunnen ontvangen en verzenden, moet een technische koppeling worden ingericht op basis van Digikoppeling. Deze koppeling kan door uw eigen organisatie of door een ICT-leverancier worden gerealiseerd.

Netwerkverbinding

Uw organisatie moet beschikken over een verbinding via Diginetwerk of internet, afhankelijk van de gekozen inrichting.

PKIoverheid-certificaten

Voor sommige onderdelen van Digilevering kunnen PKIoverheid-certificaten nodig zijn. Wanneer gebruik wordt gemaakt van de klassieke inlogmethode zijn deze certificaten verplicht.
De certificaten worden aangevraagd bij een Certificate Service Provider (CSP). In het certificaat moet het OIN van uw organisatie zijn opgenomen.

Wat regelt Logius?

Tijdens het aansluitproces zorgt Logius voor:

  • registratie van uw organisatie in Digilevering;
  • het aanmaken van een aansluiting;
  • toegang tot de preproductie- en productieomgeving;
  • het aanmaken van een hoofdgebruiker;
  • het verstrekken van de URL van de Digilevering-gebruikersinterface.

De hoofdgebruiker beheert de gebruikers binnen de organisatie en kan aanvullende gebruikersaccounts aanmaken.

Toegang tot Digilevering

Digilevering is alleen toegankelijk voor geregistreerde gebruikers. Afhankelijk van uw situatie zijn er drie manieren om in te loggen.

Inloggen met eHerkenning

eHerkenning is de standaardmethode voor organisaties om toegang te krijgen tot Digilevering.
Met eHerkenning kunnen medewerkers veilig inloggen met hun eigen account. Hiervoor moet de organisatie geregistreerd zijn in Digilevering en moet het KvK-nummer bekend zijn binnen het systeem.

Let op: Gebruikt u eHerkenning niveau 4 met een certificaat? Dan kan uw browser vragen om een certificaat te selecteren zodra u Digilevering opent. Annuleer deze melding. U kiest het certificaat pas tijdens het inloggen via het eHerkenningsportaal.

Inloggen via Keycloak

Deze inlogmethode is uitsluitend bedoeld voor medewerkers van Logius.

Klassiek inloggen met PKIoverheid-certificaat

Naast eHerkenning is tijdelijk nog een klassieke inlogmethode beschikbaar. Hierbij logt u in met een gebruikersnaam, wachtwoord en een PKIoverheid-clientcertificaat.

Let op: Deze methode wordt op termijn uitgefaseerd.

Om van deze methode gebruik te maken moet:

  • een geldig PKIoverheid-certificaat beschikbaar zijn;
  • het certificaat het OIN van uw organisatie bevatten;
  • het certificaat zijn geïnstalleerd in de browser van de gebruiker.

Het installeren van certificaten wordt meestal uitgevoerd door de systeembeheerder van uw organisatie.

Eerste keer inloggen

Na de aansluiting ontvangt de hoofdgebruiker een gebruikersnaam van Logius.

Bij de eerste keer inloggen stelt de hoofdgebruiker een wachtwoord in. Daarna kan de hoofdgebruiker aanvullende gebruikers aanmaken en beheren.

Meer informatie hierover vindt u in het hoofdstuk Gebruikers.

Wachtwoord opnieuw instellen

Bent u uw wachtwoord vergeten of is uw account vergrendeld? Kies dan op het inlogscherm voor Wachtwoord (opnieuw) instellen.

Na het invoeren van uw gebruikersnaam ontvangt u een e-mail met instructies om een nieuw wachtwoord aan te maken.

Vergrendeld account

Om de beveiliging van Digilevering te waarborgen, wordt een account tijdelijk vergrendeld wanneer:

  • drie keer achter elkaar een onjuist wachtwoord wordt ingevoerd; of
  • de geldigheidsduur van het wachtwoord is verstreken.

Via de optie Wachtwoord (opnieuw) instellen kunt u weer toegang krijgen tot uw account.

Na de aansluiting

Na afronding van het aansluitproces kan uw organisatie abonnementen afsluiten met de basisregistraties waarvan u gegevens wilt ontvangen.
Zodra een abonnement actief is en de technische koppeling operationeel is, worden berichten automatisch via Digilevering uitgewisseld.

 

Gebruikers

Binnen Digilevering hebben gebruikers alleen toegang tot functies waarvoor zij rechten hebben gekregen. De hoofdgebruiker is verantwoordelijk voor het beheren van gebruikers binnen de organisatie. Ook gebruikers met het recht Gebruikersbeheer kunnen gebruikers toevoegen, wijzigen en verwijderen.

Gebruiker toevoegen

Voordat u begint

U bent ingelogd als hoofdgebruiker of beschikt over het recht Gebruikersbeheer.

Houd de volgende gegevens van de gebruiker bij de hand:

  • Naam;
  • gebruikersnaam;
  • e-mailadres.

Stappen

  1. Open Gebruikersbeheer.
  2. Klik op Gebruiker toevoegen.
  3. Vul de gegevens van de gebruiker in.
  4. Klik op Opslaan.

Het e-mailadres is verplicht. Dit adres wordt gebruikt voor het instellen en opnieuw instellen van wachtwoorden en voor het sturen van een activatiemail als een gebruiker voor de 1e keer aanlogt met eHerkenning.

Eerste keer aanloggen met eHerkenning

Als een nieuwe gebruiker voor de 1e keer aanlogt met eHerkenning wordt de organisatie gecontroleerd aan de hand van het kvk nummer van het eHerkenning account. Indien de organisatie bekend is in Digilevering wordt het eherkenning account in Digilevering gekoppeld aan de gebruiker via het emailadres. Vervolgens wordt er een activatiemail verstuurd. Hierin staat een activatielink waarmee de gebruiker zijn account kan activeren,

Rechten toekennen

Met rechten bepaalt u welke functies een gebruiker mag uitvoeren.

Veelgebruikte rollen

Gebruikersbeheer Gebruikers toevoegen, wijzigen en verwijderen AFN, HLV, Logius
Abonnementenbeheer Abonnementen aanmaken en beheren AFN, HLV, Logius
Accorderen namens AFN Abonnementen accorderen namens een afnemer AFN
Accorderen namens HLV Abonnementen accorderen namens een HLV HLV
Rapporteren Rapportages bekijken en maken HLV, Logius
Aansluitingenbeheer Aanmaken en beheren van aansluitingen Logius
Catalogibeheer Importeren en beheren van catalogi Logius
Applicatiebeheer Gebeurtenissoortdef Toegang tot Statuspagina Beheren van gebeurtenissoorten Applicatiebeheer HLV
Beheer Enkelzijdig beëindigen Abonnementenbeheer Door HLV beëindigen abonnement van een AFN HLV
Afnemers rapportages Rapportages inzien van eigen abonnementen afnemer AFN

 

Rechten toekennen

  1. Open Gebruikersbeheer.
  2. Open de gegevens van de gebruiker.
  3. Klik op Rechten beheren.
  4. Selecteer het gewenste recht.
  5. Klik op Opslaan.

U kunt meerdere rollen aan dezelfde gebruiker toekennen.

Rechten intrekken

Het intrekken van een recht werkt op dezelfde manier als het toekennen van een recht. Open de gebruiker, volg dezelfde stappen als bij Rechten toekennen, deselecteer het recht dat u wilt intrekken en klik op Opslaan.

Gebruikersgegevens wijzigen

Gebruikers kunnen hun eigen gegevens bekijken, maar niet zelf wijzigen.

Alleen de hoofdgebruiker of een gebruiker met de rol Gebruikersbeheer kan gegevens aanpassen.

Stappen

  1. Open Gebruikersbeheer.
  2. Zoek de gebruiker.
  3. Open de gebruikersgegevens.
  4. Klik op Wijzigen.
  5. Pas de naam en/of het e-mailadres aan.
  6. Klik op Opslaan.

Gebruiker verwijderen

Voordat u begint

Controleer of u de juiste gebruiker hebt geselecteerd. Een verwijderde gebruiker kan niet worden hersteld.

Stappen

  1. Open Gebruikersbeheer.
  2. Zoek de gebruiker.
  3. Open de gebruikersgegevens.
  4. Klik op Verwijderen.
  5. Bevestig de verwijdering.

Hoofdgebruiker of contactpersoon wijzigen of toevoegen

De hoofdgebruiker en contactpersonen van een organisatie kunnen alleen door Logius worden gewijzigd of toegevoegd.

Wilt u een hoofdgebruiker of contactpersoon wijzigen of toevoegen? Neem dan contact op met uw contactpersoon bij Logius. Logius verwerkt de wijziging en past de gegevens aan in Digilevering.

Houd bij uw aanvraag de gegevens van de nieuwe hoofdgebruiker of contactpersoon bij de hand.

Catalogus

Voordat een organisatie een abonnement kan aanmaken, moet duidelijk zijn welke gebeurtenissen en gegevens beschikbaar zijn. Deze informatie is vastgelegd in de catalogus van een basisregistratie.

In dit hoofdstuk leest u wat een catalogus is, hoe deze wordt opgebouwd en welke rol Logius, de HLV en de AFN daarbij hebben.

Wat is een catalogus?

Een catalogus is een overzicht van de gebeurtenissen die een basisregistratie via Digilevering beschikbaar stelt. Per gebeurtenis is vastgelegd welke gegevens beschikbaar zijn en welke filters kunnen worden toegepast.

Organisaties gebruiken de catalogus om te bepalen op welke gebeurtenissen zij zich willen abonneren. Alleen gebeurtenissen die in de catalogus zijn opgenomen, kunnen onderdeel zijn van een abonnement.

U gebruikt de catalogus om:

  • te bekijken welke gebeurtenissen beschikbaar zijn;
  • te controleren welke gegevens bij een gebeurtenis worden geleverd;
  • te bepalen op welke gebeurtenissen u een abonnement wilt aanmaken of wijzigen.

Hoe is een catalogus opgebouwd?

Een catalogus bestaat uit verschillende onderdelen die samen bepalen welke gegevens via Digilevering beschikbaar zijn. Deze onderdelen bepalen samen welke berichten een afnemer kan ontvangen via Digilevering.

  • Basisregistratie – De bron van de gegevens, bijvoorbeeld de BRP, BAG of het Handelsregister.
  • Gebeurtenissen – Wijzigingen of gebeurtenissen waarover een bericht kan worden verstuurd, zoals een geboorte, overlijden of de vestiging van een bedrijf.
  • Gegevens – De informatie die bij een gebeurtenis wordt geleverd.
  • Gebeurtenis definities – Voorgedefinieerde velden uit de gebeurtenis waarop een afnemer zich kan op abonneren.

Rollen en verantwoordelijkheden

Bij het beheren van een catalogus zijn verschillende partijen betrokken.

Logius (Serviceorganisatie) Maakt de catalogus aan stelt deze beschikbaar in Digilevering.
HLV (Houder Landelijke Voorziening) Vult de catalogus met gebeurtenissen en gebeurtenisdefinities.
AFN (Afnemer) Gebruikt de catalogus om abonnementen op gebeurtenissen aan te maken. De AFN kan de catalogus bekijken, maar niet wijzigen.

Hoe komt een catalogus tot stand?

Een catalogus wordt in verschillende stappen opgebouwd.

  1. De HLV bepaalt welke gebeurtenissen beschikbaar zijn.
  2. De HLV legt vast welke gegevens bij iedere gebeurtenis horen.
  3. AFN's kunnen de catalogus gebruiken om abonnementen aan te maken.

Wanneer een basisregistratie nieuwe gebeurtenissen toevoegt of bestaande gebeurtenissen wijzigt, wordt de catalogus bijgewerkt.

Publiceren en versiebeheer

Een catalogus wordt opgesteld door de HLV en beschikbaar gemaakt in Digilevering. Zodra de catalogus is gepubliceerd, kunnen afnemers deze gebruiken bij het aanmaken van abonnementen.

Elke catalogus heeft een versienummer. Wanneer de HLV wijzigingen doorvoert, bijvoorbeeld door nieuwe gebeurtenissen of gegevens toe te voegen, wordt een nieuwe versie van de catalogus gemaakt. Vanaf dat moment werken afnemers met de meest recente versie van de catalogus.

Catalogus bekijken

Voordat u een abonnement aanmaakt, kunt u de catalogus raadplegen om te zien welke gebeurtenissen beschikbaar zijn.

Stappen

  1. Open het menu Aansluitbeheer en daarna Catalogibeheer.
  2. Kies de gewenste basisregistratie.
  3. Bekijk de beschikbare gebeurtenissen.
  4. Open een gebeurtenis en bekijk de beschikbare gegevens en gebeurtenissoortdefinities.

 

Resultaat

U ziet welke gebeurtenissen beschikbaar zijn en welke gegevens daarbij worden geleverd.

Catalogus beheren

De catalogus in Digilevering wordt aangemaakt door Logius. De inhoud van de catalogus wordt beheerd door de HLV.

 

Abonnementen

Met een abonnement ontvangt uw organisatie automatisch berichten over gebeurtenissen uit een basisregistratie. Een abonnement wordt altijd gebaseerd op een catalogus. In dit hoofdstuk leest u hoe u een abonnement aanmaakt, beheert en accordeert.

Wat is een abonnement?

Digilevering kan berichten versturen over verschillende gebeurtenissen uit een basisregistratie. Met een abonnement bepaalt uw organisatie welke van deze berichten zij wil ontvangen.

Een organisatie heeft meestal niet alle gegevens uit een basisregistratie nodig. Daarom kiest zij alleen de gebeurtenissen die relevant zijn voor haar werkzaamheden. Bijvoorbeeld een adreswijziging, een verhuizing of een wijziging in de gegevens van een bedrijf.

Een abonnement wordt altijd gebaseerd op een catalogus. De catalogus laat zien welke gebeurtenissen beschikbaar zijn. Bij het aanmaken van een abonnement kiest u de gewenste gebeurtenissen. U kunt daarnaast filters instellen om alleen de berichten te ontvangen die voor uw organisatie van belang zijn.

Nadat een abonnement is aangemaakt en geaccordeerd, ontvangt de organisatie automatisch berichten wanneer een geselecteerde gebeurtenis plaatsvindt.

Hoe werkt een abonnement?

Het aanmaken van een abonnement bestaat uit vijf stappen:

  1. Abonnement aanmaken
  2. Gebeurtenissen selecteren 
  3. Filters instellen
  4. Aanbieden voor akkoord
  5. Accorderen

Welke stappen u kunt uitvoeren, hangt af van uw rol en de afspraken tussen de AFN en de HLV. In de volgende paragrafen worden deze stappen toegelicht.

Voordat u begint

Voor het aanmaken en beheren van abonnementen heeft u de rol Abonnementenbeheer nodig.

Afhankelijk van uw rol binnen uw organisatie (AFN of HLV) zijn niet alle functies beschikbaar. Hierdoor kan het zijn dat u bepaalde stappen niet kunt uitvoeren.

Stap 1. Abonnement aanmaken

Voordat uw organisatie berichten via Digilevering kan ontvangen, maakt u een abonnement aan. In deze stap legt u vast voor welke basisregistratie, afnemer en OIN-aansluiting het abonnement geldt. Daarna vult u de basisgegevens van het abonnement in.

Voordat u begint

Controleer voordat u een abonnement aanmaakt of:

  • u de rol Abonnementenbeheer heeft;
  • de juiste catalogus beschikbaar is;
  • de afnemer beschikt over een OIN-aansluiting.
Stappen
  1. Maak een nieuw abonnement aan.
  2. Selecteer de basisregistratie, afnemer en OIN-aansluiting.
  3. Vul de abonnementsgegevens in.
  4. Sla het abonnement op.

Het abonnement is aangemaakt en kan verder worden ingericht door gebeurtenissen en filters toe te voegen.

Aandachtspunten
  • Alleen afnemers met een OIN-aansluiting kunnen worden geselecteerd.
  • Een abonnement is altijd gekoppeld aan één basisregistratie.
  • Geldig van bepaalt vanaf welke datum het abonnement berichten kan ontvangen.
  • Laat Geldig tot leeg als het abonnement voor onbepaalde tijd geldig is.

Stap 2. Gebeurtenissoorten toevoegen

Nadat u een abonnement heeft aangemaakt, voegt u de gebeurtenissoorten toe waarvoor uw organisatie berichten wil ontvangen. De beschikbare gebeurtenissoorten zijn afkomstig uit de catalogus van de gekozen basisregistratie.

Voordat u begint

Controleer voordat u gebeurtenissoorten toevoegt of:

  • het abonnement is aangemaakt;
  • de gewenste gebeurtenissoorten beschikbaar zijn in de catalogus.
Stappen
  1. Open het abonnement.
  2. Selecteer de gewenste gebeurtenissoorten.
  3. Voeg de selectie toe aan het abonnement.

De geselecteerde gebeurtenissoorten zijn toegevoegd aan het abonnement.

Aandachtspunten
  • U kunt alleen gebeurtenissoorten toevoegen die beschikbaar zijn in de catalogus van de gekozen basisregistratie.
  • Een abonnement kan meerdere gebeurtenissoorten bevatten.
  • Per gebeurtenissoort ziet u onder andere de versie en de geldigheidsperiode. Gebruik deze informatie om de juiste gebeurtenissoorten te selecteren.
  • In de volgende stap kunt u filters instellen voor de geselecteerde gebeurtenissoorten.

Stap 3. Filters instellen

Nadat u de gebeurtenissoorten heeft toegevoegd, kunt u filters instellen. Met filters bepaalt u welke berichten uw organisatie ontvangt. Zo ontvangt u alleen de berichten die voor uw organisatie relevant zijn.

Wat zijn filters?

Een filter is een voorwaarde waaraan een bericht moet voldoen voordat het wordt verzonden. U kunt bijvoorbeeld aangeven dat u alleen berichten wilt ontvangen voor een bepaalde gemeente, een specifieke categorie of een bepaald type gebeurtenis.

Welke filters beschikbaar zijn, hangt af van de gebeurtenissoort en de catalogus.

Soorten filters

Digilevering ondersteunt verschillende soorten filters. De twee meest voorkomende zijn:

Enkelvoudig filters

Met enkelvoudig filters stelt u één of meerdere voorwaardes in.

Voorbeeld: ontvang alleen berichten voor bepaalde postcodes

Samengesteld filter

Met een samengesteld filter kunnen de filters met meer logica worden opgesteld. Het is bijvoorbeeld mogelijk om een filter met 'and' en 'or' operators te maken.

Voorbeeld: ontvang alleen berichten voor gemeente X én voor een bepaalde categorie.

Stappen
  1. Open de gewenste gebeurtenissoort binnen het abonnement.
  2. Voeg één of meer filters toe.
  3. Stel de gewenste waarden in.
  4. Sla de wijzigingen op.

De filters zijn ingesteld. Uw organisatie ontvangt alleen berichten die voldoen aan de opgegeven voorwaarden.

Aandachtspunten
  • Niet iedere gebeurtenissoort ondersteunt dezelfde filters.
  • De beschikbare filters worden bepaald door de catalogus.
  • Controleer of de ingestelde filters aansluiten bij de informatie die uw organisatie wil ontvangen.
  • Hoe specifieker de filters, hoe gerichter de berichten die u ontvangt.

Meer informatie over de beschikbare filtertypen, operatoren en reeksverzamelingen vindt u in hoofdstuk 6, Filtering.

Stap 4. Aanbieden voor akkoord

Nadat u het abonnement heeft ingericht, kunt u het aanbieden voor akkoord. Hiermee geeft u aan dat het abonnement compleet is en gereed is om door de betrokken partij(en) te worden beoordeeld.

Na het aanbieden voor akkoord kan het abonnement niet meer worden gewijzigd. Wilt u toch wijzigingen aanbrengen, dan moet het abonnement eerst opnieuw in bewerking worden genomen.

Voordat u begint

Controleer of:

  • alle gewenste gebeurtenissoorten zijn toegevoegd;
  • de filters correct zijn ingesteld;
  • de abonnementsgegevens volledig en juist zijn.
Stappen
  1. Open het abonnement.
  2. Kies Aanbieden voor akkoord.
  3. Bevestig dat u het abonnement wilt aanbieden.

Het abonnement heeft de status 'Voor akkoord' en is gereed om door de betrokken partij(en) te worden geaccordeerd.

Aandachtspunten
  • Controleer het abonnement zorgvuldig voordat u het aanbiedt.
  • Na het aanbieden voor akkoord kunt u het abonnement niet meer wijzigen.
  • Als het abonnement moet worden aangepast, moet het eerst opnieuw in bewerking worden genomen.

Stap 5. Abonnement accorderen

Voordat een abonnement gebruikt kan worden, moet het worden geaccordeerd. Zowel de afnemer (AFN) als de houder van de basisregistratie (HLV) moeten akkoord geven, tenzij hierover mandaatafspraken zijn gemaakt. Pas nadat beide partijen akkoord hebben gegeven, wordt het abonnement actief en kunnen berichten worden geleverd.

Voordat u begint
  • Controleer of:
  • het abonnement de status 'Voor akkoord' heeft;
  • u bevoegd bent om namens uw organisatie abonnementen te accorderen.
Stappen
  1. Open het overzicht met abonnementen die wachten op accordering.
  2. Open het abonnement dat u wilt beoordelen.
  3. Controleer de abonnementsgegevens, gebeurtenissoorten en filters.
  4. Kies 'Akkoord' of 'Niet akkoord'.
  5. Bevestig uw keuze.

Het abonnement is geaccordeerd. Zodra beide partijen akkoord hebben gegeven, wordt het abonnement actief en worden berichten geleverd volgens de ingestelde gebeurtenissoorten en filters.

Aandachtspunten
  • Een abonnement wordt pas actief nadat beide partijen akkoord hebben gegeven.
  • Geeft één van de partijen Niet akkoord, dan krijgt het abonnement weer de status 'In bewerking'. De benodigde wijzigingen kunnen vervolgens worden aangebracht en het abonnement kan opnieuw voor akkoord worden aangeboden.

Abonnement beheren

Nadat een abonnement is aangemaakt, kunt u het wijzigen, kopiëren, verwijderen of beëindigen. Welke acties beschikbaar zijn, hangt af van de status van het abonnement en uw autorisaties.

Abonnement wijzigen

U kunt een abonnement wijzigen als het de status In bewerking heeft.

Heeft het abonnement de status 'Akkoord'? Neem het dan eerst opnieuw in bewerking. Digilevering maakt hiervoor een nieuwe versie van het abonnement. De bestaande versie blijft actief totdat de nieuwe versie is geaccordeerd.

U kunt onder andere de abonnementsgegevens, gebeurtenissoorten en filters aanpassen. Voor het beheren van gebeurtenissoorten en filters, zie Gebeurtenissoorten beheren en Filters beheren.

  1. Open het abonnement.
  2. Wijzig de gewenste gegevens.
  3. Sla de wijzigingen op.

U kunt gebeurtenissoorten en filters toevoegen, wijzigen of verwijderen. Met Beheer filters kunt u de waarde van een filter tegelijk wijzigen voor meerdere gebeurtenissoorten waarin hetzelfde filter voorkomt.

Zie hiervoor ook stap 2 en 3.

Let op:

  • De ingangsdatum van een abonnement moet op of na de huidige datum liggen. Past u een abonnement aan waarvan de ingangsdatum in het verleden ligt, dan moet u deze mogelijk ook wijzigen.
  • Het opnieuw in bewerking nemen kan gevolgen hebben voor het akkoordproces. Na uw wijzigingen moet het abonnement mogelijk opnieuw voor akkoord worden aangeboden.
  • Geef de nieuwe abonnementsversie een unieke waarde.
  • De ingangsdatum van de nieuwe versie moet in de toekomst liggen.

Abonnement kopiëren

U kunt een bestaand abonnement kopiëren om snel een nieuw abonnement aan te maken met vergelijkbare instellingen.

  1. Open het abonnement dat u wilt kopiëren.
  2. Kies Kopiëren.
  3. Pas de abonnementsgegevens waar nodig aan.
  4. Sla het nieuwe abonnement op.

Let op:

  • Geef het nieuwe abonnement een unieke versie.
  • De ingangsdatum moet in de toekomst liggen.
  • Controleer na het kopiëren de abonnementsgegevens, gebeurtenissoorten en filters.
  • Bij het kopiëren van een abonnement worden de namen van reeksverzamelingen overgenomen, maar niet de bijbehorende reeksen. Deze moet u opnieuw invoeren. Zie paragraaf 6.2.3, Reeksverzamelingen.

Abonnement verwijderen

U kunt een abonnement verwijderen als het niet langer nodig is. Welke abonnementen kunnen worden verwijderd, hangt af van de status van het abonnement en uw autorisaties.

  1. Open het abonnement dat u wilt verwijderen.
  2. Kies Verwijderen.
  3. Bevestig dat u het abonnement wilt verwijderen.

Het abonnement is verwijderd en wordt niet langer weergegeven in het overzicht van abonnementen.

Let op:

  • Controleer of het abonnement niet meer nodig is voordat u het verwijdert.
  • Een verwijderd abonnement kan niet meer worden gebruikt voor de levering van berichten.
  • Is het abonnement nog actief? Beëindig het abonnement eerst voordat u het verwijdert, als de applicatie dit vereist.

Abonnement eenzijdig beëindigen (HLV)

Als HLV kunt u een abonnement beëindigen zonder akkoord van de AFN. Hiervoor heeft u de rol Beheer Enkelzijdig beëindigen Abonnementenbeheer nodig.

Bij de beëindiging wordt een nieuwe versie van het abonnement aangemaakt. Deze versie doorloopt eerst het akkoordproces. Als akkoord van de AFN uitblijft, kan de HLV de beëindiging eenzijdig afronden.

Als houder van de basisregistratie (HLV) kunt u een abonnement eenzijdig beëindigen. Dit kan bijvoorbeeld nodig zijn wanneer een abonnement niet langer mag worden gebruikt of niet meer voldoet aan de gemaakte afspraken.

  1. Open het abonnement dat u wilt beëindigen.
  2. Kies Eenzijdig beëindigen.
  3. Bevestig de beëindiging.

Het abonnement is beëindigd en wordt niet langer gebruikt voor de levering van berichten.

Let op: Alleen gebruikers met de juiste autorisatie kunnen een abonnement eenzijdig beëindigen. Na beëindiging worden voor dit abonnement geen berichten meer geleverd. Informeer de afnemer vooraf als hierover afspraken zijn gemaakt.

 

Rapportages

Met rapportages krijgt u inzicht in de gegevens binnen Digilevering. U kunt rapportages gebruiken om informatie over bijvoorbeeld abonnementen of berichtenverkeer op te vragen. Welke rapportages beschikbaar zijn, hangt af van uw rol en autorisaties. Rapportages kunnen worden geëxporteerd voor verder gebruik of archivering.

Beschikbare rapportages

In onderstaande tabel staat welke rapportages beschikbaar zijn en waarvoor u deze kunt gebruiken.

Berichtenaantallen – Verstrekkingen aan Digilevering HLV,AFN* Geeft inzicht in het aantal berichten dat Digilevering van de HLV heeft ontvangen.
Berichtenaantallen – Verstrekkingen door Digilevering HLV,AFN* Geeft inzicht in het aantal berichten dat Digilevering naar afnemers heeft doorgestuurd.
Verstrekkingen aan Digilevering HLV Geeft inzicht in de gebeurtenisberichten die door de HLV aan Digilevering zijn verstrekt.
Verstrekkingen door Digilevering HLV Geeft inzicht in de gebeurtenisberichten die Digilevering aan afnemers heeft doorgestuurd.

(*) Afnemers met de rol AFNEMERRAPPORTAGE hebben beperkt toegang tot deze rapportages

Rapportage uitvoeren

Met een rapportage kunt u gegevens opvragen over het berichtenverkeer. De beschikbare zoek- en filtermogelijkheden verschillen per rapportage.

Stappen
  1. Open Rapportages.
  2. Kies de gewenste rapportage.
  3. Vul indien nodig de zoek- of filtercriteria in.
  4. Klik op Rapport uitvoeren.
  5. Exporteer de rapportage indien gewenst.

De rapportage wordt weergegeven. U kunt de resultaten bekijken of exporteren. Afhankelijk van de rapportage zijn verschillende exportformaten beschikbaar.

Aandachtspunten
  • De beschikbare zoek- en filtermogelijkheden verschillen per rapportage.
  • Welke gegevens u kunt bekijken, hangt af van uw rol en autorisaties en organisatie.

 

Filters

Met filtering bepaalt u welke gebeurtenisberichten uw organisatie via Digilevering ontvangt. Door filters in te stellen, ontvangt u alleen berichten die voldoen aan de voorwaarden van uw abonnement.

Digilevering ondersteunt twee manieren van filtering: enkelvoudige filtering en samengestelde filtering.

Wat is filtering?

Een filter is een voorwaarde waaraan een gebeurtenisbericht moet voldoen voordat het wordt doorgestuurd naar uw organisatie. U kunt bijvoorbeeld instellen dat u alleen berichten wilt ontvangen over een bepaalde gemeente, postcode of categorie. Welke filters beschikbaar zijn, hangt af van de gebeurtenissoort en de catalogus van de basisregistratie. Voor het instellen van filters binnen een abonnement, zie hoofdstuk 5.2.3, Stap 3. Filters instellen.

Enkelvoudige filtering

Met enkelvoudige filtering stelt u voorwaarden in voor afzonderlijke gegevens uit een gebeurtenisbericht. U kunt bijvoorbeeld instellen dat u alleen berichten wilt ontvangen voor bepaalde postcodes of gemeenten. Een enkelvoudig filter bestaat uit een filtertype, een operator en één of meer waarden. De operator bepaalt hoe de opgegeven waarde wordt vergeleken met de waarde in het gebeurtenisbericht. Wanneer meerdere enkelvoudige filters zijn ingesteld, moet een bericht aan alle ingestelde voorwaarden voldoen.

Filtertypen

Digilevering ondersteunt verschillende filtertypen. Welke typen beschikbaar zijn, hangt af van de gebeurtenissoort.

Tekst Filteren op tekstwaarden, zoals een postcode of gemeentenaam.
Getal Filteren op numerieke waarden.
Datum en tijd Filteren op datums en tijdstippen.
Geo-punt Filteren op geografische punten.
Geo-gebied Filteren op geografische gebieden.

 

Filteroperatoren per domein

Met een operator bepaalt u aan welke voorwaarde een waarde moet voldoen. Welke operatoren beschikbaar zijn, hangt af van het filtertype.

Tekst
Geen filter Filtering uitschakelen.
Is een van De waarde komt overeen met een van de opgegeven waarden.
Is geen van De waarde komt niet overeen met de opgegeven waarden.
Lijkt op De waarde voldoet aan een opgegeven tekstpatroon.
Lijkt niet op De waarde voldoet niet aan een opgegeven reguliere expressie.
Komt alfabetisch-lexicografisch voor De waarde komt alfabetisch vóór de opgegeven waarde.
Komt alfabetisch-lexicografisch na De waarde komt alfabetisch ná de opgegeven waarde.
Komt voor in reeksverzameling De waarde valt binnen een opgegeven verzameling van waarden of reeksen.

Bij 'Is een van', 'Is geen van' en de alfabetisch-lexicografische vergelijkingen wordt geen onderscheid gemaakt tussen hoofdletters en kleine letters. Bij 'Lijkt op' en 'Lijkt niet op' wordt dit onderscheid wel gemaakt.

Getal
Geen filter Filtering uitschakelen.
< Kleiner dan de opgegeven waarde.
> Groter dan de opgegeven waarde.
<= Kleiner dan of gelijk aan de opgegeven waarde.
>= Groter dan of gelijk aan de opgegeven waarde.
Ligt tussen De waarde ligt tussen twee opgegeven getallen.
= De waarde is gelijk aan het opgegeven getal.
<> De waarde is niet gelijk aan de opgegeven getallen.
Datum en tijd
Geen filter Filtering uitschakelen.
Valt voor De datum ligt vóór de opgegeven datum.
Valt na De datum ligt ná de opgegeven datum.
Valt voor of op De datum ligt vóór of op de opgegeven datum.
Valt op of na De datum ligt op of na de opgegeven datum.
Valt tussen De datum ligt tussen twee opgegeven datums.
Valt op De datum komt overeen met de opgegeven datum.
Valt niet op De datum komt niet overeen met de opgegeven datums.
Geografische filtering
Geo-punt Geen filter Filtering uitschakelen.
Geo-punt Ligt in Het geografische punt ligt binnen het opgegeven gebied.
Geo-punt Ligt niet in Het geografische punt ligt buiten het opgegeven gebied.
Geo-gebied Geen filter Filtering uitschakelen.
Geo-gebied Bevat Het geografische gebied bevat het opgegeven gebied.
Geo-gebied Bevat niet Het geografische gebied bevat het opgegeven gebied niet.

Bij geografische filtering kunnen aanvullende geografische gegevens nodig zijn.

Reeksverzamelingen

Met een reeksverzameling kunt u meerdere waarden of waardebereiken vastleggen in één verzameling.

Dit is bijvoorbeeld handig wanneer uw organisatie berichten wil ontvangen voor een groot aantal postcodes.

Een reeksverzameling kan binnen een abonnement bij meerdere gebeurtenissoorten worden gebruikt. Hierdoor hoeft u dezelfde waarden niet telkens opnieuw in te voeren.

Voordat u begint

Controleer of:

  • u beschikt over de rol Abonnementenbeheer;
  • het abonnement de status 'In bewerking' heeft;
  • de gewenste gebeurtenissoorten zijn toegevoegd.
Reeksverzameling aanmaken

Stappen

  1. Open het gewenste abonnement.
  2. Klik op Reeksverzamelingen.
  3. Kies Voeg reeksverzameling toe.
  4. Vul een naam in en klik op Opslaan.
  5. Klik op Wijzigen om reeksen toe te voegen.
  6. Vul per reeks een begin- en eindwaarde in, gescheiden door een puntkomma.
  7. Klik op Opslaan.

De reeksverzameling is aangemaakt en kan worden gebruikt bij het instellen van filters.

Voorbeeld

Onderstaande reeksverzameling bevat verschillende postcodebereiken:

3830AA 3832ZZ
3833AA 3833DZ
3833KA 3833KA
3833PA 3833ZZ

Iedere regel bevat een beginwaarde en een eindwaarde. Beide waarden moeten evenveel tekens bevatten.

Wilt u één specifieke waarde opnemen? Vul dan dezelfde begin- en eindwaarde in.

Reeksverzameling gebruiken

Stappen

  1. Open de gewenste gebeurtenissoort binnen het abonnement.
  2. Open het enkelvoudige filter waarvoor u de reeksverzameling wilt gebruiken.
  3. Selecteer de operator 'Komt voor in reeksverzameling'.
  4. Selecteer de gewenste reeksverzameling.
  5. Klik op Opslaan.

Het filter is gekoppeld aan de reeksverzameling. Alleen berichten die voldoen aan de ingestelde voorwaarden worden doorgestuurd.

Reeksverzameling wijzigen of verwijderen

U kunt een bestaande reeksverzameling wijzigen zolang het abonnement de status 'In bewerking' heeft.

Bij het wijzigen vervangt u de bestaande reeksen door de nieuw opgegeven reeksen.

Een reeksverzameling kan alleen worden verwijderd wanneer deze niet meer wordt gebruikt door een filter binnen de abonnementsversie.

Aandachtspunten
  • De beginwaarde moet kleiner dan of gelijk zijn aan de eindwaarde.
  • Beide waarden moeten evenveel tekens bevatten.
  • Digilevering controleert niet of reeksen elkaar overlappen.
  • Wijzigingen in een reeksverzameling kunnen gevolgen hebben voor meerdere gebeurtenissoorten.
  • Bij het kopiëren van een abonnement worden de namen van reeksverzamelingen overgenomen, maar niet de bijbehorende reeksen. Deze moet u opnieuw invoeren.
  • Bij het opnieuw in bewerking nemen van een abonnementsversie worden de reeksverzamelingen wel meegenomen.

Samengestelde filtering

Met samengestelde filtering kunt u meerdere voorwaarden combineren in één filterexpressie.

Dit is handig wanneer berichten aan verschillende combinaties van voorwaarden mogen voldoen.

Bij samengestelde filtering gebruikt u logische operatoren om voorwaarden met elkaar te verbinden.

Opbouw van een filterexpressie

Een filterexpressie bestaat uit een filterelement, een operator en een referentiewaarde.

Bijvoorbeeld:

filter1 == 'Amsterdam'

Hierbij is:

  • filter1 het filterelement;
  • == de vergelijkingsoperator;
  • 'Amsterdam' de referentiewaarde.

De namen van de filterelementen moeten overeenkomen met de definities in de catalogus.

Operatoren en referentiewaarden

Onderstaande tabel geeft een overzicht van de operatoren die bij samengestelde filtering gebruikt kunnen worden.

== Gelijk aan.
!= Niet gelijk aan.
REGEX Voldoet aan een reguliere expressie.
NREGEX Voldoet niet aan een reguliere expressie.
< Kleiner dan.
<= Kleiner dan of gelijk aan.
> Groter dan.
>= Groter dan of gelijk aan.
WITHIN Ligt binnen een geografisch gebied.
DISJOINT Ligt buiten of is gescheiden van een geografisch gebied.
CONTAINS Bevat een geografisch gebied.
OVERLAPS Overlapt met een geografisch gebied.

Welke operatoren u kunt gebruiken, hangt af van het filtertype.

Tekstwaarden worden tussen enkele aanhalingstekens geplaatst. Gebruik bij filterexpressies de juiste schrijfwijze van de operatoren.

AND, OR en haakjes

Met logische operatoren kunt u meerdere voorwaarden combineren.

AND (EN) Alle gekoppelde voorwaarden moeten waar zijn.
OR (OF) Minimaal één van de gekoppelde voorwaarden moet waar zijn.

Wanneer AND en OR in dezelfde filterexpressie worden gebruikt, heeft AND voorrang op OR.

Met haakjes kunt u aangeven welke voorwaarden eerst moeten worden beoordeeld.

Voorbeelden

Voorbeeld 1 – AND

Uw organisatie wil alleen berichten ontvangen wanneer de gemeente Amsterdam is én de leeftijd minimaal 18 jaar bedraagt.

  • filter1 == 'Amsterdam' AND filter2 >= 18

Beide voorwaarden moeten waar zijn voordat het bericht wordt doorgestuurd.

 

Voorbeeld 2 – OR

Uw organisatie wil berichten ontvangen voor Amsterdam of Rotterdam.

  • filter1 == 'Amsterdam' OR filter1 == 'Rotterdam'

Een bericht wordt doorgestuurd wanneer minimaal één van de voorwaarden waar is.

 

Voorbeeld 3 – AND en OR combineren

Uw organisatie wil berichten ontvangen wanneer:

  • de gemeente Amsterdam is en de leeftijd minimaal 18 jaar bedraagt;
  • of de gemeente Rotterdam is en de leeftijd minimaal 21 jaar bedraagt.

(filter1 == 'Amsterdam' AND filter2 >= 18)
OR
(filter1 == 'Rotterdam' AND filter2 >= 21)

Met haakjes geeft u aan welke voorwaarden bij elkaar horen.

De filterelementen in deze voorbeelden zijn fictief. Gebruik bij het instellen van een filter de filterelementen die beschikbaar zijn in de catalogus.

Aandachtspunten

  • Gebruik alleen filterelementen die beschikbaar zijn voor de gebeurtenissoort.
  • Controleer of de gebruikte operator geschikt is voor het filtertype.
  • Gebruik haakjes wanneer u meerdere AND- en OR-voorwaarden combineert.
  • Reeksverzamelingen kunnen niet worden gebruikt binnen samengestelde filterexpressies.

Aandachtspunten

  • De beschikbare filters worden bepaald door de catalogus van de basisregistratie.
  • Niet iedere gebeurtenissoort ondersteunt dezelfde filtertypen en operatoren.
  • Bij meerdere enkelvoudige filters moet een bericht aan alle ingestelde voorwaarden voldoen.
  • Controleer samengestelde filterexpressies zorgvuldig voordat u het abonnement aanbiedt voor akkoord.
  • Houd bij het wijzigen van reeksverzamelingen rekening met andere filters die dezelfde verzameling gebruiken.
  • Controleer na het kopiëren of wijzigen van een abonnement of de filters nog aansluiten bij de berichten die uw organisatie wil ontvangen.

Zie hoofdstuk 5, Abonnementen, voor het aanmaken, wijzigen en accorderen van abonnementen.