{
  "$comment": "Machine-readable companion to https://valem.run/calculators/netherlands/vat. Formula, inputs, outputs, engine-verified test vectors, cited sources and the re-runnable Valem ModelSpec behind the page.",
  "url": "https://valem.run/calculators/netherlands/vat",
  "dataUrl": "https://valem.run/calculators/netherlands/vat.json",
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Netherlands btw (vat) model by Valem (https://valem.run/calculators/netherlands/vat), CC BY 4.0.",
    "note": "Covers the model — the expression of each rule and the arrangement of the catalog. The rates and thresholds themselves are law and are not licensed by anyone; the cited sources are where they come from."
  },
  "verificationUrl": "https://valem.run/calculators/netherlands/vat/verify",
  "country": "netherlands",
  "countryName": "Netherlands",
  "formula": "vat",
  "formulaName": "BTW (VAT)",
  "title": "BTW berekenen 2026 — Netherlands VAT calculator",
  "answer": "Dutch btw is 21% as the general rate and 9% on a limited list of goods and services. Below 20 000 EUR of turnover you may apply for the kleineondernemersregeling and charge no btw at all — but it is an election, not an automatic exemption.",
  "lang": "en",
  "currency": "EUR",
  "taxYear": "2026",
  "verification": {
    "claim": "internal-consistency",
    "statement": "The Valem engine reproduces this model's stated formula through 6 self-test cases (below, and re-runnable against the spec). That asserts internal consistency, NOT that the formula matches current law — the cited sources are the evidence for that, and carry the date each was last checked.",
    "selfTestCases": 6,
    "ratesAreIllustrative": false,
    "sourcesCheckedOn": "2026-10-05"
  },
  "sources": [
    {
      "label": "Belastingdienst - Btw-tarieven en vrijstellingen (21%, 9%)",
      "url": "https://www.belastingdienst.nl/wps/wcm/connect/bldcontentnl/belastingdienst/zakelijk/btw/tarieven_en_vrijstellingen/tarieven_en_vrijstellingen",
      "checked": "2026-10-05"
    },
    {
      "label": "Belastingdienst - Voorwaarden voor de kleineondernemersregeling (KOR), EUR 20.000",
      "url": "https://www.belastingdienst.nl/wps/wcm/connect/nl/btw/content/kor-voorwaarden",
      "checked": "2026-10-05"
    }
  ],
  "terminalOutput": "mustRegister",
  "headlineOutput": "vatAmount",
  "inputs": [
    {
      "name": "amount",
      "type": "number",
      "label": "Amount",
      "minimum": 0
    },
    {
      "name": "direction",
      "type": "string",
      "label": "Direction",
      "enum": [
        "add",
        "remove"
      ]
    },
    {
      "name": "category",
      "type": "string",
      "label": "What is being supplied",
      "enum": [
        "standard",
        "reduced1"
      ]
    },
    {
      "name": "annualTurnover",
      "type": "number",
      "label": "Turnover this calendar year",
      "minimum": 0
    },
    {
      "name": "reverseCharge",
      "type": "boolean",
      "label": "B2B reverse charge applies"
    },
    {
      "name": "priorYearTurnover",
      "type": "number",
      "label": "Turnover last year",
      "minimum": 0
    }
  ],
  "outputs": [
    {
      "name": "rate",
      "type": "number",
      "formula": "category = 'reduced1' ? $const.reducedRate1 : $const.standardRate"
    },
    {
      "name": "effectiveRate",
      "type": "number",
      "formula": "reverseCharge ? 0 : rate"
    },
    {
      "name": "netAmount",
      "type": "number",
      "formula": "direction = 'remove' ? $round(amount / (1 + effectiveRate), 2) : $round(amount, 2)"
    },
    {
      "name": "vatAmount",
      "type": "number",
      "formula": "$round(netAmount * effectiveRate, 2)"
    },
    {
      "name": "grossAmount",
      "type": "number",
      "formula": "$round(netAmount + vatAmount, 2)"
    },
    {
      "name": "mustRegister",
      "type": "boolean",
      "formula": "priorYearTurnover > $const.registrationThreshold or annualTurnover > $const.registrationThreshold"
    }
  ],
  "testCases": [
    {
      "description": "S1 100.00 EUR net at the algemeen tarief",
      "given": {
        "amount": 100,
        "direction": "add",
        "category": "standard",
        "reverseCharge": false,
        "annualTurnover": 0,
        "priorYearTurnover": 0
      },
      "expect": {
        "vatAmount": 21,
        "grossAmount": 121,
        "netAmount": 100
      }
    },
    {
      "description": "S2 121.00 EUR gross back to net at 21%",
      "given": {
        "amount": 121,
        "direction": "remove",
        "category": "standard",
        "reverseCharge": false,
        "annualTurnover": 0,
        "priorYearTurnover": 0
      },
      "expect": {
        "netAmount": 100,
        "vatAmount": 21
      }
    },
    {
      "description": "S3 100.00 EUR net at the 9% verlaagd tarief",
      "given": {
        "amount": 100,
        "direction": "add",
        "category": "reduced1",
        "reverseCharge": false,
        "annualTurnover": 0,
        "priorYearTurnover": 0
      },
      "expect": {
        "vatAmount": 9,
        "grossAmount": 109
      }
    },
    {
      "description": "S4 reverse charge: the supplier charges no btw",
      "given": {
        "amount": 100,
        "direction": "add",
        "category": "standard",
        "reverseCharge": true,
        "annualTurnover": 0,
        "priorYearTurnover": 0
      },
      "expect": {
        "vatAmount": 0,
        "grossAmount": 100
      }
    },
    {
      "description": "S5 either year over 20 000 EUR: the KOR is not available",
      "given": {
        "amount": 100,
        "direction": "add",
        "category": "standard",
        "reverseCharge": false,
        "annualTurnover": 5000,
        "priorYearTurnover": 25000
      },
      "expect": {
        "mustRegister": true
      }
    },
    {
      "description": "S6 both years under the limit: the KOR is available",
      "given": {
        "amount": 100,
        "direction": "add",
        "category": "standard",
        "reverseCharge": false,
        "annualTurnover": 15000,
        "priorYearTurnover": 15000
      },
      "expect": {
        "mustRegister": false
      }
    }
  ],
  "spec": {
    "id": "vat-netherlands",
    "version": "1.0.0",
    "schema": {
      "type": "object",
      "properties": {
        "amount": {
          "type": "number",
          "minimum": 0
        },
        "direction": {
          "type": "string",
          "enum": [
            "add",
            "remove"
          ]
        },
        "category": {
          "type": "string",
          "enum": [
            "standard",
            "reduced1"
          ]
        },
        "annualTurnover": {
          "type": "number",
          "minimum": 0
        },
        "reverseCharge": {
          "type": "boolean"
        },
        "rate": {
          "type": "number",
          "readOnly": true
        },
        "effectiveRate": {
          "type": "number",
          "readOnly": true
        },
        "netAmount": {
          "type": "number",
          "readOnly": true
        },
        "vatAmount": {
          "type": "number",
          "readOnly": true
        },
        "grossAmount": {
          "type": "number",
          "readOnly": true
        },
        "mustRegister": {
          "type": "boolean",
          "readOnly": true
        },
        "priorYearTurnover": {
          "type": "number",
          "minimum": 0
        }
      }
    },
    "constants": {
      "standardRate": 0.21,
      "reducedRate1": 0.09,
      "registrationThreshold": 20000
    },
    "defaultValues": [
      {
        "path": "$",
        "expr": "{ 'amount': 100, 'direction': 'add', 'category': 'standard', 'reverseCharge': false, 'annualTurnover': 0, 'priorYearTurnover': 0 }"
      }
    ],
    "derivations": [
      {
        "path": "$.rate",
        "expr": "category = 'reduced1' ? $const.reducedRate1 : $const.standardRate"
      },
      {
        "path": "$.effectiveRate",
        "expr": "reverseCharge ? 0 : rate"
      },
      {
        "path": "$.netAmount",
        "expr": "direction = 'remove' ? $round(amount / (1 + effectiveRate), 2) : $round(amount, 2)"
      },
      {
        "path": "$.vatAmount",
        "expr": "$round(netAmount * effectiveRate, 2)"
      },
      {
        "path": "$.grossAmount",
        "expr": "$round(netAmount + vatAmount, 2)"
      },
      {
        "path": "$.mustRegister",
        "expr": "priorYearTurnover > $const.registrationThreshold or annualTurnover > $const.registrationThreshold"
      }
    ],
    "constraints": [],
    "viewDefinition": {
      "renderer": "builtin",
      "defaultView": "main",
      "views": [
        {
          "id": "main",
          "label": "VAT",
          "layout": "vertical",
          "components": [
            {
              "id": "note",
              "type": "staticText",
              "text": "The 20 000 EUR figure is the kleineondernemersregeling (KOR) limit, and the KOR is an election you apply for, not an automatic exemption: Dutch entrepreneurs are liable for btw by default. The limit is tested against the calendar year you register in AND the one before it, so a single good year closes the scheme off. The 0% tarief is not offered as a category because it is the cross-border mechanism, not a rate you choose: the Belastingdienst gives it for \"grensoverschrijdende activiteiten\"."
            },
            {
              "id": "inputs",
              "type": "fieldSet",
              "label": "Your figures",
              "components": [
                {
                  "id": "amount",
                  "type": "numericField",
                  "label": "Amount",
                  "bind": "$.amount",
                  "helperText": "Net amount when adding VAT, gross amount when removing it."
                },
                {
                  "id": "direction",
                  "type": "selectField",
                  "label": "Direction",
                  "bind": "$.direction",
                  "options": [
                    {
                      "value": "add",
                      "label": "Add VAT (net → gross)"
                    },
                    {
                      "value": "remove",
                      "label": "Remove VAT (gross → net)"
                    }
                  ]
                },
                {
                  "id": "category",
                  "type": "selectField",
                  "label": "What is being supplied",
                  "bind": "$.category",
                  "helperText": "The rate follows the category. Exports and intra-EU supplies are zero-rated or exempt — a different mechanism, not a rate you pick here.",
                  "options": [
                    {
                      "value": "standard",
                      "label": "Algemeen tarief - 21%"
                    },
                    {
                      "value": "reduced1",
                      "label": "Verlaagd tarief - 9% (food, books, medicines, some services)"
                    }
                  ]
                },
                {
                  "id": "reverseCharge",
                  "type": "checkboxField",
                  "label": "B2B reverse charge applies",
                  "bind": "$.reverseCharge",
                  "helperText": "The customer accounts for the VAT, so you charge none."
                },
                {
                  "id": "annualTurnover",
                  "type": "numericField",
                  "label": "Turnover this calendar year",
                  "bind": "$.annualTurnover"
                },
                {
                  "id": "priorYearTurnover",
                  "type": "numericField",
                  "label": "Turnover last year",
                  "bind": "$.priorYearTurnover"
                }
              ]
            },
            {
              "id": "sep",
              "type": "separatorLine"
            },
            {
              "id": "vatTile",
              "type": "statTile",
              "label": "VAT",
              "value": "$.vatAmount"
            },
            {
              "id": "netTile",
              "type": "statTile",
              "label": "Net",
              "value": "$.netAmount"
            },
            {
              "id": "grossTile",
              "type": "statTile",
              "label": "Gross",
              "value": "$.grossAmount"
            },
            {
              "id": "breakdown",
              "type": "keyValueList",
              "label": "Detail",
              "items": [
                {
                  "label": "Rate applied",
                  "value": "$.effectiveRate"
                },
                {
                  "label": "Statutory rate for this category",
                  "value": "$.rate"
                },
                {
                  "label": "Must charge btw (KOR not available)",
                  "value": "$.mustRegister"
                }
              ]
            },
            {
              "id": "sources",
              "type": "sourceList",
              "label": "Sources",
              "layers": 2,
              "items": [
                {
                  "label": "Belastingdienst - Btw-tarieven en vrijstellingen (21%, 9%)",
                  "url": "https://www.belastingdienst.nl/wps/wcm/connect/bldcontentnl/belastingdienst/zakelijk/btw/tarieven_en_vrijstellingen/tarieven_en_vrijstellingen",
                  "date": "2026-10-05",
                  "covers": [
                    "standardRate",
                    "reducedRate1"
                  ]
                },
                {
                  "label": "Belastingdienst - Voorwaarden voor de kleineondernemersregeling (KOR), EUR 20.000",
                  "url": "https://www.belastingdienst.nl/wps/wcm/connect/nl/btw/content/kor-voorwaarden",
                  "date": "2026-10-05",
                  "covers": [
                    "registrationThreshold"
                  ]
                }
              ]
            }
          ]
        }
      ]
    },
    "tests": [
      {
        "description": "S1 100.00 EUR net at the algemeen tarief",
        "given": {
          "$.amount": 100,
          "$.direction": "add",
          "$.category": "standard",
          "$.reverseCharge": false,
          "$.annualTurnover": 0,
          "$.priorYearTurnover": 0
        },
        "expect": {
          "$.vatAmount": 21,
          "$.grossAmount": 121,
          "$.netAmount": 100
        }
      },
      {
        "description": "S2 121.00 EUR gross back to net at 21%",
        "given": {
          "$.amount": 121,
          "$.direction": "remove",
          "$.category": "standard",
          "$.reverseCharge": false,
          "$.annualTurnover": 0,
          "$.priorYearTurnover": 0
        },
        "expect": {
          "$.netAmount": 100,
          "$.vatAmount": 21
        }
      },
      {
        "description": "S3 100.00 EUR net at the 9% verlaagd tarief",
        "given": {
          "$.amount": 100,
          "$.direction": "add",
          "$.category": "reduced1",
          "$.reverseCharge": false,
          "$.annualTurnover": 0,
          "$.priorYearTurnover": 0
        },
        "expect": {
          "$.vatAmount": 9,
          "$.grossAmount": 109
        }
      },
      {
        "description": "S4 reverse charge: the supplier charges no btw",
        "given": {
          "$.amount": 100,
          "$.direction": "add",
          "$.category": "standard",
          "$.reverseCharge": true,
          "$.annualTurnover": 0,
          "$.priorYearTurnover": 0
        },
        "expect": {
          "$.vatAmount": 0,
          "$.grossAmount": 100
        }
      },
      {
        "description": "S5 either year over 20 000 EUR: the KOR is not available",
        "given": {
          "$.amount": 100,
          "$.direction": "add",
          "$.category": "standard",
          "$.reverseCharge": false,
          "$.annualTurnover": 5000,
          "$.priorYearTurnover": 25000
        },
        "expect": {
          "$.mustRegister": true
        }
      },
      {
        "description": "S6 both years under the limit: the KOR is available",
        "given": {
          "$.amount": 100,
          "$.direction": "add",
          "$.category": "standard",
          "$.reverseCharge": false,
          "$.annualTurnover": 15000,
          "$.priorYearTurnover": 15000
        },
        "expect": {
          "$.mustRegister": false
        }
      }
    ]
  }
}
