Nordlet

← Blog

Real-Time EU VAT for Developers Building in Portugal

A grounded comparison of accounting and tax platforms that handle Portuguese and EU VAT through APIs, SDKs and webhooks, with clear notes on what each one actually covers.

Nordlet Team · · 12 min read

Portugal certifies invoicing software. That single fact reorders the whole comparison, because it means the question is not which platform calculates IVA best but which platform is allowed to issue the invoice at all. Add the monthly SAF-T (PT) billing file, the ATCUD unique document code and the QR code that has to appear on the invoice itself, and Portugal becomes one of the strictest places in the EU to build a billing product.

This piece compares the developer-facing platforms that handle EU and Portuguese VAT in real time, separates calculation from bookkeeping from filing, and says where each option actually fits.

What "real-time EU VAT management" has to include

The phrase gets stretched to cover very different products. To mean anything, a platform has to do most of the following while a transaction, invoice, settlement or ledger entry is being created:

  • Work out the VAT treatment from the transaction data.
  • Apply the current country and product rules.
  • Cover Portugal and the wider EU, including B2B reverse charge and B2C destination taxation.
  • Expose all of that through an API, SDK or webhook.
  • Keep the data for VAT, OSS, audit and accounting reporting.

Three different capabilities hide inside the words "real time":

  • Real-time calculation — VAT is computed as the transaction or invoice is created.
  • Real-time accounting — the transaction, the ledger entry and the VAT data land in the books immediately.
  • Real-time reporting — the data is transmitted to a tax authority shortly after the transaction.

Most products do the first. Very few do all three. Portugal is close to the third category without a clearance platform: the monthly SAF-T (PT) billing file gives the tax authority document-level data, and the software producing those documents has to be certified.

The Portuguese and EU rules that shape the comparison

Portugal applies 23%, 13% and 6% on the mainland, with lower rates in the autonomous regions — the Azores use 16%, 9% and 4%, and Madeira uses 22%, 12% and 4% — and 0% for exports and intra-EU supplies. The small-business exemption runs to €15,000 of turnover, below which a business charges no VAT and cannot deduct input VAT. The rules are published by the Autoridade Tributária. The regional rates are the detail most systems get wrong, because they are not a separate country code.

For qualifying intra-EU B2C distance sales and cross-border digital services, the EU-wide threshold is €10,000, set out on the European Commission's One Stop Shop portal. Above it, VAT generally follows the customer's Member State. The One Stop Shop lets a business register in one Member State and declare cross-border B2C VAT for the whole EU, but it does not remove the need for transaction-level logic.

There is also a marketplace rule that is stricter than most teams expect. Under Article 14a an electronic interface becomes the deemed supplier for distance sales of imported goods in consignments not exceeding €150, and separately for goods supplied to EU customers at any value when the underlying seller is not established in the EU. The Commission's Explanatory Notes on the VAT e-commerce rules set out both limbs. If you are building a marketplace, this changes the architecture rather than adding a field.

The shortlist at a glance

Platform Best fit Real-time VAT capability Accounting, OSS and filing scope Main caveat
Stripe Tax Products and marketplaces already on Stripe Calculates VAT as the transaction is created, Portugal included EU exports and OSS data; no Portuguese ledger, and it does not file EU returns itself Only worth it when Stripe is already the payment rail
Paddle SaaS and downloadable digital products Calculates VAT at checkout from the customer location Registers, files and remits as Merchant of Record Takes over the seller-of-record role and the invoice with it
Quaderno Smaller SaaS and digital commerce Calculates at checkout, validates VAT numbers Tax reports and records; automatic filing is not documented for every plan A tax and invoicing layer, not a ledger
Avalara AvaTax Enterprise ERP and billing stacks Real-time determination with maintained tax content VAT Reporting is a separate product in the Returns range Scoped and priced for enterprise rollouts
Fonoa Tax Engine Large platforms and marketplaces Real-time determination across 190+ jurisdictions Returns, e-invoicing and reporting; tax-number validation is a separate product No published pricing
Nordlet Embedded accounting inside marketplaces and platforms Resolves the scheme and the rates per transaction, posted together with the ledger entry Immutable double-entry ledger, payouts, OSS and IOSS figures, exportable audit trail Not certified as Portuguese billing software; no SAF-T (PT) file and no Declaração Periódica

Stripe Tax: the quick path when Stripe is already there

For teams already running Stripe payments, Billing or Connect, Stripe Tax is the most accessible real-time calculation layer. The documentation covers calculating VAT worldwide, the Tax API with PaymentIntents, collecting tax on invoices, and using Tax with Connect as a platform or marketplace.

Where Stripe stops is stated plainly by Stripe. Its filing documentation says: "You must file and remit the tax you collect for every location where you're registered." Automated filing is offered in the United States; elsewhere Stripe works with filing partners, so an EU VAT return is filed by you or by a partner, not by Stripe Tax. It is a calculation and export layer, not a set of books.

On a Portuguese stack, calculation is the least of it. Neither certification, nor ATCUD, nor the SAF-T billing file comes from a tax-calculation layer.

Paddle: hand the whole tax role to someone else

Paddle is a different category of product. It acts as Merchant of Record and takes responsibility for "calculating, filing, and remitting" tax where your customers are, so it computes VAT at checkout, issues the invoice, and files and remits for you. Its developer documentation covers Paddle.js, the catalog APIs, checkout and webhooks such as transaction.completed, which fires once a transaction reaches completed status and is the usual hook for granting access after payment.

The trade-off is structural rather than technical. Paddle becomes the seller of record, so you no longer hold the merchant, invoice and accounting model you would keep with your own checkout.

For digital products this is a genuinely attractive route in Portugal, because as Merchant of Record Paddle issues the invoice and the certification question moves to it rather than to you.

Quaderno: a tax layer for smaller digital businesses

Quaderno is one of the clearer developer-first options for smaller digital businesses that want a tax service independent of a single payment processor. Its API documents a /tax_rates/calculate endpoint that computes the applicable rate from the customer's address and the transaction type, a /tax_ids/validate endpoint that covers EU VAT numbers, and invoice, receipt and credit-note endpoints. A documented Connect section with account resources is the part a marketplace would build on.

The limit is scope. Quaderno is a tax and invoicing layer, not an accounting system with an immutable double-entry ledger, and its public material does not establish automatic filing on every plan in every country. Treat filing responsibility as something to confirm in writing.

Before using it for Portuguese invoicing, confirm the certification position explicitly. In Portugal that is a legal question about the software, not a feature question.

Avalara and Fonoa: the enterprise tax engines

Avalara's AvaTax performs real-time tax determination during checkout, invoicing or order processing, through REST APIs and SDKs. Note the product split: VAT Reporting sits separately under Returns, so an EU VAT compliance workflow is not simply "AvaTax" — scope the modules you actually need. Avalara documents a signup path with a 90-day free trial, while the production commercial model is enterprise-shaped.

Fonoa's Tax Engine states that it "calculates the correct indirect tax treatment for every transaction in real time" through a versioned API across more than 190 jurisdictions. One architectural detail matters: tax-number validation is a separate Fonoa product (Validate), not part of Tax Engine, so if VIES evidence matters to you, scope it explicitly instead of assuming the engine covers it.

For a Portuguese build the useful question to put to either vendor is not about determination coverage but about certified invoicing and the SAF-T (PT) file.

Where Nordlet fits: the VAT answer and the ledger entry are the same record

Nordlet is an accounting API for marketplaces and platforms that need ledgers, payouts, EU tax and an exportable audit trail inside their own product, rather than an invoicing app attached to a checkout.

The architectural difference is that VAT determination and the accounting entry belong to one system. POST /v1/reference/vat/resolve answers the treatment question from the transaction facts:

{
  "customerCountryCode": "PT",
  "customerIsBusiness": false,
  "supplyType": "digital"
}

{
  "scheme": "oss_union",
  "vatCountryCode": "PT",
  "reverseCharge": false,
  "deemedSupplier": false,
  "zeroRated": false,
  "rates": [
    { "category": "standard", "ratePercent": "23.00" },
    { "category": "reduced", "ratePercent": "13.00" },
    { "category": "reduced", "ratePercent": "6.00" }
  ],
  "legalBasis": "Directive 2006/112/EC art. 58 — taxable where the consumer resides; report via the Union OSS"
}

Change the customer to a business with a valid Portuguese VAT number and the same call returns reverse_charge with Directive 2006/112/EC art. 44, 196 — VAT due by the customer (reverse charge). Set actingAsMarketplace with a seller established outside the EU and it returns deemedSupplier: true under art. 14a(2). The legal basis travels with the answer, which is the part an auditor asks about years later.

Nine schemes are modelled: domestic, intra_eu_b2b, reverse_charge, oss_union, ioss, marketplace_deemed, export, out_of_scope and sme_exempt. The €10,000 distance-selling threshold is tracked rather than assumed — /v1/declarations/eu/distance-sales-threshold/get reports where a company stands against it, and /v1/declarations/eu/oss/compute and /v1/declarations/eu/ioss/compute produce the period figures, including a corrections section for earlier periods. Rates come from the European Commission's TEDB feed with effective dates, and a company can override them per country.

The determination then posts into an immutable double-entry ledger with the VAT metadata attached to the entry, so there is no second reconciliation between a tax engine and a separate system of record. Monetary amounts are decimal strings, never floating-point numbers. Around that: typed SDKs, webhooks such as sale_invoice.paid, Idempotency-Key support for safe retries, sandbox companies, VIES validation frozen against the invoice, multi-company support, and period locking so a closed month cannot be quietly edited.

The Portuguese boundary is the widest gap of any country covered here, and pretending otherwise would waste your time. Nordlet is not certified as Portuguese billing software, does not generate ATCUD codes or the invoice QR code, does not produce the SAF-T (PT) billing file, and ships no Portuguese return pack — /v1/declarations/eu/vat-return/compute with countryCode: "PT" returns a 422 naming Lithuania, Germany and Poland. The rates the VAT engine returns are per country, so the Azores and Madeira rates need a company-level override rather than arriving automatically. What Nordlet does cover for a Portuguese group is the ledger side — VAT determination with its legal basis, an immutable double-entry ledger, OSS and IOSS computation with corrections, VIES validation frozen against the invoice, and EN 16931 invoices over Peppol BIS 3.0. If your Portuguese entity issues its own invoices, certified billing software is a separate requirement you still have to satisfy.

The honest summary: if you need live calculation in as many countries as possible and someone else to file, the enterprise tax engines and the Merchant of Record services are further ahead. If your central requirement is real books — a marketplace-aware double-entry ledger where settlements and VAT sit in one place — that is the gap Nordlet is built for, and none of the calculation layers fills it. The API reference shows the full surface before you commit.

What Portugal makes you file

Portugal regulates the invoice, the file and the return, in that order of difficulty.

  • Certified invoicing software — invoices must be issued from software certified by the tax authority, and each document carries a unique code (ATCUD) and a QR code.
  • SAF-T (PT) billing file — submitted monthly by the 5th of the following month, carrying the billing data document by document.
  • IVA return (Declaração Periódica) — filed monthly when turnover exceeds €650,000 and quarterly otherwise, by the 20th of the second following month, with payment by the 25th.
  • E-invoicing — mandatory towards public bodies. PDF invoices are accepted as electronic invoices until the end of 2026.

If you take one thing from this section: in Portugal, choose the invoicing component first and the tax engine second.

The full picture for the country — corporate tax, payroll, filing calendar and the authorities behind each form — is on the Portugal tax page.

Selection criteria worth running before you commit

Before treating any "VAT-ready" product as equivalent to another, check it against these:

  • Calculation or bookkeeping — does it determine the VAT treatment, or only store a code you pass in?
  • Portuguese coverage — 23%, 13%, 6% on the mainland plus the different Azores and Madeira rates, and the €15,000 exemption?
  • EU destination logic — can it tell Portuguese VAT from another Member State's for a B2C sale?
  • B2B VAT-number validation — does it check VIES and keep the evidence?
  • OSS and IOSS — does it aggregate, prepare, submit, or only export?
  • Marketplace liability — can it model seller, platform and deemed-supplier roles?
  • Accounting integrity — does each calculation produce a matching ledger entry?
  • Developer ergonomics — REST API, SDKs, webhooks, sandbox, idempotency, versioning?
  • Audit trail — rate, rule, location evidence, VAT number, timestamp, revision history?
  • Certification and SAF-T (PT) — is the invoicing software certified by the tax authority, does it emit ATCUD and the QR code, and does it produce the monthly SAF-T (PT) billing file?
  • Filing responsibility — exactly which step does the vendor accept?

FAQ

Which platform offers complete real-time EU VAT management in Portugal?

None should be described as covering all three real-time capabilities for every business model, and in Portugal an extra question comes first: is the software certified to issue invoices at all. Certification, not determination coverage, is the gate.

Is Stripe Tax enough for a Portuguese marketplace?

No, and not because of the calculation. Certified invoicing, ATCUD, the QR code and the SAF-T (PT) billing file are all outside a tax-calculation layer, and they are the requirements with legal force.

Does Nordlet file Portuguese VAT returns automatically?

No. It does not compute the Declaração Periódica, it does not produce the SAF-T (PT) billing file, and it is not certified as Portuguese billing software. Return packs ship for Lithuania, Germany and Poland.

How do the Azores and Madeira VAT rates work?

They are lower than the mainland: 16%, 9% and 4% in the Azores, and 22%, 12% and 4% in Madeira. Because they are not separate country codes, most systems need an explicit override rather than resolving them automatically.

What to do first

In Portugal, start from the invoicing requirement rather than the tax engine, because certification decides what you are allowed to do. If you sell digital products and want the certification question to belong to someone else, a Merchant of Record such as Paddle is worth testing. If your Portuguese entity needs its own books, payouts and audit trail alongside certified billing, get started with the sandbox and confirm exactly which parts are covered before you build around it. Pricing is published rather than quote-only.

Sources

Every vendor claim above links to that vendor's own documentation. The rules themselves come from:

Vendor capabilities and national mandates both change. Everything here was checked against public documentation on 8 September 2026; verify anything you are about to build on.