retailCRM Документация

Интеграция Shopify с системой

Интеграцию интернет-магазина на Shopify с системой можно произвести при помощи приложения. Есть возможность выгрузить архивные данные с помощью приложения по API.

После установки приложение будет:

Настройка со стороны системы

Перед установкой Shopify необходимо создать в системе магазин. Перейдите в раздел «Магазины» в администрировании системы и кликните по кнопке «Добавить». Более подробно о создании магазина читайте в соответствующем разделе.

При создании магазина для Shopify, во вкладке «Каталог» одноименному полю необходимо присвоить значение «Не загружать», так как каталог будет сгенерирован автоматически в ходе настройки модуля на стороне Shopify.

Также нам понадобится API-ключ для взаимодействия системы и Shopify. При создании важно указать ранее созданный магазин. Создать API-ключ можно в разделе «Ключи доступа к API». Более подробнее о создании API-ключа читайте в соответствующем разделе.

Настройка со стороны Shopify

Для того, чтобы установить приложение Shopify для интеграции с системой, в административной панели магазина Shopify перейдите в раздел Apps и кликните по «Visit the Shopify App Store».

В поисковой строке Shopify App Store введите название модуля «retailCRM», затем перейдите на страницу модуля и нажмите кнопку «Add App».

После откроется страница в Shopify с перечнем возможностей модуля, для дальнейшей установки следует нажать «Install app».

Первым шагом по настройке модуля является ввод данных подключаемой системы. В первом поле введите ранее созданный API-ключ. Во втором, нужно указать полный URL системы (например, https://demo.retailcrm.ru). Далее нажмите «Save and Continue».

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

Далее, установите соответствие статусам заказов между подключаемой системой и Shopify. О настройке статусов можно узнать из соответствующей статьи.

Важно! В настройках соответствия не должно быть повторяющихся значений, иначе это приведет к неверным данным статусов заказов на стороне системы.

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

Кликните по «Save and Continue» для перехода на третий шаг настройки интеграции.

На третьем шаге необходимо настроить триггеры для передачи данных клиентов и заказов в Shopify. Для этого перейдите во вкладку «Триггеры» раздела «Коммуникации». Для создания триггера, который будет передавать заказы из системы в Shopify, заполните следующие поля:

Далее, нажмите на «Добавить действие» и выберите значение «Выполнить HTTP-запрос».

В поле «Адрес», необходимо прописать URL, который указан в настройках модуля Shopify в столбце «Order».

Значением поля HTTP-метод выберите POST. В поле «Передавать параметры» укажите значение «В теле запроса (urlencode)» и нажмите «Добавить параметр». Укажите параметр id и поставьте ему значение {{ order.id }}. Сохраните данный триггер.

Для передачи данных клиентов требуется создать триггер по аналогии с триггером для передачи заказов. URL для передачи данных клиентов берется также из настроек модуля, из колонки «Customer».

После того, как триггеры в системе будут настроены, необходимо перейти в настройки модуля Shopify, на третий шаг, и нажать «Continue».

На четвертом шаге будут сформированы вебхуки для передачи заказов и клиентов из Shopify в систему, а также сгенерирован ICML-файл для загрузки каталога в систему. В настройках магазина, в системе, будет автоматически прописан URL ICML-файла. Загрузка каталога в систему будет происходить через каждые 4 часа.

Синхронизация

Синхронизация из Shopify в систему

При создании клиента на стороне Shopify, он будет выгружен в систему при помощи вебхуков. По клиенту выгружаются следующие данные:

Важно! В систему передается только адрес доставки. Платежный адрес клиента не передается.

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

В случае, если выгружается заказ, оформленный на клиента, несуществующего в системе, будет создан новый клиент, а данный заказ привяжется к созданному клиенту.

Синхронизация из системы в Shopify

При передаче клиента передаются персональные данные и данные доставки.

При передаче данных заказа указывается информация о покупателе и адресе доставки. В случае, если выгружается заказ, оформленный на клиента, несуществующего в Shopify, будет создан новый клиент.


Редакция от 11.09.2020 18:09