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

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

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

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

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

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

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

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

При активации опции «Показать расширенный список статусов» (Enable extended statuses), будут отображены статусы доставки и причины отмены.

Обратите внимание, при выборе соответствия доступны только статусы определенной группы из системы, в зависимости от их принадлежности к совершаемому над заказом действию (если статус в Shopify относится к доставке, то для выбора соответствия будут доступны только статусы из группы доставки в системе).

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

Вы можете выбрать в соответствие статусам пустое значение (Not selected). В этом случае, статусы синхронизироваться не будут. Если в системе выбрать статус заказа, которому нет соответствия в Shopify в настройках приложения, то по заказу с этим статусом также не будет выполнено никаких действий.

Далее, требуется сопоставить службы доставки на сайте с типами доставки в системе.

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

Последним действием второго шага является настройка выбора типа оплаты, с которым будет выгружаться заказ из 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 клиент указывает данные в полях «Address» и «Apartment, suite, etc.», то в систему значение этих полей передается через разделитель ||. В связи с этим, если в системе отключено разбиение адреса по отдельным полям, то в поле «Адрес», в карточке заказа системы, будет присутствовать символ ||. Разделитель был введен для того, чтобы данные адреса при синхронизации не дублировались. Информация, указанная в поле «Address» в Shopify, будет выведена слева от разделителя, а справа, соответственно, из поля «Apartment, suite, etc.».

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

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

Обратите внимание, если в заказе присутствует информация из поля Note, она будет выгружена в поле «Комментарий оператора» в системе. Заполнить данное поле можно либо в административной панели Shopify, либо оно может быть заполнено покупателем, если включена опция добавления комментария при оформлении заказа.

Загрузка каталога в систему

При установке приложения на 4 шаге, происходит автоматическое заполнение поля «URL ICML-файла» в системе, в настройках магазина Shopify.

Если количество торговых предложений (variants) менее или равно 500 элементам, то каталог генерируется сразу на последнем этапе установки. Если более 500, то по расписанию раз в 4 часа.

Каталог товаров можно загрузить в систему принудительно нажав «Загрузить каталог из ICML сейчас» в настройках магазина.

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

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

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

При передаче клиента передаются персональные данные (Фамилия; Имя; E-mail; Телефон из профиля клиента; Флаг согласия получения маркетинговой рассылки; Адрес) и данные доставки.

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

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

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

Обратите внимание, при изменении состава заказа на стороне системы, изменения не будут переданы в Shopify по причине отсутствия метода для обновления данных в REST API Shopify.

Обновление приложения

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

Для того, чтобы стали доступны новые функции приложения, необходимо обновить его версию, путем расширения прав для приложения. Это можно сделать перейдя на страницу приложения в разделе «Apps», в котором отобразится всплывающее окно с кнопкой «Update app».

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

Возможные причины не выгрузки данных


Редакция от 26.11.2020 12:42