...
O sistema permite configurar, por filial, quais caracteres especiais devem ser removidos das descrições enviadas na NFS-e. Com isso, é possível preservar informações como datas, valores monetários, percentuais e pontuações que fazem parte do texto do serviço, garantindo que o conteúdo transmitido reflita fielmente o que está formalizado em contrato ou edital — situação especialmente relevante em operações com órgãos públicos.
Essa configuração é feita nos parâmetros da filial, no campo Sanitização DOC-e, onde você informa exatamente quais caracteres devem ser eliminados, mantendo controle total sobre o que será preservado na descrição da nota.
2. Versões para atualização
...
12.1.2510
12.1.2602
12.1.2606
3.
...
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.
...
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.
...
4. 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: [^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. SanitizacaoDOCe somente é aplicado quando RetirarAcentos também estiver habilitado.
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 parametros sao 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. SanitizacaoDOCe somente é aplicado quando RetirarAcentos também estiver habilitado.
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 independentemente de RetirarAcentos estar habilitado. Basta que o campo esteja preenchido para que a sanitização seja executada sobre a discriminação dos serviços, utilizada para preencher ambas as tags acima.
|
|
