API REST · JSON

Consulte qualquer NIF numa única chamada.

Integre a validação de contribuintes no seu sistema de faturação, ERP ou e-commerce. Dados estruturados, respostas rápidas e controlo total do consumo através do painel.

Obter a minha API key Ver documentação
Formato
JSON
Autenticação
API Key
Protocolo
HTTPS
consulta-nif.sh 
# Pedido
curl https://api.ndaysystem.com/api/consultar-nif/0000000000 \
  -H "X-API-KEY: $API_KEY" \
  -H "X-API-SECRET: $API_SECRET"

# Resposta · 200 OK
{
  "dados": {
    "nif": "0000000000",
    "nome": "EMPRESA EXEMPLO, LDA",
    "estado": "Activo",
    "inadimplente": false
  },
  "origem": "cache"
}

Empresas que confiam em nós

  • x

Funcionalidades

Tudo o que precisa para validar contribuintes

Uma API simples por fora, robusta por dentro.

Respostas rápidas

Consultas frequentes são servidas a partir de cache, reduzindo a latência das suas integrações.

Chaves de API seguras

Crie, revogue e acompanhe as suas chaves. Guardamos apenas o hash, nunca a chave original.

Quotas e subscrições

Cada subscrição tem uma quota definida. Saiba sempre quantas consultas usou e quantas restam.

Registo de pedidos

Cada consulta fica registada com código de resposta, tempo e origem, para auditoria e diagnóstico.

Painel do cliente

Gira utilizadores da sua empresa, chaves e consumo num único painel, com acesso restrito por perfil.

Notificações

Receba avisos sobre o estado da sua conta, quotas a esgotar e alterações importantes.

Como funciona

Integração em três passos

  1. 1

    Crie a sua conta

    Aceda ao painel e registe a sua empresa.

  2. 2

    Gere uma API key

    Crie uma chave e associe-a a uma subscrição com a quota adequada.

  3. 3

    Faça a primeira consulta

    Envie o NIF no pedido e receba os dados do contribuinte em JSON.

Para programadores

Feita para integrar sem fricção

Endpoints REST previsíveis, códigos HTTP padrão e respostas JSON consistentes. Funciona com qualquer linguagem: PHP, JavaScript, Python, C# ou Java.

  • 200 Consulta efectuada com sucesso
  • 401 API key em falta ou revogada
  • 404 NIF não encontrado
  • 429 Quota da subscrição esgotada
PHP 
// Laravel HTTP Client
$resposta = Http::withHeaders([
    'X-API-KEY' => $apiKey,
    'X-API-SECRET' => $apiSecret,
])->get('https://api.ndaysystem.com/api/consultar-nif/0000000000');

if ($resposta->successful()) {
    $contribuinte = $resposta->json();

    echo $contribuinte['dados']['nome'];
}

Planos à medida do seu volume de consultas

Escolha a quota que melhor se adapta ao seu negócio e acompanhe o consumo em tempo real no painel.

Começar agora Falar com a equipa

Contacto

Fale com a nossa equipa

Dúvidas sobre a integração, planos ou volumes à medida? Envie-nos uma mensagem e respondemos por email.