📅 Data de publicação
02/04/2026
🎯 Objetivo
Orientar a análise e correção do erro Wscerr047 / xml error extra content at the end of the document no TSS (Transmissão de Documentos Eletrônicos), normalmente associado a problemas de comunicação entre o TSS e o DBAccess.
🖥️ Ambiente
Cross Segmentos - TSS Transmissão de Documentos Eletrônicos
Aplicável a: todas as versões
🧩 Sintoma
Ao processar a transmissão de documentos eletrônicos no TSS, pode ocorrer a mensagem:
Wscerr047 / xml error extra content at the end of the document
Esse comportamento geralmente indica inconsistência na comunicação entre os componentes responsáveis pelo acesso ao banco e pela operação do TSS.
🔎 Causa
De forma geral, esse erro está relacionado a problemas de conexão entre o TSS e o DBAccess.
Na prática, isso pode ocorrer por motivos como:
configuração incorreta da fonte de dados ODBC;
falha de parametrização do DBAccess utilizado pelo TSS;
ausência de comunicação adequada com o banco de dados;
bibliotecas do DBAccess/DBApi desatualizadas.
✅ Solução
Para corrigir o problema, recomenda-se executar as validações abaixo em sequência.
1. Revisar a configuração do ODBC
Verifique se a fonte de dados ODBC utilizada pelo TSS está corretamente configurada, apontando para o banco de dados correto e com os parâmetros compatíveis com o ambiente.
Pontos de atenção:
nome da fonte de dados;
servidor do banco;
porta de comunicação;
usuário e senha;
driver compatível com o banco utilizado;
teste de conexão concluído com sucesso.
2. Validar a configuração do DBAccess
Confirme se o DBAccess está corretamente configurado para atender o TSS.
Revise principalmente:
arquivo de configuração do ambiente;
porta de comunicação do DBAccess;
parâmetros de conexão com o banco;
inicialização do serviço;
conectividade entre o servidor do TSS e o serviço DBAccess.
3. Confirmar a comunicação entre TSS e banco de dados
Após revisar ODBC e DBAccess, valide se o TSS consegue efetivamente acessar o banco.
Recomenda-se verificar:
se o serviço do DBAccess está ativo;
se não há bloqueio por firewall ou antivírus;
se o servidor onde está o TSS alcança a máquina/porta do DBAccess;
se não existem falhas de rede intermitentes;
se os logs indicam perda de comunicação ou timeout.
4. Atualizar as bibliotecas do DBAccess / DBApi
Também é importante verificar se as bibliotecas do DBAccess estão atualizadas.
Quando necessário, realize a atualização da DBApi nos dois ambientes:
AppServer do TSS
AppServer do Protheus
Esse ponto é importante porque incompatibilidades ou bibliotecas antigas podem causar falhas de interpretação na comunicação e refletir no erro apresentado.
🛠️ Procedimento recomendado
Para facilitar a tratativa, siga esta ordem:
validar a fonte ODBC;
revisar a configuração do DBAccess;
testar a comunicação entre TSS, DBAccess e banco;
atualizar a DBApi no AppServer do TSS;
atualizar a DBApi no AppServer do Protheus;
reiniciar os serviços envolvidos;
executar novo teste de transmissão.
🔍 Boas práticas preventivas
Para evitar recorrência desse tipo de erro, recomenda-se:
manter DBAccess e DBApi sempre atualizados;
documentar as configurações de ODBC do ambiente;
padronizar parâmetros entre TSS, AppServer e banco de dados;
monitorar serviços e portas de comunicação;
revisar logs periodicamente após atualizações de ambiente.
📌 Conclusão
O erro Wscerr047 / xml error extra content at the end of the document no TSS, na maior parte dos casos, não está ligado diretamente ao XML do documento eletrônico em si, mas sim a falhas de comunicação e configuração entre TSS, DBAccess e banco de dados.
A abordagem correta é revisar a infraestrutura de conexão, validar o ODBC, conferir o DBAccess e garantir a atualização das bibliotecas DBApi nos ambientes envolvidos.
❓ FAQ
1. Esse erro significa que o XML da NF-e está inválido?
Nem sempre. Nesse cenário, a ocorrência costuma estar mais associada à comunicação entre TSS e DBAccess do que propriamente à estrutura do XML.
2. O que devo verificar primeiro?
O primeiro passo é revisar a configuração da fonte ODBC e do DBAccess.
3. Atualizar apenas o TSS resolve?
Não necessariamente. A recomendação é atualizar a DBApi tanto no AppServer do TSS quanto no AppServer do Protheus.
4. Pode ser problema de rede?
Sim. Bloqueios de porta, firewall, indisponibilidade do serviço ou falhas de comunicação podem contribuir para esse erro.
5. Esse procedimento vale para qualquer versão?
Sim. A orientação é aplicável para todas as versões do ambiente TSS mencionado.
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”