Инструкция по Модулю
для Мегаплана
"Почта России"
Создание и отслеживание отправления
в аккаунте сервиса Почта России из Сделок
#ДелаемМегапланЛучшеВместе
МОДУЛЬ ПОЧТА РОССИИ — позволяет создавать и отслеживать отправления в аккаунте сервиса Почта России из сделок.
ПОШАГОВАЯ НАСТРОЙКА
Шаг 1. Регистрация, Авторизация

Для установки модуля, необходимо зарегистрироваться в сервисе https://beta.polytell.ru , пройти авторизацию своего аккаунта Мегаплана и произвести предварительные общие настройки для модулей Polytell, согласно инструкции.
Шаг 2. Подключение модуля

Следующим шагом, подключаем модуль Почта России.
Можно использовать Тестовый период (14 дней) или оплатить модуль.


Как оплатить модуль ►
Оплату можно сделать на сайте, методом списания стоимости модуля со своего персонального счёта, нажав кнопку "Купить". Если средств на персональном счету будет не достаточно для оплаты модуля, то появится окно с предложением пополнить персональный счёт с помощью платёжных систем через банковскую карту или вариант безналичной оплаты (реквизиты компании нужно будет потом отправить своему менеджеру, чтобы он подготовил счёт).
Замечание. После подключения модуля, отобразится его оплаченный период. Когда он закончится, с персонального
счёта будет автоматически списываться стоимость модуля за 1 месяц, при условии достаточности на нём средств.
Если использование данного модуля больше не предполагается — можно его отключить в Polytell Market.
Если планируется подключить модуль больше чем на 1 месяц, то можно отправить запрос своему менеджеру с просьбой выставить счёт на нужный период.
Шаг 3. Выполняем настройку модуля Почта России

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


После указания авторизационных данных, нажимаем кнопку "Сохранить".
Под блоком авторизации в ЛК Почты России — отображаются схемы сделок, загруженные в Polytell из Мегаплана.
Для того, чтобы из них можно было создавать и отслеживать статус Отправления, нужно нажать кнопку редактирования и сопоставить соответствующие поля этой схемы с полями Отправления Почты России (предварительно, нужные поля должны быть добавлены в схему сделок Мегаплана).

Соответствие типов полей в схеме сделки Мегаплана:
Фамилия получателя — Строка
Имя получателя — Строка
Отчество получателя — Строка
Код страны — Число
Тип адреса — Строка
Почтовый индекс — Строка
Область, регион — Строка
Район — Строка
Населенный пункт — Строка
Микрорайон — Строка
Часть адреса: Улица — Строка
Часть адреса: Номер здания — Строка
Часть здания: Дробь — Строка
Часть здания: Литера — Строка
Часть здания: Строение — Строка
Часть здания: Корпус — Строка
Часть здания: Номер — Строка
Название гостиницы — Строка
Номер для а/я, войсковая часть, войсковая часть ЮЯ, полевая почта — Строка
Вес РПО (в граммах) — Число
Сумма наложенного платежа (копейки) — Число
Сумма объявленной ценности (копейки) — Число
Категория РПО — Строка
Вид РПО — Строка
Телефон получателя — Строка
Номер заказа. Внешний идентификатор заказа, который формируется отправителем — Строка
Отметка Осторожно/Хрупкое — Да/Нет
Дата расчета — Дата
Линейная длина (сантиметры) — Число
Линейная ширина (сантиметры) — Число
Линейная высота (сантиметры) — Число
Внутренний идентификатор отправления — Строка
ШПИ — Строка
Стоимость доставки — Число
Название операции — Строка
Название атрибута — Строка
Шаг 4. Настраиваем сценарии для модуля Почта России

Чтобы создавать сценарии для модуля Почта России прямо в настройках схемы сделок Мегаплана, должен быть подключен виджет Управление сценариями в общих настройках Polytell, согласно инструкции.
В Мегаплане, заходим в Настройку схемы сделок и в разделе "Сценарии" находим тот, в который нужно добавить ссылку на запрос к сервису Почта России или добавляем новый сценарий.
Добавляем в сценарий Действие
"Запрос к внешнему сервису".


Нажимаем кнопку
"Создать сценарий Polytell".
Выбираем модуль Почта России.
В зависимости от того, что будет выполнять этот сценарий, в блоке Адрес для запроса выбираем тип запроса к сервису Почта России:
  • Url для отправки данных в личный кабинет почты россии — для запросов создания нового Отправления в ЛК Почта России.
  • Url для получения ТТН и стоимости от почты россии по отправлению — для запросов получения номера ШПИ и стоимости доставки отправления.

  • Url для отслеживания состояния отправления — для запросов получения статуса отправления в сервисе Почта России.
Затем нажимаем кнопку Создать и для сохранения этого сценария в Мегаплане, нажимаем кнопку Сохранить.
Шаг 5. Проверяем работу модуля Почта России
После настройки соответствующих сценариев в схеме сделки Мегаплана, можно проверять работу запросов к сервису "Почта России" из сделок.
При запуске этих сценариев — в сделке Мегаплана отобразятся комментарии с результатом запроса и в поля сделки запишутся полученные значения.

Например, если был выполнен сценарий


с Url для отправки данных в личный кабинет, то после удачного создания отправления, в комментарий сделки запишется уведомление: "Данные переданы для обработки в Почту России" и в сопоставленное в настройках модуля поле сделки запишется соответствующее значение для "Внутренний идентификатор отправления".
По ссылке из этого комментария нужно перейти в свой аккаунт сервиса "Почта России" и провести созданное новое отправление к сдаче.
После выполнения этой операции, можно отправлять запрос получения номера Штрихового Почтового Идентификатора и его стоимости доставки "Url для получения ТТН и стоимости...".
Если сценарий с этим запросом выполнить без проведения отправления к сдаче, то в комментарий сделки запишется ошибка запроса
"Ошибка получения ШПИ...".

Если отправление было проведено к сдаче и запрос "Url для получения ТТН и стоимости от почты..." был выполнен успешно,
то в комментарий сделки запишется уведомление: "ШПИ успешно получен и записан в сделку" (Каждому почтовому отправлению присваивается номер ШПИ — штриховой почтовый идентификатор, подтверждающий факт отправки почтового отправления).
Полученные значения записываются в указанные в настройках модуля поля сделки ШПИ и Стоимость доставки.
Теперь — можно начать отслеживать статус отправления, запуская сценарий с "Url для отслеживания состояния отправления".
После успешного выполнения данного запроса — в сделку запишется комментарий "Статус отправления получен" и его значения запишутся в поля сделки, указанные в настройках модуля: Название операции и Название атрибута.
Например, если клиент уже получил отправление в отделении почты, то результат запроса с "Url для отслеживания состояния отправления" будет таким: в поле "Название операции" изменится значение с "Обработка" на "Вручение",
а поле "Название атрибута" изменится с "Прибыло в место вручения" на "Вручение адресату".
Оставьте заявку на
консультацию или покупку
#МегапланДелаемЛучшеВместе
Нажимая на кнопку, вы соглашаетесь на обработку персональных данных
и политикой конфиденциальности