Introdução ao TOTVS Protheus
Bem-vindo ao guia introdutório sobre o TOTVS Protheus! Se você está chegando agora no ecossistema TOTVS e possui pouca familiaridade com esta ferramenta, esta página foi desenvolvida para você. Vamos desmistificar os principais conceitos, do básico até as ferramentas necessárias para dar os primeiros passos no desenvolvimento.
O que é um ERP?
ERP significa Enterprise Resource Planning (Planejamento de Recursos Empresariais). Trata-se de um sistema de software corporativo integrado utilizado por empresas para gerenciar e automatizar as principais partes de suas operações.
Um ERP centraliza as informações de diversos departamentos de uma empresa — como Financeiro, Recursos Humanos, Compras, Vendas, Estoque e Produção — em um único banco de dados. Isso permite que a informação flua livremente entre as áreas de forma segura, reduzindo erros, evitando retrabalho e fornecendo aos gestores uma visão unificada e precisa do negócio.
O que é o TOTVS Protheus?
O Protheus (historicamente conhecido como Microsiga Protheus) é um robusto sistema ERP desenvolvido e comercializado pela TOTVS.
O grande diferencial do Protheus é ser altamente customizável. Ele foi arquitetado para ser extremamente flexível, permitindo que as empresas adaptem o software às suas regras de negócio e necessidades específicas. O ERP é estruturado em Módulos operacionais (por exemplo: SIGAFAT para Faturamento, SIGAFIN para Financeiro, SIGACOM para Compras, entre muitos outros), e todos esses módulos se integram nativamente para formar o ambiente corporativo da empresa.
Linguagens e Ferramentas de Programação
Devido à sua alta maleabilidade, há todo um ecossistema de desenvolvimento moldado para suportar essas customizações. Para criar tabelas, telas novas, rotinas customizadas ou integrações, você usará as seguintes tecnologias:
1. Linguagens de Programação
- AdvPL (Advanced Protheus Language): É a linguagem de programação nativa clássica do Protheus, projetada pela própria TOTVS (baseada em xBase/Clipper). A imensa maioria do código "padrão" do ERP é construída sob esta base. É uma linguagem orientada a eventos com elementos de orientação a objetos.
- TLPP (TOTVS Language Plus Plus): É a evolução oficial do AdvPL. O TLPP traz recursos de linguagens modernas, como verdadeira orientação a objetos, controle de namespaces, tipagem de dados, suporte melhorado à programação assíncrona e facilidade extrema no desenvolvimento de integrações e APIs REST. É o futuro do desenvolvimento na plataforma da TOTVS.
2. Ferramentas e IDEs
- Visual Studio Code (VS Code): É o editor de código oficial hoje para desenvolver no Protheus. A TOTVS descontinuou as suas IDEs proprietárias antigas que eram baseadas na plataforma Eclipse (como o TOTVS Developer Studio - TDS).
- Extensão TOTVS Developer Studio for VS Code: Para preparar o seu VS Code, é necessário baixar a extensão oficial fornecida pela TOTVS diretamente no Marketplace. Ela provê formatação e cores (syntax highlighting), comandos de compilação, geração de pacote (patch), utilitários para inspetor de tabelas e, mais importante, o depurador de código (debug).
3. Arquitetura Básica
- Application Server (AppServer): É a aplicação de servidor onde ocorre o processamento. É no AppServer que fica armazenado o RPO (Repositório de Objetos - arquivo que guarda o seu código já compilado) e onde o código AdvPL/TLPP é rodado.
- SmartClient: É o cliente desktop clássico. O usuário final inicia o SmartClient no seu computador para se conectar ao AppServer e abrir a interface (as telas) do Protheus.
Como desenvolver: O Fluxo de Trabalho Básico
Para os iniciantes, o processo do dia a dia de como desenvolver uma rotina é mais ou menos assim:
Passo 1: Preparando o Ambiente
Você precisará de um ambiente (normalmente local ou em um servidor de testes) que possua configuração de AppServer atrelado a um Banco de Dados Relacional, e o SmartClient. Além disso, instale o VS Code com a extensão TOTVS Developer Studio.
Passo 2: Cadastrando a Conexão
Na extensão do VS Code, você adicionará um novo servidor apontando para o IP/Servidor e Porta TCP do seu AppServer. O sistema solicitará suas credenciais de ambiente para conectar a IDE ao RPO correspondente.
Passo 3: Escrevendo o Código
Você trabalhará principalmente criando e editando arquivos contendo a extensão preferecialmente .tlpp (códigos TLPP) ou .prw (códigos AdvPL). Uma vez interligado, todo código-fonte novo ou rotina alterada precisará de um processo de tradução técnica para o servidor.
Ponto de Atenção: Pontos de Entrada
Em implantações no cliente, a principal forma de alterar uma funcionalidade sem destruir a base do sistema nativo da TOTVS é através de "User Functions" e "Pontos de Entrada" — gatilhos vazios liberados pela arquitetura para inserirmos lógicas de negócio próprias.
Passo 4: Compilando as Modificações
Diferente da agilidade de frameworks modernos JavaScript/Web, o código feito em AdvPL/TLPP não sobe dinamicamente até seu repositório (RPO). Você necessitará enviar o comando Compilar Arquivo/Pasta no VS Code, que criptografará e hospedará esta rotina internamente no servidor.
Passo 5: Acesso, Teste e Debug
Após o sucesso na compilação, você iniciará uma tela no executável do SmartClient ou usará um programa tipo "Postman", no caso de uma API REST, e acionará a sua função. Utilizando os "Breakpoints" criados a partir do VS Code, você acompanhará a linha exata em depuração para localizar falhas e verificar conteúdos variados em tempo real.
Não se assuste no início! O ecossistema Protheus é muito extenso. Os desafios iniciais geralmente estão em entender o Dicionário de Dados do Sistema (onde configuramos tabelas, índices e gatilhos sem usar SQL) e o conceito arquitetural de como cada Módulo interage um com o outro. Logo você pegará o jeito!