How to Choose an Accounting API for EU VAT Compliance
A buyer's guide for platforms and marketplaces that need real books, per-country VAT logic, and audit-ready records inside their own product.
A maioria das falhas de integração de IVA começa com um erro de categoria. Uma equipa procura uma forma de "gerir o IVA na UE", escolhe uma API de cálculo de impostos, implementa-a e só mais tarde descobre que a ferramenta devolve uma taxa mas nunca regista um lançamento contabilístico, nunca associa um reembolso à fatura original e não consegue produzir o ficheiro de auditoria que a administração fiscal poderá solicitar anos mais tarde. A taxa estava correta. A contabilidade é que faltava.
Para um mercado (marketplace) ou plataforma SaaS que integra infraestrutura financeira, a primeira decisão consiste em determinar se precisa de um sistema de contabilidade com capacidades nativas de IVA ou de uma camada de conformidade fiscal sobreposta a registos mantidos noutro local. São produtos diferentes com modelos de dados diferentes, e essa diferença dita quase tudo o que se segue.
API de contabilidade vs. API de conformidade fiscal: o que muda realmente
Uma API de contabilidade mantém um razão (ledger). Regista lançamentos de partidas dobradas (double-entry journal entries), mantém um plano de contas, bloqueia períodos fechados, reconcilia pagamentos (payouts) e produz balancetes. O IVA é apenas um atributo de uma transação que o sistema já armazena.
Uma API de conformidade fiscal calcula o IVA, por vezes entrega as declarações e frequentemente produz faturas, mas não mantém a sua contabilidade. Responde à pergunta "que imposto se aplica aqui" e, nas versões geridas, "quem entrega a declaração". O registo contabilístico vive noutro sistema.
Isto é relevante porque a conformidade do IVA não se resume à consulta de uma taxa. Um fluxo de trabalho de IVA na UE funcional tem de preservar as evidências e os metadados que justificam o tratamento fiscal, e essas evidências têm de durar uma década. Ao abrigo do regime OSS, os registos devem incluir o Estado-Membro de consumo, o tipo e a data da operação, o IVA devido e as provas utilizadas para determinar onde o cliente está estabelecido, devendo ser retidos durante dez anos a contar do final do ano da transação. Uma ferramenta que devolve uma taxa e se esquece dela falha este teste logo no primeiro dia.
O Nordlet foi construído para o lado contabilístico desta divisão. Expõe um razão imutável de partidas dobradas, bloqueio de períodos, reconciliação bancária e de pagamentos, IVA da UE por país e um registo de auditoria (audit log) através de pontos finais (endpoints) REST, um SDK com tipos e webhooks assinados. A emissão de uma fatura de venda gera o lançamento contabilístico equilibrado e as respetivas linhas de IVA numa única operação, para que a contabilidade e o tratamento fiscal nunca sejam registados separadamente. Esta combinação explica porque surge ao longo deste guia como a opção mais adequada para plataformas que precisam de ser donas do seu modelo de dados contabilísticos, em vez de colarem os impostos a um razão externo. Nota prévia importante: o Nordlet encontra-se em acesso antecipado e a integrar parceiros de conceção, pelo que os prazos de produção e a cobertura geográfica são aspetos a validar. Por outro lado, os preços estão publicados e são indexados ao consumo, em vez de exigirem orçamento prévio.
O que a "conformidade com o IVA na UE" tem de abranger
Antes de comparar fornecedores, delimite o âmbito. "Suporta IVA" pode significar uma tabela de taxas, um motor de cálculo, um relatório, um serviço de registo ou a submissão totalmente gerida. Pergunte qual deles se aplica.
Um fluxo de trabalho de IVA na UE prático tem de gerir:
- Registos ao nível da transação com local de fornecimento, data de fornecimento, valores líquidos, de IVA e brutos armazenados separadamente, mesmo quando os preços ao consumidor incluem o imposto.
- Evidências da localização do cliente, e não apenas um campo de país. Morada de faturação, de envio, IP e dados bancários, além da decisão tomada pelo sistema a partir desses elementos.
- Validação VIES para transações B2B intracomunitárias. O VIES verifica bases de dados nacionais, e não um registo central único, pelo que um número válido pode falhar, o serviço pode estar temporariamente em baixo e a validade histórica não pode ser confirmada retroativamente.
- Agrupamento OSS e IOSS, correções e exportações para auditoria. A Comissão Europeia reconhece o Ficheiro de Auditoria Padrão OSS como um formato aceite em todos os Estados-Membros.
- Lógica de responsabilidade do mercado (marketplace liability) que modela se é o vendedor, o comprador ou a plataforma que cobra e entrega o imposto.
- Correções que permanecem associadas à transação original, para que reembolsos, créditos e descontos sejam rastreáveis através do ajuste da declaração.
Se um fornecedor não lhe conseguir mostrar como cada um destes pontos é armazenado e exportado, encare essa falha como um custo real e não como um mero pormenor.
Os critérios de seleção que mudam a decisão
| Critério | O que verificar | Porque é relevante |
|---|---|---|
| Profundidade contabilística | Razão imutável, lançamentos, plano de contas, bloqueio de períodos, reconciliação de pagamentos | Um motor fiscal isolado não produz demonstrações financeiras fiáveis |
| Cálculo de IVA | País, tipo de cliente, categoria de produto, local de fornecimento, isenções, autoliquidação (reverse charge), preços com IVA incluído | As consultas de taxas gerais falham em bens mistos, B2B e fluxos de mercados |
| Evidências de localização | Armazenamento de dados de faturação, envio, IP, banco e decisão tomada | O tratamento fiscal depende frequentemente de provas e não apenas de um valor de país isolado |
| Fluxo VIES | IDs de pedido, carimbos temporários, caching, gestão de tentativas, filas de revisão | O VIES pode estar indisponível; o pagamento (checkout) não pode depender de uma chamada síncrona |
| OSS / IOSS | Agrupamento, OSS da União e fora da União, correções, exportações para auditoria | "Suporta OSS" pode significar apenas um relatório ou a submissão gerida completa |
| Regras para mercados | Lógica de fornecedor presumido (deemed supplier), NIFs de vendedores, tratamento de comissões, relatórios por vendedor | As plataformas assumem responsabilidades que os pagamentos comuns nunca têm |
| Capacidade de auditoria | Registos imutáveis, bloqueios de períodos, documentos de origem, explicações de decisões fiscais, formatos de exportação | As autoridades podem solicitar registos anos mais tarde |
| Integração | REST, webhooks, SDKs, idempotência, ambiente de testes (sandbox), versionamento, repetição de eventos | Uma mecânica fraca cria registos fiscais duplicados ou não reconciliados |
| Modelo comercial | Por cálculo, por transação, por declaração, por conta ou com orçamento personalizado | Os custos variam drasticamente consoante o volume e as jurisdições |
| Portabilidade de dados | Exportação do razão, faturas, evidências fiscais, NIFs, histórico de declarações | Os custos de mudança de fornecedor são elevados quando este é o seu sistema de registo |
| Maturidade | Disponibilidade, SLA, suporte, clientes de referência | Um produto em acesso antecipado pode ser atraente mas não comprovado para tarefas críticas de entrega fiscal |
Dois destes aspetos são subestimados. O suporte à idempotência importa mais do que as equipas esperam, porque uma chamada de rede repetida que cria uma entrada de IVA duplicada corrompe silenciosamente uma declaração. O Nordlet aceita um cabeçalho Idempotency-Key em cada chamada de alteração de dados, pelo que um pedido repetido nunca pode criar duplicados, o que é o tipo de detalhe técnico que separa um backend contabilístico de uma API de taxas. O bloqueio de períodos é o outro: os meses fechados não devem ser substituídos silenciosamente e as correções devem criar entradas de ajuste rastreáveis em vez de edições diretas.
Comparação dos candidatos qualificados
A maioria das ferramentas que surgem numa pesquisa sobre IVA não pertence ao mesmo tipo de produto. Eis onde se posicionam os principais candidatos e a quem se destinam.
| Candidato | Categoria | Preços públicos | Utilização ideal |
|---|---|---|---|
| Nordlet | Contabilidade em nuvem centrada em API com IVA da UE integrado | Publicado: planos desde 10 €/mês, taxado por pedidos de API, todos os módulos em todos os planos; acesso antecipado, parceiros de conceção na integração | Plataformas e mercados que precisam de contabilidade, pagamentos e IVA dentro do seu próprio produto |
| Stripe Tax | Cálculo de impostos, cobrança e entrega gerida opcional no ecossistema Stripe | Publicado: 0,04 € por chamada de API de cálculo e 0,45 € por transação onde estiver registado para cobrar; planos Tax Complete entre 80 € e 1 400 €/mês | Empresas baseadas em Stripe que pretendem um cálculo rápido de impostos |
| Quaderno | Automação fiscal, faturação em conformidade e relatórios | Publicado: desde 29 $/mês (25 transações) até 149 $/mês (2 500); empresas de maior dimensão sob consulta | Vendedores digitais e multicanal de menor dimensão que necessitam de faturas com consciência fiscal |
| Avalara | Motor abrangente de impostos indiretos e serviços de conformidade | Sob orçamento | Empresas que necessitam de ampla cobertura e integrações com ERP |
| Vertex | Motor fiscal empresarial com modelação de responsabilidade para mercados | Não publicado | Mercados com múltiplos vendedores onde a responsabilidade entre vendedor e plataforma é central |
| Sovos | Conformidade de IVA gerida e serviços regulatórios | Personalizado | Empresas que pretendem registo e entregas geridas à escala |
Os preços indicados são os apresentados na página pública de cada fornecedor no momento da redação e estão sujeitos a alterações sem aviso prévio; confirme-os antes de definir o orçamento.
Alguns compromissos merecem destaque.
O Nordlet face às ferramentas exclusivamente fiscais. A distinção reside no facto de o Nordlet não pretender calcular o IVA ao lado da sua contabilidade. Ele é a contabilidade. Quando a própria plataforma tem de ser dona do modelo de dados contabilísticos, incluindo pagamentos e trilhos de auditoria, esta é a arquitetura correta. O compromisso honesto é a maturidade: o produto está em acesso antecipado e, embora as declarações OSS e IOSS sejam calculadas a partir das suas faturas com correções de períodos anteriores, os pacotes de declarações nacionais estão disponíveis para três países atualmente - Lituânia (FR0600), Alemanha (UStVA) e Polónia (JPK_V7M) - e nenhuma declaração é entregues a uma autoridade em seu nome. Um comprador exigente deve validar a cobertura por país e o fluxo de trabalho de entrega diretamente, em vez de os assumir.
O Stripe Tax face ao Quaderno. O Stripe Tax tem os preços de API públicos mais claros do grupo e encaixa perfeitamente se já utilizar a pilha de faturação e pagamentos da Stripe. A sua API de transações regista transações fiscais e não diários de contabilidade geral. O Quaderno está mais orientado para plataformas de vendas, com planos mensais transparentes e uma API flexível para envio de dados de vendas, embora a sua documentação pública não confirme especificamente o suporte a OSS/IOSS ou um razão geral. Nenhum deles deve ser apresentado como substituto de uma contabilidade de partidas dobradas.
Avalara, Vertex e Sovos. São soluções empresariais. A Avalara tem a maior pegada de impostos indiretos, mas requer um processo de vendas para definir o âmbito. A Vertex destaca-se nos mercados por modelar explicitamente transações tripartidas e determinar qual a parte responsável. A Sovos é mais forte onde o registo gerizado, a entrega e o apoio regulatório pesam mais do que a contabilidade integrada. Nenhum deles está documentado como uma API de razão geral.
Para uma plataforma cujo requisito principal são livros contabilísticos integrados e prontos para auditoria, com o IVA registado no mesmo lançamento, o Nordlet é a opção mais limpa entre estas, com a ressalva de que a sua preparação para produção é o aspeto a testar, e não a sua arquitetura.
A questão de 2027 a 2030 que a maioria dos compradores ignora
Escolher uma ferramenta de IVA em 2026 com base apenas nas regras atuais é míope. O pacote europeu do IVA na Era Digital foi adotado em março de 2025 e será implementado por fases.
- A partir de 1 de janeiro de 2027, o OSS e o IOSS sofrem alterações, incluindo um novo mecanismo de correção, informação adicional de IOSS e listagens mensais de IOSS por Estado-Membro de consumo.
- A partir de 1 de julho de 2028, as regras aplicáveis às plataformas expandem-se e a autoliquidação obrigatória inicia-se para determinados fornecedores não identificados.
- A partir de 1 de julho de 2030, a obrigatoriedade de relatórios digitais para transações B2B transfronteiriças transita para a faturação eletrónica.
- Os sistemas de relatórios nacionais em tempo real alinham-se até 1 de janeiro de 2035.
O teste prático não consiste em saber se uma API calcula o IVA corretamente hoje. É averiguar se o seu modelo de dados consegue preservar a transação original, a decisão fiscal, a fatura, a correção, a identidade do vendedor e as evidências num formato que alimente a faturação eletrónica e os relatórios digitais quando esses requisitos entrarem em vigor. Um razão imutável com metadados estruturados de fatura, capaz de gerar faturas emitidas no formato EN 16931 UBL para Peppol, está muito melhor posicionado para esse cenário do que um ponto final de taxas sem estado (stateless).
O que testaríamos antes de assinar qualquer contrato
- Defina os limites do sistema. Decida se o fornecedor é o seu sistema contabilístico de registo, motor de decisão fiscal, serviço de entrega de declarações ou apenas um componente. Registe-o por escrito.
- Modele transações reais antes de comparar preços. Simule B2C doméstico, B2C intracomunitário, B2B intracomunitário com NIF válido, VIES inválido ou indisponível, vendas de mercados com fornecedor presumido (deemed supplier), reembolsos, descontos e taxas mistas.
- Exija uma explicação da decisão fiscal. A resposta deve mostrar porque foi escolhida a taxa, a jurisdição, a isenção, a autoliquidação, ou a parte responsável pelo imposto.
- Interrompa propositadamente o VIES. Confirme os carimbos temporários, os identificadores de pedido, a lógica de repetição, os resultados em cache e um canal de revisão manual.
- Inspecione as exportações, e não o painel de controlo (dashboard). Peça exemplos de ficheiros OSS, de declarações de IVA, faturas, diários e auditorias.
- Teste a imutabilidade. Tente substituir um período fechado. O sistema deve recusar e forçar um lançamento de ajuste rastreável.
- Separe o preço de cálculo do preço de conformidade. Obtenha o custo total de chamadas de API, transações, registos, entregas, armazenamento, suporte e jurisdições adicionais.
- Valide a economia da plataforma. Para um mercado, modele o custo por vendedor, transação e conta ativa, em vez de olhar apenas para a mensalidade do comerciante.
- Confirme a preparação para produção. SLA, limites de pedidos (rate limits), webhooks, idempotência, paridade com o ambiente de testes (sandbox), residência de dados e direitos de exportação.
- Classifique a compatibilidade futura. Pondere explicitamente as alterações ao OSS em 2027, as regras para plataformas em 2028 e os relatórios transfronteiriços em 2030.
A maior parte desta lista pode ser executada numa empresa de testes (sandbox) durante uma tarde; o guia do motor de IVA da UE documenta os casos de local de fornecimento, autoliquidação, fornecedor presumido e OSS/IOSS que o Nordlet resolve e onde os respetivos alertas são acionados.
FAQ
Uma API de IVA é o mesmo que uma API de contabilidade?
Não. Uma API de IVA calcula ou entrega impostos. Uma API de contabilidade mantém livros de partidas dobradas e armazena o IVA como um atributo de uma transação registada. Se a sua plataforma precisa de ser o sistema de registo, uma ferramenta estritamente de IVA obriga-o a manter o razão noutro local e a reconciliar duas origens de dados.
Posso confiar no VIES para validação B2B em tempo real no pagamento (checkout)?
Não como uma dependência síncrona única. As consultas do VIES a bases de dados nacionais podem ficar temporariamente indisponíveis, um número válido pode não aparecer se a empresa não estiver registada para o comércio intracomunitário, e a validade passada não pode ser confirmada mais tarde. Crie mecanismos de caching, repetições, carimbos temporários, IDs de pedido e uma fila de revisão manual em redor do serviço.
O termo "suporta OSS" significa que o fornecedor entrega as minhas declarações?
Raramente, e nunca deve assumi-lo. Pode significar apenas um relatório, um cálculo, apoio no registo ou uma submissão totalmente gerida. Pergunte exatamente quais os países e declarações abrangidos, quem as submete e como são geridas as correções.
Porque é que o Nordlet aparece nesta comparação se ainda está em acesso antecipado?
Porque se trata da opção mais próxima para plataformas que precisam de contabilidade integrada, pagamentos, integridade do razão e metadados de IVA num único produto, algo que a maioria das APIs estritamente fiscais não oferece. O acesso antecipado constitui uma limitação real nos prazos de produção e na cobertura geográfica, pelo que deve encarar a disponibilidade e o fluxo de trabalho de entrega como questões a validar e não como factos garantidos.
Que erro isolado causa mais problemas relacionados com o IVA mais tarde?
Não armazenar as evidências subjacentes à decisão fiscal. As autoridades podem solicitar registos anos após uma venda, e os registos OSS devem ser guardados durante dez anos. Uma ferramenta que devolve uma taxa correta mas descarta as provas de localização, o resultado do VIES e a ligação à transação falhará numa auditoria, mesmo que todos os cálculos estivessem corretos.