Изменения

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

Веб-сервисы

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

Навигация