Изменения

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

Веб-сервисы

5207 байт добавлено, 13:07, 20 июня 2023
Геокодирование
[[Файл:калькулятор.png|right|300×100px|thumb|Калькулятор]][[Файл:трекинг.png|right|300px|thumb|Трекинг по номеру]]Все ссылки на дополнительные сервисы содержат '''экстра_код'''. Экстра код - код — это ваш уникальный [[Личный кабинет курьерской службы#Подключение|код курьерской службы]].
Дополнительными сервисами может воспользоваться любой клиент курьерской службы. Для этого ему не нужно иметь доступ в [[Личный кабинет|личный кабинет]], достаточно перейти по нужной ссылке.
==Калькулятор==Сервис предназначен для расчета стоимости доставки, работает аналогично [[Личный кабинет курьерской службыклиента#Настройка пункта "Калькулятор"|калькулятору]] в личном кабинете.
"Калькулятор" доступен по ссылке вида '''home.courierexe.ru/экстра_код/calculator'''. Экстра-код можно посмотреть [[Интеграция с другими системами#Тарификация и выбор подрядчика и его тарифа клиентом|по ссылке]].[[Файл:калькулятор.png|none|450 px]]
==Трекинг по номеру=="Трекинг по номеру" позволяет Позволяет отслеживать заказ статус заказа по его номеру. Сервис доступен по ссылке вида '''home.courierexe.ru/экстра_код/tracking'''. При поиске заказа выводится таблица с подробностями. Поля таблицы настраиваются в "[[Личный кабинет курьерской службы#Настройка полейличного кабинета клиента|админкеличном кабинете курьерской службы]]" на вкладке "'''Поля трекинга по номеру"'''.
Чтобы получить информацию о заказе, введите его номер в поле "'''Код" ''' и нажмите на кнопку "'''Найти"'''.
==Отзывы==[[Файл:Отзыв1трекинг.PNGpng|rightnone|300px|thumb|Отзывы: оценка в виде звёздочек и комментарий900px]]Сервис позволяет запрашивать у клиентов отзывы к работе курьерской службы, в том числе к заказам, к курьерам, к сообщениям и т.д.
== Отзывы могут быть нескольких типов:==Сервис позволяет запрашивать у клиентов отзывы о работе курьерской службы, в том числе о заказах, о работе курьера, о работе менеджера и т. д.
* оценка (=== Настройка получения отзывов ===Например, запрос отзыва у получателя о работе курьера, доставившего заказ, работает следующим образом. Мы добавляем в ткарточку клиента пользовательское поле — флажок '''Оценка курьера'''.чЕсли флажок установлен, по доставленным заказам этого клиента в определенном статусе запускается автоматическая смс-рассылка с ссылкой на форму голосования. Результаты можно вывести в виде звёздочек);* комментарий;* оценка отчеты и комментарий;* отзыв типа хорошо/плохов карточку курьера. Требуется подключение [[Модуль отправки SMS-сообщений|модуля отправки смс-уведомлений]].
Для Чтобы автоматизировать работу сервиса, отправьте обращение в нашу службу поддержки с ответами на следующие вопросы:# Кто кому будет ставить оценку или оставлять отзыв?<br>Например, это будет получатель, который оценивает работу курьера.# Выберите тип отзыва:#* оценка (в том числе в виде звёздочек);#* комментарий;#* оценка и комментарий;#* отзыв типа хорошо/плохо.[[Файл:Отзыв1.PNG|none|450 px]]# Когда отправлять смс получателю: когда заполнен статус доставки со слов курьера (предварительный статус доставки) или указана информация о доставке по заказу в карточке корреспонденции (окончательный статус доставки)?# Пришлите текст смс для оценки качества работы. Учтите, что длина одного смс-сообщения — 160 символов латиницей или 70 символов кириллицей. <br>Пример: «Здравствуйте. Оцените, пожалуйста, работу курьера <ссылка>»# Добавить в карточку курьера пользовательское поле — флажок '''Не оценивать курьера'''?<br>Если флажок установлен, по заказам, доставленным этим курьером, рассылки не будет. Это нужно, чтобы исключить служебных курьеров из смс-рассылки.# Как вы хотите получать статистику для оценки качества работы сервиса сформируйте ссылку вида ? <br>Вы можете скачать и импортировать в '''Отчеты''' > '''Дополнительные возможности'''home:#* отчет о рейтинге курьера, который будет показывать оценку в разрезе курьера за указанный период. Поля отчета: «Курьер», «Средняя оценка», «Количество оценок». [https://www.courierexe.ru/download/Report1.xml Скачать];#* сводный отчет по оценкам качества за период по доставленным корреспонденциям. Поля отчета: «Шифр», «Курьер», «Оценка», «Комментарий к оценке». [https://www.courierexe.ru/экстра-кодdownload/opinionsReport2.xml Скачать].#: Если вам нужен другой отчет, пришлите пример шаблона такого отчета с описанием полей.# Добавить в карточку курьера поле '''Рейтинг курьера''' с параметрами? Оно показывает среднюю оценку работы курьера за последние 3 месяца:[[Файл:Оценка курьера.png|none|500 px]]
*'''code''' - внутренний код сущности в системе. Обязательный параметр.*'''rate''' - <rspoiler text="оценка">При наличии параметра rate оценка проставляется сразу и в форме не запрашивается. Обычно создаются две ссылки, одной из которых присвоено значение rate = 1, а другой - rate = 5. Таким образом формируется тип отзыва "хорошо/плохо", когда у клиента на выбор только две оценки. Возможно как с запросом комментария, так и без него. </rspoiler>. Для заказов параметр должен быть равен коду из справочника [[Справочники#Жалобы клиентов|Жалобы]]. Для остальных типов - целое число от 1 до 5. *'''type''' - тип сущности. По умолчанию 3 Форма отзывов (заказголосование).===*Для работы сервиса используется ссылка на форму вида '''note''' - признак ввода комментарияhome. По умолчанию 1courierexe.*'''star''' ru/экстра- признак вывода в виде звёздочек. По умолчанию 1.*код/opinions'''hash''' - значение хэша ссылки. Хэш генерируется функцией [[Руководство программиста#Хеширование|SignatureUrl]]. Обязательный параметр.*'''field''' - Пользовательское поле, для указания типа отзыва.с параметрами:
* '''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''' -  — дополнительный параметр, зависит от клиента
Параметры ответа:
* '''name''' -  — найденный адрес* '''pos''' - геокоординаты -  — геокоординаты — долгота и широта* '''kind''' -  — найденный элемент является домом, если значение house* '''zipcode''' -  — индекс найденного объекта* '''distance''' -  — расстояние до МКАД/КАД в метрах
271
правка

Навигация