AliExpress

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

Скопировано

Важно!

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

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

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

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

Примечание

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

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

Подключение

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

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

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

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

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

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

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

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

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

Заполнение jwt токена

Чтобы использовать новый локальный API для продавцов Aliexpress, необходимо выпустить jwt токен и сохранить его в модуле. Для этого нужно перейти по ссылке в личный кабинет Aliexpress и создать (либо выбрать существующий) jwt токен. Скопируйте текст токена и вставьте в текстовый инпут на странице настройки интеграции, и затем нажмите кнопку Сохранить.

Когда вы сохраните токен (и если он уже был сохранен), то на странице настройки интеграции вместо поля ввода токена будет отображаться текст JWT токен сохранён, а также кнопка Редактировать для смены токена. Для перехода к следующему шагу нажмите Продолжить

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

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

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

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

Примечание

Если планируете работать с уже имеющимися товарами в AliExpress - данный этап можно пропустить.

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

Выгрузка товаров и остатков в 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:

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

Передача заказов из AliExpress в систему (создание и обновление) по расписанию раз в 2 минуты.

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

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

Примечание

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

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

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

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

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

Выгрузка ФИО для заказа происходит следующим образом:

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

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

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

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

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

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

1. externalId (внешний ID позиции RetailCRM) ⇒ id (ID товара в AliExpress);
2. id (ID позиции) ⇒ sku_id (артикул позиции);
3. quantity (количество) ⇒ quantity (количество);
4. initialPrice (цена позиции) ⇒ item_price (цена позиции);
5. productName (название позиции) ⇒ name (название позиции);
6. comment (комментарий к позиции) ⇒ buyer_comment (комментарий к позиции).

Имеется возможность работы с заказами без предварительной загрузки каталога в AliExpress, сформированного модулем. Для этого достаточно на странице настройки каталога активировать опцию «Использовать автоматическую привязку товаров». При обработке заказа из AliExpress модуль будет искать аналогичный товар в Системе по совпадению артикула - при успешном поиске найденный товар будет добавлен в заказ (с привязкой к каталогу), если товар не нашёлся - он будет добавлен в заказ как обычный текст (без привязки к каталогу Системы).

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

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

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

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

Выгрузка цен и остатков товаров

Опция «Активировать выгрузку остатков» позволяет выгружать остатки товаров из Системы в AliExpress отдельно от каталога. Остаток по товару собирается на основе всех указанных складов (если ни один склад не выбран, будет браться общий остаток товара).

Опция «Активировать выгрузку цен» позволяет выгружать цены товаров (базовую цену и цену со скидкой, согласно настройкам типов цен в модуле). Если в запросе указана цена со скидкой равной 0, данная цена будет удалена. Если цена в запросе не была указана, то в AliExpress данная цена соответственно изменена не будет.

Важно!

Если включена опция «Использовать автоматическую привязку товаров», то данные по товарам для выгрузки цен и остатков будут собираться на основе совпадения артикулов у товаров между системами. Если данная опция отключена,то данные будут собираться на основе сформированного модулем каталога товаров.

При выгрузке цен также существует ряд особенностей.

Торговое предложение не попадет в выгрузку, если:

• у предложения отсутствует цена, установленная в настройках модуля как базовая;
• установлена базовая цена < 0.99 руб.

Цена со скидкой будет установлена в 0, если:

• цена со скидкой составляет величину менее 10% от базовой цены;
• цена со скидкой больше, чем базовая.