# Zoek Belastingkenmerk

> Gratis tool en API die een Nederlands Belastingdienst **betalingskenmerk** (16 cijfers) omzet naar het onderliggende **aanslagnummer** — en andersom. De omzetting volgt de officiële specificatie "Betalingskenmerk bepaling v1.5". Geen account, geen API-sleutel, CORS aan. Antwoorden worden aan de edge gecachet (Cloudflare Workers).

Belangrijk om te weten:

- Een betalingskenmerk bestaat altijd uit **16 cijfers**. Positie 1 is een modulus-11 controlegetal (elfproef); positie 2–9 (deel van) het BSN/RSIN; positie 10–11 de middelcode (belastingsoort); positie 12–16 jaar, tijdvak en volgnummer.
- Een aanslagnummer bestaat uit **9 cijfers + 1 letter + 7 cijfers** (bijv. `036000012L0123110`).
- De omzetting gebeurt volledig client-side in de browser én identiek in de API (dezelfde module `core.mjs`). Er worden geen persoonsgegevens opgeslagen of gelogd.
- Dit is een **onafhankelijke** tool, geen officiële dienst van de Belastingdienst. Aan de uitkomst kunnen geen rechten worden ontleend.
- Een klein deel van de aanslagen (sommige milieuheffingen, conserverende aanslagen) krijgt een willekeurig kenmerk dat niet met een formule te herleiden is; het controlegetal is dan wél te valideren.

## API (gratis, geen sleutel, CORS, JSON)

- [API-overzicht](https://zoek-belastingkenmerk.nl/api/v1): machine-leesbare beschrijving van alle endpoints.
- [OpenAPI 3.1 specificatie](https://zoek-belastingkenmerk.nl/openapi.json): volledige schema-definitie voor tools/agents.
- [GET /api/v1/convert?q={invoer}&lang=nl|en](https://zoek-belastingkenmerk.nl/api/v1/convert?q=2036000016301110): auto-detecteert richting (letters → encode aanslagnummer, cijfers → decode betalingskenmerk).
- [GET /api/v1/decode?kenmerk={16 cijfers}&lang=nl|en](https://zoek-belastingkenmerk.nl/api/v1/decode?kenmerk=2036000016301110): decodeer een betalingskenmerk naar BSN/RSIN, belastingsoort, jaar en tijdvak.
- [GET /api/v1/encode?aanslag={aanslagnummer}](https://zoek-belastingkenmerk.nl/api/v1/encode?aanslag=036000012L0123110): bouw het 16-cijferige betalingskenmerk voor een aanslagnummer.
- [GET /api/v1/validate?kenmerk={16 cijfers}](https://zoek-belastingkenmerk.nl/api/v1/validate?kenmerk=2036000016301110): controleer alleen of het controlegetal (elfproef) klopt.

## Documentatie en uitleg

Elke blogpagina is ook als schone Markdown beschikbaar: voeg `.md` toe aan de URL (bijv. `/blog/wat-is-een-betalingskenmerk.md`).

- [Wat is een betalingskenmerk?](https://zoek-belastingkenmerk.nl/blog/wat-is-een-betalingskenmerk): de 16 cijfers, het controlegetal en de opbouw uitgelegd.
- [Aanslagnummer: wat is het en waar vind je het?](https://zoek-belastingkenmerk.nl/blog/aanslagnummer-uitleg-waar-vinden): opbouw (9 cijfers + letter + 7 cijfers), de betekenis van de letter en het verband met het betalingskenmerk.
- [Betalingskenmerk omzetten naar aanslagnummer](https://zoek-belastingkenmerk.nl/blog/betalingskenmerk-omzetten-naar-aanslagnummer): stap voor stap van 16 cijfers naar aanslagnummer en gegevens.
- [Btw / omzetbelasting betalen — het juiste betalingskenmerk](https://zoek-belastingkenmerk.nl/blog/btw-omzetbelasting-betalen-betalingskenmerk): kenmerk per maand of kwartaal.
- [Loonheffing betalen — het juiste betalingskenmerk](https://zoek-belastingkenmerk.nl/blog/loonheffing-betalen-betalingskenmerk): kenmerk voor de aangifte loonheffingen.
- [Inkomstenbelasting betalen — het juiste betalingskenmerk](https://zoek-belastingkenmerk.nl/blog/inkomstenbelasting-betalen-betalingskenmerk): kenmerk bij de (voorlopige) aanslag IB en hoe termijnen werken.
- [Vennootschapsbelasting betalen — het juiste betalingskenmerk](https://zoek-belastingkenmerk.nl/blog/vennootschapsbelasting-betalen-betalingskenmerk): kenmerk voor de Vpb-aanslag.
- [Motorrijtuigenbelasting (wegenbelasting) betalen](https://zoek-belastingkenmerk.nl/blog/motorrijtuigenbelasting-betalen-betalingskenmerk): kenmerk voor de MRB-rekening of naheffing (letters M en Y).
- [Toeslag terugbetalen — het juiste betalingskenmerk](https://zoek-belastingkenmerk.nl/blog/toeslag-terugbetalen-betalingskenmerk): zorg-, huur-, kinderopvangtoeslag en kindgebonden budget.
- [Naheffingsaanslag betalen — wat betekent het?](https://zoek-belastingkenmerk.nl/blog/naheffingsaanslag-betalen-betalingskenmerk): naheffing btw/loon/MRB en het bijbehorende kenmerk.
- [Betalingskenmerk klopt niet — wat nu?](https://zoek-belastingkenmerk.nl/blog/betalingskenmerk-klopt-niet): het controlegetal en de meest gemaakte fouten.

## Volledige inhoud (1 bestand)

- [llms-full.txt](https://zoek-belastingkenmerk.nl/llms-full.txt): alle uitleg, de complete middelcode-tabel en API-voorbeelden in één bestand.

## Optional

- [Homepagina (interactieve tool)](https://zoek-belastingkenmerk.nl/): het zoekveld met directe omzetting.
- [Blogoverzicht](https://zoek-belastingkenmerk.nl/blog/): alle artikelen.
- [Sitemap](https://zoek-belastingkenmerk.nl/sitemap.xml): alle geïndexeerde pagina's.