Skip to content
HALOWERK

Rechenwerk

oss return calc

Aggregates B2C distance sales of goods and services by Member State of consumption and VAT rate and computes VAT = taxable amount × rate, rounded half up to cents per country and rate (Art. 369g Directive 2006/112/EC). Each rate is validated against the VAT rates of the Taxes in Europe Database (TEDB, European Commission) valid on the supply date (monthly snapshots 2025-01 to 2026-11, as of 2026-11-01): standard, reduced, super-reduced, parking and region-specific rates (e.g. Madeira,.

POST https://rechen.halowerk.com/v1/oss-return-calc

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
quarterstringYesTax period, e.g. 2026-Q3 (2025-Q1 to 2026-Q4 covered).
member_state_of_identificationstringYesMember State where you are registered for OSS (EL for Greece).
linesarrayYes
correctionsarrayNoAmendments to earlier returns (VAT amount per period and Member State).
strictbooleanNotrue: reject the return if a rate is not valid; false: exclude such lines and report them.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "quarter",
    "member_state_of_identification",
    "lines"
  ],
  "properties": {
    "quarter": {
      "type": "string",
      "pattern": "^\\d{4}-Q[1-4]$",
      "description": "Tax period, e.g. 2026-Q3 (2025-Q1 to 2026-Q4 covered)."
    },
    "member_state_of_identification": {
      "type": "string",
      "pattern": "^[A-Z]{2}$",
      "description": "Member State where you are registered for OSS (EL for Greece)."
    },
    "lines": {
      "type": "array",
      "minItems": 1,
      "maxItems": 5000,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "country",
          "rate_percent",
          "net_amount_eur"
        ],
        "properties": {
          "country": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "description": "Member State of consumption."
          },
          "rate_percent": {
            "type": "number",
            "minimum": 0,
            "maximum": 30,
            "description": "VAT rate applied, in percent."
          },
          "net_amount_eur": {
            "type": "number",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "Taxable amount in EUR (negative for credit notes of the same period); convert other currencies at the ECB rate of the last day of the period (Art. 369h)."
          },
          "supply_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "description": "Date of supply; enables the exact rate check when rates changed during the quarter."
          },
          "kind": {
            "type": "string",
            "enum": [
              "goods",
              "services"
            ],
            "default": "goods",
            "description": "Intra-Community distance sale of goods or B2C service."
          },
          "dispatched_from": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "description": "For goods: Member State where dispatch began, if not the Member State of identification."
          },
          "fixed_establishment": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "description": "For services: Member State of the fixed establishment supplying them, if not the Member State of identification."
          }
        }
      }
    },
    "corrections": {
      "type": "array",
      "maxItems": 500,
      "description": "Amendments to earlier returns (VAT amount per period and Member State).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "period",
          "country",
          "vat_amount_eur"
        ],
        "properties": {
          "period": {
            "type": "string",
            "pattern": "^\\d{4}-Q[1-4]$",
            "description": "Corrected quarter."
          },
          "country": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "description": "Member State of consumption."
          },
          "vat_amount_eur": {
            "type": "number",
            "minimum": -1000000000,
            "maximum": 1000000000,
            "description": "VAT difference (positive = more VAT due)."
          }
        }
      }
    },
    "strict": {
      "type": "boolean",
      "default": true,
      "description": "true: reject the return if a rate is not valid; false: exclude such lines and report them."
    }
  }
}

Open original schema

Published input example

{
  "quarter": "2026-Q3",
  "member_state_of_identification": "DE",
  "lines": [
    {
      "country": "FR",
      "rate_percent": 20,
      "net_amount_eur": 1000,
      "supply_date": "2026-08-10"
    },
    {
      "country": "AT",
      "rate_percent": 10,
      "net_amount_eur": 500
    }
  ]
}

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 →