Como funciona o sugTES — cadastro automático de TES (SF4) no Acelerador Bee IT

Como Funciona 01 de julho de 2026 8 min de leitura por Daniel Silva Moreira · Canal Homologado TOTVS · Bee IT

Cadastrar TES (Tipo de Entrada e Saída, tabela SF4) manualmente no Protheus é uma das tarefas mais lentas de uma implantação — consultor sênior leva 2 a 4 horas por TES, e em uma indústria média isso vira 160 a 320 horas só pra deixar o SIGAFAT operacional. O agente sugTES do Acelerador Implantação Bee IT faz esse trabalho em ~10 horas totais — 3 a 6 minutos por TES com revisão humana.

Este post mostra como o sugTES funciona por dentro: quais dados ele lê, como decide o CST, como cobre Reforma Tributária 2026 e como o envio ao Protheus fecha o ciclo.

O ponto de partida — o SPED do cliente

O sugTES não parte do zero. Ele parte do SPED EFD ICMS/IPI que o cliente já emite. No painel esquerdo, dentro de IMPORTAÇÃO, você sobe o SPED dos últimos 3 meses (~15.000 notas típico) e o parser interno extrai em ~10 segundos:

Todos os CFOPs únicos usados (~25 a 40 em uma indústria média)
CSTs vigentes por CFOP (a lista mostra 20 CFOP 5102 com CST 000, 15 CFOP 5102 com CST 020, etc)
NCMs únicas por CFOP
UFs de origem e destino
Tipo de destinatário (PJ Simples, PJ Real, PJ Presumido, PF, MEI)

Esse dataset vira a base fatual que o sugTES usa. Sem ele o agente teria que adivinhar — com ele, o agente sabe exatamente o que o cliente já opera.

O agente lê a base e gera sugestões

Na tela Cadastros → SF4 · TES, você clica em "Sugerir com IA". O sugTES envia pro Claude Sonnet 4.6 um pacote contendo:

Dados do CNPJ do cliente (regime tributário, UF, IE, ramo)
Lista de CFOPs únicos com contagem de uso
CSTs vigentes por CFOP no SPED
NCMs mais representativas
Configuração dos parâmetros MV_ do Protheus do cliente (MV_ATUSA1, MV_TESICMSST, MV_XBSICPF, etc)
Vinculação atual com os cadastros F2A-CJG da Reforma Tributária 2026 (se já existe)

E devolve uma TES sugerida por CFOP, com todos os campos preenchidos:

Descrição amigável ("Venda interestadual ST de Eletrônicos")
CST 1 (origem: 0 nacional, 1 importada, 2 nacional > 40% importado…)
CST 2 (tributação ICMS: 00, 10, 20, 30, 40, 50, 60, 70, 90)
CSOSN se for Simples Nacional
Tratamento IPI (entrada com crédito, saída com débito, suspensão)
PIS/COFINS por regime (cumulativo, não cumulativo, monofásico)
Atualiza estoque / gera duplicata / debita orçamento
ICMS-ST com MVA (se aplicável ao produto do cliente)
Diferencial de alíquota (EC 87/2015) quando for consumidor final
Vinculação F2A/CJE pra RT 2026
Confidence score de 0.0 a 1.0

Sugestões com confidence ≥ 0.7 vão direto pra fila "Aprovadas". Sugestões com confidence < 0.7 caem numa tela dedicada de revisão manual, com o CFOP + CSTs vigentes + racional da IA lado a lado.

O que a IA acerta de primeira e o que precisa humano

Na média dos projetos rodados, o sugTES acerta ~70% das TES sem revisão humana. Os padrões onde a IA acerta:

CFOP 5102 (venda interestadual de mercadoria de terceiros): TES com CST 1=0 + CST 2=00 + PIS/COFINS não-cumulativo
CFOP 1102 (compra pra comercialização): entrada com crédito ICMS, registro em livro
CFOP 6108 (venda ao consumidor final): TES com cálculo de diferencial de alíquota (EC 87/2015)
CFOP 5910 (remessa pra industrialização): TES com atualiza estoque = SIM mas gera duplicata = NÃO
CFOP 1922 (compra de imobilizado): TES com CIAP habilitado, sem duplicata

Os 30% que precisam de revisão humana caem em categorias previsíveis:

Importação direta (CFOP 3xxx) — depende de DI, regime aduaneiro, drawback
Substituição tributária com MVA específico — cada produto tem regra
Zona Franca de Manaus (CFOP 6109/6110/6111) — isenção própria
Drawback suspensão (CFOP 7949) — regime aduaneiro especial
PIS/COFINS monofásico (combustíveis, autopeças, medicamentos) — requer conhecimento do segmento

Pra esses o agente marca confidence: 0.4 e sinaliza claramente "revisão obrigatória" no card.

Reforma Tributária 2026 já vem embutido

Isso é o que separa o sugTES de qualquer script tradicional de cadastro em massa: cada TES é gerada considerando os cadastros F2A-CJG que a LC 214/2025 exige.

Se o cliente tem o F2A (alíquotas CBS/IBS) já cadastrado, o sugTES vincula automaticamente a TES ao F2A correto por NCM. Se tem F2B (cesta básica), aplica alíquota reduzida quando cabível. Se tem F2E (operações especiais), vincula ZFM, MEI e Simples. Se tem F2H (Imposto Seletivo), aplica IS pra fumo/álcool/veículos.

E o CJE (configurador por item) é preenchido junto — o SF4 e o CJE saem alinhados, sem risco de divergência em janeiro de 2026 quando o ano-teste começa a valer.

Se você quiser entender a fundo a mecânica da RT 2026 no Protheus, esse post cobre: Reforma Tributária 2026 no TOTVS Protheus.

Envio ao Protheus via U_BEEITSYNC

Quando você aprova as TES na tela de revisão, o motor de integração entra em ação. Cada TES vira uma chamada REST pra User Function homologada U_BEEITSYNC rodando no Protheus do cliente. O motor cuida de:

Autenticação — Basic Auth com senha vinda do Vault Supabase (nunca em texto puro)
Envio batch — múltiplas TES no mesmo request, com transação
Validação SX3 — U_BEEITSYNC checa campo obrigatório e retorna 422 se faltar
Retry exponencial — 3 tentativas com backoff em caso de timeout
Circuit breaker — se 3 chamadas seguidas falharem, para de tentar e abre incidente
Idempotency-Key — envio duplicado não gera TES duplicada
Detector de "ok-fake" — se o Protheus retornar sucesso mas o RECNO for o mesmo do envio anterior, o motor identifica e sinaliza que a TES não gravou de verdade

O resultado final você acompanha na tela Painel de Integração: quantas TES foram enviadas, quantas gravaram, quantas deram erro (com o motivo), e o RECNO real de cada uma no Protheus.

Auditoria completa em audit_log

Toda ação do sugTES fica em audit_log:

Quem gerou a sugestão (actor_user_id)
Qual CFOP e qual CNPJ do cliente (tenant_id)
Payload da sugestão original da IA (payload_before)
Payload após revisão humana (payload_after)
Timestamp e IP

Retenção de 5 anos, atendendo LGPD Art. 16. Cliente enterprise consegue ver a trilha completa na tela Auditoria interna.

Um caso real

Cliente do segmento de distribuição, 65 TES pra cadastrar, regime Lucro Real, sem ZFM, sem drawback. Fluxo real:

Import do SPED (3 meses): 10 s (parser interno)
Geração de sugestões pela IA: ~45 s (Claude Sonnet 4.6)
46 TES com confidence ≥ 0.7 aprovadas em batch: 2 min de revisão superficial
19 TES com confidence < 0.7 revisadas uma a uma: 1 h 30 min
Envio ao Protheus via U_BEEITSYNC: ~3 min (30 s por batch de 10)
Validação em ambiente de homologação SEFAZ com notas de teste: 6 h

Total: ~8 horas de consultor sênior, contra 215 horas no modo manual clássico. Redução de 96% nas horas de digitação/decisão, com todas as decisões rastreáveis.