Conteúdo

1. Sobre

A remoção irrestrita de caracteres especiais tem impactado diretamente a qualidade e a fidelidade das descrições enviadas na NFS-e. Informações relevantes como datas (01/02/2026), valores monetários (R$), percentuais (%), separadores e pontuação são eliminadas, resultando em textos difíceis de interpretar e, em alguns casos, em não conformidade com requisitos contratuais e editais — situação comum em operações com órgãos públicos.

Além da perda de legibilidade, esse comportamento pode gerar riscos operacionais e contratuais, uma vez que a descrição do serviço, em muitos casos, precisa refletir exatamente o que está formalizado em contrato ou edital.

A solução apresentada visa mitigar estes impactos e prover ao cliente o controle de quais informações serão mantidas ou removidas na NFS-e.

2. Versões para atualização

A solução está disponível a partir dos patches:

Data: 22/05/2026

Biblioteca RM

12.1.2510
12.1.2602
12.1.2606

3. O que mudou

Anteriormente, ao habilitar a opção de remover acentos e caracteres especiais na NFS-e, o sistema eliminava todos os caracteres considerados especiais — incluindo informações importantes como datas (ex.: 01/02/2026), valores (ex.: R$ 1.500,00), percentuais (ex.: 15%) e pontuações comuns no texto.

Isso causava descrições de serviço truncadas ou de difícil leitura, podendo gerar inconsistências com contratos e editais, especialmente em operações com órgãos públicos.

Agora é possível definir, nos parâmetros da filial, exatamente quais caracteres devem ser removidos da descrição da NFS-e. Com isso, você mantém o controle sobre as informações que precisam ser preservadas, garantindo que o texto enviado na nota reflita fielmente o que está formalizado em contrato ou edital.

4. Como configurar

Acesse os parâmetros da filial e, no campo Sanitização DOC-e, informe apenas os caracteres que deseja remover. Deixe o campo vazio para que nenhum caractere adicional seja eliminado além dos acentos, caso a opção Retirar Acentos esteja habilitada.

Visão Geral dos Parâmetros

Parâmetro Comportamento

RetirarAcentos Quando habilitado, remove acentos e caracteres especiais de todo o conteúdo textual do XML gerado.

SanitizacaoDOCe

Define um conjunto de caracteres que devem ser substituídos por espaço no XML. Somente é aplicado quando RetirarAcentos também está habilitado.

O conteúdo deste campo pode ser informado de forma literal ou através de uma expressão regular, por exemplo:

Forma literal (lista de caracteres):
¨~'´`^ªº§¢£³²¹¬°

Expressão regular (exemplos):

[^A-Za-z0-9\.\,]+	Encontra sequências de caracteres "especiais" (como espaços, símbolos, acentos ou interrogações) que não sejam letras comuns, números, pontos ou vírgulas.
[^\x00-\x7F]+	Encontra caracteres "estranhos" ou fora do padrão ocidental comum (como emojis, símbolos exóticos ou ideogramas asiáticos).
\b(\w+)\s+\1\b	Encontra palavras duplicadas em sequência (como "o o" ou "que que").

NF-e — Padrão SEFAZ (envio direto e via TSS)

Os parâmetros são aplicados sobre todo o XML serializado da NF-e antes do envio. Portanto, todas as tags de conteúdo textual são afetadas, incluindo:

Identificação e Cabeçalho

Tag XML	Descrição
`natOp`	Natureza da operação
`xJust`	Justificativa de contingência

Emitente e Destinatário

Tag XML	Descrição
`xNome`	Razão social do emitente/destinatário
`xFant`	Nome fantasia
`xLgr`	Logradouro do endereço
`xCpl`	Complemento do endereço
`xBairro`	Bairro
`xMun`	Município
`xPais`	País

Produtos e Serviços

Tag XML	Descrição
`xProd`	Descrição do produto/serviço
`xCor`	Cor do produto
`xCont`	Número do container
`xDed`	Descrição da dedução

Informações Adicionais

Tag XML	Descrição
`infCpl`	Informações complementares de interesse do contribuinte
`infAdFisco`	Informações de interesse do fisco
`xTexto`	Texto de observações e processos referenciados
`xCampo`	Nome do campo de uso livre
`xPed`	Número do pedido de compra
`xNEmp`	Número do empenho

Transporte e Exportação

Tag XML	Descrição
`xLocDesemb`	Local de desembaraço aduaneiro
`xLocExporta`	Local de exportação
`xLocDespacho`	Local de despacho
`xContato`	Nome do contato responsável pelo transporte
`xAgente`	Nome do agente
`xOrgao`	Órgão emissor do documento de transporte
`xEnder`	Endereço do transportador

Cobrança e Pagamento

Tag XML	Descrição
`xPag`	Descrição do meio de pagamento
`xMotivo`	Motivo (retorno de status SEFAZ, internamente)
`xMotivoIsencao`	Descrição do motivo de isenção

NFS-e — Layout Único (TSS / TPF)

Os parâmetros são aplicados sobre todo o XML serializado do RPS/NFS-e antes do envio ao TSS ou TPF. Todas as tags de conteúdo textual são afetadas, incluindo:

Prestador e Tomador

Tag XML	Descrição
`razao`	Razão social
`fantasia`	Nome fantasia
`logradouro`	Logradouro
`compleend`	Complemento do endereço
`bairro`	Bairro
`municipio`	Município
`tipologr`	Tipo de logradouro
`tipobairro`	Tipo de bairro
`email`	E-mail

Serviço

Tag XML	Descrição
`discr`	Discriminação do serviço
`natop`	Natureza da operação

Informações Complementares

Tag XML	Descrição
`descricao`	Descrição/dados complementares do documento
`observacao`	Observações referentes ao documento
`motcanc`	Motivo de cancelamento
`descricaoMotivo`	Descrição do motivo

NFS-e — Layout Nacional (DPS)

No layout nacional, os parâmetros não são aplicados sobre todo o XML. O processamento ocorre de forma pontual, somente nas seguintes tags:

Tag XML	Descrição
`xDescServ`	Descrição do serviço prestado
`xInfComp`	Informações complementares da nota

Importante: Neste layout, SanitizacaoDOCe é aplicado mesmo quando o conteúdo já passou por RetirarAcentos. A sanitização é executada sobre a discriminação dos serviços utilizada para preencher ambas as tags acima.