Manager.VAT โ Custom Fields
Welke velden je in Manager.io moet aanmaken (Klanten & Leveranciers) โ Manager.VAT leest alleen, wijzigt niets.
1. Eerst kiezen: Nederlands of Engels
Kies รฉรฉn taal voor alle 7 velden hieronder en houd die overal aan (ook bij Customers รฉn Suppliers). Mixen mag niet: dus of alles Nederlands (kolom NL), of alles Engels (kolom EN).
Waarom รฉรฉn taal? Manager.VAT herkent de velden straks automatisch op naam. Eรฉn taal per administratie voorkomt dubbele of missende koppelingen (bijv. BTW no รฉn VAT no tegelijk aanmaken โ niet doen).
2. De 7 velden โ maak ze exact zo
Maak deze velden aan in Manager.io onder Settings → Custom Fields, zowel bij Customers als bij Suppliers (zelfde 7 namen, in de gekozen taal).
| # | Nederlands (NL) | Engels (EN) | Type |
| 1 | Rekening no | Account no | Tekst (plain text) |
| 2 | BTW no | VAT no | Tekst (plain text) |
| 3 | KvK no | CoC no | Tekst (plain text) |
| 4 | Peppol ID | Peppol ID | Tekst (plain text) |
| 5 | BTW nummer gecontroleerd | VAT number checked | Checkbox (vinkje) |
| 6 | KvK nummer gecontroleerd | CoC number checked | Checkbox (vinkje) |
| 7 | Peppol gecontroleerd | Peppol checked | Checkbox (vinkje) |
- Per veld: New Custom Field → Name exact als in de tabel (gekozen taal) → Type als in de tabel.
- Weergave-opties (op documenten tonen) uit laten โ de velden zijn alleen voor de app/API nodig.
- Save. Herhaal voor alle 7 velden bij Customers, daarna exact hetzelfde bij Suppliers.
Vinkjes worden handmatig gezet. Manager.VAT is read-only en vinkt niets zelf aan: na een succesvolle controle zet je het vinkje zelf in Manager.io en klik je op de detailpagina op Verversen. De app toont het daarna als Gecontroleerd.
Bestaande namen mogen afwijken: heet het vinkje in je administratie al Peppol ID gecontroleerd? Dat mag โ de app herkent zowel Peppol gecontroleerd als Peppol ID gecontroleerd. Het tekstveld mag ook Peppol # heten.
3. Daarna: automatisch koppelen
Zodra de 7 velden bestaan, koppelt Manager.VAT ze automatisch op naam (Setup → Velden automatisch zoeken of bij het starten). Je hoeft geen UUID's over te typen โ de app vult de keys zelf in api_config.json onder fields in.
Herstart na wijzigen: stop en start de server opnieuw (stop-manager-vat.bat / start-manager-vat.bat), klik daarna in de app op Vernieuwen.
Komt een veld niet door? Controleer: (1) naam exact als in de tabel, (2) juiste taal overal, (3) juiste type (tekst vs. checkbox), (4) aangemaakt bij zowel Customers als Suppliers. Lukt het nog niet, zoek de Key handmatig op (veld openen bij Settings → Custom Fields) โ of lees hem af met Manager.UUID โ en plak hem in api_config.json.
Meerdere Peppol-velden? Bestaan er zowel Peppol # als Peppol ID, kies dan bij het koppelen het veld waar je ID's daadwerkelijk in staan. De app markeert dat als dubbel en laat jou kiezen; hij raadt niet.
4. Controleren of het werkt
- Vul bij een test-klant het BTW/VAT-veld in (bijv.
NL123456789B01) en klik in de app op Bekijken → Controleer BTW.
- Verschijnt het nummer op de detailpagina, dan leest de app het veld (koppeling klopt).
- Blijft een veld leeg terwijl het in Manager.io wel gevuld is, dan klopt de koppeling niet โ zie ยง3.
Uitgebreide uitleg per controle: zie handleiding.html (ยง7โยง10).
Manager.VAT โ Custom Fields (Klanten & Leveranciers) โ kies NL of EN
Manager.VAT โ Custom Fields
Which fields to create in Manager.io (Customers & Suppliers) โ Manager.VAT only reads, never changes anything.
1. First choose: Dutch or English
Choose one language for all 7 fields below and use it everywhere (including Customers and Suppliers). Do not mix: either all Dutch (NL column) or all English (EN column).
Why one language? Manager.VAT will soon recognize the fields automatically by name. One language per business prevents duplicate or missing links (e.g. creating both BTW no and VAT no โ don't).
2. The 7 fields โ create them exactly like this
Create these fields in Manager.io under Settings → Custom Fields, under both Customers and Suppliers (same 7 names, in the chosen language).
| # | Dutch (NL) | English (EN) | Type |
| 1 | Rekening no | Account no | Text (plain text) |
| 2 | BTW no | VAT no | Text (plain text) |
| 3 | KvK no | CoC no | Text (plain text) |
| 4 | Peppol ID | Peppol ID | Text (plain text) |
| 5 | BTW nummer gecontroleerd | VAT number checked | Checkbox |
| 6 | KvK nummer gecontroleerd | CoC number checked | Checkbox |
| 7 | Peppol gecontroleerd | Peppol checked | Checkbox |
- Per field: New Custom Field → Name exactly as in the table (chosen language) → Type as in the table.
- Leave display options (show on documents) off โ the fields are only needed for the app/API.
- Save. Repeat for all 7 fields under Customers, then exactly the same under Suppliers.
Checkboxes are set manually. Manager.VAT is read-only and never ticks anything itself: after a successful check, tick the box yourself in Manager.io and click Verversen (Refresh) on the detail page. The app then shows it as Checked.
Existing names may differ: is the tick already called Peppol ID checked in your administration? That is fine โ the app recognises both Peppol checked and Peppol ID checked. The text field may also be called Peppol #.
3. Then: link automatically
Once the 7 fields exist, Manager.VAT links them automatically by name (Setup → Find fields automatically or at startup). No need to copy UUIDs โ the app fills the keys itself in api_config.json under fields.
Restart after changes: stop and restart the server (stop-manager-vat.bat / start-manager-vat.bat), then click Refresh in the app.
Field not coming through? Check: (1) name exactly as in the table, (2) same language everywhere, (3) correct type (text vs. checkbox), (4) created under both Customers and Suppliers. Still stuck? Look up the Key manually (open the field under Settings → Custom Fields) โ or read it with Manager.UUID โ and paste it into api_config.json.
Multiple Peppol fields? If both Peppol # and Peppol ID exist, choose the field that actually contains your IDs when linking. The app marks this as ambiguous and lets you choose; it will not guess.
4. Check that it works
- Fill in the VAT field for a test customer (e.g.
NL123456789B01) and click View → Check VAT in the app.
- If the number appears on the detail page, the app reads the field (link OK).
- If a field stays empty while filled in Manager.io, the link is wrong โ see ยง3.
Details per check: see handleiding.html (ยง7โยง10).
Manager.VAT โ Custom Fields (Customers & Suppliers) โ choose NL or EN