Autenticação

Todas as chamadas à API Focus NFe exigem autenticação HTTP Basic (RFC 7617). Não há cabeçalho de API key separado: o token da empresa é enviado como usuário do Basic Auth e a senha fica em branco.

Como funciona

  1. O cliente monta o par usuário = token alfanumérico gerado no cadastro da empresa (painel Focus NFe).
  2. A senha do Basic deve ser vazia (string vazia, não omita o esquema Basic).
  3. O cabeçalho Authorization enviado pelo cliente é equivalente a Basic + Base64(token:) — note os dois pontos e nada depois deles.

O mesmo esquema vale para homologação e produção; muda apenas a URL base do servidor e o token.

Exemplo com cURL

curl -u 'SEU_TOKEN_AQUI:' \
  https://homologacao.focusnfe.com.br/v2/empresas

O caractere após os dois pontos é intencional: senha vazia. Sem aspas, alguns shells podem exigir escapar caracteres especiais do token.