TOTVS Protheus + E-commerce

Protheus conectado ao ecommerce — em tempo real, com NF-e

O Brasil médio roda em Protheus. A CCX Company integra Protheus com VTEX, Shopify, Salesforce Commerce e Magento cobrindo catálogo, estoque, preço, pedido B2C/B2B e emissão de nota fiscal — tudo com compliance fiscal brasileiro e observabilidade de ponta a ponta.

  • APIs REST nativas do Protheus (FWREST, ADVPL/TLPP)
  • VTEX, Shopify, Salesforce Commerce e Magento
  • Catálogo, estoque, preço, pedido, NF-e em tempo real
  • Middleware em AWS/GCP com filas e retries
  • Compliance fiscal BR: NF-e, ICMS ST, Simples Nacional
  • Squads que trabalham lado a lado com time Protheus do cliente

Protheus 12+

Cloud ou on-prem

4-6

Meses projeto típico

99.9%

SLA integração

NF-e

End-to-end

Por que integrar Protheus

Protheus no core, ecommerce na ponta

O Protheus tem décadas de maturidade em operação fiscal, financeira e logística no Brasil. Bem integrado, ele vira motor confiável da operação digital sem precisar ser substituído.

Protheus é o ERP mais usado no mid-market brasileiro
Já carrega regras fiscais, contábeis e operacionais do negócio
Substituir por SAP ou Oracle é custoso e raramente justificado
Ecommerce bem integrado transforma Protheus em motor de vendas online
Reduz retrabalho manual, divergências e atrasos em NF-e
Viabiliza marketplaces, D2C e B2B sobre o mesmo ERP
Arquitetura

Três formas de conectar Protheus ao ecommerce

Baixo volume

APIs REST diretas

Ecommerce chama APIs do Protheus (FWREST) e vice-versa via webhooks. Integração direta, sem camada intermediária. Simples e rápido para operações até ~500 pedidos/dia.

Volume + resiliência

Middleware dedicado

Camada em AWS/GCP com filas (SQS, Pub/Sub), retries idempotentes, DLQ e observabilidade. Isola o Protheus dos picos de tráfego e absorve falhas transitórias.

Alto volume dados

ETL + Batch

Para catálogos volumosos ou dados analíticos. ETL diário/horário para data lake ou warehouse, sincronizando mestre e relatórios sem estressar o ERP.

Fluxos cobertos

Seis fluxos essenciais em produção

Catálogo & SKUs

Produtos, variações, medidas, pesos, hierarquia e atributos saem do Protheus e chegam ao ecommerce, com versionamento e rollback por lote.

Preço & Tabelas

Tabelas de preço, listas, negociação B2B, promoções e descontos calculados no Protheus e publicados por canal e segmento.

Estoque & Disponibilidade

Estoque por filial, centro de distribuição e reserva em tempo real. Integrações com WMS e split-order para pedidos multi-origem.

Pedido B2C e B2B

Pedido do ecommerce entra no Protheus, orquestra crédito, estoque reservado, frete e retorna status até a entrega final.

NF-e & Financeiro

Emissão de NF-e via SEFAZ, DANFE anexado ao pedido, registro contábil e sincronização com contas a receber no financeiro Protheus.

Cadastros

Clientes PF/PJ com CPF/CNPJ, endereços, contatos, lista de preço vinculada e condição de pagamento. Two-way sync quando necessário.

Plataformas suportadas

Integramos Protheus com as principais plataformas BR

VTEX
Shopify Plus
Salesforce Commerce
Magento 2
Compliance fiscal BR

Integração com rigor fiscal brasileiro

NF-e & DANFE

Emissão, cancelamento, carta de correção e consulta de situação via SEFAZ integrados ao ciclo de pedido.

ICMS & ICMS-ST

Cálculo de ICMS, substituição tributária e DIFAL conforme estado de origem e destino, direto no Protheus.

Simples Nacional

Regime tributário do cliente considerado no cálculo de impostos e na geração do documento fiscal.

MDF-e & CT-e

Em operações com logística própria, documentos fiscais complementares também entram no fluxo.

Análise profunda

Arquitetura de integração para o mercado médio

Operações mid-market brasileiras têm particularidades: ERP Protheus no core, operação fiscal complexa, equipes de TI enxutas e orçamento sensível a custo de licença. A CCX Company desenha integrações que respeitam essa realidade. Quando o volume é modesto, usamos APIs REST do Protheus diretamente contra a plataforma de commerce, com webhooks para eventos. Quando o volume cresce, ou a operação ganha marketplaces e múltiplas filiais, introduzimos um middleware com filas e observabilidade, sem obrigar o cliente a licenciar um hub caro como MuleSoft ou CPI. O caminho é incremental, cabível no bolso e escalável.

Mapeamento de campos e dicionário de dados

Metade do sucesso de uma integração Protheus está no mapeamento de campos. Cada tabela (SA1, SB1, SC5, SD1) tem dezenas de colunas, muitas personalizadas. Campos fiscais (CFOP, NCM, CEST, origem) precisam viajar corretos para o ecommerce e vice-versa. Atributos de produto (cor, tamanho, voltagem) muitas vezes estão em campos livres que precisam ser normalizados. A CCX começa todo projeto com um workshop de data mapping junto com o time Protheus do cliente ou parceiro TOTVS, produzindo um dicionário vivo que guia a implementação e evita surpresas em homologação.

Orquestração pedido → NF-e → entrega

O fluxo de pedido em operação BR tem mais passos que em outros mercados: crédito, reserva de estoque, cálculo fiscal, emissão de NF-e, autorização SEFAZ, separação, expedição, CT-e em alguns casos e atualização do consumidor. A CCX orquestra isso com correlation ids que permitem rastrear cada passo no Protheus, no ecommerce e no middleware. Cada evento relevante (autorização, nota emitida, pedido faturado, objeto postado, entrega concluída) atualiza o pedido no ecommerce e dispara notificações ao cliente. Falhas viram tasks na esteira operacional, não pedidos travados em silêncio.

Mercado médio: SAP é caro, planilha não escala

Muita empresa mid-market fica presa em um limbo: o Protheus está bom no core, mas o ecommerce cresce e as integrações manuais não acompanham. Migrar para SAP é caro e longo, exportar CSV não escala, e os connectors genéricos de mercado entregam só 60% do necessário. A CCX entrega uma terceira via: integrações customizadas, mas em escopo enxuto, com middleware leve, custo previsível e ownership claro. Muitas operações saem de 2-3 dias de atraso em pedido/NF para near real-time em 4 meses, sem mexer no ERP e sem licenciar nada novo de peso.

FAQ

Perguntas frequentes

O Protheus tem APIs REST prontas para integração?

Sim. Desde a versão 12, Protheus expõe APIs REST nativas via FWREST e ADVPL. Os módulos SIGAFAT, SIGAFIS, SIGACOM e outros possuem endpoints padrão para catálogo, pedido, estoque, preço e financeiro — além de permitir endpoints customizados em ADVPL/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. Usamos APIs REST do Protheus combinadas com APIs e webhooks da VTEX.

Preciso de middleware para integrar Protheus?

Depende do volume e da complexidade. Em operações menores, integração direta API-to-API funciona. Em volumes maiores ou com múltiplas plataformas (ex: Protheus + VTEX + marketplaces), recomendamos middleware com filas e observabilidade — em AWS, GCP ou on-premise.

Como é feito o fluxo de NF-e?

O pedido entra no ecommerce, é enviado ao Protheus, que reserva estoque, calcula impostos e emite a NF-e via SEFAZ. O XML e DANFE retornam para o ecommerce, são anexados ao pedido do cliente e enviados por email/WhatsApp. Status fiscais (autorizada, cancelada, rejeitada) ficam sincronizados.

Quanto tempo leva um projeto de integração Protheus + ecommerce?

Para o escopo core (catálogo, estoque, preço, pedido, NF-e), projetos ficam tipicamente entre 2 e 4 meses. Escopos ampliados com B2B, múltiplas filiais, marketplaces conectados e regras fiscais complexas podem chegar a 6 meses.

A CCX customiza o Protheus?

Não somos especialistas em ADVPL/TLPP puro, mas trabalhamos junto com o time Protheus do cliente ou parceiro TOTVS. Nosso foco é a camada de integração: APIs, middleware, mapeamento de campos, orquestração de pedido e resiliência. Isso permite dividir escopo claro entre as partes.

Protheus Cloud ou on-premise faz diferença para integração?

Pouca. Protheus Cloud expõe as mesmas APIs REST via TOTVS Fluig/TLPP Web. Em on-premise, é necessário cuidar de acesso de rede (VPN, tunelamento ou exposição segura). Os patterns de integração (pedido, estoque, preço) são idênticos.

Quais plataformas de ecommerce vocês conectam com Protheus?

VTEX (IO e Classic), Shopify Plus, Salesforce Commerce Cloud, Magento 2, Wake e plataformas custom com APIs. Para marketplaces, conectamos via hub central (ex: Olist, Anymarket) ou diretamente com Mercado Livre, Amazon e Magalu.

Vamos conversar

Pronto para integrar Protheus com seu ecommerce?

Em duas sessões mapeamos APIs, fluxos, fiscal e entregamos escopo, cronograma e estimativa realista de esforço.

+55 (11) 2427-6839 • [email protected]

Integração TOTVS Protheus com E-commerce | CCX Company | CCX Company