MANUAL DO GRANMONEY · SISTEMA WEB
Importar clientes
Importe clientes no GranMoney com planilha Excel: CPF/CNPJ, contatos, data de nascimento, endereço, atualização sem duplicar cadastros e erros.
A importação de clientes do GranMoney traz a sua base de clientes de uma planilha do Excel: nome, CPF ou CNPJ, telefones, e-mail, endereço, data de nascimento e limite de crédito. Ela também atualiza cadastros existentes, localizando o cliente pelo nome ou pelo documento.
Como importar clientes
- Abra Cadastros → Importação.
- Selecione a planilha, escolha a tabela Clientes e clique em Realizar importação (F6).
- Associe as colunas aos campos e marque Ignorar primeira linha (cabeçalho) se houver títulos.
- Para atualizar clientes já cadastrados, escolha Nome ou CPF/CNPJ em Atualizar registros baseados em.
- Clique em Realizar importação e confirme.
Os números da imagem marcam o que conferir no mapeamento de clientes.

- A coluna do documento vai para CPF/CNPJ: 11 dígitos é CPF, 14 é CNPJ.
- A coluna do estado vem antes da coluna da cidade.
- Nascimento aceita a data como texto no formato dd/mm/aaaa.
- Atualizar registros baseados em: vazio cria clientes novos; Nome ou CPF/CNPJ atualizam os existentes.
- Ignorar primeira linha (cabeçalho) marcado: a linha de títulos não vira cliente.
- Realizar importação abre a confirmação antes de gravar.
Colunas que a planilha pode ter
| Campo no GranMoney | O que colocar | Exemplo |
|---|---|---|
| Nome | Nome do cliente (obrigatório se não houver Razão social) | Mariana Costa Albuquerque |
| Razão social | Para empresas | Buffet Alegria Festas Ltda |
| CPF/CNPJ | Documento, com ou sem pontuação | 886.053.303-17 |
| RG, IE | Documentos complementares | 1234567 |
| Contato | Pessoa de contato | Juliana |
| Fone, Celular, Whatsapp | Telefones | (67) 99140-2231 |
| E-mail em formato válido | mariana.albuquerque@exemplo.com.br | |
| Estado | Sigla ou nome | MS |
| Cidade | Nome da cidade | Campo Grande |
| CEP, Rua, Número, Bairro, Complemento | Endereço | 79002-000 |
| Limite de crédito | Valor em reais | 500,00 |
| Nascimento | Data em texto, dd/mm/aaaa | 14/03/1991 |
| Nome da mãe, Observação | Textos livres | Prefere açaí sem açúcar |
| Ativo S/N | S, sim ou 1 para ativo | S |
Como o GranMoney trata os dados
- Linhas sem Nome e sem Razão social são puladas.
- O CPF/CNPJ é lido pelos números: 11 dígitos é CPF, 14 é CNPJ. Documento inválido não é gravado. Formate a coluna como texto para não perder zeros à esquerda.
- Com CNPJ, o cliente fica como pessoa jurídica; caso contrário, como pessoa física.
- A data de nascimento só é aceita com 10 caracteres, como 14/03/1991. Datas no formato de data do Excel não são lidas: deixe a coluna como texto.
- Coloque a coluna Estado antes da Cidade, para a cidade ser procurada no estado certo.
- Um erro de validação, como e-mail em formato inválido, mostra "Linha N: ..." e nenhum cliente do arquivo é gravado.
Cliente com nota fiscal emitida
Ao atualizar clientes, o CPF/CNPJ de quem já tem nota fiscal emitida com o documento atual não pode ser trocado pela planilha. Nesse caso aparece a mensagem: "Linha N: o cliente ... já possui nota fiscal emitida com o documento atual, por isso o CPF/CNPJ não pode ser alterado pela importação. Corrija a planilha ou cadastre um novo cliente. Nenhum registro foi importado."
Exemplo prático
Na imagem, a planilha traz 6 clientes: quatro pessoas físicas com CPF e data de nascimento, e duas empresas com CNPJ (um buffet e uma escola). Depois de importados, eles aparecem em Cadastros → Clientes e já podem ser escolhidos em vendas, na Agenda e nos lançamentos.
Perguntas frequentes
Como importar clientes de uma planilha no GranMoney?
Em Cadastros → Importação, envie o arquivo .xlsx, escolha a tabela Clientes, associe as colunas (Nome, CPF/CNPJ, Celular, Email...) e confirme.
Por que o CPF de alguns clientes não foi importado?
O documento estava inválido ou perdeu dígitos, normalmente o zero à esquerda quando a coluna está como número. Formate a coluna como texto e importe de novo usando CPF/CNPJ ou Nome como referência.
Como atualizar o e-mail dos clientes sem duplicar cadastros?
Use uma planilha com o CPF/CNPJ e o novo e-mail, escolha CPF/CNPJ em Atualizar registros baseados em e mapeie só essas duas colunas.
