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

Материал из Меасофт
Перейти к: навигация, поиск
(Геокодирование)
 
(не показано 48 промежуточных версий 6 участников)
Строка 1: Строка 1:
[[Файл:калькулятор.png|right|300×100px|thumb|Калькулятор]]
+
Все ссылки на дополнительные сервисы содержат '''экстра_код'''. Экстра код — это ваш уникальный [[Личный кабинет курьерской службы#Подключение|код курьерской службы]].
[[Файл:трекинг.png|right|300px|thumb|Трекинг по номеру]]
 
Все ссылки на дополнительные сервисы содержат экстра_код. Экстра код - это ваш уникальный [[Личный кабинет курьерской службы#Подключение|код курьерской службы]].
 
  
Дополнительными сервисами может воспользоваться любой клиент курьерской службы. Для этого ему не нужно иметь доступ в [[Личный кабинет|личный кабинет]], достаточно перейти по нужной ссылке.  
+
Дополнительными сервисами может воспользоваться любой клиент курьерской службы. Для этого ему не нужно иметь доступ в [[личный кабинет]], достаточно перейти по нужной ссылке.
  
==Калькулятор==
+
== Калькулятор ==
"Калькулятор" доступен по ссылке вида '''home.courierexe.ru/экстра_код/calculator'''. Сервис предназначен для расчета стоимости доставки, работает аналогично [[Личный кабинет курьерской службы#Настройка пункта "Калькулятор"|калькулятору]] в личном кабинете.
+
Сервис предназначен для расчета стоимости доставки, работает аналогично [[Личный кабинет клиента#Калькулятор|калькулятору]] в личном кабинете.
  
==Трекинг по номеру==
+
Калькулятор доступен по ссылке вида '''home.courierexe.ru/экстра_код/calculator'''. Экстра-код можно посмотреть [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|по ссылке]].
"Трекинг по номеру" позволяет отслеживать заказ по его номеру. Сервис доступен по ссылке вида '''home.courierexe.ru/код_экстра_клиента/tracking'''.  
+
[[Файл:калькулятор.png|none|450 px]]
  
Чтобы получить информацию о заказе, введите его номер в поле "Код" и нажмите кнопку "Найти".
+
== Трекинг по номеру ==
 +
Позволяет отслеживать статус заказа по его номеру. Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/tracking'''. При поиске заказа выводится таблица с подробностями. Поля таблицы настраиваются в [[Личный кабинет курьерской службы#Настройка личного кабинета клиента|личном кабинете курьерской службы]] на вкладке '''Поля трекинга по номеру'''.
  
==Отзывы==
+
Чтобы получить информацию о заказе, введите его номер в поле '''Код''' и нажмите на кнопку '''Найти'''.
  
Сервис позволяет запрашивать у клиентов отзывы к работе курьерской службы, в том числе к заказам, к курьерам, к сообщениям и т.д.  
+
[[Файл:трекинг.png|none|900px]]
  
Отзывы могут быть нескольких типов:
+
== Отзывы ==
 +
Сервис позволяет запрашивать у клиентов отзывы о работе курьерской службы, в том числе о заказах, о работе курьера, о работе менеджера и т. д.
  
* оценка в виде звёздочек;
+
=== Настройка получения отзывов ===
* комментарий;
+
Например, запрос отзыва у получателя о работе курьера, доставившего заказ, работает следующим образом. Мы добавляем в карточку клиента пользовательское поле — флажок '''Оценка курьера'''. Если флажок установлен, по доставленным заказам этого клиента в определенном статусе запускается автоматическая смс-рассылка с ссылкой на форму голосования. Результаты можно вывести в отчеты и в карточку курьера. Требуется подключение [[Модуль отправки SMS-сообщений|модуля отправки смс-уведомлений]].
* оценка и комментарий;
 
* отзыв типа хорошо/плохо.
 
  
Для работы сервиса сформируйте ссылку вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
+
Чтобы автоматизировать работу сервиса, отправьте обращение в нашу службу поддержки с ответами на следующие вопросы:
 +
# Кто кому будет ставить оценку или оставлять отзыв?<br>Например, это будет получатель, который оценивает работу курьера.
 +
# Выберите тип отзыва:
 +
#* оценка (в том числе в виде звёздочек);
 +
#* комментарий;
 +
#* оценка и комментарий;
 +
#* отзыв типа хорошо/плохо.[[Файл:Отзыв1.PNG|none|450 px]]
 +
# Когда отправлять смс получателю: когда заполнен статус доставки со слов курьера (предварительный статус доставки) или указана информация о доставке по заказу в карточке корреспонденции (окончательный статус доставки)?
 +
# Пришлите текст смс для оценки качества работы. Учтите, что длина одного смс-сообщения — 160 символов латиницей или 70 символов кириллицей. <br>Пример: «Здравствуйте. Оцените, пожалуйста, работу курьера <ссылка>»
 +
# Добавить в карточку курьера пользовательское поле — флажок '''Не оценивать курьера'''?<br>Если флажок установлен, по заказам, доставленным этим курьером, рассылки не будет. Это нужно, чтобы исключить служебных курьеров из смс-рассылки.
 +
# Как вы хотите получать статистику для оценки качества работы? <br>Вы можете скачать и импортировать в '''Отчеты''' > '''Дополнительные возможности''':
 +
#* отчет о рейтинге курьера, который будет показывать оценку в разрезе курьера за указанный период. Поля отчета: «Курьер», «Средняя оценка», «Количество оценок». [https://www.courierexe.ru/download/Report1.xml Скачать];
 +
#* сводный отчет по оценкам качества за период по доставленным корреспонденциям. Поля отчета: «Шифр», «Курьер», «Оценка», «Комментарий к оценке». [https://www.courierexe.ru/download/Report2.xml Скачать].
 +
#: Если вам нужен другой отчет, пришлите пример шаблона такого отчета с описанием полей.
 +
# Добавить в карточку курьера поле '''Рейтинг курьера'''? Оно показывает среднюю оценку работы курьера за последние 3 месяца:[[Файл:Оценка курьера.png|none|500 px]]
  
*'''code''' - внутренний код сущности в системе. Обязательный параметр.
+
=== Форма отзывов (голосование) ===
*'''rate''' - <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой - rate = 5. Таким образом формируется тип отзыва “хорошо/плохо”, когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов - целое число от 1 до 5.
+
Для работы сервиса используется ссылка на форму вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
*'''type''' - тип сущности. По умолчанию 3 (заказ).
 
*'''note''' - признак ввода комментария. По умолчанию 1.
 
*'''star''' - признак вывода в виде звёздочек. По умолчанию 1.
 
*'''hash''' - значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметр.
 
  
 +
* '''code''' — внутренний код сущности, которой дается оценка, в системе. Обязательный параметр.
 +
* '''rate''' — <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой — rate = 5. Таким образом формируется тип отзыва «хорошо/плохо», когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов — целое число от 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               Запрос оценки в виде звёздочек и комментария для адреса (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/экстра-код/opinions?code=123456&rate=1''' Запрос комментария для адреса (оценка уже проставлена)
+
Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):
  
'''home.courierexe.ru/экстра-код/opinions?code=123456&star=0''' Запрос оценки в виде списка и комментария для адреса
+
home.courierexe.ru/экстра-код/'''o'''?'''c'''=123456&'''r'''=1&'''n'''=1&'''t'''=3
  
'''home.courierexe.ru/экстра-код/opinions?code=123456&type=12''' Запрос оценки сотрудника в виде звёздочек с комментарием
+
== Информирование о поступивших заказах ==
  
'''home.courierexe.ru/экстра-код/opinions?code=123456&rate=1&note=0''' Оценка выставлена, комментарий не запрашивается, сразу выводится сообщение о выставленной оценке.
+
Вы можете включить автоматические уведомления о заказах, поступающих из [[Личный кабинет клиента|ЛК клиента]] или через [[API]]. Для этого в основном меню выберите '''Настройка''' > '''Пользователи''', откройте карточку пользователя и на вкладке '''Настройка''' установите флажок '''Показывать окно поступивших заказов''', затем нажмите '''ОК'''.  
  
 +
Подробнее см. раздел [[Пользователи#Окно поступивших заказов|«Окно поступивших заказов»]].
  
Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):
+
== Внешний интерфейс сотрудников (Staff) ==
 +
Интерфейс позволяет без входа в систему MeaSoft совершать следующие действия:
 +
* вносить информацию о доставке заказов по накладным — [[#Адреса|Адреса]];
 +
* добавлять и редактировать собеседования — [[#Собеседования|Собеседования]];
 +
* получать заказы на обзвон — [[#Колл-центр|Колл-центр]];
 +
* вести учет по приглашенным клиентам — [[#Приглашенные|Приглашенные]].
 +
 
 +
Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/staff'''.
 +
 
 +
Сотрудник должен быть зарегистрирован в системе MeaSoft как [[Пользователи#Создать нового пользователя|пользователь]]. Для входа в Staff используются те же логин и пароль, что и для входа в систему MeaSoft.
 +
 
 +
Количество доступных разделов зависит от прав пользователя.
 +
 
 +
=== Адреса ===
 +
Пункт основного меню '''Адреса''' позволяет удаленному сотруднику вносить в корреспонденции информацию о доставке из отсканированных накладных. По умолчанию отображается список заказов в виде таблицы.
 +
 +
Чтобы внести информацию о доставке, нажмите на строку заказа. Откроется окно, вверху которого скан накладной, а внизу — форма для внесения данных. Заполните ее и нажмите кнопку '''Сохранить'''. Заказ исчезнет из списка адресов.
 +
 
 +
Таблица заказов содержит следующие столбцы:
 +
 
 +
'''#''' — внутренний код в Staff.
 +
 
 +
'''Фирма''' — компания получателя.
 +
 
 +
'''Адрес''' — адрес получателя.
 +
 
 +
'''Заказ''' — номер заказа с вкладки '''Заказы'''.
 +
 
 +
'''Номер''' — значение столбца '''Номер''' с вкладки '''Адреса'''.
 +
 
 +
'''Шифр''' — шифр корреспонденции.
 +
 
 +
Вверху справа можно выполнить поиск корреспонденции.
 +
 
 +
Заказ попадает в список на вкладке '''Адреса''', если:
 +
* он не старше 2 месяцев;
 +
* в поле '''Инфо о доставке''' введено слово «Скан»;
 +
* к заказу прикреплен [[Функции|скан накладной]] с заполненной информацией о доставке. Имя файла должно быть «scan.jpg».
 +
 
 +
=== Собеседования ===
 +
Пункт основного меню '''Собеседования''' предназначен для добавления и редактирования [[Собеседования|собеседований]].
 +
 
 +
Вверху справа можно отфильтровать собеседования по дате, имени кандидата. Правее можно выбрать столбцы, которые будут отображаться в таблице, и количество записей собеседований, выводимых на странице.
 +
 
 +
Чтобы добавить собеседование, нажмите на кнопку '''Добавить''', в открывшемся окне внесите необходимую информацию и нажмите '''Сохранить'''.
 +
 +
Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения.
 +
 
 +
=== Колл-центр ===
 +
Позволяет удаленному сотруднику получать задачи на обзвон клиентов по вопросам доставки заказов. Заказы попадают в проекты, созданные в [[Личный кабинет курьерской службы#Колл-центр|ЛК курьерской службы]]. Проект соответствует условию, по которому фильтруются попадающие в него заказы. Например, проект по обзвону клиентов с изменившейся датой доставки.
 +
 
 +
Раздел '''Колл-центр''' для оператора выглядит следующим образом:
 +
 
 +
[[Файл:Колл-центр для оператора.png|none|1100 px]]
 +
 
 +
 
 +
Чтобы получить задачу на обзвон, нажмите на кнопку '''Получить заказ'''. Откроется окно следующего вида:
 +
 
 +
[[Файл:Проект для оператора.png|none|1100 px]]
 +
 
 +
Слева отображается название проекта и скрипт звонка, справа — форма для просмотра и редактирования данных заказа. Если для получателя найдено несколько заказов, их данные отображаются слева. Когда оператор вносит результаты звонка в карточку задачи, изменения распространяются в карточки всех связанных заказов.
 +
 
 +
Если вы дозвонились по указанному в форме номеру, внесите информацию в форму, переведите заказ в соответствующий статус и нажмите на кнопку '''Сохранить'''. Если в результате меняется плановая дата или район доставки, у заказа сбрасывается плановый курьер.
 +
 
 +
Если дозвониться не удалось, нажмите на кнопку '''Не дозвонились'''. Через 1 час заказ снова появляется в очереди задач проекта.
 +
 
 +
При нажатии на кнопку '''Отмена''' заказ сразу возвращается в очередь задач.
 +
 
 +
Полученная сотрудником задача исчезает из очереди. Если по полученной задаче в течение получаса не совершается никаких действий, она принудительно возвращается в очередь.
 +
 
 +
=== Приглашенные ===
 +
Пункт основного меню '''Приглашенные''' предназначен для удаленных сотрудников, которые получают вознаграждение за приведенных клиентов. Здесь они могут видеть таблицу со списком приглашенных клиентов и размером своего вознаграждения за их заказы. Вверху справа можно отфильтровать клиентов по дате. Нажатие на строку таблицы открывает окно с детализацией заказов.
 +
 
 +
В системе MeaSoft такой сотрудник должен быть назначен [[Сотрудники#Виды сотрудников|агентом]], а также указан менеджером на вкладке '''Основное''' в <rspoiler text="карточке клиента">«Клиенты» → карточка клиента → вкладка «Основное» → поле «Менеджер» </rspoiler>, которого он привёл. Там же в поле '''% менеджера''' указывается размер вознаграждения агента в виде процента от заказов.
  
home.courierexe.ru/экстра-код/'''o'''?'''c'''=123456&'''r'''=1&'''n'''=1&'''t'''=3
+
== Геокодирование ==
 +
[[Модуль «Карта»#Геокодирование|Геокодирование]] выполняется запросом к серверу на адрес:
  
==Информирование системы о поступивших заказах==
+
О лимитах геокодирования, принципе работы читайте [[Модуль «Карта»#Геокодирование|здесь]]
[[Файл:информ.новые_заказы.png|right|300px|thumb|Подключение окна уведомлений о заказах]]
 
  
В системе MeaSoft есть возможность включить автоматические уведомления о заказах, поступающих из [[Личный кабинет клиента|ЛК клиента]]/[[API|API-интерфейса]]. Для этого в основном меню выберите "Настройка" &rarr; "Пользователи" &rarr; карточка пользователя &rarr; "Настройка", '''поставьте галку''' '''"Показывать окно поступивших заказов"''' и нажмите "ОК".  
+
URL запроса: http://home.courierexe.ru/geocoder
  
В результате у выбранного пользователя в системе  MeaSoft каждые 10 минут будет появляться окно со списком новых заказов и двумя кнопками: "Перейти (Прочитан)" и "Закрыть". 
+
GET-параметры:
  
Чтобы временно скрыть окно, нажмите кнопку "'''Закрыть'''".
+
* '''geocoder''' — в данном параметре может использоваться как полный адрес для разбора, так и в составе других параметров
 +
* '''town''' — город
 +
* '''address''' — адрес
 +
* '''street''' — улица
 +
* '''home''' — номер дома
 +
* '''extracode''' — дополнительный параметр, зависит от клиента
  
Чтобы открыть список новых заказов на вкладке "Адреса", нажмите кнопку "'''Перейти'''". После этого кнопка "Перейти" сменится на "Прочитан".
 
  
Чтобы очистить список заказов из окна уведомлений, нажмите кнопку "'''Прочитан'''".
+
Результатом является ответ в формате XML, например:
  
==Внешний интерфейс сотрудников==
+
<source lang="xml">
[[Файл:Внешний_интерфейс.PNG|right|300px|thumb|Внешний интерфейс сотрудников]]
+
<?xml version="1.0" encoding="UTF-8"?>
Внешний интерфейс сотрудников позволяет без входа в систему MeaSoft вносить информацию о доставке заказов по накладным, добавлять/редактировать собеседования.  
+
<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>
 +
</source>
  
Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/staff'''. Для входа используются те же логин и пароль, что и для <rspoiler text="входа в систему MeaSoft">Сотрудник должен быть зарегистрирован в системе MeaSoft как пользователь ("Настройка" &rarr; "Пользователи")</rspoiler>.
+
Параметры ответа:
  
===Адреса===
+
* '''name''' — найденный адрес
===Собеседования===
+
* '''pos''' — геокоординаты — долгота и широта
Пункт основного меню "Собеседования" предназначен для добавления и редактирования [[Собеседования|собеседований]].
+
* '''kind''' — найденный элемент является домом, если значение house
 +
* '''zipcode''' — индекс найденного объекта
 +
* '''distance''' — расстояние до МКАД/КАД в метрах
  
Вверху справа можно отфильтровать собеседования по дате, имени (поле "Поиск"). Правее с помощью галок выбираются столбцы, которые будут отображаться в таблице. Также можно выбрать количество собеседований, выводимых на страницу.
 
  
Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения. 
+
Ответ в случае, если адрес не геокодирован
  
===Колл-центр===
+
<source lang="xml">
===Приглашенные===
+
<?xml version="1.0" encoding="UTF-8"?>
 +
<ymaps>
 +
  <error>
 +
    <status>429</status>
 +
    <message>Coordinates aren't found</message>
 +
  </error>
 +
</ymaps>
 +
</source>

Текущая версия на 13:07, 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 такой сотрудник должен быть назначен агентом, а также указан менеджером на вкладке Основное в карточке клиента
, которого он привёл. Там же в поле % менеджера указывается размер вознаграждения агента в виде процента от заказов.

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

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

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

URL запроса: 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>