Добавление рейсов

Remote API  > Команды на добавление  >

Добавление рейсов

Previous pageReturn to chapter overviewNext page

Параметры

 

com=add/rout

par= структуре rout_str

 

Один из параметров car_id или agent_id должен быть задан. На эту машину или агента будет подключен рейс. Если оба эти параметра >0 то рейс подключат к машине

 

Обязательные параметры rout_str

"car_id": <int>                            /* ID  машины */

"agent_id": <int>                /* ID  агента */

"date_id": <uint>                /* дата рейса  Unix time */

"tim_start": <uint>                /* дата и время планового старта рейса Unix time*/

"duration": <int>                /* продолжительность рейса в минутах */

"length": <int>                            /* длина рейса в метрах */

"work_status": <int>                  /* статус рейса если=10 то рей просто добавиться, если = 40 то в    случае наличия у агента мобильного устройства, будет сразу  отправлено ему */

"num_in_smena": <int>        /* номер в смене если рейсов несколько, =1 */

"mass": <double>                /* суммарная масса заказов на доставку */

"volum": <double>                  /* суммарный объем заказов на доставку */

"pickup_mass": <double>        /* суммарная масса заказов на сбор заказов */

"pickup_volum": <double>        /* суммарный объем заказов на сбор заказов */

"tasks":  List<task_str>        /* массив структур task_str описывающих задания в рейсе. Рейс без  задач создан не будет.*/

 

Необязательные параметры rout_str

 

"logistic_id": <text>                /* внутренний идентификатор логистики АНТОР */  

"extern_id": <text>                /* внешний идентификатор, переданный в логистику АНТОР из системы заказчика*/

"stock1": <stock_str>            /* структура stock_str описывающая склад выезда. Если передать null, то первая задача на складе добавлена не будет. Если  передать структуру описания склада, то программа проверит    наличие такого склада в системе ( проверка идет по  координатам ) если его нет, то создаст склад, создаст в складе задачу и добавит ее в начало рейса */

"stock2": <stock_str>            /* структура stock_str описывающая склад возврата.  Если передать null, то последняя задача на складе добавлена не будет. Если передать структуру описания склада, то программа проверит наличие такого склада в системе ( проверка идет по координатам ) если его нет, то создаст склад, создаст в складе задачу и добавит ее в конец рейса */

"driver": <text>                  /* фио водителя / агента */

"name": <text>                              /* название рейса */

 

Игнорируемые параметры rout_str

 

"id": <Guid>                        /* уникальный ид рейса*/

"num_point": <int>                /* количество заказов в рейсе*/

"num_rout": <int>                /* номер рейса в LiW*/

 

 

Обязательные параметры task_str

 

"lon_x": <double>                       /* координаты долгота */

"lat_y": <double>                        /* координаты широта */

"mass": <double>                /* масса заказа на доставку */

"volum": <double>                  /* объем заказа на доставку */

"pickup_mass": <double>        /* масса заказа на сбор заказов */

"pickup_volum": <double>        /* объем заказа на сбор заказов */

"date_id": <uint>                        /* дата заказа в Unix time - совпадает с data_id рейса*/

"plan_start": <uint>                    /* дата и время планового прибытия к клиенту Unix time */

"plan_duration": <int>               /* время в минутах работы у клиента */

"windows_start": <uint>            /* дата и время начала временного окна прибытия к клиенту Unix time */

"windows_duration": <int>        /* продолжительность временного окна в минутах */

 

 

Необязательные параметры task_str

 

"logistic_id": <text>                /* внутренний идентификатор логистики АНТОР */  

"extern_id": <text>                /* внешний идентификатор, переданный в логистику АНТОР

из системы заказчика*/

"name": <text> /* название задачи */

"address": <text> /* адрес задачи */

"client": <text> /* название клиента */

"comment": <text> /* комментарии */

"contact_name": <text> /* контактное лицо */

"phone": <text> /* телефон */

"email": <text> /* e-mail адрес */

"radius": <int> /* не обязателен. Радиус фиксации приезда к задаче в метрах, если =0 то берется из опций группы на закладке Анализ факта.

Используется в  мониторинге */

“works”: <List<work_str>> /* список работ в задаче, = null  или не задано если работ нет */

Описание структуры work_str в главе Справочник структур, используемых в API.

 

Игнорируемые параметры task_str

 

"id": <Guid> /* ид задачи */

"pos": <int> /* позиция в рейсе буде проставлена с учетом очередности в списке*/

"work_status": <int> /* статус выполнения задачи будет взят из rout_str*/

"stock": <int> /* =0 если обычная задача, =1 если задача на складе старта и =2 если на складе окончания рейса. При создании рейса в него нельзя передавать задачи на складе */