Integração com Protheus: tudo o que gestores de TI precisam saber

O Protheus é o ERP mais presente nas médias empresas brasileiras. Desenvolvido pela TOTVS e com décadas de implantações no mercado nacional, ele roda a operação de empresas de varejo, manufatura, distribuição e serviços de norte a sul do país. E é exatamente essa presença que torna a integração com Protheus um tema recorrente — e muitas vezes desafiador.

Quem trabalha com projetos de integração no Brasil cedo ou tarde se depara com uma empresa que precisa conectar o Protheus a um e-commerce, marketplace, plataforma logística ou sistema externo. Este artigo é um guia direto para gestores de TI que precisam entender as opções de integração com Protheus, as diferenças entre cada abordagem e como evitar os erros mais comuns.

As particularidades do Protheus que impactam a integração

Antes de falar sobre as formas de integração, é importante entender algumas características do Protheus que diferenciam projetos de integração com ele de projetos com outros ERPs.

Customizações intensas: O Protheus é altamente customizável via ADVPL (linguagem proprietária da TOTVS). Muitas empresas têm anos de customizações acumuladas que modificam o comportamento padrão dos processos. Uma integração que funciona perfeitamente em um Protheus "padrão" pode exigir ajustes significativos em um ambiente fortemente customizado.

Versões heterogêneas: O Protheus tem várias versões em uso no mercado (P12, versões anteriores). A capacidade de integração — especialmente via APIs modernas — varia significativamente entre versões.

REST API relativamente recente: A TOTVS implementou suporte a REST API no Protheus de forma mais robusta a partir das versões mais recentes (P12 em diante). Empresas com versões mais antigas dependem de abordagens legadas.

Modelo de banco de dados proprietário: O Protheus usa um modelo de banco de dados com características específicas (campos fixos, estrutura de tabelas particular) que exige conhecimento especializado para acesso direto.

As 4 formas de integrar com Protheus

REST API (versões recentes do P12)
A TOTVS expandiu o suporte a APIs REST no Protheus, permitindo que sistemas externos consumam e publiquem dados via endpoints HTTP padrão. É a forma mais moderna e recomendada para novas integrações em ambientes com Protheus atualizado. Vantagens: padrão moderno fácil de consumir por qualquer plataforma iPaaS, independência de protocolo proprietário, facilidade de manutenção. Limitações: cobertura funcional ainda crescendo, requer versão atualizada do Protheus, customizações do cliente podem não estar expostas via API padrão. Quando usar: novas integrações em ambientes com P12 atualizado, especialmente quando os processos necessários têm endpoints REST disponíveis.
SOAP / Web Services
O Protheus suporta integração via Web Services SOAP, que é o protocolo legado de integração da TOTVS. É mais maduro que o REST e tem maior cobertura de processos de negócio disponíveis. Vantagens: maior cobertura de processos, maduro e estável em versões mais antigas, amplamente suportado por plataformas de integração. Limitações: protocolo mais verboso que REST, menos intuitivo para desenvolvedores modernos, estrutura de mensagens SOAP pode ser complexa de mapear. Quando usar: integrações em ambientes com versões mais antigas do Protheus, ou quando os processos necessários não têm endpoints REST disponíveis.
Acesso direto ao banco de dados
Em alguns cenários — especialmente com versões antigas do Protheus ou para integrações de leitura de dados —, o acesso direto ao banco de dados é uma opção. Vantagens: acesso a qualquer dado incluindo customizações, performance elevada para consultas de leitura em massa, funciona independente de versão. Limitações: altamente invasivo, bypassa a camada de negócio do Protheus, risco de inconsistência para escrita, alta dependência da estrutura interna de tabelas. Quando usar: apenas para leitura em cenários específicos onde não há alternativa via API ou Web Service. Nunca para escrita de dados.
Arquivo flat (TXT, CSV, XML)
O Protheus suporta importação e exportação de dados via arquivos em formatos como TXT (layout fixo), CSV e XML. É a abordagem mais legada, mas ainda presente em muitos ambientes. Vantagens: funciona em qualquer versão do Protheus, simples de implementar para processos batch, independente de conectividade de rede. Limitações: não é em tempo real, gestão de arquivos adiciona complexidade operacional, tratamento de erros é manual. Quando usar:

Processos de negócio mais integrados com Protheus

Nos projetos de integração Protheus que a Snowlink implementa, estes são os processos mais frequentes: Gestão de pedidos (recebimento de pedidos de e-commerce → criação de pedido de venda no Protheus, atualização de status); Estoque (sincronização de saldo do Protheus para e-commerce e marketplaces em tempo real); Produtos e preços (sincronização de cadastro de produtos e atualização de tabelas comerciais); Faturamento (geração automática de NF-e no Protheus após confirmação de pagamento); e Financeiro (conciliação de pagamentos recebidos em marketplaces com o contas a receber do Protheus, baixa automática de títulos).

Erros comuns em projetos de integração Protheus

Não mapear as customizações antes de começar: Se o cliente tem campos customizados obrigatórios no Protheus, a integração precisa conhecê-los. Começar o projeto sem esse mapeamento garante retrabalho.
2. Usar acesso direto ao banco para escrita: Escrever dados diretamente nas tabelas do Protheus bypassa toda a lógica de negócio do ERP — validações, triggers, atualizações de índices. O resultado são dados inconsistentes que geram problemas difíceis de diagnosticar.
3. Não tratar o retry de mensagens: O Protheus às vezes rejeita mensagens por indisponibilidade temporária ou dados inválidos. Sem mecanismo de retry, essas mensagens são perdidas silenciosamente.
4. Subestimar o impacto das customizações na manutenção: Uma atualização de versão do Protheus pode quebrar customizações que a integração depende. Planeje um processo de validação da integração sempre que o Protheus for atualizado.
5. Não definir o responsável pelo conector após o go-live: A pergunta "quem chamo quando a integração Protheus quebrar?" precisa ter resposta antes do go-live, não depois.

Próximos passos

A Snowlink tem conector nativo para Protheus P12, com suporte aos principais processos de negócio de varejo, distribuição e manufatura. Nossos especialistas conhecem as particularidades do Protheus no mercado brasileiro e já implementaram integrações em ambientes com customizações complexas. Se você precisa integrar o Protheus ao seu ecossistema de sistemas, fale com nosso time.