Передача данных о маршруте движения груза и номера ТС для Меркурия

Передача информации о складах перегруза поставщикам из системы ALTLOG-онлайн

Лог-оператор предоставляет данные для системы Меркурий перед каждой отгрузкой (до того как груз погружен в машину). После того как производитель внесет данные в систему Меркурий машина может приступать к перевозке.

Данные по маршрутам и ТС Заказчику отправляются автоматически при отгрузке маршрутного листа в системе. При каждой отгрузке передаются обновленные данные. При первой передаче данных передаются все возможные пункты перегрузки груза. Канал передачи данных настраивается в карточке юридического лица.

В зависимости выбранного канала передачи данных Заказчик может так же самостоятельно их забирать используя GET API

Маршруты в системе Оnline логистика

Настройки для лог операторов:

Маршруты хранятся по адресу:
вкладка Справочники -> Пункты доставок -> блок "Настройки для Меркурия" -> Список возможных складов перегруза.

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

Работа с маршрутами для Заказчиков

Маршруты можно получать с помощью GET API, описание тут

Выгрузка XML файла

Выгрузить XML файл для Меркурия возможно в системе Оnline логистика (доступ "Администратор"), Заказчики могут самостоятельно выгружать из рабочего кабинета клиента.

В системе Оnline логистика
Склад - Расход
В рабочем кабинете клиента.
Рядом с каждым заказом.

Передача информации о складах перегруза поставщикам из системы altlog-онлайн

Для "Юридических лиц" можно настроить способ передачи информации:
Вкладка "Справочники"
раздел "Список юридических лиц" - Изменение юридического лица
Вкладка "Меркурий"
В окне "Транспорт" представлены следующие варианты:
1. Не использовать - по умолчанию.
2. Высылать на Email - второй по безопасности. Возможна отправка информации в формате Exce/XML на электронную ящик/ящики. Клиент может установить в почте доп. программу для обработки и дальнейшей прогрузки данных.
3. Выкладывать на FTP - данные отправляются в виртуальную папку. Возможно использование папки лог-оператора или клиента. Информация обновляется при открытии папки.
4. Использовать Web Service - самый правильный способ. Вариант получения информации через веб-сервис логистического оператора. Аltlog-онлайн сам прогружает данные в момент отгрузки. Клиент на своей стороне должен произвести ряд действий с API, например, вписать доступы. API ключ у каждого свой.

API получения XML для Меркурия из программы ON-LINE ЛОГИСТИКА (altlog.ru)
Забирать XML по HTTPS протоколу (просто скачать файл) для нужной ему накладной можно по ссылке:

вместо фигурных скобок подставить данные
https://altlog.ru/mercury/get_xml.htm?api-key={API-KEY}&issueNumber={WB_NUMBER}&issueDate={WB_DATE}

Где:
altlog.ru - домен логистического оператора. Обычно это домен второго уровня, например stl.altlog.ru

{API-KEY} - Ключ доступа клиента - выдаётся Заказчику персональным менеджером и находится в настройках пользователя.

{WB_NUMBER} - Номер накладной

{WB_DATE} - Дата накладной, указанная в формате ГГГГ-ММ-ДД

Варианты передачи информации в Меркурий поставщиком:

- Предварительно через API, получить список пунктов и загрузить их в свою систему, например в 1С. Данный вариант подходит если изначально известен пункт выгрузки.

- Установить в 1С/SAP модуль интеграции с Меркурием, тогда информация будет подгружаться автоматоматически.

- Ручное занесение данных через сайт Меркурия. В этом случае важен формат передачи пунктов выгрузки.

Пример структуры отдельного файла

Поле <transshipment> показывает был перегруз или нет. Значение "falsе" блокирует место, означает что на указанном складе не может быть перегруза.

При отгрузке в конечную точку всем пунктам перегруза, в которых перегруза реально не было, в поле transshipment проставляется "Falsе". Данный параметр указывает, что перегруза не было. Везде где перегруза не было в поле <vehicleNumber> будет указан номер машины, которая доставляла в последнюю точку.

Обновления

2024.02.07

Изменен алгоритм формирования флага в поле "transshipment".

Поле остается пустым для пунктов, в которых или в которые не была произведена отгрузка.

Поле заполняется флагом "true" при отгрузке с пункта перегрузки для точки отгрузки и точки перегрузки. Если отгрузка производится в конечную точку, то все пустые поля "transshipment" - склады где не было перегрузки заполняются флагом "false", в этих точках как и раньше проставляется ТС, следующее на конечную точку согласно требованиям системы Меркурий.