Skip to main content

​
Solução de problemas do Multicart

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

​
Limitações da pré-visualização

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.

​
Solução de problemas da pré-visualização

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.

​
Solução de problemas de traduções

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

​
Problemas comuns e soluções

​
O Upcart desapareceu da minha loja

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.

​
As configurações do meu carrinho mudaram/foram redefinidas depois que publiquei um carrinho diferente

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.

​
Minha proteção de envio desapareceu depois de trocar de carrinho

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.

​
Minhas regras de desconto pararam de funcionar depois de trocar de carrinho

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.

​
Não consigo excluir meu carrinho

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.

​
A pré-visualização do rascunho não parece certa/não corresponde ao que espero

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.

​
As análises do meu carrinho ativo não estão preenchidas

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.

​
Perguntas frequentes

​
O que acontece com meu carrinho ativo atual quando publico um novo?

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

​
Posso pré-visualizar os carrinhos sandbox e ativo ao mesmo tempo?

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.

​
Publiquei um carrinho por engano e agora minhas configurações ativas estão erradas. O que faço?

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.

​
Estou recebendo um erro ao tentar publicar/despublicar/excluir. O que há de errado?

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.

​
O upgrade para a V2 mudou a aparência do meu carrinho. Posso reverter?

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.

​
Não vejo a opção “Translate” no meu carrinho. Onde ela está?

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.