SnelUBL documentatie

Laatst gecontroleerd: 23 juni 2026.

SnelUBL zet PDF-, DOCX- en afbeeldingsfacturen om naar UBL XML. De documentatie hieronder beschrijft de huidige werking van Quick Mode, Workflows, proefconversies en lokale opslag in de browser.

Account en gratis proefconversies

• U kunt een account aanmaken met alleen een e-mailadres en wachtwoord.
• Nieuwe gebruikers kunnen de eerste 3 conversies gratis uitvoeren zonder vooraf betaalgegevens toe te voegen.
• Als de gratis conversies op zijn, opent SnelUBL de upgradeflow. Daar vult u organisatiegegevens aan en voegt u betaalinformatie toe voordat u verder converteert.
• Heeft u al een organisatie met betaalinformatie, dan werkt SnelUBL direct met die organisatie.

Bestanden en limieten

SnelUBL ondersteunt PDF, DOCX, PNG, JPEG, HEIF/HEIC en WebP. Uploads mogen maximaal 3 MB per bestand zijn voordat ze worden verwerkt. Tijdens voorbereiding kan SnelUBL bestanden comprimeren of beperken zodat ze geschikt blijven voor conversie.

Bij PDF- en DOCX-bestanden met meerdere pagina's verwerkt SnelUBL de eerste 2 pagina's als factuurbron. Lever daarom bij voorkeur één factuur per bestand aan. Voor gescande batches blijft splitsen per factuur de veiligste werkwijze.

Quick Mode

Quick Mode is bedoeld voor losse conversies.

1. Kies de organisatie waarvoor u de conversie wilt boeken.
2. Sleep een ondersteund bestand naar het uploadvak of kies een bestand via de knop.
3. SnelUBL slaat de originele previewbron lokaal op in IndexedDB en start daarna de conversie via de HTTP API.
4. De achtergrondverwerker blijft de status ophalen, ook wanneer u naar een andere pagina gaat.
5. Na voltooiing kunt u de UBL downloaden of de preview openen.

Workflows

Workflows verwerken facturen automatisch via een workflowconfiguratie, bijvoorbeeld via e-mail of een handmatige dropzone binnen de workflowpagina.

• Een workflow hoort bij een organisatie.
• Een upload via de workflowdropzone start een HTTP-keten en wordt daarna gepolld tot er een resultaat is.
• Originele previewdata en verwerkingsresultaten worden lokaal in IndexedDB bewaard zodat preview en download na navigatie of herladen kunnen blijven werken.
• Statusrijen bewaren alleen lichte metadata in localStorage, zoals bestandsnaam, status en stabiele ID's.

Resultaten, preview en opslag

SnelUBL gebruikt IndexedDB in uw browser voor grote lokale gegevens zoals originele previewbestanden en verwerkingsresultaten. localStorage wordt alleen gebruikt voor lichte statusmetadata. Als u browserdata wist, kan een oude preview of download lokaal niet meer beschikbaar zijn.

Controleer de geconverteerde UBL altijd voordat u deze in uw administratie gebruikt. SnelUBL helpt bij automatisering, maar vervangt geen eigen controle, juridisch advies of fiscaal advies.

Integraties

Workflows kunnen resultaten afleveren via beschikbare bestemmingen zoals e-mail, cloudopslag of boekhoudkoppelingen die in uw omgeving zijn geactiveerd. Cloudkoppelingen gebruiken OAuth/PKCE en tokens worden via de backend beheerd.

Problemen oplossen

• Geen organisatie zichtbaar: vernieuw de pagina nadat u bent ingelogd, of controleer of uw account een proeforganisatie of betaalde organisatie heeft.
• Limiet bereikt: rond de upgradeflow af met organisatie- en betaalgegevens.
• Preview ontbreekt na herladen: de lokale IndexedDB-vermelding kan zijn gewist of niet beschikbaar zijn in deze browser.
• Bestand te groot: verklein het bestand of lever de eerste factuurpagina's als afzonderlijk bestand aan.

Meer achtergrond: kennisbank over UBL en e-factureren.