- Início
- Integrações
- Protheus e e-commerce
Protheus conectado ao e-commerce, com NF-e.
TOTVS Protheus integrado a VTEX, Shopify Plus, Salesforce Commerce e Magento: catálogo, estoque, preço, pedido B2C e B2B e nota fiscal, com compliance fiscal brasileiro e observabilidade de ponta a ponta.
O Protheus tem décadas de maturidade fiscal, financeira e logística no Brasil. Bem integrado, ele vira o motor confiável da operação digital, sem precisar ser substituído.
Plataformas que conectamos ao Protheus
Os mesmos fluxos de catálogo, estoque, preço, pedido e NF-e, adaptados às APIs de cada ponta, para marketplaces, D2C e B2B sobre o mesmo ERP.
Por que a CCX nessa frente
Integrações sob medida, em escopo enxuto, com middleware leve, custo previsível e responsabilidade clara.
Foco na camada de integração
APIs, middleware, mapeamento de campos e orquestração. O ADVPL fica com o time Protheus do cliente ou o parceiro TOTVS, com escopo claro entre as partes.
Dicionário de dados vivo
Todo projeto começa com um workshop de mapeamento das tabelas SA1, SB1, SC5 e SD1 e dos campos fiscais, como CFOP, NCM e CEST, para evitar surpresas na homologação.
Caminho incremental
APIs diretas quando o volume é modesto; middleware com filas quando entram marketplaces e filiais, sem obrigar a licenciar um hub corporativo de integração.
Lado a lado com o seu time
Squads que trabalham junto com o time Protheus do cliente, sem mexer no ERP e sem exigir troca de sistema.
Três camadas, com o Protheus protegido dos picos
As APIs do Protheus de um lado, as da plataforma do outro e, no meio, um middleware com filas, retries idempotentes e DLQ que absorve picos e falhas transitórias.
- TOTVS ProtheusCloud ou on-premise
- APIs RESTFWREST, ADVPL e TLPP
- NF-e na SEFAZXML e DANFE autorizados
- MiddlewareAWS ou GCP, filas e DLQ
- Filas na nuvemAWS SQS ou Google Pub/Sub
- APIs e webhooksDo lado do commerce
- VTEXVTEX IO e Classic
- Shopify PlusPedido e fulfillment
- SalesforceCommerce Cloud B2B e B2C
- Cliente finalStatus, NF-e e DANFE
Arquitetura de referência para volume e resiliência. Em operações de baixo volume, as APIs REST do Protheus conversam direto com a plataforma, sem middleware.
APIs diretas, middleware ou ETL: quando usar cada um
Os três caminhos levam os dados do Protheus ao e-commerce. Muda o volume, o número de canais e a necessidade de tempo real.
| Caminho | Faz sentido quando | Atenção |
|---|---|---|
| APIs REST diretas (FWREST e webhooks) | A operação tem baixo volume, até cerca de 500 pedidos por dia, e uma plataforma de commerce. | Sem camada intermediária, o Protheus recebe os picos de tráfego diretamente. |
| Middleware dedicado (AWS ou GCP) | O volume cresce, entram marketplaces e várias filiais, ou há mais de uma plataforma. | Exige filas, retries idempotentes, DLQ e observabilidade desenhados desde o primeiro release. |
| ETL e batch | Catálogos volumosos ou dados analíticos que seguem para data lake ou warehouse, sem estressar o ERP. | Roda em janela diária ou horária; pedido e estoque em tempo real ficam nas APIs ou no middleware. |
Seis fluxos que colocamos em produção
Onde a integração entre Protheus e e-commerce costuma quebrar, e como desenhamos cada um.
Catálogo e SKUs
Produtos, variações, medidas, pesos, hierarquia e atributos saem do Protheus e chegam ao e-commerce, com versionamento e rollback por lote.
Preço e tabelas
Tabelas de preço, listas, negociação B2B, promoções e descontos calculados no Protheus e publicados por canal e segmento.
Estoque e disponibilidade
Estoque por filial e centro de distribuição, com reserva em tempo real, integração ao WMS e divisão de pedidos com várias origens.
Pedido B2C e B2B
O pedido do e-commerce entra no Protheus, orquestra crédito, reserva de estoque e frete, e devolve o status até a entrega final.
NF-e e financeiro
Emissão de NF-e via SEFAZ, DANFE anexado ao pedido, registro contábil e sincronização com o contas a receber do Protheus.
Cadastros
Clientes PF e PJ com CPF ou CNPJ, endereços, contatos, lista de preço vinculada e condição de pagamento, com sincronização nos dois sentidos quando necessário.
Do pedido à entrega, com rigor fiscal brasileiro
No Brasil o pedido tem mais etapas que em outros mercados. Orquestramos todas com correlation id: falha vira tarefa na esteira operacional, não pedido travado em silêncio.
- Crédito, reserva de estoque e cálculo fiscal feitos no Protheus.
- NF-e emitida, cancelada, corrigida e consultada na SEFAZ dentro do ciclo do pedido.
- ICMS, ICMS-ST e DIFAL por estado de origem e destino, com o Simples Nacional considerado.
- MDF-e e CT-e no fluxo quando a operação tem logística própria.
- Nota emitida, pedido faturado, objeto postado e entrega concluída atualizam o pedido na loja.
- Correlation id para rastrear cada passo no Protheus, no middleware e no e-commerce.
Perguntas frequentes
O Protheus tem APIs REST prontas para integração?
Sim. Desde a versão 12, o Protheus expõe APIs REST nativas via FWREST e ADVPL. Os módulos SIGAFAT, SIGAFIS, SIGACOM e outros têm endpoints padrão para catálogo, pedido, estoque, preço e financeiro, além de permitir endpoints customizados em ADVPL ou TLPP.
É possível integrar Protheus com VTEX?
Sim, é um dos cenários mais comuns no mercado médio brasileiro. A CCX integra Protheus com VTEX cobrindo catálogo, estoque, preço, pedido B2C e B2B, emissão de NF-e e atualização de status, com as APIs REST do Protheus combinadas às APIs e webhooks da VTEX.
Preciso de middleware para integrar Protheus?
Depende do volume e da complexidade. Em operações menores, a integração direta entre APIs funciona. Em volumes maiores ou com várias plataformas, como Protheus, VTEX e marketplaces, recomendamos middleware com filas e observabilidade, em AWS, GCP ou on-premise.
Como é feito o fluxo de NF-e?
O pedido entra no e-commerce e é enviado ao Protheus, que reserva estoque, calcula impostos e emite a NF-e via SEFAZ. O XML e o DANFE voltam ao e-commerce, são anexados ao pedido e enviados ao cliente por e-mail ou WhatsApp. Os status fiscais (autorizada, cancelada, rejeitada) ficam sincronizados.
Quanto tempo leva um projeto de integração Protheus e e-commerce?
Para o escopo core, com catálogo, estoque, preço, pedido e NF-e, os projetos ficam tipicamente entre 2 e 4 meses. Escopos ampliados, com B2B, várias filiais, marketplaces conectados e regras fiscais complexas, podem chegar a 6 meses.
A CCX customiza o Protheus?
Não somos especialistas em ADVPL ou TLPP puro, mas trabalhamos junto com o time Protheus do cliente ou com o parceiro TOTVS. Nosso foco é a camada de integração: APIs, middleware, mapeamento de campos, orquestração de pedido e resiliência. Assim o escopo de cada parte fica claro.
Protheus Cloud ou on-premise faz diferença para integração?
Pouca. O Protheus Cloud expõe as mesmas APIs REST via TOTVS Fluig e TLPP Web. Em on-premise, é preciso cuidar do acesso de rede, com VPN, tunelamento ou exposição segura. Os padrões de integração de pedido, estoque e preço são idênticos.
Quais plataformas de e-commerce vocês conectam com Protheus?
VTEX (IO e Classic), Shopify Plus, Salesforce Commerce Cloud, Magento 2, Wake e plataformas próprias com APIs. Para marketplaces, conectamos via hub central, como Olist ou Anymarket, ou diretamente com Mercado Livre, Amazon e Magalu.
Integre o Protheus ao seu e-commerce.
Trinta minutos com um engenheiro da CCX, sem custo, para mapear APIs, fluxos, regras fiscais e próximos passos entre o Protheus e a sua plataforma.