Documenten lezen met een bestandssjabloonintegratie
Leer Transportial waar waarden staan in een documentopmaak, zoals een orderformulier van een klant, zodat bestanden in die opmaak automatisch worden gelezen.
Bijgewerkt 4 oktober 2026
Veel klanten sturen orders als pdf-, Word- of Excel-bestanden die er altijd hetzelfde uitzien. Een bestandssjabloonintegratie beschrijft die opmaak één keer: welke waarde waar staat, en welk Transportial-veld hij vult. Bestanden in dezelfde opmaak kunnen dan automatisch worden gelezen, bijvoorbeeld als je een order aanmaakt vanuit een bestand.
Voordat je begint
- Zorg voor een voorbeeldbestand in de opmaak die je wilt lezen. Ondersteunde bestanden zijn onder meer pdf, Word, Excel, CSV, XML en afbeeldingen.
Het sjabloon aanmaken
- Open het zijmenu (☰, rechtsboven), kies Integraties en klik op + Integratie aanmaken.
- Vul een Naam in, bijvoorbeeld de klant en de naam van het document.
- Kies bij Selecteer integratietype de optie Integratie via bestandssjabloon. Het paneel wordt breder.
- Kies bij Selecteer entiteit wat het bestand aanmaakt, meestal een transportorder.
- Sleep je voorbeeldbestand naar het uploadvak, of klik erop om het bestand te kiezen.
- Klik voor elke waarde die je wilt lezen op + Veld toevoegen.
- Stel elk veld in (zie hieronder).
- Klik op Testen en controleer het resultaat.
- Zet Uit/Aan op aan en klik op Opslaan.
Een veld instellen
- Selecteer selectortype: hoe de waarde wordt gevonden.
- HTML: de waarde wordt gevonden in de tekststructuur van het document.
- Matrix: de waarde staat op een positie in het raster van de pagina.
- Variabele tekstpositie: de waarde wordt gevonden ten opzichte van een label, bijvoorbeeld de tekst rechts van "Leverdatum". Gebruik Boven, Rechts, Onder en de optie voor links om aan te geven waar.
- Selector: waar naar gezocht wordt.
- JSON mapping: het Transportial-veld waar de waarde in komt.
- Selecteer veldtype, Formaat en Regex: lees datums en getallen correct en haal een deel uit een tekst.
De tabbladen Matrix en HTML naast de velden laten zien hoe Transportial je voorbeeldbestand ziet en markeren wat je selectors vinden. Gebruik ze om posities bij te stellen. Zet JSON-modus aan om alle velden als tekst te bewerken.
Markeer het veld dat de order identificeert (bijvoorbeeld het ordernummer van de klant) met Identificatie, zodat een verbeterd bestand de order bijwerkt in plaats van een tweede aan te maken.
Het sjabloon gebruiken
Als je een order aanmaakt vanuit een bestand, gebruikt Transportial je sjabloon om de order in te vullen. Zie Een transportorder importeren vanuit een bestand.