Obter tokens do cliente

GET/v1/clients/{cnpj}/tokens

Recupera os tokens (nfe_test_.../nfe_live_...) de um cliente a partir do CNPJ — os mesmos tokens usados no header Authorization: Bearer das chamadas de emissão. É a forma programática de obter o token de um cliente logo após criá-lo, sem precisar copiá-lo manualmente do painel.

Endpoint privilegiado

Exige as duas — Chave de Acesso e Chave Restrita — sempre juntas. Retorna o token de produção sem pedir a senha da conta, então trate a Chave Restrita com o mesmo cuidado que a senha da conta. Veja O que é a Chave Restrita antes de usar este endpoint.

Autorização: X-Access-Key + X-Restricted-Key.

Rate limit: 20 requisições/minuto por IP, além do limite global de 60/min.

Parâmetros

Path

cnpjstringobrigatório

CNPJ do cliente (com ou sem máscara).

Resposta

200 OK

idstring

UUID interno do cliente.

namestring

Razão social cadastrada.

cnpjstring

CNPJ normalizado (somente dígitos).

tokensarray

Lista de tokens do cliente.

idstring

UUID do token.

namestring

Nome descritivo do token (ex: “Chave de Produção”).

typestring

Valores aceitos: PROD | HOMOLOG

Ambiente ao qual o token pertence.

tokenstring

O token em si (nfe_live_... ou nfe_test_...), usado no header Authorization: Bearer.

Erros: 401 (falta X-Access-Key ou X-Restricted-Key, chave inválida/revogada, ou Chave Restrita de outra conta), 404 (nenhum cliente com esse CNPJ nessa conta) — veja os formatos de erro.

cURL

curl https://app.nfe.tenzanlabs.com/v1/clients/11222333000181/tokens \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "X-Restricted-Key: nfe_restricted_SUA_CHAVE_RESTRITA_AQUI"

Node.js

import { ClientsClient } from '@tenzanlabs/nfe-node-sdk';

// getTokensByCnpj exige restrictedKey nas opções — sem ela, o SDK lança
// um erro local antes de sequer chamar a API.
const clients = new ClientsClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI', {
  restrictedKey: 'nfe_restricted_SUA_CHAVE_RESTRITA_AQUI',
});

const { tokens } = await clients.getTokensByCnpj('11222333000181');
console.log(tokens); // [{ id, name, type, token }, ...]

Python

from nfe_sdk import ClientsClient

# get_tokens_by_cnpj exige restricted_key — sem ela, o SDK lança um erro
# local antes de sequer chamar a API.
clients = ClientsClient(
    access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI',
    restricted_key='nfe_restricted_SUA_CHAVE_RESTRITA_AQUI',
)

resposta = clients.get_tokens_by_cnpj('11222333000181')
print(resposta["tokens"])

Java

import br.com.saascore.nfe.ClientsClient;
import br.com.saascore.nfe.model.ClientTokensResponse;

// getTokensByCnpj exige restrictedKey — sem ela, o SDK lança uma exceção
// local antes de sequer chamar a API.
ClientsClient clients = new ClientsClient(
    "nfe_access_SUA_CHAVE_DE_ACESSO_AQUI",
    "nfe_restricted_SUA_CHAVE_RESTRITA_AQUI"
);

ClientTokensResponse resposta = clients.getTokensByCnpj("11222333000181");
System.out.println(resposta.tokens.get(0).token);

Exemplo de resposta

{
  "id": "183e2c79-7c26-4a9e-b20d-63ce5645497b",
  "name": "Empresa Exemplo LTDA",
  "cnpj": "11222333000181",
  "tokens": [
    { "id": "...", "name": "Chave de Produção", "type": "PROD", "token": "nfe_live_..." },
    { "id": "...", "name": "Chave de Homologação", "type": "HOMOLOG", "token": "nfe_test_..." }
  ]
}