Importar cadastros (CSV/Excel)

Já tem seus clientes e produtos em uma planilha? Importe tudo de uma vez, sem digitar um por um. A importação aceita CSV e Excel (.xlsx), mostra uma pré-visualização com o que está certo e o que tem erro, e só grava quando você confirma.

Onde fica

• Cadastros → Produtos → Importar
• Cadastros → Clientes → Importar

Passo a passo

1. Clique em Importar e depois em Baixar modelo. Você recebe um arquivo com as colunas certas e duas linhas de exemplo.
2. Preencha uma linha por registro (apague as linhas de exemplo) e salve. Pode salvar como CSV ou manter em Excel .xlsx.
3. Volte em Importar, selecione o arquivo e clique em Enviar e pré-visualizar.
4. Confira a pré-visualização: cada linha aparece como Novo, Atualiza ou Erro, com a mensagem do que precisa corrigir.
5. Clique em Importar N válida(s). As linhas com erro são ignoradas (corrija e reenvie se quiser incluí-las).

Reenviar a mesma planilha atualiza os registros já existentes — produto pelo código, cliente pelo CPF/CNPJ. Nada é duplicado.

Colunas do modelo

Produtos

codigo · descricao · ncm (8 díg.) · cest (7 díg., opcional) · unidade (ex.: UN) · gtin (opcional) · valorUnitario · origem (0 a 8) · grupoCodigo (opcional)

Clientes

tipoPessoa (J jurídica / F física) · cpfCnpj · razaoSocial · nomeFantasia · inscricaoEstadual · indicadorIe (1, 2 ou 9) · email · telefone · codigo · grupoCodigo · logradouro · numero · complemento · bairro · municipio · uf · cep

O código do município (IBGE) é descoberto automaticamente a partir de município + UF — você não precisa preenchê-lo. Se o nome da cidade não bater com a UF, a linha acusa erro.

Dicas para não dar erro

• Não precisa de máscara: pode mandar CNPJ/CEP com ou sem pontos/traços — o sistema limpa.
• CNPJ e CPF são validados pelo dígito verificador (inclusive o novo CNPJ alfanumérico).
• NCM tem 8 dígitos; CEST, quando houver, 7.
• valorUnitario aceita vírgula ou ponto (2,50 ou 2.50).
• grupoCodigo deve ser o código de um grupo já cadastrado; se não existir, o registro entra sem grupo (a linha mostra um aviso, mas importa).
• Acentos: salvando como CSV pelo Excel, prefira "CSV UTF-8"; ou use o .xlsx direto.

Pela API de integração também é possível sincronizar cadastros de forma contínua a partir do seu ERP.