> ## 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.

# Compatibilidade de apps com o Upcart

Este artigo descreve como solucionar problemas de compatibilidade de apps com o Upcart e apresenta boas práticas para um desempenho ideal.

<div id="overview">
  ## **Visão geral**
</div>

O Upcart foi projetado para se integrar sem problemas à maioria dos apps da Shopify. No entanto, certos apps de terceiros podem causar problemas de funcionamento dependendo de como eles modificam o carrinho, o checkout, a lógica de preços ou de moeda da Shopify.\
​

O Upcart opera como uma sobreposição de cart drawer, aprimorando a experiência do carrinho de compras sem substituir completamente o carrinho ou o checkout nativos da Shopify.\
​

Apps que sobrescrevem o comportamento do carrinho da Shopify, interceptam ações de Add to Cart ou substituem o sistema nativo de preços ou de moeda da Shopify podem entrar em conflito com o Upcart.

Recomendamos usar a funcionalidade nativa da Shopify sempre que possível (como o Shopify Markets para conversão de moeda). **Nossa equipe tem escopo de suporte limitado para apps de terceiros que alteram significativamente a estrutura padrão do carrinho da Shopify.**

Mesmo que um app esteja disponível na Shopify App Store, ele ainda pode ser categorizado como um app de terceiros e pode ter certas limitações quando usado com o Upcart.

<div id="incompatible-apps">
  ## **Apps incompatíveis**
</div>

Os apps a seguir demonstraram causar problemas de forma consistente com o Upcart e não são suportados:

**BUCKS (app de conversão de moeda)**\
O Upcart não é compatível com apps de conversão de moeda de terceiros. O Upcart usa a conversão de moeda nativa da Shopify por meio do Shopify Markets. Apps de conversão de moeda como o BUCKS apenas alteram os preços visualmente na vitrine e não modificam a moeda real do carrinho. Por isso, eles não afetam a exibição de moeda dentro do Upcart e podem causar inconsistências.

Se você precisa de funcionalidade multimoeda, recomendamos usar o **Shopify Markets.**

**CloudFox Checkout**\
Apps de substituição de checkout de terceiros não são compatíveis com o Upcart.

**CartPanda**\
Sistemas de checkout de terceiros não são suportados.

***

<div id="apps-that-may-cause-issues">
  ## **Apps que podem causar problemas**
</div>

Os apps a seguir foram relatados como causadores de conflitos ou podem não funcionar totalmente como esperado com o Upcart:

* **qikify Quick View Popups**
* **Vitals**
* **Bundle Bear**

Embora esses apps possam funcionar em alguns casos, certos elementos ou recursos do Upcart podem não ser exibidos ou funcionar como esperado.

Se você tiver problemas ao usar qualquer um desses apps, recomendamos ativar a configuração de compatibilidade descrita abaixo.\
​

Os desenvolvedores também podem utilizar a [<u>API pública do Upcart</u>](https://rokt.notion.site/upcart-public-api) para trabalhar em uma solução.

***

<div id="enhanced-ajax-api-compatibility">
  ## **Enhanced AJAX API Compatibility**
</div>

Se você estiver enfrentando conflitos com outro app, recomendamos ativar:

**Enhanced AJAX API Compatibility**

Para ativar essa configuração:

Vá em **Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility**. Não existe um destino Settings de nível superior no admin do Upcart — a configuração fica dentro do editor de carrinho, atrás da seção recolhida **Advanced Settings**.

Essa configuração diz ao Upcart para parar de interceptar as chamadas de Add to Cart.

Ela também faz uma segunda coisa que o nome não sugere: faz o Upcart enfileirar as chamadas à API Ajax de carrinho da Shopify (`/cart/add`, `/cart/add.js`, `/cart/update.js`, `/cart/change.js`) para que elas sejam executadas uma de cada vez, impedindo que atualizações simultâneas de scripts diferentes sobrescrevam umas às outras. Como esse enfileiramento aplica um patch a todas as requisições de rede do carrinho na página, ative a configuração apenas quando precisar dela e teste a vitrine depois.

Isso permite que outros apps, como apps de bundles, construtores de páginas, apps de personalização e apps de opções de produtos, funcionem sem interferência.

<div id="important">
  ### **Importante:**
</div>

Essa configuração tem um custo.

Como o Upcart deixará de interceptar as chamadas de Add to Cart, ele não pode impedir que outros apps redirecionem os clientes para a página de carrinho nativa.

Se os clientes forem redirecionados para fora do cart drawer depois de ativar essa configuração:

1. Verifique as configurações do app conflitante.
2. Procure opções como:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. Ajuste essas configurações para evitar redirecionamentos forçados para a página de carrinho.

É altamente recomendável testar depois de ativar essa configuração.

Os apps listados acima são exemplos dos que apresentaram problemas de compatibilidade com o Upcart. Pode haver apps adicionais ainda não identificados. Esta lista será atualizada conforme novos casos forem relatados.

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### Se o Upcart não estiver abrindo ou estiver redirecionando
</div>

Se o Upcart não estiver abrindo corretamente ou estiver redirecionando para a página de carrinho, consulte nosso guia de solução de problemas:

[Solução de problemas: Upcart não abre ou redireciona para a página de carrinho](/pt/upcart/troubleshooting_upcart_not_opening_or_redirecting)

Este guia percorre as causas comuns e as soluções passo a passo, incluindo:

* Conflitos com o tema ou código personalizado
* Problemas com as configurações de carrinho AJAX
* Verificações de compatibilidade de apps
* Etapas de solução de problemas de navegador e cache

Se o problema persistir depois de seguir o guia, entre em contato com o suporte informando a URL da sua loja e uma breve descrição do problema.

***

<div id="testing-recommendation">
  ## **Recomendação de teste**
</div>

Antes de publicar qualquer alteração, recomendamos testar o Upcart em uma versão duplicada do seu tema.

Para isso:

* No admin da Shopify, vá em **Online Store > Themes**
* Clique em **Actions** ao lado do seu tema ativo e selecione **Duplicate**
* Abra o tema duplicado e clique em **Preview**
* Teste as interações do carrinho, bundles, descontos, exibição de moeda e upsells
* Depois de confirmar, publique o tema atualizado

Testar com antecedência ajuda a evitar problemas de exibição ou desempenho antes que eles afetem os clientes.

***
