Изменения

Перейти к: навигация, поиск

Веб-сервисы

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

Навигация