De factuurregels van 31 landen, in je AI-assistent.
Btw-tarieven, e-facturatieplichten, formaten en verplichte velden voor de EU-27 plus het VK, Noorwegen, Zwitserland en IJsland. Eén installatie, en je assistent antwoordt uit de regels in plaats van uit zijn geheugen.
Productgegevens
- Type
- Open source · MIT
- Status
- Beta · sinds 2026
- Werkt in
- Claude · Cursor · VS Code
- Stack
- Node · TypeScript
- Links
- GitHub npm euinvoice.dev
- Installatie
-
npx euinvoice-mcp
Waarom het bestaat
Europees factureren is versnipperd. Elk land heeft eigen btw-tarieven, eigen e-facturatieplichten, eigen formaten en eigen verplichte velden. Duitsland wil XRechnung, Italië alles via SDI, Polen via KSeF, en de kennis van een taalmodel loopt daar altijd een paar wijzigingen achteraan.
Ik bouw koppelstukken tussen AI-assistenten en bedrijfssoftware, en factureren is precies zo'n plek waar een assistent zeker moet weten in plaats van gokken. Deze server is de gestructureerde kennis achter zo'n koppelstuk. Open source, zodat je de regels en de randgevallen zelf kunt nakijken.
Zo werkt het
Eén vraag, het juiste antwoord.
Geen zoektocht langs belastingsites. Je beschrijft de situatie, de assistent haalt de regels uit de server en antwoordt met tarief, formaat en verplichte velden.
Ik verkoop software vanuit Nederland aan een bedrijf in Duitsland. Welke btw reken ik, en hoe moet de factuur eruitzien?
Btw verleggen. Je rekent 0% en zet de verlegging op de factuur; de klant in Duitsland geeft de btw zelf aan.
- Btw: verlegd, artikel 196 btw-richtlijn
- Op de factuur: beide btw-nummers en de vermelding "btw verlegd"
- Formaat: XRechnung 3.0 of ZUGFeRD/Factur-X; Peppol BIS 3.0 kan ook
- Let op: Duitse bedrijven moeten sinds 1 januari 2025 e-facturen kunnen ontvangen
Wil je de verplichte velden voor deze factuur erbij?
Ja, en vergelijk het met België.
België verplicht e-facturatie tussen bedrijven via Peppol vanaf 1 januari 2026. Duitsland moet sinds 2025 kunnen ontvangen en vanaf 2027 verzenden. De velden voor je Duitse factuur staan hieronder.
Wat het doet
Tarieven
Btw-tarieven en OSS
Standaard-, verlaagde, sterk verlaagde en parkeertarieven per land, of alle standaardtarieven naast elkaar. Plus de drempels en regels van de One-Stop Shop voor B2C over de grens.
- get_vat_rates
- list_vat_rates
- get_oss_rules
Plichten
E-facturatie en verlegging
Welke mandaten per land gelden voor B2G, B2B en B2C, via welk systeem en vanaf wanneer. En wanneer je btw verlegt en wat je dan op de factuur zet.
- get_einvoicing_requirements
- get_b2b_mandate_status
- get_reverse_charge_rules
Formaten
Formaten en verplichte velden
UBL, CII, Factur-X, XRechnung, FatturaPA en Peppol BIS: wat het is en waar het geldt. De verplichte velden per land en transactietype, EN 16931 met de nationale uitbreidingen, en twee landen naast elkaar.
- get_invoice_format
- validate_invoice_fields
- get_en16931_info
- compare_countries
Wanneer wordt het verplicht
Elk land zijn eigen datum, eigen systeem.
Dit is het soort antwoord dat de server geeft: per land het systeem, het formaat en de datum waarop e-facturatie tussen bedrijven verplicht is. Zes van de 31 landen, als voorproefje.
Installeren
Eén blok in je configuratie, en klaar.
Geen account, geen cloud. De server start via npx zodra je assistent hem nodig heeft, en draait op je eigen machine.
-
Kies je assistent
Claude Desktop, Cursor of VS Code. Elke client die MCP spreekt werkt.
-
Plak het blok hiernaast
In het configuratiebestand van je assistent. Voor Cursor en VS Code zonder de buitenste mcpServers-laag.
-
Herstart en stel je vraag
Dat is alles. Begin met "Wat zijn de btw-tarieven in Duitsland?"
claude_desktop_config.json
{
"mcpServers": {
"euinvoice": {
"command": "npx",
"args": ["-y", "euinvoice-mcp"]
}
}
}
MCP-instellingen van Cursor of VS Code
{
"euinvoice": {
"command": "npx",
"args": ["-y", "euinvoice-mcp"]
}
}
Wat je kunt vragen
Gewone zinnen, precieze antwoorden.
Je hoeft geen toolnamen te kennen. Dit zijn vragen die je letterlijk zo stelt.
-
“Wat zijn de btw-tarieven in Duitsland?”
-
“Welk e-factuurformaat heb ik nodig voor facturen aan de overheid in Italië?”
-
“Vergelijk de factuureisen van Frankrijk en Duitsland.”
-
“Wanneer start de B2B-e-facturatieplicht in Polen?”
-
“Welke velden zijn verplicht op een factuur aan een klant in Spanje?”
-
“Leg de verleggingsregeling uit voor B2B-diensten binnen de EU.”
Wat eraan komtFactuur genereren en XML valideren staan op de roadmap. Versie 0.2 maakt UBL 2.1 en CII uit gestructureerde invoer, 0.3 valideert bestaande bestanden tegen EN 16931. Tot die tijd is dit een naslagserver, geen generator.
Bekijk de roadmap
Wat is MCPEen open standaard waarmee AI-assistenten tools gebruiken. Zie het als een stekker: je installeert één server en elke assistent die MCP spreekt kan ermee werken. Dezelfde techniek bouw ik voor organisaties op hun eigen systeem.
Bekijk Het KoppelstukZelf gebouwd, zelf in productie.
Wat ik hier voor mezelf bouw, bouw ik ook voor organisaties die AI verder willen brengen dan de pilot.