Glossário do Protheus para quem não é da TI

Toda reunião de projeto tem esse momento: a TI diz que o problema está na SD2 e resolve com ponto de entrada, e quem executa o processo sai sem saber com o que concordou. O problema quase nunca é o sistema — é vocabulário. Este glossário traduz as palavras que você ouve sobre o seu próprio trabalho: não é lista para programador, é o dicionário de quem usa o ERP todo dia.

Antes de tudo: “tabela” não é coisa de TI

Quando alguém diz “isso está na SA1”, está dizendo algo simples: é a gaveta onde o sistema guarda essa informação. O Protheus separa cada tipo de dado numa gaveta diferente — cliente numa, fornecedor em outra, produto em outra — com um código de três caracteres que a TI usa como nome próprio, do jeito que você diz “pedido” em vez de “documento de intenção de compra”. Você não precisa decorar: precisa saber que a sigla aponta onde o dado mora, não descreve um problema técnico obscuro.

Uma observação que economiza confusão: em conversa essas siglas aparecem sozinhas (SA1); no banco de dados vêm com números no fim (SA1010, SA1990) — o número diz a qual empresa o conjunto pertence. “SA1010” num e-mail da TI é a mesma SA1.

Padrão que vale guardar: o Protheus separa cabeçalho de itens: SC5/SC6 no pedido de venda, SF1/SD1 na entrada, SF2/SD2 na saída. Exceção: o pedido de compra não tem cabeçalho separado — a SC7 guarda um registro por item, e os dados gerais (fornecedor, condição) se repetem em cada linha. No dicionário de dados, a SC7 tem tanto o campo de item (C7_ITEM) quanto o de fornecedor (C7_FORNECE) na mesma tabela.

Módulo é a área do sistema. O nome sempre começa com SIGA, herança do nome antigo do produto — Sistema Integrado de Gestão Administrativa. Depois vem a abreviação da área.

Os módulos conversam entre si: um pedido faturado no SIGAFAT gera título no SIGAFIN, baixa saldo no SIGAEST e alimenta o SIGAFIS — por isso um erro no financeiro pode ter nascido no faturamento. Ver a mesma informação em módulos diferentes é normal: é o mesmo dado, sob a ótica de cada área.

Os conceitos que realmente travam

Aqui não são siglas de gaveta. São ideias — e é onde a conversa descarrila de verdade.

É a regra de comportamento da operação: o TES de um item diz ao sistema o que aquela movimentação significa — se movimenta estoque, se gera título financeiro, quais impostos calcula, se atualiza custo.

É por isso que o TES é campeão de chamado. Um TES trocado não dá erro na hora — deixa o sistema fazer, em silêncio, a coisa errada: imposto indevido, estoque que não baixa, título que não nasce. “Qual TES você usou?” não é burocracia, é a primeira pergunta certa.

Nas versões atuais existe também o TES Inteligente, que sugere o TES a partir de regras cadastradas, em vez de depender só da digitação.

Alçada de aprovação

É até quanto cada pessoa pode aprovar, e em que ordem — uma hierarquia de quem aprova primeiro, quem aprova depois, e a partir de qual valor sobe um nível.

“O pedido está preso na alçada” significa que espera alguém autorizar, não que houve erro. Existem alçadas por documento, por item e por nível — por isso um pedido às vezes é liberado só em parte.

Parâmetro MV_

Parâmetro é uma chave de configuração. Os nomes quase sempre começam com MV_ (MV_ESTADO, MV_TPSALDO) e guardam uma decisão sobre como a empresa quer que o Protheus se comporte.

“Isso é parâmetro” quer dizer que o comportamento é ajustável sem programar — configuração, não defeito. Também explica por que o sistema se comporta diferente entre empresas com a mesma versão.

O Protheus vem com “ganchos” espalhados dentro das rotinas padrão: lugares onde a empresa encaixa uma regra própria — validar um campo, bloquear uma gravação, preencher algo automaticamente.

“Vou fazer por ponto de entrada” quer dizer que a TI vai acrescentar comportamento sem reescrever a rotina padrão — a rotina original continua sendo da TOTVS e recebe as atualizações dela.

Customização

Tudo que existe no seu Protheus e não veio de fábrica: campo criado, relatório próprio, rotina exclusiva, ponto de entrada, integração.

Se o comportamento é padrão, é documentado pela TOTVS e o suporte oficial atende; se é customização, quem mantém é a TI interna ou a consultoria. “Isso é padrão ou customizado?” é a pergunta que mais economiza tempo em chamado.

RPO

O arquivo onde ficam todos os programas do Protheus — o Repositório de Objetos: as rotinas da TOTVS e as customizações da empresa, num pacote só.

“Atualizar o RPO” ou “aplicar pacote” quer dizer trocar esse conjunto, normalmente numa janela combinada, porque mexe em todo mundo ao mesmo tempo.

Cópia do sistema com uma finalidade — costuma haver pelo menos duas: uma onde a empresa trabalha de verdade, outra onde se testa antes.

Os ambientes têm dados diferentes. Se você testar “no ambiente de teste” e não achar o pedido de ontem, não é defeito — é uma cópia mais antiga, assim de propósito, para não arriscar o dado real.

Release e upgrade

Release é a versão do Protheus, com correções, mudanças legais e recursos novos. Upgrade é o projeto de subir de uma versão para outra.

Upgrade não é só coisa de TI: quem valida se o processo continua funcionando é quem o executa — daí o pedido de “testar seu dia a dia em homologação”.

Dicionário de dados

O cadastro das gavetas: onde o Protheus guarda a definição de quais tabelas existem, quais campos cada uma tem, tamanho e tipo.

Você ouve isso ao pedir um campo novo: criar um campo é registrar no dicionário. Por isso “só aumentar o tamanho do campo” nunca é tão simples — mexe em tudo que usa aquele campo.

Estas quatro são traiçoeiras porque parecem português comum. E são — só que com outro significado.

De brinde: quando a TI diz “não é bug, é comportamento padrão”, não está sendo defensiva — o sistema faz aquilo de propósito, e mudar exige decisão de negócio, não uma correção. Pergunte “qual é o caminho para mudar?”, em vez de reabrir o chamado.

Com esse vocabulário, um chamado fica mais fácil de escrever: onde, o quê, o que aconteceu, em qual ambiente. O modelo pronto para copiar está em Como escrever um chamado de Protheus que não volta.

O que isso muda

Você não precisa aprender Protheus por dentro — precisa de vocabulário suficiente para que sua experiência de processo chegue inteira do outro lado da mesa. Guarde este glossário para consulta rápida.

Quer ver MV_ESTADO e MV_TPSALDO — os dois parâmetros citados acima — no seu ambiente? Peça a quem tem acesso ao banco para rodar:

SELECT X6_FIL, X6_VAR, X6_CONTEUD, X6_DESCRIC
  FROM SX6010
 WHERE X6_VAR IN ('MV_ESTADO', 'MV_TPSALDO')
   AND D_E_L_E_T_ = ' '
 ORDER BY X6_VAR, X6_FIL

Ficou faltando alguma sigla que você ouve e ninguém explica? Escreva para a gente — as mais citadas entram na próxima atualização deste texto.