# Headless commerce: os três níveis, as opções reais e qual delas você provavelmente quer de verdade

> A maioria das empresas que pedem "headless commerce" quer comércio incorporado por widget. Algumas precisam de commercetools ou Saleor. Aqui está o framework de decisão honesto.

Ryan Badger - 3 de outubro de 2025 - 6 min de leitura

## O que "headless commerce" realmente significa

Headless commerce significa desacoplar o frontend (o que o seu cliente vê) do backend de comércio (carrinho, checkout, estoque, pedidos). Em vez de escolher uma plataforma que traz os dois juntos (como as lojas com tema da Shopify), você constrói ou compra o frontend separadamente e o liga a uma API de comércio.

A palavra "headless" é usada de forma frouxa. Há três níveis distintos:

- **Headless completo:** você constrói o frontend do zero (React, Next.js, Astro, Nuxt) e chama uma API de comércio para cada dado. Listagens de produtos, estado do carrinho, checkout. Você é dono de toda a UX.
- **Headless com widget incorporado:** o seu frontend já existe (um site de marketing, um projeto no Webflow, um blog). Você coloca um widget de comércio que é renderizado dentro dele. Não é "headless completo", mas ainda é desacoplado: o seu site não é um template de plataforma de comércio.
- **Tradicional (não headless):** você escolhe Shopify, BigCommerce ou WooCommerce, usa o sistema de temas deles, e o seu site É a plataforma de comércio.

A maior parte do barulho em torno de "headless" é sobre o nível 1. A maioria das lojas não precisa dele de fato.

## Quando o headless completo vale a pena

O headless completo se paga em quatro situações específicas. Fora delas, é tempo de engenharia que você não recupera.

1. **Você precisa de uma UX personalizada que os temas das plataformas não alcançam.** Configuradores interativos, visualizadores 3D de produto, layouts de narrativa com muito conteúdo. Reconstruir o frontend ia acontecer de qualquer jeito; headless só significa que você também pode controlar o fluxo de dados de comércio.
2. **Distribuição multicanal a partir de um só catálogo.** Site + aplicativo móvel + quiosque na loja + interface de voz/chat. Uma API de comércio compartilhada alimentando todos eles é realmente difícil de fazer da forma tradicional.
3. **Escala em que as plataformas tradicionais viram gargalo.** A Shopify Plus dá conta da maior parte disso hoje, mas se você está no volume da Nike/IKEA, uma API de comércio por trás do seu próprio frontend dá controles de desempenho que uma loja com tema não dá.
4. **Equipe de engenharia com capacidade real de frontend.** Se você tem engenheiros de frontend dedicados, o headless fica realmente mais barato com o tempo porque você deixa de pagar o imposto do desenvolvedor de temas.

Se você não se encaixa em uma das quatro, o headless completo é quase sempre uma troca pior do que escolher uma plataforma hospedada.

## O conjunto de opções de headless completo

Para as equipes que realmente precisam de headless completo, a lista realista de 2026:

- **commercetools**: nível corporativo, engenharia alemã, caro. A implementação de referência do composable commerce.
- **Saleor**: código aberto, auto-hospedado ou gerenciado, API GraphQL forte. Amigável para desenvolvedores.
- **Medusa**: código aberto, nativo em JavaScript, ecossistema em crescimento. Mais próximo, no formato, de uma "Shopify como API".
- **BigCommerce Headless**: use a BigCommerce como backend e traga o seu próprio frontend. A opção mais limpa de "migrar sem reconstruir o backend".
- **Shopify Storefront API**: use o comércio da Shopify por trás de um frontend personalizado. A complexidade de hospedagem e desenvolvimento fica com você; estoque / pedidos / pagamentos continuam na Shopify.
- **Shoprocket pelo SDK `@shoprocket/core`**: produtos, carrinho e sessões totalmente programáticos ([shoprocket-js](https://github.com/shoprocket/shoprocket-js)). Pule o widget, renderize a sua própria interface, fale com a nossa API diretamente. Veja a seção "Onde o Shoprocket se encaixa" abaixo para as ressalvas.

Ranking aproximado por ergonomia para desenvolvedores: Medusa > Saleor > Shopify Storefront API > BigCommerce > commercetools. Ranking aproximado por confiabilidade corporativa: commercetools > Shopify > BigCommerce > Saleor > Medusa. Escolha conforme aquilo que você está otimizando.

## A opção com widget incorporado (a categoria que a maioria das pessoas realmente quer)

A maioria das empresas que dizem querer "headless" na verdade quer isto: um site de marketing ou de conteúdo que já tem, mais um comércio que se encaixa sem forçar uma reconstrução.

Shoprocket, Snipcart e Ecwid ficam todos aqui. Você mantém o seu site (Webflow, WordPress, HTML estático, Astro, Framer), cola uma tag de script e o comércio é renderizado dentro dele. É desacoplado, mas não reimplementado.

```
<!-- EXAMPLE ONLY. Grab your real snippet from Sales channels → Embeds in your dashboard -->
<script src="https://cdn.shoprocket.io/loader.js" data-pk="pk_yourkey"></script>
<div data-shoprocket="catalog" data-embed-id="emb_xxx"></div>
```

A API também está disponível se você quiser ir além (cartões de produto personalizados feitos com o seu próprio markup, consultando a nossa API para os dados). O controle programático completo fica no SDK de JS ([shoprocket-js](https://github.com/shoprocket/shoprocket-js)), para eventos, manipulação do carrinho e interfaces personalizadas.

**Quando este nível vence o headless completo:**

- Você já tem um site de que gosta (não quer reconstruir o frontend)
- Você não tem engenheiros de frontend dedicados
- Seus requisitos de UX cabem no que o widget renderiza
- Você quer o comércio no ar em semanas, não em trimestres

**Quando passar para o headless completo:**

- O widget não alcança a UX de que você precisa
- Você precisa renderizar produtos em contextos que o widget não cobre (aplicativo móvel nativo, quiosques, TV)
- Você tem a equipe de engenharia para sustentá-lo

## Como saber de qual nível você precisa

Faça a si mesmo duas perguntas:

1. **Os meus requisitos de UX caberiam dentro de uma seção retangular do meu site atual?** Se sim, o widget incorporado serve. Se não, você está em território de headless completo.
2. **Tenho um engenheiro de frontend dedicado pelos próximos 18 meses?** Se não, pule o headless completo, independentemente do que você ache que precisa.

A segunda pergunta é a decisiva. Headless completo sem um engenheiro de frontend é uma pilha de dívida técnica esperando para acontecer. Os fornecedores da plataforma de comércio vão ajudar, mas não podem substituir alguém que seja dono do seu frontend personalizado.

## E o "composable commerce"?

A mesma ideia, rebatizada para o ciclo de compras corporativo. "Composable" = escolher o melhor de cada categoria para cada função (CMS, busca, PIM, carrinho, checkout, impostos) e ligá-los por meio de APIs. Funciona quando você tem a equipe para ligá-los. Vira um peso de manutenção quando não tem.

Para lojas com faturamento abaixo de cerca de US$ 10 milhões por ano, o composable é quase sempre um erro. A superfície de integração é enorme, e toda troca de fornecedor quebra alguma coisa.

## Onde o Shoprocket se encaixa

Cobrimos os níveis 1 e 2, e somos honestos sobre qual você deve escolher.

**Nível 2 (widget incorporado), o padrão para 95% dos nossos clientes.** Cole uma tag de script e o widget é renderizado dentro do seu site atual. Catálogo, carrinho, checkout, busca, variantes, pagamentos, tudo resolvido. Assinatura fixa a partir de US$ 29/mês, 0% de taxa por transação. É o caminho rápido e o certo para a maioria das lojas.

**Nível 1 (headless completo), tecnicamente suportado, raramente recomendado.** O SDK `@shoprocket/core` ([shoprocket-js](https://github.com/shoprocket/shoprocket-js)) expõe produtos, estado do carrinho e sessões de forma programática. Você pode renderizar cada pixel por conta própria e falar com a nossa API diretamente. A mesma assinatura fixa cobre isso.

**Por que não empurramos o nível 1, mesmo ele funcionando:** cobrir todos os casos extremos em um frontend personalizado (estados de carregamento, carrinhos vazios, interface de seleção de variantes, fluxos de checkout, tratamento de erros, acessibilidade, telas de celular, i18n em 21 idiomas) dá muito trabalho de engenharia. O widget já traz tudo isso, testado em milhares de lojas. Você estaria reimplementando um problema já resolvido, a menos que tenha um motivo de UX específico para não fazer isso.

Se você tem esse motivo de UX específico e capacidade de engenharia dedicada, o SDK core está aí. Caso contrário: cole o widget e siga em frente.

> **Dica:** se um fornecedor se diz "headless" sem saber responder "qual framework de frontend vocês recomendam?", provavelmente é de widget incorporado. Tudo bem; só saiba o que você está comprando.

## Resumo

- **Headless completo:** commercetools, Saleor, Medusa, Shopify Storefront API, BigCommerce Headless. Só vale a pena com necessidades específicas de UX, multicanal, escala ou equipe de desenvolvimento dedicada.
- **Widget incorporado:** Shoprocket, Snipcart, Ecwid. A resposta certa para a maioria das lojas que "querem headless". O Shoprocket também oferece headless completo pelo SDK core, para o caso raro em que você precise.
- **Tradicional:** Shopify + tema, BigCommerce + tema. Ainda é o caminho mais rápido se você ainda não tem um site.

A maioria das empresas que pedem headless na verdade quer o nível de widget incorporado. [Comece um teste grátis do Shoprocket](https://app-v3.shoprocket.io/signup) se isso soa como você. 14 dias, sem cartão. [Preços](https://v3.shoprocket.io/pt/precos.md) a partir de US$ 29.

---

- HTML version: https://v3.shoprocket.io/pt/blog/headless-commerce-tres-niveis-opcoes-reais-e-qual-voce-provavelmente-quer
- Language: Português (pt)
- Also in: [العربية](https://v3.shoprocket.io/ar/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [Deutsch](https://v3.shoprocket.io/de/blog/headless-commerce-drei-stufen-optionen-entscheidung.md), [Ελληνικά](https://v3.shoprocket.io/el/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [English](https://v3.shoprocket.io/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [Español](https://v3.shoprocket.io/es/blog/headless-commerce-tres-niveles-opciones-reales.md), [Français](https://v3.shoprocket.io/fr/blog/commerce-headless-trois-niveaux-quelle-option-choisir.md), [עברית](https://v3.shoprocket.io/he/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [हिन्दी](https://v3.shoprocket.io/hi/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [Bahasa Indonesia](https://v3.shoprocket.io/id/blog/headless-commerce-tiga-tingkatan-pilihan-nyata-dan-mana-yang-anda-butuhkan.md), [Italiano](https://v3.shoprocket.io/it/blog/headless-commerce-tre-livelli-opzioni-reali-quale-scegliere.md), [日本語](https://v3.shoprocket.io/ja/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [Lietuvių](https://v3.shoprocket.io/lt/tinklarastis/headless-prekyba-trys-lygiai-ir-kuris-jums-tinka.md), [Norsk](https://v3.shoprocket.io/nb/blogg/headless-commerce-tre-nivaer-reelle-alternativer-og-hva-du-trenger.md), [Nederlands](https://v3.shoprocket.io/nl/blog/headless-commerce-drie-niveaus-welke-past-bij-jou.md), [Polski](https://v3.shoprocket.io/pl/blog/headless-commerce-trzy-poziomy-realne-opcje-co-wybrac.md), [Română](https://v3.shoprocket.io/ro/blog/headless-commerce-cele-trei-niveluri-si-care-ti-trebuie.md), [Русский](https://v3.shoprocket.io/ru/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [ไทย](https://v3.shoprocket.io/th/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md), [Türkçe](https://v3.shoprocket.io/tr/blog/headless-ticaret-uc-kademe-gercek-secenekler-ve-hangisini-istiyorsunuz.md), [中文](https://v3.shoprocket.io/zh/blog/headless-commerce-the-three-tiers-the-real-options-and-which-one-you-probably-actually-want.md)