Изменения

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

Веб-сервисы

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

Навигация