Como cadastrar clientes e fornecedores

A base única de pessoas do Zukey: cliente, fornecedor ou os dois no mesmo cadastro. Veja o que cada campo faz, por que o tipo de contribuinte derruba a NF-e e como importar a carteira inteira de uma vez.

Caminho no menu	Cadastros › Clientes / Fornecedores
Endereço direto	`/app/customers`
Também se chega por	Botão de novo cadastro dentro do pedido de venda e da entrada de NF-e
Permissão necessária	Clientes

Em resumo

O mesmo cadastro pode ser cliente e fornecedor — você marca os dois papéis, não duplica a pessoa.
O tipo de contribuinte define como o ICMS sai na nota. Errado aqui, a NF-e é rejeitada na emissão.
CPF/CNPJ é a chave: o sistema não deixa cadastrar o mesmo documento duas vezes.
Cadastro com movimento não se exclui — se inativa. O botão "Excluir" só funciona em cadastro sem histórico.

Antes de abrir esta tela

Nenhum: Este é o primeiro cadastro do sistema. Só faz falta a loja estar cadastrada, se você opera com mais de uma.

O que você vê ao abrir a tela

A tela abre com a listagem de todos os cadastros. No topo ficam a busca, o filtro de loja e as ações; a tabela vem abaixo.

Campo de busca: Aceita "Nome, CPF/CNPJ ou e-mail" — o mesmo campo procura pelos três.
Filtro de loja: O seletor "Todas as lojas" recorta a lista quando você tem mais de uma empresa na conta.
Mais filtros: Abre o painel "Adicionar filtro", onde se filtra por tipo, situação e demais campos do cadastro.
Exportar CSV: Baixa a lista filtrada — útil para conferência ou para levar a carteira a outro lugar.
Colunas da tabela: Código, Nome, Pessoa (física ou jurídica), CPF / CNPJ, E-mail, Tipo, Telefone e Status.

Passo a passo: cadastrando um cliente

No menu lateral, abra Cadastros › Clientes / Fornecedores. A URL é /app/customers.
Clique no botão de novo cadastro, no canto superior direito da listagem.
Escolha o tipo de pessoa: física (CPF) ou jurídica (CNPJ). A escolha muda os campos seguintes.
Informe o CPF ou o CNPJ. Se o documento já existir na base, o sistema avisa e não deixa duplicar.
Preencha o nome (pessoa física) ou a razão social e o nome fantasia (pessoa jurídica).
Marque o papel do cadastro: cliente, fornecedor ou os dois. É isso que faz a pessoa aparecer na busca do pedido de venda, na entrada de nota, ou nas duas telas.
Informe o tipo de contribuinte de ICMS — contribuinte, não contribuinte ou isento. Este campo vai direto para a nota fiscal; veja a tabela da próxima seção antes de escolher.
Em pessoa jurídica, preencha a Inscrição Estadual quando o cliente for contribuinte, e a Inscrição Municipal se você emite NFS-e para ele.
Digite o CEP: logradouro, bairro, cidade e UF vêm preenchidos. Complete o número e o complemento — número em branco rejeita a nota.
Informe telefone, celular e e-mail. O e-mail é o endereço para onde a NF-e autorizada é enviada.
Se quiser, complete os dados cadastrais opcionais: RG, Data de Nascimento, Gênero, Estado Civil, Profissão, Nacionalidade e Website.
Defina o Status como Ativo (as outras opções são Inativo e Bloqueado).
Salve. O cadastro já pode ser usado em qualquer tela de venda ou de compra.

Vendedor e categoria de cliente são opcionais, mas quem usa comissão ou quer separar a carteira por perfil ganha tempo preenchendo desde o começo.

O campo que mais causa rejeição de nota

O tipo de contribuinte não é detalhe cadastral: ele define a tributação de ICMS da operação. Marcar um consumidor final como contribuinte, ou o contrário, é a causa mais comum de nota rejeitada em quem está começando.

Tipo	Quem é	Efeito na nota
Contribuinte	Empresa com inscrição estadual ativa	Operação entre contribuintes; a IE vai na nota
Não contribuinte	Consumidor final, pessoa física, empresa sem IE	Operação para consumidor final
Isento	Empresa dispensada de inscrição estadual	Sem IE, mas tratada como pessoa jurídica

Na dúvida sobre um CNPJ, consulte a inscrição estadual antes de emitir. Corrigir o cadastro depois não conserta uma nota já autorizada.

Importando a carteira por planilha

Quem vem de outro sistema não precisa redigitar. A tela tem importação em massa: você baixa o modelo, cola seus dados nas colunas correspondentes e envia o arquivo.

Na listagem de clientes, abra a importação por planilha.
Baixe o modelo e preencha uma linha por pessoa, respeitando os nomes das colunas.
Envie o arquivo e confira a prévia: o sistema aponta as linhas com documento inválido ou repetido antes de gravar qualquer coisa.
Confirme. Os cadastros aceitos entram na lista; os recusados voltam com o motivo, para você corrigir e reenviar só eles.

Cuidado com o CNPJ vindo de planilha: com e sem pontuação são lidos como documentos diferentes se o formato variar entre linhas. Padronize a coluna antes de enviar.

Inativar x excluir

São ações diferentes e a tela oferece as duas. Cadastro que já apareceu em uma nota ou em um título financeiro não pode ser apagado — o sistema mostra o aviso "Não é possível excluir" na coluna de ações.

Ação	Quando usar	O que acontece
Inativar	Cliente que parou de comprar	Some das buscas de venda, histórico preservado
Bloquear	Cliente inadimplente	Continua visível, sinalizado na operação
Excluir	Cadastro criado por engano, sem movimento	Removido de vez; só funciona sem histórico

O que costuma dar errado

Endereço sem número: A NF-e exige número e código do município. Cadastro importado sem número derruba a nota na emissão.
Fornecedor sem o papel marcado: Se a pessoa não aparece na entrada de NF-e, quase sempre é porque só o papel de cliente está marcado.
Inscrição Estadual em cliente não contribuinte: Combinação inconsistente: ou o tipo está errado, ou a IE não deveria estar ali.
Buscar antes de criar: Use o campo de busca com o documento antes de cadastrar. É mais rápido que descobrir a duplicidade depois.

Perguntas frequentes

Posso usar o mesmo cadastro como cliente e fornecedor?

Sim, e é o recomendado. Marque os dois papéis no mesmo cadastro: o histórico de compra e de venda fica na mesma pessoa, sem duplicar documento.

Consigo importar clientes de outro sistema?

Sim. Exporte para planilha no sistema antigo, transfira os dados para o modelo do Zukey e use a importação em massa. A prévia mostra o que será gravado antes de confirmar.

É obrigatório informar e-mail do cliente?

Não para salvar, mas sem e-mail a NF-e autorizada não é enviada automaticamente ao destinatário — você precisa baixar o PDF e mandar por fora.

Tenho duas lojas. Preciso cadastrar o cliente nas duas?

O filtro "Todas as lojas" na listagem indica que o cadastro é vinculado à loja. Cadastre na loja que vende para ele, ou nas duas se ele compra dos dois CNPJs.

Continue de onde parou

Próxima guia de Cadastros: Como cadastrar produtos

Relacionadas:

Voltar para o índice da central de ajuda ou conhecer os recursos do sistema.