Skip to content
HALOWERK

Rechenwerk

vat calc

Rates from § 12 UStG as in force on 01.11.2026: 19 % standard (§ 12(1)), 7 % reduced (§ 12(2), incl. restaurant and catering services except drinks from 2026, no. 15), 0 % for qualifying PV supplies (§ 12(3)). Items can be given net or gross; VAT per rate group is computed on the summed net (or gross) amounts and rounded commercially to cents, as required for the breakdown by rates on invoices (§ 14(4) no. 8 UStG); optionally per line. Mixed calculation: a gross total can be split by.

POST https://rechen.halowerk.com/v1/vat-calc

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
itemsarrayNoInvoice lines.
roundingstringNoper_rate: VAT on the sum per rate (invoice breakdown); per_line: VAT rounded on every line.
gross_totalnumberNoMixed calculation: gross total to split by rate shares (instead of items).
sharesarrayNoMixed calculation: percentage of the gross total per rate (must sum to 100).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "description": "Invoice lines.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "amount",
          "rate"
        ],
        "properties": {
          "description": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional line text."
          },
          "amount": {
            "type": "number",
            "minimum": -10000000000,
            "maximum": 10000000000,
            "description": "Line amount in EUR (negative for credits)."
          },
          "amount_type": {
            "type": "string",
            "enum": [
              "net",
              "gross"
            ],
            "default": "net",
            "description": "Whether amount is net or gross."
          },
          "rate": {
            "type": "number",
            "enum": [
              19,
              7,
              0
            ],
            "description": "VAT rate in percent."
          }
        }
      }
    },
    "rounding": {
      "type": "string",
      "enum": [
        "per_rate",
        "per_line"
      ],
      "default": "per_rate",
      "description": "per_rate: VAT on the sum per rate (invoice breakdown); per_line: VAT rounded on every line."
    },
    "gross_total": {
      "type": "number",
      "minimum": 0,
      "maximum": 10000000000,
      "description": "Mixed calculation: gross total to split by rate shares (instead of items)."
    },
    "shares": {
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "description": "Mixed calculation: percentage of the gross total per rate (must sum to 100).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "rate",
          "percent"
        ],
        "properties": {
          "rate": {
            "type": "number",
            "enum": [
              19,
              7,
              0
            ],
            "description": "VAT rate."
          },
          "percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 100,
            "description": "Share of the gross total in percent."
          }
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "items": [
    {
      "amount": 49.99,
      "rate": 19
    },
    {
      "amount": 10.7,
      "amount_type": "gross",
      "rate": 7
    },
    {
      "amount": 3.33,
      "rate": 19
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →