API de Consulta de NIF Empresas

Visão Geral

<p>A API de Consulta de NIF Empresas permite consultar dados de empresas angolanas através do Número de Identificação Fiscal (NIF).</p>

Funcionalidades

<ul>
    <li>Consulta de dados de empresas (nome, tipo)</li>
    <li>Respostas rápidas e confiáveis</li>
    <li>Cache integrado para melhor performance</li>
    <li>Integração simples e direta</li>
</ul>

Casos de Uso

<ul>
    <li>Verificação de dados de empresas</li>
    <li>Integração com sistemas de compras</li>
    <li>Validação de fornecedores</li>
    <li>Consulta rápida de informações empresariais</li>
</ul>

Endpoints Disponíveis

Consultar NIF de Empresa

Endpoint

<pre><code>GET /consultar/{nif}/nif</code></pre>

Parâmetros

<table>
    <thead>
        <tr>
            <th>Parâmetro</th>
            <th>Tipo</th>
            <th>Obrigatório</th>
            <th>Descrição</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>nif</td>
            <td>string</td>
            <td>Sim</td>
            <td>Número de Identificação Fiscal da empresa</td>
        </tr>
    </tbody>
</table>

Exemplo de requisição

<pre><code>curl -X GET "https://portfolio-joaotomas.test/api/gateway/consulta-nif/consultar/5410003144/nif" \
  -H "X-API-Key: sua-chave-aqui" \
  -H "Accept: application/json"</code></pre>

Resposta de sucesso

<pre><code>{
  "error": false,
  "name": "UNITEL, S.A",
  "type": "CONSULTA DE NIF"
}</code></pre>

Resposta de erro

<pre><code>{
  "error": true,
  "message": "Empresa não encontrada"
}</code></pre>