Wat zijn website scripts? #
Website scripts zijn bestanden die VerzamelSysteem gebruikt om een connectie te maken met een website om zo de facturen van te kunnen downloaden. Deze scripts kun je downloaden vanuit de “Script Bibliotheek” voordat je ze kan gebruiken in VerzamelSysteem. De scripts die in de bibliotheek staan zijn gemaakt door VerzamelSysteem of gedeeld door andere VerzamelSysteem gebruikers (welke zij zelf hebben gemaakt met behulp van de Script Wizard). Alle scripts worden gecontroleerd door de ontwikkelaars van VerzamelSysteem voordat zij ter beschikking worden gesteld in de bibliotheek.
Script Bibliotheek #
De “Script Bibliotheek” is het centrale overzicht van alle scripts waarmee VerzamelSysteem facturen kan ophalen van websites. De bibliotheek kun je terugvinden als submenu van de pagina “Websites”, en deze bestaat uit 2 secties:
– Mijn aangepaste scripts: Scripts die je zelf hebt aangemaakt met de Script Wizard, of
die je hebt gedownload uit de community.
– Community scripts: Scripts die door VerzamelSysteem-ontwikkelaars of andere VerzamelSysteem-gebruikers zijn gedeeld.
Je kunt deze downloaden en direct gebruiken.
Daarnaast is er in de rechterbovenhoek ook een knop “Nieuw script maken” waarmee je zelf website scripts kunt toevoegen met behulp van de Script Wizard. De Script Wizard zal geopend worden wanneer je op de knop klikt.
Eigen script maken met Script Wizard #
De Script Wizard is een stap-voor-stap hulpmiddel waarmee je aangepaste scripts kunt maken voor het automatisch ophalen van facturen van websites. Met de wizard kun je VerzamelSysteem leren hoe het moet inloggen op een website, waar de facturen staan, en hoe deze gedownload moeten worden.
Er zijn drie methoden beschikbaar om facturen te verzamelen:
- 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
Elke methode heeft zijn eigen wizard met specifieke stappen. Welke methode gebruikt wordt is afhankelijk van de website waar je een script voor gaat maken.
Methode 1 – Browser Modus #
De browser modus simuleert een echte gebruiker: het opent een browser, logt in met je gegevens, navigeert naar de factuurpagina en downloadt de bestanden. Je wijst de wizard de juiste elementen aan op de pagina (knoppen, invoervelden, links).
Wanneer gebruiken:
– De website heeft geen publieke API beschikbaar om facturen mee te downloaden
– Je wilt facturen downloaden als PDF of screenshot
– De website vereist complexe interactie (cookie popups, 2FA, etc.)
Voordelen: Werkt met vrijwel elke website (wanneer er geen antibot protectie aanwezig is)
Nadelen: Gegenereerde script kan breken als de website wijzigt en moet dan worden aangepast + langzamer dan bijvoorbeeld een API verbinding.
>> Klik hier voor een handleiding van de Browser Modus
Methode 2 – Interne API #
Veel websites laden hun factuurgegevens via verborgen API-calls. De wizard detecteert deze automatisch terwijl je door de website navigeert. Het script gebruikt dan dezelfde API-calls om facturen op te halen, zonder dat het de pagina hoeft te scrapen.
Wanneer gebruiken:
– De wizard detecteert automatisch een interne API op de website
– Je wilt een betrouwbaarder script dan browser modus
– Er is geen publieke API beschikbaar
Voordelen: Betrouwbaarder, sneller, minder gevoelig voor website-wijzigingen
Nadelen: Niet altijd beschikbaar, vereist om eerst in te loggen met behulp van de browser
>> Klik hier voor een handleiding van de Interne API Modus
Methode 3 – Publieke API #
Sommige websites bieden een officieel gedocumenteerde REST API aan waarmee je facturen kunt ophalen met een API-sleutel. De wizard helpt je om de API te configureren, velden te mappen en een script te genereren.
Wanneer gebruiken:
– De dienst biedt een publieke API aan (bijv. boekhoudsoftware, hosting providers, SaaS-diensten)
– Je hebt een API-sleutel of access token
Voordelen: Meest betrouwbaar, snelst, officieel ondersteund
Nadelen: Alleen beschikbaar als de dienst een API aanbiedt voor facturen (blijkt nogal zeldzaam)
>> Klik hier voor een handleiding van de Publieke API Modus