Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Autenticação

O servidor sempre inicia e sempre responde tools/list, mesmo sem chave (modo gratuito). A chave só é exigida quando você chama uma ferramenta que consome a API da NFE.io - nesse caso, sem chave, a ferramenta retorna um erro instrutivo pedindo a credencial (não é um 401 de transporte).

As duas chaves​

FunçãoHeader HTTPVariável (local)Nome no dashboard
Operações fiscais (emissão, notas, empresas)X-NFE-API-Key ou Authorization: BearerNFE_API_KEYChave de Dados
Lookups (CNPJ, CEP)X-NFE-Lookup-KeyNFE_LOOKUP_API_KEYChave de Consulta

Se a Chave de Consulta não for informada, os lookups usam a Chave de Dados como fallback.

Nomenclatura

O dashboard chama de "Chave de Dados" (fiscal) e "Chave de Consulta" (lookups). A variável NFE_LOOKUP_API_KEY recebe o nome pela função para não confundir com o rótulo do dashboard.

Empresa padrão​

Ferramentas que operam sobre uma empresa (issue_service_invoice, list_service_invoices, get_invoice_status, get_company) aceitam um companyId opcional. Se você omitir, o servidor usa a empresa padrão:

Header HTTPVariável (local)
X-NFE-Company-IdNFE_COMPANY_ID

Precedência da chave fiscal​

Da maior para a menor prioridade:

  1. X-NFE-API-Key (header)
  2. Authorization: Bearer (header)
  3. NFE_API_KEY (variável de ambiente - só no modo local/stdio)
  4. anônimo (só as ferramentas gratuitas respondem)
Onde a chave vive

No hosted e no local via npx a credencial nunca é lida de arquivo compartilhado: no hosted ela chega por header a cada requisição; no local, por variável de ambiente. Veja Segurança.

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.