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

Материал из Меасофт
Перейти к: навигация, поиск
м (Колл-центр)
(Геокодирование)
 
(не показано 12 промежуточных версий 3 участников)
Строка 38: Строка 38:
 
# Добавить в карточку курьера поле '''Рейтинг курьера'''? Оно показывает среднюю оценку работы курьера за последние 3 месяца:[[Файл:Оценка курьера.png|none|500 px]]
 
# Добавить в карточку курьера поле '''Рейтинг курьера'''? Оно показывает среднюю оценку работы курьера за последние 3 месяца:[[Файл:Оценка курьера.png|none|500 px]]
  
=== Форма отзывов ===
+
=== Форма отзывов (голосование) ===
 
Для работы сервиса используется ссылка на форму вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
 
Для работы сервиса используется ссылка на форму вида '''home.courierexe.ru/экстра-код/opinions''' с параметрами:
  
Строка 61: Строка 61:
 
home.courierexe.ru/экстра-код/'''o'''?'''c'''=123456&'''r'''=1&'''n'''=1&'''t'''=3
 
home.courierexe.ru/экстра-код/'''o'''?'''c'''=123456&'''r'''=1&'''n'''=1&'''t'''=3
  
== Информирование системы о поступивших заказах ==
+
== Информирование о поступивших заказах ==
[[Файл:информ.новые_заказы.png|right|300px|thumb|Подключение окна уведомлений о заказах]]
 
  
В системе MeaSoft есть возможность включить автоматические уведомления о заказах, поступающих из [[Личный кабинет клиента|ЛК клиента]]/[[API|API-интерфейса]]. Для этого в основном меню выберите «Настройка» → «Пользователи» → карточка пользователя → «Настройка», '''поставьте галку''' '''«Показывать окно поступивших заказов»''' и нажмите «ОК».
+
Вы можете включить автоматические уведомления о заказах, поступающих из [[Личный кабинет клиента|ЛК клиента]] или через [[API]]. Для этого в основном меню выберите '''Настройка''' > '''Пользователи''', откройте карточку пользователя и на вкладке '''Настройка''' установите флажок '''Показывать окно поступивших заказов''', затем нажмите '''ОК'''.  
  
В результате у выбранного пользователя в системе MeaSoft каждые 10 минут будет появляться окно со списком новых заказов и двумя кнопками: «Перейти (Прочитан)» и «Закрыть».
+
Подробнее см. раздел [[Пользователи#Окно поступивших заказов|«Окно поступивших заказов»]].
  
Чтобы временно скрыть окно, нажмите кнопку «'''Закрыть'''».
+
== Внешний интерфейс сотрудников (Staff) ==
 
+
Интерфейс позволяет без входа в систему MeaSoft совершать следующие действия:
Чтобы открыть список новых заказов на вкладке «Адреса», нажмите кнопку «'''Перейти'''». После этого кнопка «Перейти» сменится на «Прочитан».
+
* вносить информацию о доставке заказов по накладным — [[#Адреса|Адреса]];
 +
* добавлять и редактировать собеседования — [[#Собеседования|Собеседования]];
 +
* получать заказы на обзвон — [[#Колл-центр|Колл-центр]];
 +
* вести учет по приглашенным клиентам — [[#Приглашенные|Приглашенные]].
  
Чтобы очистить список заказов из окна уведомлений, нажмите кнопку «'''Прочитан'''».
+
Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/staff'''.
  
== Внешний интерфейс сотрудников (Staff) ==
+
Сотрудник должен быть зарегистрирован в системе MeaSoft как [[Пользователи#Создать нового пользователя|пользователь]]. Для входа в Staff используются те же логин и пароль, что и для входа в систему MeaSoft.
[[Файл:Внешний_интерфейс.PNG|right|300px|thumb|Внешний интерфейс сотрудников]]
 
Staff позволяет без входа в систему MeaSoft вносить информацию о доставке заказов по накладным, добавлять/редактировать собеседования, получать заказы на прозвон, а также вести учет по приглашенным клиентам.
 
  
Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/staff'''. Для входа используются те же логин и пароль, что и для <rspoiler text="входа в систему MeaSoft">Сотрудник должен быть зарегистрирован в системе MeaSoft как пользователь («Настройка» → «Пользователи»)</rspoiler>.
+
Количество доступных разделов зависит от прав пользователя.
  
 
=== Адреса ===
 
=== Адреса ===
Пункт основного меню «Адреса» позволяет удаленному сотруднику вносить в корреспонденции информацию о доставке из отсканированных накладных. По умолчанию в «Адресах» отображается список заказов в виде таблицы.
+
Пункт основного меню '''Адреса''' позволяет удаленному сотруднику вносить в корреспонденции информацию о доставке из отсканированных накладных. По умолчанию отображается список заказов в виде таблицы.
 
   
 
   
Чтобы внести информацию о доставке, нажмите на строку заказа. Откроется окно, вверху которого скан накладной, а внизу — форма для внесения данных. Заполните ее и нажмите кнопку «Сохранить». Заказ исчезнет из списка адресов.
+
Чтобы внести информацию о доставке, нажмите на строку заказа. Откроется окно, вверху которого скан накладной, а внизу — форма для внесения данных. Заполните ее и нажмите кнопку '''Сохранить'''. Заказ исчезнет из списка адресов.
  
 
Таблица заказов содержит следующие столбцы:
 
Таблица заказов содержит следующие столбцы:
  
'''#''' — внутренний код staff’а.
+
'''#''' — внутренний код в Staff.
  
 
'''Фирма''' — компания получателя.
 
'''Фирма''' — компания получателя.
Строка 93: Строка 93:
 
'''Адрес''' — адрес получателя.
 
'''Адрес''' — адрес получателя.
  
'''Заказ''' — номер заказа с вкладки «Заказы».
+
'''Заказ''' — номер заказа с вкладки '''Заказы'''.
  
'''Номер''' — значение столбца «Номер» с вкладки «Адреса».
+
'''Номер''' — значение столбца '''Номер''' с вкладки '''Адреса'''.
  
 
'''Шифр''' — шифр корреспонденции.
 
'''Шифр''' — шифр корреспонденции.
Строка 101: Строка 101:
 
Вверху справа можно выполнить поиск корреспонденции.
 
Вверху справа можно выполнить поиск корреспонденции.
  
Заказ попадает в список «Адресов» в случае, если:
+
Заказ попадает в список на вкладке '''Адреса''', если:
 
+
* он не старше 2 месяцев;
# Он не старше 2 месяцев.
+
* в поле '''Инфо о доставке''' введено слово «Скан»;
# В поле «Инфо о доставке» введено слово «Скан».
+
* к заказу прикреплен [[Функции|скан накладной]] с заполненной информацией о доставке. Имя файла должно быть «scan.jpg».
# К заказу прикреплен [[Функции|скан накладной]] с заполненной информацией о доставке. Имя файла должно быть «scan.jpg».
 
  
 
=== Собеседования ===
 
=== Собеседования ===
Пункт основного меню «Собеседования» предназначен для добавления и редактирования [[Собеседования|собеседований]].
+
Пункт основного меню '''Собеседования''' предназначен для добавления и редактирования [[Собеседования|собеседований]].
  
Вверху справа можно отфильтровать собеседования по дате, имени (поле «Поиск»). Правее с помощью галок выбираются столбцы, которые будут отображаться в таблице. Также можно выбрать количество собеседований, выводимых на страницу.
+
Вверху справа можно отфильтровать собеседования по дате, имени кандидата. Правее можно выбрать столбцы, которые будут отображаться в таблице, и количество записей собеседований, выводимых на странице.
  
Чтобы добавить собеседование, нажмите кнопку «Добавить», в открывшемся окне внесите необходимую информацию и нажмите «Сохранить».
+
Чтобы добавить собеседование, нажмите на кнопку '''Добавить''', в открывшемся окне внесите необходимую информацию и нажмите '''Сохранить'''.
 
   
 
   
 
Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения.
 
Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения.
 
  
 
=== Колл-центр ===
 
=== Колл-центр ===
Строка 122: Строка 120:
 
Раздел '''Колл-центр''' для оператора выглядит следующим образом:
 
Раздел '''Колл-центр''' для оператора выглядит следующим образом:
  
[[Файл:Колл-центр для оператора.png|none|1000 px]]
+
[[Файл:Колл-центр для оператора.png|none|1100 px]]
 +
 
  
 
Чтобы получить задачу на обзвон, нажмите на кнопку '''Получить заказ'''. Откроется окно следующего вида:
 
Чтобы получить задачу на обзвон, нажмите на кнопку '''Получить заказ'''. Откроется окно следующего вида:
  
[[Файл:Проект для оператора.png|1200 px|none]]
+
[[Файл:Проект для оператора.png|none|1100 px]]
  
Справа отображается название проекта и скрипт звонка, слева — форма для просмотра и редактирования данных заказа.
+
Слева отображается название проекта и скрипт звонка, справа — форма для просмотра и редактирования данных заказа. Если для получателя найдено несколько заказов, их данные отображаются слева. Когда оператор вносит результаты звонка в карточку задачи, изменения распространяются в карточки всех связанных заказов.
  
 
Если вы дозвонились по указанному в форме номеру, внесите информацию в форму, переведите заказ в соответствующий статус и нажмите на кнопку '''Сохранить'''. Если в результате меняется плановая дата или район доставки, у заказа сбрасывается плановый курьер.
 
Если вы дозвонились по указанному в форме номеру, внесите информацию в форму, переведите заказ в соответствующий статус и нажмите на кнопку '''Сохранить'''. Если в результате меняется плановая дата или район доставки, у заказа сбрасывается плановый курьер.
Строка 134: Строка 133:
 
Если дозвониться не удалось, нажмите на кнопку '''Не дозвонились'''. Через 1 час заказ снова появляется в очереди задач проекта.
 
Если дозвониться не удалось, нажмите на кнопку '''Не дозвонились'''. Через 1 час заказ снова появляется в очереди задач проекта.
  
При нажатии на кнопку '''Отмена''' заказ возвращается в очередь задач через 3 минуты.
+
При нажатии на кнопку '''Отмена''' заказ сразу возвращается в очередь задач.
  
 
Полученная сотрудником задача исчезает из очереди. Если по полученной задаче в течение получаса не совершается никаких действий, она принудительно возвращается в очередь.
 
Полученная сотрудником задача исчезает из очереди. Если по полученной задаче в течение получаса не совершается никаких действий, она принудительно возвращается в очередь.
  
 
=== Приглашенные ===
 
=== Приглашенные ===
Пункт основного меню «Приглашенные» предназначен для удаленных сотрудников, которые получают вознаграждение за приведенных клиентов. Здесь они могут видеть таблицу со списком приглашенных клиентов и размером своего вознаграждения за их заказы. Вверху справа можно отфильтровать клиентов по дате. Нажатие на строку таблицы открывает окно с детализацией заказов.
+
Пункт основного меню '''Приглашенные''' предназначен для удаленных сотрудников, которые получают вознаграждение за приведенных клиентов. Здесь они могут видеть таблицу со списком приглашенных клиентов и размером своего вознаграждения за их заказы. Вверху справа можно отфильтровать клиентов по дате. Нажатие на строку таблицы открывает окно с детализацией заказов.
  
В системе MeaSoft такой сотрудник должен быть назначен [[Сотрудники#Виды сотрудников|агентом]], а также указан менеджером на вкладке «Основное» в <rspoiler text="карточке клиента">«Клиенты» → карточка клиента → вкладка «Основное» → поле «Менеджер» </rspoiler>, которого он привёл. Там же в поле «% менеджера» указывается размер вознаграждения агента в виде процента от заказов.
+
В системе MeaSoft такой сотрудник должен быть назначен [[Сотрудники#Виды сотрудников|агентом]], а также указан менеджером на вкладке '''Основное''' в <rspoiler text="карточке клиента">«Клиенты» → карточка клиента → вкладка «Основное» → поле «Менеджер» </rspoiler>, которого он привёл. Там же в поле '''% менеджера''' указывается размер вознаграждения агента в виде процента от заказов.
[[Файл:Приведенные.PNG|none|600px]]
 
  
 
== Геокодирование ==
 
== Геокодирование ==
Геокодирование выполняется запросом к серверу на адрес:
+
[[Модуль «Карта»#Геокодирование|Геокодирование]] выполняется запросом к серверу на адрес:
 +
 
 +
О лимитах геокодирования, принципе работы читайте [[Модуль «Карта»#Геокодирование|здесь]]
  
http://home.courierexe.ru/geocoder
+
URL запроса: http://home.courierexe.ru/geocoder
  
 
GET-параметры:
 
GET-параметры:

Текущая версия на 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>