Tempo de leitura: 2 minutos
Nesse post, vamos aprender detalhadamente os significados dos status das tabelas SPED050 e SPED052 do TSS (TOTVS Sped Service). Entender esses códigos é fundamental para Analistas e Desenvolvedores Protheus que precisam diagnosticar falhas de transmissão e garantir a conformidade fiscal das operações de NFe e NFSe.
O TSS é o motor de comunicação entre o Protheus e as SEFAZ estaduais e prefeituras. Quando ocorre um erro na transmissão, o primeiro lugar onde buscamos respostas é no banco de dados do TSS. Este guia faz parte da nossa trilha de TSS no Protheus e é um complemento essencial para quem já domina as rotinas do Backoffice.
Status TSS: Guia das Tabelas SPED050 e SPED052 no Protheus
Se você já se deparou com uma nota fiscal “presa” ou com erro desconhecido no Monitor de Transmissão, sabe que a consulta direta via SQL nas tabelas do TSS é o caminho mais rápido para a solução. As tabelas SPED050 (Cabeçalho de Documentos) e SPED052 (Log de Eventos/Lotes) guardam o histórico vital de cada tentativa de envio.
Tabela SPED050: Status da Nota Fiscal
A tabela SPED050 armazena o cabeçalho do documento fiscal. O campo principal para análise é o
1 | STATUS |
Campo STATUS (NFe/NFSe)
Este campo indica em que estágio de processamento o documento se encontra dentro do TSS.
Outros Status Importantes na SPED050
- STATUSCANC (Cancelamento/Inutilização):
- 1: Recebido para cancelamento.
- 2: Cancelado com sucesso.
- 3: Falha na tentativa de cancelamento.
- STATUSMAIL (Envio de E-mail):
- 1: E-mail na fila para transmissão.
- 2: E-mail enviado ao cliente/transportadora.
- 3: Bloqueio de envio (geralmente por cancelamento).
Tabela SPED052: Status do Lote
A tabela SPED052 controla o envio dos lotes de documentos. É comum uma nota estar correta, mas o lote apresentar falhas de comunicação.
Exemplo Prático: Consulta de Status via SQL
Para um diagnóstico rápido diretamente no Microsoft SQL Server, você pode utilizar a query abaixo para identificar notas com erro (Status 3 ou 5):
Consulta de Notas com Erro no TSS Tabela: SPED050 */ SELECT NFE_ID, STATUS, STATUSDESC, SERIE, NNF FROM SPED050 WHERE STATUS IN ('3', '5') AND D_E_L_E_T_ = ''
👉 Dica: Se o status estiver como ‘3’, o problema geralmente é no Dicionário de Dados do Protheus (tamanhos de campos ou validações SX3) que gerou um XML inválido para o TSS.
