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 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
A solução está disponível a partir dos patches:
...
12.1.2510
12.1.2602
12.1.2606
3.
...
...
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.
O que mudou
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 (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 | 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:. O processamento ocorre de forma pontual, somente nas seguintes tags: Identificação e Cabeçalho| Tag XML | Descrição |
|---|
natOp | Natureza da operação | xJust | Justificativa de contingência |
|
|---|
formpagto | Forma de pagamento do documento. | tipodocumento | Tipo do documento. |
| Tag XML | Descrição |
|---|
xNomerazao | Razão social do emitente/destinatário | xFant | 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. | complendxCpl | Complemento do endereço. | xBairrobairro | Bairro | xMun | Município | xPais | País |
| Tag XML | Descrição |
|---|
razao | Razão social do intermediário. |
| Tag XML | Descrição |
|---|
xProdrazao | Descriçã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. |
| 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 |
|
|---|
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. |
| 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 |
|
|---|
descricao | 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. | 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:todo 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 fantasiado 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. | observacao | Observações referentes ao do documento. | 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:| Tag XML | Descrição |
|---|
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. |
|
|
