Максоптра — различия между версиями

Материал из Меасофт
Перейти к: навигация, поиск
м (Построение маршрутов)
 
(не показано 8 промежуточных версий 2 участников)
Строка 1: Строка 1:
= Автоматическая маршрутизация =
+
MeaSoft — официальный дилер системы маршрутизации [https://maxoptra.ru/ Максоптра]. Мы предоставляем услуги маршрутизации по основному договору, по специальным ценам, доступным только пользователям нашей системы.
  
Наша компания является официальным дилером системы маршрутизации [https://maxoptra.ru/ Максоптра]. Мы предоставляем услуги маршрутизации по основному договору, по специальным ценам, доступным только пользователям нашей системы.
+
При автоматическом планировании маршрутов система распределяет заказы между курьерами с учетом интервалов доставки, веса, объема грузов. Поддерживаются пешие курьеры. Учитывает наличие пропусков и прочих ограничений движения транспорта. Можно использовать зонирование и распределять заказы по районам, а уже внутри них — строить маршруты. Система учитывает стоимость часа курьера и километра пробега и рассчитывает оптимальный маршрут. В результате маршрутизации наша система получает данные о <rspoiler text="вхождении отправлений в маршруты">Сразу запланируете курьеров для сортировки заказов на складе</rspoiler>, расчетное <rspoiler text="время прибытия курьера на адрес">Можно сообщить уточненное время прибытия в SMS получателю</rspoiler>, и <rspoiler text="последовательность объезда">Заказы будут выстроены в правильном порядке у курьера в приложении</rspoiler> адресов курьером.
 
 
При автоматическом планировании маршрутов система распределяет заказы между курьерами с учетом интервалов доставки, веса, объема грузов. Поддерживаются пешие курьеры. Учитывает наличие пропусков и прочих ограничений движения транспорта. Можно использовать зонирование, и распределять заказы по районам, а уже внутри них - строить маршруты. Система учитывает стоимость часа курьера и километра пробега, и рассчитывает оптимальный маршрут. В результате маршрутизации наша система получает данные о <rspoiler text="вхождении отправлений в маршруты">Сразу запланируете курьеров для сортировки заказов на складе</rspoiler>, расчетное <rspoiler text="время прибытия курьера на адрес">Можно сообщить уточненное время прибытия в SMS получателю</rspoiler>, и <rspoiler text="последовательность объезда">Заказы будут выстроены в правильном порядке у курьера в приложении</rspoiler> адресов курьером.
 
  
 
== С чего начать ==
 
== С чего начать ==
 
 
Чтобы начать использовать маршрутизацию, обратитесь в нашу службу технической поддержки. Мы создадим тестовый аккаунт для вашей компании, передадим вам доступы, поможем настроить маршрутизацию под ваши требования. Далее, в течение 2-х недель вы бесплатно пользуетесь, тестируете, и по истечение этого срока, если вас устраивает качество работы, переводим аккаунт в боевой платный режим.
 
Чтобы начать использовать маршрутизацию, обратитесь в нашу службу технической поддержки. Мы создадим тестовый аккаунт для вашей компании, передадим вам доступы, поможем настроить маршрутизацию под ваши требования. Далее, в течение 2-х недель вы бесплатно пользуетесь, тестируете, и по истечение этого срока, если вас устраивает качество работы, переводим аккаунт в боевой платный режим.
<!-- Максоптра присылает ссылку на ЛК, логин и пароль от [https://start.maxoptra.com/demo8888888 '''админки''']
 
Обращаем внимание на URL, в нем указан '''идентификатор аккаунта – demo8888888'''. Заменив идентификатор аккаунта на '''rest/2''' получаем путь '''API - https://start.maxoptra.com/rest/2''' -->
 
  
 
== Настройка распределительных центров ==
 
== Настройка распределительных центров ==
 +
Зайдите по присланным данным в ЛК Максоптры. Распределительные центры — это филиалы в MeaSoft, их необходимо вручную создать в Максоптре, название региональных центров должно полностью совпадать с вашим названием филиалов. Адрес распределительного центра нужно указывать настоящий, с этого адреса курьеры выходят на маршрут.
  
Заходим по присланным данным в ЛК максоптры. Распределительные центры - это филиалы в Курьерской службе 2008,  их необходимо вручную завести в Максоптре, название региональных центров должно полностью совпадать с Вашим названием филиалов. Адрес распределительного центра нужно указывать настоящий, из этого адреса курьеры выходят на маршрут. [[Файл:1 Maxoptra.png|200px|thumb|right|Распределительный центр]]
+
[[Файл:1 Maxoptra.png|800px|none]]
Заполняем:
 
#Точное название;
 
#Адрес; 
 
#Время работы (лучше ставить максимально возможное, курьеры будут выходить на маршрут по своему графику).
 
  
'''Инструкция''' как создавать распределительные центры  - [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=24839542 '''здесь'''].
+
Заполните:
 +
# Точное название.
 +
# Адрес.
 +
# Время работы. Лучше ставить максимально возможное, курьеры будут выходить на маршрут по своему графику.
 +
 
 +
'''Инструкция''' как создавать распределительные центры — [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=24839542 '''здесь'''].
  
 
== Создание пользователя с ролью диспетчера ==
 
== Создание пользователя с ролью диспетчера ==
 +
Маршруты строятся под пользователем с ролью '''Диспетчер'''.
 +
 +
[[Файл:2 Maxoptra.png|800px|none]]
 +
 +
Если нужно, создайте нового пользователя, укажите роль «Диспетчер» и привяжите к нему региональные центры, которые он может обслуживать.
 +
 +
Заполните:
 +
# Имя, логин, пароль, установите флажок «Доступ к API».
 +
# Включите роль диспетчера, привяжите к пользователю филиалы, которые он обслуживает;
 +
# Включите роль администратор аккаунта, появится возможность менять настройки планирования с одного аккаунта.
  
Маршруты строятся под пользователем с ролью '''Диспетчер'''. [[Файл:2 Maxoptra.png|200px|thumb|right|Пользователь Максоптра]]Если нужно, создаем нового пользователя, указываем роль “Диспетчер” – привязываем к нему региональные центры, которые он может обслуживать.
+
'''Инструкция''' как создавать пользователя — [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=24839549 '''здесь'''].
Заполняем:
 
#Имя, Логин, Пароль, галку “Доступ к API”;
 
#Включаем роль диспетчера, привязываем  к пользователю филиалы, которые он обслуживает;
 
#Включаем роль администратор аккаунта, появится возможность менять настройки планирования с одного аккаунта.
 
  
'''Инструкция''' как создавать пользователя - [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=24839549 '''здесь'''].
+
Многофилиальная система может работать под одним пользователем Максоптры при условии, что одновременно планирование идет для разных филиалов.
Многофилиальная система может работать под одним пользователем Максоптры, при условии, что одновременно планирование идет для разных филиалов.  
 
  
 
== Настройка подключения к Максоптре ==
 
== Настройка подключения к Максоптре ==
Запускаем Курьерскую Службу 2008, необходимо прописать настройки подключения к Максоптре в следующих переменных раздела ''"Справочники" -> "Переменные" -> "Подключения" -> "Карты" -> "Маршрутизация"'':
+
В MeaSoft откройте '''Справочники''' > '''Переменные''' > '''Подключения''' > '''Карты''' > '''Маршрутизация''' и укажите значения следующих переменных:
  
 
{| class="wikitable"
 
{| class="wikitable"
Строка 39: Строка 41:
 
! Название !! Системное название !! Значение
 
! Название !! Системное название !! Значение
 
|-
 
|-
|API || DeliveryHost || https://start.maxoptra.com/rest/2
+
|API || DeliveryHost || https://commerceX.maxoptra.ru/rest/2,<br> где X — число, см. в ссылке на личный кабинет.<br>Например, для личного кабинета по ссылке вида https://commerce5.maxoptra.ru/vesna<br>путь к API будет https://commerce5.maxoptra.ru/rest/2
 
|-
 
|-
|Идентификатор аккаунта || DeliveryAccountID || demo8888888
+
|Идентификатор аккаунта || DeliveryAccountID || См. в ссылке на личный кабинет.<br>Например, в ссылке вида https://commerce5.maxoptra.ru/vesna идентификатор аккаунта — vesna
 
|-
 
|-
|Логин || DeliveryLogin || User1
+
|Логин || DeliveryLogin || Логин от учетной записи личного кабинета Максоптры
 
|-
 
|-
|Пароль || DeliveryPass ||  
+
|Пароль || DeliveryPass || Пароль от учетной записи личного кабинета Максоптры
 
|-
 
|-
 
|Включить поддержку пешеходов || DeliveryPedestrian || Включить, если на аккаунте активирована такая опция
 
|Включить поддержку пешеходов || DeliveryPedestrian || Включить, если на аккаунте активирована такая опция
 
|-
 
|-
|Время начала маршрута || DeliveryWorkBegin || Время выхода курьеров на маршрут, по умолчанию - 08:00
+
|Время начала маршрута || DeliveryWorkBegin || Время выхода курьеров на маршрут, по умолчанию — 08:00
 
|-
 
|-
|Время завершения маршрута || DeliveryWorkEnd || Время ухода курьеров с маршрута, по умолчанию - 21:00
+
|Время завершения маршрута || DeliveryWorkEnd || Время ухода курьеров с маршрута, по умолчанию — 21:00
 
|-
 
|-
 
|}
 
|}
  
 
== Настройка курьеров ==
 
== Настройка курьеров ==
 
 
Курьеры автоматически создаются в Максоптре. График работы курьера будет как у распределительного центра, с которым он работает (филиала).
 
Курьеры автоматически создаются в Максоптре. График работы курьера будет как у распределительного центра, с которым он работает (филиала).
  
 
== Настройка автомобилей ==
 
== Настройка автомобилей ==
 +
В Максоптру автоматически передаются автомобили, которые указаны в карточке курьера.
  
В максоптру автоматически передаются автомобили, которые указаны в карточке курьера. [[Файл:3 Maxoptra.png|200px|thumb|right|Автокурьер]]'''Только при наличии привязанного автомобиля, курьер считается автокурьером.''' При планировании считается, что курьер выходит на маршрут на этом автомобиле. Вместе курьер и машина определяют все логистические условия. Например, машина определяет, какую массу можно перевезти, а курьер устанавливает рабочее время.
+
Только при наличии привязанного автомобиля курьер считается автокурьером.
 +
 
 +
При планировании считается, что курьер выходит на маршрут на этом автомобиле. Вместе курьер и машина определяют все логистические условия. Например, машина определяет, какую массу можно перевезти, а курьер устанавливает рабочее время.
  
 
== Пешие курьеры ==
 
== Пешие курьеры ==
 +
Это дополнительная оплачиваемая опция «Типы транспортных средств», по умолчанию она выключена для аккаунта. После подключения опции в аккаунте включите ее и в MeaSoft, в переменной '''Включить поддержку пешеходов'''.
  
Это дополнительная оплачиваемая опция '''“Типы транспортных средств”''', по умолчанию она выключена на аккаунте. После подключения опции на аккаунте, необходимо включить ее  в курьерской службе, в переменной '''DeliveryPedestrian'''.
+
В Максоптре пешие курьеры «ездят» на автомобилях с типом '''транзит''' или '''пешеход'''.
В Максоптре пешие курьеры ездят на  автомобилях с типом '''транзит''' или '''пешеход'''. Транзит – это общественный транспорт: автобус, метро, электричка.  Если в курьерской службе, условно, 10 пеших курьеров, то необходимо 10 автомобилей  с типом транзит.  По АПИ невозможно установить такой признак, поэтому автомобили для пеших курьеров создаются вручную в ЛК Максоптры. Планирование происходит также, как и для автокурьеров, курьерская служба сама отправит пеших курьеров на автомобилях с типом '''транзит''' или '''пешеход'''.
 
  
 +
Транзит — это общественный транспорт: автобус, метро, электричка. Если в курьерской службе, например, 10 пеших курьеров, то нужны 10 автомобилей с типом «транзит». По API невозможно установить такой признак, поэтому автомобили для пеших курьеров создаются вручную в ЛК Максоптры.
  
'''Инструкция''' по созданию пеших курьеров  - [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=1966104 '''здесь'''].
+
Планирование происходит так же, как и для автокурьеров, MeaSoft сам отправит пеших курьеров на автомобилях с типом «транзит» или «пешеход».
 +
 
 +
'''Инструкция''' по созданию пеших курьеров — [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=1966104 '''здесь'''].
  
 
== Настройка территорий ==
 
== Настройка территорий ==
 +
Территории — это районы в MeaSoft. '''Территории не обязательны''', по умолчанию Максоптра планирует маршруты без них.
  
Территории — это районы в Курьерской службе 2008. Максоптра не поддерживает передачу территорий по API. Территории нужно рисовать на карте в ЛК Максоптры, там же необходимо привязывать к ним курьеров.  Курьерская служба может обновлять данные курьера и сохранять настроенные привязки по территории в ЛК Максоптры. На данный момент поддерживаются территории только для курьеров, если территорию указать для машины, то она будет сброшена при последующей синхронизации машин.
+
Максоптра не поддерживает передачу территорий по API. Нарисуйте территории на карте в ЛК Максоптры и привяжите к ним курьеров.
'''Территории не обязательны''', по умолчанию Максоптра планирует маршруты без них.
 
  
'''Инструкция''' по настройке территорий - [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=1966088 '''здесь'''].
+
MeaSoft может обновлять данные курьера и сохранять настроенные привязки по территории в ЛК Максоптры.
 +
 
 +
На данный момент поддерживаются территории только для курьеров, если территорию указать для машины, то она будет сброшена при последующей синхронизации машин.
 +
 
 +
'''Инструкция''' по настройке территорий — [https://doc.maxoptra.com/docs/pages/viewpage.action?pageId=1966088 '''здесь'''].
  
 
Порядок маршрутизации с территориями:
 
Порядок маршрутизации с территориями:
#маршрутизация заказов попавших в территории, водителями из этих же территорий;
+
# Маршрутизация заказов, попавших в территории, на водителей из этих же территорий.
#маршрутизация заказов не попавшие в территории, на водителей с территорией. Если у водителя есть возможность обслужить заказы с территории и остается место, он может выполнить заказы и без территории;
+
# Маршрутизация заказов, не попавшие в территории, на водителей с территорией. Если у водителя есть возможность обслужить заказы с территории и остается место, он может выполнить заказы и без территории.
#маршрутизация заказов не попавших в территории, на водителей без территории;
+
# Маршрутизация заказов, не попавших в территории, на водителей без территории.
  
 
== Построение маршрутов ==
 
== Построение маршрутов ==
 +
После ввода настроек аккаунта и настроек регионального центра можно приступать к построению маршрутов.
  
После ввода настроек аккаунта и настроек регионального центра, можно приступать к построению маршрутов. [[Файл:4 Maxoptra.png|200px|thumb|right|Построение маршрутов]]Необходимо вывести адреса на карту. Открыть интерфейс маршрутизации и нажать кнопку “Планировать”. [[Файл:5 Maxoptra.png|200px|thumb|right|Личный кабинет Максоптра]]Построенные маршруты можно запланировать на всех курьеров “Подтвердить все маршруты” или назначить по одному, через контекстное меню таблицы “Маршруты”. Все адреса, которые небыли запланированы в маршрут, будут отображены на вкладке “Незапланированно”, через контекстное меню, их также можно принудительно поместить в уже существующий маршрут.
+
Данные курьеров, машин и заказов синхронизируются при планировании.
Если маршруты не построились, а на вкладке “незапланированно” – отсутствует информация по ошибкам, то более подробную информацию можно узнать в ЛК максоптры. К сожалению не все ошибки можно узнать по АПИ.
+
 
 +
[[Файл:4 Maxoptra.png|600px|none]]
 +
 
 +
В MeaSoft отобразите адреса на карте. Откройте интерфейс маршрутизации и нажмите на кнопку '''Планировать'''.
 +
 
 +
[[Файл:5 Maxoptra.png|600px|none]]
 +
 
 +
Возможные действия с построенными маршрутами:
 +
* запланировать на всех курьеров по кнопке '''Подтвердить все маршруты''';
 +
* назначить по отдельным курьерам через контекстное меню таблицы '''Маршруты''';
 +
* назначить весь маршрут одного курьера другому. После этого необходимо повторно запустить автоматические планирование.
 +
 
 +
Все адреса, не запланированные в маршрут, отображаются на вкладке '''Незапланировано'''. С помощью контекстного меню их можно принудительно поместить в существующий маршрут.
 +
 
 +
 
 +
Если маршруты не построились, а на вкладке '''Незапланировано''' отсутствует информация об ошибках, см. подробную информацию в ЛК Максоптры. Заходить в ЛК нужно сразу после ошибки планирования, иначе данные перезаписываются следующим планированием.
  
 
== Печать акта и мобильное приложение ==
 
== Печать акта и мобильное приложение ==
 +
После планирования маршрута на курьера, в адресах сохраняется номер в маршруте и время прибытия. Печать стандартного акта передачи материальных ценностей в выдаче устанавливает столбец «Номер в акте». Сортировка адресов в акте в первую очередь идет по порядковому номеру в маршруте. Как заполняется номер в акте, регулируется в переменной <mparam code="StoreGivnActPos/>.
  
После планирования маршрута на курьера, в адресах, сохраняется номер в маршруте и время прибытия.  Печать стандартного акта передачи материальных ценностей в выдаче, устанавливает столбец “Номер в акте”. Сортировка адресов в акте, в первую очередь идет по порядковому номеру в маршруте. Как заполняется номер в акте регулируется в переменной <mparam code="StoreGivnActPos/>.
+
Если у пользователя настроен пользовательский акт передачи материальных ценностей, его необходимо дорабатывать, вероятнее всего, он не будет правильно заполнять столбец «Номер в акте». Какой акт используется, можно посмотреть в <mparam code="PRINT_AKT_TYPE/>.
Если у пользователя настроен пользовательский акт передачи материальных ценностей, то его необходимо дорабатывать, вероятнее всего он не будет правильно заполнять столбец “номер в акте”. Какой акт используется, можно посмотреть в <mparam code="PRINT_AKT_TYPE/>.
 
  
В мобильном приложении курьера, заказы сортируются по “номеру в акте” из выдачи. А в самом акте, адреса в первую очередь сортируются по “номеру в маршруте” из адресов. Если акт не распечатать, то в мобильном приложении не будет сортировки по маршруту.
+
В мобильном приложении курьера заказы сортируются по столбцу «Номер в акте» из выдачи. В самом акте адреса сортируются по номеру в маршруте из адресов.
  
 
== Устранение неполадок ==
 
== Устранение неполадок ==
 
+
# Маршруты не планируются (при динамических перерывах) или планируются на второю половину дня при фиксированных перерывах. Сравните график работы курьера и регионального центра, чтобы курьер не начинал работать раньше своего РЦ. Если планирование идет текущим днем, то прошедшее время выпадает из плана.
#Маршруты не планируются (при динамических перерывах) или планируются на второю половину дня при фиксированных перерывах. Необходимо сравнить график работы курьера и регионального центра, чтобы курьер не начинал работать раньше своего РЦ. Если планирование идет текущим днем, то прошедшее время выпадает из плана.
+
# Маршруты не строятся для заказов, попавших в территории. Возможно, нет водителей, работающих в этих территориях. Также надо проверить, что нет конфликта когда у машины указаны одни территории, а у водителя другие. Особенно касается пеших курьеров, так как настраивается вручную и территории машины для пешего курьера автоматически не сбрасываются.
#Маршруты не строятся для заказов, попавших в территории. Возможно нет водителей, работающих в данных территориях. Также надо проверить, что нет конфликта, это когда у машины указаны одни территории, а у водителя другие. Особенно касается пеших курьеров, т.к. настраивается вручную и территории машины для пешего курьера автоматически не сбрасывается.
+
# Не строятся маршруты для пеших курьеров. Проверьте, достаточно ли машин с признаком пешего курьера (транзита). Проверьте зоны курьера и грузоподъемность машины.
#Не строятся маршруты для пеших курьеров. Необходимо проверить достаточное количество машин с признаком пешего курьера (транзита). Проверить зоны курьера и грузоподъемность машины.  
+
# Не все заказы попадают в маршруты во время перерыва. Проверьте тип перерыва на обед, должен быть «динамический» с возможностью его сдвига.
#Не все заказы попадают в маршруты во время перерыва. Проверить тип перерыва на обед, должен быть “динамический” с возможностью его сдвига.
+
# При запуске планировщика возникает ошибка с кодом 1015. Включите роль «диспетчер» у пользователя Максоптры. Проверьте, что пользователь с ролью диспетчера привязан к распределительным центрам.
#При запуске планировщика возникает ошибка с кодом 1015. Необходимо включить роль “диспетчер” у пользователя максоптры. Также нужно проверить, что пользователь с ролью диспетчера привязан к распределительным центрам.
+
# Личный кабинет Максоптры не загружается. Авторизация происходит успешно, но область с машинами, заказами и картой остаётся неактивной. Должна помочь комбинация CTRL+F5.
#Личный кабинет максоптры не загружается. Авторизация происходит успешно, но область с машинами, заказами и картой остаётся не активной. Должна помочь комбинация Ctrl + F5
+
# Появляется «Ошибка, нет ни одного исполнителя с машиной. Обратите внимание на курьеров в маршрутах, возможно были ошибки синхронизации.» Eсли у курьеров ошибка «Internal service error: Performer external id should be unique» — возможно, ошибка Максоптры, такое было при переносе данных с тестового аккаунта на боевой. Помогло удаление всех водителей в ЛК Максоптры, после этого они успешно добавляются и обновляются в системе.
#Появляется ошибка  “Ошибка, нет ни одного исполнителя с машиной. Обратите внимание на курьеров в маршрутах, возможно были ошибки синхронизации.Eсли у курьеров ошибка “Internal service error: Performer external id should be unique” – возможно глючит максоптра, такое было при переносе данных с демо аккаунта на боевой. Помогло удаление всех водителей в ЛК максоптры, после этого они успешно добавляются и обновляются в системе.
 

Текущая версия на 13:56, 11 марта 2022

MeaSoft — официальный дилер системы маршрутизации Максоптра. Мы предоставляем услуги маршрутизации по основному договору, по специальным ценам, доступным только пользователям нашей системы.

При автоматическом планировании маршрутов система распределяет заказы между курьерами с учетом интервалов доставки, веса, объема грузов. Поддерживаются пешие курьеры. Учитывает наличие пропусков и прочих ограничений движения транспорта. Можно использовать зонирование и распределять заказы по районам, а уже внутри них — строить маршруты. Система учитывает стоимость часа курьера и километра пробега и рассчитывает оптимальный маршрут. В результате маршрутизации наша система получает данные о вхождении отправлений в маршруты
, расчетное время прибытия курьера на адрес
, и последовательность объезда
адресов курьером.

С чего начать

Чтобы начать использовать маршрутизацию, обратитесь в нашу службу технической поддержки. Мы создадим тестовый аккаунт для вашей компании, передадим вам доступы, поможем настроить маршрутизацию под ваши требования. Далее, в течение 2-х недель вы бесплатно пользуетесь, тестируете, и по истечение этого срока, если вас устраивает качество работы, переводим аккаунт в боевой платный режим.

Настройка распределительных центров

Зайдите по присланным данным в ЛК Максоптры. Распределительные центры — это филиалы в MeaSoft, их необходимо вручную создать в Максоптре, название региональных центров должно полностью совпадать с вашим названием филиалов. Адрес распределительного центра нужно указывать настоящий, с этого адреса курьеры выходят на маршрут.

1 Maxoptra.png

Заполните:

  1. Точное название.
  2. Адрес.
  3. Время работы. Лучше ставить максимально возможное, курьеры будут выходить на маршрут по своему графику.

Инструкция как создавать распределительные центры — здесь.

Создание пользователя с ролью диспетчера

Маршруты строятся под пользователем с ролью Диспетчер.

2 Maxoptra.png

Если нужно, создайте нового пользователя, укажите роль «Диспетчер» и привяжите к нему региональные центры, которые он может обслуживать.

Заполните:

  1. Имя, логин, пароль, установите флажок «Доступ к API».
  2. Включите роль диспетчера, привяжите к пользователю филиалы, которые он обслуживает;
  3. Включите роль администратор аккаунта, появится возможность менять настройки планирования с одного аккаунта.

Инструкция как создавать пользователя — здесь.

Многофилиальная система может работать под одним пользователем Максоптры при условии, что одновременно планирование идет для разных филиалов.

Настройка подключения к Максоптре

В MeaSoft откройте Справочники > Переменные > Подключения > Карты > Маршрутизация и укажите значения следующих переменных:

Название Системное название Значение
API DeliveryHost https://commerceX.maxoptra.ru/rest/2,
где X — число, см. в ссылке на личный кабинет.
Например, для личного кабинета по ссылке вида https://commerce5.maxoptra.ru/vesna
путь к API будет https://commerce5.maxoptra.ru/rest/2
Идентификатор аккаунта DeliveryAccountID См. в ссылке на личный кабинет.
Например, в ссылке вида https://commerce5.maxoptra.ru/vesna идентификатор аккаунта — vesna
Логин DeliveryLogin Логин от учетной записи личного кабинета Максоптры
Пароль DeliveryPass Пароль от учетной записи личного кабинета Максоптры
Включить поддержку пешеходов DeliveryPedestrian Включить, если на аккаунте активирована такая опция
Время начала маршрута DeliveryWorkBegin Время выхода курьеров на маршрут, по умолчанию — 08:00
Время завершения маршрута DeliveryWorkEnd Время ухода курьеров с маршрута, по умолчанию — 21:00

Настройка курьеров

Курьеры автоматически создаются в Максоптре. График работы курьера будет как у распределительного центра, с которым он работает (филиала).

Настройка автомобилей

В Максоптру автоматически передаются автомобили, которые указаны в карточке курьера.

Только при наличии привязанного автомобиля курьер считается автокурьером.

При планировании считается, что курьер выходит на маршрут на этом автомобиле. Вместе курьер и машина определяют все логистические условия. Например, машина определяет, какую массу можно перевезти, а курьер устанавливает рабочее время.

Пешие курьеры

Это дополнительная оплачиваемая опция «Типы транспортных средств», по умолчанию она выключена для аккаунта. После подключения опции в аккаунте включите ее и в MeaSoft, в переменной Включить поддержку пешеходов.

В Максоптре пешие курьеры «ездят» на автомобилях с типом транзит или пешеход.

Транзит — это общественный транспорт: автобус, метро, электричка. Если в курьерской службе, например, 10 пеших курьеров, то нужны 10 автомобилей с типом «транзит». По API невозможно установить такой признак, поэтому автомобили для пеших курьеров создаются вручную в ЛК Максоптры.

Планирование происходит так же, как и для автокурьеров, MeaSoft сам отправит пеших курьеров на автомобилях с типом «транзит» или «пешеход».

Инструкция по созданию пеших курьеров — здесь.

Настройка территорий

Территории — это районы в MeaSoft. Территории не обязательны, по умолчанию Максоптра планирует маршруты без них.

Максоптра не поддерживает передачу территорий по API. Нарисуйте территории на карте в ЛК Максоптры и привяжите к ним курьеров.

MeaSoft может обновлять данные курьера и сохранять настроенные привязки по территории в ЛК Максоптры.

На данный момент поддерживаются территории только для курьеров, если территорию указать для машины, то она будет сброшена при последующей синхронизации машин.

Инструкция по настройке территорий — здесь.

Порядок маршрутизации с территориями:

  1. Маршрутизация заказов, попавших в территории, на водителей из этих же территорий.
  2. Маршрутизация заказов, не попавшие в территории, на водителей с территорией. Если у водителя есть возможность обслужить заказы с территории и остается место, он может выполнить заказы и без территории.
  3. Маршрутизация заказов, не попавших в территории, на водителей без территории.

Построение маршрутов

После ввода настроек аккаунта и настроек регионального центра можно приступать к построению маршрутов.

Данные курьеров, машин и заказов синхронизируются при планировании.

4 Maxoptra.png

В MeaSoft отобразите адреса на карте. Откройте интерфейс маршрутизации и нажмите на кнопку Планировать.

5 Maxoptra.png

Возможные действия с построенными маршрутами:

  • запланировать на всех курьеров по кнопке Подтвердить все маршруты;
  • назначить по отдельным курьерам через контекстное меню таблицы Маршруты;
  • назначить весь маршрут одного курьера другому. После этого необходимо повторно запустить автоматические планирование.

Все адреса, не запланированные в маршрут, отображаются на вкладке Незапланировано. С помощью контекстного меню их можно принудительно поместить в существующий маршрут.


Если маршруты не построились, а на вкладке Незапланировано отсутствует информация об ошибках, см. подробную информацию в ЛК Максоптры. Заходить в ЛК нужно сразу после ошибки планирования, иначе данные перезаписываются следующим планированием.

Печать акта и мобильное приложение

После планирования маршрута на курьера, в адресах сохраняется номер в маршруте и время прибытия. Печать стандартного акта передачи материальных ценностей в выдаче устанавливает столбец «Номер в акте». Сортировка адресов в акте в первую очередь идет по порядковому номеру в маршруте. Как заполняется номер в акте, регулируется в переменной Сохранять номер строки в акте передачи курьеру
. Если у пользователя настроен пользовательский акт передачи материальных ценностей, его необходимо дорабатывать, вероятнее всего, он не будет правильно заполнять столбец «Номер в акте». Какой акт используется, можно посмотреть в Печатная форма акта
.

В мобильном приложении курьера заказы сортируются по столбцу «Номер в акте» из выдачи. В самом акте адреса сортируются по номеру в маршруте из адресов.

Устранение неполадок

  1. Маршруты не планируются (при динамических перерывах) или планируются на второю половину дня при фиксированных перерывах. Сравните график работы курьера и регионального центра, чтобы курьер не начинал работать раньше своего РЦ. Если планирование идет текущим днем, то прошедшее время выпадает из плана.
  2. Маршруты не строятся для заказов, попавших в территории. Возможно, нет водителей, работающих в этих территориях. Также надо проверить, что нет конфликта — когда у машины указаны одни территории, а у водителя другие. Особенно касается пеших курьеров, так как настраивается вручную и территории машины для пешего курьера автоматически не сбрасываются.
  3. Не строятся маршруты для пеших курьеров. Проверьте, достаточно ли машин с признаком пешего курьера (транзита). Проверьте зоны курьера и грузоподъемность машины.
  4. Не все заказы попадают в маршруты во время перерыва. Проверьте тип перерыва на обед, должен быть «динамический» с возможностью его сдвига.
  5. При запуске планировщика возникает ошибка с кодом 1015. Включите роль «диспетчер» у пользователя Максоптры. Проверьте, что пользователь с ролью диспетчера привязан к распределительным центрам.
  6. Личный кабинет Максоптры не загружается. Авторизация происходит успешно, но область с машинами, заказами и картой остаётся неактивной. Должна помочь комбинация CTRL+F5.
  7. Появляется «Ошибка, нет ни одного исполнителя с машиной. Обратите внимание на курьеров в маршрутах, возможно были ошибки синхронизации.» Eсли у курьеров ошибка «Internal service error: Performer external id should be unique» — возможно, ошибка Максоптры, такое было при переносе данных с тестового аккаунта на боевой. Помогло удаление всех водителей в ЛК Максоптры, после этого они успешно добавляются и обновляются в системе.