Модуль «ПЭК»

Возможности модуля

Интеграция с ПЭК позволяет:

  • Рассчитать предварительную стоимость доставки
  • Оформлять заявку на доставку или авиаперевозку
  • Создавать заявки с помощью предварительного оформления
  • Отображать в системе актуальные статусы доставок и задавать соответствия статусов доставки статусам заказа
  • Указывать плательщика и необходимые услуги по заказу

Установка модуля

Для успешной установки модуля «ПЭК» необходимо:

  1. Создать API-ключ;
  2. Активировать интеграцию и перейти в личный кабинет модуля «ПЭК»;
  3. В личном кабинете модуля указать необходимые настройки интеграции.

Описание подключения модуля интеграции

Создание API-ключа в RetailCRM

Для работы модуля необходимо создать новый API-ключ в системе RetailCRM. Для этого перейдите в раздел настроек: «Настройки | Интеграция | Ключи доступа к API». На данной странице настроек нажмите кнопку «Добавить».

Примечаниекрайне не рекомендуется использовать уже существующий API-ключ в системе. Для каждой интеграции и подключения по API используйте разные API-ключи!

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

Перейдите в раздел настроек: «Настройки | Интеграция | Маркетплейс» и найдите модуль «ПЭК». Активируйте его и перейдите в личный кабинет модуля для дальнейших настроек, нажав на кнопку «Перейти в личный кабинет».

В личном кабинете модуля необходимо будет заполнить информацию, запрашиваемую на двух вкладках: «Подключение» и «Спецификации товара».

На вкладке «Подключение» представлены три кнопки, которые содержат обязательные поля для заполнения.

В полях кнопки «Настройки подключения ПЭК» необходимо указать данные ПЭК:

  • ПЭК логин: логин от главного ЛК ПЭК
  • ПЭК api-ключ: ключ, созданный вами ранее в RetailCRM.

В полях кнопки «Настройки подключения CRM» необходимо указать данные RetailCRM:

  • Адрес CRM: адрес вашей системы формата https://crmagent.retailcrm.ru;
  • API ключ: ключ, созданный вами ранее в RetailCRM.

В полях кнопки «Дополнительные данные подключения» необходимо указать данные контактного лица, на которое оформлен договор и ЛК ПЭК:

На вкладке «Спецификации товара»  необходимо настроить соответствия свойств товаров из RetailCRM с предложенными вариантами.

В обязательном порядке, согласно законодательству по правилам оформления кассовых чеков, должны быть сопоставлены следующие значения:

  • Поставщик — наименование поставщика товара, который будет указан в кассовом чеке в качестве поставщика.;
  • ИНН поставщика;
  • Номер поставщика — номер телефона для связи с поставщиком.

  • Мера количества предмета расчета;
  • Товарная группа маркированного товара.

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

«Мера количества предмета расчета» заполняется в том случае, если у вас присутствуют товары разных весовых мер. Данное поле не является обязательным к заполнению.

Как добавить в каталог свойства товаров, необходимые для заполнения вкладки «Спецификации товара»

Все свойства должны быть добавлены в каталог RetailCRM через тег <param></param>.

Важно: в обработке данных НЕ участвуют базовые свойства товаров из RetailCRM!

Ниже приведены примеры оформления данных свойств в каталоге RetailCRM.

Поставщик: <param name = Поставщик>ООО «Чей Товар»</param>

ИНН поставщика: <param name = ИНН поставщика>7712345678</param>

Номер поставщика: <param name = Номер поставщика>79031112255</param>

Мера количества предмета расчета имеет следующие допустимые значения:

  • 0 — (шт)
  • 10 — г(Грамм),
  • 11 — кг(Килограмм),
  • 12 — т(Тонна),
  • 20 — см(Сантиметр),
  • 21 — дм(Дециметр),
  • 2 — м(Метр),
  • 30 — кв.см(Квадратный сантиметр),
  • 31 — кв.дм(Квадратный дециметр),
  • 32 — кв.м(Квадратный метр),
  • 40 — мл(Миллилитр),
  • 41 — л(Литр),
  • 42 — куб.м(Кубический метр),
  • 255 — Применяется при использовании иных единиц измерения

Итоговый вид свойства товара будет выглядеть следующим образом: <param name = Мера количества предмета расчета>10</param> , если товар исчисляется в граммах или <param name = Мера количества предмета расчета>0</param>, если в штуках.

Товарная группа маркированного товара имеет следующие допустимые значения:

  • 1 — lp — Текстиль,
  • 2 — shoes – Обувь,
  • 4 — perfumery – Парфюм,
  • 5 — tires – Шины,
  • 6 — electronics – Фото,
  • 9 — bicycle – Велосипеды,
  • 10 — wheelchairs — Медицинские изделия,
  • 17 — bio – БАДЫ,
  • 19 — antiseptic – Антисептики.

Итоговый вид свойства товара будет выглядеть следующим образом: <param name = Товарная группа маркированного товара>1</param> , если текстиль или <param name = Товарная группа маркированного товара>9</param>, если велосипед.

Поля модуля

Все поля, отмеченные звездочкой обязательны к заполнению по требованию ПЭК.
Названия полей идентичны полям в вашем ЛК ПЭК.
Значения полей можно уточнить у вашего менеджера ПЭК

Вес и габариты:
Указывайте корректные значения

Чекбокс “не отправлять данные в службу доставки”
Этот чекбокс позволяет не отправлять данные в СД до того момента пока вы не согласуете все необходимые нюансы заказа с вашим получателем. Как только чекбокс снят — создается заявка в ПЭК

Плательщик — платит за услуги доставки
-Отправитель
-Получатель

Упаковки beta-версия
Если выбираете несколько упаковок то значения веса, габаритов должны быть заполнены у каждой упаковки. Все единицы товара должны быть распределены по упаковкам.
Если вы не отметите количество упаковок, то по умолчанию она будет одна в заказе.
Сейчас работа с упаковками находится на стадии разработки. В retailCRM создаются упаковки, размеры и вес упаковок складываются и передаются в ПЭК (в виде одной упаковки с суммарными размерами и весов, посчитанными модулем)
На данный момент пользоваться упаковками не рекомендуется.

Расчет тарифа
Для расчета тарифа необходимо корректно заполнить все обязательные поля блока доставки

Тип услуги ПЭК
Позволяет выбрать тип создаваемой на стороне ПЭК заявки:

  1. заявка на забор груза
  2. предварительное оформление на доставку.

Данные, влияющие на стоимость

Данные, влияющие на стоимость — позволяет выбрать дополнительные услуги (будут влиять на стоимость доставки):

  1. Необходим забор день в день — позволяет указать необходимость забора груза по дате доставки, указанной в CRM;
  2. Страховка груза — позволяет застраховать груз;
  3. Необходим забор груза у отправителя — позволяет указать необходимость забора груза у отправителя силами доставки ПЭК;
  4. Необходима доставка по городу получателя* — позволяет указать необходимость доставки груза по указанному адресу получателя силами доставки ПЭК;

*Если выставлена данная услуга, то отправка будет осуществляться до адреса указанного клиентом, если не указана то будет осуществляться доставка до терминала.

Дополнительные услуги отправителя

Доп. услуги отправителя — можно выбрать необходимые дополнительные услуги при доставки по Москве при заборе груза у отправителя:

  1. Доп. услуги не нужны;
  2. Перевозка по Садовому Кольцу;
  3. Перевозка по Московской Окружной ЖД;
  4. Перевозка по Третьему Транспортному Кольцу.

Доп. услуги получателя — можно выбрать необходимые дополнительные услуги при доставки по Москве для доставки груза получателю:

  1. Доп. услуги не нужны
  2. Перевозка по Садовому Кольцу
  3. Перевозка по Московской Окружной ЖД
  4. Перевозка по Третьему Транспортному Кольцу

Оба параметра влияют на стоимость доставки

Общие данные доставки

Общие данные доставки — позволяет выбрать дополнительные услуги для самой доставки:
(значения услуг уточняйте у вашего менеджера ПЭК)

  1. Хрупкий груз — влияет на стоимость;
  2. Стекло;
  3. Жидкость — влияет на стоимость;
  4. Другой груз;
  5. Необходима открытая машина;
  6. Необходима боковая погрузка;
  7. Жесткая упаковка;
  8. Ответственное хранение;
  9. За услуги платит получатель сверх суммы НП
  10. Необходима погрузка силами ПЭК
  11. Необходима разгрузка силами ПЭК
  12. Пломбировка
  13. Упаковка стреппинг-лентой
  14. Возврат документов

Форма оплаты — необходимый параметр для типа заявки «Предварительное оформление». Позволяет указать, каким образом будет осуществлена оплата доставки — через банк или в кассу. Если не указано, по-умолчанию передается «Банк».

Личные данных получателя

Данный блок обязателен (по требованию ПЭК) к заполнению и необходим для указания личных данных получателя и его документа (на основе этих данных производится выдача товара клиенту, с его предварительной идентификацией по ним).
«Служебное поле для других документов (кроме паспорта)» заполняется при необходимости (можно оставить пустым), если выбран любой удостоверяющий личность документ, кроме паспорта гражданина РФ.

Системные поля

Данные поля являются служебными (заполняются автоматически модулем интеграции после подсчета стоимости доставки — выбора тарифа на доставку), их редактирование вручную может повлечь за собой некорректное создание доставки в системе ПЭК.

Если при подключение модуля возникли вопросы или вы наблюдаете нестабильную работу обмена:
1. приготовьте номер проблемного заказа,
2. адрес вашей retailCRM, логин/пароль,
3. логин/пароль к Личному Кабинету службы доставки или Маркетплейса.

Далее обратитесь в поддержку на нашем сайте