Для передачи даты и времени во всех сервисах используется формат UNIXTIME (в секундах), единицы измерения остальных параметров – согласно указанному.

| Boolean status – true/false true в случае успешной операции
Unixtimestamp timeBegin (секунды) – время начала интервала
Unixtimestamp timeEnd (секунды) – время окончания интервала
Double fuelConsumptionWithout Movement – расход топлива без движения за период, литры, с точностью до 0.1 литра
String error – текст сообщения об ошибке в случае возникновения ошибки |

Список возвращаемых ошибок:

0: No errors – ошибок нет

1: Signing in failed – неправильно введен логин / пароль

2: Authorization required – для доступа к данным необходима авторизация

3: Dead session number – сессия закончена, необходимо авторизоваться заново

4: Bad interval – неправильно введен временной интервал

5: Bad object – объекта с таким идентификатором не существует

6: Admin login – попытка авторизации от имени пользователя с правами Администратора

7: Unusable object – значение не может быть рассчитано для объекта с данным идентификатором

8: Bad event type – типа события с таким идентификатором не существует

9: Access denied – нет прав доступа на объект

10: Data not found – не найдены данные для соответствующих входных значений

11: Blocked interval – запрашиваемый период содержит периоды блокировки данных

12: Bad object type – указанный тип объекта не существует.

13: Invalid format – неверный формат

14: Undefined error – неопределенная ошибка

15: 404 – несуществующая страница

Импорт интерфейсов

wsimport -d bin -s src http://demo.omnicomm.ru:8000/AnalyticalServer/ws?wsdl

Java-код:

Строки «user» и «pass» необходимо заменить реальными значениями.

package ru.omnicomm.test.client;

import ru.omnicomm.analyticalserver.*;

import java.net.MalformedURLException; 

import java.net.URL; 

import java.util.List;

public class  ExampleClient { 
    public static void main(String[] args) throws MalformedURLException {
        AnalyticalServer = new AnalyticalServer(new URL("http://demo.omnicomm.ru:8000/AnalyticalServer/ws?wsdl")); 

        AnalyticalServerWS port = AnalyticalServer.getAnalyticalServerPort(); 

        AuthResponseEntry auth = port.signIn("user", "pass"); 

        String sessionId = auth.getsessionId (); 

        System.out.println("auth sessionId: " + sessionId); 

        ObjectSetResponseEntry objects = port.getObjectSet(sessionId); 
        List<Vehicle> vehicles = objects.getVehicleList(); 

        for (Vehicle vehicle : vehicles) { 
            System.out.printf("vehicle: %d / %s\n", vehicle.getVehicleID(), vehicle.getRegNmb()); 
        }

    }
}

Примером реализованной интеграции является программный продукт на базе 1С:Предприятие 8 компании Рарус – «Управление автотранспортом Проф».

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

Полное описание конфигурации приведено по адресу: http://rarus.ru/1c-transport/1c8-avtotransport-prof/#tab-product-func-link

При совместной работе с Omnicomm Online «Управление автотранспортом Проф» автоматически или в ручном режиме загружает из Omnicomm Online следующие данные:

• Местоположение ТС
• Значение одометра
• Текущая скорость
• Время работы двигателя и дополнительного оборудования
• Текущее значение уровня топлива
• Общий расход топлива
• Количество заправленного топлива

Также загружается информация о событиях:

• Превышения скорости
• Нарушения предельных режимов работы оборудования
• Сливы топлива

На основании полученных данных доступно построение отчетов:

• Сравнение заправок, введенных вручную, с полученными по данным Omnicomm Online
• План-фактный анализ по пробегу и расходу топлива
• Отчет по событиям

План-фактный анализ. Сравнение фактических и плановых значений пробега и расхода топлива.

Заправочная ведомость. Сравнение фактических и заявленных объемов заправок ГСМ.

Отчет по событиям Omnicomm Online

Вывод отчетов в 1С не ограничен приведенными примерами и расширяем даже при использовании стандартной конфигурации «Управление автотранспортом ПРОФ». Дополняйте шаблоны вывода ответов (например: добавляйте информацию о плановом и фактическом времени работы водителя в план-фактный отчет) или создавайте новые.