agentleFS
mathijs-oordmathijs-oord/vink-plugin/skills/betaald/SKILL.md

betaald

Skill6 starsChanged 2 days agoMITView on GitHub

Zet een verkoopfactuur op betaald — werkt voor zowel zelf-gemaakte facturen (/factuur) als geïmporteerde zelffacturen (/zelffactuur). Zet status op `paid` en legt de betaaldatum vast in `paid_at`. Verandert niets aan de BTW-aangifte (sent én paid tellen al mee).

The file

Files
SKILL.md

Factuur op betaald zetten

De gebruiker meldt dat een verkoopfactuur betaald is. Zet de status op paid en leg de betaaldatum vast in de kolom paid_at. Geldt voor alle rijen in data/invoices.csv — zowel source=created (zelf gemaakt) als source=imported / self-billing.

Het rekenwerk en de veilige rij-herschrijving doet admin.mjs (principe: AI bepaalt WAT, code bepaalt HOE). Nooit zelf de CSV bewerken — altijd via het commando hieronder.

Stappen

1. Bepaal welke factuur

  • De gebruiker geeft meestal een factuurnummer (bv. 2026-0006 of IRB172600063).
  • Geen of onduidelijk nummer? Lees data/invoices.csv en toon de openstaande facturen (status = sent, dus nog niet paid): nummer, klant, totaal, datum. Vraag welke. Match desnoods fuzzy op klantnaam/bedrag/maand als de gebruiker dat noemt.
  • Controleer dat het nummer bestaat in data/invoices.csv. Niet gevonden → meld het en stop (geef de dichtstbijzijnde matches als hint).
  • Staat de factuur al op paid? Meld de bestaande paid_at en vraag of die overschreven moet worden voordat je doorgaat.

2. Bepaal de betaaldatum

  • Gebruiker geeft een datum → gebruik die (formaat YYYY-MM-DD; reken een vorm als "10 juni" / "10-06-2026" om naar 2026-06-10).
  • Geen datum opgegeven → vandaag (dat is de default van het commando).

3. Zet op betaald

node "${CLAUDE_PLUGIN_ROOT}/lib/admin.mjs" mark-paid <factuurnummer> [YYYY-MM-DD]
  • Zonder datum-argument → paid_at wordt vandaag.
  • Het commando voegt de paid_at-kolom toe als die nog niet bestaat, zet status=paid en herschrijft invoices.csv atomisch. Het print het resultaat terug (incl. was_already_paid).

4. Meld kort

Nummer, klant, totaal en de vastgelegde paid_at. Bij meerdere facturen: per stuk een regel.

Belangrijk

  • Alleen status + betaaldatum — bedragen, BTW, regels of paden raak je niet aan.
  • Geen effect op /aangifte: zowel sent als paid tellen al mee in de BTW-aangifte; paid_at is puur administratief (cashflow/debiteurenbewaking).
  • Een betaling terugdraaien (paid → sent) of een verkeerde paid_at corrigeren: met de hand in invoices.csv (bewuste keuze — de skill zet alleen op betaald).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.