AliExpress
Скопировать ссылку на статью
Скопировано

Важно!

Модуль интеграции с AliExpress работает по модели FBS: Доставка со склада продавца.

Интеграционный модуль AliExpress позволяет реализовать передачу следующих данных в RetailCRM:

  1. Заказы, в том числе их изменения.
  2. Клиенты. Подробную информацию по процессу синхронизации данных клиентов с RetailCRM можно посмотреть здесь.

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

Перед передачей товарного каталога убедитесь, что он соответствует правилам публикации товаров AliExpress.

Подключение

Подготовка к подключению

Для работы модуля необходим аккаунт продавца на AliExpress. Если у вас его нет - создайте его перейдя по этой ссылке. При необходимости, можете воспользоваться официальной инструкции AliExpress по этой ссылке.

Создание API-ключа для подключения

Создайте API-ключ следуя этой инструкции. У ключа должны быть активны методы следующих разделов: «Заказы», «Клиенты», «Склад», «Справочники», «Пользователи», «Задачи» и «Интеграция».

Подключение модуля к RetailCRM

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

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

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

Подключение модуля к аккаунту AliExpress

Выбор пользователя для периодического обновления подключения

AliExpress требует, чтобы подключение к интеграционному модулю обновлялось каждый месяц. Для обновления достаточно заново войти в аккаунт AliExpress через модуль (как это сделать описано в следующем шаге). Если не обновить подключение вовремя - модуль прекратит выгружать новые заказы и обновлять старые.

Для предотвращения такой ситуации в модуле реализована система напоминаний, которая не позволит забыть о необходимости обновления подключения. Модуль начнёт создавать задачу в RetailCRM на обновление подключения за 5 дней до прекращения работы. После прекращения работы модуль также продолжит создавать задачу. В форме ниже (вы также должны видеть её на экране) необходимо выбрать пользователя, на которого будет назначаться задача на обновление подключения.

Подключение аккаунта AliExpress

Для запуска процесса подключения нажмите на кнопку Подключить аккаунт. Если вы ещё не вошли в аккаунт AliExpress - вы увидите форму входа:

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

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

Для перехода к следующему шагу нажмите Продолжить.

Настройка соответствий цен

На этом шаге вы увидите такую форму:

В AliExpress предлагаются лишь два типа цены для товара: базовая и акционная. Здесь вы сможете связать их с типами цен в AliExpress. Выберите нужные типы цен RetailCRM, а затем нажмите Продолжить.

Настройка выгрузки каталога

На этом шаге вы увидите следующую страницу:

Выгрузка товаров и остатков в AliExpress производится через YML-каталог. Учёт остатков производится в разрезе складов. На этой странице вам необходимо выбрать те склады, остатки из которых будут выгружаться в каталог AliExpress. Остатки по нескольким складам суммируются (например, на первом складе осталось 5 единиц товара, на втором - 2; если оба склада выбраны здесь - в AliExpress выгрузится 7 единиц).

Выбор складов выглядит следующим образом:

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

Это сообщение означает, что каталог находится в процессе генерации. Индикатор генерации каталога также может появиться в этом разделе без нажатия кнопки Сгенерировать - это происходит во время генерации каталога для вашего магазина.

Теперь надо немного подождать. Ссылка на каталог появится после завершения генерации. Перезагружать страницу для появления ссылки не нужно.

Массовые операции YML

Выгрузка данных каталога производится согласно этой инструкции. Для получения ссылки на каталог нажмите кнопку Скопировать (находится в секции Каталог товаров в модуле, рядом с кнопкой Сгенерировать).

Скопированную ссылку нужно вставить в раздел Товары > Массовые операции YML > Загрузить YML.

В открывшемся окне укажите ссылку на YML файл.

На странице с загрузкой YML файла настройте какие данные нужно обновлять автоматически для всех товаров из YML файла. Обновление данных будет происходить раз в 4 часа.

После завершения работы с YML вернитесь в модуль для продолжения настройки, и нажмите Продолжить. Если вы уже закрыли страницу настройки модуля, то откройте её через вашу RetailCRM. Для этого перейдите в Настройки, нажмите на вкладку Интеграция, затем Маркетплейс, найдите в списке модуль AliExpress, кликните по нему и нажмите кнопку Перейти в личный кабинет.

Примечание

Загрузка файла каталога в инструмент «Массовые операции YML» может занимать продолжительное время, так как загруженные файлы YML обрабатываются на стороне AliExpress.

Настройка соответствий статусов заказов

При переходе на следующий шаг появится форма заполнения соответствий:

Для каждого статуса AliExpress необходимо выбрать один статус из RetailCRM. Нельзя выбирать один и тот же статус дважды.

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

Для перехода к следующему шагу нажмите Продолжить.

Выбор типа оплаты для заказов из AliExpress

AliExpress пока не предоставляет информации о том, как именно покупатель оплатил товар. Поэтому для всех заказов будет использоваться тот тип оплаты, который вы выберете в этой форме:

Важно!

У выбранного типа оплаты должны быть активны все возможные статусы оплаты. В противном случае выгрузка заказов не будет работать.

После выбора типа оплаты нажмите кнопку Завершить настройку.

Навигация по модулю

После завершения настройки модуля вы окажетесь в секции "AliExpress" ⇒ "Подключение". В левой части экрана раскроется такое меню:

При открытии этих пунктов вы увидите те же настройки, которые были пройдены вами ранее в режиме мастера.

В секции RetailCRM этого меню находятся настройки подключения:

Здесь можно обновить API-ключ.

Ниже секции RetailCRM находится выпадающее меню. В нём указаны все магазины, которые подключены к модулю. Модуль позволяет подключить несколько магазинов и аккаунтов AliExpress к одной RetailCRM.

Добавление магазина RetailCRM в модуль

Добавление магазинов производится кнопкой "Добавить магазин". Если её нажать - вы увидите следующее:

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

Все настройки в секции AliExpress уникальны для каждого добавленного магазина. Количество добавляемых магазинов неограничено.

Синхронизация данных модулем

Модуль выгружает следующие данные из AliExpress:

  • Новые заказы.
  • Изменённые заказы.

Для заказов автоматически создаются клиенты в RetailCRM.

Модуль не создаёт и не изменяет корпоративных клиентов т.к. AliExpress & T-Mall не предназначена для использования организациями.

Примечание

Представленная далее информация содержит названия полей AliExpress и RetailCRM. Эти названия необходимы для полноценного описания того, как интеграционный модуль выгружает данные. Если вы хотите узнать как именно сопоставляются данные из AliExpress и данные RetailCRM, или же узнать почему модуль выгрузил тот или иной заказ не так, как вы ожидали - информация ниже поможет вам разобраться.

Выгрузка новых заказов

Новые заказы выгружаются за определённый период - началом периода считается момент завершение предыдущей выгрузки заказов. Если выполняется первая выгрузка заказов, то выгрузятся все заказы за предыдущий месяц.

Получение заказов идёт порциями по 1000 штук (если заказов меньше тысячи, то будет выгружено столько заказов, сколько их есть в AliExpress). Модуль вынужден получать данные чека для каждого заказа индивидуально (фактически в данных чека содержится адрес).

При выгрузке заказов (как новых, так и изменённых) модуль учитывает временную зону вашей RetailCRM.

Клиент для заказа генерируется следующим образом:

В заказе AliExpress есть поле buyer_signer_fullname, которое содержит ФИО клиента - это поле разбивается на фамилию, имя и отчество. Разбиение происходит по словам следующим образом:

  1. Если присутствует только одно слово, то оно считается именем.
  2. Если присутствуют два слова, то они считаются фамилией и именем.
  3. Если присутствуют три слова, то они считаются полным ФИО.

ФИО записывается в поля firstName (имя), lastName (фамилия) и patronymic (отчество). Это поля RetailCRM.

В поле externalId (внешний ID) RetailCRM попадает значение поля buyer_login_id AliExpress.

Если предоставлены данные чека, то адрес из него записывается в клиента следующим образом (данные представлены в следующем формате: поле RetailCRM ⇒ поле AliExpress):

  1. index (индекс в заказе) ⇒ zip (индекс в заказе);
  2. countryIso (код страны в заказе) ⇒ country (код страны в заказе);
  3. region (регион в заказе) ⇒ province (регион или провинция в заказе);
  4. city (город в заказе) ⇒ city (город в заказе);
  5. text (адрес в произвольной форме) ⇒ address и address2 (адреса в произвольной форме, записываются через пробел);
  6. notes (заметка к адресу) ⇒ detail_address (заметка к адресу, может содержать информацию о том, как добраться до клиента, или код домофона для доставки).

Заказ из AliExpress в RetailCRM передаётся следующим образом:

  1. В поле externalId (внешний ID заказа) передаётся поле order_id (ID заказа в AliExpress).
  2. В поле number (номер заказа) также передаётся ID заказа в AliExpress.
  3. В поле createdAt (дата создания заказа) передаётся дата создания из AliExpress (поле gmt_create). При этом дата и время конвертируются из временной зоны API AliExpress во временную зону вашей RetailCRM.
  4. В поле customer заказа (данные клиента) передаётся только поле externalId (внешний ID клиента). Заказы выгружаются после клиентов - поэтому это поле свяжет заказ с клиентом в RetailCRM.
  5. Статус заказа в RetailCRM (поле status) выставляется согласно маппингу в настройках модуля.
  6. Заполнение фамилии (firstName), имени (lastName) и отчества (patronymic) в заказе RetailCRM работает так же, как и для клиента в заказе.
  7. Для контрагента заказа выставляется тип individual (физическое лицо).
  8. Оплата в заказе создаётся согласно маппингу в настройках модуля. Если в маппинге не указан тип оплаты для заказов, то передачи оплаты не произойдёт. В externalId (внешний идентификатор) оплаты записывается значение вида payment_{{ ID заказа AliExpress }} (например, для заказа с ID 1 в AliExpress получится такое значение внешнего кода оплаты: payment_1). Если заказ уже оплачен, то будет передана дата оплаты (поле paidAt в RetailCRM), которая берётся из данных заказа (поле gmt_pay_time в AliExpress).
  9. Адрес доставки (поле order[delivery][address]) заполняется так же, как и адрес покупателя.
  10. Стоимость доставки (поле order[delivery][cost]) передаётся из первого товара в заказе AliExpress (в AliExpress это поле order[product_list][order_product_dto][][logistics_amount][amount]).

Позиции заказа передаются следующим образом (указано в виде формата: поле RetailCRM ⇒ поле AliExpress).

  1. externalId (внешний ID позиции RetailCRM) ⇒ product_id (ID товара в AliExpress);
  2. id (ID позиции) ⇒ sku_code (артикул позиции);
  3. quantity (количество) ⇒ product_count (количество);
  4. initialPrice (цена позиции) ⇒ amount (цена позиции);
  5. productName (название позиции) ⇒ product_name (название позиции);
  6. comment (комментарий к позиции) ⇒ memo (комментарий к позиции).

Выгрузка изменений по заказам

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

Выгрузка изменений отличается от выгрузки новых заказов лишь тем, что передача изменений производится через методы редактирования заказа и оплаты, а не через методы пакетной выгрузки. Передаваемые данные и методы их формирования идентичны.

Может случиться ситуация, при которой товара в заказе нет в каталоге RetailCRM (например, вы ранее вручную создали этот товар в AliExpress). Заказ с таким товаром выгрузится в RetailCRM, однако у товара будет отсутствовать изображение и закупочная цена, а карточку товара открыть не получится. Чтобы избежать такой ситуации рекомендуем использовать каталог RetailCRM для передачи всех товаров в AliExpress.

Благодарим за отзыв.
Была ли статья полезна?
Нет
  • Рекомендации не помогли
  • Нет ответа на мой вопрос
  • Текст трудно понять
  • Не нравится описанный функционал
Да