Spotbooking

Inleiding

Spotbooking is een online platform waarmee besturen zoals gemeentes of politiezones innames openbaar domein kunnen beheren (aanvragen oppikken, goedkeuren of weigeren, visualisatie, etcetera). Dankzij de Spotbooking integratie kan je vanuit Skryv enkele Spotbooking functionaliteiten aanspreken.

Goed om te weten

Spotbooking communiceert achterliggend met GIPOD, een overkoepelend Vlaams platform waar alle innames openbaar domein geregistreerd worden. Weet dat Skryv zelf ook een rechtstreekse connector met GIPOD aanbiedt. Deze biedt slechts beperkte technische functionaliteiten. De meerwaarde van Spotbooking is de uitgebreide, gebruiksvriendelijke interface voor zowel aanvragers als dossierbeheerders.

Protocol

Voorwaarden

Vooraleer je met de Spotbooking integratie aan de slag wil, moet de klant het Spotbooking platform al in gebruik hebben genomen. Binnen Spotbooking moet je een technische gebruiker aanmaken met bijhorende gebruikersnaam en paswoord.

Beperkingen

De Spotbooking widget is enkel beschikbaar in de neutrale frontoffice.

Het is mogelijk om een aanvraag ook vanuit de backoffice te definiëren, maar dit gebeurt door Spotbooking in een extra browsertab te openen, de aanvraag in te voeren, de ID te kopiëren en deze vervolgens te plakken in een formulierveld in de backoffice.

Flow

Binnen de scope van een frontoffice formuliertaak kan een gebruiker via een widget een aanvraag inname openbaar domein definiëren. De aanvraag is meteen gekend in Spotbooking met ID en status ‘unverified’, maar kan er nog niet verwerkt worden (instelbaar). In de backoffice kan een dossierbeheerder de aanvraag vervolgens ofwel weigeren (annuleren in Spotbooking), ofwel accepteren (ter beoordeling in Spotbooking plaatsen). Daarna verloopt de verdere afhandeling van de aanvraag in Spotbooking zelf. Eenmaal de finale beslissing in Spotbooking vastligt, gebeurt de terugkoppeling naar Skryv manueel via een op te laden rapport.

Initiële setup

Volg onderstaand stappenplan om de Spotbooking integratie op te zetten.

Zarn eigenschappen toevoegen.

CODE

SKRYV_BACKOFFICEURL
SKYRV_FRONTOFFICEURL

Applicatie eigenschappen toevoegen.

Eigenschap	Beschrijving
`skryv.spotbooking.url`	URL Spotbooking van de klant.
`skryv.spotbooking.username`	Gebruikersnaam technische gebruiker.
`skryv.spotbooking.password`	Wachtwoord technische gebruiker.

OF, in het geval je applicatie beheerd wordt via Zarnstates.

CODE

"environmentVariables": {
    ...
    "SKRYV_SPOTBOOKING_URL": ...,
    "SKRYV_SPOTBOOKING_USERNAME": ...
},
"secrets": {
    ...
    "SKRYV_SPOTBOOKING_PASSWORD": ...
},
...

Configuratie

De configuratie van de Spotbooking integratie gebeurt in Studio via toevoegen van het Spotbooking element aan het aanvraagformulier. Na weigering of acceptatie van de aanvraag door de backoffice medewerker moeten de juiste service taken gedefinieerd zijn om dit door te geven aan Spotbooking: Spotbooking valideer aanvraag en Spotbooking annuleer aanvraag. Toevoegen van het rapport na afhandeling in Spotbooking kan via een formulier met bestand veld of via rechtstreekse upload in het dossier in de backoffice.

Spotbooking functies en methodes

${spotbooking.validate(<spotbookingId>)}

Dit zet de aanvraag in Spotbooking op status ‘te behandelen’. De parameter is de ID van de aanvraag zoals gekend in Spotbooking. Deze functie kan je opzetten via een service taak template.

${spotbooking.cancel(<spotbookingId>)}

Dit zet de aanvraag in Spotbooking op status ‘geannuleerd’. De parameter is de ID van de aanvraag zoals gekend in Spotbooking. Deze functie kan je opzetten via een service taak template.