...
| Í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 O sistema permite configurar, por filial, quais caracteres especiais devem ser removidos das descrições enviadas no Doc-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.
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. 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 deve ser informado de forma literal ou através de uma expressão regular, por exemplo: Forma literal ((uma lista de caracteres), por exemplo: 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 | NFNFS-e — Padrão SEFAZ (envio direto e via TSSLayout Único (TSS / TPF) |
|---|
| NFNFS-e — Padrão SEFAZ (envio direto e via TSSLayout Único (TSS / TPF)Os parâmetros não 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. O processamento ocorre de forma pontual, somente nas seguintes tags: natOp | Natureza da operação | xJust | Justificativa de contingência | formpagto | Forma de pagamento do documento. | tipodocumento | Tipo do documento. |
xNome emitente/destinatárioxFant | Nome fantasia | xLgr | Logradouro do endereço | | prestador. | logradouro | Logradouro do prestador. | compleend | Complemento do endereço. | bairro | Bairro do prestador. |
| Tag XML | Descrição |
|---|
logradouro | Logradouro da prestação. | complend |
xCplxBairroxMun | Município | xPais | País | | Tag XML | Descrição |
|---|
razao | Razão social do intermediário. |
xProdDescrição do produto/serviço | xCor | Cor do produto | xCont | Número do container | xDed | Descrição da dedução | | Razão social do tomador. | logradouro | Logradouro do tomador. | complend | Complemento do endereço. | bairro | Bairro do tomador. |
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 | nome | Nome do destinatário. | logradouro | Logradouro do destinatário. | complend | Complemento do endereço do destinatário. | bairro | Bairro do destinatário. |
| Tag XML | Descrição |
|---|
endereco | Endereço do imóvel. | complemento | Complemento do imóvel. | bairro | Bairro do imóvel. |
| Tag XML | Descrição |
|---|
discr | Discriminação do serviç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 Pagamentodescricao | Descrição/dados complementares. | observacao | Observações do documento. |
| Tag XML | Descrição |
|---|
nomraz | Nome/Razão social do responsável. | endereco | Endereço da atividade portuária. | compl | Complemento do endereço. | bairro | Bairro da atividade portuária. |
| Tag XML | Descrição |
|---|
endereco | Endereço da construção civil. | compl | Complemento do endereço. | bairro | Bairro da construção civil. |
| Tag XML | Descrição |
|---|
xLogObra | Logradouro da obra. | xComplObra | Complemento do logradouro da obra. | xBairroObra | Bairro da obra. |
| Tag XML | Descrição |
|---|
logradouro | Logradouro do imóvel. | complend | Complemento do imóvel. | bairro | Bairro do imóvel. |
| 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 Nacional (TSS / TPFDPS) |
|---|
| NFS-e — Layout Único Nacional (TSS / TPFDPS)Os parâmetros não 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 Tomadortodo o XML. O processamento ocorre de forma pontual, somente nas seguintes tags: | Tag XML | Descrição |
|---|
xLgr | Logradouro do endereço. | xCpl | Complemento do endereço. | xBairro | Bairro do endereço. |
| Tag XML | Descrição |
|---|
xNome | Nome/Razão social do prestador. |
| Tag XML | Descrição |
|---|
xNome | Nome/Razão social do tomador. |
| Tag XML | Descrição |
|---|
xNome | Nome/Razão social do intermediário. |
| Tag XML | Descrição |
|---|
xDescServ | Descrição do serviço. |
| Tag XML | Descrição |
|---|
infoCompl | Informações complementares do serviço. |
| Tag XML | Descrição |
|---|
xInfComp | Texto de informações complementares. |
| Tag XML | Descrição |
|---|
razao | Razão social |
fantasia | Nome fantasia| do prestador. | compleend | Complemento do endereço do prestador. | bairro | Bairro do prestador. |
| Tag XML | Descrição |
|---|
logradouro | Logradouro da prestação. |
compleendcomplend | Complemento do endereço da prestação. | bairro | Bairro |
municipio | Município | tipologr | Tipo de logradouro | tipobairro | Tipo de bairro | email | E-mail | | Tag XML | Descrição |
|---|
razao | Razão social do intermediário. |
| Tag XML | Descrição |
|---|
razao | Razão social do tomador. | logradouro | Logradouro do tomador. | complend | Complemento do endereço do tomador. | bairro | Bairro do tomador. |
| Tag XML | Descrição |
|---|
nome | Nome do destinatário. | logradouro | Logradouro do destinatário. | complend | Complemento do endereço do destinatário. | bairro | Bairro do destinatário. |
| Tag XML | Descrição |
|---|
endereco | Endereço do imóvel. | complemento | Complemento do imóvel. | bairro | Bairro do imóvel. |
| 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 referentes ao motcanc | Motivo de cancelamento | descricaoMotivo | Descrição do motivo | | | Card |
|---|
| label | NFS-e — Layout Nacional (DPS) |
|---|
| | Tag XML | Descrição |
|---|
nomraz | Nome/Razão social do responsável. | endereco | Endereço da atividade portuária. | compl | Complemento do endereço. | bairro | Bairro da atividade portuária. |
| Tag XML | Descrição |
|---|
endereco | Endereço da construção civil. | compl | Complemento do endereço. | bairro | Bairro da construção civil. |
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:xDescServ | Descrição do serviço prestado | xInfComp | Informações complementares da nota | 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 |
|---|
xLogObra | Logradouro da obra. | xComplObra | Complemento do logradouro da obra. | xBairroObra | Bairro da obra. |
| Tag XML | Descrição |
|---|
logradouro | Logradouro do imóvel. | complend | Complemento do imóvel. | bairro | Bairro do imóvel. |
|
|
