🧩 Resumo

Ao transmitir NFS-e via TSS (TOTVS Service SOA) para prefeituras atendidas pelo provedor GissOnline no layout ABRASF 2.04, pode ocorrer falha de validação de schema (XSD) quando o XML é gerado com a tag Aliquota contendo 4 casas decimais (ex.: 0.0250), mas o schema do provedor aceita apenas 2 casas.
A correção é feita por pacote oficial que ajusta o schema (originalmente expedido para um município específico) e, quando aplicável, requer *renomear o arquivo .xsd para o código IBGE do município que está sendo transmitido. TDN

🎯 Aplicabilidade

✅ Indicado quando você identificar no log/retorno do TSS erro semelhante a:

• Aliquota: [facet 'fractionDigits'] The value '0.0250' has more fractional digits than are allowed ('2')

🔎 Cenário comum:

• Provedor GissOnline

• Layout ABRASF 2.04

• Município destino com schema exigindo 2 casas na Aliquota

⚙️ Pré-requisitos

• Acesso ao servidor do TSS (parar/iniciar serviços e editar arquivos).

• Backup da pasta de schemas/arquivos do TSS antes de qualquer alteração.

• Pacote de correção oficial disponível na Central de Downloads (conforme orientação TOTVS no ticket) e documentação técnica do item. TDN

🛠️ Passo a passo

1) ✅ Baixar e aplicar o pacote oficial de correção

1. Baixe o pacote de correção indicado pela TOTVS para o problema de fractionDigits na tag Aliquota (o pacote trata ajuste no schema do município originalmente contemplado). TDN

2. Aplique o pacote seguindo o procedimento padrão de atualização/aplicação para New NFS-e no TSS:

   • Parar o serviço do TSS

   • Proceder com a aplicação do pacote conforme rotina recomendada (inclui controles de JOB quando aplicável)

   • Reiniciar o TSS ao final TDN

💡 Dica: mantenha o TSS e artefatos do produto atualizados com o pacote de expedição contínua mais recente, conforme boas práticas do processo de aplicação. TDN

2) 🧾 Validar o arquivo de schema entregue no pacote

Na documentação técnica do ticket, a correção aponta a função/arquivo de schema no padrão:

• nfse_v2.04_<codigoIBGE>.xsd (exemplo do pacote: nfse_v2.04_2704302.xsd) TDN

Confirme no diretório de schemas do TSS se o arquivo foi atualizado/substituído corretamente.

3) 🏙️ Quando necessário: renomear o schema para o município de destino

📌 Em alguns cenários, o pacote é expedido com o schema nomeado para um município específico (código IBGE).
Se o município que está falhando for outro, mas mesmo provedor/layout (ex.: GissOnline / ABRASF 2.04) e o problema for idêntico (casas decimais da Aliquota), aplique a prática operacional abaixo:

1. Localize o schema entregue/ajustado no padrão:

   • nfse_v2.04_2704302.xsd (município do pacote) TDN

2. Faça backup do arquivo antes de alterar.

3. Renomeie para o código IBGE do município de destino. Exemplo:

   • Destino: Guarujá/SP = 3518701

   • Renomear para: nfse_v2.04_3518701.xsd

✅ Após isso, reinicie o TSS e reteste a transmissão.

⚠️ Importante: essa adaptação só é recomendada quando o município utiliza o mesmo provedor e o mesmo layout (ABRASF 2.04 / GissOnline), pois o schema pode variar entre cidades mesmo dentro do mesmo provedor.

4) 🔁 Revalidar parametrizações no ERP (quando aplicável)

Após implementação/alteração de município/layout, pode ser necessário “replicar” parâmetros do município no ERP (ex.: execução do Wizard de configuração na rotina fiscal correspondente), conforme orientação padrão do processo de New NFS-e. TDN

❗ Erros comuns

• 🧱 Aplicar o pacote e não reiniciar o TSS (o schema pode não ser carregado corretamente).

• 🗂️ Renomear o schema com código IBGE incorreto (ex.: confundir código do município).

• 🔀 Usar o schema ajustado em município com layout/provedor diferente (pode causar novas rejeições).

• 🧨 Alterar arquivos sem backup (dificulta rollback).

❓ FAQ

1) Isso é erro de parametrização do Protheus?
Normalmente não. O erro ocorre por validação do XSD (schema) exigindo 2 casas na tag Aliquota, enquanto o XML é validado contra um schema que restringe fractionDigits. A correção é feita no schema do TSS. TDN

2) O pacote resolve para qualquer prefeitura?
O ajuste foi documentado para um município específico. Para outros municípios, pode ser necessário renomear o schema para o código IBGE correto quando o cenário técnico for equivalente (mesmo provedor/layout). TDN

3) Qual o padrão do nome do schema da New NFS-e?
No caso documentado: nfse_v2.04_<codigoIBGE>.xsd. TDN

🔗 Referências

• TOTVS TDN — Documento técnico do ticket (ajuste no schema para tratar casas decimais esperadas na Aliquota). TDN

• TOTVS TDN — Procedimento de aplicação de pacote/atualização da New NFS-e do TSS (NFS0077). TDN

🏷️ Sugestão para cadastro na Base de Conhecimento

Título: NFS-e (TSS / New NFS-e) — Erro de schema na tag Aliquota (fractionDigits) ao transmitir ABRASF 2.04 (GissOnline)
Categoria: Protheus > Documentos Eletrônicos > NFS-e > TSS
Tags: tss, nfse, new-nfse, gissonline, abrasf-204, schema, xsd, aliquota, fractiondigits, guaruja