Nome Fantasia do Destinatário no DANFE e no XML da NF-e | 132741 | Resulth ERP
CONTEXTO
Durante a conferência de documentos fiscais, identificar o destinatário somente pela Razão Social pode dificultar o reconhecimento comercial rápido. Com esta versão, é possível incluir o Nome Fantasia do cliente diretamente nos Dados Adicionais do DANFE e no XML da NF-e, tornando a identificação mais ágil e assertiva.
O QUE MUDOU
Novo parâmetro "Mostrar o NOME FANTASIA do cliente no campo DADOS ADICIONAIS do DANFE" adicionado na tela Parâmetros da NF-e, guia DANFE.
Quando habilitado, o sistema inclui automaticamente a linha NOME FANTASIA: [nome] nos Dados Adicionais de toda NF-e emitida para cliente PJ com Nome Fantasia cadastrado.
A informação é gravada na tag XML <infCpl>, garantindo que a reimpressão do DANFE sempre respeite o conteúdo original do XML.
Suporte tanto ao DANFE padrão quanto ao DANFE personalizado — novo campo INFCPL disponível no configurador de layout personalizado.
Funciona exclusivamente para clientes Pessoa Jurídica (PJ). Clientes PF e PJ sem Nome Fantasia cadastrado não são afetados.
COMO ACESSAR E CONFIGURAR
Caminho: Parâmetros da NF-e>Guia DANFE |
Localize o novo parâmetro ao final da lista de opções da guia DANFE e marque o checkbox para habilitar:
Parâmetros da NF-e — guia DANFE com o novo parâmetro "Mostrar o NOME FANTASIA do cliente no campo DADOS ADICIONAIS do DANFE" destacado
Parâmetro |
Tipo |
Valor padrão |
Mostrar o NOME FANTASIA do cliente no campo DADOS ADICIONAIS do DANFE |
Checkbox |
✘ Desmarcado |
Comportamento por estado do parâmetro
Estado |
Dados Adicionais do DANFE |
Tag XML infCpl |
✔ Marcado |
NOME FANTASIA: [Nome Fantasia — até 67 caracteres] |
Gravado automaticamente na emissão |
✘ Desmarcado |
Comportamento atual — sem alteração |
Nome Fantasia não é gravado |
COMO USAR — PASSO A PASSO
Habilitando o recurso
Acesse Parâmetros da NF-e e clique na guia DANFE.
Localize ao final da lista o parâmetro "Mostrar o NOME FANTASIA do cliente no campo DADOS ADICIONAIS do DANFE" e marque o checkbox.
Clique em OK para salvar.
Emitindo a NF-e
Emita a NF-e normalmente para um cliente PJ que possua Nome Fantasia cadastrado.
O sistema inclui automaticamente nos Dados Adicionais a linha:
NOME FANTASIA: [Nome Fantasia do cliente]
A informação é gravada na tag <infCpl> do XML no momento da autorização.
Dados Adicionais do DANFE — Nome Fantasia exibido ao final das Informações Complementares após habilitação do parâmetro
Reimprimindo o DANFE
Na reimpressão, o sistema lê o Nome Fantasia exclusivamente do XML já autorizado — nunca do cadastro atual do cliente.
Se a NF-e foi emitida antes da habilitação do parâmetro, o Nome Fantasia não será exibido na reimpressão, pois o dado não estava no XML original.
DANFE Personalizado
Para quem utiliza layout de DANFE personalizado, o novo campo INFCPL está disponível no configurador, permitindo posicioná-lo livremente no layout. Na guia Personalizar DANFE, dentro dos Parâmetros da NF-e, é possível incluir e posicionar o campo conforme necessário.
REGRAS DE NEGÓCIO
O parâmetro vem desmarcado por padrão — nenhuma NF-e existente é afetada automaticamente.
Funciona somente para clientes Pessoa Jurídica (PJ). Clientes PF não são impactados.
O Nome Fantasia é limitado a 67 caracteres, respeitando o comportamento atual de truncamento das informações complementares.
Se o cliente PJ não possuir Nome Fantasia cadastrado, o rótulo "NOME FANTASIA:" não é exibido e nenhum espaço em branco desnecessário é gerado.
A informação é persistida exclusivamente via tag <infCpl> no XML da NF-e.
A reimpressão não consulta o cadastro atual do cliente — usa apenas o conteúdo gravado no XML autorizado.
O campo INFCPL está disponível tanto no DANFE padrão quanto no DANFE personalizado.
BOAS PRÁTICAS E OBSERVAÇÕES
⚠ |
Atenção à reimpressão de NF-es antigas. NF-es emitidas antes da habilitação do parâmetro não terão o Nome Fantasia nos Dados Adicionais, mesmo após ativar o recurso. Esse é o comportamento esperado e correto. |
💡 |
Verifique se o Nome Fantasia está preenchido no cadastro do cliente antes de emitir. Clientes PJ sem Nome Fantasia cadastrado não exibirão a linha nos Dados Adicionais. |
ℹ️ |
Para usuários de DANFE personalizado: após habilitar o parâmetro, acesse a guia Personalizar DANFE nos Parâmetros da NF-e e posicione o campo INFCPL no local desejado do layout para que a informação seja exibida corretamente. |