Веб-сервисы — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м (Информирование системы о поступивших заказах)
(Геокодирование)
Строка 144: Строка 144:
 
== Геокодирование ==
 
== Геокодирование ==
 
[[Модуль «Карта»#Геокодирование|Геокодирование]] выполняется запросом к серверу на адрес:
 
[[Модуль «Карта»#Геокодирование|Геокодирование]] выполняется запросом к серверу на адрес:
 +
 +
О лимитах геокодирования, принципе работы читайте [[Модуль «Карта»#Геокодирование|здесь]]
  
 
http://home.courierexe.ru/geocoder
 
http://home.courierexe.ru/geocoder

Версия 12:48, 20 июня 2023

Все ссылки на дополнительные сервисы содержат экстра_код. Экстра код — это ваш уникальный код курьерской службы.

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

Калькулятор

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

Калькулятор доступен по ссылке вида home.courierexe.ru/экстра_код/calculator. Экстра-код можно посмотреть по ссылке.

Калькулятор.png

Трекинг по номеру

Позволяет отслеживать статус заказа по его номеру. Сервис доступен по ссылке вида home.courierexe.ru/экстра_код/tracking. При поиске заказа выводится таблица с подробностями. Поля таблицы настраиваются в личном кабинете курьерской службы на вкладке Поля трекинга по номеру.

Чтобы получить информацию о заказе, введите его номер в поле Код и нажмите на кнопку Найти.

Трекинг.png

Отзывы

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

Настройка получения отзывов

Например, запрос отзыва у получателя о работе курьера, доставившего заказ, работает следующим образом. Мы добавляем в карточку клиента пользовательское поле — флажок Оценка курьера. Если флажок установлен, по доставленным заказам этого клиента в определенном статусе запускается автоматическая смс-рассылка с ссылкой на форму голосования. Результаты можно вывести в отчеты и в карточку курьера. Требуется подключение модуля отправки смс-уведомлений.

Чтобы автоматизировать работу сервиса, отправьте обращение в нашу службу поддержки с ответами на следующие вопросы:

  1. Кто кому будет ставить оценку или оставлять отзыв?
    Например, это будет получатель, который оценивает работу курьера.
  2. Выберите тип отзыва:
    • оценка (в том числе в виде звёздочек);
    • комментарий;
    • оценка и комментарий;
    • отзыв типа хорошо/плохо.
      Отзыв1.PNG
  3. Когда отправлять смс получателю: когда заполнен статус доставки со слов курьера (предварительный статус доставки) или указана информация о доставке по заказу в карточке корреспонденции (окончательный статус доставки)?
  4. Пришлите текст смс для оценки качества работы. Учтите, что длина одного смс-сообщения — 160 символов латиницей или 70 символов кириллицей.
    Пример: «Здравствуйте. Оцените, пожалуйста, работу курьера <ссылка>»
  5. Добавить в карточку курьера пользовательское поле — флажок Не оценивать курьера?
    Если флажок установлен, по заказам, доставленным этим курьером, рассылки не будет. Это нужно, чтобы исключить служебных курьеров из смс-рассылки.
  6. Как вы хотите получать статистику для оценки качества работы?
    Вы можете скачать и импортировать в Отчеты > Дополнительные возможности:
    • отчет о рейтинге курьера, который будет показывать оценку в разрезе курьера за указанный период. Поля отчета: «Курьер», «Средняя оценка», «Количество оценок». Скачать;
    • сводный отчет по оценкам качества за период по доставленным корреспонденциям. Поля отчета: «Шифр», «Курьер», «Оценка», «Комментарий к оценке». Скачать.
    Если вам нужен другой отчет, пришлите пример шаблона такого отчета с описанием полей.
  7. Добавить в карточку курьера поле Рейтинг курьера? Оно показывает среднюю оценку работы курьера за последние 3 месяца:
    Оценка курьера.png

Форма отзывов (голосование)

Для работы сервиса используется ссылка на форму вида home.courierexe.ru/экстра-код/opinions с параметрами:

  • code — внутренний код сущности, которой дается оценка, в системе. Обязательный параметр.
  • rate — оценка
    . Для заказов параметр должен быть равен коду из справочника Жалобы. Для остальных типов — целое число от 1 до 5.
  • type — тип сущности, которой дается оценка. По умолчанию 3 (заказ).
  • note — признак ввода комментария. По умолчанию 1.
  • star — признак вывода в виде звёздочек. По умолчанию 1.
  • hash — значение хэша ссылки. Хэш генерируется функцией SignatureUrl. Обязательный параметр.
  • field — Пользовательское поле, для указания типа отзыва.

Примеры запросов (без хэша):

home.courierexe.ru/экстра-код/opinions?code=123456                Запрос оценки в виде звёздочек и комментария для адреса (type = 3, note = 1, star = 1).
home.courierexe.ru/экстра-код/opinions?code=123456&rate=1         Запрос комментария для адреса (оценка уже проставлена).
home.courierexe.ru/экстра-код/opinions?code=123456&star=0         Запрос оценки в виде списка и комментария для адреса.
home.courierexe.ru/экстра-код/opinions?code=123456&type=12        Запрос оценки сотрудника в виде звёздочек с комментарием.
home.courierexe.ru/экстра-код/opinions?code=123456&rate=1&note=0  Оценка выставлена, комментарий не запрашивается, сразу выводится сообщение о выставленной оценке.

Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):

home.courierexe.ru/экстра-код/o?c=123456&r=1&n=1&t=3

Информирование о поступивших заказах

Вы можете включить автоматические уведомления о заказах, поступающих из ЛК клиента или через API. Для этого в основном меню выберите Настройка > Пользователи, откройте карточку пользователя и на вкладке Настройка установите флажок Показывать окно поступивших заказов, затем нажмите ОК.

Подробнее см. раздел «Окно поступивших заказов».

Внешний интерфейс сотрудников (Staff)

Интерфейс позволяет без входа в систему MeaSoft совершать следующие действия:

Сервис доступен по ссылке вида home.courierexe.ru/экстра_код/staff.

Сотрудник должен быть зарегистрирован в системе MeaSoft как пользователь. Для входа в Staff используются те же логин и пароль, что и для входа в систему MeaSoft.

Количество доступных разделов зависит от прав пользователя.

Адреса

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

Чтобы внести информацию о доставке, нажмите на строку заказа. Откроется окно, вверху которого скан накладной, а внизу — форма для внесения данных. Заполните ее и нажмите кнопку Сохранить. Заказ исчезнет из списка адресов.

Таблица заказов содержит следующие столбцы:

# — внутренний код в Staff.

Фирма — компания получателя.

Адрес — адрес получателя.

Заказ — номер заказа с вкладки Заказы.

Номер — значение столбца Номер с вкладки Адреса.

Шифр — шифр корреспонденции.

Вверху справа можно выполнить поиск корреспонденции.

Заказ попадает в список на вкладке Адреса, если:

  • он не старше 2 месяцев;
  • в поле Инфо о доставке введено слово «Скан»;
  • к заказу прикреплен скан накладной с заполненной информацией о доставке. Имя файла должно быть «scan.jpg».

Собеседования

Пункт основного меню Собеседования предназначен для добавления и редактирования собеседований.

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

Чтобы добавить собеседование, нажмите на кнопку Добавить, в открывшемся окне внесите необходимую информацию и нажмите Сохранить.

Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения.

Колл-центр

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

Раздел Колл-центр для оператора выглядит следующим образом:

Колл-центр для оператора.png


Чтобы получить задачу на обзвон, нажмите на кнопку Получить заказ. Откроется окно следующего вида:

Проект для оператора.png

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

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

Если дозвониться не удалось, нажмите на кнопку Не дозвонились. Через 1 час заказ снова появляется в очереди задач проекта.

При нажатии на кнопку Отмена заказ сразу возвращается в очередь задач.

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

Приглашенные

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

В системе MeaSoft такой сотрудник должен быть назначен агентом, а также указан менеджером на вкладке Основное в карточке клиента
, которого он привёл. Там же в поле % менеджера указывается размер вознаграждения агента в виде процента от заказов.

Геокодирование

Геокодирование выполняется запросом к серверу на адрес:

О лимитах геокодирования, принципе работы читайте здесь

http://home.courierexe.ru/geocoder

GET-параметры:

  • geocoder — в данном параметре может использоваться как полный адрес для разбора, так и в составе других параметров
  • town — город
  • address — адрес
  • street — улица
  • home — номер дома
  • extracode — дополнительный параметр, зависит от клиента


Результатом является ответ в формате XML, например:

<?xml version="1.0" encoding="UTF-8"?>
<ymaps>
  <GeoObjectCollection>
    <featureMember>
      <GeoObject>
        <metaDataProperty>
          <GeocoderMetaData>
            <kind>house</kind>
          </GeocoderMetaData>
        </metaDataProperty>
        <name>ул. Сталеваров, 20</name>
        <Point>
          <pos>37.8389496 55.754736</pos>
          <kind>house</kind>
          <zipcode>house</zipcode>
          <distance>house</distance>
        </Point>
      </GeoObject>
    </featureMember>
  </GeoObjectCollection>
</ymaps>

Параметры ответа:

  • name — найденный адрес
  • pos — геокоординаты — долгота и широта
  • kind — найденный элемент является домом, если значение house
  • zipcode — индекс найденного объекта
  • distance — расстояние до МКАД/КАД в метрах


Ответ в случае, если адрес не геокодирован

<?xml version="1.0" encoding="UTF-8"?>
<ymaps>
  <error>
    <status>429</status>
    <message>Coordinates aren't found</message>
  </error>
</ymaps>