= Решение для оптимизации и контроля за сбором твердых бытовых отходов (ТБО) =

Этот компонент оптимизирует движение мусороуборочной техники по вывозу ТБО в масштабах города или района, а так же производит контроль планового/внепланового вывоза мусора, фактического выполнения сменно-суточных заданий водителями.


== Интеграция с внешними учетными системами (1С и др.) ==

Интеграция реализована путем обмена сообщениями в JSON формате по протоколу HTTP. Инициатором обмена выступает сторонняя система. Необходимым условием является наличие следующих HTTP заголовков:
 * X-Signature: reserved
 * Content-Type: text/x-json

=== Импорт ===
Компонент может импортировать из сторонних систем такие исходные данные:
 * Перечень контейнерных площадок
 * Запланированные маршруты движения
 * Персонал (водители мусороуборочной техники, грузчики/экспедиторы)

=== Экспорт ===
В сторонние системы экспортируются данные о фактическом выполнении маршрутов.

'''Выгрузка итогов по маршруту''' (http://<server_name>/components/communa/export_to_1c_v2). 

Запрос должен содержать идентификатор/код маршрута в параметре waybill:
{{{
{"waybill":14721}
}}}

В ответ будет отправлено сообщение с суммарными результатами уборки:
{{{
{
  "waybill": {
    "wastebin_loads": {"reported": 53, "out_of_route": 139, "total": 192}, 
    "waybill": 14721, 
    "route_start_time": "2021-04-16 13:21:51", 
    "route_end_time": "2021-04-17 12:35:46"
  }, 
  "trucks": [
    {
      "tablet_id": "445a52a0f59eb406", 
      "capacity": 10.000, 
      "id": 1015157
    }, 
    {
      "tablet_id": "e36e5da7533265a0", 
      "capacity": 10.000, 
      "id": 1015131
    }
  ], 
  "success": true, 
  "personnel": [
    {
      "first_name": "Василий", 
      "last_name": "mts1", 
      "middle_name": "", 
      "id": 1012652
    }, 
    {
      "first_name": "Иван", 
      "last_name": "mts", 
      "middle_name": "", 
      "id": 1012651
    }
  ]
}
}}}

'''Выгрузка итогов по маршруту с площадками''' (http://<server_name>/components/communa/export_to_1c).

Запрос:
{{{
{"waybill":14721}
}}}

Ответ:
{{{
{
    "waybill": {
        "waybill": 14721,
        "points": [
            {
                "long": 30.4067446392582,
                "reason": "Cтояв автомобіль",
                "lat": 50.4820775451919,
                "loaded": 0,
                "id": 8556,
                "left": 1
            },
            {
                "long": 30.4067553599089,
                "reason": null,
                "lat": 50.4820707265568,
                "loaded": 1,
                "id": 8568,
                "left": 0
            },

            ...

            {
                "long": 30.4095232486725,
                "reason": null,
                "lat": 50.4938488915337,
                "loaded": 1,
                "id": 11831,
                "left": 0
            }
        ]
    },
    "success": true
}
}}}

'''Выгрузка итогов по машине за заданный интервал времени''' (http://<server_name>/components/communa/export_to_1c_v3).

В запросе указывает идентификатор мусороуборочной машины (код документа карточки спецавтомобиля. Его можно узнать, открыв карточку спецавтомобиля и кликнув самую правую иконку на панели инструментов в карточке), а так же начальное и конечное время:
{{{
{
  "truck_id": 1014489, 
  "time_from": "2021-08-09 00:00:00", 
  "time_to": "2021-08-09 23:59:59"
}
}}}

Ответ:
{{{
{
    "wastebin_loads": {
        "total": 0,
        "reported": 0,
        "time_to": "2021-08-09 23:59:59",
        "time_from": "2021-08-09 00:00:00",
        "out_of_route": 0
    },
    "truck": {
        "tablet_id": "29e199b8401de077",
        "id": 1014489,
        "object_id": 1405
    },
    "success": true
}}}}