Изменения

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

Веб-сервисы

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

Навигация