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

# Совместимость приложений с Upcart

В этой статье описано, как устранять проблемы совместимости приложений с Upcart, и приведены лучшие практики для оптимальной работы.

<div id="overview">
  ## **Обзор**
</div>

Upcart разработан для плавной интеграции с большинством приложений Shopify. Однако некоторые сторонние приложения могут вызывать проблемы с функциональностью в зависимости от того, как они изменяют логику корзины, оформления заказа, ценообразования или валют Shopify.\
​

Upcart работает как наложение cart drawer, улучшая опыт использования корзины без полной замены нативной корзины или оформления заказа Shopify.\
​

Приложения, которые переопределяют поведение корзины Shopify, перехватывают действия Add to Cart или заменяют нативную систему ценообразования или валют Shopify, могут конфликтовать с Upcart.

Мы рекомендуем по возможности использовать нативную функциональность Shopify (например, Shopify Markets для конвертации валют). **Наша команда имеет ограниченные возможности поддержки сторонних приложений, которые существенно изменяют стандартную структуру корзины Shopify.**

Даже если приложение доступно в Shopify App Store, оно все равно может относиться к сторонним приложениям и иметь определенные ограничения при использовании с Upcart.

<div id="incompatible-apps">
  ## **Несовместимые приложения**
</div>

Следующие приложения, как было установлено, постоянно вызывают проблемы с Upcart и не поддерживаются:

**BUCKS (приложение-конвертер валют)**\
Upcart несовместим со сторонними приложениями для конвертации валют. Upcart использует нативную конвертацию валют Shopify через Shopify Markets. Приложения-конвертеры валют, такие как BUCKS, лишь визуально изменяют цены на витрине и не изменяют фактическую валюту корзины. По этой причине они не влияют на отображение валюты внутри Upcart и могут вызывать несоответствия.

Если вам нужна мультивалютная функциональность, мы рекомендуем использовать **Shopify Markets.**

**CloudFox Checkout**\
Сторонние приложения для замены оформления заказа несовместимы с Upcart.

**CartPanda**\
Сторонние системы оформления заказа не поддерживаются.

***

<div id="apps-that-may-cause-issues">
  ## **Приложения, которые могут вызывать проблемы**
</div>

Сообщалось, что следующие приложения вызывают конфликты или могут работать с Upcart не полностью так, как задумано:

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

Хотя эти приложения в некоторых случаях могут работать, отдельные элементы или функции Upcart могут отображаться или функционировать не так, как ожидается.

Если вы столкнулись с проблемами при использовании любого из этих приложений, мы рекомендуем включить настройку совместимости, описанную ниже.\
​

Разработчики также могут использовать [<u>Upcart Public AP</u>](https://rokt.notion.site/upcart-public-api)I для поиска решения.

***

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

Если вы сталкиваетесь с конфликтами с другим приложением, мы рекомендуем включить:

**Enhanced AJAX API Compatibility**

Чтобы включить эту настройку:

Перейдите в **Upcart → Cart editor → Settings → Cart settings → Advanced Settings → Enhanced Ajax API compatibility**. В админ-панели Upcart нет раздела Settings верхнего уровня — настройка находится внутри редактора корзины, в свернутом разделе **Advanced Settings**.

Эта настройка указывает Upcart прекратить перехват вызовов Add to Cart.

Она также делает вторую вещь, о которой название не говорит: заставляет Upcart ставить в очередь вызовы Ajax cart API Shopify (`/cart/add`, `/cart/add.js`, `/cart/update.js`, `/cart/change.js`), чтобы они выполнялись по одному, предотвращая перезапись одновременных обновлений разными скриптами. Поскольку такая очередь патчит все сетевые запросы корзины на странице, включайте настройку только при необходимости и тестируйте витрину после этого.

Это позволяет другим приложениям, таким как приложения для бандлов, конструкторы страниц, приложения кастомизации и приложения опций товара, работать без помех.

<div id="important">
  ### **Важно:**
</div>

Эта настройка имеет компромисс.

Поскольку Upcart больше не будет перехватывать вызовы Add to Cart, он не сможет предотвращать перенаправление покупателей другими приложениями на нативную страницу корзины.

Если после включения этой настройки покупатели перенаправляются в обход cart drawer:

1. Проверьте настройки конфликтующего приложения.
2. Ищите такие опции, как:
   * Disable redirect to cart
   * Stay on page after add to cart
   * Enable AJAX add to cart
3. Измените эти настройки, чтобы предотвратить принудительные перенаправления на страницу корзины.

Настоятельно рекомендуется тестирование после включения этой настройки.

Перечисленные выше приложения — примеры тех, у которых были выявлены проблемы совместимости с Upcart. Могут существовать и другие, еще не выявленные приложения. Этот список будет обновляться по мере поступления новых случаев.

<div id="if-upcart-is-not-opening-or-is-redirecting">
  ### Если Upcart не открывается или перенаправляет
</div>

Если Upcart не открывается должным образом или вместо этого перенаправляет на страницу корзины, обратитесь к нашему руководству по устранению неполадок:

[Устранение проблем: Upcart не открывается или перенаправляет на страницу корзины](/ru/upcart/troubleshooting_upcart_not_opening_or_redirecting)

Это руководство рассматривает распространенные причины и пошаговые решения, включая:

* Конфликты с темой или пользовательским кодом
* Проблемы с настройками AJAX-корзины
* Проверки совместимости приложений
* Шаги по устранению проблем с браузером и кэшем

Если проблема сохраняется после выполнения руководства, свяжитесь со службой поддержки, указав URL вашего магазина и краткое описание проблемы.

***

<div id="testing-recommendation">
  ## **Рекомендация по тестированию**
</div>

Прежде чем вносить любые изменения в действующую версию, мы рекомендуем протестировать Upcart на дубликате вашей темы.

Для этого:

* В админ-панели Shopify перейдите в **Online Store > Themes**
* Нажмите **Actions** рядом с вашей действующей темой, затем выберите **Duplicate**
* Откройте дубликат темы и нажмите **Preview**
* Протестируйте взаимодействие с корзиной, бандлы, скидки, отображение валют и апселлы
* После подтверждения опубликуйте обновленную тему

Предварительное тестирование помогает предотвратить проблемы с отображением или производительностью до того, как они затронут покупателей.

***
