Изменения

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

Веб-сервисы

12 910 байт добавлено, 13:07, 20 июня 2023
Геокодирование
[[Файл:калькулятор.png|right|300×100px|thumb|Калькулятор]][[Файл:трекинг.png|right|300px|thumb|Трекинг по номеру]]Все ссылки на дополнительные сервисы содержат '''экстра_код'''. Экстра код - код — это ваш уникальный [[Личный кабинет курьерской службы#Подключение|код курьерской службы]].
Дополнительными сервисами может воспользоваться любой клиент курьерской службы. Для этого ему не нужно иметь доступ в [[Личный кабинет|личный кабинет]], достаточно перейти по нужной ссылке.
==Калькулятор=="Калькулятор" доступен по ссылке вида '''home.courierexe.ru/экстра_код/calculator'''. Сервис предназначен для расчета стоимости доставки, работает аналогично [[Личный кабинет курьерской службыклиента#Настройка пункта "Калькулятор"|калькулятору]] в личном кабинете.
==Трекинг по номеру=="Трекинг по номеру" позволяет отслеживать заказ по его номеру. Сервис Калькулятор доступен по ссылке вида '''home.courierexe.ru/код_экстра_клиентаэкстра_код/trackingcalculator'''. Экстра-код можно посмотреть [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|по ссылке]].[[Файл:калькулятор.png|none|450 px]]
Чтобы получить информацию о заказе, введите == Трекинг по номеру ==Позволяет отслеживать статус заказа по его номер номеру. Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/tracking'''. При поиске заказа выводится таблица с подробностями. Поля таблицы настраиваются в поле "Код" и нажмите кнопку "Найти"[[Личный кабинет курьерской службы#Настройка личного кабинета клиента|личном кабинете курьерской службы]] на вкладке '''Поля трекинга по номеру'''.
==Внешний интерфейс сотрудников==[[Файл:Внешний_интерфейс.PNG|right|300px|thumb|Внешний интерфейс сотрудников]]Внешний интерфейс сотрудников позволяет без входа в систему 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''' — значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|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.
Для работы сервиса сформируйте ссылку вида '''homeКоличество доступных разделов зависит от прав пользователя.courierexe.ru/экстра-код/opinions''' с параметрами:
*'''code''' - внутренний код сущности в системе. Обязательный параметр.*'''rate''' - <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой - rate = 5. Таким образом формируется тип отзыва “хорошо/плохо”, когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов - целое число от 1 до 5. Адреса ===*Пункт основного меню '''typeАдреса''' - тип сущностипозволяет удаленному сотруднику вносить в корреспонденции информацию о доставке из отсканированных накладных. По умолчанию 3 (заказ)отображается список заказов в виде таблицы.*'''note''' - признак ввода комментария. По умолчанию 1. *'''star''' - признак вывода в виде звёздочекЧтобы внести информацию о доставке, нажмите на строку заказа. По умолчанию 1Откроется окно, вверху которого скан накладной, а внизу — форма для внесения данных.*Заполните ее и нажмите кнопку '''hashСохранить''' - значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметрЗаказ исчезнет из списка адресов.
Таблица заказов содержит следующие столбцы:
Примеры запросов (без хэша)'''#''' — внутренний код в Staff. '''Фирма''' — компания получателя. '''Адрес''' — адрес получателя. '''Заказ''' — номер заказа с вкладки '''Заказы'''. '''Номер''' — значение столбца '''Номер''' с вкладки '''Адреса'''. '''Шифр''' — шифр корреспонденции. Вверху справа можно выполнить поиск корреспонденции. Заказ попадает в список на вкладке '''Адреса''', если:* он не старше 2 месяцев;* в поле '''Инфо о доставке''' введено слово «Скан»;* к заказу прикреплен [[Функции|скан накладной]] с заполненной информацией о доставке. Имя файла должно быть «scan.jpg». === Собеседования ===Пункт основного меню '''Собеседования''' предназначен для добавления и редактирования [[Собеседования|собеседований]]. Вверху справа можно отфильтровать собеседования по дате, имени кандидата. Правее можно выбрать столбцы, которые будут отображаться в таблице, и количество записей собеседований, выводимых на странице. Чтобы добавить собеседование, нажмите на кнопку '''Добавить''', в открывшемся окне внесите необходимую информацию и нажмите '''Сохранить'''. Чтобы отредактировать собеседование, нажмите на соответствующую строку и в открывшемся окне внесите необходимые изменения. === Колл-центр ===Позволяет удаленному сотруднику получать задачи на обзвон клиентов по вопросам доставки заказов. Заказы попадают в проекты, созданные в [[Личный кабинет курьерской службы#Колл-центр|ЛК курьерской службы]]. Проект соответствует условию, по которому фильтруются попадающие в него заказы. Например, проект по обзвону клиентов с изменившейся датой доставки. Раздел '''Колл-центр''' для оператора выглядит следующим образом: [[Файл:Колл-центр для оператора.png|none|1100 px]]  Чтобы получить задачу на обзвон, нажмите на кнопку '''Получить заказ'''. Откроется окно следующего вида: [[Файл:Проект для оператора.png|none|1100 px]] Слева отображается название проекта и скрипт звонка, справа — форма для просмотра и редактирования данных заказа. Если для получателя найдено несколько заказов, их данные отображаются слева. Когда оператор вносит результаты звонка в карточку задачи, изменения распространяются в карточки всех связанных заказов. Если вы дозвонились по указанному в форме номеру, внесите информацию в форму, переведите заказ в соответствующий статус и нажмите на кнопку '''Сохранить'''. Если в результате меняется плановая дата или район доставки, у заказа сбрасывается плановый курьер. Если дозвониться не удалось, нажмите на кнопку '''Не дозвонились'''. Через 1 час заказ снова появляется в очереди задач проекта. При нажатии на кнопку '''Отмена''' заказ сразу возвращается в очередь задач. Полученная сотрудником задача исчезает из очереди. Если по полученной задаче в течение получаса не совершается никаких действий, она принудительно возвращается в очередь. === Приглашенные ===Пункт основного меню '''Приглашенные''' предназначен для удаленных сотрудников, которые получают вознаграждение за приведенных клиентов. Здесь они могут видеть таблицу со списком приглашенных клиентов и размером своего вознаграждения за их заказы. Вверху справа можно отфильтровать клиентов по дате. Нажатие на строку таблицы открывает окно с детализацией заказов.
В системе MeaSoft такой сотрудник должен быть назначен [[Сотрудники#Виды сотрудников|агентом]], а также указан менеджером на вкладке '''Основное'''homeв <rspoiler text="карточке клиента">«Клиенты» → карточка клиента → вкладка «Основное» → поле «Менеджер» </rspoiler>, которого он привёл.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''' Запрос оценки в виде списка и комментария для адресаО лимитах геокодирования, принципе работы читайте [[Модуль «Карта»#Геокодирование|здесь]]
'''URL запроса: http://home.courierexe.ru/экстра-код/opinions?code=123456&type=12''' Запрос оценки сотрудника в виде звёздочек с комментариемgeocoder
'''home.courierexe.ru/экстраGET-код/opinions?code=123456&rate=1&note=0''' Оценка выставлена, комментарий не запрашивается, сразу выводится сообщение о выставленной оценке.параметры:
* '''geocoder''' — в данном параметре может использоваться как полный адрес для разбора, так и в составе других параметров
* '''town''' — город
* '''address''' — адрес
* '''street''' — улица
* '''home''' — номер дома
* '''extracode''' — дополнительный параметр, зависит от клиента
Для уменьшения длины ссылки можно использовать короткую форму записи метода и параметров (наименования параметров сокращаются до одной буквы):
home.courierexe.ru/экстра-код/'''o'''?'''c'''=123456&'''r'''=1&'''n'''=1&'''t'''=3Результатом является ответ в формате XML, например:
<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>
271
правка

Навигация