Quem desenvolve ERPs de varejo, sistemas de PDV para restaurantes ou plataformas de e-commerce sabe o quanto a identidade visual impressa na nota fiscal impacta a confiança do consumidor final.
Nos últimos anos, desde que o DREI e a Receita Federal padronizaram a Razão Social (<xNome>) de novas empresas e MEIs para o formato numérico seguido do nome civil ou societário (como 44.781.800 JOAO DA SILVA ou M J COMERCIO DE PELICULAS LTDA), milhares de lojistas passaram a reclamar de um problema comercial sério: o cliente compra na loja " Burger House Artesanal", mas recebe no WhatsApp ou na sacola do delivery um cupom fiscal NFC-e 80mm ou um DANFE A4 estampando apenas o nome desconhecido da razão social jurídica.
No Manual de Orientação do Contribuinte (MOC 7.0) da SEFAZ, o campo oficial responsável por exibir a marca comercial da empresa no XML da NF-e (Modelo 55) e da NFC-e (Modelo 65) é a tag <xFant> (Nome Fantasia) dentro do grupo <emit>.
Com o lançamento da release v0.56.128 da Notaas, o suporte a nomeFantasia (<xFant>) está disponível de ponta a ponta: no cadastro do projeto, no provisionamento Multi-CNPJ via Org API, no payload de emissão e na renderização automática do DANFE A4 e do DANFE NFC-e 80mm.
1. Anatomia da Tag <xFant> no Grupo <emit> do XML (NF-e 55 e NFC-e 65)
Pelo schema XSD leiauteNFe_v4.00.xsd, o grupo <emit> (Identificação do Emitente da Nota Fiscal Eletrônica) exige uma ordem estrita dos elementos filhos. Se você tentar injetar <xFant> depois de <enderEmit> ou enviar uma tag vazia <xFant></xFant>, a SEFAZ rejeita o lote imediatamente com Rejeição 215 (Falha no Schema XML).
Veja como a engine da Notaas estrutura o bloco <emit> quando o nomeFantasia está configurado:
<emit>
<CNPJ>44781800000162</CNPJ>
<xNome>M J PELICULAS LTDA</xNome>
<xFant>MJ PELICULAS - CONTROLE SOLAR</xFant>
<enderEmit>
<xLgr>RUA TESTE</xLgr>
<nro>100</nro>
<xBairro>CENTRO</xBairro>
<cMun>3550308</cMun>
<xMun>SAO PAULO</xMun>
<UF>SP</UF>
<CEP>01001000</CEP>
<cPais>1058</cPais>
<xPais>BRASIL</xPais>
</enderEmit>
<IE>123456789110</IE>
<CRT>1</CRT>
</emit>
⚡ Regras de Validação do
<xFant>no Motor da Notaas (v0.56.128):
- 1. Posição Exata no XSD: O elemento
<xFant>é inserido estritamente entre<xNome>e<enderEmit>.- 2. Sanitização e Limite de 60 Caracteres: O MOC exige tamanho de
1 a 60 caracteres(TString). Nossa engine aplica.trim()automático, remove espaços duplicados e trunca com segurança em 60 caracteres para jamais quebrar a validação de schema da SEFAZ.- 3. Omissão Inteligente quando Nulo/Vazio: Se a empresa não possui Nome Fantasia (
nullou string em branco" "), a tag<xFant>é omitida por completo do XML.
2. Como Configurar o nomeFantasia na Org API (POST e PATCH /api/v1/org/projects)
Para Software Houses e ERPs que gerenciam múltiplos clientes, o ideal é gravar o nomeFantasia uma única vez no cadastro do projeto. Assim, todas as NF-es e NFC-es emitidas por aquela loja herdam automaticamente o <xFant> sem que você precise enviá-lo a cada venda no caixa:
const ORG_TOKEN = process.env.NOTAAS_ORG_TOKEN!; // ntaas_org_...
const BASE_URL = "https://platform.notaas.com.br/api/v1";
// 1. Criando um novo tenant na Org API já com Nome Fantasia:
export async function criarLojaComNomeFantasia() {
const response = await fetch(`${BASE_URL}/org/projects`, {
method: "POST",
headers: {
"Authorization": `Bearer ${ORG_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Loja Matriz - MJ Películas",
cnpj: "44781800000162",
razaoSocial: "M J PELICULAS LTDA",
nomeFantasia: "MJ PELICULAS - CONTROLE SOLAR",
inscricaoEstadual: "123456789110",
crt: 1,
ambiente: 1, // 1 = Produção, 2 = Homologação
endereco: {
logradouro: "Rua Teste",
numero: "100",
bairro: "Centro",
codigoMunicipio: "3550308",
cidade: "São Paulo",
uf: "SP",
cep: "01001000"
}
}),
});
return await response.json();
}
// 2. Atualizando um projeto existente via PATCH (ou limpando com null):
export async function atualizarNomeFantasiaProjeto(projectId: string, nomeFantasia: string | null) {
const response = await fetch(`${BASE_URL}/org/projects/${projectId}`, {
method: "PATCH",
headers: {
"Authorization": `Bearer ${ORG_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ nomeFantasia }),
});
return await response.json();
}
(Você também pode preencher ou editar o campo "Nome Fantasia" diretamente na interface visual da plataforma em Configurações do Projeto → Dados da Empresa ou no modal de criação de novo projeto).
3. Sobrescrevendo o nomeFantasia por Nota + Logotipo no DANFE
Caso um mesmo CNPJ opere múltiplas bandeiras comerciais (por exemplo, um restaurante que opera como dark kitchen com três marcas diferentes no iFood sob a mesma inscrição estadual), você pode sobrescrever o Nome Fantasia diretamente no payload de emissão (POST /api/v1/nfe/emitir) enviando emit.nomeFantasia (ou emit.xFant).
Além disso, combinando o nomeFantasia com o upload de logotipo por projeto (POST /api/v1/org/projects/{id}/logo ou tool org_upload_project_logo no Notaas MCP Server), os geradores de PDF da Notaas entregam uma apresentação impecável:
- No DANFE NF-e (Modelo 55 — Retrato, Paisagem e Etiqueta Simplificada): Exibe o logotipo do emitente, a Razão Social e o Nome Fantasia no quadro de identificação superior, além do suporte completo ao Grupo G (
<entrega>) para entrega em local diferente do destinatário e à coluna de<IPI>evTotTribda Lei da Transparência. - No DANFE NFC-e 80mm (Modelo 65 — Impressoras Térmicas Epson/Bematech/Elgin): Destaca o Nome Fantasia da loja no cabeçalho do cupom térmico junto à tabela detalhada de formas de pagamento (PIX, Cartão, Dinheiro), Troco (
vTroco) e QR Code v2.
📚 Guias Técnicos Relacionados:
- 📦 API NF-e Gratuita: Como Emitir Nota Fiscal de Produto (Modelo 55): Guia pilar de integração REST JSON para NF-e.
- 🛒 NFC-e (Modelo 65): Guia Completo de Integração via API para SaaS e PDV: Como configurar Token CSC, séries e contingência offline no varejo.
- 🧾 DANFE NFC-e 80mm (PIX, Troco e Formas de Pagamento) e NF-e Produtor Rural: Detalhes do layout térmico de 80mm.
- 🏢 API Fiscal Multi-Tenant (Org API): Como gerenciar centenas de lojas e filiais com personalização White-Label.
🚀 Personalize o DANFE dos Seus Clientes na Notaas
Comece agora com 20 notas fiscais gratuitas por mês em produção + até 5 CNPJs em homologação via Org API, e escale com logotipo personalizado e domínio White-Label no Plano SaaS Pro (R$ 249/mês com CNPJs ilimitados):
👉 Criar Conta Gratuita na Notaas Platform
👉 Ver Documentação da Org API (/docs/org-api)