Protheus, ADVPL, fiscal.
Tudo definido por quem implementa.

TOTVS S.A. é a maior empresa brasileira de software empresarial e dona do ERP Protheus, líder no mercado de gestão corporativa no Brasil.

TOTVS é uma multinacional brasileira fundada em 1983, listada na B3 (TOTS3) e líder em ERP no Brasil. Sua principal plataforma é o Protheus, suíte modular que cobre desde manufatura e logística até fiscal e financeiro, com forte verticalização por setor (varejo, agro, saúde, jurídico, construção, serviços). O Protheus é a fundação técnica sobre a qual praticamente todos os engajamentos da HSB são construídos.

Protheus é o ERP corporativo da TOTVS, escrito em ADVPL/TLPP, com arquitetura cliente-servidor multi-empresa e multi-filial. A versão atual relevante é a 12.1.2410+.

TOTVS Protheus é um ERP modular escrito majoritariamente em ADVPL (e cada vez mais TLPP) sobre um runtime proprietário composto pelo AppServer, TopConnect (banco) e SmartClient (cliente). Cobre módulos como SIGAFIN (financeiro), SIGAFAT (faturamento), SIGAFIS (fiscal), SIGAEST (estoque), SIGACOM (compras), SIGAGCT (contábil), SIGAATF (ativo fixo), SIGAGPE (folha), SIGAHCM (RH), SIGATEL (telecom), entre outros. A versão atual de referência em projetos enterprise é a release 12.1.2410, com upgrades trimestrais.

ADVPL (Advanced Protheus Language) é a linguagem proprietária da TOTVS, derivada de Clipper/xBase, na qual a maior parte do Protheus é escrito.

ADVPL é uma linguagem procedural com extensões orientadas a objeto, criada pela TOTVS especificamente pro Protheus. Herda sintaxe de Clipper e Harbour (família xBase) e roda exclusivamente sobre o AppServer da TOTVS. Customizações de cliente são feitas em ADVPL via Pontos de Entrada (PEs), User Functions e Triggers. Apesar de ainda dominante em customizações legadas, a TOTVS direciona código novo gradualmente pra TLPP (sucessora).

TLPP (TOTVS Language Plus Plus) é a evolução do ADVPL com tipagem mais forte, suporte nativo a REST e desenho moderno. Coexiste com ADVPL na mesma codebase.

TLPP foi introduzida pela TOTVS pra modernizar a stack do Protheus. Permite escrever APIs REST nativas, manipulação JSON mais limpa e estruturas de classe mais alinhadas a linguagens contemporâneas. Coexiste com ADVPL no mesmo .prw e compila pro mesmo RPO. O caminho recomendado pra customização nova é TLPP, com legado ADVPL refatorado gradualmente.

AppServer é o servidor de aplicação proprietário da TOTVS que executa o RPO compilado e atende as conexões do SmartClient/REST.

AppServer é o processo central do Protheus em produção. Lê o RPO compilado, gerencia conexões de SmartClient e jobs assíncronos, mantém pool de threads e cache de funções compiladas. Configurações críticas vivem no appserver.ini: pools de conexão, parâmetros de licença, rotas de REST, jobs agendados. Em ambientes enterprise, é comum particionar serviços (faturamento, fiscal, estoque) em AppServers dedicados pra isolar carga.

RPO (Repository) é o arquivo compilado do Protheus, contendo todo o código ADVPL/TLPP da aplicação e das customizações.

RPO é o binário compilado que o AppServer carrega na inicialização. Cada release da TOTVS gera um RPO base, e customizações são compiladas e mescladas em camadas (RPO custom, projetos, hot-fix). A organização em camadas é crítica em ambientes maduros: misturar customização com RPO base é causa frequente de incompatibilidade em upgrades. Regerar RPO em produção (não copiar de dev) é prática recomendada pra evitar dessincronia de cache.

TopConnect é a camada de acesso a banco do Protheus, que abstrai SGBDs (Oracle, SQL Server, PostgreSQL) e gerencia pool de conexões.

TopConnect intermediava queries do AppServer pro SGBD subjacente. Suporta Oracle, SQL Server, PostgreSQL e DB2. Configurações de NumServers, MaxConnections e timeouts vivem no top_server.ini e impactam diretamente a capacidade do ambiente. Em release 12.1.2410, a TOTVS ainda mantém suporte ao TopConnect legado mas introduz alternativas via DBaccess. Tuning de TopConnect é tipicamente o primeiro ganho de performance em ambientes que escalam usuários.

Parâmetros MV_* são variáveis de configuração do Protheus que controlam comportamento de módulos, cálculos, integrações e jobs.

Os parâmetros MV_* (lidos na tabela SX6) são o principal mecanismo de configuração do Protheus. Cobrem desde alíquotas fiscais padrão (MV_ALIQICM) até comportamento de bloqueio transacional (MV_BLOQUEI), limites de jobs simultâneos (MV_MAXJOB), conexões TopConnect (MV_TOPATIM) e centenas de outros. Auditar parâmetros default em ambientes herdados frequentemente revela ganhos de performance e estabilidade não-óbvios.

NF-e (Nota Fiscal Eletrônica) é o documento fiscal eletrônico de venda de mercadoria, regulamentado pelo ajuste SINIEF 07/2005, transmitido via webservice à SEFAZ.

Modelo 55 da NF-e é o documento de saída de mercadoria mais comum no Brasil. Emitida via XML assinado digitalmente, transmitido à SEFAZ, autorizado e retornado com chave de acesso de 44 dígitos. No Protheus, é gerada pelo módulo de Faturamento (SIGAFAT) com integração ao TSS ou a serviço similar. Variações: NFC-e (consumidor final, modelo 65), NFS-e (serviços, municipal), NFCom (comunicação, modelo 62, obrigatória desde nov/2025).

NFCom (Nota Fiscal de Serviços de Comunicação, modelo 62) é o documento eletrônico que substitui os modelos 21 e 22, obrigatório desde novembro de 2025.

NFCom foi desenhada do zero pro setor de telecomunicações, diferente da adaptação representada pelos modelos 21/22. Prevê faturamento por ciclo, ajustes via documento próprio (modelo 63), agrupamento por assinante e detalhamento por item de plano. No Protheus, exige atualização para release 12.1.2410+ com pacote NFCom aplicado e reconfiguração do SIGATEL. Veja análise detalhada em /insights/nfcom-modelo-21-22.

SPED (Sistema Público de Escrituração Digital) é a iniciativa federal que digitalizou obrigações acessórias: SPED Fiscal (EFD-ICMS/IPI), Contribuições (EFD-Contribuições), Contábil (ECD) e mais.

SPED é o guarda-chuva da escrituração digital brasileira, instituído pelo Decreto 6.022/2007. As principais entregas no contexto Protheus são EFD-ICMS/IPI (mensal, estadual), EFD-Contribuições (mensal, federal PIS/COFINS), ECD (anual, contábil), ECF (anual, fiscal federal) e EFD-Reinf (recente, retenções federais). Geração no Protheus se concentra no SIGAFIS e SIGAGCT, com auditoria via SF3.

EFD-Reinf é a obrigação acessória que centraliza retenções federais (IR, CSLL, PIS, COFINS, Previdência) substituindo gradualmente a DIRF e parte da DCTF.

EFD-Reinf entrou em produção em fases desde 2018 e foi expandida em 2023-2024. No Protheus, exige customização pra mapear eventos R-1000 (cadastro), R-2010 a R-2099 (retenções e contribuições) e R-4000+ (retenções na fonte). Erros frequentes em projetos: mapeamento incorreto de natureza de rendimento, falta de validação de NIT/CNPJ, e geração de eventos duplicados ao reprocessar competências.

Reforma Tributária aprovada pela EC 132/2023 e regulamentada pela LC 214/2025 institui IBS e CBS, extinguindo gradualmente ICMS, ISS, PIS e COFINS entre 2026 e 2033.

A Reforma Tributária brasileira é a maior mudança fiscal em 40 anos. IBS (Imposto sobre Bens e Serviços, gestão estadual+municipal) e CBS (Contribuição sobre Bens e Serviços, federal) substituem progressivamente ICMS, ISS, PIS e COFINS. Cronograma: jan/2026 testes obrigatórios em produção com alíquotas zero, jan/2027 cobrança gradual, jan/2033 extinção dos tributos antigos. Impacto no Protheus é estrutural — toca SF1, SF2, SF3, SB1 e MaFisLeg. Análise completa em /insights/reforma-tributaria-protheus.

DCTFWeb é a declaração consolidada de débitos federais, gerada automaticamente a partir da EFD-Reinf e e-Social, substituindo a DCTF tradicional.

DCTFWeb é gerada online no portal da Receita Federal a partir dos eventos EFD-Reinf e e-Social transmitidos pelo contribuinte. Pra empresas com Protheus, isso significa que a qualidade do dado fiscal precisa estar em ordem na origem — erros aparecem tardiamente na DCTFWeb. A transição da DCTF tradicional pra DCTFWeb foi concluída em 2024 pra a maioria dos contribuintes.

Migração de versão Protheus exige upgrade do RPO base, validação de customizações, reconfiguração de TopConnect e estratégia de rollback. Pode ser feita sem janela de manutenção com canary release.

Migrar Protheus 11 pra 12 (ou pra release 12.1.2410+ mais recente) é projeto técnico complexo em ambiente enterprise. Vimos casos de migração com 47 lojas 24×7 e zero janela de manutenção (case Carajás). A estratégia canary — migrar gradualmente lote de filiais com rollback automatizado — é a abordagem padrão da HSB. Tempo típico: 6-12 semanas dependendo do volume de customização.

Squad embedded é o modelo de engajamento HSB onde 2 sócios + engenheiros sênior trabalham junto com a TI do cliente por 6+ meses, com decisão técnica diária.

Engajamento embedded substitui o modelo tradicional de consultoria com PowerPoints e SOWs de produto entregue. Time HSB integra com TI do cliente, com sócios fazendo code review diário e participando das cerimônias de produto. Recomendado pra projetos críticos de migração, refactoring profundo ou desligamento de middleware legado.

Pontos de Entrada (User Functions com nomes pré-definidos pela TOTVS) são o mecanismo oficial de customização do Protheus sem alterar código padrão.

PEs são funções com assinatura conhecida (ex: M410GRV, A100Cli) que a TOTVS chama em momentos específicos do fluxo. Implementadas pelo cliente em RPO custom, permitem alterar comportamento sem tocar no RPO base. Boa prática: nomear PEs com prefixo do cliente (ex: ABC_M410GRV), isolar lógica em libraries reutilizáveis, e nunca fazer DB write fora de transação dentro de PE de alta frequência.

HyperSync é a plataforma low-code de integração da HSB que roda dentro do Protheus do cliente. Endpoints declarativos, webhooks, multi-empresa, audit trail. Pricing self-serve.

HyperSync é o produto mais maduro da HSB, em produção em 8 grupos enterprise. Substitui middleware de integração externo (broker, ESB) por uma camada nativa Protheus. Endpoints REST e webhooks são definidos por YAML/JSON, compilados pra ADVPL otimizado pelo próprio HyperSync. Audit trail por requisição, multi-empresa, retry com idempotência. Pricing self-serve a partir de Hobby (grátis), Pro mensal/anual, Enterprise sob proposta. Site: https://hypersync.com.br.