---
title: "Chaves de autenticação (API Keys)"
description: "Nesta documentação você irá aprender como utilizar as chaves de autenticação (API Keys) da plataforma da NFE.io."
source_url: https://nfe.io/docs/documentacao/nossa-plataforma/chaves-de-autenticacao
last_updated: 2026-02-25
---

# Acessar chave de autenticação na plataforma

Para utilizar as APIs oferecidas pela [NFE.io][4] você precisará usar as chaves de autenticação disponibilizadas no momento da criação da conta.

:::tip Resumo Rápido

**Existem DUAS chaves diferentes com propósitos específicos:**

- **Chave de Dados** → Para **consultar** informações (CNPJ, CPF, CEP, notas emitidas)
- **Chave de Nota Fiscal** → Para **emitir** notas fiscais e gerenciar empresas

**Regra simples:** Precisa consultar dados? Use a Chave de Dados. Precisa emitir nota fiscal? Use a Chave de Nota Fiscal.

:::

**Ao final desse tutorial, você será capaz de:**

* [Identificar as chaves de acesso disponíveis](#1-menu-conta)
* [Entender a diferença entre as chaves](#3-entendendo-as-duas-chaves)
* [Saber quando usar cada chave](#4-quando-usar-cada-chave)
* [Evitar erros comuns de autenticação](#6-erros-comuns-e-solucoes)

**Requisitos**  
[Criar uma conta][7]

## 1) Menu conta

1- Clique no menu **CONTA** e aparecerá todas as chaves disponíveis.

![](https://nfe.io/docs/static/docs/plataforma/account-page.png)

2- Clique na opção **CHAVE DE ACESSO**

![](https://nfe.io/docs/static/docs/plataforma/access-key-option.png)

## 2) Chaves disponíveis

Nesta tela, você verá **duas chaves diferentes**:

![](https://nfe.io/docs/static/docs/plataforma/access-key.png)

:::warning Atenção

**Cada chave tem uma finalidade específica.** Usar a chave errada resultará em erro 401 (Não autorizado). Continue lendo para entender quando usar cada uma.

:::

## 3) Entendendo as duas chaves

### 🔍 Chave de Dados (Data Key)

**Propósito:** Consultar informações e dados cadastrais.

Esta chave permite que você faça **consultas** (somente leitura) de:

- ✅ **CNPJ** - Dados cadastrais de empresas na Receita Federal
- ✅ **CPF** - Status e validação de CPF
- ✅ **CEP** - Consulta de endereços
- ✅ **Simples Nacional** - Regime tributário de empresas
- ✅ **Notas Fiscais já emitidas** - Consultar NFe/NFCe por chave de acesso

**Base URLs que usam esta chave:**
- `legalentity.api.nfe.io` - Consultas de CNPJ
- `naturalperson.api.nfe.io` - Consultas de CPF
- `address.api.nfe.io` - Consultas de CEP
- `nfe.api.nfe.io` - Consultas de notas fiscais

**Exemplo de uso:**
```bash
curl -X GET "https://legalentity.api.nfe.io/v1/legalentities/basicInfo/12345678000195" \
  -H "Authorization: SUA_CHAVE_DE_DADOS"
```

### 📝 Chave de Nota Fiscal (Invoice Key)

**Propósito:** Emitir e gerenciar notas fiscais.

Esta chave permite que você **emita notas e gerencie** sua operação fiscal:

- ✅ **Emitir NFS-e** - Nota Fiscal de Serviço Eletrônica
- ✅ **Emitir NF-e** - Nota Fiscal de Produto Eletrônica (modelo 55)
- ✅ **Emitir NFC-e** - Nota Fiscal de Consumidor Eletrônica (modelo 65)
- ✅ **Criar empresas** - Cadastrar empresas na plataforma
- ✅ **Gerenciar certificados** - Upload de certificados digitais
- ✅ **Cancelar notas** - Cancelamento de documentos fiscais
- ✅ **Enviar emails** - Envio de PDF/XML para clientes
- ✅ **Webhooks** - Configurar notificações de eventos

**Base URLs que usam esta chave:**
- `api.nfe.io` - NFS-e (Nota de Serviço)
- `api.nfse.io` - NF-e e NFC-e (Produto e Consumidor)

**Exemplo de uso:**
```bash
curl -X POST "https://api.nfe.io/v2/companies/ID_EMPRESA/serviceinvoices" \
  -H "Authorization: SUA_CHAVE_DE_NOTA_FISCAL" \
  -H "Content-Type: application/json" \
  -d '{"borrower": {...}, "services": [...]}'
```

## 4) Quando usar cada chave

### Tabela Comparativa

| Característica | 🔍 Chave de Dados | 📝 Chave de Nota Fiscal |
|---|---|---|
| **Propósito** | Consultas (somente leitura) | Emissão e gestão fiscal |
| **Operações** | Consultar CNPJ, CPF, CEP, notas | Emitir notas, criar empresas, cancelar |
| **Padrão de URL** | `*.api.nfe.io` (subdomínio) | `api.nfe.io/*` ou `api.nfse.io/*` (caminho) |
| **Tipo de acesso** | Read-only (GET) | Read + Write (GET, POST, PUT, DELETE) |
| **Requer certificado** | ❌ Não | ✅ Sim (para emissão de notas) |
| **Exemplo de endpoint** | `GET legalentity.api.nfe.io/v1/...` | `POST api.nfe.io/v2/companies/.../serviceinvoices` |

### Fluxograma de Decisão

```mermaid
graph TD
    A[O que você precisa fazer?] --> B{Consultar dados?}
    B -->|Sim| C{Que tipo de consulta?}
    C -->|CNPJ| D[🔍 Use Chave de Dados<br/>legalentity.api.nfe.io]
    C -->|CPF| E[🔍 Use Chave de Dados<br/>naturalperson.api.nfe.io]
    C -->|CEP/Endereço| F[🔍 Use Chave de Dados<br/>address.api.nfe.io]
    C -->|Nota já emitida| G[🔍 Use Chave de Dados<br/>nfe.api.nfe.io]
    
    B -->|Não| H{Emitir ou gerenciar?}
    H -->|Emitir NFS-e| I[📝 Use Chave de Nota Fiscal<br/>api.nfe.io]
    H -->|Emitir NF-e/NFC-e| J[📝 Use Chave de Nota Fiscal<br/>api.nfse.io]
    H -->|Criar empresa| K[📝 Use Chave de Nota Fiscal<br/>api.nfe.io ou api.nfse.io]
    H -->|Cancelar nota| L[📝 Use Chave de Nota Fiscal<br/>api.nfe.io ou api.nfse.io]
    H -->|Upload certificado| M[📝 Use Chave de Nota Fiscal<br/>api.nfe.io ou api.nfse.io]
    
    style D fill:#e3f2fd
    style E fill:#e3f2fd
    style F fill:#e3f2fd
    style G fill:#e3f2fd
    style I fill:#fff3e0
    style J fill:#fff3e0
    style K fill:#fff3e0
    style L fill:#fff3e0
    style M fill:#fff3e0
```

## 5) Mapeamento completo de endpoints

### Endpoints que usam 🔍 Chave de Dados

| Operação | Endpoint | Documentação |
|---|---|---|
| Consultar CNPJ | `GET legalentity.api.nfe.io/v1/legalentities/basicInfo/{cnpj}` | [Consulta CNPJ](/desenvolvedores/rest-api/consulta-de-cnpj-v1) |
| Consultar CPF | `GET naturalperson.api.nfe.io/v1/naturalperson/status/{cpf}/{birthDate}` | [Consulta CPF](/desenvolvedores/rest-api/consulta-de-cpf-v1) |
| Consultar CEP | `GET address.api.nfe.io/v2/addresses/{postalCode}` | [Consulta Endereços](/desenvolvedores/rest-api/consulta-de-enderecos-v1) |
| Consultar NF-e por chave | `GET nfe.api.nfe.io/v2/productinvoices/{accessKey}` | [Consulta NF-e](/desenvolvedores/rest-api/consulta-de-nota-fiscal-v2) |
| Consultar NFC-e por chave | `GET nfe.api.nfe.io/v1/consumerinvoices/coupon/{accessKey}` | [Consulta NFC-e](/desenvolvedores/rest-api/consulta-de-nota-fiscal-v2) |

### Endpoints que usam 📝 Chave de Nota Fiscal

| Operação | Endpoint | Documentação |
|---|---|---|
| Criar empresa | `POST api.nfe.io/v2/companies` ou `POST api.nfse.io/v2/companies` | [Criar Empresa](/documentacao/nossa-plataforma/criar-empresa) |
| Upload certificado | `POST api.nfe.io/v2/companies/{id}/certificate` | [Upload Certificado](/documentacao/nossa-plataforma/upload-certificado) |
| Emitir NFS-e | `POST api.nfe.io/v2/companies/{id}/serviceinvoices` | [NFS-e v1](/desenvolvedores/rest-api/nota-fiscal-de-servico-v1) |
| Emitir NF-e | `POST api.nfse.io/v2/companies/{id}/productinvoices` | [NF-e v2](/desenvolvedores/rest-api/nota-fiscal-de-produto-v2) |
| Emitir NFC-e | `POST api.nfse.io/v2/companies/{id}/consumerinvoices` | [NFC-e v2](/desenvolvedores/rest-api/nota-fiscal-de-consumidor-v2) |
| Listar NFS-e | `GET api.nfe.io/v2/companies/{id}/serviceinvoices` | [NFS-e v1](/desenvolvedores/rest-api/nota-fiscal-de-servico-v1) |
| Cancelar NFS-e | `DELETE api.nfe.io/v2/companies/{id}/serviceinvoices/{invoiceId}` | [NFS-e v1](/desenvolvedores/rest-api/nota-fiscal-de-servico-v1) |
| Criar webhook | `POST api.nfse.io/v2/webhooks` | [Webhooks](/documentacao/conceitos/webhook) |

## 6) Erros comuns e soluções

### ❌ Erro 401: "API Key da conta não é válida"

**Causa mais comum:** Você está usando a chave errada para o endpoint.

**Como identificar qual chave usar:**

1. **Olhe para a URL base:**
   - Se for `*.api.nfe.io` (com subdomínio) → 🔍 **Chave de Dados**
   - Se for `api.nfe.io/*` ou `api.nfse.io/*` → 📝 **Chave de Nota Fiscal**

2. **Pergunte-se:**
   - "Estou consultando dados?" → 🔍 **Chave de Dados**
   - "Estou emitindo/criando algo?" → 📝 **Chave de Nota Fiscal**

**Exemplos de erros e soluções:**

| ❌ Erro | ✅ Solução |
|---|---|
| Tentando emitir NFS-e com Chave de Dados | Use a **Chave de Nota Fiscal** |
| Tentando consultar CNPJ com Chave de Nota Fiscal | Use a **Chave de Dados** |
| Tentando criar empresa com Chave de Dados | Use a **Chave de Nota Fiscal** |
| Tentando consultar nota emitida com Chave de Nota Fiscal | Use a **Chave de Dados** (se for consulta por chave de acesso) |

### Outras verificações de segurança

- ✅ Certifique-se de que está usando o cabeçalho correto: `Authorization: SUA_CHAVE`
- ✅ Não adicione prefixos como "Bearer" na Chave de API (use apenas para JWT)
- ✅ Verifique se não há espaços antes ou depois da chave
- ✅ Confirme que a chave está ativa na plataforma

## 7) Boas práticas de segurança

:::danger Segurança crítica

**NUNCA faça isso:**
- ❌ Commitar chaves no Git/GitHub
- ❌ Expor chaves em código-fonte público
- ❌ Compartilhar chaves por email ou chat sem criptografia
- ❌ Usar a mesma chave em produção e testes (quando possível)
- ❌ Armazenar chaves em texto plano no frontend

**SEMPRE faça isso:**
- ✅ Armazene chaves em variáveis de ambiente (`process.env`, `.env` no `.gitignore`)
- ✅ Use gerenciadores de secrets (AWS Secrets Manager, Azure Key Vault, etc.)
- ✅ Rotacione chaves periodicamente ou se suspeitar de vazamento
- ✅ Use HTTPS em todas as requisições
- ✅ Limite o acesso às chaves apenas para quem precisa
- ✅ Monitore o uso das chaves para detectar comportamentos anômalos

:::

**Exemplo de uso seguro em Node.js:**

```javascript
// ✅ CORRETO - Usando variável de ambiente
const DATA_API_KEY = process.env.NFEIO_DATA_KEY;
const INVOICE_API_KEY = process.env.NFEIO_INVOICE_KEY;

// Consultar CNPJ
const cnpjResponse = await fetch(
  'https://legalentity.api.nfe.io/v1/legalentities/basicInfo/12345678000195',
  { headers: { 'Authorization': DATA_API_KEY } }
);

// Emitir nota
const invoiceResponse = await fetch(
  'https://api.nfe.io/v2/companies/ID/serviceinvoices',
  {
    method: 'POST',
    headers: {
      'Authorization': INVOICE_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({...})
  }
);
```

**Exemplo de arquivo `.env`:**

```bash
# Chaves NFE.io (NÃO commitar este arquivo!)
NFEIO_DATA_KEY=sua-chave-de-dados-aqui
NFEIO_INVOICE_KEY=sua-chave-de-nota-fiscal-aqui
```

**Adicione ao `.gitignore`:**

```
.env
.env.local
.env.*.local
```

## 8) Próximos passos

### Se você vai usar a Chave de Dados:

1. **Comece com consultas simples:**
   - [Consultar CNPJ](/desenvolvedores/rest-api/consulta-de-cnpj-v1) - Ideal para começar
   - [Consultar CPF](/desenvolvedores/rest-api/consulta-de-cpf-v1)
   - [Consultar CEP](/desenvolvedores/rest-api/consulta-de-enderecos-v1)

2. **Consultas avançadas:**
   - [Consultar notas fiscais](/desenvolvedores/rest-api/consulta-de-nota-fiscal-v2)
   - [Distribuição de NF-e](/desenvolvedores/rest-api/consulta-nf-e-distribuicao-v1)

### Se você vai usar a Chave de Nota Fiscal:

1. **Configure sua estrutura primeiro:**
   - [Criar uma empresa][8]
   - [Fazer upload do certificado digital][9]

2. **Emita sua primeira nota:**
   - [Emitir NFS-e (Nota de Serviço)][10]
   - [Emitir NF-e (Nota de Produto)](/desenvolvedores/rest-api/nota-fiscal-de-produto-v2)
   - [Emitir NFC-e (Nota de Consumidor)](/desenvolvedores/rest-api/nota-fiscal-de-consumidor-v2)

3. **Gerencie suas notas:**
   - [Listar notas fiscais de serviço][11]
   - [Cancelar uma nota fiscal de serviço][12]
   - [Configurar Webhooks](/documentacao/conceitos/webhook)

### Documentação complementar:

- [Introdução à REST API](/desenvolvedores/rest-api/intro) - Guia completo da API
- [Conceitos da plataforma](/documentacao/conceitos) - Entenda melhor a NFE.io
- [Cálculo de impostos](/desenvolvedores/rest-api/calculo-de-impostos-v1) - Motor tributário

---

:::info Dica final

Guarde este marcador! Sempre que tiver dúvida sobre qual chave usar, volte à [tabela comparativa](#4-quando-usar-cada-chave) ou ao [fluxograma de decisão](#fluxograma-de-decisão).

:::

[1]: #Acessar%5Fchave%5Fde%5Fautenticacao%5Fna%5Fplataforma
[2]: #1%5FMenu%5Fconta
[3]: #2%5FChaves%5Fdisponiveis
[4]: https://nfe.io/docs
[5]: https://nfe.io/docs/documentacao/nossa-plataforma/chaves-de-autenticacao/#1%5FMenu%5Fconta
[6]: https://nfe.io/docs/documentacao/nossa-plataforma/chaves-de-autenticacao/#2%5FChaves%5Fdisponiveis
[7]: https://nfe.io/docs/documentacao/nossa-plataforma/criar-conta/
[8]: https://nfe.io/docs/documentacao/nossa-plataforma/criar-empresa/
[9]: https://nfe.io/docs/documentacao/nossa-plataforma/upload-certificado/
[10]: https://nfe.io/docs/documentacao/nossa-plataforma/nota-fiscal-servico/emitir-nota-servico/
[11]: https://nfe.io/docs/ocumentacao/nossa-plataforma/nota-fiscal-servico/listar-notas-servico/
[12]: https://nfe.io/docs/documentacao/nossa-plataforma/nota-fiscal-servico/cancelar-nota-servico/