Vink — lichtgewicht ZZP-administratie met Claude Code
English: Vink is a Claude Code plugin for Dutch freelancers (ZZP'ers): invoices, receipts,
quarterly VAT returns and year-end figures, kept as plain CSV/JSON files in your own folder. The
skills decide what to record; a deterministic Node CLI does the invoice numbering, VAT math,
currency conversion and PDF rendering. Docs and skills are in Dutch; invoices and the dashboard
render in Dutch or English.
Een lichtgewicht administratie voor Nederlandse ZZP'ers/freelancers, volledig op platte
bestanden (CSV + JSON) en aangedreven door Claude Code.
Je praat in gewone taal ("maak een factuur voor klant X", "verwerk deze bon"); de skills
redeneren en stellen voor, en een klein deterministisch programma (lib/admin.mjs) doet het
exacte rekenwerk en schrijft naar de bestanden.
Kernprincipe: AI bepaalt WAT, deterministische code bepaalt HOE. Factuurnummers,
BTW-berekening, koersconversie en PDF-generatie lopen nooit "uit het hoofd" van de AI, maar
altijd via code. Zo blijft de administratie reproduceerbaar en controleerbaar.
Deze repo is een Claude Code plugin: hij levert alléén de skills + code. Jouw administratie
(facturen, bonnen, CSV's) blijft in je eigen map staan — die bezit je zelf, kun je backuppen,
en blijft staan als de plugin een update krijgt.
Wat kun je ermee?
| Commando | Wat het doet |
|---|
/setup-vink | Eenmalige onboarding: je map initialiseren + bedrijfsgegevens en standaard betaaltermijn instellen. |
/factuur | Een verkoopfactuur maken (omzet). Vult tarief/omschrijving aan op basis van eerdere facturen, kent het juiste oplopende factuurnummer toe en genereert een PDF. |
/zelffactuur | Een factuur importeren die je opdrachtgever namens jou maakte (self-billing). Telt óók als omzet. |
/bon | Een bon of inkoopfactuur als kostenpost verwerken. Classificeert de BTW (aftrekbaar / verlegd / niet-aftrekbaar) en rekent vreemde valuta om op de ECB-dagkoers. |
/betaald | Een verkoopfactuur op betaald zetten (status + betaaldatum). |
/aangifte | Een kwartaal-BTW-overzicht samenstellen (rubrieken 1a t/m 5g + ICP-opgaaf) ter voorbereiding van je aangifte. |
/dashboard | Een HTML-dashboard met de stand van zaken: openstaande facturen (met dagen te laat/over datum), omzet en kosten van dit jaar en per kwartaal, en de eerstvolgende aangifte-deadline. |
/jaaropgave | Je jaarcijfers ter voorbereiding van de aangifte inkomstenbelasting: winst-en-verliesrekening, afschrijvingen, KIA, ondernemersaftrek en MKB-winstvrijstelling tot de belastbare winst, plus BTW-jaaroverzicht en balansposten. |
In het slash-menu heten de skills vink:factuur, vink:bon, enz. (de plugin-naam is de
prefix). De korte vorm /factuur werkt ook gewoon — Claude herkent de bedoeling, ook midden in
een zin.
⚠️ Dit is een voorbereidend hulpmiddel. De skills berekenen en ordenen; de daadwerkelijke
aangiftes (BTW en inkomstenbelasting) dien je zelf in bij de Belastingdienst. Geen vervanging voor een
boekhouder of fiscaal advies — controleer de uitkomsten.
Vereisten
Installeren (voor gebruikers)
Eenmalig, in Claude Code:
/plugin marketplace add mathijs-oord/vink-plugin
/plugin install vink@vink-plugin
Daarna:
- Maak (of kies) een map voor je administratie, bv.
~/Administratie, en open die map in
Claude Code (cd ~/Administratie en start Claude Code daar). Hier komt jouw data te staan.
- Typ
/setup-vink. Dat zet bij eerste gebruik de lege templates klaar in je map (data/-CSV's,
business.example.json, een project-CLAUDE.md en de uitvoer-mappen) en vraagt vervolgens je
bedrijfsgegevens (naam, adres, KvK, BTW-id, IBAN) + standaard betaaltermijn.
- Probeer het uit, bijvoorbeeld:
/factuur → "Maak een factuur voor Acme B.V., 20 uur consultancy à €100."/bon → "Verwerk deze bon" (+ pad naar een PDF/foto)./aangifte → "Stel de aangifte voor dit kwartaal samen."
Werk je voor meerdere administraties? Maak per administratie een aparte map en draai /setup-vink in
elk. De plugin is overal beschikbaar; de data blijft per map gescheiden.
Updates ontvangen
Bij third-party marketplaces staat auto-update standaard uit. Twee opties:
Updates raken alleen de plugin-code/skills/regels — nooit je data. Je data/, facturen/,
bonnen/, aangiftes/ en jaaropgaven/ blijven onaangeroerd.
Hoe het is opgebouwd
De plugin (deze repo — wordt geüpdatet):
This is the beginning of the README. Read the rest at the original. Read the full README ↗
