Clientes
Os tomadores de serviço de cada empresa. Mantenha o cadastro aqui e use os dados no objeto tomador na hora de emitir.
Escoposcadastros:ler · cadastros:escrever
# Produçãohttps://api.emissordenota.com/v1# Sandboxhttps://sandbox.api.emissordenota.com/v1Endpoints
- GET
/v1/clientesLista os clientes de uma empresa - POST
/v1/clientesCadastra um cliente - GET
/v1/clientes/{id}Consulta um cliente - POST
/v1/clientes/{id}Atualiza um cliente - DELETE
/v1/clientes/{id}Remove um cliente
O objeto cliente
idstringIdentificador do cliente, com o prefixo cli_.
empresa_idstringA empresa a que o cliente pertence.
documentostringCNPJ ou CPF, só com dígitos.
nomestringRazão social ou nome completo.
emailstringEndereço que recebe as notas do cliente.
enderecoobjectEndereço completo, preenchido a partir do CEP.
criado_emstringData e hora do cadastro, em ISO 8601.
{ "id": "cli_6Pz3nKd8Wm", "empresa_id": "emp_8Kq2mXv41c", "documento": "98765432000198", "nome": "Clínica Bem Viver Ltda", "email": "[email protected]", "endereco": { "cep": "01310100", "logradouro": "Avenida Paulista", "numero": "1578", "bairro": "Bela Vista", "municipio": "São Paulo", "uf": "SP" }, "criado_em": "2026-10-14T16:05:48-03:00"}Cadastrar um cliente
POST/v1/clientes
Cria o cliente na carteira de uma empresa. O mesmo documento não se repete dentro da empresa.
Corpo da requisição
empresa_idstringobrigatórioA empresa dona do cadastro.
documentostringobrigatórioCNPJ ou CPF, só com dígitos.
nomestringobrigatórioRazão social ou nome completo.
emailstringopcionalEndereço que recebe as notas do cliente.
enderecoobjectopcionalExigido por algumas prefeituras para tomador pessoa jurídica.
cepstringobrigatório8 dígitos.
numerostringobrigatórioNúmero do endereço.
complementostringopcionalSala, andar ou bloco.
curl -X POST https://api.emissordenota.com/v1/clientes \ -H "Authorization: Bearer $EDN_KEY" \ -H "Content-Type: application/json" \ -d '{ "empresa_id": "emp_8Kq2mXv41c", "documento": "98765432000198", "nome": "Clínica Bem Viver Ltda", "email": "[email protected]", "endereco": { "cep": "01310100", "numero": "1578" } }'Listar clientes
GET/v1/clientes
Devolve os clientes de uma empresa, do mais recente para o mais antigo.
Parâmetros de consulta
empresa_idstringobrigatórioA empresa dona dos clientes.
documentostringopcionalBusca exata por CNPJ ou CPF.
buscastringopcionalTrecho do nome.
limiteintegeropcionalItens por página. O padrão e o máximo são 50.
cursorstringopcionalO proximo_cursor da página anterior.
Remover um cliente
DELETE/v1/clientes/{id}
Remove o cadastro e responde 204, sem corpo. As notas já emitidas para o cliente não são alteradas.
# API=https://api.emissordenota.com/v1curl -X DELETE $API/clientes/cli_6Pz3nKd8Wm \ -H "Authorization: Bearer $EDN_KEY"# 204 No ContentErros
StatusCódigoQuando
- 404cliente_nao_encontradoO id não existe nesse ambiente.
- 409cliente_ja_cadastradoO documento já existe na empresa.
- 422dados_invalidosDocumento ou CEP inválidos.