Cadastrar cliente

Como cadastrar um cliente emitente (empresa ou autônomo), com a busca automática na Receita e as sugestões a partir de notas já emitidas.

Para: Escritório · Atualizado em 23/10/2026

Para que serve

Aqui você cadastra um cliente que vai emitir notas pelo sistema. O cadastro guarda a identificação, o regime tributário, o endereço, a numeração da DPS e as preferências de e-mail da nota.

Para chegar aqui: Clientes › + Novo cliente. Só quem pode alterar clientes e tem acesso a todos os clientes da conta vê esse botão.

Depois de cadastrar, o sistema abre o detalhe do cliente. Lá você envia o certificado digital e confere o checklist Pronto para emitir — sem certificado o cliente ainda não emite.

Passo a passo

Em Tipo de cliente, escolha Pessoa jurídica (CNPJ) ou Pessoa física (CPF) — autônomo.
Digite o CNPJ (ou o CPF). Com um CNPJ válido, o sistema busca sozinho os dados na Receita Federal e preenche razão social, nome fantasia, regime sugerido, endereço e, se estiverem vazios, e-mail e telefone. Você também pode clicar em Buscar. Confira tudo antes de salvar.
Preencha a Inscrição Municipal, se o cliente tiver. Abaixo do campo podem aparecer sugestões (veja "Sugestões" abaixo).
Escolha o Ambiente: Homologação para testar, Produção para emitir notas com valor fiscal.
Confira o Regime Tributário. Para pessoa física ele é sempre "Autônomo (pessoa física)".
Em Configuração fiscal, confira a Série da DPS e o Próximo nº da DPS. Se o cliente for do Simples, preencha também o Regime de apuração do Simples e o Percentual aproximado de tributos (Simples), que é obrigatório nesta tela. Se não souber o percentual, cadastre depois a alíquota efetiva pela calculadora do Perfil fiscal (veja Detalhe do cliente).
Em Endereço, informe o CEP: o sistema preenche logradouro, bairro, UF e o Código IBGE. Complete o Número.
Informe o E-mail de contato (obrigatório) e o telefone (opcional).
Em E-mail da NFS-e, decida se a nota vai automaticamente para o tomador e se alguém recebe cópia oculta.
Clique em Cadastrar cliente.

Sugestões a partir de notas já emitidas

Se o CNPJ já emitiu notas (por este sistema ou por outro emissor, como o Emissor Nacional), o sistema mostra sugestões em amarelo:

Inscrição municipal usada nas notas, com um botão para usar o valor. Quando o valor digitado confere, aparece "Confere com…". Pode aparecer também um link Consultar na prefeitura.
Série já usada até o nº X — "continue do Y para não repetir a DPS". Clique em Usar para aplicar.
Regime de apuração do Simples e percentual de tributos da nota mais recente, com Usar.

As sugestões são ajuda: nada é aplicado sem você clicar.

Campos

Campo	O que significa
Tipo de cliente	Empresa (CNPJ) ou profissional autônomo (CPF). Não pode ser trocado depois.
CNPJ / CPF	Documento do cliente. Não pode ser alterado depois do cadastro.
Inscrição Municipal	Número do cliente na prefeitura (inscrição municipal). Opcional; só alguns municípios exigem na nota.
Ambiente	Homologação (homologação: testes, sem valor fiscal) ou Produção (produção: notas reais). O padrão é Homologação.
Nome / Razão social	Nome que sai na nota. Para pessoa física, o campo se chama Nome completo.
Nome Fantasia	Opcional, só para empresa.
Regime Tributário	Simples Nacional, MEI, Lucro Presumido ou Lucro Real. Define como o motor calcula os impostos. Mudanças futuras são feitas pela edição ou pelo perfil fiscal, com data de início.
Série da DPS	Série da numeração (série e número da DPS), de 1 a 49999. O padrão é 1. Séries de 50000 em diante são de outros canais de emissão e a Sefin rejeita (E0010).
Próximo nº da DPS	Número da próxima DPS. Se o cliente já emitiu nesta série por outro sistema, continue a numeração.
Regime de apuração do Simples	Só para Simples: 1 (tudo pelo Simples), 2 (ISS fora do Simples) ou 3 (federais e municipal fora do Simples). Veja regime de apuração do Simples.
Percentual aproximado de tributos (Simples)	Só para Simples, obrigatório no formato 6.00. É o percentual usado para informar os tributos aproximados da lei 12.741. Para clientes já cadastrados sem o percentual (ou integrações pela API, onde segue opcional), a emissão mostra um aviso e a nota sai com os tributos aproximados zerados; o aviso não bloqueia.
CEP, Logradouro, Número, Bairro	Endereço do estabelecimento do cliente.
Código IBGE	Código do município (código IBGE do município), preenchido pelo CEP. O nome do município aparece abaixo para conferência.
UF	Estado, com 2 letras.
Complemento	Opcional.
E-mail de contato	E-mail do cliente para contato. Obrigatório.
Telefone	Opcional.
Enviar a NFS-e automaticamente por e-mail ao tomador	Ligado: depois da autorização, a NFS-e vai por e-mail ao tomador.
Cópia oculta (ex.: contador)	Opcional. Um ou mais e-mails separados por vírgula que recebem cópia oculta da nota.

Erros comuns e como resolver

"CNPJ inválido" / "CPF inválido". Confira os dígitos. O botão Cadastrar cliente não envia com documento inválido.
"CNPJ já cadastrado neste tenant". Este cliente já existe na sua conta. Procure-o em Clientes.
A busca na Receita não preencheu nada. A consulta pode estar indisponível no momento ou ter atingido o limite. Preencha à mão ou tente Buscar de novo mais tarde.
"Série da DPS inválida: pela API … só são aceitas séries de 1 a 49999". Use só números, de 1 a 49999. A Sefin rejeita séries maiores com E0010.
"Percentual aproximado de tributos inválido (ex.: 6.00)". Use número maior que zero com até duas casas, como 6.00. Para clientes do Simples o campo é obrigatório.
"E-mail inválido na cópia oculta". Corrija o e-mail indicado; separe vários por vírgula.
"Cadastro de cliente restrito". Seu acesso é restrito a alguns clientes. Peça a um administrador com acesso a todos. Veja cliente.criacao_restrita.
Limite do plano. O plano não permite mais clientes. Veja Plano e uso.
O município ficou errado. O padrão do formulário é São Paulo até você informar o CEP. Confira o nome do município abaixo do Código IBGE. Município errado causa a rejeição E0084.

Veja também

Termos usados

Cliente (do escritório): Empresa ou profissional que emite notas pelo sistema — o prestador do serviço.
CNPJ: Cadastro Nacional da Pessoa Jurídica: identifica empresas.
CPF: Cadastro de Pessoas Físicas: identifica pessoas.
Inscrição municipal: Número do cadastro do prestador na prefeitura do município onde está estabelecido.
Homologação: Ambiente de testes oficial (produção restrita): as notas emitidas nele não têm valor fiscal.
Produção: Ambiente oficial: as notas emitidas nele têm valor fiscal.
Regime tributário: Forma como o prestador apura os impostos: Simples Nacional, MEI, Lucro Presumido ou Lucro Real.
Simples Nacional: Regime simplificado para micro e pequenas empresas (LC 123/2006), com recolhimento unificado.
MEI: Microempreendedor Individual: categoria do Simples Nacional com tributos fixos mensais.
Lucro Presumido: Regime em que o IR e a CSLL são calculados sobre uma margem de lucro presumida pela lei.
Lucro Real: Regime em que o IR e a CSLL são calculados sobre o lucro contábil efetivo.
Série e número da DPS: Numeração própria de cada DPS do cliente: uma série (de 1 a 49999) e um número que só avança.
DPS: Declaração de Prestação de Serviço: os dados da nota que o sistema assina e envia para virar NFS-e.
Regime de apuração do Simples: Diz se os tributos federais e o ISS do optante do Simples são recolhidos pelo Simples (DAS) ou por fora.
Lei 12.741 (tributos aproximados): Lei que manda informar na nota o valor aproximado dos tributos pagos pelo consumidor.
Código IBGE do município: Código de 7 dígitos que identifica cada município brasileiro na NFS-e.
Tomador: Quem contrata e recebe o serviço — a pessoa ou empresa para quem a nota é emitida.
NFS-e: Nota Fiscal de Serviço eletrônica: o documento fiscal que comprova a prestação de um serviço.

Mais em Cadastros

ClientesA lista dos clientes emitentes do escritório e como chegar ao cadastro, aos certificados e ao checklist de cada um.
Detalhe do clienteTudo sobre um cliente numa página — dados, perfil fiscal, IBPT, NF-e recebidas, checklist "Pronto para emitir", fechamento, certificados e acesso ao portal.
Editar clienteComo alterar os dados de um cliente — ambiente, regime com data de início, inscrição municipal, numeração da DPS e e-mail da nota.
Certificado digital A1Como enviar, conferir, trocar e revogar o certificado A1 do cliente, e o que o sistema confere no envio.
TomadoresA agenda de quem recebe as notas de cada cliente, com as retenções de ISS e de tributos federais de cada tomador.
Produtos e tributação (NF-e e NFC-e)Como cadastrar os produtos da NF-e e da NFC-e e a tributação de cada um. O sistema calcula com os percentuais do produto e confere a coerência; a definição tributária é do contador.
ServiçosO catálogo de serviços de cada cliente — códigos, ISS, IBS/CBS, retenções federais, dedução e as regras por tomador.
Tributação municipalA tabela de códigos de tributação municipal por município e serviço nacional, usada na emissão.
IBPT por clienteComo usar, opcionalmente, a tabela do IBPT para a Lei 12.741 com o token do próprio cliente.