Perguntas Frequentes

Tudo o que precisa saber sobre a API de Validação Fiscal de NIF

Sobre o Serviço

O que faz esta API?

A API permite validar dados fiscais associados a um Número de Identificação Fiscal (NIF) de Angola. Retorna informações como nome, estado, tipo de contribuinte, município e província — tudo em formato JSON.

Para que serve esta API?

Serve para validar contribuintes durante processos de registo, celebração de contratos, emissão de facturas, onboarding de clientes e integração com sistemas empresariais (ERPs, CRMs, plataformas SaaS).

A API serve para pesquisa pública de dados pessoais?

Não. A API foi concebida exclusivamente para validação fiscal em contextos comerciais legítimos. Não deve ser utilizada para recolha massiva de dados, marketing ou criação de bases de dados paralelas.

Integração

Preciso de criar conta para usar a API?

Sim. Para utilizar a API é necessário subscrever um plano e gerar uma chave de API (API Key).

Qual o formato das respostas?

Todas as respostas são em JSON. Uma resposta de sucesso inclui os campos: nif, nome, telefone, morada, municipio, provincia, estado, tipo.

Posso integrar com ERP ou CRM?

Sim. A API é REST e responde em JSON, pelo que é compatível com qualquer sistema que suporte requisições HTTP — ERPs, CRMs, plataformas de faturação, aplicações web e mobile.

Como funciona a autenticação?

Inclua a sua API Key no header de cada requisição: Authorization: Bearer SUA_API_KEY. Também aceita os headers X-API-Key ou o parâmetro ?api_key=.

Planos e Limites

Existe limite de requisições?

Sim. Cada plano possui limites diários. O plano Free permite um número reduzido de validações por dia. Os planos Basic e Pro oferecem volumes significativamente maiores. Para necessidades enterprise, contacte-nos.

Existe plano enterprise?

Para volumes superiores ou necessidades específicas de integração, contacte a equipa comercial em suporte@angohost.ao para um plano personalizado.

Posso testar antes de subscrever?

Sim. A demonstração na página principal permite testar a validação de NIF sem necessidade de registo. Para uso em produção, é necessária uma API Key.