Какие произошли изменения: 3
- В api использовался ip адрес и порт реального сервера (server-01.beltranssat.by:22899), что являлось проблемой, т.к. клиенты были привязаны к нашей внутренней инфраструктуре.
Теперь все обращения идут по доменному имени и стандартному http порту (80).
Новые адреса сервисов логистики теперь следующие:
▶https://api.nav.by/info/ws_proxy.php?schema=vrp — заказы и оптимизация
▶https://api.nav.by/info/ws_proxy.php?schema=vehicles – автомобили
▶https://api.nav.by/info/ws_proxy.php?schema=zones – зоны
▶ https://api.nav.by/info/ws_proxy.php?schema=drivers— водители
Все новые адреса wsdl схем и сервисов также можно посмотреть в документации по интеграции с логистикой https://nav.by/info/documentation.php#123
2. 1С интеграция
Интеграция у клиентов написана так, что при внесении обратно-совместимых изменений в наше api (добавление поля в ответ или параметра в метод) интеграция перестает работать. Теперь мы всегда будем выпускать обратно-совместимые изменения в новой версии api.
Это потребует от клиентов, при интеграции с 1С, использовать динамические ссылки, т.е. нельзя встраивать статическую ws-ссылку в конфигурацию.
Изменения в api:
- Удален тип VehicleJaxbExt , который добавлял поле volume2 к VehicleJaxb. Теперь надо использовать поле VehicleJaxb.volume2Capacity.
- Удален тип CustomerDataAddJaxb который добавлял поле volume2 к CustomerDataJaxb. Теперь надо использовать поле CustomerDataJaxb.volume2. А также данное поле теперь будет приходить в ответах на запросы, в которых есть тип CustomerDataJaxb.
- Удален параметр addNames из методов getRoutes, getSolutionRoutes. Ранее, если задавать данный параметр, то в результате вызова методов, которые отдавали маршруты, в ответе возвращались дополнительные текстовые поля (driverId2, vehicleName, solutionName, solutionDescription).
- Из метода getPointStatus удален параметр addGeocodingState — статус геокодирования (geocodingState) — теперь он возвращается всегда.
- В CustomerDataJaxb добавлено поле text6. Т.е. теперь можно задавать text6 при добавлении заказа (addPoint), а также получать его при получении списка заказов маршрута (getRoutePoints).
ВНИМАНИЕ! Что делаем со старой версией?
Все клиенты в течение 3 месяцев должны обновить адреса наших сервисов. 12.08.2022 старая версия api будет отключена!
ЧУП «БелТрансСпутник»
Республика Беларусь, г. Минск, ул. Платонова, 12Б
+375 (17) 270-78-25
