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-calcInputs
| Field | Type | Required | Description |
|---|---|---|---|
| quarter | string | Yes | Tax period, e.g. 2026-Q3 (2025-Q1 to 2026-Q4 covered). |
| member_state_of_identification | string | Yes | Member State where you are registered for OSS (EL for Greece). |
| lines | array | Yes | |
| corrections | array | No | Amendments to earlier returns (VAT amount per period and Member State). |
| strict | boolean | No | true: 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."
}
}
}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
- Rechenwerk0.003 USDC
ai act risk class
POSThttps://rechen.halowerk.com/v1/ai-act-risk-classEvaluates the caller’s description against Regulation (EU) 2024/1689 as amended by Regulation (EU) 2026/1744: prohibited practices of Art. 5(1)(a)-(h) and the new points (ba) and (bb) (from 2 December 2026); high-risk under Art. 6(1) (safet
- Rechenwerk0.002 USDC
annuity schedule
POSThttps://rechen.halowerk.com/v1/annuity-scheduleMonthly annuity in arrears as used by German banks: rate = loan × (nominal rate + initial repayment rate) / 12, or from a term via A = L·q^n·(q−1)/(q^n−1) with q = 1 + i/12; interest each month = balance × i/12 (30/360), rounded to cents, t
- Rechenwerk0.002 USDC
appeal deadlines
POSThttps://rechen.halowerk.com/v1/appeal-deadlinesCovers only clearly codified periods: Berufung one month and grounds two months (§§ 517, 520(2) ZPO), Revision one and two months (§§ 548, 551(2) ZPO), labour court appeal (§ 66(1) ArbGG), all starting with service of the complete judgment