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

Материал из Меасофт
Перейти к: навигация, поиск
м (Отзывы)
м (Отзывы)
Строка 16: Строка 16:
  
 
== Отзывы ==
 
== Отзывы ==
Сервис позволяет запрашивать у клиентов отзывы к работе курьерской службы, в том числе к заказам, к курьерам, к сообщениям и т. д.
 
  
Чтобы настроить сервис, отправьте обращение в нашу службу поддержки с ответами на следующие вопросы:
+
Сервис позволяет запрашивать у клиентов отзывы о работе курьерской службы, в том числе о заказах, о работе курьера, о работе менеджера и т. д.
# Кто кому будет ставить оценку или оставлять отзыв?<br>Например, это будет получатель, который оценивает доставку курьера.
+
 
# Добавить в карточку клиента пользовательское поле — флажок '''Оценка курьера'''?<br>Если флажок установлен, по доставленным заказам этого клиента запускается автоматическая смс-рассылка с ссылкой на форму голосования. Требуется подключение [[Модуль отправки SMS-сообщений|модуля отправки смс-уведомлений]].
+
=== Настройка получения отзывов ===
## Выберите тип отзыва:
+
 
##* оценка (в том числе в виде звёздочек);
+
Например, запрос отзыва у получателя о работе курьера, доставившего заказ, работает следующим образом. Мы добавляем в карточку клиента пользовательское поле — флажок '''Оценка курьера'''. Если флажок установлен, по доставленным заказам этого клиента в определенном статусе запускается автоматическая смс-рассылка с ссылкой на форму голосования. Результаты можно вывести в отчеты и в карточку курьера. Требуется подключение [[Модуль отправки SMS-сообщений|модуля отправки смс-уведомлений]].
##* комментарий;
+
 
##* оценка и комментарий;
+
Чтобы автоматизировать работу сервиса, отправьте обращение в нашу службу поддержки с ответами на следующие вопросы:
##* отзыв типа хорошо/плохо.[[Файл:Отзыв1.PNG|none|500 px]]
+
# Кто кому будет ставить оценку или оставлять отзыв?<br>Например, это будет получатель, который оценивает работу курьера.
## Что будет триггером для отправки смс статус со слов курьера или заполненное инфо о доставке по заказу?
+
# Выберите тип отзыва:
## Пришлите текст смс для оценки качества работы.
+
#* оценка (в том числе в виде звёздочек);
 +
#* комментарий;
 +
#* оценка и комментарий;
 +
#* отзыв типа хорошо/плохо.[[Файл:Отзыв1.PNG|none|500 px]]
 +
# Когда отправлять смс получателю: когда заполнен статус доставки со слов курьера (предварительный статус доставки) или указана информация о доставке по заказу в карточке корреспонденции (окончательный статус доставки)?
 +
# Пришлите текст смс для оценки качества работы. Учтите, что длина одного смс-сообщения — 160 символов латиницей или 70 символов кириллицей. <br>Пример: «Здравствуйте. Оцените, пожалуйста, работу курьера <ссылка>»
 
# Добавить в карточку курьера пользовательское поле — флажок '''Не оценивать курьера'''?<br>Если флажок установлен, по заказам, доставленным этим курьером, рассылки не будет. Это нужно, чтобы исключить служебных курьеров из смс-рассылки.
 
# Добавить в карточку курьера пользовательское поле — флажок '''Не оценивать курьера'''?<br>Если флажок установлен, по заказам, доставленным этим курьером, рассылки не будет. Это нужно, чтобы исключить служебных курьеров из смс-рассылки.
# Как вы хотите получать статистику для оценки качеств работы? Можем добавить для вас отчеты:
+
# Как вы хотите получать статистику для оценки качества работы? <br>Можем добавить для вас отчеты:
 
#* отчет о рейтинге курьера, который будет показывать оценку в разрезе курьера за указанный период;
 
#* отчет о рейтинге курьера, который будет показывать оценку в разрезе курьера за указанный период;
 
#* сводный отчет по оценкам качества за период по доставленным корреспонденциям.  
 
#* сводный отчет по оценкам качества за период по доставленным корреспонденциям.  
Строка 35: Строка 39:
 
# Добавить в карточку курьера поле '''Рейтинг курьера'''? Оно показывает среднюю оценку работы курьера за последние 3 месяца.
 
# Добавить в карточку курьера поле '''Рейтинг курьера'''? Оно показывает среднюю оценку работы курьера за последние 3 месяца.
  
Для работы сервиса сформируйте ссылку вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
+
=== Форма отзывов ===
  
* '''code''' — внутренний код сущности в системе. Обязательный параметр.
+
Для работы сервиса используется ссылка на форму вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
 +
 
 +
* '''code''' — внутренний код сущности, которой дается оценка, в системе. Обязательный параметр.
 
* '''rate''' — <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой — rate = 5. Таким образом формируется тип отзыва «хорошо/плохо», когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов — целое число от 1 до 5.
 
* '''rate''' — <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой — rate = 5. Таким образом формируется тип отзыва «хорошо/плохо», когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов — целое число от 1 до 5.
* '''type''' — тип сущности. По умолчанию 3 (заказ).
+
* '''type''' — тип сущности, которой дается оценка. По умолчанию 3 (заказ).
 
* '''note''' — признак ввода комментария. По умолчанию 1.
 
* '''note''' — признак ввода комментария. По умолчанию 1.
 
* '''star''' — признак вывода в виде звёздочек. По умолчанию 1.
 
* '''star''' — признак вывода в виде звёздочек. По умолчанию 1.
 
* '''hash''' — значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметр.
 
* '''hash''' — значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметр.
 
* '''field''' — Пользовательское поле, для указания типа отзыва.
 
* '''field''' — Пользовательское поле, для указания типа отзыва.
 
  
 
Примеры запросов (без хэша):
 
Примеры запросов (без хэша):
  
'''home.courierexe.ru/экстра-код/opinions?code=123456''' Запрос оценки в виде звёздочек и комментария для адреса (type = 3, note = 1, star = 1).
+
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&rate=1''' Запрос комментария для адреса (оценка уже проставлена).
+
home.courierexe.ru/экстра-код/opinions?code=123456&star=0         Запрос оценки в виде списка и комментария для адреса.
 
+
home.courierexe.ru/экстра-код/opinions?code=123456&type=12       Запрос оценки сотрудника в виде звёздочек с комментарием.
'''home.courierexe.ru/экстра-код/opinions?code=123456&star=0''' Запрос оценки в виде списка и комментария для адреса.
+
home.courierexe.ru/экстра-код/opinions?code=123456&rate=1&note=0 Оценка выставлена, комментарий не запрашивается, сразу выводится сообщение о выставленной оценке.
 
 
'''home.courierexe.ru/экстра-код/opinions?code=123456&type=12''' Запрос оценки сотрудника в виде звёздочек с комментарием.
 
 
 
'''home.courierexe.ru/экстра-код/opinions?code=123456&rate=1&note=0''' Оценка выставлена, комментарий не запрашивается, сразу выводится сообщение о выставленной оценке.
 
 
 
  
 
Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):
 
Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):

Версия 12:26, 16 августа 2021

Калькулятор
Трекинг по номеру

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

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

Калькулятор

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

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

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

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

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

Отзывы

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

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

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

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

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

Форма отзывов

Для работы сервиса используется ссылка на форму вида 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

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

Подключение окна уведомлений о заказах

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

В результате у выбранного пользователя в системе MeaSoft каждые 10 минут будет появляться окно со списком новых заказов и двумя кнопками: "Перейти (Прочитан)" и "Закрыть".

Чтобы временно скрыть окно, нажмите кнопку "Закрыть".

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

Чтобы очистить список заказов из окна уведомлений, нажмите кнопку "Прочитан".

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

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

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

Сервис доступен по ссылке вида home.courierexe.ru/экстра_код/staff. Для входа используются те же логин и пароль, что и для входа в систему MeaSoft
.

Адреса

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

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

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

# - внутренний код staff’а.

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

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

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

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

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

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

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

  1. Он не старше 2 месяцев.
  2. В поле "Инфо о доставке" введено слово "Скан".
  3. К заказу прикреплен скан накладной с заполненной информацией о доставке. Имя файла должно быть "scan.jpg".

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

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

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

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

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


Колл-центр

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

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

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

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

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

Справа отображается название проекта и скрипт звонка, слева — форма для просмотра и редактирования данных заказа.

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

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

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

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

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

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

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

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

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

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>