Consultar cliente

GET/v1/clients/{id}

Consulta um cliente específico da sua conta pelo id. Mesmo formato minimalista do item da listagem — nunca dados fiscais ou credenciais.

Autorização: só a Chave de Acesso (X-Access-Key).

Parâmetros

Path

idstringobrigatório

UUID do cliente.

Resposta

200 OK

idstring

UUID interno do cliente.

namestring

Razão social cadastrada.

cnpjstring

CNPJ normalizado (somente dígitos).

Erros: 401 (Chave de Acesso ausente ou inválida), 404 (nenhum cliente com esse id pertence à conta da Chave de Acesso usada) — veja os formatos de erro.

cURL

curl https://app.nfe.tenzanlabs.com/v1/clients/183e2c79-7c26-4a9e-b20d-63ce5645497b \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI"

Node.js

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

const clients = new ClientsClient('nfe_access_SUA_CHAVE_DE_ACESSO_AQUI');
const cliente = await clients.getClient('183e2c79-7c26-4a9e-b20d-63ce5645497b');
console.log(cliente.name);

Python

from nfe_sdk import ClientsClient

clients = ClientsClient(access_key='nfe_access_SUA_CHAVE_DE_ACESSO_AQUI')
cliente = clients.get_client('183e2c79-7c26-4a9e-b20d-63ce5645497b')
print(cliente["name"])

Java

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

ClientsClient clients = new ClientsClient("nfe_access_SUA_CHAVE_DE_ACESSO_AQUI");
ClientSummary cliente = clients.getClient("183e2c79-7c26-4a9e-b20d-63ce5645497b");
System.out.println(cliente.name);

Exemplo de resposta

{ "id": "183e2c79-...", "name": "Empresa Exemplo LTDA", "cnpj": "11222333000181" }