Staat de website waarvan je facturen wilt ophalen er nog niet tussen? Met de Script Wizard maak je zelf een script voor vrijwel elke website — zonder dat je hoeft te programmeren. De wizard begeleidt je stap voor stap door het proces en genereert automatisch een werkend script.
Onderstaand een voorbeeld van de script wizard die wordt gebruikt in de Browser Modus.
Je vindt de Script Wizard via het menu Bibliotheek → Nieuw Script Maken (knop in rechterbovenhoek).
Er zijn drie methoden beschikbaar om website scripts te genereren via de script wizard:
-
- Browser Modus – Navigeert door de website zoals een gebruiker
- Interne API – Gebruikt de verborgen API van de website (via de browsermodus)
- Publieke API – Gebruikt een publieke en gedocumenteerde REST API
–> Op deze pagina behandelen we de Browser modus
Zodra de script wizard is geopend heb je de optie om te kiezen tussen “Website inhoud” en “API”. Selecteer “Website inhoud” om verder te gaan met de browser modus.
Stap 1: Scriptnaam en instellingen #
Vul een herkenbare naam in voor het script, zoals de naam van de website. Kies daarna de juiste instellingen:
- Scriptcategorie: kies “Website” voor een gewoon script, of “Factuurportaal” als het om een herbruikbaar portaalscript gaat (zoals een Stripe Billing Portal die door meerdere scripts gebruikt kan worden).
- Scriptnaam: plaats hier de naam van het script, dit is meestal gelijk aan de naam van de website. Heeft een website meerdere versies? Zoals bijvoorbeeld een portaal voor particulieren en zakelijke gebruikers? Dan is het handig om dit ook duidelijk te vermelden in de scriptnaam.
- Inlog URL: de link die wordt gebruikt om in te kunnen loggen op de website. Deze url zal de wizard ook eerst openen om te starten met het configureren van het script.
- Inlogmethode: geef aan hoe je op deze website kunt inloggen, bijvoorbeeld met wachtwoord of authenticator etc.
- Factuurpagina URL: de url waar de facturen op staan. Invullen van de link in deze stap is optioneel en kan altijd later in een verdere stap geconfigureerd worden.
Klik vervolgens op de knop “Browser Openen” om naar de volgende stap te gaan.
Er opent dan een wizard-omgeving waarbij de inlogpagina van de betreffende site wordt geladen aan de rechterkant. Aan de linkerkant van de wizard zie je een zijbalk. Aan de bovenkant van de zijbalk tref je de instellingen van het nieuw te maken script en opties om het script aan te passen naar wens.
Specifieke website instellingen in de zijbalk (selecteer wat van toepassing is)
- Twee-factor authenticatie: schakel dit in als de website 2FA vereist bij het inloggen (via SMS, e-mail of een authenticator-app).
- Facturen zonder datum: schakel dit in als de website geen factuurdatums toont (maar bijvoorbeeld alleen maanden waar de factuur voor is uitgegeven).
- Heeft CAPTCHA: schakel dit in als de website een CAPTCHA toont bij het inloggen. VerzamelSysteem lost deze dan automatisch op.
- Factuur op Detailpagina: selecteer deze optie wanneer de facturen niet direct te downloaden zijn vanaf 1 factuurpagina, maar wanneer er doorgeklikt dient te worden naar een aparte pagina per factuur. Wanneer deze optie is geselecteerd dan zal de script wizard de stappen hierop aanpassen.
- Factuur extern: selecteer deze optie wanneer de facturen niet op dezelfde website staan, maar bijvoorbeeld op een facturatieportaal (zoals bijv Stripe).
- Screenshot Modus: voor websites zonder downloadbare PDF. Het systeem maakt dan screenshot van de factuurpagina die jij selecteert
#
Stap 2: Login-elementen selecteren #
Onder de website opties in de zijbalk zie je een sectie genaamd “Login elementen“.
Hier worden elementen getoond van de loginpagina die je dient aan te wijzen, zodat het script bijvoorbeeld weet waar jouw gebruikersnaam en wachtwoord op de pagina ingevuld dienen te worden.
Je klikt per element op Selecteren, klik daarna op het bijbehorende onderdeel op de webpagina, en VerzamelSysteem slaat de selector op.
LET OP: De volgorde van elementen in de zijbalk, is de volgorde van uitvoering van het script
Dit is het belangrijkste principe om te begrijpen: de elementen worden uitgevoerd in de volgorde waarop ze in de lijst staan. Als je wilt dat VerzamelSysteem eerst een cookiemelding wegklikt, dan de gebruikersnaam invult, dan het wachtwoord, en dan op inloggen klikt, moet dat ook precies in die volgorde in de elementenlijst staan. Je kunt elementen omhoog of omlaag slepen om de volgorde aan te passen.
Voor de loginpagina zul je standaard de volgende elementen zien staan:
- Gebruikersnaam / e-mail
- Wachtwoord
- Inlogknop
Via + Element Toevoegen voeg je losse elementen toe aan de lijst. Met het rode kruisje achter een element kun je elementen ook weer verwijderen uit de lijst wanneer ze niet nodig zijn.
Hieronder een overzicht van alle beschikbare login elementen welke je kan gebruiken op de loginpagina.
👤 Gebruikersnaam/E-mail Invoer (verplicht)
Het veld waar de gebruikersnaam of het e-mailadres wordt ingevuld. Selecteer het invoerveld op de webpagina.
Bij dit element kies je ook de invulmethode:
– Invullen — vult de tekst direct in het veld in (snel). Gebruik dit in de meeste gevallen.
– Typen — typt de tekens één voor één in (langzamer, maar imiteert menselijk gedrag). Gebruik dit als de website botdetectie heeft die directe invulling blokkeert.
🔑 Wachtwoord Invoer (verplicht)
Het wachtwoordveld op de loginpagina. Werkt hetzelfde als het gebruikersnaamveld, inclusief de keuze tussen Invullen en Typen.
▶️ Inlogknop (verplicht)
De knop of link waarmee het inlogformulier wordt verstuurd.
👆 Klik Voor Wachtwoord
Sommige websites tonen het wachtwoordveld pas nadat je op een knop hebt geklikt of het e-mailadres hebt bevestigd. Voeg dit element toe vóór het wachtwoordveld en selecteer de knop die het wachtwoordveld zichtbaar maakt.
🍪 Cookie Toestemming
De knop waarmee een cookiemelding of -popup wordt weggeklikt. Zet dit element vóór de login-elementen als de cookiemelding verschijnt vóór het inloggen.
🤖 Captcha Selectievakje
Het CAPTCHA-selectievakje dat soms op een loginpagina staat. VerzamelSysteem lost dit automatisch op via 2captcha. Selecteer het CAPTCHA-element op de pagina. Zet dit op de juiste positie in de volgorde — doorgaans vlak voor de inlogknop.
🔐 2FA Code Invoer
Het invoerveld voor de tweefactorauthenticatiecode. Zet dit element ná de inlogknop, want de 2FA-pagina verschijnt pas nadat het inlogformulier is verstuurd. Kies ook hier de invulmethode (Invullen of Typen).
✅ 2FA Bevestigen
De knop om de ingevoerde 2FA-code te bevestigen. Zet dit direct na het 2FA Code Invoer-element.
📲 Gebruikersbevestiging
Voor websites die werken met een pushmelding of app-bevestiging (bijv. “Bevestig in je mobiele app”). VerzamelSysteem pauzeert het script en wacht tot de gebruiker de bevestiging op zijn telefoon heeft afgehandeld, waarna het automatisch doorgaat.
🖱️ Aangepaste Klik
Een extra klik op een willekeurig element, op een zelf te kiezen moment in de volgorde. Gebruik dit voor knoppen, pop-ups of tussenstappen die niet in een van de andere categorieën passen. Je kunt meerdere aangepaste klik-elementen toevoegen.
⏱️ Wachten (seconden)
Voegt een pauze in op de gekozen positie in de volgorde. Voer in hoeveel seconden het script moet wachten voordat het doorgaat. Gebruik dit als een pagina of element langzaam laadt en VerzamelSysteem te snel verder gaat.
–>> Wanneer het loginproces is vastgelegd met alle benodigde elementen kun je doorgaan naar de factuurpagina. Klik op de knop “Doorgaan naar facturen” om de volgende stap te openen.
#
Stap 3: Factuurpagina instellen #
Log handmatig in via de ingebouwde browser en navigeer naar de pagina waar je facturen worden getoond. Zodra je op de juiste pagina bent, klik je op Huidige URL Gebruiken. VerzamelSysteem onthoudt dit adres en navigeert er bij elke run automatisch naartoe.
Klik op → Doorgaan naar Factuurelementen zodra je op de juiste pagina staat.
Factuurpagina op een externe URL zoals bijvoorbeeld Stripe?
Als de factuurpagina op een externe URL staat (bijv. een apart facturatieportaal), zie je hier ook de stap voor externe navigatie. Selecteer dan de knoppen of links die je normaal zou klikken om van de inlogpagina naar het externe portaal te navigeren.
Externe navigatie-elementen:
- 🌐 Navigeer naar URL — als het script eerst naar een specifieke URL moet gaan voordat het verdere navigatiestappen uitvoert.
- 🔗 Navigatie Klik — een knop of link die je normaal klikt om naar het externe factuurportaal te gaan. Verplicht bij externe factuurlocaties.
- 🍪 Cookie Toestemming — een cookieknop op de externe pagina.
- 🖱️ Aangepaste Klik — extra klikstap in het navigatiepad.
- ⏱️ Wachten (seconden) — pauze om de externe pagina te laten laden.
Als er tijdens de navigatie een nieuw venster opent, gebruik dan de tabbalk boven in de browser om naar het nieuwe venster te schakelen.
#
Stap 4: Factuurelementen selecteren #
Nu geef je aan welke elementen op de factuurpagina VerzamelSysteem moet herkennen. Net als bij de login-elementen geldt: de volgorde in de zijbalk bepaalt de volgorde van uitvoering. Stel de elementen in de logische volgorde in: eerst de rij, dan de data erin, en tot slot de download- of navigatieactie.
Het is mogelijk om zelf de elementen op de pagina te selecteren. Wanneer je hier geen geduld voor hebt kun je dit ook automatisch door AI laten doen. Klik in dat geval dan op Automatisch Genereren (AI) om de elementen automatisch te laten detecteren. De AI analyseert de pagina en vult de selectors automatisch in. Controleer daarna of de detectie correct is en pas waar nodig aan.
Hieronder een overzicht van alle beschikbare factuurelementen welke je kan gebruiken op de facturatiepagina.
📋 Factuur Rij (verplicht als startpunt)
Eén rij uit de factuurlijst. Dit is het startpunt: zodra VerzamelSysteem weet hoe één rij eruitziet, herkent het automatisch alle andere rijen op de pagina. Selecteer een representatieve rij — niet de koptekstrij.
Elke rij wordt afzonderlijk verwerkt: alle elementen die je daarna instelt (datum, beschrijving, download, enz.) worden per rij uitgevoerd.
📅 Datum Element
Het datumveld binnen een rij. VerzamelSysteem leest de datum uit en gebruikt die voor datumfiltering. Als de datum op de detailpagina staat in plaats van in de rij, kun je dit element daar instellen.
📝 Beschrijving/Titel
De omschrijving of naam van de factuur, zoals “Factuur maart 2024” of de naam van het product. Dit wordt gebruikt als bestandsnaam bij het downloaden.
🔢 Factuurnummer
Het factuurnummer of de factuur-ID. Optioneel, maar handig voor de bestandsnaam en herkenbaarheid in de factuurlijst.
📥 Download/PDF Link
De directe link of knop om de factuur te downloaden. Selecteer dit als er een zichtbare download- of PDF-link in de rij staat.
👆 Klik om Download te Tonen
Sommige websites tonen de downloadlink pas nadat je op een knop hebt geklikt (bijv. een actieknop of menu). Voeg dit element toe vóór het Download-element. VerzamelSysteem klikt dan eerst op deze knop en zoekt daarna de downloadlink.
👆 Klik om Detaillink te Tonen
Vergelijkbaar met bovenstaande, maar dan voor een detailpaginalink die pas zichtbaar wordt na een klik. Gebruik dit in combinatie met het Detailpagina Link-element.
🔗 Detailpagina Link
Een link naar de detailpagina van de factuur. Gebruik dit als je eerst naar een detailpagina moet navigeren voordat je de factuur kunt downloaden. VerzamelSysteem volgt de link en verwerkt de detailpagina-elementen die je in stap 5 instelt.
🔄 Meer Laden Knop
Een knop om meer facturen te laden op de pagina (ook wel “Toon meer” of “Laad meer”). VerzamelSysteem klikt hier automatisch op totdat alle facturen in het geselecteerde datumbereik zijn geladen.
➡️ Volgende Pagina Knop
De knop of link voor de volgende pagina bij gepagineerde factuurlijsten. VerzamelSysteem navigeert automatisch door alle pagina’s totdat alle facturen in het datumbereik zijn verwerkt.
📸 Screenshot Element
Voor websites zonder downloadbare PDF. VerzamelSysteem maakt een screenshot van het geselecteerde element (of van de volledige pagina als je niets selecteert) en slaat dat op als afbeelding. Schakel in de zijbalk “Screenshot Modus” in als je deze optie wilt gebruiken.
🍪 Cookie Toestemming
Een cookieknop op de factuurpagina, voor het geval die pas na het inloggen verschijnt.
⏱️ Wachten (seconden)
Pauze op een specifieke positie in de verwerkingsvolgorde. Gebruik dit als de factuurpagina of een element langzaam laadt.
#
Snelle modus en batchverwerking #
Bij de factuurelementen vind je ook de Snelle modus. Wanneer de snelle modus is ingeschakeld, verwerkt VerzamelSysteem meerdere factuurpagina’s tegelijk in parallel (standaard 3 pagina’s per batch). Dit versnelt het ophalen aanzienlijk bij grote hoeveelheden facturen.
Via Batchgrootte stel je in hoeveel pagina’s er gelijktijdig worden verwerkt. Schakel de snelle modus uit als de website beperkingen heeft op snelle of gelijktijdige verzoeken. In dat geval worden facturen één voor één verwerkt.
#
Facturen op meerdere pagina’s (multi-sectie) #
Heeft de website facturen op meerdere verschillende pagina’s? Denk aan een webshop met aparte secties voor bestellingen, abonnementen en creditnota’s. Via Factuur Sectie Toevoegen maak je per pagina een afzonderlijke sectie aan, elk met een eigen URL en eigen factuurelementen. VerzamelSysteem doorloopt elke sectie en bundelt alle gevonden facturen.
#
Stap 5: Detailpagina-elementen #
Als je bij de website opties hebt ingesteld dat de facturen op een detailpagina staan, navigeer dan nu via de ingebouwde browser naar een detailpagina van een factuur (het maakt niet uit welke factuur). Selecteer vervolgens de elementen op die detailpagina.
De volgorde geldt ook hier: stel de elementen in de volgorde in waarin VerzamelSysteem ze moet uitvoeren.
Beschikbare elementen op de detailpagina:
👆 Klik om Download te Tonen
Als er op de detailpagina eerst een knop geklikt moet worden voordat de downloadlink zichtbaar wordt.
📥 Download/PDF Link
De directe downloadlink op de detailpagina.
📅 Datum Element
De factuurdatum, als die alleen op de detailpagina staat (en niet in de rij op de overzichtspagina).
📝 Beschrijving/Titel
De omschrijving van de factuur op de detailpagina.
🔢 Factuurnummer
Het factuurnummer op de detailpagina.
📸 Screenshot Element
Voor het maken van een screenshot van de detailpagina als er geen PDF beschikbaar is. Schakel in de zijbalk “Screenshot Modus” in als je deze optie wilt gebruiken.
🍪 Cookie Toestemming
Cookie-knop op de detailpagina.
⏱️ Wachten (seconden)
Pauze op de detailpagina, bijvoorbeeld om een PDF-viewer te laten laden.
#
Stap 6: Script genereren #
Klik op Controleren & Genereren voor een samenvatting van alle geselecteerde elementen. Controleer of alles klopt en klik daarna op Script Genereren. VerzamelSysteem maakt automatisch een werkend script en slaat het op in je scriptbibliotheek.
#
Script bewerken #
Je kunt een bestaand eigen script altijd aanpassen. Open de Scriptbibliotheek, zoek het script op en klik op Bewerken (het potlood icoontje).
De wizard opent opnieuw met je eerder ingevulde instellingen, deze kun je vervolgens aanpassen naar wens.
Na het opslaan word je gevraagd of je het versienummer wilt verhogen — handig als je een bijgewerkte versie wilt delen via de community.
#
Script delen via de community #
Heb je een script gemaakt voor een website die anderen ook gebruiken? Deel het dan via de community. Na een check door ontwikkelaars van VerzamelSysteem kunnen andere gebruikers het script vervolgens direct installeren vanuit de Scriptbibliotheek.
–> Klik hier voor meer informatie over het delen van scripts met de community
#
Veelgestelde vragen #
De website werkt niet meer na een tijdje. Wat nu?
Websites veranderen soms hun opmaak. Ga naar de Scriptbibliotheek, open het script en klik op Bewerken om de selectors opnieuw in te stellen.
Het script slaat elementen over of gaat te snel. Wat doe ik?
Voeg een Wachten (seconden)-element toe op de juiste positie in de lijst. Dit geeft de website extra tijd om te laden voordat VerzamelSysteem doorgaat naar de volgende stap.
De website detecteert dat het geen echte gebruiker is. Wat doe ik?
Probeer bij het gebruikersnaam- en wachtwoordveld de invulmethode te wijzigen van Invullen naar Typen. Dit imiteert menselijk typgedrag en helpt bij websites die botdetectie gebruiken. Schakel ook de Snelle modus uit als die aan staat.
Mijn website gebruikt een authenticator-app voor 2FA. Werkt dat ook?
Ja. Stel de 2FA-methode in op “Authenticator App” bij de scriptinstellingen en configureer de bijbehorende authenticator in de instellingen van VerzamelSysteem. Het systeem genereert dan automatisch de benodigde code.
Hoe weet ik of mijn script correct werkt?
Je kunt dit testen door de website toe te voegen aan jouw VerzamelSysteem groep en facturen proberen op te halen. Gebruik bij problemen de debugmodus of live preview modus om te zien waar het eventueel misgaat.