Inleiding

Uit bevragingen van zowel de burger als de lokale besturen blijkt dat de afvalophalingskalender één van de meest gewenste functionaliteiten is voor de Mijn Burgerprofiel app. Daarom hebben we het nu mogelijk gemaakt om de afvalophalingskalender aan te bieden in de Mijn Burgerprofiel app en burgers aan de afvalophalingen te herinneren met behulp van pushnotificaties.

We willen eind 2024 enkele lokale besturen en afvalintercommunales de mogelijkheid bieden om afvaldata in de lokale MBP app te tonen, afhankelijk van hun interesse.

De gegevens zullen in deze pilootfase door het MBP app team worden geïmporteerd.

Doelstellingen pilootfase

• De afvalkalender in een beperkte selectie van lokale MBP apps aanbieden, voor een kleine groep steden en gemeenten.

• De afvalkalender uitrollen op een gecontroleerde manier en op kleine schaal.

• Samen nagaan met de afvalintercommunales of we alles uit de interviews goed vertaald hebben naar functionaliteit.

• Feedback verzamelen over de opzet en inhoud zodat we verder kunnen optimaliseren waar nodig en daarna breder kunnen uitrollen.

Overzicht verloop pilootfase

Open

Afvaldata in Mijn Burgerprofiel app

We delen het model achter de afvaldata binnen Mijn Burgerprofiel op in 3 grote peilers:

• AfvalkalenderTypes

• Groepen

• Afvalkalenders

Deze 3 peilers worden verder in dit document meer in detail toegelicht. Er wordt bij het importeren een stabiele link gelegd tussen deze 3 peilers onderling om de burger de kalender te kunnen tonen in Mijn Burgerprofiel.

Vanuit Digitaal Vlaanderen is er geen voorkeur hoe deze afvaldata tot bij ons komen. Dat mag via het lokale bestuur of via de afvalintercommunale rechtstreeks. Naar efficiëntie toe vermoeden we dat de afvalintercommunale van dienst ons die gegevens zal bezorgen. Afval is immers de bevoegdheid van de afvalintercommunales. 

De data voor elke peiler zal tijdens de pilootfase via een apart bestand door het MBP app team geïmporteerd worden. Voor elke gemeente zullen dus steeds minstens 3 importbestanden aangeleverd moeten worden.

Ingevulde importbestanden aanleveren tijdens de pilootfase kan via contactpersoon Daan De Ridder.

Na ontvangst, importeert het MBP app team de aangeleverde gegevens in de systemen van Digitaal Vlaanderen. Daarna kunnen die, mits validatie via een demo app, getoond worden in de lokale app(s).

Hieronder wordt meer in detail uitgelegd wat elke peiler inhoudt.

AfvalkalenderTypes

AfvalkalenderTypes zijn alle items, alle blokken, die een afvalintercommunale op de afvalkalender wil kunnen tonen.

Dit kunnen enerzijds reguliere afvalfracties zijn zoals PMD, GFT, restafval, ...

Anderzijds kunnen we (indien gewenst) aan de hand van een afvalkalenderType ook andere zaken tonen op de afvalkalender. Denk maar aan een repair café, een uitzonderlijke sluitingsdag van het recyclagepark of een feestdag waarop de ophalingen niet doorgaan.

De naamgeving van elk afvalkalenderType is vrij te kiezen door de afvalintercommunale en de invulling werd bewust flexibel gemaakt.

Om de afvalkalenderTypes te importeren hebben we één importbestand nodig per gemeente volgens onderstaand sjabloon. Dit is op dit moment het enige importbestand waarvoor Digitaal Vlaanderen een eigen opmaak definieerde.

Open

Mogelijke iconen per afvalkalenderType

afvalkalenderTypes in MBP app, getoond in de lijstweergave

afvalkalenderTypes in MBP app, getoond in de lijstweergave
Open

Groepen

Een groep bestaat uit een lijst van adressen (straat, huisnummer(s), postcode en naam gemeente). Een groep komt bijgevolg overeen met één ophaalronde van een afvalintercommunale.

In kleinere gemeenten is er soms slechts één ophaalronde voor de hele gemeente. In grote steden zijn er meestal meerdere ophaalrondes die bijvoorbeeld ruwweg gelijk lopen met de verschillende deelgemeentes in de stad.

Een groep mag adressen in meerdere postcodes bevatten maar die moet wel behoren tot dezelfde niscode als de hoofdgemeente waarvoor we de import doen.

Het opstellen van adressenlijsten is al eens gebeurd voor de Recycle app en dit wordt periodiek onderhouden door de afvalintercommunales. Het opstellen van adressenlijsten is bovendien een tijdsintensief proces.

We hebben er daarom voor gekozen om dezelfde adresdefinities te hanteren zoals de Recycle app.

De afvalintercommunales kunnen deze data bijgevolg rechtstreeks exporteren uit Recycle en importeren in MBP volgens hetzelfde formaat.

Een afvalkalender wordt steeds per groep opgemaakt, of omgekeerd: een afvalkalender kan niet weergegeven worden zonder een bijhorende groep met corresponderende adressen. De kalender wordt immers aan de MBP app-gebruiker getoond op basis van het ingevoerde adres. Dit adres behoort dan weer tot één of meerdere groepen waarvoor een kalender kan weergegeven worden.

Enkele principes rond de opmaak van Groepen:

• Een adres mag in meerdere groepen voorkomen: stel dat een adres voor alle ophalingen een vast stramien volgt maar voor GFT-ophalingen een ander specifieker ritme, dan moet dit adres zowel voorkomen in het importbestand met de reguliere ophalingen als in het importbestand met de GFT-ophalingen.

• Het importsysteem verwacht vandaag één lijn (rij in een importbestand) per postcode. Een straat die doorheen meerdere gemeenten in het grondgebied loopt, moet ontdubbeld worden.

• Huisnummers kunnen toegevoegd worden volgens volgende definities:

  • Even huisnummers van een straat

  • Oneven huisnummers van een straat

  • Beide (alle) huisnummers van een straat

  • Exhaustieve lijst van huisnummers van een straat (even en onever in een aparte cel)

Afvalkalenders

Dit is de laatste peiler in het model van de afvaldata. Hierbij wordt voor een bepaalde groep (adressenlijst, ophaalronde) afvalkalenderTypes ingepland op een kalender. De kalender kan voor een periode van een jaar of half jaar geïmporteerd worden. De kalender hoeft niet noodzakelijk te starten bij een nieuw kalenderjaar.

Een afvalkalender wordt steeds per groep opgemaakt of omgekeerd: een afvalkalender kan niet weergegeven worden zonder een bijhorende groep met corresponderende adressen. De kalender wordt immers aan de app-gebruiker getoond op basis van het ingevoerde adres. Dit adres behoort dan weer tot één of meerdere groepen waarvoor een kalender kan weergegeven worden.

Ook hier werd het formaat en de opmaak van Recycle gevolgd. De kalenders zelf kunnen dus geëxporteerd worden uit Recycle en geïmporteerd worden in de systemen van Digitaal Vlaanderen.

Opmaak van de afvalkalender:

• Eerste kolom geeft een reeks datums weer (meestal kalenderjaar).

• De kolommen erna komen overeen met de afvalkalenderTypes.

• Een “x” duidt aan of er een ophaling plaatsvindt van een bepaald afvalkalenderType op een bepaalde datum.

Sjablonen importbestanden

Lege sjablonen

AfvalkalenderTypes	Groep	Afvalkalender

AfvalkalenderTypes	Groep	Afvalkalender
Open	Open	Open

Ingevulde voorbeeldbestanden

AfvalkalenderTypes	Groep	Kalender

AfvalkalenderTypes	Groep	Kalender
Open	Open	Open

Notificaties

De app gebruiker kan notificaties ontvangen vanuit de MBP app als de burger de push notificaties voor de afvalkalender heeft ingeschakeld.

Op basis van de keuze van de gebruiker wanneer die notifcaties over de afvalkalender wil ontvangen, zal de gebruiker de dag voordien of de dag zelf een notificatie kunnen ontvangen op een zelf gekozen tijdstip.

Foutcorrectie in de afvaldata

Wanneer u een fout ontdekt in de afvaldata (afvalkalenderTypes, Groepen of Kalenders) kunnen die in deze fase enkel door Digitaal Vlaanderen gecorrigeerd worden.

Lever daarvoor een nieuwe, aangepaste versie van het foutieve importbestand aan via contactpersoon Daan De Ridder. Het MBP app team zal in dat geval het foutieve importbestand vervangen door het juiste.

In de toekomst zullen afvalintercommunales hiervoor zelf kunnen aanmelden op een portaal om de nodige aanpassingen zelf door te kunnen voeren via een grafische interface.

Steekproeven en validatie afvaldata in de pilootfase

We bieden de mogelijkheid aan voor afvalintercommunales om de geïmporteerde afvaldata zelf te valideren. Hiervoor is het mogelijk om toegang te krijgen tot onze demo app.

Stel hiervoor één contactpersoon die toegang zal krijgen tot onze demo app. Enkel deze persoon kan dan de validatie doen. Idealiter beperken we ons tot een iOS-gebruiker.

FAQ

Hoe lever ik de importbestanden aan? Afvalintercommunale

• De ingevulde importbestanden mogen doorgestuurd worden naar Daan De Ridder.

• Ga gestructureerd tewerk en splits alles op per gemeente:

  • Lever alle benodigde importbestanden in één zip-bestand per gemeente aan

  • Steek de afvalkalenderTypes in de root folder

  • Maak telkens één folder waarin één groep en corresponderende kalender samenzitten en geef deze folder een unieke naam (bvb. Zone 1A - Groep en kalender).

• Pas een gestandaardiseerde naamgeving toe per gemeente en per importbestand. Zorg voor een duidelijk interpreteerbare naamgeving. Enkele voorbeelden:

  • AfvalkalenderTypes_Herentals_20241206

  • Groep1A_Herentals_20241206, Maandagronde_Herentals_20241206, ZoneA_Herentals_20241206, …

  • Kalender1A_Herentals_20241206, KalenderMaandagronde_Herentals_20241206, KalenderZoneA_Herentals_20241206, …

• Bij de import worden stabiele links gelegd tussen de importbestanden onderling. Exacte schrijfwijze in de importbestanden en unieke naamgeving zijn dus essentieel om dit te doen werken zoals bedoeld.

Hoe afvalkalenderTypes benoemen? Afvalintercommunale

• Lever een lijst aan van de Types zoals die ook op de papieren kalender benoemd zijn.

• Zet geen tijdsaanduiding in de naamgeving van een afvalkalenderType zoals “Morgen” of “Vandaag”. Dit maakt de bewoording in de notificaties onduidelijk voor een gebruiker.

• Enkele voorbeelden van afvalkalenderTypes:

  • PMD

  • GFT

  • Restafval

  • Snoeihout

  • KGA

  • Repair café

  • Recyclagepark gesloten

  • Feestdag: geen ophaling

  • Paasmaandag: geen ophaling

• Zorg er steeds voor dat de afvalkalenderTypes exact dezelfde naamgeving hebben zoals gebruikt in het importbestand(en) van de corresponderende kalender.

• Staat er een kolom in het kalender-importbestand waarvoor geen afvalkalenderType beschikbaar is (bvb. PMD staat op de kalender maar werd niet opgenomen in het bestand met de afvalkalenderTypes), dan zal de import falen en moet er een correctie gebeuren in de importbestanden. Na correctie doen we de import opnieuw.

Achtergrondkleur bij de iconen voor afvalkalenderTypes

Het achtergrondkleur van de iconen kan vrij gekozen worden door de afvalintercommunale. Dit achtergrondkleur wordt ingevuld als hexadecimale code (bijvoorbeeld #008430) in het importbestand van de afvalkalenderTypes.

Het icoon zelf kan dan weer enkel wit of zwart zijn. Vanuit toegankelijkheid zal de app er namelijk voor zorgen dat er genoeg kleurcontrast aanwezig is tussen het kleur van het icoon en het achtergrondkleur.

Het kleur van het icoon wordt automatisch door de app toegepast na een controle op kleurcontrast met het achtergrondkleur.

Hieronder een voorbeeld van achtergrondkleuren waarbij de app een wit icoon zal tonen:

Hoe vul ik het sjabloon voor de groepen in? Afvalintercommunale

• Start vanaf een export uit Recycle.

• Valideer of de kolommen en de volgorde overeenkomen met het sjabloon voor Groepen.

  • Even - Oneven - Beide - Straatnaam - Postcode - Gemeente

Hoe vul ik het sjabloon voor de kalender in? Afvalintercommunale

• Start vanaf een export uit Recycle:

  • Wij importeren bij voorkeur steeds rechtstreeks de CSV-export uit Recycle.

• De kolommen moeten exact overeenkomen met de ingevoerde afvalkalenderTypes in het sjabloon met de afvalkalenderTypes.

• Staat er een kolom in het kalender-importbestand waarvoor geen afvalkalenderType beschikbaar is (bvb. PMD staat op de kalender maar werd niet opgenomen in het bestand met de afvalkalenderTypes), dan zal de import falen en moet er een correctie gebeuren in de importbestanden. Na correctie doen we de import opnieuw.

• De eerste kolom toont de datums voor de komende ophaalperiode. We hanteren het volgende formaat (ISO-norm 8601): YYYY-MM-DD

• Om een ophaling aan te duiden, vullen we een “x” in voor een bepaalde datum en corresponderend afvalkalenderType.

Foutje gespot in een importbestand of in de MBP app? Afvalintercommunale

Corrigeer het bestand en lever ons een nieuwe versie aan. Wij doen de import opnieuw.

Let er hierbij wel op dat alle data in deze importbestanden gekoppeld is aan elkaar: een afvalkalender kan niet opgemaakt worden zonder een corresponderende groep (adressenlijst). Een afvalkalender kan evenmin opgesteld worden zonder corresponderende afvalkalenderTypes.

Als een afvalkalenderType wordt gebruikt in de afvalkalender, maar niet aanwezig was in het importbestand met de afvalkalenderTypes, dan zal de import falen. Na correctie in de importbestanden doen we de import opnieuw.

Waarom ontvang ik als burger geen notificaties? Burger

Het kan voorkomen dat een burger geen notificaties ontvangt vanuit de MBP app. Controleer dan achtereenvolgens deze zaken om te voorkomen dat u notificaties mist:

Digitaal Vlaanderen contacteren ivm de afvalkalender

Tijdens de pilootfase zal alle opvolging via Daan De Ridder verlopen.

Na de pilootfase schakelen we over op onze standaard manier van werken. Via de servicedesk voor de afdeling Loketplatform van Digitaal Vlaanderen kan een ticket aangemaakt worden bij vragen of problemen: