Placeholders
Leer hoe je placeholders in een PDF gebruikt, zodat Legalsign de ondertekenvelden automatisch op de juiste plek zet, zowel via de webversie als via de API.
Met placeholders in je PDF-documenten komen de Legalsign-velden automatisch op de juiste plek te staan voor de ondertekenaars. Je gebruikt ze om documenten snel voor te bereiden voordat je ze ter ondertekening aanbiedt.
Wat zijn placeholders?
Binnen Legalsign kun je PDF-documenten voorzien van speciale placeholders voordat je ze verstuurt voor ondertekening. Een placeholder werkt als een vooraf gedefinieerd gebied waar het ondertekeningsveld automatisch wordt geplaatst zodra je het document uploadt in Legalsign.
Met placeholders bereid je documenten snel en efficiënt voor op elektronische ondertekening, zowel handmatig als via de API van Legalsign. Zo staat elk ondertekeningsveld nauwkeurig op de juiste plek en wordt alle relevante informatie correct weergegeven en ingevuld.
Opbouw van een placeholder
Een placeholder in Legalsign bestaat uit meerdere segmenten. Je scheidt de segmenten met een dubbele punt.
#LSF:1:SIGNATURE:20:5#
De segmenten hebben de volgende betekenis:
| Segment | Voorbeeld | Betekenis |
|---|---|---|
| Prefix | LSF | Vaste prefix. Staat voor 'Legalsign Field'. |
| Positie | 1 | De positie in de lijst van toegevoegde contacten. |
| Type | SIGNATURE | Het type veld dat op deze plaats moet komen. |
| Breedte | 20 | Optioneel. De breedte van het veld, uitgedrukt in procenten ten opzichte van de pagina. |
| Hoogte | 5 | Optioneel. De hoogte van het veld, uitgedrukt in procenten ten opzichte van de pagina. |
[!TIP] In de meeste gevallen hoef je de breedte en hoogte van het veld niet op te geven. Legalsign berekent deze automatisch op basis van de breedte van de placeholder en een gemiddelde hoogte. Bijvoorbeeld: #LSF:1:SIGNATURE#
Beschikbare veldtypen
Voor het type-segment kun je de volgende waarden gebruiken:
| Type | Betekenis |
|---|---|
| SIGNATURE | Een veld waarin een handtekening geplaatst kan worden. |
| STAMP | Een veld waarin een stempel geplaatst kan worden die de ondertekenaar identificeert. |
| DATE | Een veld waarin een datum vrij ingevuld kan worden. |
| CURRENT_DATE | Vult bij het ondertekenen automatisch de huidige datum in. |
| TEXT | Een vrij in te vullen tekstveld. |
| TEXT_MULTILINE | Een vrij in te vullen tekstveld dat meerdere regels kan bevatten. |
| FIRST_NAME | Vult de voornaam van het ondertekenende contact in. |
| LAST_NAME | Vult de achternaam van het ondertekenende contact in. |
| FULL_NAME | Combineert de voor- en achternaam van het ondertekenende contact en vult deze in. |
Werkwijze webversie
Als maker van het ondertekenverzoek werk je als volgt:
- Upload een PDF-document met de juiste placeholders in Legalsign.
- Voeg de ondertekenaars toe in de juiste volgorde.
Legalsign genereert de velden daarna automatisch op de plek van de placeholders, conform de opgegeven specificaties.
Werkwijze API
Wanneer je een document via de Legalsign API aanbiedt, zijn de ondertekenende contacten vooraf bekend. Op basis van deze informatie maakt Legalsign de ondertekenvelden direct aan op de plekken van de gedetecteerde placeholders in het document.
Meer informatie in de video
Meer informatie over de werking van placeholders vind je in onderstaande video.
Laatst bijgewerkt op