Важно!
Модуль интеграции с AliExpress работает по модели FBS: Доставка со склада продавца.
Интеграционный модуль AliExpress позволяет реализовать передачу следующих данных в RetailCRM:
- Заказы, в том числе их изменения.
- Клиенты. Подробную информацию по процессу синхронизации данных клиентов с RetailCRM можно посмотреть здесь.
Из RetailCRM в 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 передаётся следующим образом:
- В поле
externalId
(внешний ID заказа) передаётся полеid
(ID заказа в AliExpress). - В поле
number
(номер заказа) также передаётся ID заказа в AliExpress. - В поле
createdAt
(дата создания заказа) передаётся дата создания из AliExpress (полеcreated_at
). При этом дата и время конвертируются из временной зоны API AliExpress во временную зону вашей RetailCRM. - Статус заказа в RetailCRM (поле
status
) выставляется согласно маппингу в настройках модуля. - Заполнение фамилии (
firstName
), имени (lastName
) и отчества (patronymic
) в заказе RetailCRM работает так как указано выше. - Для контрагента заказа выставляется тип
individual
(физическое лицо). - Оплата в заказе создаётся согласно маппингу в настройках модуля. Если в маппинге не указан тип оплаты для заказов, то передачи оплаты не произойдёт. В
externalId
(внешний идентификатор) оплаты записывается значение видаpayment_{{ ID заказа AliExpress }}
(например, для заказа с ID1
в AliExpress получится такое значение внешнего кода оплаты:payment_1
). Если заказ уже оплачен, то будет передана дата оплаты (полеpaidAt
в RetailCRM), которая берётся из данных заказа (полеpaid_at
в AliExpress). - В поле адреса в произвольной форме (поле
order[delivery][address][text]
в заказе RetailCRM) записывается полный адрес доставки из поляdelivery_address
заказа AliExpress. - Стоимость доставки (поле
order[delivery][cost]
) складывается из стоимостей доставок предсплитованных отправлений (в AliExpress это полеorder[pre_split_postings][][delivery_fee]
).
Позиции заказа передаются следующим образом (указано в виде формата: поле RetailCRM ⇒ поле AliExpress):
externalId
(внешний ID позиции RetailCRM) ⇒id
(ID товара в AliExpress);id
(ID позиции) ⇒sku_id
(артикул позиции);quantity
(количество) ⇒quantity
(количество);initialPrice
(цена позиции) ⇒item_price
(цена позиции);productName
(название позиции) ⇒name
(название позиции);comment
(комментарий к позиции) ⇒buyer_comment
(комментарий к позиции).
Имеется возможность работы с заказами без предварительной загрузки каталога в AliExpress, сформированного модулем. Для этого достаточно на странице настройки каталога активировать опцию «Использовать автоматическую привязку товаров». При обработке заказа из AliExpress модуль будет искать аналогичный товар в Системе по совпадению артикула - при успешном поиске найденный товар будет добавлен в заказ (с привязкой к каталогу), если товар не нашёлся - он будет добавлен в заказ как обычный текст (без привязки к каталогу Системы).
Выгрузка изменений по заказам
При выгрузке изменений AliExpress передаёт информацию о заказе целиком. Выгрузка также выполняется с указанием даты предыдущей выгрузки, а если это первая выгрузка - данные также берутся за месяц.
Выгрузка изменений отличается от выгрузки новых заказов лишь тем, что передача изменений производится через методы редактирования заказа и оплаты, а не через методы пакетной выгрузки. Передаваемые данные и методы их формирования идентичны.
Может случиться ситуация, при которой товара в заказе нет в каталоге RetailCRM (например, вы ранее вручную создали этот товар в AliExpress). Заказ с таким товаром выгрузится в RetailCRM, однако у товара будет отсутствовать изображение и закупочная цена, а карточку товара открыть не получится. Чтобы избежать такой ситуации рекомендуем использовать каталог RetailCRM для передачи всех товаров в AliExpress.
Выгрузка цен и остатков товаров
Опция «Активировать выгрузку остатков» позволяет выгружать остатки товаров из Системы в AliExpress отдельно от каталога. Остаток по товару собирается на основе всех указанных складов (если ни один склад не выбран, будет браться общий остаток товара).
Опция «Активировать выгрузку цен» позволяет выгружать цены товаров (базовую цену и цену со скидкой, согласно настройкам типов цен в модуле). Если в запросе указана цена со скидкой равной 0, данная цена будет удалена. Если цена в запросе не была указана, то в AliExpress данная цена соответственно изменена не будет.
Важно!
Если включена опция «Использовать автоматическую привязку товаров», то данные по товарам для выгрузки цен и остатков будут собираться на основе совпадения артикулов у товаров между системами. Если данная опция отключена,то данные будут собираться на основе сформированного модулем каталога товаров.
При выгрузке цен также существует ряд особенностей.
Торговое предложение не попадет в выгрузку, если:
- у предложения отсутствует цена, установленная в настройках модуля как базовая;
- установлена базовая цена < 0.99 руб.
Цена со скидкой будет установлена в 0, если:
- цена со скидкой составляет величину менее 10% от базовой цены;
- цена со скидкой больше, чем базовая.