Обмен данными с ON-LINE ЛОГИСТИКА по перегрузке алкоголя для ЕГАИС

Варианты получения данных:

По электронной почте в момент перегрузки в формате csv или xml
Через папку ftp в момент перегрузки в формате csv или xml
Через запрос к API ON-LINE ЛОГИСТИКА в произвольный момент в формате xml или json
Самый правильный вариант! Обращением к API Поставщика из программы ON-LINE ЛОГИСТИКА в момент перегрузки в формате json или xml

Передача данных по электронной почте в момент перегрузки в формате csv или xml

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

Для получения данных по электронной почте необходимо:

определиться с форматом данных
сообщить об этом Вашему менеджеру в логистической компании
сообщить Вашему менеджеру в логистической компании адрес электронной почты, но который должны приходить Акты перегрузки

В момент перегрузки груза Вам будет приходить письмо с файлом формата csv или xml

Передача данных в FTP папку в момент перегрузки

! Это неправильный способ, так как Вы не знаете когда транспортное средство было перегружено и можете слишком поздно запросить данные с FTP папки, что может привести к несвоевременной регистрации факта перегрузи и проблемами с Грузополучателем и органами исполнительной власти

Для получения данных в FTP папку необходимо:

определиться с форматом данных, приходящих на FTP в виде файлов csv или xml
сообщить об этом Вашему менеджеру в логистической компании
запросить реквизиты FTP доступа к папке, либо предоставить свои

Данные на FTP передаются в формате csv или xml в момент перегруза (загрузки груза в новую машину)

Запрос к API ON-LINE ЛОГИСТИКА в произвольный момент

! Это самый неправильный способ, так как Вы не знаете когда транспортное средство было перегружено и можете слишком поздно запросить данные с сервера ON-LINE ЛОГИСТИКА, что может привести к несвоевременной регистрации факта перегрузи и проблемами с Грузополучателем и органами исполнительной власти

Независимо от выбранного способа получения данных, Вы можете обращаться к API ON-LINE ЛОГИСТИКА. Для этого необходимо:

сообщить о таком желании Вашему менеджеру логистической компании
получить ключ авторизации у Вашего менеджера в логистической компании {API-KEY}

Забирать данные можно по ссылке:

https://{LOG}.altlog.ru/alco/get_json.htm?api-key={API-KEY}&issueNumber={WB_NUMBER}&issueDate={WB_DATE}

где:

{LOG} - префикс Вашей логистической компании (например, у СТЛ это stl)
{API-KEY} - Ключ доступа
{WB_NUMBER} - Номер накладной 
{WB_DATE} - Дата накладной в формате ГГГГ-ММ-ДД

Ответ приходит в формате json. Пример:

{
  "number": "30514",
  "date": "2021-09-22 14:30:00",
  "transport_type": 413,
  "car_number": "",
  "trailer_number": "",
  "driver": "",
  "redirection_sign": "-",
  "address": "Россия,Москва, Ступинский пр-зд, д.1",
  "waybills": [
    {
      "number": "БА0820043",
      "date": "2021-03-20",
      "order": "81803"
    }
  ]
}

где:

number - номер акта перегруза, выданный сервисом ON-LINE ЛОГИСТИКА (номер МЛ)
date - дата перегруза
transport_type - тип транспорта (всегда 413 для автомобильного)
car_number - номер транспортного средства на которое произведена перегрузка
trailer_number - ноер полуприцепа
driver - Семенов Семен Иванович - ФИО водителя, принявшего груз к перевозке
edirection_sign - подпись водителя, принявшего груз к перевозке, всегда "-"
address - адрес перегрузки груза
waybills - массив со списком накладных Акта перегруза
number - номер накладной
date - дата накладной
order - номер заказа в сервисе ON-LINE ЛОГИСТИКА

Доступ производится от лица пользователя, владельца ключа

Если по накладной было несколько перегрузов, то json массив будет иметь несколько структур

! При разработке важно понимать, что в рамках текущей версии API в структуру json или xml изменения не могут быть внесены, при этом элементы / узлы могут пополняться дополнительными параметрами

HTTPS API Поставщика

! Самый правильный способ - написать API со своей стороны для получения Актов перегруза. Данные приходят в режиме онлайн в момент перегрузки груза (загрузки груза в новое транспортное средство)

Формат получения данных json, либо xml

Для получения данных в API поставщика необходимо:

написать свой API
сообщить о желании получать данные на свой API
передать Вашему менеджеру логистической компании:
- Ключ доступа
- Способ передачи ключа (в заголовок или в URL запроса)
- Адрес метода куда направляется POST запрос

Ответ должен содержать:

Успешный код HTTP ответа 200

{
 "status":true,
 "result":{}
}

Код HTTP ответа с ошибкой 4xx

{
  "status":false,
  "result":{4xx},
  "error":"Текст ошибки"
}

Все статьи