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

VTEX ou CWS Platform: o que os problemas conhecidos dizem sobre a sustentação?

A lista pública de problemas conhecidos, o timeout na extração em massa e o limite de requisições sem garantia: a conta da sustentação pela lente de quem responde por tecnologia.

Linha do tempo comparativa de sustentação de software destacando itens de backlog e filas de retry de API.

Nota editorial: comparativo de arquitetura entre VTEX e CWS Platform, escrito para quem responde como CIO ou CTO. Todo fato sobre a VTEX vem da documentação pública dela, da página oficial de problemas conhecidos e do fórum oficial, com o endereço ao lado.

A demonstração de plataforma mostra o que funciona. O time de tecnologia vai viver, pelos anos seguintes, com o que não funciona: a sincronização noturna com o ERP que estoura o tempo, a chamada que volta recusada no pico de atualização de preços, o defeito conhecido que ninguém sabe quando sai da fila. Isso é sustentação, e é ela que decide quantas pessoas o canal digital consome depois da implantação.

Duas perguntas ajudam a medir esse custo antes da assinatura. O que a lista pública de problemas conhecidos do fornecedor mostra sobre o tempo que os itens ficam em aberto? E o que o fornecedor garante sobre os limites das APIs de que a integração vai depender? Cada nova tentativa, cada fila e cada conciliação manual é custo de transação que não aparece na licença.

Este comparativo olha para VTEX e CWS Platform só por esse ângulo. Não é um ranking de funcionalidades. O mapa geral está no post sobre os três modelos de plataforma de comércio B2B, e as outras leituras por fornecedor estão no hub de comparações.

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

O que a VTEX resolve bem

A VTEX expõe a plataforma por API de forma ampla. Segundo a documentação para desenvolvedores, as capacidades centrais vêm de mais de 70 microsserviços compartilhados, acessíveis por APIs REST. A lista de APIs REST separa as APIs por domínio, como Catalog, Checkout e Logistics, com credenciais geridas pela License Manager API, por AppKeys e AppTokens.

Para dados próprios, o Master Data funciona como banco chave-documento, com Data Plane e Control Plane. Sem o id do registro, a consulta usa /search, apoiado em índices, ou /scroll, para extração em massa.

A documentação também diz as regras de concorrência, o que poupa descoberta em produção. A visão geral da Checkout API avisa que operações que modificam dados não podem ser executadas em paralelo e que o cliente da API deve enfileirá-las. E a VTEX publica uma página aberta de problemas conhecidos, com status por item.

Onde a arquitetura diverge

A divergência que interessa ao CIO ou CTO começa justamente nessa página. Segundo a página de known issues da VTEX, consultada em 05/11/2026, 1.458 dos 2.070 itens publicados estavam em aberto (Backlog ou Scheduled) e 244 marcados No Fix; a idade mediana dos abertos era de 3,2 anos. Em aberto, aqui, é o status na página no dia da consulta, não a afirmação de que o problema atinge toda conta: muitos itens descrevem cenários específicos. O número é um retrato datado e muda com o tempo.

Uma linha do tempo com muitos itens em aberto espalhados, um grupo marcado como No Fix e um colchete que mostra a idade mediana dos abertos.

Dois registros mostram como isso encosta numa integração B2B:

  • registrado pela VTEX como problema conhecido, em aberto em 05/11/2026 (aberto desde junho de 2019): ao pedir grandes volumes de dados pelo endpoint de scroll, o Master Data pode dar timeout ("In some cases, when requesting large amounts of data through our scroll endpoint, Master Data will timeout.", https://help.vtex.com/en/known-issues/master-datas-scroll-endpoint-sometimes-returns-a-408-error).
  • atrito registrado no fórum oficial da VTEX, consultado em 05/11/2026: em resposta no fórum oficial, em janeiro de 2024, a VTEX responde que não pode dar 100% de certeza de que o erro de limite de requisições não vai ocorrer na API de preços ("Infelizmente, eu não posso te dar 100% de certeza de que esse problema não irá ocorrer", https://community.vtex.com/t/limite-de-requisicao-rest/37825).

O primeiro pesa porque o /scroll é o caminho documentado para extração em massa, que é exatamente o que fazem as cargas noturnas para ERP, BI e conciliação. Com o timeout registrado como problema conhecido em aberto, a integração precisa nascer com paginação, nova tentativa e ponto de retomada, e alguém precisa monitorar a carga que parou no meio.

O segundo pesa porque, no B2B, preço muda muito e por cliente. A tabela que vem do ERP pode gerar volumes grandes de atualização de uma vez. Sem garantia de que o limite de requisições não vai disparar, a integração precisa de fila, espera progressiva e uma regra para o que acontece com o preço enquanto a atualização não termina. Somado à regra documentada do checkout, de enfileirar as escritas, esse desenho é trabalho do time do cliente, antes e depois da implantação.

Na CWS Platform, a arquitetura é API-first, com APIs REST e webhooks. Tabelas de preço, regras e contratos podem vir do ERP ou do CRM por API, o imposto vem do ERP ou do motor fiscal que o cliente já usa, e o limite de crédito do cliente é mantido na plataforma. A política comercial fica em parâmetros do Commerce Rules Engine, e todos os clientes rodam a mesma versão. As duas perguntas deste comparativo valem para qualquer fornecedor, inclusive a CWS.

decisão VTEX, pelo mecanismo documentado CWS Platform
O que a lista pública mostra Em 05/11/2026, 1.458 de 2.070 itens em aberto, 244 No Fix, idade mediana dos abertos de 3,2 anos Pergunta para qualquer fornecedor: a lista, o status e a idade dos itens
Extração em massa de dados /scroll do Master Data, com timeout registrado como problema conhecido em aberto APIs REST e webhooks para ERP, CRM e sistemas do cliente
Limite de requisições na API de preços Sem garantia de que o erro não ocorra, segundo resposta no fórum oficial em janeiro de 2024 Tabelas de preço podem vir do ERP por API; o limite é pergunta para o contrato
Onde mora a condição comercial B2B No app B2B Organizations, do VTEX IO: meios de pagamento, tabelas de preço e coleções por organização Parâmetros do Commerce Rules Engine, com todos os clientes na mesma versão

A decisão técnica é saber, antes de assinar, quanto da sustentação vai morar no time da empresa e quanto vai morar na plataforma.

O que muda na operação, pela lente de CIO/CTO

Para o time de tecnologia, a diferença aparece em três rotinas. A primeira é a diligência. Antes de escolher qualquer plataforma, vale filtrar a lista pública de problemas conhecidos pelos módulos que o projeto vai usar e ler três coisas: quantos itens estão em aberto, quantos foram marcados como sem correção prevista e há quanto tempo os abertos esperam. Depois, levar ao fornecedor os itens que encostam no seu cenário e pedir o plano para cada um.

Chamadas de atualização de preço chegam a um limite de requisições; a maioria passa, e uma ou outra volta por um ciclo de fila e nova tentativa.

A segunda é o desenho da integração. Cada limite sem garantia e cada problema conhecido em aberto vira requisito: nova tentativa, fila, espera progressiva, ponto de retomada, alerta. Isso tem custo de construção e, sobretudo, custo de sustentação, porque alguém precisa olhar o alerta às três da manhã.

A terceira é o ciclo de vida do código próprio. Pela documentação de componentes componíveis da VTEX, os componentes se dividem em Built-in, já instalados, e Plug-and-play, que pedem instalação e, em alguns casos, configuração; os que ficam fora dessas duas categorias exigem etapa de desenvolvimento ou configuração complexa. Quanto mais regra comercial mora em código próprio, maior o inventário que o time precisa acompanhar. Vale perguntar ao fornecedor quem sustenta cada app depois da implantação e desenhar, como num RACI, quem responde por cada parte: plataforma, integração e operação.

Na CWS, a regra comercial fica em parâmetros, no princípio de configuração em vez de código, e a plataforma reúne 11 módulos, 6 AI Agents e 1.029 parâmetros, com todos os clientes na mesma versão.

Quando escolher a VTEX

A VTEX atende bem a cenários com estas características:

Time técnico que quer construir sobre a plataforma. Escolha essa arquitetura quando há equipe para desenvolver e manter apps no VTEX IO e integrar dezenas de microsserviços pelas APIs REST.

Varejo B2C e marketplace de varejo. Escolha essa arquitetura quando a operação é de consumidor final, com e-commerce, lojas físicas e marketplace sob a mesma orquestração de pedidos, como descreve a página da VTEX Commerce Platform.

Ecossistema de integrações prontas. Escolha essa arquitetura quando a estratégia depende das mais de 900 integrações prontas com provedores de pagamento e marketplaces citadas no guia de composabilidade.

Quando a CWS Platform é a escolha certa neste cenário

A CWS Platform é a escolha indicada quando o ERP é a fonte da regra e o time de tecnologia quer que a política comercial não vire código próprio para sustentar.

ERP e CRM como fonte e o imposto do motor fiscal se conectam por APIs REST e webhooks a um núcleo de política comercial em parâmetros, que segue para o pedido.

ERP como fonte, plataforma por API. Escolha essa arquitetura quando preço, regra e contrato nascem no ERP ou no CRM. A CWS é API-first, com APIs REST e webhooks, e o imposto vem do ERP ou do motor fiscal que a empresa já usa.

Política comercial em parâmetros. Escolha essa arquitetura quando a regra muda com frequência e não deve virar app. O Commerce Rules Engine, no CDL Workspace, guarda a política em parâmetros.

Uma versão para todos os clientes. Escolha essa arquitetura quando o time não quer manter versão própria da plataforma. Todos os clientes rodam a mesma versão.

Crédito do cliente dentro da plataforma. Escolha essa arquitetura quando o limite de crédito precisa acompanhar o pedido. Ele é mantido na plataforma, concedido no CDL Workspace ou por API.

Por onde continuar

Se a pergunta ainda é qual modelo de plataforma serve à sua operação, o ponto de partida é os três modelos de plataforma de comércio B2B. Para a conta de manter a regra integrada com outro fornecedor, o comparativo quanto custa manter a regra comercial integrada? olha para ERP e CRM.

Se a decisão depende da sua integração real, vale conversar com um especialista da CWS Platform e mapear, com os seus fluxos de preço, pedido e crédito, onde cada regra vai morar. A página Quando a Integração Trava Tudo trata da dor por trás deste cenário em profundidade, sem falar de fornecedor nenhum.

Comparações com outros fornecedores

Para comparar a VTEX com outras plataformas, sem a CWS Platform no meio:

Leia também

Marcas citadas neste artigo

  • VTEXVTEX
  • MagentoMagento
  • SAP
  • commercetools
  • Spryker
  • Adobe Commerce
  • Salesforce
  • SAP Commerce Cloud
  • Optimizely
  • 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.