Integrar Protheus com e-commerce: hub vs API direta — qual escolher

Você vende (ou vai vender) em múltiplos canais — Mercado Livre, Shopee, Amazon, loja própria — e precisa que os pedidos, o estoque e o faturamento se reflitam no Protheus. Dois caminhos existem: integração via plataforma hub (middleware) ou API direta de cada canal. A escolha errada custa caro em manutenção, retrabalho ou limitação de escala.

O cenário de quem vende em múltiplos canais

Cada marketplace tem sua API própria, seu formato de pedido, suas regras de frete e suas especificidades de nota fiscal. Uma API do Mercado Livre não funciona igual à da Shopee. Quando você tem 2 canais, talvez dê para manter duas integrações separadas. Com 4, 5 ou mais, a manutenção vira um pesadelo.

Caminho 1: API direta para cada marketplace

Neste modelo, você (ou sua equipe de TI) desenvolve e mantém um conector entre o Protheus e a API de cada marketplace. O pedido chega na API do canal, é lido pelo conector, processado no Protheus (geração de pedido de venda, baixa de estoque, emissão de NF-e) e o status retorna ao canal.

Vantagens: controle total sobre a lógica de integração; sem custo de plataforma terceira; possibilidade de customização profunda por regra de negócio.

Desvantagens: cada novo canal = novo desenvolvimento; APIs de marketplaces mudam frequentemente (e você precisa acompanhar cada mudança); custo de manutenção cresce linearmente com o número de canais; exige desenvolvedor com experiência simultânea em ADVPL e em REST APIs de terceiros.

Caminho 2: plataforma hub (middleware)

Hubs como Anymarket, Pluggto, Bling, ConnectPlug e similares funcionam como um intermediário que já tem os conectores prontos com os principais marketplaces. Você configura seus produtos, regras de preço e estoque no hub, e o hub se comunica com cada marketplace e com o ERP.

A integração com o Protheus, nesse modelo, é feita uma vez — entre o hub e o ERP. Novos marketplaces são adicionados no hub sem mexer no Protheus.

Vantagens: um único ponto de integração com o Protheus; novos canais adicionados pelo hub sem desenvolvimento customizado; os conectores com marketplaces são mantidos pela plataforma hub; funcionalidades de gestão de catálogo, preços e estoque multi-canal incluídas.

Desvantagens: custo mensal da plataforma (geralmente proporcional ao volume de pedidos); menor controle sobre casos de borda específicos do seu negócio; dependência de um terceiro na cadeia de pedidos.

Comparativo direto

Quando usar cada um

Use API direta se: você tem 1-2 canais e prevê manter assim por muito tempo; tem regras de negócio muito específicas que nenhum hub consegue atender; tem equipe interna de desenvolvimento com experiência em APIs e em ADVPL.

Use hub se: você opera ou pretende operar em 3+ marketplaces; não quer manter equipe dedicada para integração; precisa adicionar novos canais de forma ágil; o custo mensal do hub cabe na margem da operação.

Como o Protheus se conecta em ambos os modelos

Em ambos os casos, a integração com o Protheus acontece via API REST (do Protheus side) ou via leitura/escrita direta no banco de dados — dependendo da complexidade das operações e do nível de customização do ambiente. Para pedidos de e-commerce, os módulos mais envolvidos são Faturamento, Estoque e Fiscal (emissão de NF-e). A integração precisa lidar com: criação de pedido de venda (SC5/SC6), baixa de estoque, geração de NF-e com tributação correta por estado de destino, e atualização de status de pedido no marketplace após faturamento.

Protheus®, TOTVS®, Microsiga® e Fluig® são marcas registradas da TOTVS S.A. A Global ERP é consultoria independente, sem afiliação formal com a fabricante. As orientações deste artigo refletem a interpretação técnica da equipe Global ERP e não substituem orientação contábil-jurídica formal.