Guia / Clientes

Cadastro de clientes: XMLs antigos, consulta de CNPJ e endereço

Publicado em 13 de outubro de 2026.

A tabela de emissão só pede nome, CNPJ ou CPF, valor e descrição. O endereço e os outros dados do tomador vêm do cadastro de clientes, que o sistema monta sozinho na maior parte dos casos.

De onde vêm os dados

XMLs de notas antigas

Na configuração inicial ou depois, em Clientes, envie XMLs soltos ou um arquivo .zip. Cliente novo recebe os dados da nota mais recente dele; cliente que já existe só tem os campos vazios completados. Notas em que o tomador é a própria empresa são ignoradas.

Consulta do CNPJ

Quando um CNPJ novo entra na tabela, o sistema consulta os dados abertos da Receita Federal (pela BrasilAPI) e preenche o cadastro com endereço e situação. O nome da tabela prevalece: o da Receita só entra se o nome estiver vazio.

Edição manual

Clique no cliente, na tela Clientes, para corrigir ou completar. CPFs não são consultados: complete o endereço à mão.

A emissão nunca depende da consulta externa. Se ela falhar, a nota sai assim mesmo, e você completa o cadastro quando quiser.

Endereço: quando é obrigatório

• Na maioria das notas, o endereço do tomador é opcional. Sem ele, a nota sai sem endereço, e a conferência avisa antes de emitir.
• Com ISS retido pelo tomador, o endereço é obrigatório: a Sefin rejeita a nota sem ele (E0237), e o sistema aponta o erro antes do envio.
• O município é escolhido pelo nome, na tabela oficial do IBGE. Um CEP que não pertence ao município também é rejeitado pela Sefin.

Avisos que o cadastro gera

• Endereço incompleto: aparece na lista de clientes e na conferência.
• CNPJ que não está ativo na Receita: a situação aparece em vermelho e a conferência avisa, sem bloquear.
• CNPJ ou CPF inválido: a célula fica vermelha na tabela e a linha não é enviada.

O CNPJ alfanumérico, emitido desde julho de 2026, é aceito no cadastro, na emissão e no cancelamento.