Nordlet

← Blogue

IVA da UE em tempo real para programadores a construir em Portugal

Uma comparação fundamentada de plataformas de contabilidade e impostos que gerem o IVA português e da UE através de API, SDK e webhooks, com notas claras sobre o que cada uma abrange efetivamente.

Nordlet Team · · 15 min de leitura

Portugal certifica o software de faturação. Este único facto altera toda a comparação, uma vez que significa que a questão não é saber que plataforma calcula melhor o IVA, mas sim que plataforma tem permissão para emitir a fatura. Se juntarmos o ficheiro de faturação SAF-T (PT) mensal, o código único de documento ATCUD e o código QR que tem de constar na própria fatura, Portugal torna-se num dos locais mais estritos da UE para criar um produto de faturação.

Este artigo compara as plataformas orientadas a programadores que gerem o IVA da UE e português em tempo real, separa o cálculo da contabilidade e da entrega de declarações, e indica onde cada opção se enquadra realmente.

O que a "gestão de IVA da UE em tempo real" tem de incluir

A expressão é utilizada para abranger produtos muito diferentes. Para significar alguma coisa, uma plataforma tem de executar a maior parte das seguintes tarefas enquanto uma transação, fatura, liquidação ou lançamento contabilístico está a ser criado:

  • Apurar o enquadramento de IVA a partir dos dados da transação.
  • Aplicar as regras vigentes do país e do produto.
  • Cobrir Portugal e o resto da UE, incluindo a autoliquidação (reverse charge) B2B e a tributação no destino B2C.
  • Expor tudo isto através de uma API, SDK ou webhook.
  • Guardar os dados para efeitos de IVA, OSS, auditoria e prestação de contas contabilísticas.

Três capacidades diferentes ocultam-se por trás das palavras "em tempo real":

  • Cálculo em tempo real - o IVA é calculado à medida que a transação ou a fatura é criada.
  • Contabilidade em tempo real - a transação, o lançamento no razão e os dados de IVA entram imediatamente na contabilidade.
  • Reporte em tempo real - os dados são transmitidos à autoridade tributária pouco tempo após a transação.

A maioria dos produtos faz o primeiro. Muito poucos fazem os três. Portugal está próximo da terceira categoria sem uma plataforma de desalfandegamento (clearance): o ficheiro de faturação SAF-T (PT) mensal fornece à autoridade tributária dados ao nível do documento, e o software que produz esses documentos tem de ser certificado.

As regras portuguesas e da UE que moldam a comparação

Portugal aplica 23%, 13% e 6% no continente, com taxas mais baixas nas regiões autónomas - os Açores aplicam 16%, 9% e 4%, e a Madeira aplica 22%, 12% e 4% - e 0% nas exportações e transmissões intracomunitárias. A isenção para pequenas empresas vai até aos 15.000 € de volume de negócios, abaixo do qual uma empresa não cobra IVA e não pode deduzir o IVA suportado. As regras são publicadas pela Autoridade Tributária. As taxas regionais são o pormenor que a maioria dos sistemas faz erradamente, uma vez que não constituem um código de país separado.

Para as vendas à distância B2C intracomunitárias elegíveis e serviços digitais transfronteiriços, o limiar a nível da UE é de 10.000 €, estabelecido no portal do Balcão Único da Comissão Europeia. Acima deste valor, o IVA segue geralmente o Estado-Membro do cliente. O Balcão Único permite que uma empresa se registe num Estado-Membro e declare o IVA B2C transfronteiriço para toda a UE, mas não elimina a necessidade de lógica ao nível da transação.

Existe também uma regra para os mercados online (marketplaces) que é mais restrita do que a maioria das equipas espera. Ao abrigo do artigo 14.º-A, uma interface eletrónica passa a ser o fornecedor presumido (deemed supplier) nas vendas à distância de bens importados em remessas que não excedam 150 €, e separadamente para bens fornecidos a clientes da UE de qualquer valor quando o vendedor subjacente não está estabelecido na UE. As notas explicativas da Comissão sobre as regras do IVA no comércio eletrónico estabelecem ambas as vertentes. Se está a construir um marketplace, isto altera a arquitetura em vez de adicionar apenas um campo.

Visão geral das principais opções

Plataforma Melhor adequação Capacidade de IVA em tempo real Âmbito de contabilidade, OSS e declarações Principal ressalva
Stripe Tax Produtos e marketplaces já presentes na Stripe Calcula o IVA à medida que a transação é criada, incluindo Portugal Exportações para a UE e dados do OSS; sem razão (ledger) português, e não entrega as declarações da UE diretamente Apenas compensa quando a Stripe já é o canal de pagamentos
Paddle SaaS e produtos digitais descarregáveis Calcula o IVA no checkout a partir da localização do cliente Regista, entrega e retém impostos como Merchant of Record Assume o papel de comerciante registado (merchant of record) e a respetiva fatura
Quaderno SaaS de menor dimensão e comércio digital Calcula no checkout, valida números de IVA Relatórios e registos fiscais; a entrega automática não está documentada para todos os planos Uma camada de impostos e faturação, não um razão (ledger)
Avalara AvaTax ERP empresariais e arquiteturas de faturação Determinação em tempo real com conteúdo fiscal atualizado O relatório de IVA (VAT Reporting) é um produto separado na gama Returns Dimensionado e com preços para implementações empresariais
Fonoa Tax Engine Plataformas e marketplaces de grande dimensão Determinação em tempo real em mais de 190 jurisdições Declarações, faturação eletrónica e relatórios; a validação de NIF é um produto separado Sem preços públicos
Nordlet Contabilidade embebida em marketplaces e plataformas Resolve o regime e as taxas por transação, lançados em conjunto com o registo no razão Razão de partidas dobradas imutável, pagamentos (payouts), valores de OSS e IOSS, trilho de auditoria exportável Não certificado como software de faturação português; sem ficheiro SAF-T (PT) e sem Declaração Periódica

Stripe Tax: o caminho rápido quando a Stripe já está presente

Para equipas que já utilizam pagamentos Stripe, Billing ou Connect, o Stripe Tax é a camada de cálculo em tempo real mais acessível. A documentação abrange o cálculo do IVA a nível mundial, a API Tax com PaymentIntents, a cobrança de impostos em faturas e a utilização do Tax com o Connect como plataforma ou marketplace.

Onde a Stripe cessa as suas funções é indicado de forma clara pela mesma. A respetiva documentação de entrega de declarações refere: "Deve entregar e liquidar o imposto que cobra em cada local onde estiver registado." A entrega automatizada é oferecida nos Estados Unidos; noutros locais, a Stripe trabalha com parceiros de entrega, pelo que a declaração de IVA da UE é entregue por si ou por um parceiro, e não pelo Stripe Tax. Trata-se de uma camada de cálculo e exportação, e não de um conjunto de livros de contabilidade.

Numa arquitetura portuguesa, o cálculo é o menor dos problemas. Nem a certificação, nem o ATCUD, nem o ficheiro de faturação SAF-T provêm de uma camada de cálculo de impostos.

Paddle: entregar toda a responsabilidade fiscal a terceiros

O Paddle pertence a uma categoria de produto diferente. Atua como Merchant of Record e assume a responsabilidade de "calcular, entregar e liquidar" os impostos onde se encontram os seus clientes, calculando assim o IVA no checkout, emitindo a fatura, entregando as declarações e liquidando o valor por si. A respetiva documentação para programadores abrange o Paddle.js, as API de catálogo, o checkout e webhooks como transaction.completed, que é acionado assim que uma transação atinge o estado completed e constitui o webhook habitual para conceder acesso após o pagamento.

O compromisso é estrutural e não técnico. O Paddle torna-se no vendedor registado (merchant of record), pelo que deixa de possuir o modelo de comerciante, de fatura e de contabilidade que manteria com o seu próprio checkout.

Para produtos digitais, esta é uma via genuinamente atrativa em Portugal, uma vez que, enquanto Merchant of Record, o Paddle emite a fatura e a questão da certificação transfere-se para si própria em vez de recair sobre si.

Quaderno: uma camada fiscal para empresas digitais mais pequenas

O Quaderno é uma das opções mais claras orientadas a programadores para empresas digitais mais pequenas que pretendem um serviço fiscal independente de um único processador de pagamentos. A sua API documenta um endpoint /tax_rates/calculate que calcula a taxa aplicável a partir da morada do cliente e do tipo de transação, um endpoint /tax_ids/validate que abrange os números de IVA da UE, bem como endpoints para faturas, recibos e notas de crédito. Uma secção Connect documentada com recursos de conta é a parte sobre a qual um marketplace seria construído.

O limite reside no âmbito. O Quaderno é uma camada de impostos e faturação, e não um sistema contabilístico com um razão de partidas dobradas imutável, e o respetivo material público não estabelece a entrega automática de declarações em todos os planos e em todos os países. Considere a responsabilidade de entrega como algo a confirmar por escrito.

Antes de o utilizar para a faturação portuguesa, confirme explicitamente a posição em termos de certificação. Em Portugal, trata-se de uma questão jurídica relativa ao software, e não de uma questão de funcionalidades.

Avalara e Fonoa: os motores fiscais empresariais

O AvaTax da Avalara efetua a determinação de impostos em tempo real durante o checkout, faturação ou processamento de encomendas, através de API REST e SDK. Note a divisão de produtos: o relatório de IVA (VAT Reporting) situa-se separadamente em Returns, pelo que um fluxo de trabalho de conformidade com o IVA da UE não se resume a um simples "AvaTax" - dimensione os módulos de que realmente necessita. A Avalara documenta um caminho de registo com um período experimental gratuito de 90 dias, enquanto o modelo comercial de produção está moldado para o tecido empresarial.

O Tax Engine da Fonoa declara que "calcula o tratamento correto de imposto indireto para cada transação em tempo real" através de uma API com controlo de versões em mais de 190 jurisdições. Um pormenor arquitetónico importa: a validação de números de contribuinte é um produto Fonoa separado (Validate), e não parte do Tax Engine, pelo que, se a prova VIES for importante para si, dimensione-a explicitamente em vez de assumir que o motor a inclui.

Para uma construção em Portugal, a questão útil a colocar a qualquer um dos fornecedores não diz respeito à cobertura de determinação, mas sim à faturação certificada e ao ficheiro SAF-T (PT).

Onde o Nordlet se enquadra: a resposta do IVA e o lançamento no razão são o mesmo registo

O Nordlet é uma API de contabilidade para marketplaces e plataformas que necessitam de razões, pagamentos (payouts), impostos da UE e um trilho de auditoria exportável dentro do seu próprio produto, em vez de uma aplicação de faturação associada a um checkout.

A diferença arquitetónica reside no facto de a determinação do IVA e o lançamento contabilístico pertencerem a um único sistema. POST /v1/reference/vat/resolve responde à questão do enquadramento a partir dos factos da transação:

{
  "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"
}

Se alterar o cliente para uma empresa com um número de IVA português válido, a mesma chamada devolve reverse_charge com Directive 2006/112/EC art. 44, 196 - VAT due by the customer (reverse charge). Se definir actingAsMarketplace com um vendedor estabelecido fora da UE, devolve deemedSupplier: true ao abrigo do art. 14a(2). A base legal viaja com a resposta, que é a parte sobre a qual um auditor questiona anos mais tarde.

São modelados nove regimes: domestic, intra_eu_b2b, reverse_charge, oss_union, ioss, marketplace_deemed, export, out_of_scope e sme_exempt. O limiar de vendas à distância de 10.000 € é monitorizado em vez de ser assumido - /v1/declarations/eu/distance-sales-threshold/get reporta a posição de uma empresa face ao mesmo, e /v1/declarations/eu/oss/compute e /v1/declarations/eu/ioss/compute produzem os valores do período, incluindo uma secção de correções para períodos anteriores. As taxas provêm do canal TEDB da Comissão Europeia com datas de vigência, podendo uma empresa anulá-las por país.

A determinação é depois lançada num razão de partidas dobradas imutável com os metadados de IVA associados ao lançamento, pelo que não existe uma segunda reconciliação entre um motor fiscal e um sistema de registo separado. Os montantes monetários são strings decimais, nunca números de vírgula flutuante. Em redor disto: SDK tipados, webhooks como sale_invoice.paid, suporte para Idempotency-Key para tentativas seguras, empresas sandbox, validação VIES congelada face à fatura, suporte multi-empresa e bloqueio de período para que um mês fechado não possa ser discretamente alterado.

A fronteira portuguesa é a maior lacuna de qualquer país aqui abrangido, e fingir o contrário seria uma perda de tempo. O Nordlet não está certificado como software de faturação português, não gera códigos ATCUD nem o código QR da fatura, não produz o ficheiro de faturação SAF-T (PT) e não envia nenhum pacote de declaração português - /v1/declarations/eu/vat-return/compute com countryCode: "PT" devolve um 422 mencionando a Lituânia, a Alemanha e a Polónia. As taxas que o motor de IVA devolve são por país, pelo que as taxas dos Açores e da Madeira necessitam de uma anulação ao nível da empresa em vez de chegarem automaticamente. O que o Nordlet abrange para um grupo português é a vertente do razão - determinação do IVA com a respetiva base legal, um razão de partidas dobradas imutável, apuramento de OSS e IOSS com correções, validação VIES congelada face à fatura e faturas EN 16931 sobre Peppol BIS 3.0. Se a sua entidade portuguesa emitir as suas próprias faturas, o software de faturação certificado é um requisito separado que continua a ter de satisfazer.

O resumo honesto: se precisa de cálculo em direto no maior número de países possível e que outra entidade faça a entrega, os motores fiscais empresariais e os serviços de Merchant of Record estão mais avançados. Se o seu requisito central são livros de contabilidade reais - um razão de partidas dobradas com consciência de marketplace onde as liquidações e o IVA se encontram no mesmo local - essa é a lacuna para a qual o Nordlet foi construído, e nenhuma das camadas de cálculo a preenche. A referência da API mostra toda a superfície antes de se comprometer.

O que Portugal obriga a entregar

Portugal regulamenta a fatura, o ficheiro e a declaração, por essa ordem de dificuldade.

  • Software de faturação certificado - as faturas devem ser emitidas a partir de software certificado pela autoridade tributária, e cada documento ostenta um código único (ATCUD) e um código QR.
  • Ficheiro de faturação SAF-T (PT) - submetido mensalmente até ao dia 5 do mês seguinte, transportando os dados de faturação documento a documento.
  • Declaração de IVA (Declaração Periódica) - entregue mensalmente quando o volume de negócios excede 650.000 € e trimestralmente nos restantes casos, até ao dia 20 do segundo mês seguinte, com pagamento até ao dia 25.
  • Faturação eletrónica - obrigatória perante organismos públicos. As faturas em PDF são aceites como faturas eletrónicas até ao final de 2026.

Se retirar uma conclusão desta secção: em Portugal, escolha primeiro o componente de faturação e só depois o motor fiscal.

O panorama completo para o país - imposto sobre as sociedades, salários, calendário de entrega e as autoridades por trás de cada impresso - encontra-se na página de impostos de Portugal.

Critérios de seleção a executar antes de se comprometer

Antes de tratar qualquer produto "preparado para o IVA" como equivalente a outro, verifique-os face aos seguintes pontos:

  • Cálculo ou contabilidade - determina o tratamento do IVA ou apenas armazena um código que lhe transmite?
  • Cobertura portuguesa - 23%, 13%, 6% no continente mais as diferentes taxas dos Açores e da Madeira, e a isenção de 15.000 €?
  • Lógica de destino da UE - consegue distinguir o IVA português do de outro Estado-Membro para uma venda B2C?
  • Validação de número de IVA B2B - verifica o VIES e guarda a prova?
  • OSS e IOSS - agrega, prepara, submete ou apenas exporta?
  • Responsabilidade do marketplace - consegue modelar os papéis de vendedor, plataforma e fornecedor presumido (deemed supplier)?
  • Integridade contabilística - cada cálculo produz um lançamento correspondente no razão?
  • Ergonomia para programadores - API REST, SDK, webhooks, sandbox, idempotência, controlo de versões?
  • Trilho de auditoria - taxa, regra, prova de localização, número de IVA, carimbo temporal, histórico de revisões?
  • Certificação e SAF-T (PT) - o software de faturação é certificado pela autoridade tributária, emite o ATCUD e o código QR, e produz o ficheiro de faturação SAF-T (PT) mensal?
  • Responsabilidade de entrega - qual é exatamente a etapa que o fornecedor assume?

FAQ

Que plataforma oferece uma gestão completa do IVA da UE em tempo real em Portugal?

Nenhuma deve ser descrita como abrangendo todas as três capacidades em tempo real para todos os modelos de negócio e, em Portugal, surge primeiro uma questão adicional: o software está certificado para emitir faturas? A certificação, e não a cobertura de determinação, é o crivo.

O Stripe Tax é suficiente para um marketplace português?

Não, e não por causa do cálculo. A faturação certificada, o ATCUD, o código QR e o ficheiro de faturação SAF-T (PT) estão todos fora de uma camada de cálculo de impostos, sendo estes os requisitos com força legal.

O Nordlet entrega as declarações de IVA portuguesas automaticamente?

Não. Não calcula a Declaração Periódica, não produz o ficheiro de faturação SAF-T (PT) e não está certificado como software de faturação português. Os pacotes de declaração são enviados para a Lituânia, a Alemanha e a Polónia.

Como funcionam as taxas de IVA dos Açores e da Madeira?

São inferiores às do continente: 16%, 9% e 4% nos Açores, e 22%, 12% e 4% na Madeira. Como não são códigos de país separados, a maioria dos sistemas necessita de uma anulação explícita em vez de os resolver automaticamente.

O que fazer primeiro

Em Portugal, comece pelo requisito de faturação e não pelo motor fiscal, uma vez que a certificação decide o que lhe é permitido fazer. Se vende produtos digitais e pretende que a questão da certificação pertença a outrem, vale a pena testar um Merchant of Record como o Paddle. Se a sua entidade portuguesa necessita dos seus próprios livros, pagamentos e trilho de auditoria juntamente com a faturação certificada, comece a utilizar a sandbox e confirme exatamente quais as partes abrangidas antes de construir a sua solução em redor da mesma. Os preços são publicados e não obtidos apenas mediante orçamento.

Fontes

Todas as alegações dos fornecedores acima fazem hiperligação para a documentação do respetivo fornecedor. As regras em si provêm de:

As capacidades dos fornecedores e os mandatos nacionais estão sujeitos a alterações. Tudo o que aqui consta foi verificado face à documentação pública a 8 de setembro de 2026; verifique qualquer aspeto sobre o qual esteja prestes a construir.