Autenticação

Autenticação via API Key

A API NFS-e Nacional suporta autenticação por API Key de Workspace, indicada para integrações server-to-server (ERPs, sistemas de automação, etc.) sem necessidade de login interativo.

Formato da chave

As chaves são geradas com o prefixo ntk_ seguido de 64 caracteres hexadecimais:

Code
ntk_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

Como autenticar

Envie a chave no header Authorization no lugar do Bearer JWT:

Code
Authorization: Bearer ntk_<sua_chave_aqui>

Selecionando a empresa

Um workspace pode ter múltiplas empresas. Para selecionar qual empresa usar na requisição, passe o header empresa-id:

Code
Authorization: Bearer ntk_<sua_chave_aqui>
empresa-id: <uuid_da_empresa>

Se empresa-id for omitido, a empresa padrão do workspace será usada automaticamente.

Exemplo completo

Listar tomadores

Code
curl https://nfse.labds.com.br/api/v1/tomadores \
  -H "Authorization: Bearer ntk_a1b2c3d4e5f6..." \
  -H "empresa-id: 745b7faa-727d-4182-815b-359136407575"

Erros comuns

Status	Mensagem	Causa
`401`	`API Key inválida ou revogada`	Chave incorreta ou revogada
`403`	`Empresa não pertence ao workspace desta API Key`	`empresa-id` não pertence ao workspace da chave
`403`	`Esta operação requer autenticação via token JWT`	Tentativa de gerenciar chaves usando uma API Key
`404`	`Nenhuma empresa vinculada a este workspace`	Workspace sem empresas cadastradas

Last modified on May 4, 2026