Skip to main content

Belgian VAT Returns

Belgian tenants only

VAT return endpoints return 403 for tenants with CountryCode ≠ BE. Set your country in Settings → General to enable this feature.

The VAT Returns feature aggregates your delivered AR invoices into the standard Belgian FPS Finance grids and exports an Intervat-compatible XML declaration.

Scope (v1)​

  • Covered: Output VAT from outbound (AR) invoices — Grids G01, G02, G03, G54, G71
  • Not covered: Input VAT deduction (Grid 81) — requires AP invoice CBE validation, not yet implemented

List available periods​

Returns the quarters for which you have delivered AR invoices:

curl https://api.invostaq.com/api/vat/periods \
  -H "Authorization: Bearer {token}"
{
  "periods": [
    { "label": "2026-Q1", "year": 2026, "quarter": 1, "from": "2026-01-01", "to": "2026-03-31", "invoiceCount": 8 }
  ]
}

Generate a return summary​

curl "https://api.invostaq.com/api/vat/return?year=2026&quarter=1" \
  -H "Authorization: Bearer {token}"
{
  "period": "2026-Q1",
  "currency": "EUR",
  "grids": {
    "G01": { "taxableBase": 0.00, "vatAmount": 0.00, "rate": 6 },
    "G02": { "taxableBase": 0.00, "vatAmount": 0.00, "rate": 12 },
    "G03": { "taxableBase": 12500.00, "vatAmount": 2625.00, "rate": 21 },
    "G54": { "vatAmount": 2625.00 },
    "G71": { "vatAmount": 2625.00 }
  },
  "invoiceCount": 8,
  "warnings": ["Input VAT deduction (Grid 81) is not included. This return covers outbound invoices only."]
}

Grid reference:

GridMeaning
G01Taxable turnover at 6%
G02Taxable turnover at 12%
G03Taxable turnover at 21%
G54Total output VAT due
G71Net VAT to pay (G54 − G81; G81 = 0 in v1)

Export Intervat XML​

Downloads a Belgian Intervat-compatible XML declaration ready for FPS Finance submission:

curl "https://api.invostaq.com/api/vat/return/xml?year=2026&quarter=1" \
  -H "Authorization: Bearer {token}" \
  -o vat-2026-Q1.xml

The response is application/xml with Content-Disposition: attachment; filename="vat-2026-Q1.xml".

Prerequisite: Your Belgian VAT number must be configured in Settings → General. Returns 422 if not set.

Authentication​

All VAT return endpoints require Bearer JWT. See Authentication.