{"$schema":"https://json-schema.org/draft/2020-12/schema","title":"Jaaropgave (Annual Wage Statement)","description":"Dutch annual wage statement issued by the employer (inhoudingsplichtige) to each employee at year-end, per Art. 28 lid 1 onderdeel e Wet op de loonbelasting 1964 jo. de Uitvoeringsregeling loonbelasting 2011. Required minimum content per the Belastingdienst Handboek Loonheffingen 2026 + the model jaaropgaaf the Belastingdienst publishes (vormvrij sinds 2022): naam + BSN werknemer, naam werkgever + loonheffingennummer, kalenderjaar, loon voor de loonbelasting/volksverzekeringen (kolom 14 loonstaat), ingehouden loonbelasting/premie volksverzekeringen (kolom 15), verrekende arbeidskorting (kolom 18), loon voor de Zvw (kolom 12), ingehouden bijdrage Zvw (kolom 16), werkgeversheffing Zvw, levensloopverlofkorting (kolom 19), loonheffingskorting toegepast ja/nee + datum vanaf wanneer. Extra praktijkvelden uit Loket.nl / AFAS / Visma Nmbrs / Exact / Personio specimens: SV-loon (premieloon werknemersverzekeringen) per fonds (Awf, Aof, Whk, Ufo) tot maximumpremieloon 2026 EUR 79 409, ingehouden werknemersbijdrage pensioen, vakantietoeslag YTD, 13e/14e maand YTD, bijtelling privégebruik auto YTD, eindheffingen WKR (informatief), loon uit vroegere dienstbetrekking ja/nee voor IB-rubriek 2 vs. 1, ZW-uitkering doorbetaald door werkgever, en de wettelijke verklaring 'bestemd voor de aangifte inkomstenbelasting'.","type":"object","required":["employer","employee","year","wages","loonheffingskorting","place_of_issue","issue_date"],"additionalProperties":false,"properties":{"employer":{"type":"object","description":"Werkgever (inhoudingsplichtige). Naam + adres + loonheffingennummer zijn wettelijk verplicht (Art. 28 lid 1 onderdeel e Wet LB jo. Belastingdienst model jaaropgaaf).","required":["name","address","loonheffingen_nummer","represented_by"],"additionalProperties":false,"properties":{"name":{"type":"string","minLength":1},"legal_form":{"type":"string","description":"Rechtsvorm (BV, NV, VOF, eenmanszaak, stichting, etc.)"},"address":{"type":"string","minLength":1,"description":"Vestigingsadres incl. postcode + plaats"},"kvk":{"type":"string","pattern":"^[0-9]{8}$","description":"KvK-nummer (8 cijfers)"},"rsin":{"type":"string","pattern":"^[0-9]{9}$","description":"Rechtspersonen- en Samenwerkingsverbanden Identificatienummer (9 cijfers)"},"btw_id":{"type":"string","description":"BTW-identificatienummer (NL + 9 cijfers + B + 2 cijfers)"},"loonheffingen_nummer":{"type":"string","pattern":"^[0-9]{9}L[0-9]{2}$","description":"Loonheffingennummer toegekend door Belastingdienst (9 cijfers + L + 2 cijfers subnummer)"},"sector_code":{"type":"string","description":"Sectorcode UWV (bv. 33 voor Horeca catering, 45 voor Zakelijke dienstverlening)"},"collective_agreement":{"type":"string","description":"Toepasselijke CAO"},"represented_by":{"type":"string","minLength":1,"description":"Naam + functie van de tekenbevoegde namens werkgever"}}},"employee":{"type":"object","description":"Werknemer. Naam + adres + BSN + geboortedatum zijn praktijkstandaard (model Belastingdienst noemt naam + BSN expliciet; adres + geboortedatum praktijk voor identificatie en VIA-koppeling Belastingdienst).","required":["full_name","address","bsn","date_of_birth","start_date"],"additionalProperties":false,"properties":{"full_name":{"type":"string","minLength":1},"initials":{"type":"string","description":"Voorletters voor formele aanhef"},"address":{"type":"string","minLength":1,"description":"Woonadres incl. postcode + plaats; 'in het buitenland' kan, met landcode"},"bsn":{"type":"string","pattern":"^[0-9]{9}$","description":"Burgerservicenummer (9 cijfers, 11-proef)"},"date_of_birth":{"type":"string","format":"date"},"personnel_number":{"type":"string","description":"Personeelsnummer / werknemernummer in werkgevers-loonadministratie"},"start_date":{"type":"string","format":"date","description":"Datum in dienst (begin huidige dienstbetrekking; bij meerdere dienstverbanden in het jaar: vroegste datum binnen het kalenderjaar)"},"end_date":{"type":"string","format":"date","description":"Datum uit dienst (indien dienstbetrekking eindigde in het jaar)"}}},"year":{"type":"integer","minimum":2020,"maximum":2100,"description":"Kalenderjaar waarop de jaaropgave betrekking heeft"},"loon_categorie":{"type":"string","enum":["huidige_dienstbetrekking","vroegere_dienstbetrekking"],"default":"huidige_dienstbetrekking","description":"Soort loon: huidige dienstbetrekking (IB-aangifte rubriek 1: inkomsten uit tegenwoordige arbeid) of vroegere dienstbetrekking (rubriek 2: pensioen / WW / WIA / WAO / ZW / Wajong-uitkering --- groen tabel). Bepaalt fiscale behandeling en al dan niet recht op arbeidskorting."},"wages":{"type":"object","description":"Bedragen per Belastingdienst model jaaropgaaf 2026 + uitbreidingen. Verplicht: loon LB/PVV (kolom 14), loonheffing kolom 15, arbeidskorting kolom 18, Zvw-loon kolom 12, ingehouden bijdrage Zvw kolom 16, werkgeversheffing Zvw, levensloopverlofkorting kolom 19. Premieloon werknemersverzekeringen (Awf/Aof/Whk/Ufo) is best-practice toevoeging --- niet wettelijk verplicht op de jaaropgaaf maar nuttig voor de werknemer voor WW/Wia-aanvragen.","required":["loon_lb_pvv","ingehouden_lb_pvv","verrekende_arbeidskorting","loon_zvw","ingehouden_bijdrage_zvw","werkgeversheffing_zvw","premies_werknemersverzekeringen"],"additionalProperties":false,"properties":{"loon_lb_pvv":{"type":"number","minimum":0,"description":"Loon voor de loonbelasting / volksverzekeringen (kolom 14 loonstaat). Fiscaal loon. Basis voor IB-aangifte rubriek 1 of 2."},"ingehouden_lb_pvv":{"type":"number","minimum":0,"description":"Ingehouden loonbelasting / premie volksverzekeringen (kolom 15). Loonheffing = LB + PVV (AOW + ANW + Wlz)."},"verrekende_arbeidskorting":{"type":"number","minimum":0,"description":"Verrekende arbeidskorting (kolom 18). Door de werkgever bij toepassing van de loonbelastingtabel verrekende arbeidskorting (Art. 8.11 Wet IB 2001)."},"loon_zvw":{"type":"number","minimum":0,"description":"Loon voor de Zvw / bijdrageloon Zorgverzekeringswet (kolom 12). Tot maximumbijdrageloon 2026 EUR 79 409."},"ingehouden_bijdrage_zvw":{"type":"number","minimum":0,"description":"Ingehouden inkomensafhankelijke bijdrage Zvw werknemer (kolom 16). Reguliere werknemers: 0 (werkgever betaalt werkgeversheffing). Voor pseudo-werknemers (DGA), gepensioneerden, AOW'ers met aanvullend inkomen kan het ingehouden bijdrage Zvw zijn."},"werkgeversheffing_zvw":{"type":"number","minimum":0,"description":"Werkgeversheffing Zvw die de werkgever betaalt (informatief; 2026: 6,10 \\% van het Zvw-loon)."},"levensloopverlofkorting":{"type":"number","minimum":0,"description":"Verrekende levensloopverlofkorting (kolom 19). Alleen relevant voor lopende rechten uit vóór 2012; sinds 2022 is de levensloopregeling fiscaal afgewikkeld --- doorgaans 0."},"premies_werknemersverzekeringen":{"type":"object","description":"Premieloon en premies werknemersverzekeringen per fonds. Premieloon gemaximeerd op maximumpremieloon 2026 EUR 79 409. Werkgever-premies; geen inhouding op werknemer (uitzondering: WGA-verhaal door eigenrisicodrager Art. 40 Wfsv).","required":["premieloon","totaal_werkgever"],"additionalProperties":false,"properties":{"premieloon":{"type":"number","minimum":0,"description":"Premieloon werknemersverzekeringen (basis Awf, Aof, Whk). Tot maximumpremieloon 2026 EUR 79 409."},"awf_premie":{"type":"number","minimum":0,"description":"WW-Awf premie werkgever (2026: 2,74 \\% laag / 7,74 \\% hoog)"},"awf_categorie":{"type":"string","enum":["laag","hoog"],"description":"Awf-laag (vast schriftelijk + onbepaalde tijd + niet-oproep) of Awf-hoog (oproep / uitzend / bepaalde tijd zonder schriftelijke onbepaalde-tijd-overeenkomst)"},"aof_premie":{"type":"number","minimum":0,"description":"Aof premie werkgever (2026: 6,27 \\% klein / 7,63 \\% groot werkgever, gedifferentieerd Wet differentiatie Aof-premie)"},"whk_premie":{"type":"number","minimum":0,"description":"Whk-premie werkgever (Werkhervattingskas: WGA + ZW-flex; gemiddeld 1,52 \\% in 2026, sectorgedifferentieerd)"},"ufo_premie":{"type":"number","minimum":0,"description":"Ufo-premie (overheidssectoren; 2026: 0,68 \\%)"},"totaal_werkgever":{"type":"number","minimum":0,"description":"Totaal premies werknemersverzekeringen werkgever in het jaar (informatief)"}}},"loonheffing_bijzonder_tarief":{"type":"number","minimum":0,"description":"Ingehouden loonheffing over loon-bijzonder-tarief (eenmalige beloningen: bonus, eindejaarsuitkering, vakantiegeld). Onderdeel van ingehouden_lb_pvv totaal --- hier informatief."}}},"loonheffingskorting":{"type":"object","description":"Loonheffingskorting toegepast: ja/nee + datum vanaf wanneer (Belastingdienst model jaaropgaaf 2026 verplicht item). Bestaat uit algemene heffingskorting + arbeidskorting. Mag maar bij één inhoudingsplichtige tegelijk worden toegepast.","required":["toegepast"],"additionalProperties":false,"properties":{"toegepast":{"type":"string","enum":["ja","nee","gewisseld"],"description":"Is de loonheffingskorting in dit jaar toegepast bij deze werkgever? 'gewisseld' = deels wel/deels niet."},"vanaf_datum":{"type":"string","format":"date","description":"Datum vanaf wanneer de LH-korting in dit jaar bij deze werkgever is toegepast. Verplicht indien toegepast = ja en de werknemer niet het hele jaar bij deze werkgever was, of indien gewisseld."},"tot_datum":{"type":"string","format":"date","description":"Datum tot wanneer de LH-korting in dit jaar bij deze werkgever is toegepast (indien gewisseld of indien de werknemer in de loop van het jaar uit dienst is gegaan)."},"verrekende_algemene_heffingskorting":{"type":"number","minimum":0,"description":"Verrekende algemene heffingskorting (Art. 8.10 Wet IB 2001). Onderdeel LH-korting samen met arbeidskorting; staat op zichzelf op de jaaropgaaf bij sommige systemen (Loket.nl)."},"toelichting":{"type":"string","description":"Vrije toelichting bij gewisseld --- bv. 'LH-korting toegepast 1 jan t/m 30 juni; vanaf 1 juli verzoek werknemer ingetrokken wegens tweede dienstbetrekking.'"}}},"extra":{"type":"object","description":"Aanvullende informatie die niet wettelijk verplicht is op de jaaropgaaf maar door werknemers wordt verwacht (Loket.nl / AFAS / Visma Nmbrs / Exact / Personio specimens) en bij IB-aangifte / belastingaftrek nuttig is.","additionalProperties":false,"properties":{"vakantiegeld_uitbetaald":{"type":"number","minimum":0,"description":"Uitbetaald vakantiegeld in het jaar (Art. 15 Wml; doorgaans 8 \\% over 12 maanden, uitbetaling typisch in mei/juni)"},"dertiende_maand_uitbetaald":{"type":"number","minimum":0,"description":"Uitbetaalde 13e (eindejaarsuitkering) of 14e maand in het jaar (CAO-afhankelijk)"},"bijtelling_auto":{"type":"object","description":"Bijtelling privégebruik auto van de zaak in het jaar. 2026: 22 \\% standaard zonder aparte 17 \\%-EV-categorie meer voor nieuwe leaseauto's, alleen overgangsrecht voor lopende beschikkingen vóór 1.1.2026; 35 \\% oldtimer over dagwaarde.","additionalProperties":false,"properties":{"categorie":{"type":"string","enum":["geen","4pct_overgang","16pct_overgang","17pct_overgang","22pct_standaard","35pct_oldtimer","jaarrente"],"description":"Bijtellingscategorie 2026"},"cataloguswaarde":{"type":"number","minimum":0,"description":"Cataloguswaarde of dagwaarde (oldtimer) van het voertuig"},"bedrag_ytd":{"type":"number","minimum":0,"description":"Bedrag bijtelling in het jaar (12 maanden of pro rata)"},"eigen_bijdrage_ytd":{"type":"number","minimum":0,"description":"Eigen bijdrage werknemer voor privégebruik in het jaar (verlaagt de netto-bijtelling)"}}},"pensioenpremie_werknemer":{"type":"number","minimum":0,"description":"Door werknemer betaalde pensioenpremie in het jaar (verlaagt fiscaal loon; al verwerkt in loon_lb_pvv). Informatief getoond zodat werknemer reservering controleert."},"eindheffing_wkr":{"type":"number","minimum":0,"description":"Eindheffing werkkostenregeling (Art. 31 Wet LB) op overschrijding vrije ruimte. Niet op werknemer verhaald maar werkgever-last; vermelding informatief."},"zw_uitkering_doorbetaald":{"type":"boolean","description":"Geeft aan of de werkgever in het jaar een ZW-uitkering heeft doorbetaald aan de werknemer (no-riskpolis Art. 29b ZW). Belastingdienst-relevant want kan tot vroegere-dienstbetrekking-loon herkwalificeren."},"thirty_percent_ruling":{"type":"boolean","description":"Heeft de werknemer in het jaar (deels) van de 30 \\%-regeling (Art. 31a Wet LB) gebruikgemaakt? Sinds 1.1.2024 gestaffeld 30/20/10 \\% over respectievelijk 20/20/20 maanden voor nieuwe beschikkingen."},"anoniementarief_toegepast":{"type":"boolean","description":"Is het anoniementarief 52 \\% (Art. 26b Wet LB) toegepast? (geen BSN of geen geldig identiteitsbewijs voor 1e werkdag)"},"loonbeslag_ingehouden":{"type":"number","minimum":0,"description":"Totaal in het jaar ingehouden loonbeslag (Art. 475 Rv, beslagvrije voet Art. 475d Rv)"}}},"place_of_issue":{"type":"string","minLength":1,"description":"Plaats van afgifte van de jaaropgave"},"issue_date":{"type":"string","format":"date","description":"Datum van afgifte. Wettelijke termijn: voorafgaand aan de IB-aangifte van de werknemer; praktijk-norm Belastingdienst: tweede helft januari van het volgende jaar."},"verklaring_ib_aangifte":{"type":"boolean","default":true,"description":"Vermelding 'deze jaaropgave is bestemd voor de aangifte inkomstenbelasting' --- standaard zin op het Belastingdienst-model. Default true (altijd tonen)."}}}