Commerce Bridge

Commerce Bridge é a camada opcional que adapta provedores externos ao contrato interno do e-commerce. A plataforma funciona sem ela; o adaptador é ligado somente quando um projeto precisa aproveitar serviços como VTEX headless.

Recorte da seçãoReferência do sistema

Consulte contratos, decisões e comportamentos atuais do sistema com caminhos diretos para os detalhes relacionados.

Atualizado21 de jul. de 2026

Seções4

Tags3

commerce-bridgevtexadaptadores

Nesta página · 4 tópicos

Responsabilidade

mermaid

O storefront não deve conhecer detalhes de GraphQL, cookies ou schemas de um fornecedor. O bridge traduz busca, categoria, produto, SKU e checkout para os tipos internos.

Estado atual

proxy GraphQL em /api/bff/vtex-graphql;
rotas de marcas, categorias, busca, SKU e checkout em /api/vtex/*;
configuração por ambiente;
backend nativo permanece o comportamento padrão;
código do adaptador fica isolado de catálogo, OrderForm e componentes visuais.

Quando ativar

migração gradual de frontend;
operação headless sobre catálogo já existente;
integração temporária durante transição de plataforma;
projeto que precisa manter checkout ou dados no provedor.

Regras de manutenção

não importar tipos do provedor em componentes do storefront;
normalizar respostas no limite do adaptador;
tratar timeout e indisponibilidade sem corromper estado local;
esconder credenciais no servidor;
documentar diferenças de preço, estoque e checkout por projeto.