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

commercetools ou Spryker: o que muda na integração e no upgrade?

SaaS de API ou framework PaaS com o código no projeto: pela lente do CTO, o que cada modelo faz com a integração ao ERP e com o upgrade.

Comparativo técnico entre commercetools e Spryker mostrando arquitetura de APIs e código de projeto

Nota editorial: a CWS Platform concorre com a commercetools 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: a commercetools serve ao time que quer consumir o comércio B2B como APIs do fornecedor e escrever só as integrações, rodando num ambiente gerenciado por ela. A Spryker serve ao time que quer o código do comércio dentro do próprio projeto, com processo de pedido, endpoints e preço por contrato ajustáveis no código, e aceita atualizar esse código por pacotes. A diferença aparece na integração com o ERP e no upgrade.

As duas costumam aparecer juntas para quem procura uma plataforma B2B composable, e por isso são tratadas como equivalentes. Para o CTO, não são. Na commercetools, o projeto conversa com as APIs do pacote licenciado, e o código próprio fica nas bordas: storefront e integrações. Na Spryker, o código do comércio vive no repositório do projeto, e o fornecedor entrega atualizações como pacotes que o time aplica. A decisão é onde o seu time quer que o código mais difícil de manter fique, e quem responde quando a versão muda.

O mapa geral dos modelos está no post sobre os três modelos de plataforma de comércio B2B, e as outras comparações estão no hub de comparações.

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

commercetools e Spryker lado a lado

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

critério commercetools Spryker
Modelo de plataforma Pacote B2B Commerce sobre a commercetools Platform, com Merchant Center e APIs REST e GraphQL Código do comércio no projeto, atualizado por Composer; processo de pedido em XML e endpoints declarados em YAML
B2B nativo ou por extensão Nativo no pacote: Business Units, Associate Roles, Approval Rules, Approval Flows e Quotes Nativo: Company Account com business units, papéis e permissões, Approval Process e Request for Quote
Preço por cliente e contrato Standalone Prices por moeda, país, Customer Group ou canal, preços por Business Unit e faixas por quantidade Merchant Custom Prices: preço por relação comercial, aplicado às business units designadas
Cotação Quote Request, Staged Quote e Quote, com renegociação Request for Quote com versões, edição pelo representante e validade
Crédito e venda a prazo Não documentado Não documentado
Integração com ERP Connect (runtime gerenciado para aplicações de integração) e Import API assíncrona Data Exchange API para ERP, PIM, OMS e BI, Async Event API e PunchOut Gateway
Modelo de cobrança Por volume de pedidos, não por GMV Não documentado
Implantação Integrações escritas pelo time e hospedadas no Connect Code Upgrader com pipeline de CI por projeto, no modelo PaaS+

Preço e regra comercial: dado na API ou código no projeto

Na commercetools, a regra de preço é dado que o projeto grava e consulta por API. Pela referência de Standalone Prices, o preço fica fora do produto, ligado à variante pelo SKU, com escopo por moeda, país, Customer Group ou canal e faixas por quantidade. As Business Units modelam empresa e divisões, com herança de Stores, papéis e regras de aprovação. A estrutura tem tetos de operação. Está registrado na documentação da commercetools, consultada em 16/10/2026, na página de limites da API: "The hierarchy of Business Units is limited to 5 levels." e "The maximum number of 50 000 StandalonePrices can be specified per ProductVariant" (limites da API da commercetools). A referência de Business Units trata os 5 níveis como limite ajustável por projeto, depois de análise técnica. Vale levar para a demonstração a profundidade real da árvore de clientes e o número de preços por SKU.

Uma balança equilibrada: no prato da esquerda, fichas representam o preço como dado lido pela API; no da direita, uma folha com linhas de código representa o preço como dimensão no código do projeto; a haste da balança indica onde a regra comercial fica.

Na Spryker, o preço por contrato é uma dimensão do motor de preço que roda no projeto. Pela visão geral de Merchant Custom Prices, a relação comercial entra como dimensão de preço ao lado de modo, volume, loja e moeda, o preço vale para as business units designadas, e quando há várias relações com preços diferentes vence o menor. A carga em massa é por CSV, com comando de console.

Cotação e venda assistida

Na commercetools, a cotação é um ciclo de recursos de API. Pela visão geral de Quotes, o comprador gera um Quote Request a partir do carrinho, o vendedor monta um Staged Quote e envia um Quote vinculante, que pode ser renegociado. O Assisted Selling deixa o representante assumir e travar o carrinho do cliente no Merchant Center.

Na Spryker, o Request for Quote passa por estados de rascunho, espera, edição pelo representante e pronto, gera uma versão nova a cada devolução e fecha sozinho quando vence a validade. O Agent Assist deixa o agente entrar como o cliente na storefront.

Integração com o ERP: o contrato de entrega das mensagens

Aqui os dois modelos se separam de forma mais visível. Na commercetools, a integração é uma aplicação do projeto rodando no Connect, um runtime gerenciado com aplicações do tipo Service, Event e Job, e as cargas em lote usam a Import API, assíncrona. O time não opera servidor, mas tem de escrever o conector para o contrato de entrega da plataforma. Está registrado na documentação da commercetools, consultada em 16/10/2026: "The delivery promise is at-least-once delivery with no ordering guarantees." (comportamento de deploy do Connect). Para quem integra pedido e preço com o ERP, vale perguntar na demonstração como o conector trata o evento repetido e o evento fora de ordem.

Mensagens do ERP seguem por dois caminhos: à esquerda, envelopes numa esteira entram no conector no runtime gerenciado, com eventos entregues pelo menos uma vez e sem ordem garantida; à direita, envelopes esperam diante de um prédio com duas portas, a Glue, que recebe correções sem endpoints novos, e a API Platform, que a substitui.

Na Spryker, as APIs de integração se dividem por ator: Storefront API, Back Office API, Merchant API, Data Exchange API para operações em massa com ERP, PIM, OMS e BI, e Async Event API para notificações por evento. A Data Exchange API permite criar endpoints pelo Back Office, sem código. A camada antiga de API está numa transição registrada. Está registrado no roteiro de APIs da Spryker, em página de 30/07/2026: "Glue gets bugfixes, security, and compatibility, no new endpoints" (roteiro de APIs da Spryker). A mesma página registra que a API Platform, em Symfony, substitui a Glue e convive com ela. Vale perguntar na demonstração em qual das duas a integração nova deve nascer.

Custo e modelo de cobrança

A página de preços da commercetools registra que o pacote B2B Commerce é precificado por volume de pedidos, não por GMV, e o pacote descreve recursos entregues como Add-On à parte, como suporte a HIPAA e testes de carga. Vale perguntar se o uso do Connect entra no contrato-base ou como linha própria, e somar o custo da integração que o time vai escrever.

Nas fontes da Spryker usadas aqui, o modelo de cobrança não é tratado; o Code Upgrader é descrito como parte do modelo PaaS+. A pergunta para a proposta é a mesma dos dois lados: o que entra no contrato-base, o que vira add-on e quanto do código do projeto o time vai manter.

Implantação e sustentação: quem aplica o upgrade

Na commercetools, o código que o time mantém fica nas bordas: conectores e, se escolher o template, o storefront. O Connect publica cada conector a partir de uma tag Git, com build de prévia e validação de código antes do deploy. O upgrade que cabe ao time é o desse código.

Dois discos do mesmo tamanho: à esquerda, as APIs do pacote licenciado com um pequeno bloco de código do time nas bordas, que é o que o time atualiza; à direita, o disco inteiro é código do comércio no projeto, envolvido por um ciclo que parte de um pacote, a atualização por Composer com pull request.

Na Spryker, o upgrade é do código do projeto. Pela documentação do Code Upgrader, a ferramenta compara o composer.json e o composer.lock com o último código lançado, aplica primeiro as versões de segurança e abre um pull request com as atualizações; versões major não são aplicadas de forma automática. E há uma condição de ambiente. Está registrado na documentação da Spryker, consultada em 16/10/2026: "The Upgrader supports only projects that run in cloud environments. If you are running Spryker on premises, migrate to cloud" (preparação do projeto para o Code Upgrader). Para quem pensa em rodar em infraestrutura própria, vale perguntar como fica o upgrade fora da nuvem.

Quando escolher a commercetools

Time que quer consumir o comércio como API. O pacote B2B Commerce entrega Business Units, Associate Roles, aprovações e Quotes como APIs REST e GraphQL, com o Merchant Center para o operador.

Integração sem servidor próprio. O Connect hospeda as aplicações de integração, com tipos para chamada síncrona, evento e tarefa agendada.

Aprovação em vários níveis. As Approval Rules definem critérios por valor, moeda e país, com solicitantes e aprovadores por papel, herdadas pelas unidades filhas.

Cobrança que não acompanha o GMV. A página de preços descreve o pacote B2B precificado por volume de pedidos.

Quando escolher a Spryker

Processo de pedido sob medida. O OMS da Spryker modela o ciclo do pedido como máquina de estados em XML, com condições e comandos em PHP que ligam regras de negócio e integrações.

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

Preço por contrato com várias relações. O Merchant Custom Prices trata a relação comercial como dimensão de preço, com regra de desempate documentada.

Upgrade assistido por pull request. O Code Upgrader roda numa pipeline de CI dedicada ao projeto, com agendamento configurável.

Quando nenhuma das duas cabe

Há um terceiro modelo, descrito no post sobre os três modelos de plataforma de comércio B2B: nem consumir APIs e escrever a regra nas bordas, nem trazer o código do comércio para dentro do projeto, e sim levar a regra comercial para a plataforma.

É o modelo da CWS Platform. A política comercial fica guardada em parâmetros, configuração em vez de código. Tabelas de preço, regras e contratos são configuráveis na plataforma ou chegam do ERP e do CRM por API, e o cálculo de impostos pode ser delegado ao motor fiscal que o cliente já usa. A arquitetura é API-first e headless, com APIs REST e webhooks, e todos os clientes rodam a mesma versão. São 11 módulos, 6 AI Agents e 1.029 parâmetros.

Para ler cada fornecedor contra esse modelo, há dois comparativos: commercetools ou CWS Platform: quanto custa manter a regra comercial integrada e Spryker ou CWS Platform: por onde passa o preço por cliente na integração com o ERP.

Se nenhuma das duas formas de dividir o código cabe no time que você tem, vale conversar com um especialista da CWS Platform antes de fechar a arquitetura.

Perguntas frequentes

commercetools ou Spryker: qual é melhor para B2B?

Depende de onde o time quer o código. A commercetools serve a quem quer consumir Business Units, aprovações e cotação como APIs e escrever só as integrações. A Spryker serve a quem quer o processo de pedido, o preço por contrato e os endpoints dentro do código do projeto, com PunchOut para compradores que usam eProcurement.

SaaS ou PaaS: qual a diferença na prática?

Na commercetools, o projeto chama as APIs do pacote licenciado e hospeda as integrações no Connect, um runtime gerenciado. Na Spryker, o código do comércio fica no repositório do projeto, e o Code Upgrader, entregue no modelo PaaS+, abre pull requests com as atualizações. Na prática, muda quem aplica a nova versão e onde o código customizado mora.

Qual integra melhor com o ERP?

As duas têm caminho documentado. A commercetools oferece o Connect e a Import API, e registra que os eventos do Connect são entregues pelo menos uma vez, sem garantia de ordem. A Spryker oferece a Data Exchange API e a Async Event API, e registra que a Glue não ganha endpoints novos enquanto a API Platform a substitui.

Como fica o upgrade em cada um?

Na commercetools, o time atualiza o código que escreveu nas bordas, conectores e storefront, e publica cada conector a partir de uma tag Git. Na Spryker, o Code Upgrader aplica atualizações por Composer e abre pull request, mas versões major não são automáticas e a ferramenta só suporta projetos em nuvem, como registra a documentação.

Leia também

Marcas citadas neste artigo

  • commercetools
  • Spryker

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.