Conteúdo
| Índice |
|---|
| maxLevel | 1 |
|---|
| exclude | Conteúdo |
|---|
| style | none |
|---|
| separator | none |
|---|
|
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.
...
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:
...
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"). |
|
| Deck of Cards |
|---|
| startHidden | false |
|---|
| history | false |
|---|
| id | Tipos |
|---|
|
| Card |
|---|
| label | NF-e — Padrão SEFAZ (envio direto e via TSS) |
|---|
| 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 |
| 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 |
|
| Card |
|---|
| label | NFS-e — Layout Único (TSS / TPF) |
|---|
| 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 |
| 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 |
|
| Card |
|---|
| label | NFS-e — Layout Nacional (DPS) |
|---|
| 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.
|
|
