API de taxas de IVA: JSON, campos e exemplos
A API disponibiliza um ficheiro JSON estático de taxas de referência para 174 países. Não exige chave ou conta. A resposta e os nomes dos campos mantêm o contrato técnico em inglês.
Endpoint recomendado
GET https://vatestimator.com/api/v1/rates.jsonO endpoint legado /api/rates.json continua disponível. Para novas integrações prefira a versão v1.
Exemplo JavaScript
const response = await fetch('https://vatestimator.com/api/v1/rates.json');
const data = await response.json();
const portugal = data.rates.find(row => row.code === 'PT');
console.log(portugal.standard_rate);Campos principais
code- Código ISO do país, por exemplo PT.
currency_code- Código ISO da moeda; currency é apenas o símbolo.
standard_rate- Taxa normal ou null quando não é comparável.
rates[].rate_percent- Percentagem; rate é o alias legado.
calculation_method / tax_model- Método de cálculo e âmbito dos componentes.
official_source_url / last_verified- Fonte oficial e data de verificação de cada país.
meta.schema_version- Versão do esquema, atualmente 1.2 no endpoint v1.
Modelos que exigem cuidado
Uma taxa normal nula indica que não há uma única taxa nacional comparável. Leia tax_model, os contextos das taxas e o método de cálculo. Para tax_inclusive_base, total = líquido ÷ (1 − taxa/100); esse líquido exclui apenas o componente escolhido.
Datas, moeda e atribuição
Use currency_code para lógica; o símbolo pode ser partilhado por várias moedas. meta.last_verified não significa que todos os países foram verificados nesse dia: consulte rates[].last_verified. O conjunto pode ser usado gratuitamente com atribuição ao VATEstimator. Confirme as fontes antes de faturar.
Limitações do cálculo
As regras e taxas podem mudar. Confirme as condições na fonte oficial do país antes de faturar. A calculadora executa a operação matemática, sem determinar a classificação fiscal.