> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solução de problemas do Multicart

> Resolva problemas comuns com configurações do Multicart.

<div id="multicart-troubleshooting">
  # Solução de problemas do Multicart
</div>

Este guia ajuda você a resolver problemas comuns ao trabalhar com múltiplas configurações de carrinho no Upcart.

<div id="preview-limitations">
  ## Limitações da pré-visualização
</div>

As pré-visualizações de rascunho podem não refletir totalmente o comportamento do carrinho ativo. Recursos que dependem do estado real do carrinho, códigos de desconto ativos ou determinadas integrações podem se comportar de forma diferente.

**Recursos com limitações conhecidas de pré-visualização:**

* **Descontos** - Podem não disparar corretamente no modo sandbox
* **Proteção de envio** - As consultas de produto se comportam de forma diferente no sandbox
* **Pagamentos expressos** (Shop Pay, Apple Pay, etc.) - Não disponíveis na pré-visualização

⚠️ **Dica:** para a maioria das mudanças de layout e design, a pré-visualização é confiável. Para testar Descontos, proteção de envio ou pagamentos expressos, você precisará publicar o carrinho para testar adequadamente.

<div id="preview-troubleshooting">
  ### Solução de problemas da pré-visualização
</div>

Se você pré-visualizar um carrinho e vir um carrinho incorreto, isso pode acontecer devido a limitações do Shopify. Tente atualizar a página ou abrir e fechar o carrinho para atualizar a pré-visualização.

<div id="troubleshooting-translations">
  ## Solução de problemas de traduções
</div>

Se as traduções não estiverem aparecendo na sua loja:

1. **Verifique se a tradução foi salva** - Vá para All Carts → Translate no seu carrinho ativo e confirme que o texto foi inserido para o locale
2. **Verifique se o carrinho com as traduções está ativo** - As traduções só sincronizam quando um carrinho é publicado
3. **Verifique as configurações de locale do Shopify** - Vá para Shopify Admin → Settings → Languages e confirme que o locale está habilitado
4. **Verifique se o locale correto está ativo** - Sua loja precisa ser navegada no locale de destino para as traduções serem exibidas

<div id="common-issues-and-solutions">
  ## Problemas comuns e soluções
</div>

<div id="upcart-has-disappeared-from-my-store">
  ### O Upcart desapareceu da minha loja
</div>

**Causa mais comum:** você não tem um carrinho ativo.

**Como corrigir:**

1. Abra o app Upcart e vá para **All Carts**
2. Verifique se algum carrinho mostra um selo verde "live"
3. Se nenhum carrinho estiver ativo, clique em **Publish** em qualquer carrinho de rascunho que você queira ativar

**Outras causas:**

* O app embed do Upcart pode estar desativado. O carrinho ativo mostraria um selo amarelo "App embed off". Vá para Shopify Admin → Online Store → Themes → Customize → App embeds → ative o **Upcart**.

<div id="my-cart-settings-changedreset-after-i-published-a-different-cart">
  ### As configurações do meu carrinho mudaram/foram redefinidas depois que publiquei um carrinho diferente
</div>

Esse é o comportamento esperado. Publicar um carrinho sobrescreve os metafields ativos do Shopify com as configurações do novo carrinho.

**Como corrigir:**

1. Seu carrinho anterior ainda está salvo como rascunho
2. Vá para **All Carts** e encontre seu carrinho antigo na seção Drafts
3. Clique em **Publish** nele para restaurar as configurações anteriores

**Como evitar isso no futuro:** revise um carrinho de rascunho com cuidado antes de publicar, já que a publicação substitui todas as configurações ativas.

<div id="my-shipping-protection-disappeared-after-switching-carts">
  ### Minha proteção de envio desapareceu depois de trocar de carrinho
</div>

A proteção de envio é configurada por carrinho. O carrinho recém-publicado não tem um produto de proteção de envio configurado ou tem um diferente.

**Como corrigir:**

1. Vá para o editor de carrinho do carrinho ativo atual
2. Navegue até o módulo Add-ons → seção Shipping Protection
3. Configure novamente o produto de proteção de envio
4. Salve (as configurações do carrinho ativo serão atualizadas imediatamente)

**Se você quiser que ambos os carrinhos tenham a mesma proteção de envio:** configure o produto de proteção de envio em cada carrinho individualmente antes de publicar.

<div id="my-discount-rules-stopped-working-after-switching-carts">
  ### Minhas regras de desconto pararam de funcionar depois de trocar de carrinho
</div>

As regras de desconto são **para toda a loja, não por carrinho** — um único conjunto para toda a sua loja, aplicado independentemente de qual carrinho está ativo. Publicar um carrinho diferente nunca as remove nem substitui, então uma mudança de comportamento após uma publicação não é um conjunto de regras perdido.

**Como corrigir:** abra **Discounts** na navegação à esquerda do Upcart e verifique as regras lá. Se uma regra parou de disparar, veja se o carrinho recém-publicado ainda contém o bloco que a exibe — as regras sobrevivem à publicação, mas o layout de carrinho que exibe o progresso delas pode não sobreviver.

<div id="i-cant-delete-my-cart">
  ### Não consigo excluir meu carrinho
</div>

Você está tentando excluir um carrinho ativo. Carrinhos ativos não podem ser excluídos.

**Como corrigir:**

1. Vá para **All Carts** e identifique qual carrinho está ativo (selo verde)
2. Clique em **Unpublish** nele
3. ⚠️ Aviso: isso significa que nenhum carrinho estará ativo até você publicar outro
4. Quando ele for um rascunho, a opção de exclusão ficará disponível

**Se você não tem outro carrinho para publicar:** crie um novo carrinho (ou duplique o atual), configure-o e publique o novo antes de excluir o antigo. Isso evita um intervalo sem carrinho ativo.

<div id="the-draft-preview-doesnt-look-rightdoesnt-match-what-i-expect">
  ### A pré-visualização do rascunho não parece certa/não corresponde ao que espero
</div>

As pré-visualizações de rascunho usam o modo sandbox, que tem limitações conhecidas. Nem todos os recursos se comportam da mesma forma que em um ambiente ativo.

**Limitações conhecidas:**

* Os descontos podem não disparar no modo sandbox
* A proteção de envio pode não renderizar corretamente
* Os botões de pagamento expresso (Shop Pay, Apple Pay, etc.) não estão disponíveis na pré-visualização

**Para a maioria das mudanças de layout/design:** a pré-visualização sandbox é confiável o suficiente.

**Para testar Descontos, proteção de envio ou pagamentos expressos:** você precisará publicar o carrinho em um ambiente ativo para testar adequadamente.

<div id="my-live-cart-analytics-arent-populated">
  ### As análises do meu carrinho ativo não estão preenchidas
</div>

As análises por carrinho cobrem apenas a atividade registrada desde que os carrinhos começaram a ser marcados nos eventos de análise. A atividade anterior ainda está armazenada e ainda é contabilizada — ela apenas não pode ser dividida por carrinho, então visualize-a na página Analytics ou no gráfico da página inicial em vez da visão por carrinho.

<div id="frequently-asked-questions">
  ## Perguntas frequentes
</div>

<div id="what-happens-to-my-current-live-cart-when-i-publish-a-new-one">
  ### O que acontece com meu carrinho ativo atual quando publico um novo?
</div>

O carrinho ativo anterior é automaticamente movido de volta para rascunho. Isso acontece instantaneamente. Você verá um modal de confirmação antes disso acontecer.

<div id="can-i-preview-both-sandbox-and-live-carts-at-once">
  ### Posso pré-visualizar os carrinhos sandbox e ativo ao mesmo tempo?
</div>

Ao alternar entre as pré-visualizações sandbox e ativa, o Upcart atualizará a página para carregar os dados corretos. Se você precisar pré-visualizar as duas versões ao mesmo tempo, use uma janela privada/anônima para uma delas para evitar atualizações forçadas.

<div id="i-published-a-cart-by-mistake-and-now-my-live-settings-are-wrong-what-do-i-do">
  ### Publiquei um carrinho por engano e agora minhas configurações ativas estão erradas. O que faço?
</div>

Nenhum dado é perdido. Vá para **All Carts** e encontre o carrinho que você realmente queria que estivesse ativo (ele estará agora na seção Drafts). Clique em **Publish** nele para restaurá-lo como o carrinho ativo.

<div id="im-getting-an-error-when-trying-to-publishunpublishdelete-whats-wrong">
  ### Estou recebendo um erro ao tentar publicar/despublicar/excluir. O que há de errado?
</div>

O servidor impede que duas mutações de carrinho sejam executadas ao mesmo tempo para a mesma loja. Se você clicou rapidamente duas vezes, ou se duas abas do navegador acionaram a ação simultaneamente, a segunda falhará.

Aguarde alguns segundos e tente novamente. O erro é transitório. Se persistir, atualize a página e tente mais uma vez.

<div id="the-upgrade-to-v2-changed-how-my-cart-looks-can-i-revert-it">
  ### O upgrade para a V2 mudou a aparência do meu carrinho. Posso reverter?
</div>

**Se você ainda não publicou:** você pode reverter o upgrade no editor de carrinho antes de publicar.

**Se você já publicou o carrinho V2:** você não precisa de um rascunho antigo. Abra o editor de carrinho e use o menu suspenso **Cart version** para voltar para **V1.0 (Legacy)** e depois salve. O menu suspenso aparece sempre que todos os módulos do carrinho estão na V2, esteja o carrinho ativo ou em rascunho.

<div id="i-dont-see-a-translate-option-on-my-cart-where-is-it">
  ### Não vejo a opção "Translate" no meu carrinho. Onde ela está?
</div>

A ação Translate só aparece na tabela **All Carts**, não no card de carrinho da página inicial. Ela também exige que você tenha pelo menos um locale não inglês habilitado na sua loja Shopify.

Para acessá-la:

1. Vá para Upcart → All Carts (via "Manage all carts" na página inicial)
2. Encontre seu carrinho na tabela
3. Procure o botão Translate nas ações da linha

Se nenhuma opção Translate aparecer, talvez você não tenha locales adicionais configurados no Shopify. Vá para Shopify Admin → Settings → Languages para adicionar um locale.