Pular para o conteúdo
platform
Quando a Integração Trava Tudo · · 11 min

OroCommerce ou Spryker: como cada um conecta ERP e compras?

Pela lente do CTO: o conector do ERP, o PunchOut com o sistema de compras do cliente e a fatura do pedido, nos dois lados.

Diagrama conceitual comparando a conexão do OroCommerce e da Spryker com sistemas de compras e ERP.

Nota editorial: a CWS Platform concorre com a Oro (OroCommerce) e com a Spryker. Este comparativo usa só a documentação pública de cada fornecedor, com o endereço ao lado de cada fato e a data de cada registro citado.

Resposta curta: o OroCommerce serve a quem quer cotação, listas de preço por cliente e integrações documentadas com ERPs como Epicor Prophet 21. A Spryker serve a quem quer o código do comércio no projeto, com PunchOut em OCI e cXML. Nos dois, confira a ponte: a Oro registra conector SAP e PunchOut como extensões fora da licença; a Spryker, cXML lido só nos elementos listados e fatura por e-mail que não é e-invoice estruturada.

Entre OroCommerce e Spryker, o CIO costuma comparar arquitetura: uma plataforma B2B que roda onde a empresa escolher, de um lado, e o código do comércio dentro do projeto, do outro. A pergunta que decide a integração é mais estreita: como o pedido sai do sistema de compras do cliente, passa pela loja, chega ao ERP e volta como fatura. O mapa geral está no post sobre os três modelos de plataforma de comércio B2B, as outras comparações ficam no hub de comparações, e a comparação commercetools ou Spryker olha a Spryker pela integração e pelo upgrade entre plataformas componíveis.

Leia mais em O Custo da Venda Assista no YouTube Inscreva-se no canal

OroCommerce e Spryker lado a lado

A tabela resume o que cada documentação registra; onde a fonte não trata o ponto, a célula diz isso.

ponto OroCommerce Spryker
Modelo de plataforma OroCloud (SaaS gerenciado), nuvem pública, nuvem privada ou on-premise Código do comércio no projeto, com o processo de pedido modelado em máquina de estados
B2B nativo ou por extensão Clientes em árvore, papéis de comprador e cotação na plataforma Company Account com business units, papéis e permissões, e pedido de cotação
Preço por cliente e contrato Listas de preço por website, grupo de clientes e cliente Preço por relação comercial, aplicado às business units designadas
Cotação Pedido de cotação com preço-alvo; CPQ com aprovação por região, marca, valor ou segmento Pedido de cotação com versões, edição pelo representante e prazo de validade
Crédito e venda a prazo Termo de pagamento por cliente (antecipado, na entrega ou prazo em dias) Não documentado
Integração com ERP API REST (JSON:API); integrações de ERP listadas como extensões customizadas, fora do núcleo Data Exchange API, com endpoints de dados criados pelo Back Office
Modelo de cobrança Não tratado nas fontes usadas aqui Não tratado nas fontes usadas aqui
Implantação Na OroCloud, pacote gerado do Git pela orocloud-cli, com três modos de publicação Com o Code Upgrader, atualizações de pacote abertas como pull request

Preço e regra comercial: de onde vem o preço por cliente

No OroCommerce, o preço sai de cadeias de listas atribuídas aos níveis de configuração, website, grupo de clientes e cliente (Combined Price Lists). Na integração documentada com o Epicor Prophet 21, preços específicos de produto, promoções e taxas fiscais chegam do ERP à loja (integração com o Epicor P21).

Na Spryker, o recurso Merchant Custom Prices trata a relação comercial como uma dimensão de preço, ao lado de modo, volume, loja e moeda, e aplica o preço às business units designadas; a carga em massa é feita por arquivo CSV, com um comando de console (Merchant Custom Prices).

Para o CTO, a pergunta é qual sistema guarda a regra e qual só a recebe. Vale pedir às duas, na demonstração, o caminho de uma alteração de preço do ERP até o carrinho, com quem executa cada passo.

Cotação, venda assistida e PunchOut: o pedido que nasce no sistema de compras

No OroCommerce, o comprador acompanha cada pedido de cotação no storefront, com preços-alvo por item (pedidos de cotação), e o recurso Login as Customer User deixa um usuário do back-office operar o storefront como um comprador específico, na edição Enterprise (configuração de customer users).

Dois símbolos de plugue e tomada lado a lado. No do OroCommerce, um adaptador entre o plugue e a tomada representa a extensão Greenwing, fora do contrato de licença; no da Spryker, o plugue entra direto na tomada, que tem um pente representando os elementos cXML que o fluxo padrão interpreta.

Registrado na documentação da Oro, consultada em 16/10/2026: a integração de PunchOut com a Greenwing é extensão customizada e não é coberta pelo contrato de licença da Oro ("This is a custom extension, not a core feature of OroCommerce, and is not covered by the Oro User License Agreement.", PunchOut com a Greenwing).

Na Spryker, o representante edita preços, quantidades e frete da cotação e devolve uma nova versão com prazo de validade (Request for Quote), e o e-mail do agente que atendeu pode ser gravado no pedido (instalação do Agent Assist). O PunchOut Gateway implementa os fluxos OCI e cXML para conectar a loja a sistemas de eProcurement, com um carrinho por BuyerCookie no cXML.

Registrado na documentação da Spryker, em página de 22/06/2026: no fluxo cXML, a conexão é identificada e autenticada pelas credenciais do remetente, e o carrinho volta ao sistema de compras numa PunchOutOrderMessage; elementos cXML fora da lista de cobertura não são interpretados pelo fluxo padrão ("Elements that are not listed are not parsed by the default flow.", cobertura do protocolo PunchOut).

Vale pedir às duas, na demonstração, um teste com o sistema de compras de um cliente real e perguntar quem mantém essa ponte.

Integração com o ERP: o conector e a fatura

Na Oro, a integração com o Epicor P21 roda em duas fases, migração inicial e sincronização contínua, agendada ou em tempo real; a loja envia clientes, endereços, pedidos novos e faturas pagas, e recebe cotações, preços, estoque e itens não despachados (integração com o Epicor P21). As faturas podem ser importadas de sistemas externos, com prefixo de numeração próprio (configuração de faturas).

Uma linha horizontal com o ERP no centro e uma loja em cada ponta. Entre a loja OroCommerce e o ERP, um componente representa a integração de ERP descrita pela Oro; entre a loja Spryker e o ERP, outro componente do mesmo tamanho representa a Data Exchange API.

Registrado na documentação da Oro, consultada em 16/10/2026: a integração com o SAP é uma extensão customizada, não um recurso do núcleo, e não é coberta pelo contrato de licença da Oro ("This is a custom extension, not a core feature of OroCommerce, and is not covered by the Oro User License Agreement.", integração com o SAP).

Na Spryker, a Data Exchange API é construída sobre a Dynamic Entity API, que cria endpoints, validações e mapeamentos pelo Back Office, sem código, e aceita OAuth 2.0, credenciais do Back Office ou chave de API. No OMS da Spryker, eventos do pedido podem ser disparados por chamada de API, e comandos em PHP executam rotinas como a autorização de pagamento.

Registrado na documentação da Spryker, em página de 06/10/2026: o e-mail de confirmação e fatura do pedido não é uma fatura eletrônica estruturada ("It is not a structured e-invoice.", visão geral do Order Management).

Para o CTO, a pergunta é em que ponta mora cada documento. Vale perguntar às duas qual sistema emite a fatura que o comprador recebe, em qual formato, e quem mantém o conector do ERP a cada versão.

Custo e modelo de cobrança: o que entra na licença e o que vira projeto

Nas fontes usadas aqui, nenhum dos dois detalha a cobrança da plataforma: a proposta precisa trazê-la. O que as fontes mostram é onde o trabalho de integração cai.

Na Oro, as integrações de ERP listadas, como Epicor Prophet 21 e Oracle JD Edwards, são tratadas como extensões customizadas, fora do núcleo do produto e do contrato de licença padrão (integrações de ERP). Na Spryker, regras de negócio e integrações do pedido entram como plugins em PHP registrados no projeto: condições avaliam se uma transição pode ocorrer, e comandos executam as rotinas (OMS da Spryker).

Vale pedir que as duas propostas separem licença da plataforma, extensões e horas do projeto de integração, com a manutenção de cada ponte ao longo do contrato.

Implantação e sustentação: quem testa a ponte a cada versão

Na OroCloud, a atualização é empacotada a partir do Git pela orocloud-cli e publicada com modo de manutenção, por rolling upgrade, seguro só quando a estrutura do banco não muda, ou por source upgrade (como rodar upgrades).

Dois diagramas de ramificação lado a lado, iguais. No do OroCommerce, um ramo sai da linha da versão e volta a ela, marcado como a atualização pela orocloud-cli; no da Spryker, um ramo sai da linha do projeto e volta a ela, marcado como o pull request do Code Upgrader.

Com o Spryker Code Upgrader, a ferramenta compara o composer.json e o composer.lock do projeto com o último código lançado, aplica primeiro as versões de segurança e abre um pull request; versões major ficam com o time, com instruções no pull request (como funciona o Code Upgrader).

Uma extensão fora do núcleo e um plugin no projeto levam à mesma pergunta: quem testa o conector do ERP e o fluxo de PunchOut quando a plataforma muda de versão, e em que prazo.

Quando escolher o OroCommerce

ERP com mapa de integração documentado. Para o Epicor P21, integração tratada como extensão, a Oro descreve o que a loja envia e o que recebe do ERP, com sincronização agendada ou em tempo real (integração com o Epicor P21).

Fatura paga no portal. O comprador paga a fatura no storefront, por link externo ou como convidado, e cada mudança de status do pagamento dispara um webhook (InvoicePaymentBundle).

Liberdade para escolher onde a plataforma roda. OroCloud, nuvem pública, nuvem privada ou on-premise (infraestrutura da OroCloud).

Quando escolher a Spryker

Comprador que compra pelo sistema de compras dele. O PunchOut Gateway implementa OCI e cXML para conectar a loja a sistemas de eProcurement.

Processo de pedido desenhado pela empresa. O OMS da Spryker modela o ciclo do pedido como máquina de estados, com eventos automáticos, manuais, por API ou por prazo.

Endpoints de dados sem código. A Data Exchange API cria endpoints, validações e mapeamentos pelo Back Office.

Quando nenhuma das duas cabe

Na Oro e na Spryker, parte da conversa com o ERP e com o sistema de compras do cliente depende de extensão ou de código do projeto. O post sobre os três modelos de plataforma de comércio B2B descreve um terceiro caminho: levar a regra comercial para a plataforma.

É o modelo da CWS Platform. A plataforma é API-first e headless, com APIs REST e webhooks. Tabelas de preço, regras e contratos são configuráveis na plataforma e podem vir do ERP ou do CRM por API, e o cálculo de impostos pode ser delegado ao motor fiscal que o cliente já usa: o imposto vem do ERP. A cobrança é licença de plataforma mais licença de integração, e todos os clientes rodam a mesma versão. O CDL Workspace é um só sistema para todo o ecossistema. São 11 módulos, 6 AI Agents e 1.029 parâmetros.

A leitura de cada fornecedor contra esse modelo está em OroCommerce ou CWS Platform: como fica a operação de pedidos depois do clique? e em Spryker ou CWS Platform: por onde passa o preço por cliente na integração com o ERP?. Se o desenho da integração ainda deixa perguntas abertas, vale conversar com um especialista da CWS Platform antes de fechar a arquitetura.

Perguntas frequentes

OroCommerce ou Spryker: qual integra melhor com o ERP?

Depende do ERP e de quem vai manter a ponte. A Oro documenta integrações com ERPs como Epicor Prophet 21 e JD Edwards e registra o conector SAP como extensão customizada, fora do contrato de licença. A Spryker oferece a Data Exchange API, com endpoints criados pelo Back Office, e as regras do pedido entram como plugins no projeto.

Qual atende PunchOut com o sistema de compras do cliente?

Os dois documentam PunchOut. Na Oro, a integração com a Greenwing é registrada como extensão customizada, fora do contrato de licença. Na Spryker, o PunchOut Gateway implementa OCI e cXML, e o fluxo padrão não interpreta elementos fora da lista de cobertura. Vale testar com o sistema de compras do próprio comprador.

O conector de ERP vem na licença?

Na Oro, a documentação registra o conector SAP e as integrações de ERP listadas como extensões customizadas, fora do núcleo e do contrato de licença. As fontes da Spryker usadas aqui não tratam de conector de ERP pronto; descrevem a integração pelas APIs, como a Data Exchange API.

Como fica a fatura do pedido?

Na Oro, as faturas podem ser importadas de sistemas externos e pagas no storefront, por link ou como convidado, com webhook a cada mudança de status do pagamento. Na Spryker, a documentação registra que o e-mail de confirmação e fatura do pedido não é uma fatura eletrônica estruturada. Vale perguntar às duas qual sistema emite a fatura que o comprador recebe.

Leia também

Marcas citadas neste artigo

  • Spryker
  • SAP
  • commercetools
  • Oracle
  • OroCommerce

Marcas e logotipos pertencem aos seus titulares. A citação não indica parceria nem endosso.

"Estavamos á quase 2 anos tentando implantar uma solução B2B, com a CWS, implantamos em 60 dias."
EDIVALDO C. · Setor automotivo · 201 a 500 funcionários · Software Advice · Ver avaliações

A integração está travando a sua operação?

Peça o diagnóstico da sua operação ou fale direto com um especialista, como preferir.

Prefiro receber os próximos textos sobre integração com o ERP

Um resumo semanal com os textos novos sobre integração com o ERP, só nas semanas em que sair algum. Sem spam, e você sai com um clique.

A integração está travando a sua operação?

Antes de sair: peça o diagnóstico da sua operação ou fale com um especialista.

Prefiro receber os próximos textos sobre integração com o ERP

Um resumo semanal com os textos novos sobre integração com o ERP, só nas semanas em que sair algum. Sem spam, e você sai com um clique.