Интеграция с дилерским аккаунтом Emex

Содержание

В PARTS SOFT можно настроить интеграцию с дилерским аккаунтом Emex через API, подключив поставщика Emex как маркетплейс.

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

Заказы из Emex подгружаются в систему как клиентские заказы и оформляются на специально выбранного контрагента в системе.

Функционал предназначен для поставщиков, работающих с дилерскими аккаунтами Emex.

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

Запрос доступа

ШАГ 1. Свяжитесь с представителем Emex по адресу co@emex.ru и запросите доступ к веб-сервису Emex для вашего IP.

Пример письма с указанием IP-адреса можно найти в форме подключения веб-сервиса Emex. Для этого в панели администрирования перейдите в раздел Прайсы → Веб-сервисы, нажмите кнопку Подключить и выберите Emex и нажмите Продолжить. На открывшейся странице

Интеграция с дилерским аккаунтом Emex иллюстрация №1

Пример письма с указанием IP-адреса

Настройка на стороне Emex

ШАГ 1. Войдите в свой дилерский аккаунт на Emex.

ШАГ 2. Найдите заказ, с которого хотите начать подгрузку заказов в систему PARTS SOFT.

Откройте карточку заказа и скопируйте GlobalID, он понадобится вам для настройки загрузки заказов.

Интеграция с дилерским аккаунтом Emex иллюстрация №3

Global ID в информации о заказе

ШАГ 3. Найдите в личном кабинете или уточните у вашего менеджера Emex Location ID вашего магазина или пункта выдачи.

Если у вас несколько пунктов выдачи, понадобятся Location ID каждого из них.

Настройка на стороне PARTS SOFT

Чтобы подключить поставщика Emex как маркетплейс, выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Маркетплейсы и в списке доступных сервисов выберите логотип Emex Дилерский. Нажмите кнопку ОК в окошке подтверждения.

Интеграция с дилерским аккаунтом Emex иллюстрация №3

Переход к подключению Emex

ШАГ 2. На открывшейся странице задайте следующие настройки:

Таблица 1. Настройки интеграции с маркетплейсом Emex
№	Название настройки	Описание
1	Название	Укажите название маркетплейса. Указанное название будет отображаться в панели администрирования.
2	Аккаунт активен	Активируйте опцию, чтобы маркетплейс стал доступен для работы.
3	Регион подключения	Выберите регион, в котором будет доступен маркетплейс. Если оставить это поле пустым, маркетплейс будет доступен во всех регионах.
4	Логин	Укажите логин от вашего дилерского аккаунта Emex. Убедитесь, что вы не указали логин от клиентского аккаунта.
5	Пароль	Укажите пароль от вашего дилерского аккаунта Emex. Убедитесь, что вы не указали пароль от клиентского аккаунта.
6	Стартовый global_id	Укажите GlobalID, который вы скопировали в карточке заказа в личном кабинете Emex. С заказа с этим ID начнётся загрузка заказов из Emex в систему. Если оставить это поле пустым, загрузка начнётся с самого первого заказа в Emex. При большом количестве заказов могут загрузиться не все заказы.
7	Последний timestamp	Заполняется системой автоматически при каждой подгрузке заказов. Не редактируйте значения в этом поле. Используется только в случае, если нужно сбросить загрузку, например, при возникновении ошибок. При необходимости очистить поле рекомендуем обратиться в тех.поддержку PARTS SOFT во избежание ошибок интеграции.
8	Выберите прайс-лист, к которому закрепятся заказы	Выберите прайс-лист, на который будут оформляться заказы, получаемые из маркетплейса.
9	Источник загрузки заказов из Emex	Выберите источник загрузки заказов из маркетплейса в систему.
10	Связанный контрагент	Выберите контрагента, на которого будут оформляться заказы, получаемые с маркетплейса Emex. Рекомендуем создать отдельного контрагента для заказов с Emex.
11	Грузить только Price logo (через запятую)	Перечислите sup_logo прайс-листов Emex (через запятую), если требуется загружать в систему заказы только из этих прайс-листов. Узнать sup_logo можно в личном кабинете Emex.
12	PriceLogo использовать как желаемый прайс-лист при автообработке заказа	Активируйте опцию, если требуется, чтобы прайс-листы, перечисленные в поле Грузить только Price logo (через запятую), считались желаемыми при автообработке заказа.
13	Адрес API поставок Emex	Укажите API-адрес поставок Emex.
14	Токен API поставок Emex	Укажите API-токен, с помощью которого будет выполняться подключение и передача данных.

Нажмите кнопку Сохранить.

Интеграция с дилерским аккаунтом Emex иллюстрация №4

Настройки интеграции с маркетплейсом Emex

После сохранения основных настроек будет доступна настройка автоматической обработки заказов — выполните настройку, если требуется.

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

Для настройки соответствия между статусами заказа в системе и заказов на маркетплейсе Emex, выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Маркетплейсы и в строке маркетплейса Emex нажмите кнопку Статусы.

Интеграция с дилерским аккаунтом Emex иллюстрация №5

Переход к настройке соответствия статусов

ШАГ 2. На открывшейся странице настройте соответствие статусов. Настройка аналогична настройке соответствия статусов для веб-сервисов.

Веб-сервисы. Настройки, подсклады, синхронизация статусов иллюстрация №15

Соответствие статусов

Запрос отправится в Emex как только все позиции заказа перейдут в статус подтверждения или отказа.

Подтверждение отправляется с количеством больше 0, отказ — с количеством 0.

Настройка пунктов выдачи

Для каждого отдельного магазина или отдельного пункта выдачи Emex необходимо создать отдельный пункт выдачи заказов в системе. Для этого выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Справочники → Пункты выдачи и нажмите кнопку Создать.

ШАГ 2. На открывшейся странице задайте настройки ПВЗ.

В поле Emex Location ID обязательно укажите Location ID, который вы получили от менеджера Emex или скопировали в личном кабинете.

Это необходимо, чтобы заказы с вашего дилерского аккаунта Emex распределялись между настроенными пунктами выдачи.

Если не указать Location ID для какого-либо пункта выдачи Emex в системе, заказы в данный ПВЗ не будут подгружаться из Emex.

Сохраните изменения.

Интеграция с дилерским аккаунтом Emex иллюстрация №7

Опция Emex Location ID в настройках ПВЗ

Обработка получаемых заказов

Загрузка заказов производится каждые 15 минут.

Заказы поставщику в разделе Заказы поставщику → Группы формируются по одному на каждую позицию. Заказы сразу открываются и закрываются. Такую схему обработки заказов поставщику используется для того, чтобы в дальнейшем вы могли загружать накладные к заказам (инвойсы).

Интеграция с дилерским аккаунтом Emex иллюстрация №8

Статусы заказов

Увидеть позиции, которые попали в сформированные заказы поставщику, можно в разделе Заказы клиента → Все.

Для таких позиций будут указаны:

прайс-лист, который вы выбрали при настройке интеграции;
отметка, что заказ был создан с помощью интеграции;
GlobalID заказа, который вы указали при настройке интеграции;
Статус, установленный согласно настроенным вами правилам соответствия статусов заказов.

Интеграция с дилерским аккаунтом Emex иллюстрация №11

Информация о подгруженых заказах

Отправка накладных в Emex

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

Отправка накладной в Emex выполняется в карточке накладной — с помощью кнопки Отправить в маркетплейс.

В карточке накладной также доступна история отправок накладной в Emex. На странице истории отправок можно увидеть статус, дату отправки, request и response.

Вы также можете отправить в Emex выгрузку по API (аналогично отправке выгрузки Яндекс.Маркет).