Интеграцию интернет-магазина на Shopify с системой можно произвести при помощи приложения. Есть возможность выгрузить архивные данные с помощью приложения по API.
После установки приложение будет:
Перед установкой Shopify необходимо создать в системе магазин. Перейдите в раздел «Магазины» в администрировании системы и кликните по кнопке «Добавить». Более подробно о создании магазина читайте в соответствующем разделе.
При создании магазина для Shopify, во вкладке «Каталог» одноименному полю необходимо присвоить значение «Не загружать», так как каталог будет сгенерирован автоматически в ходе настройки модуля на стороне Shopify.
Также нам понадобится API-ключ для взаимодействия системы и Shopify. При создании важно указать ранее созданный магазин. Создать API-ключ можно в разделе «Ключи доступа к API». Более подробнее о создании API-ключа читайте в соответствующем разделе.
Примечание: в создаваемом API-ключе, в поле «Разрешенные методы API» должны быть активированы следующие методы:
Для того, чтобы установить приложение 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 клиент указывает данные в полях «Address» и «Apartment, suite, etc.», то в систему значение этих полей передается через разделитель ||
. В связи с этим, если в системе отключено разбиение адреса по отдельным полям, то в поле «Адрес», в карточке заказа системы, будет присутствовать символ ||
. Разделитель был введен для того, чтобы данные адреса при синхронизации не дублировались. Информация, указанная в поле «Address» в Shopify, будет выведена слева от разделителя, а справа, соответственно, из поля «Apartment, suite, etc.».
При оформлении заказа на стороне Shopify, он также выгружается в систему с помощью вебхуков и содержит следующую информацию: данные покупателя, состав заказа, данные доставки.
В случае, если выгружается заказ, оформленный на клиента, несуществующего в системе, будет создан новый клиент, а данный заказ привяжется к созданному клиенту.
Обратите внимание, если в заказе присутствует информация из поля Note, она будет выгружена в поле «Комментарий оператора» в системе. Заполнить данное поле можно либо в административной панели Shopify, либо оно может быть заполнено покупателем, если включена опция добавления комментария при оформлении заказа.
При установке приложения на 4 шаге, происходит автоматическое заполнение поля «URL ICML-файла» в системе, в настройках магазина Shopify.
Если количество торговых предложений (variants
) менее или равно 500 элементам, то каталог генерируется сразу на последнем этапе установки. Если более 500, то по расписанию раз в 4 часа.
Каталог товаров можно загрузить в систему принудительно нажав «Загрузить каталог из ICML сейчас» в настройках магазина.
Обновление информации о товарах происходит также по расписанию раз в 4 часа. По товарам выгружается следующая информация:
Важно! Если при оформлении заказа в Shopify, добавить новую позицию, не являющуюся товаром из каталога в системе, то заказ будет выгружен с данной позицией, но в каталог этот товар не добавится.
При передаче клиента передаются персональные данные (Фамилия; Имя; E-mail; Телефон из профиля клиента; Флаг согласия получения маркетинговой рассылки; Адрес) и данные доставки.
При передаче данных заказа указывается информация о покупателе, адресе доставки и составе заказа. В случае, если выгружается заказ, оформленный на клиента, несуществующего в Shopify, будет создан новый клиент.
Если в заказе, в системе, будет выбран тип оплаты, указанный в настройках приложения для интеграции, то в Shopify будет создана транзакция с суммой и статусом оплаты.
В Shopify нельзя изменять состав заказа, который пришел из системы. При попытке сделать данное действие, будет выведено сообщение, что заказ не доступен для редактирования, но можно изменить следующие данные:
Обратите внимание, при изменении состава заказа на стороне системы, изменения не будут переданы в Shopify по причине отсутствия метода для обновления данных в REST API Shopify.
Приложение для интеграции Shopify с системой постоянно улучшается, добавляются новые возможности для передачи и синхронизации данных.
Для того, чтобы стали доступны новые функции приложения, необходимо обновить его версию, путем расширения прав для приложения. Это можно сделать перейдя на страницу приложения в разделе «Apps», в котором отобразится всплывающее окно с кнопкой «Update app».
Важно! Информация не будет показана в том случае, если ваш браузер блокирует показ всплывающих окон.