{
  "$comment": "Machine-readable companion to https://valem.run/calculators/south-africa/car-tax. Formula, inputs, outputs, engine-verified test vectors, cited sources and the re-runnable Valem ModelSpec behind the page.",
  "url": "https://valem.run/calculators/south-africa/car-tax",
  "dataUrl": "https://valem.run/calculators/south-africa/car-tax.json",
  "license": {
    "name": "CC BY 4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "South Africa licence disc model by Valem (https://valem.run/calculators/south-africa/car-tax), 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/south-africa/car-tax/verify",
  "country": "south-africa",
  "countryName": "South Africa",
  "formula": "car-tax",
  "formulaName": "Licence disc",
  "title": "Licence Disc Renewal Cost — South Africa",
  "answer": "South Africa's annual vehicle licence fee is based on the car's tare weight and set by each province.",
  "lang": "en",
  "currency": "ZAR",
  "taxYear": "2025",
  "verification": {
    "claim": "shape-only",
    "statement": "The rates in this model are illustrative. Its 2 self-test cases confirm the engine reproduces the shape of the charge, but the schedule is not the official one, so the amount will not match a real bill. The cited sources name the document that would replace it.",
    "selfTestCases": 2,
    "ratesAreIllustrative": true,
    "sourcesCheckedOn": "2026-08-02"
  },
  "sources": [
    {
      "label": "NaTIS",
      "url": "https://www.natis.gov.za",
      "checked": "2026-08-02"
    }
  ],
  "terminalOutput": "fee",
  "inputs": [
    {
      "name": "tareWeight",
      "type": "number",
      "label": "Tare weight (kg)",
      "minimum": 0
    }
  ],
  "outputs": [
    {
      "name": "fee",
      "type": "number",
      "label": "Annual licence fee",
      "format": "currency",
      "formula": "($w := tareWeight; $round($w <= 1000 ? 300 : $w <= 1500 ? 456 : $w <= 2000 ? 660 : $w <= 2500 ? 900 : 1200, 2))"
    }
  ],
  "testCases": [
    {
      "description": "C1 Gauteng 1,250 kg",
      "given": {
        "tareWeight": 1250
      },
      "expect": {
        "fee": 456
      }
    },
    {
      "description": "C2 Gauteng 2,100 kg",
      "given": {
        "tareWeight": 2100
      },
      "expect": {
        "fee": 900
      }
    }
  ],
  "spec": {
    "id": "car-tax-south-africa",
    "version": "1.0.0",
    "schema": {
      "type": "object",
      "properties": {
        "tareWeight": {
          "type": "number",
          "minimum": 0
        },
        "fee": {
          "type": "number",
          "readOnly": true
        }
      }
    },
    "constants": {},
    "defaultValues": [
      {
        "path": "$",
        "expr": "{ 'tareWeight': 1250 }"
      }
    ],
    "derivations": [
      {
        "path": "$.fee",
        "expr": "($w := tareWeight; $round($w <= 1000 ? 300 : $w <= 1500 ? 456 : $w <= 2000 ? 660 : $w <= 2500 ? 900 : 1200, 2))"
      }
    ],
    "constraints": [],
    "metaDerivations": [],
    "viewDefinition": {
      "renderer": "builtin",
      "defaultView": "main",
      "views": [
        {
          "id": "main",
          "label": "Licence disc",
          "layout": "vertical",
          "components": [
            {
              "id": "illustrativeNotice",
              "type": "alert",
              "variant": "warning",
              "label": "Illustrative rates — not the official schedule",
              "text": "'The annual vehicle licence fee is set by each province and based on tare weight, so the same car costs different amounts in Gauteng, the Western Cape and KwaZulu-Natal. The figures here show the shape of that fee. Check your provincial licensing department for the amount you will pay.'"
            },
            {
              "id": "tare",
              "type": "numericField",
              "label": "Tare weight (kg)",
              "bind": "$.tareWeight"
            },
            {
              "id": "tiles",
              "type": "group",
              "layout": "horizontal",
              "components": [
                {
                  "id": "feeTile",
                  "type": "statTile",
                  "label": "Annual licence fee",
                  "bind": "$.fee",
                  "format": "currency",
                  "currency": "ZAR"
                }
              ]
            },
            {
              "id": "note",
              "type": "staticText",
              "text": "'South Africa: annual vehicle licence (disc) fee is based on tare weight and set by each province. Illustrative Gauteng-style table; late renewal adds penalties. Estimate, not advice.'"
            },
            {
              "id": "sources",
              "type": "sourceList",
              "label": "Sources",
              "items": [
                {
                  "label": "NaTIS",
                  "url": "https://www.natis.gov.za",
                  "date": "2026-08-02"
                }
              ]
            }
          ]
        }
      ]
    },
    "tests": [
      {
        "description": "C1 Gauteng 1,250 kg",
        "given": {
          "$.tareWeight": 1250
        },
        "expect": {
          "$.fee": 456
        }
      },
      {
        "description": "C2 Gauteng 2,100 kg",
        "given": {
          "$.tareWeight": 2100
        },
        "expect": {
          "$.fee": 900
        }
      }
    ]
  }
}