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

Материал из Меасофт
Перейти к: навигация, поиск
м
м (Настройка подключения к Максоптре)
Строка 32: Строка 32:
  
 
== Настройка подключения к Максоптре ==
 
== Настройка подключения к Максоптре ==
Запускаем Курьерскую Службу 2008, необходимо прописать настройки подключения к Максоптре в следующих переменных раздела ''"Справочники" -> "Переменные" -> "Подключения" -> "Карты" -> "Маршрутизация"'':
+
 
 +
В MeaSoft откройте '''Справочники''' > '''Переменные > '''Подключения''' > '''Карты''' > '''Маршрутизация''' и укажите значения следующих переменных:
  
 
{| class="wikitable"
 
{| class="wikitable"
Строка 38: Строка 39:
 
! Название !! Системное название !! Значение
 
! Название !! Системное название !! Значение
 
|-
 
|-
|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 || Включить, если на аккаунте активирована такая опция

Версия 09:45, 23 марта 2021

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

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

С чего начать

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

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

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

Заполняем:

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

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

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

Маршруты строятся под пользователем с ролью Диспетчер.
Пользователь Максоптра
Если нужно, создаем нового пользователя, указываем роль “Диспетчер” – привязываем к нему региональные центры, которые он может обслуживать.

Заполняем:

  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

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

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

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

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

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

Это дополнительная оплачиваемая опция “Типы транспортных средств”, по умолчанию она выключена на аккаунте. После подключения опции на аккаунте, необходимо включить ее в курьерской службе, в переменной DeliveryPedestrian. В Максоптре пешие курьеры ездят на автомобилях с типом транзит или пешеход. Транзит – это общественный транспорт: автобус, метро, электричка. Если в курьерской службе, условно, 10 пеших курьеров, то необходимо 10 автомобилей с типом транзит. По АПИ невозможно установить такой признак, поэтому автомобили для пеших курьеров создаются вручную в ЛК Максоптры. Планирование происходит также, как и для автокурьеров, курьерская служба сама отправит пеших курьеров на автомобилях с типом транзит или пешеход.


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

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

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

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

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

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

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

После ввода настроек аккаунта и настроек регионального центра, можно приступать к построению маршрутов.
Построение маршрутов
Необходимо вывести адреса на карту. Открыть интерфейс маршрутизации и нажать кнопку “Планировать”.
Личный кабинет Максоптра
Построенные маршруты можно запланировать на всех курьеров “Подтвердить все маршруты” или назначить по одному, через контекстное меню таблицы “Маршруты”. Все адреса, которые небыли запланированы в маршрут, будут отображены на вкладке “Незапланированно”, через контекстное меню, их также можно принудительно поместить в уже существующий маршрут.

Если маршруты не построились, а на вкладке “незапланированно” – отсутствует информация по ошибкам, то более подробную информацию можно узнать в ЛК максоптры. К сожалению не все ошибки можно узнать по АПИ.

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

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

В мобильном приложении курьера, заказы сортируются по “номеру в акте” из выдачи. А в самом акте, адреса в первую очередь сортируются по “номеру в маршруте” из адресов. Если акт не распечатать, то в мобильном приложении не будет сортировки по маршруту.

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

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