Saltar para o conteúdo principal

Primeiros passos

Endpoint de validação de IVA

Verifique a autenticidade do número de IVA e obtenha informações abrangentes da empresa, incluindo país, nome comercial, morada e detalhes de registo.

Endpoint de cálculo de IVA

Calcule preços em conformidade com o IVA com base em regulamentos específicos por país, tipo de compra e valor da transação para cálculos financeiros precisos.

Endpoint de categorias de IVA

Aceda às taxas de IVA atuais e categorias fiscais para países específicos para garantir conformidade com os regulamentos fiscais locais.

Arquitetura REST

A API de validação de IVA segue os princípios REST, utilizando URLs previsíveis e orientadas a recursos e códigos de estado HTTP padrão para integração fluida e tratamento de erros. Todos os endpoints da API devem terminar com uma barra final (/) e suportam apenas pedidos GET.

Segurança HTTPS

Todas as comunicações da API são protegidas com protocolos de encriptação TLS 1.2 ou superior para garantir a integridade e privacidade dos dados.

Versionamento da API

A API de validação de IVA mantém compatibilidade retroativa através de versionamento, operando atualmente na Versão 1 com melhorias futuras planeadas.

Autenticação

A sua chave API serve como credencial exclusiva para aceder à API de validação de IVA. Cada serviço Cleariflow requer uma chave única, garantindo acesso seguro e isolado entre diferentes APIs. A API implementa limitação de taxa para garantir utilização justa entre todos os utilizadores.

Códigos de resposta e erro

Quando os pedidos falham, a API devolve respostas de erro JSON estruturadas com códigos e descrições específicos para resolução eficaz de problemas.

Códigos de país

Abaixo está a lista de países suportados pelos endpoints de IVA