WiKi - UserSide - Вклад [ru]

API address UK

2026-11-12T09:38:49Z

IronBot: [IronBot] Sync UK localization from RU

[[API_address_EN|en]] | '''uk''' | [[API address|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Робота з адресами

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

Також див.: [[Адресная система_UK|Адресна система]]

=== Типи адресних одиниць ===

==== add_locality_type ====
''Додано у 3.13.64''
Опис: Додавання типу адресної одиниці
Обов'язкові параметри:
name - найменування
token - токен

==== edit_locality_type ====
''Додано у 3.13.64''
Опис: Редагування типу адресної одиниці
Обов'язкові параметри:
id - id
Необов'язкові параметри:
name - найменування
token - токен

==== get_locality_type ====
''Додано у 3.13.9''
Опис: Інформація про типи адресних одиниць
Необов'язкові параметри:
token - токен

==== get_alias ====
''Додано у 3.15.7''
Опис: Інформація про аліаси

=== Адресні одиниці ===

==== add_address ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Додано у 3.13.64''
Опис: Додавання адресної одиниці
Обов'язкові параметри:
locality_type_id - id типу адресної одиниці
name - назва
Необов'язкові параметри:
parent_id - id батьківської адресної одиниці
gov_id - ID адресного об'єкта в державних базах даних

==== get ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)''

''Додано у 3.13.9''

Опис: Інформація про адресні одиниці
Обов'язкові параметри ''(має бути хоча б одне)'':
id - id об'єктів ''(можна через кому)''
locality_type_id - тип об'єктів ''(можна через кому)''
parent_id - id батьківського об'єкта ''(можна через кому)''
is_disable_hidden - прапорець - не відображати приховані адресні одиниці
gov_id - ID адресного об'єкта в державних базах даних

==== edit_address ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.21.0-beta.1 (додано параметр is_show_on_map)''

''Змінено у 3.20.4 (додано параметр parent_id)''

''Додано у 3.13.60''

Опис: Редагування адресної одиниці
Обов'язкові параметри:
id - id об'єкта
Необов'язкові параметри:
map_color - HTML-колір полігона на карті
parent_id - id батьківської адресної одиниці
is_show_on_map - прапорець - відображати на карті
gov_id - ID адресного об'єкта в державних базах даних

=== Область ===

==== add_province ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

Опис: Додавання області
Обов'язкові параметри:
name - Найменування
Необов'язкові параметри:
gov_id - ID адресного об'єкта в державних базах даних

==== edit_province ====
Опис: Редагування області
Обов'язкові параметри:
id - ID області
Необов'язкові параметри:
Перелік параметрів використовується аналогічно до методу add_province

==== del_province ====
Опис: Видалення області
Обов'язкові параметри:
id - ID області

==== get_province ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.12.17 (додано вхідний параметр id)''
Опис: Список областей
Необов'язкові параметри:
id - ID областей (можна через кому)
gov_id - ID адресного об'єкта в державних базах даних

=== Район ===

==== add_district ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Додано у 3.13.46''
Опис: Додавання району
Обов'язкові параметри:
name - найменування
Необов'язкові параметри:
gov_id - ID адресного об'єкта в державних базах даних

==== edit_district ====
''Додано у 3.13.46''
Опис: Редагування району
Обов'язкові параметри:
id - id району
Необов'язкові параметри:
Перелік параметрів використовується аналогічно до методу add_province

==== del_district ====
''Додано у 3.13.46''
Опис: Видалення району
Обов'язкові параметри:
id - id району

==== get_district ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Додано у 3.13.46''
Опис: Список районів
Необов'язкові параметри:
id - id районів ''(можна через кому)''
gov_id - ID адресного об'єкта в державних базах даних

=== Населений пункт ===

==== add_city ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

Опис: Додавання населеного пункту
Обов'язкові параметри:
name - Найменування населеного пункту
Необов'язкові параметри:
province_id - ID області
district_id - ID району в області
gov_id - ID адресного об'єкта в державних базах даних

==== get_city ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)''

''Змінено у 3.13.46 (додано вхідний параметр district_id)''

''Змінено у 3.12.17 (додано вхідний параметр id)''

Опис: Список населених пунктів
Необов'язкові параметри:
id - id населеного пункту ''(можна через кому)''
district_id - id району ''(можна через кому)''
province_id - id області ''(можна через кому)''
is_disable_hidden - прапорець - не відображати приховані населені пункти
gov_id - ID адресного об'єкта в державних базах даних

==== edit_city ====
Опис: Редагування населеного пункту
Обов'язкові параметри:
id - ID населеного пункту
Необов'язкові параметри:
Перелік параметрів використовується аналогічно до методу add_city

==== del_city ====
Опис: Видалення населеного пункту
Обов'язкові параметри:
id - ID населеного пункту

=== Район у населеному пункті ===

==== add_area ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

Опис: Додавання району в населеному пункті
Обов'язкові параметри:
city_id - ID населеного пункту
name - Найменування
Необов'язкові параметри:
gov_id - ID адресного об'єкта в державних базах даних

==== get_area ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)''

''Змінено у 3.12.17 (додано вхідний параметр id)''

Опис: Список районів населених пунктів
Необов'язкові параметри:
id - ID районів (можна через кому)
city_id - ID міст (можна через кому)
is_disable_hidden - прапорець - не відображати приховані райони
gov_id - ID адресного об'єкта в державних базах даних

==== edit_area ====
Опис: Редагування району населеного пункту
Обов'язкові параметри:
id - ID району населеного пункту
Необов'язкові параметри:
Перелік параметрів використовується аналогічно до методу add_area

==== del_area ====
Опис: Видалення району населеного пункту
Обов'язкові параметри:
id - ID району населеного пункту

=== Вулиця ===

==== add_street ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

Опис: Додавання вулиці
Обов'язкові параметри:
city_id - ID населеного пункту
name - Найменування
Необов'язкові параметри:
area_id - ID району населеного пункту
gov_id - ID адресного об'єкта в державних базах даних

==== get_street ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.14.69 (додано вхідний параметр is_disable_hidden)''

''Змінено у 3.12.17 (додано вхідний параметр id)''
Опис: Список вулиць
Необов'язкові параметри:
id - ID вулиць ''(можна через кому)''
city_id - ID населених пунктів ''(можна через кому)''
area_id - ID районів населених пунктів ''(можна через кому)''
is_disable_hidden - прапорець - не відображати приховані вулиці
gov_id - ID адресного об'єкта в державних базах даних

==== edit_street ====
Опис: Редагування вулиці
Обов'язкові параметри:
id - ID вулиці
Необов'язкові параметри:
Перелік параметрів використовується аналогічно до методу add_street

==== del_street ====
Опис: Видалення вулиці
Обов'язкові параметри:
id - ID вулиці

=== Будівля ===

==== add_house ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.16.19 (додано параметр type_id)''

''Змінено у 3.13.57 (додано параметр comment, task_comment)''

''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)''

Опис: Додавання будівлі
Обов'язкові параметри:
city_id - id населеного пункту
street_id - id вулиці
number - номер будівлі
block - блок/корпус будівлі ''(для версії 3.12 і нижче)''
custom_name - Довільне ''(повне)'' найменування будівлі ''(для версії 3.12 і нижче)''
Необов'язкові параметри:
area_id - id району в населеному пункті
apart_count - кількість квартир/приміщень у будівлі
comment - нотатки
entrance_count - кількість входів/під'їздів у будівлі
level_count - кількість поверхів у будівлі
task_comment - робоча нотатка за будівлею
type_id - id типу будівлі
gov_id - ID адресного об'єкта в державних базах даних

==== add_house_mark ====
Опис: Додавання мітки на будинку
Обов'язкові параметри:
house_id - ID будинку
mark_id - ID мітки

==== del_house ====
Опис: Видалення будинку
Обов'язкові параметри:
id - ID будинку

==== delete_house_mark ====
Опис: Зняття мітки з будинку
Обов'язкові параметри:
house_id - ID будинку
mark_id - ID мітки

==== edit_building_coord ====
''Додано у 3.13.14''
Опис: Зміна географічних координат у будівлі/об'єкта інфраструктури
Обов'язкові параметри:
id - id будівлі
coord - координати вершин полігона будівлі

==== get_building_structure ====
''Додано у 3.16dev3''

Опис: Перегляд структури будівлі
Обов'язкові параметри:
id - id будівлі

==== edit_building_structure ====
''Додано у 3.15.20''

Опис: Редагування структури будівлі
Обов'язкові параметри:
id - id будівлі
Необов'язкові параметри:
level_list - список типів рівнів ''(поверхів)'' через кому

==== edit_house ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Змінено у 3.18beta1 (додано параметр task_interval)''

''Змінено у 3.16.20 (додано параметр type_id, is_not_connected)''

''Змінено у 3.13.57 (додано параметр comment, task_comment)''

''Змінено у 3.13.15 (додано параметр apart_count, level_count, entrance_count)''

Опис: Редагування будівлі
Обов'язкові параметри:
id - id будівлі ''(для версії 3.12 і нижче)''/id адресної одиниці ''(для версії 3.13 і вище)''
або
building_id - id будівлі ''(для версії 3.13 і вище)''
Необов'язкові параметри:
area_id - id району в населеному пункті
apart_count - кількість квартир/приміщень у будівлі
block - блок/корпус будівлі ''(для версії 3.12 і нижче)''
city_id - id населеного пункту
comment - нотатки
custom_name - Довільне ''(повне)'' найменування будівлі ''(для версії 3.12 і нижче)''
entrance_count - кількість входів/під'їздів у будівлі
is_not_connected - прапорець - будівля не підключена
level_count - кількість поверхів у будівлі
number - номер будівлі
street_id - id вулиці
task_comment - робоча нотатка за будівлею
task_interval - можливі інтервали часу для виконання робіт ''(наприклад: {"day":[[0,23],[0,23],[0,23],[0,23],[0,23],[0,23],[0,23]]})''
type_id - id типу будівлі
gov_id - ID адресного об'єкта в державних базах даних

==== get_house ====

''Доопрацьовано у: 3.21.92 (додано параметр gov_id)''

''Доопрацьовано у: 3.21.3 (додано параметри apart, entrance, floor, is_not_use)''

''Доопрацьовано у: 3.21.2 (додано параметр additional_data_XXX)''

''Доопрацьовано у: 3.21.0 (додано параметр building_type_id)''

''Доопрацьовано у: 3.16dev3 (додано параметри name, limit, is_like)''

''Доопрацьовано у: 3.13.35 (додано параметри mark_id)''

''Доопрацьовано у 3.13.19 (додано параметр building_id)''

Опис: Список будинків
Обов'язкові параметри:
немає
Необов'язкові параметри:
id - id будівлі ''(для версії 3.12. Можна через кому)'', id адресної одиниці ''(для версії 3.13+. Можна через кому)''
building_id - id будівлі ''(для версії 3.13+. Можна через кому)''
city_id - ID населених пунктів ''(можна через кому)''
area_id - ID районів населених пунктів ''(можна через кому)''
street_id - ID вулиць ''(можна через кому)''
is_disable_hidden - прапорець - не відображати приховані будинки
mark_id - id мітки
name - повна адреса будівлі ''(відповідно до шаблону)''
limit - максимальна кількість записів, які потрібно повернути у відповіді
is_like - прапорець - використовувати порівняння підрядка там, де це можливо ''(а не повний збіг)''
gov_id - ID адресного об'єкта в державних базах даних

additional_data_XXX_<filter> - значення додаткового поля та фільтр ''(наприклад: additional_data_999_eq=значення, additional_data_999_ne=значення, additional_data_999_like=значення, additional_data_999_notlike=значення, additional_data_999_set=1, additional_data_999_set=0)''
apart - кількість домогосподарств
building_type_id - ID типу будівлі ''(можна через кому)''
entrance - кількість під'їздів
floor - кількість поверхів
is_not_use - прапорець — будівля не підключена

==== get_building_type ====
''Додано у 3.20.5''

Опис: Довідник типів будівель
Обов'язкові параметри:
немає

==== get_level ====
''Додано у 3.15.20''

Опис: Довідник типів рівнів (поверхів)
Обов'язкові параметри:
немає

==== move_child_object ====
''Додано у 3.16dev8''

Опис: Перенесення дочірніх об'єктів з будівлі на іншу будівлю
Обов'язкові параметри:
src_building_id - id вихідної будівлі
dst_building_id - id будівлі-отримувача

==== owner_remove ====
Опис: Вилучення власника з будівлі
Див. API->owner->[[API_owner_UK#unbind_building|unbind_building]]

==== (*) add_house_to_map ====
''Додано у 3.12.40''

''Виключено у 3.13''

Опис: Додавання будинку на карту
Обов'язкові параметри:
house_id - ID будинку
map_id - ID карти
coord - координати вершин полігона будинку

==== (*) remove_house_from_map ====
''Додано у 3.12.40''

''Виключено у 3.13''

Опис: Видалення будинку з карти
Обов'язкові параметри:
house_id - ID будинку
map_id - ID карти

API address EN

2026-11-12T09:38:47Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_address_UK|uk]] | [[API address|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Address management

Optional parameters:
action - request subcategory ''(possible value: see below)''

Also see: [[Address System|Address System]]

=== Types of address units ===

==== add_locality_type ====
''Added in 3.13.64''
Description: Add an address unit type
Required parameters:
name - name
token - token

==== edit_locality_type ====
''Added in 3.13.64''
Description: Edit an address unit type
Required parameters:
id - id
Optional parameters:
name - name
token - token

==== get_locality_type ====
''Added in 3.13.9''
Description: Information about the types of address units
Optional parameters:
token - token

==== get_alias ====
''Added in 3.15.7''
Description: Information about aliases

=== Address units ===

==== add_address ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Added in 3.13.64''
Description: Add an address unit
Required parameters:
locality_type_id - address unit type id
name - name
Optional parameters:
parent_id - id of parent address unit
gov_id - address object ID in government databases

==== get ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Changed in 3.14.69 (added is_disable_hidden input parameter)''

''Added in 3.13.9''

Description: Information about address units
Required parameters ''(at least one is required)'':
id - id of objects ''(can be separated by commas)''
locality_type_id - type of objects ''(can be separated by commas)''
parent_id - id of parent object ''(can be separated by commas)''
is_disable_hidden - flag - do not display hidden address units
gov_id - address object ID in government databases

==== edit_address ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Changed in 3.21.0-beta.1 (added is_show_on_map parameter)''

''Modified in 3.20.4 (added parent_id parameter)''

''Added in 3.13.60''
Description: Edit address unit
Required parameters:
id - id of the object
Optional parameters:
map_color - HTML color of the polygon on the map
parent_id - parent address unit id
is_show_on_map - flag - show on the map
gov_id - address object ID in government databases

=== Province ===

==== add_province ====

''Updated in: 3.21.92 (added gov_id parameter)''

Description: Add a province
Required parameters:
name - Name
Optional parameters:
gov_id - address object ID in government databases

==== edit_province ====
Description: Edit a province
Required parameters:
id - ID of the province
Optional parameters:
The parameter list is used similarly to the add_province method

==== del_province ====
Description: Delete a province
Required parameters:
id - ID of the province

==== get_province ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Changed in 3.12.17 (added incoming id parameter)''
Description: List of provinces
Optional parameters:
id - ID of the province (can be comma separated)
gov_id - address object ID in government databases

=== District ===

==== add_district ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Added in 3.13.46''
Description: Add a district
Required parameters:
name - name
Optional parameters:
gov_id - address object ID in government databases

==== edit_district ====
''Added in 3.13.46''
Description: Edit a district
Required parameters:
id - id of the district
Optional parameters:
The parameter list is used similarly to the add_province method

==== del_district ====
''Added in 3.13.46''
Description: Delete a district
Required parameters:
id - id of the district

==== get_district ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Added in 3.13.46''
Description: List of districts
Optional parameters:
id - id of districts ''(can be comma separated)''
gov_id - address object ID in government databases

=== City ===

==== add_city ====

''Updated in: 3.21.92 (added gov_id parameter)''

Description: Add a city
Required parameters:
name - Name of the city
Optional parameters:
province_id - ID of the province
district_id - ID of the district in the region
gov_id - address object ID in government databases

==== get_city ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Modified 3.14.69 (added incoming parameter is_disable_hidden)''

''Modified 3.13.46 (added district_id input parameter)''

''Modified 3.12.17 (added incoming id parameter)''

Description: List of cities
Optional parameters:
id - id of the city ''(can be comma separated)''
district_id - id of the district ''(comma separated)''
province_id - province id ''(comma separated)''
is_disable_hidden - flag - do not display hidden cities
gov_id - address object ID in government databases

==== edit_city ====
Description: Editing a city
Required parameters:
id - ID of the city
Optional parameters:
The list of parameters is used similarly to the add_city method

==== del_city ====
Description: Delete a city
Required parameters:
id - ID of the city

=== Area in the city ===

==== add_area ====

''Updated in: 3.21.92 (added gov_id parameter)''

Description: Add an area in a city
Required parameters:
city_id - ID of the city
name - Name
Optional parameters:
gov_id - address object ID in government databases

==== get_area ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Changed in 3.14.69 (added incoming parameter is_disable_hidden)''

''Modified 3.12.17 (added id parameter)''

Description: List of areas of the cities
Optional parameters:
id - ID of areas (can be comma separated)
city_id - ID of cities (can be separated by commas)
is_disable_hidden - flag - do not display hidden areas
gov_id - address object ID in government databases

==== edit_area ====
Description: Edit the area of the city
Required parameters:
id - ID of the city`s area
Optional parameters:
The list of parameters is used similarly to the add_area method

==== del_area ====
Description: Remove a city area
Required parameters:
id - ID of the city`s area

=== Street ===

==== add_street ====

''Updated in: 3.21.92 (added gov_id parameter)''

Description: Add a street
Required parameters:
city_id - ID of the city
name - Name
Optional parameters:
area_id - ID of the area of the city
gov_id - address object ID in government databases

==== get_street ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Modified 3.14.69 (added is_disable_hidden input parameter)''

''Modified 3.12.17 (added id parameter)''
Description: List of streets
Optional parameters:
id - ID of streets ''(can be comma separated)''
city_id - ID of city ''(can be comma separated)''
area_id - ID of the city`s area ''(can be comma separated)''
is_disable_hidden - flag - do not display hidden streets
gov_id - address object ID in government databases

==== edit_street ====
Description: Edit a street
Required parameters:
id - street id
Optional parameters:
The parameter list is used similarly to the add_street method

==== del_street ====
Description: Delete a street
Required parameters:
id - street ID

=== Building ===

==== add_house ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Modified 3.16.19 (added type_id parameter)''

''Modified 3.13.57 (added comment parameter, task_comment)''

''Modified in 3.13.15 (added parameter apart_count, level_count, entrance_count)''

Description: Add a building
Required parameters:
city_id - id of city
street_id - street id
number - building number
block - building block/section ''(for version 3.12 and earlier)''
custom_name - Arbitrary ''(full)'' building name ''(for version 3.12 and below)''
Optional parameters:
area_id - the id of the city`s area
apart_count - number of households in the building
comment - notes
entrance_count - number of entrances in the building
level_count - number of floors in the building
task_comment - task note for the building
type_id - building type id
gov_id - address object ID in government databases

==== add_house_mark ====
Description: Add a mark to a building
Required parameters:
house_id - house ID
mark_id - ID of mark

==== del_house ====
Description: Delete a building
Required parameters:
id - ID of the house

==== delete_house_mark ====
Description: Remove a building mark
Required parameters:
house_id - house ID
mark_id - mark ID

==== edit_building_coord ====
''Added in 3.13.14''
Description: Change the geographic coordinates of a building/infrastructure facility
Required parameters:
id - building id
coord - coordinates of the building polygon vertices

==== get_building_structure ====
''Added in 3.16dev3''

Description: View building structure
Required parameters:
id - building id

==== edit_building_structure ====
''Added in 3.15.20''

Description: Edit building structure
Required parameters:
id - id of the building
Optional parameters:
level_list - comma separated list of level types ''(floors)''

==== edit_house ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Changed in 3.18beta1 (added task_interval parameter)''

''Changed in 3.16.20 (added type_id, is_not_connected)''

''Modified 3.13.57 (added comment parameter, task_comment)''

''Modified 3.13.15 (added parameter apart_count, level_count, entrance_count)''

Description: Edit building
Required parameters:
id - id of building ''(for version 3.12 and below)''/id of address unit ''(for version 3.13 and above)''
or
building_id - building id ''(for version 3.13 and above)''
Optional parameters:
area_id - the id of the city`s area
apart_count - number of households in the building
block - building block/section ''(for version 3.12 and earlier)''
city_id - id of the city
comment - notes
custom_name - Arbitrary ''(full)'' building name ''(for version 3.12 and below)''
entrance_count - number of entrances in the building
is_not_connected - flag - building is not connected
level_count - number of floors in the building
number - building number
street_id - street id
task_comment - work note on the building
task_interval - possible time intervals for work ''(for example: {"day":[[0,23],[0,23],[0,23],[0,23],[0,23],[0,23],[0,23],[0,23]]})'')
type_id - building type id
gov_id - address object ID in government databases

==== get_house ====

''Updated in: 3.21.92 (added gov_id parameter)''

''Updated in: 3.21.3 (added apart, entrance, floor, and is_not_use parameters)''

''Updated in: 3.21.2 (added additional_data_XXX parameter)''

''Updated in: 3.21.0 (added building_type_id parameter)''

''Refined in: 3.16dev3 (added parameters name, limit, is_like)''

''Refined in: 3.13.35 (added mark_id parameters)''

''Refined in 3.13.19 (added building_id parameter)''

Description: List of buildings
Required parameters:
None
Optional parameters:
id - building id ''(for version 3.12. Can be comma separated)'', address unit id ''(for version 3.13+. Can be comma separated)''
building_id - building id ''(for version 3.13+. Can be separated by commas)''
city_id - ID of the city ''(comma separated)''
area_id - ID of the city`s area ''(comma separated)''
street_id - ID of the streets ''(comma separated)''
is_disable_hidden - flag - do not display hidden buildings
mark_id - mark id
name - full address of the building ''(according to the template)''
limit - maximum number of records to return in the response
is_like - flag - use substring comparison where possible ''(not a full match)''
gov_id - address object ID in government databases

additional_data_XXX_<filter> - additional field value and filter ''(for example: additional_data_999_eq=value, additional_data_999_ne=value, additional_data_999_like=value, additional_data_999_notlike=value, additional_data_999_set=1, additional_data_999_set=0)''
apart - number of households
building_type_id - building type ID ''(comma separated)''
entrance - number of entrances
floor - number of floors
is_not_use - flag - building is not connected

==== get_level ====
''Added in 3.15.20''

Description: Level type directory (floors)
Required parameters:
None

==== move_child_object ====
''Added in 3.16dev8''

Description: Move child objects from a building to another building
Required parameters:
src_building_id - id of the source building
dst_building_id - id of the destination building

==== owner_remove ====
Description: Remove owner from a building
See API->owner->[[API_owner_EN#unbind_building|unbind_building]]

==== (*) add_house_to_map ====
''Added in 3.12.40''

''Removed in 3.13''

Description: Add a building to the map
Required parameters:
house_id - house ID
map_id - map ID
coord - coordinates of vertices of the house polygon

==== (*) remove_house_from_map ====
''Added in 3.12.40''

''Removed in 3.13''

Description: Remove a building from the map
Required parameters:
house_id - house ID
map_id - map ID

==== get_building_type ====
''Added in 3.20.5''

Description: Building type reference
Required parameters:
none

Версії 3.19

2026-11-12T09:38:44Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.19_EN|en]] | '''uk''' | [[Версии_3.19|ru]]

Версії гілки [[3.19_UK|3.19]]

Також див.: [[Версії ERP "USERSIDE"]]

== 3.19.55 "Plutonium" - 03.02.2026 ==
* Виправлено обробку посилань в описі завдання ''(у деяких випадках)''
* Виправлено помилку під час перегляду списку ТМЦ на складі після зміни статусу завдання
* Виправлення невеликих помилок

== 3.19.54 "Lead" - 02.07.2025 ==
* У списку будівель додано можливість відображати менеджера з будівлі
* При груповому надсиланні e-mail для абонентів додано параметр "Ігнорувати дублі E-mail адрес"
* Додано можливість вказівки кількості завдань у статистиці проблемних абонентів
* Виправлено відправлення SMS-повідомлень співробітникам підрозділу при призначенні підрозділу на завдання
* Виправлено помилка під час перегляду списку завдань ''(у деяких випадках)''
* Виправлено сортування в результатах опитування FDB-таблиці з пристрою
* Виправлено помилка при фільтрації по будівлі у списку операцій за складом ''(у деяких випадках)''

== 3.19.53 "Samarium" - 10.06.2025 ==
* '''Додано новий тип з'єднання: "Планований об'єкт" у схемі комутації'''
* '''В особистих налаштуваннях для абонента додано можливість індивідуального налаштування кількості записів у таблицях'''
* У групових діях за завданнями додано можливість додавання/зняття мітки для абонентів, що належать до завдань
* У лічильнику новин за завданнями вважаються також і новини, де підрозділ співробітника є спостерігачем
* Виправлено фільтрацію згрупованих завдань за статусом завдання

== 3.19.52 "Nobelium" - 18.05.2025 ==
* Для тайлів карт додано параметр налаштування "Максимальний масштаб (програмно)"
* У картці будівлі у списку кабельних ліній додано роздільну фільтрацію за типами кабельних ліній
* У плані робіт додано фільтр за завданнями, у яких відсутні коментарі
* Виправлено робота лінійки на карті покриття ''(у деяких випадках)''
* Виправлено вибір зміненого статусу завдання у налаштуванні ланцюжка завдань для батьківського/дочірнього завдання
* Виправлено помилка при фільтрації завдань за статусами у розділі "Статистика"
* Виправлено помилка під час перегляду рекламної кампанії ''(у деяких випадках)''
* Виправлено коректне виведення потрібної кількості записів у списку обладнання

== 3.19.51 "Promethium" - 26.04.2025 ==
* Для типів кабельних ліній додано параметр "Мінімальний масштаб для виведення об'єктів на карті"
* У ланцюжках автоматизації за типом завдання додано варіант "Надіслати SMS (Додаткове поле з номером телефону)"
* Виправлено роботу відкладених ланцюжків завдань при створенні поточного в частині призначення/виключення співробітників

== 3.19.50 "Iodine" - 19.04.2025 ==
* Доопрацьовано метод API->fiber->[[API_fiber_UK#edit|edit]]
* Виправлено малювання стрілок комутації на адаптерах мультиплексора ''(у деяких випадках)''
* Виправлено формування тексту шаблонів SMS-повідомлень у лівому меню
* Невеликі зміни та виправлення

== 3.19.49 "Sodium" - 12.04.2025 ==
* Додано метод API->vlan->[[API_vlan_UK#customer_add_to_vlan|customer_add_to_vlan]]
* Додано метод API->vlan->[[API_vlan_UK#customer_remove_from_vlan|customer_remove_from_vlan]]
* Виправлено вибір/збереження виконавців при зміні статусу завдання
* Виправлено помилка при перегляді списку VLAN по пристрої ''(у деяких випадках)''
* Виправлено копіювання/немає абонента при створенні дочірнього завдання
* Виправлено зміну статусу у батьківського завдання по ланцюжку
* Виправлено швидкий пошук за типом завдання при створенні дочірнього завдання ''(у деяких випадках)''
* Виправлено перегляд списку активних абонентів зараз при переході з головної сторінки
* Виправлено скидання налаштувань доступу до обладнання при збереженні картки пристрою

== 3.19.48 "Erbium" - 05.04.2025 ==
* Допрацьовано метод API->attach->[[API_attach_UK#add|add]]
* Додано швидкий пошук у селекторі вибору типу завдання при створенні дочірнього завдання
* Можливість видалення невикористовуваних адрес розділена для будівель та інших адресних одиниць
* У картці будівлі у вкладці зі списком кабельних ліній додано посилання-фільтр на загальний список кабельних ліній з фільтрацією лініями даної будівлі
* При створенні дочірнього завдання можна вибрати чи копіювати опис завдання та абонентів з батьківського завдання
* У таблиці списку абонентів додано можливість виводити колонку з власними координатами абонента
* У картці абонента за наявності власних координат додано посилання для переходу на Google-карти
* Доопрацьовано зміну списку пов'язаного обладнання з-під картки завдання
* Доопрацювання відображення новин за завданнями
* Виправлено відображення переліку VLAN ID у таблиці портів комутатора ''(у деяких випадках)''
* Виправлено помилка під час створення завдання/зміни статусу за наявності ланцюжка завдань ''(у деяких випадках)''
* Виправлено формування посилань на список абонентів у графіку зростання
* Виправлено відображення міток на абоненті в інформації щодо абонента у списку завдань
* Виправлено відображення символу * у посиланнях в описі тексту завдання
* Виправлено фільтрація за фільтром "Адреса (не містить)" у списку завдань

== 3.19.47 "Rhenium" - 24.03.2025 ==
* Меню вибору ТМЦ при зміні статусу завдання за замовчуванням тепер буде згорнуто
* Виправлено непотрібна конвертація SMS у трансліт ''(у деяких випадках)''
* Виправлено помилка при спробі редагування опису прикріпленого файлу ''(у деяких випадках)''
* Виправлено помилка при груповій дії у списку завдань "Перевести всіх абонентів із завдань до колишніх абонентів"
* Виправлено помилка у списку завдання при фільтрації за колишніми абонентами ''(у деяких випадках)''
* Виправлено групову зміну значення додаткового поля для будівель ''(у деяких випадках)''

== 3.19.46 "Tungsten" - 09.03.2025 ==
* У розділі "Налаштування - База обладнання" додано можливість синхронізації локальної бази обладнання вручну ''(автоматично це здійснюється раз на добу)''
* Кожен співробітник може собі налаштувати властивість "Приховувати з головної сторінки завдання з ознакою "вивести на головну сторінку"
* До ланцюжка завдань/автоматизації за типами завдань додано можливість "Батьківське завдання. Додати коментар"
* При створенні дубліката полігону з картки - дублікат створюється прямо на карті відразу в режимі зміни координат
* Для статусів завдань додано параметр "Заборонити додавання коментарів до завдань у такому статусі"
* У налаштування покриття додано можливість вказівки властивостей за умовчанням при додаванні нових полігонів
* До групових дій по об'єктах на карті ''(полігонам)'' додано можливість змінювати колір, прозорість, властивості кордону
* У списку кабельних ліній додано фільтр за адресою
* При редагуванні координат полігону на карті покриття для збереження координат достатньо натиснути клавішу Enter
* У картці будівлі додано вкладку з кабельними лініями, що знаходяться на цій будівлі, спорудах зв'язку або абонентах на ньому
* Виправлено виведення інформації по абонентах у спливаючому повідомленні модуля usm_asterisk ''(у деяких випадках)''
* Виправлено перенесення інформації про адресу потенційного абонента при його додаванні та перемиканні режиму фіз/юр.
* Виправлено помилка у вікні створення нової споруди зв'язку ''(у деяких випадках)''
* Виправлено помилка перерахунку адреси будівлі при зміні батьківського адресного об'єкта ''(у деяких випадках)''
* Виправлено помилка при перейменуванні прикріпленого файлу на ім'я з апострофом
* Виправлено роботу фільтра за власником у списку завдань
* Виправлено помилка при редагуванні картки білінгу ''(у деяких випадках)''

== 3.19.45 "Berkelium" - 02.03.2025 ==
* '''Для профілів співробітників додано нове право "Дозволити експорт до Excel всього списку"'''
* Додано метод API->customer->[[API_customer_UK#msg_add_to_customer|msg_add_to_customer]]
* Додано метод API->node->[[API_node_UK#get_relation_customers|get_relation_customers]]
* Додано метод API->device->[[API_device_UK#get_relation_customers|get_relation_customers]]
* У картці об'єкта на карті з типом "Полігон" додано відображення інших об'єктів полігонів, що входять до цього полігону. З можливістю фільтрації.
* Виправлено дублювання секцій підрозділів у розділі "Мої завдання" ''(у деяких випадках)''
* Виправлено угруповання у списку завдань
* Виправлено створення вторинного завдання по ланцюжку при створенні первинного завдання
* Виправлено помилка групування/фільтрації за власником у списку завдань

== 3.19.44 "Lutetium" - 22.02.2025 ==
* Додано метод API->employee->[[API_employee_UK#division_employee_add|division_employee_add]]
* Додано метод API->employee->[[API_employee_UK#division_employee_remove|division_employee_remove]]
* Для списку завдань додано можливість групування за власником
* Ctrl+LeftClick на карті покриття на об'єкті на карті з типом "Полігон" відкриває картку цього полігону, Alt+LeftClick на карті покриття на об'єкті на карті з типом "Полігон" включає режим зміни координат цього полігону
* У спливаючому повідомленні вхідних дзвінків модуля usm_asterisk виводяться спочатку абоненти зі звичайним статусом ''(а не, наприклад, колишні)''
* У класифікаторі типів завдань доданий швидкий пошук за найменуванням типу завдань
* Додана фіксація та відображення співробітника хто закрив/відзначив завдання виконаним
* У налаштування полів списку обладнання додано колонку з інформацією чи включено інформування з неактивності
* У логічній схемі будівлі силуети під'їздів виводяться яскравішими лініями
* У конфігураційному файлі можна використовувати масив довірених IP-адрес для доступу без 2FA-авторизації ''(при включеній 2FA-авторизації)''
* Для об'єктів на карті (полігони) додано можливість вказувати прозорість та зовнішній вигляд межі об'єкту
* Додано можливість створювати копії для об'єктів на карті з-під картки об'єкта або картки покриття
* Виправлено роботу ланцюжка завдань за призначенням виконавцем автора завдання під час створення завдання
* Виправлено робота фільтрів у списку завдань ''(у деяких випадках)''
* Виправлено помилка з неможливістю вибору ТМЦ під час закриття завдання ''(у деяких випадках)''
* Виправлено додавання коментарів до дочірніх завдань по ланцюжку ''(у деяких випадках)''

== 3.19.43 "Rhodium" - 16.02.2025 ==
* '''Для кабельних ліній додано можливість їх об'єднання'''
* У списку завдань додано можливість виводити колонку "Власник"
* При додаванні коментаря до завдання додано можливість через символ @ звертатися до підрозділу ''(з надсиланням повідомлення всім співробітникам цього підрозділу)''
* У картці абонента, якщо у нього є адреса будівлі та у будівлі є координати - виводиться маркер швидкого переходу на цю будівлю на карті покриття
* У налаштування таблиці за адресами ''(будівель)'' додано можливість відображення колонки з кількістю абонентів по будівлі
* У списку абонентів ховаються колонки з доп.полями, якщо в них немає значень
* Додано параметр "Ігнорувати використання 2FA для співробітників з довіреними IP-адресами входу"
* Виправлено роботу кабельного тестера по окремих портах на комутаторах
* Виправлено помилку з фільтрацією співробітника при побудові звіту по залишках ТМЦ
* Виправлено роботу параметра налаштування "Дільники/Ущільнювачі. Дозволити комутацію тільки у вільні порти"
* Виправлено коректне копіювання налаштувань автоматичного призначення співробітників/підрозділів для типу завдання

== 3.19.42 "Iron" - 10.02.2025 ==
* Доопрацьовано пошук власників за значенням додаткового поля
* У списку завдань додано групування завдань за типом, статусом, будівлею, автором, місяцем створення
* У списку дій з автотранспорту додано відображення нотаток
* Доопрацювання відправлення повідомлень за завданням з-під картки завдання
* Виправлено налаштування ланцюжків за типами завдань ''(у деяких випадках)''
* Виправлено редагування номера телефону для колишнього абонента
* Виправлено фільтрацію за значенням додаткового поля по будівлях ''(у деяких випадках)''
* Виправлено робота фільтра по додатковим полям у списку абонентів ''(у деяких випадках)''
* Виправлено відображення списку автоматичних спостерігачів-підрозділів під час створення нового завдання
* Виправлено малювання форми мультиплексора на схемі комутації ''(у деяких випадках)''
* Виправлено відображення комутації на портах мультиплексора у його картці ''(у деяких випадках)''

== 3.19.41 "Francium" - 25.01.2025 ==
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* У типі завдань для співробітника додано можливість скопіювати налаштування призначення з іншого типу завдань
* В умовах SMS-розсилки по абонентам додано можливість фільтрації за розміром знижки
* Доопрацювання формування QR-коду для споруд зв'язку
* Виправлено помилка при імпорті споруд зв'язку ''(у деяких випадках)''
* Виправлено помилка при видаленні підмережі у абонента ''(у деяких випадках)''
* Виправлено помилка при створенні нового співробітника ''(у разі використання 2FA)''

== 3.19.40 "Barium" - 19.01.2025 ==
* Допрацьовано метод API->employee->[[API_employee_UK#edit|edit]]
* До групових дій по будівлях додано можливість зміни менеджера
* У меню картки завдання додано посилання на перегляд завдання ''(і пов'язаних завдань)'' на карті
* У картці завдання додано швидке посилання на виключення прив'язаного до завдання абонента
* Доопрацьовано приховування/відображення великого списку пов'язаних абонентів у картці завдання
* Для списку співробітників можна виводити колонку з найменуванням підрозділу
* У картці будівлі додано фільтр за списком споруд зв'язку по даній будівлі.
* У групових діях за абонентами додано можливість масового додавання та виключення із завдання
* Виправлення невеликих помилок та неточностей

== 3.19.39 "Neon" - 11.01.2025 ==
* У групових діях за завданнями додано можливість виключення спостерігача
* Для типів споруд зв'язку можна налаштувати шаблон для введення номера
* У групові дії зі споруд зв'язку додано можливість додавання/виключення із завдання
* Виправлено збереження шаблону за типами споруд зв'язку для підказки на карті покриття.
* Виправлено сортування у списку ONU по OLT у разі коли вибрано конкретний PON-порт

== 3.19.38 "Argon" - 04.01.2025 ==
* У картці завдання, якщо прикріплені кабельні лінії, то виводиться посилання на відображення на карті цих ліній
* Для ключів додана робота з мітками
* До змінних шаблонів документа за завданням додано параметр відображення QR-коду з координатами споруди зв'язку, що відноситься до завдання
* Додано параметр налаштування "Дільники/Ущільнювачі. Дозволити комутацію тільки у вільні порти"
* У ланцюжку завдань за завданнями/автоматизації додані варіанти дій "Дочірнє завдання. Змінити статус на" та "Дочірнє завдання. Додати коментар"
* Виправлено відображення споруд зв'язку на карті при дуже великих масштабах ''(у деяких випадках)''
* Виправлено пошук на карті покриття
* Виправлено задвоєння слішів при редагуванні коментарів до завдань

== 3.19.37 "Bromine" - 27.12.2024 ==
* У ланцюжках/умовах за типами завдань додано можливість вказівки додаткової умови спрацювання ''(на першому етапі - наявність певної мітки на абоненті)''
* До списку кабельних ліній додано групові дії щодо додавання/виключення кабельних ліній до завдання
* До списку абонентів додано фільтр за наявністю зазначеного VLAN
* Виправлено помилка під час перегляду списку завдань ''(у деяких випадках)''
* Виправлено помилка при перегляді історії дій по співробітнику ''(у деяких випадках)''
* Виправлено помилка у формі приходу ТМЦ ''(у деяких випадках)''
* Виправлено помилка при роботі доп.поля з типом "Лічильник" ''(у деяких випадках)''
* Виправлено сортування за значеннями додаткових полів у списку завдань ''(у деяких випадках)''
* Виправлено розрахунок значення в дод.полі типу "Лічильник"
* Виправлено помилка інтерфейсу при пошуку інформації щодо споруд зв'язку в картці завдання
* Виправлено зміну пігтейлу для волокна кабельної лінії, що кінець на абоненті

== 3.19.36 "Fermium" - 15.12.2024 ==
* У картці будівлі додано можливість масово додавати споруди зв'язку необхідного типу та кількості
* При додаванні будівель до рекламної кампанії - по певній вулиці додано можливість вибрати відразу кілька будівель цієї вулиці
* При виборі адрес для рекламної кампанії можна додавати відразу всі будівлі по власнику
* Доопрацьовано автоматизацію відправки SMS абоненту при зміні статусу завдання. Можна вибрати одноразове відправлення або щоразу зміну статусу.
* Для персоналу додано налаштування типів відпусток та лікарняних
* До списку завдань додано фільтр "Автор завдання ''(Співробітники підрозділу. У тому числі звільнені та переведені)''"
* До статистики з проблемних будівель додано фільтр за адресою ''(населений пункт, район і т.п.)''
* Для модуля usm_observer додано можливість налаштування тексту повідомлень про тривогу/скасування за кожним контрольованим показником
* При об'єднанні потенційного абонента та поточного - ознака "Юридична особа" переноситься
* До групових дій по об'єктах на карті додано можливість їх видалення
* Виправлено фільтрація за групою абонентів ''(і не входження до групи абонентів)'' у списку абонентів
* Виправлено помилка при фільтрації списку завдань за типом абонента ''(у деяких випадках)''
* Виправлено помилка при відображенні значень додаткових полів у заголовку об'єкта ''(у деяких випадках)''

== 3.19.35 "Phosphorus" - 08.12.2024 ==
* Додано метод API->fiber->[[API_fiber_UK#set_pigtail_type|set_pigtail_type]]
* Додано налаштування полів таблиці для списку абонентів
* У фільтр по будівлях додано можливість вибірки за якістю "Будівля не підключена"
* У формі вибору ТМЦ для заміни пропонуються тільки ТМЦ на поточному співробітнику/або на всіх, якщо є доступ до їх підзвіту
* Виправлено додавання посилання на коментар до завдання в іншому коментарі
* Виправлено сортування списку завдань за автором завдання
* Виправлено коректну вибірку завдань у відомості робіт ''(у деяких випадках)''
* Виправлено автокомутація абонентів до портів обладнання (за завданням планувальника)
* Виправлено роботу звіту щодо надходжень коштів абонентів
* Виправлено збереження порожніх коментарів для всіх портів пристрою

== 3.19.34 "Tin" - 02.12.2024 ==
* Доопрацьовано метод API->owner->[[API_owner_UK#add|add]]
* Допрацьовано метод API->owner->[[API_owner_UK#edit|edit]]
* Міграція основних даних щодо власників/орендарів у додаткові поля
* У групових діях зі споруд зв'язку додано можливість масової зміни адреси
* До списку кабельних ліній додано фільтр по полігону на карті, який покриває ці кабельні лінії.
* До списку споруд зв'язку додано фільтр по полігону на карті, який покриває ці споруди зв'язку
* Для пристроїв додано можливість масово змінювати коментарі на портах
* У відомості робіт з персоналу додано можливість фільтрації по підрозділу
* Додано параметр налаштування "Завдання, що позначені для виведення на головну сторінку. Виводити в т.ч. і закриті завдання"
* Додано параметр налаштування "Дільники/Ущільнювачі. Дозволити подвійну комутацію в порти"
* Виправлено виняток співробітником себе із завдання ''(у деяких випадках)''

== 3.19.33 "Carbon" - 23.11.2024 ==
* Додано метод API->employee->[[API_employee_UK#merge|merge]]
* Допрацьовано метод API->employee->[[API_employee_UK#edit|edit]]
* У списку абонентів у групових діях при відображенні їх на карті - також виводяться і сигнали ONU, що у них встановлені ''(за наявності)''
* Для споруд зв'язку можна вказувати до 3 орендарів/власників
* Підтримка фільтрації по орендарю/власнику у списку споруд зв'язку та кабельних ліній ''(з можливістю відображення на карті)''
* Звіт "ONU, що не скомутовані до OLT" інтегрований у фільтр у списку обладнання
* Доопрацьовано фільтр з вибірки будівель, що не зазначені на карті
* Доопрацьовано пошук точки на карті на маршруті комутації по введеному метражу
* Виправлено розрахунок точки на карті за маршрутом комутації ''(у деяких випадках)''
* Виправлено відображення значень додаткових полів у списку власників/орендарів
* Виправлено помилка при додаванні ТМЦ ''(у деяких випадках)''
* Виправлено розрахунок координат центру будівлі ''(у деяких випадках)''
* Виправлено відправлення SMS-абоненту при створенні завдання ''(по ланцюжку завдань)''

== 3.19.32 "Arsenic" - 17.11.2024 ==
* '''При створенні завдання або зміни його статусу можна надсилати SMS абоненту з цього завдання ''(опціональна система шаблонів, що настроюються)'''''
* '''У список ONU додано звіт "ONU, що не скомутовані до OLT"'''
* '''Для кабельних ліній додано можливість відображення точки на карті по введеному метражу на маршруті ''(наприклад для пошуку точки обриву)'''''
* Винесено окремо права на перегляд/зміну власників та на перегляд/зміну орендарів
* У списку кабельних ліній додано фільтрацію за маркою кабелю ''(з каталогу кабелів)''
* Додано параметр налаштування "Виводити співробітнику список його штрафів та премій"
* У картці зв'язку можна налаштувати параметр "Напрямок напису об'єкта на карті"
* У списку ONU/комутаторів додано фільтрацію за наявністю/відсутністю комутації на вказаному порту
* На сторінці новин за завданнями додано окремий звіт за всіма коментарями до завдань за останню добу
* При створенні завдання співробітником у кого немає прав на зміну виконавців тепер немає можливості призначити виконавців ''(використовуються тільки автоматично призначені)''
* У картці ключа в історії передачі ключа додано інформацію про співробітника, який виконав операцію передачі ключа
* Додано параметр налаштування "Вимкнути властивість "Будівля не підключена" за наявності абонентів"
* Виправлено помилка з неможливістю зміни пароля співробітником коли минув термін його заміни
* Виправлено перевірку обов'язковості заповнення об'єктів під час створення завдання ''(у деяких випадках)''
* Виправлено перенесення значень додаткового поля до іншого додаткового поля
* Виправлено перевірку на обов'язковість заповнення для додаткових полів з типом "Вибір зі списку ''(кілька значень)'''

== 3.19.31 "Nihonium" - 08.11.2024 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* '''Для шаф/стійок можна вказати максимальну електричну потужність, що виділяється на цей об'єкт'''
* У картці обладнання додано посилання в меню для швидкої передачі цього ТМЦ в інше місце ''(аналогічно дії картки ТМЦ)''
* Додано параметр налаштування "Загальномережеві повідомлення вважати архівними через ... днів"
* У групових діях за завданнями додано можливість прикріплювати UUID файлів ''(копії файлів)''
* У групових діях за завданнями додано можливість вказати номер батьківського завдання
* Для списку ONU в розділі "Обладнання" додано налаштування полів таблиці
* У швидкому пошуку у списку співробітників шукає у т.ч. за значеннями додаткових полів
* У списку співробітників підрозділу в полі з посадою, якщо вона не вказана явно - виводиться посада співробітника в компанії
* Виправлення помилок із взаємоблокуваннями по системі
* Виправлено відображення типів адаптерів на схемі комутації для кросів/ODF з довільними номерами адаптерів
* Виправлено помилка з формування посилання на координати на Google-картах ''(у деяких випадках)''

== 3.19.30 "Uranium" - 05.11.2024 ==
* Доопрацьовано метод API->task->[[API_task_UK#add|add]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* Доопрацьовано звіт за кількістю та розміром прикріплених файлів ''(з урахуванням множинного використання одних і тих же файлів)''
* У відомості робіт по співробітникам додано облік оплати за складовими роботами за завданням
* Виправлено перенесення всіх об'єктів з будівлі на іншу будівлю ''(у деяких випадках)''
* Виправлено помилка при перегляді відфільтрованого списку абонентів на головній сторінці ''(у деяких випадках)''

== 3.19.29 "Ruthenium" - 02.11.2024 ==
* '''Інтеграція ТМЦ будь-якого типу один в одного ''(раніше була можливість тільки інтегрувати ТМЦ у пристрої)'''''
* '''Для GPS-треків транспорту та співробітників відображаються стрілки напрямку руху на карті'''
* '''У картці абонента додано можливість швидкої передачі ТМЦ з доступних для поточного співробітника'''
* У налаштуваннях кожного складу доданий параметр "Надсилати повідомлення співробітникам при надходженні транзитних ТМЦ"
* У календарі робіт фільтр доданий мультивибір у типах завдань
* У групових процесах по спорудам зв'язку додано можливість створювати групове або окремі завдання
* Додано параметри налаштування для написів на карті "Розмір тексту написів", "Виводити написи з різних боків об'єктів"
* Доопрацьовано перевірку прав доступу до складів для співробітника у списку ТМЦ
* Доопрацьовано перевірку прав доступу для співробітників з обмеженим доступом з географії
* У схемі комутації запам'ятовується для співробітника обраний шар підкладки схеми "(чорний, білий, сірий)"
* У ланцюжках типів завдань додано можливість змінювати статус у батьківського завдання
* Додані типи пігтейлів SC UPC Female/SC APC Female
* Виправлено видалення файлів з додаткових полів під час редагування та збереження об'єкта
* Виправлено робота лінійки на карті покриття ''(у деяких випадках)''
* Виправлено відображення інформації у списку будівель ''(у деяких випадках)''
* Виправлено зміну порядку пунктів головного меню системи
* Виправлено відображення завдань у календарі робіт ''(у деяких випадках)''
* Виправлено автопризначення підрозділів на завдання по ланцюжку ''(у деяких випадках)''
* Виправлено відображення списку пов'язаних об'єктів при спробі видалення складу
* Виправлено збереження нотатки для операції списання ТМЦ
* Виправлено помилка відображення днів у календарі робіт пов'язана з переходом на літній/зимовий час

== 3.19.28 "Aluminium" - 21.10.2024 ==
* '''Масовий імпорт ТМЦ ''(з перенесенням на споруди зв'язку)'''''
* Доопрацьовано зміну дати завдання з одночасною зміною призначеного виконавця
* Новий тип додаткового поля "Прикріплені файли"
* У групових діях за будинками додано можливість встановлення інтервалів часу для проведення робіт на значення за замовчуванням або з налаштувань за замовчуванням
* Доопрацьовано налаштування автопризначення співробітників/підрозділів у типах завдань
* Доопрацьовано переміщення всіх ТМЦ з операції в рамках однієї операції по складу
* Фільтрування за власником у списку завдань перевірятиме і будівлі з таким власником, які прикріплені до завдання
* У фільтр списку дзвінків додано можливість вибірки за номером IP-телефону співробітника/оператора
* На карті покриття при наведенні на будівлю у випадку якщо в будівлі лише один абонент то в підказці виводиться інформація також і по цьому абоненту
* У групові дії по будинках додані операції з робочою заміткою по будівлі
* У каталозі товарів для найменувань ТМЦ додано поле з максимальною ел.потужністю
* У фільтрі у списку споруд зв'язку додано можливість вибірки за планованими об'єктами
* До групових дій по абонентам додано можливість зміни статусу ''(для ручних білінгів)''
* У списку будівель у групових діях додано зміну додаткового поля
* Для дільників/ущільнювачів додано можливість вказівки довільного інтервалу нумерації вихідних портів
* Оптимізація сторінки "Мої завдання"
* При введенні SMS під час відправлення в лівому меню - відображається лічильник кількості символів і явно використовується обмеження на максимальну довжину повідомлення
* Доопрацьовано перевірку прав щодо відправлення SMS співробітникам
* Додано параметр налаштування для календаря робіт "Відображати виконані завдання сірим кольором"
* Виправлення помилки з неможливістю передачі ТМЦ на спорудження зв'язку ''(у деяких випадках)''
* Виправлено зміну типу пігтейлів для кросу/ODF через схему комутації
* Виправлено помилка з порожніми IP/MAC-адресами у картці пристрою
* Виправлено помилка під час виконання групових дій для великого списку абонентів
* Виправлено нумерацію адаптерів кросу/ODF на схемі комутації для власних налаштувань номерів адаптерів
* Виправлено відправлення повідомлень співробітникам ''(у деяких випадках)''

== 3.19.27 "Nitrogen" - 14.10.2024 ==
* Новий тип додаткового поля "Тариф"
* Додано параметр налаштування "Для макету шаф/стійок використовувати зображення обладнання"
* Доопрацьовано швидкий пошук по будинках у верхній панелі та пошук по будинках у списку будівель працює за частковим збігом
* Для типів завдань додано параметр "Використовувати облік складових робіт за завданням"
* Доопрацьовано спрощення адрес для будівель з двома та більш складовими адресами
* У календарі робіт у спливаючій підказці на завданні виводиться більш розгорнута інформація ''(налаштована за шаблоном для типу завдання)''
* Додана темна тема інтерфейсу ''(в тестовому вигляді)'' та можливість швидкого перемикання світлої/темної тем у верхній панелі
* Додавання меню до картки пристрою
* Додавання до картки пристрою кнопки швидкого переходу в схему комутації з центруванням на цьому пристрої
* Додано параметр налаштування для абонентів "При переведенні в статус "Колишні" очищати комутацію"
* Виправлено швидкий пошук вмісту з апострофом на сторінці "Адреса (Будівлі)"
* Виправлено відображення комутації для кросів/ODF на схемі комутації
* Виправлено коректну вказівку коментарів до портів кросу/ODF
* Виправлено можливість змінити тип спорудження зв'язку в його картці
* Виправлено збереження коментарів на портах обладнання
* Виправлені групові дії для всього вибраного списку абонентів

== 3.19.26 "Mercury" - 08.10.2024 ==
* У картці ODF/кроса, дільника/ущільнювача ''(а також на об'єктах у стійці/шафі)'' додано посилання швидкого переходу в схему комутації з центруванням на цьому пристрої
* Додана підтримка роботи одночасно з кількома SMS-провайдерами при надсиланні повідомлень у лівому меню
* Для трас кабельних ліній доданий архів ''(настроюється)''
* У налаштуваннях по білінгу додано можливість вказівки інтервалу як часто оновлювати дані щодо трафіку абонентів
* Для трас кабельних ліній додано можливість створити копію
* Для ТМЦ доданий облік та робота із закупівельною вартістю
* Для профілів співробітників додано окремі права для перегляду та зміни закупівельної вартості
* Додано звіт "Оборотно-сальдова відомість (Закупівельна вартість)"
* У ланцюжках дій за завданнями додано можливість зміни статусу на потрібний через інтервал часу
* Додані типи транспорту
* Додано висновок типу завдання у невиконаних завданнях у картці абонента
* Для графіка роботи співробітника можна вказати термін його дії
* При вказівці абоненту VLAN ID можна вказати tag/untag
* Доопрацьовано відображення кабельних ліній на карті покриття при зміні масштабу
* Доопрацьовано відображення ліній на схемі комутації
* Виправлено помилка при роботі планувальника та спроб повідомлення співробітників про зникнення активності обладнання
* Виправлено помилка з відображенням залежних абонентів для деяких типів пристроїв ''(у деяких випадках)''
* Виправлено помилка при імпорті списку обладнання ''(у деяких випадках)''
* Виправлено пошук за назвою будівлі, що містить апостроф у пошуку верхньої панелі
* Виправлено вказівку типу адаптера за замовчуванням для портів ODF/кросів при їх додаванні

== 3.19.25 "Dysprosium" - 02.10.2024 ==
* У робочому часі співробітника додано можливість перегляду старих графіків роботи та копіювання записів з існуючих
* Доопрацьовано вказівку довільних координат для абонентів
* Доопрацьовано відображення вибраних споруд зв'язку на карті в групових діях за ними
* Виправлено коректне відображення у календарі завдань, що тривають кілька днів
* Виправлено використання шаблону для повідомлень за допомогою Messenger про падіння/підняття обладнання
* Виправлення неточностей відображення додаткової інформації в розділі "IP-підмережі"
* Виправлений знімання OLT-RX рівнів сигналів з OLT
* Виправлено роботу параметра "Заборонити додавання, якщо номер телефону вже використовується в іншому записі"

== 3.19.24 "Curium" - 28.09.2024 ==
* '''У фільтр по комутаторам додано можливість відображення пристроїв з портами, що вийшли з ладу'''
* Додано метод API->task->[[API_task_UK#mark_add|mark_add]]
* Додано метод API->task->[[API_task_UK#mark_delete|mark_delete]]
* У списку споруд зв'язку додано можливість відображення на карті відфільтрованих записів
* На карті покриття додаткові шари можна швидко посиланням виділяти все/знімати виділення
* Доопрацьовано передачу ТМЦ на об'єкти завдання при його виконанні та спрацюванні автоматизації
* Для типів завдань можна налаштовувати параметр "Дозволяти виконання завдань лише за наявності прикріплених файлів"
* До списку абонентів можна додати колонку "MAC-адреса"
* У списку завдань якщо увімкнено відображення колонок додаткових полів, то значення таких додаткових полів не виводяться в поле "Опис"
* До налаштування списку завдань додано параметр "У полі "Опис" додавати додаткові поля"
* Доопрацьовано роботу з селектором вибору шарів об'єктів на карті покриття для мобільних пристроїв
* У схемі комутації для кабельної лінії можна скинути порядок провідників/волокон/жил за замовчуванням
* Доопрацювання додавання та видалення вручну координат маршруту для кабельної лінії
* У ланцюжку завдань та автоматизації для типу завдання додано можливість "Призначити виконавцем підрозділ співробітника, що змінив статус у завдання"
* При додаванні комутатора пропонується відразу вказати Uplink-порт
* Для профілю співробітника додано право на перегляд вартості ТМЦ за складом
* Для списку дзвінків додано можливість залишати коментар до кожного виклику
* Для списаних ТМЦ у списку виводиться поле з його попереднім місцезнаходженням
* Доданий тип пігтейлу/адаптера "E2000"
* Додано параметр налаштування для модуля usm_asterisk "Інтервал між викликами з одного номера, щоб було створено нове завдання (секунд)"
* Доопрацьовано визначення завдань як прострочені
* Виправлено дублювання записів історії зміни координат по кабельним лініям, а також виправлено навігацію сторінками у вікні історії по об'єктах
* Виправлено помилка при отриманні рівнів сигналів ONU по OLT ''(у деяких випадках)''
* Виправлено помилка при додаванні споруди зв'язку з карти покриття
* Виправлено відображення логічної схеми будівлі ''(у деяких випадках)''
* Виправлено приховування панелі редагування на карті покриття ''(у деяких випадках)''
* Виправлено фільтрація у списку завдань за адресним об'єктом ''(у деяких випадках)''
* Виправлено підсвічування селектора вибору співробітника на завдання ''(у деяких випадках)''

== 3.19.23 "Strontium" - 23.09.2024 ==
* '''Для абонентів різних категорій на карті можна налаштовувати колір значків ''(фізичні особи, юридичні особи, колишні абоненти, потенційні абоненти)''. Також окремо налаштовується можливість змінювати межу значка для неактивних абонентів'''
* '''абонентам можна вказувати VLAN ''(кілька)''. У картці VLAN видно абонентів, у яких він вказаний '''
* '''У налаштуванні типів завдань додано спільну сторінку з налаштуванням розцінок за всіма типами завдань'''
* '''При додаванні споруди зв'язку можна відразу вказати його координати, використовуючи геолокацію ''(якщо це підтримує пристрій та браузер)'''''
* Право у профілі співробітника "Редагування виконаних завдань" тепер впливає на неможливість зміни статусу у виконаного завдання
* У списку обладнання додано сортування за кількістю вільних портів
* Трохи змінено зовнішній вигляд LC-адаптерів на схемі комутації
* У списку співробітників номери телефонів зроблені активними з можливістю зателефонувати та інших операцій з ними
* У групових діях за абонентами додано можливість масово змінювати значення додаткового поля
* У списку дзвінків для невідомих номерів додано можливість швидко додати потенційного абонента або прикріпити номер до існуючого абонента
* У списку дзвінків тепер відображаються і співробітники, якщо виклик надійшов від них. У фільтрі за дзвінками додана фільтрація по співробітнику.
* Кожен співробітник може в особистих налаштуваннях вказати параметр "У списку завдань виводити спочатку завдання з високим пріоритетом"
* У списку будівель додано фільтрацію за наявності налаштованого інтервалу часу для виконання робіт
* У звіті по резервах на складах додано можливість фільтрації за конкретними складами
* Для статусів абонентів можна завантажувати власний значок, що відображатиметься у списку абонентів
* Додано параметр налаштування з обладнання "Виводити список VLAN ID на інтерфейсі"
* До списку абонентів додано фільтрацію за знижкою
* У налаштуваннях профілю співробітника можна вказати, чи доступна цьому профілю інформація по балансу, тарифу абонентів
* Для об'єктів на карті (полігони, написи, зображення) додані додаткові поля
* До інформації щодо завдань у картці абонента ''(вкладка "Тех.підтримка")'' додано виведення інформації за автором завдання
* Для списку тарифів додано можливість налаштування полів таблиці
* У налаштування винесено параметр "Швидкість транспорту для зміни кольору маршруту" у двох варіантах. Дозволяє змінювати на карті колір ділянок маршруту транспорту залежно від його швидкості на цій ділянці
* У налаштуванні полів списку завдань можна виводити колонку з чек-листами за завданнями
* При створенні нового адресного об'єкта, якщо ця будівля - то пропонується кнопка швидкого збереження та переходу в картку цієї будівлі
* У налаштуванні кольорів кабельних ліній на карті в залежності від ємності кабелю додано можливість вказувати і товщину ліній
* Додано автогенерацію імені абонента для входу в систему при додаванні нового співробітника
* Для постачальників додано можливість налаштування полів таблиці
* Заборонено звільняти співробітника за наявності ТМЦ на ньому
* Під час передачі ТМЦ на абонента в результатах швидкого пошуку відображається і адреса абонента
* У ланцюжках типів завдань додано можливість копіювання пріоритету при створенні нового завдання
* У звіті за кількістю абонентів у будівлях додана фільтрація по вищому адресному об'єкту ''(за населеним пунктом, районом тощо)''
* При зміні кінцевих точок кабельної лінії - пропонується очистити комутацію з відповідної сторони
* Для запасів кабелю кожної кабельної лінії можна вказати індивідуальний колір відображення на карті
* До списку комутаторів додано фільтрацію за моделями пристроїв та за кількістю вільних портів
* Для профілів операторів окремо винесено права перегляду та зміни об'єктів на карті ''(полігони, написи...)''
* У списку будівель додано фільтрацію за наявності робочої нотатки на будівлі
* Лічильники трафіку на портах підтримують відображення петабайтів
* У звіті залишків ТМЦ додано можливість виведення детальної інформації щодо ТМЦ при експорті в Excel
* Для кросов/ODF додано можливість вказати власника
* У додаткових полях додані варіанти "заповнено" та "не заповнено" в "Умови та залежності"
* Для додаткових полів типу "Вибір зі списку" додано можливість вказувати роздільники у списку
* У картці абонента виводяться у верхній частині всі невиконані завдання щодо нього
* У картці завдання додано можливість швидкого виключення підрозділів із завдання
* Додано параметр "Автоматично вмикати опитування модулем usm_peleng при вказівці пристрою IP-адреси"
* Для типів споруд зв'язку додано налаштування шаблону спливаючої підказки на карті
* У ланцюжках автоматизації за типами завдань додано можливість копіювання коментарів з первинного завдання до нового, що створюється
* Виправлено помилка при видаленні запису в блокноті
* Виправлено розрахунок дати "Виконати до" для завдань ''(у деяких випадках)''

== 3.19.22 "Technetium" - 18.09.2024 ==
* '''У завданнях додано можливість повідомлень у Telegram/Messenger співробітників та спостерігачів про зміну статусу завдання'''
* '''Для пристроїв впроваджено функціональність "Планування". Пристрій можна відзначити як запланований і не буде в т.ч. активно опитуватись '''
* '''У шарах карти покриття додано можливість відразу відобразити всі шари або відключити всі шари'''
* '''У лівому меню зі спорудами зв'язку доданий розділ з усіма схемами планування ''(у схемах комутації)'''''
* '''Для комутаторів додано розрахунок маршруту з'єднань. Для спрощення прописування VLAN. Вказується початковий пристрій, кінцевий пристрій і якщо є комутація - покаже список всіх пристроїв і портів на них, де потрібно прописати VLAN'''
* Для співробітників додано параметр налаштування "Шаблон повного ПІБ", що дозволяє змінити в цілому за системою порядок імені та прізвища
* У таблиці обладнання, що встановлено у стійці, можна налаштувати виведення додаткових полів по обладнанню
* Список будівель, що не зазначені на карті, перероблений з окремої сторінки у вигляді умови фільтра в загальному списку будівель
* Якщо у пристрою кілька IP-адрес - можна вибрати який з них буде основним ''(в т.ч. для SNMP-опитування)''
* У логічній схемі будівлі додано посилання для приховання колишніх абонентів
* На карті додана кнопка для відображення підказок для всіх об'єктів в області видимості на екрані ''(на великих масштабах)''
* У налаштуваннях завдання додано параметр "Шаблон інформації для копіювання при кліку на номер завдання"
* Для кожного OLT можна увімкнути параметр "Заборонити автооновлення рівнів сигналів на підключених ONU", що унеможливлює відповідні запити на цей пристрій
* Для кожного типу завдань можна налаштувати якісь об'єкти обов'язкові до заповнення ''(наприклад: спорудження зв'язку, абонент, будівля тощо)''
* У властивостях додаткових вкладок у картці абонента додано властивість "Завантажувати сторінку з боку сервера", що дозволяє використовувати серверний curl
* Додані окремі шаблони для надсилання повідомлень через пошту та Messenger/Telegram про падіння/піднімання обладнання. До шаблонів додано нові змінні.
* Для обладнання додано параметр налаштування "Вважати порти з комутацією до колишніх абонентів як вільні"
* Для потенційних абонентів додано параметр "Заборонити додавання, якщо номер телефону вже використовується в іншому записі"
* Додано параметр налаштування для картки абонента "Оновлювати активність під час PING"
* При зміні коментаря на порту обладнання - підставляється текст існуючого коментаря
* Для типів завдань можна налаштувати "Шаблон спливаючого повідомлення на карті"
* Для кожного типу кабельної лінії можна налаштувати шаблон спливаючого повідомлення на карті "(з можливим виведенням даних додаткових полів)"
* У списку кабельних ліній можна додати відображення колонки з кількістю вільних провідників
* Повернено можливість перетягування спливаючих діалогових вікон
* Виправлено вибір типів завдань при створенні завдання щодо спорудження зв'язку/абоненту
* Виправлено відображення завдань на карті покриття ''(у деяких випадках)''
* Виправлено відображення об'єктів на карті покриття для співробітників з обмеженими правами доступу ''(у деяких випадках)''
* Виправлено виконання ланцюжка дій за завданнями ''(у деяких випадках)''

== 3.19.21 "Beryllium" - 12.09.2024 ==
* Доопрацювання сортування адрес у швидкому пошуку верхньої панелі
* Виправлено відображення спливаючої схеми комутації на спорудженні зв'язку на карті за відсутності прав на редагування споруди зв'язку
* Виправлення помилок міграції

== 3.19.20 "Cadmium" - 12.09.2024 ==
* '''При закритті завдання можна вибирати які ТМЦ з усіх доступних передати на завдання і в якій кількості ''(налаштовується)'''''
* '''Додано окремі права для співробітників - перегляд та зміна логічної схеми будівлі'''
* До статистики додано звіт зі зміни статусу у завдань співробітниками за період
* У меню картки спорудження зв'язку додано посилання на версію для друку
* Доопрацьовано відображення календаря працівників у діалоговому вікні зміни дати виконання робіт
* Виправлено відображення зайнятого годинника для співробітника в календарі завдань ''(у деяких випадках)''
* Виправлено редагування завдання за відсутності прав на додавання такого типу завдань
* Виправлено помилка при фільтрації за додатковим полем у списку абонентів ''(у певному випадку)''
* Виправлено копіювання значень додаткових полів під час створення дочірнього завдання по ланцюжку
* Виправлено помилка при перегляді списку обладнання ''(у деяких випадках)''

== 3.19.19 "Meitnerium" - 08.09.2024 ==
* '''Новий тип додаткових полів "Пароль"'''
* Додано метод API->task->[[API_task_UK#add_owner_to_task|add_owner_to_task]]
* Додано метод API->task->[[API_task_UK#remove_owner_from_task|remove_owner_from_task]]
* Для типів завдання додано можливість налаштування копіювання власників з об'єктів, що прикріплюються ''(будівель, споруд зв'язку)''
* Перероблено швидкий пошук по ТМЦ при додаванні дільника
* Під час створення копії лінії зв'язку додано підтвердження
* У групових діях за VLAN додано масове перейменування
* Додано право для профілю співробітника "Прослуховування записів дзвінків"
* Для об'єкта на карті (полігон) додано можливість завантажувати координати з KML-файлу
* Додано налаштування полів таблиці з ТМЦ у картці операції по складу
* Складові адреси будівель ''(з 2/3/4... адрес)'' тепер спрощуються в назвах, відкидаючи збігаються початкові частини адреси
* У календарі призначень співробітників за завданням - блокується до вибору час, у який заборонено вести роботи по будівлі
* Для типів споруд зв'язку додані поля, що настроюються "Висота над рівнем моря (м.)" і "Розміри (ШхВхГ) (див.)"
* Підкориговано роботу з умовами та залежностями додаткових полів
* Виправлено помилка при додаванні графіка робочого часу для співробітника
* Виправлено помилка при призначенні умов SMS-розсилки ''(у деяких випадках)''
* Виправлено робота ланцюжків та залежностей для додаткових полів ''(у деяких випадках)''
* Виправлено обробка написів на карті покриття при її переміщенні ''(у деяких випадках)''
* Виправлено перевірку прав на редагування завдання при його збереженні
* Виправлено пропадання пігтейлів на кінцях кабельної лінії під час її редагування
* Виправлено вилучення підрозділів з автоспостерігачів для типу завдань
* Виправлення масштабування об'єктів на карті покриття ''(у деяких випадках)''
* Виправлено призначення авто-виконавців в умовах ланцюжка за завданнями
* Виправлено відображення додаткових полів у формі реєстрації дзвінка від абонента
* Виправлено копіювання значень додаткових полів під час створення дочірнього завдання ''(залежно від різних налаштувань)''

== 3.19.18 "Lanthanum" - 01.09.2024 ==
* '''Додано побудову залежних абонентів по конкретному порту пристрою, по дільнику/ущільнювачу ''(а також окремо по кожному адаптеру)'', по кросу/ODF ''(а також окремо по кожному адаптеру)'''''
* '''У розділі "Персонал" додана сторінка "Відпустки та лікарняні"'''
* У налаштуванні робочого часу співробітника можна вказати відразу графік на 14 днів
* Для умов та залежностей відображення додаткових полів додано варіант "не рівно"
* Доопрацьовано відображення контекстного меню для споруд зв'язку ''(в режимі відображення без canvas)''
* У картці ТМЦ виводяться підказки до додаткових полів найменувань ТМЦ
* Виправлено приховування написів на карті покриття при переміщеннях карти
* Виправлено помилка при переміщенні кроса/ODF на іншу споруду зв'язку
* Виправлено фільтрація по додатковому полю у списку завдань ''(у деяких випадках)''
* Виправлено робота залежностей та умов щодо додаткових полів типу "Прапор"

== 3.19.17 "Thorium" - 30.08.2024 ==
* '''У документі для параметра "INVENTORY_OPERATION_INVENTORY_LIST_RU" та подібних зроблено можливість налаштування полів цієї таблиці'''
* Для будівель можна налаштувати інтервали виконання робіт, що включають два і більше інтервали для кожного дня
* Змінена видача методу API->address->[[API_address_UK#get_house|get_house]]
* Доопрацьовано метод API->additional_data->[[API_device_UK#get_value|get_value]]
* Доопрацьовано фільтрацію за датою коментаря та автором коментаря у списку завдань
* Для профілю співробітника додано нове право "Виключення ТМЦ з операції" ''(за складом)''
* На колір полігонів на карті впливає колір призначених на полігон міток
* У групових діях за завданнями доданий варіант масової зміни значень додаткового поля
* Для об'єктів на карті з типом "Напис" додано натискання лівої кнопки миші, що веде до картки цього об'єкта
* Виправлено відображення червоним кольором неактивних будівель на карті покриття
* Виправлено візуалізація кольору будівель залежно від призначеної мітки на будівлі
* Виправлено помилка при перегляді картки полігону на карті ''(у деяких випадках)''
* Виправлено помилка під час роботи системного планувальника ''(у деяких випадках)''
* Виправлено відображення найменувань спец.об'єктів у додаткових полях у списку завдань
* Виправлено обробка умов та залежностей для додаткових полів для типу поля "Вибір зі списку (кілька значень)"

== 3.19.16 "Cobalt" - 27.08.2024 ==
* У налаштуванні типу завдань додано параметр налаштування "Виключати інших виконавців при виборі конкретного виконавця через календар"
* На карті покриття для об'єктів на карті з типом "Напис" додано клікабельний перехід до картки цього напису та контекстне меню з можливістю редагування
* Виправлено непотрібні підтвердження на співробітниках при створенні завдання на роботу ''(в деяких випадках)''
* Виправлено локалізація віджету календаря в розділі "Журнал завдань - Календар"
* Виправлені неточності візуалізації при виборі співробітника з-під календаря під час створення завдання

== 3.19.15 "Actinium" - 25.08.2024 ==
* Роботи з оптимізації та швидкодії карти покриття. '''При першому завантаженні об'єкти можуть завантажуватися довго у зв'язку з кешуванням.'''
* Додано параметр "Мінімальний масштаб для написів на об'єктах інфраструктури"
* Доопрацьовано метод API->device->[[API_device_UK#get_data|get_data]]
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* Доопрацювання фокусування селектора вибору виконавців під час створення завдання
* Для всіх типів споруд зв'язку ''(в т.ч. з власними значками на карті)'' виводиться контекстне меню правою кнопкою на карті покриття
* При об'єднанні потенційного та поточного абонента переноситься також і історія дій по абоненту
* Допрацьовано відображення/приховування ланцюжком додаткових полів залежно від значення додаткового поля
* У меню комутації волокна кабельної лінії додано можливість відображення залежних від цього волокна абонентів
* Для портів кросов/ODF додано можливість побудови структурної схеми по одному порту
* У налаштуванні таблиці списку завдань додано поле "Адреса (Будівля) ID"
* У автоматизації та ланцюжках за типами завдань додані варіанти дій "Співробітник. Виключити", "Підрозділ. Виключити", "Співробітник. Виключити всіх", "Підрозділ. Виключити всіх", "Співробітник. Автоматично призначені.
* При виборі виконавця на завдання через календар - береться до уваги кількість годин часу на виконання і в календарі враховується це значення при виборі осередків
* Додано параметр "Дозволити призначати співробітників у календарі на недоступний годинник"
* Для типів завдань можна призначати автоматичних спостерігачів залежно від адреси завдання
* Виправлено відображення пігтейлів на волокнах у схемі комутації
* Виправлено коректне проставлення UP/DNLINK-інтерфейсу для обладнання
* Виправлено відображення посилань на додавання нового завдання з-під лівого меню ''(у деяких випадках)''
* Виправлено зміну кольору комутації між об'єктами на схемі комутації
* Виправлено помилка під час перегляду логічної схеми будівлі ''(у деяких випадках)''

== 3.19.14 "Zirconium" - 20.08.2024 ==
* '''У групові дії ТМЦ додано можливість передачі ТМЦ'''
* '''Додано облік графіка роботи з кожному з підрозділів'''
* '''Для додаткових полів можна вказувати профілі співробітників для яких ці поля будуть доступні'''
* При призначенні співробітника/підрозділу на завдання - у календарі виводиться інформація щодо робочих годин цього співробітника відповідно до графіка його роботи
* Додано метод API->cwdm->[[API_cwdm_UK#get|get]]
* При редагуванні абонента можна вручну вписати його координати
* Додано виведення адреси за завданням у підказці на заданні на карті
* У плані робіт до групових дій додано можливість додати/виключити спорудження зв'язку із завдання
* У шаблоні картки завдання можна виводити інформацію про контактних осіб абонента
* У списку завдань адресу завдання зроблено клікабельною і додано маркер швидкого переходу на карту покриття
* Для міток об'єктів додано візуальний шаблон відображення на карті - штрихпунктирна лінія з двома точками
* При створенні/зміні завдання час "виконати до" можна вказати як у вигляді кількості годин так і вказати конкретну дату/час
* У картці спорудження зв'язку для обладнання та ТМЦ виводяться дати встановлення цих об'єктів
* Додано параметр налаштування "При видаленні потенційного абонента - видаляти та пов'язані з ним завдання"
* Додано швидкий пошук по ТМЦ при додаванні дільника/ущільнювача на зв'язок
* При включенні режиму редагування на карті елементи керування зміщуються нижче
* Порти кросу/ODF можна довільно нумерувати
* При поверненні завдання з відкладеного - завдання повертається в останній не-відкладений статус ''(для випадків, коли завдання перед тим як стати "відкладеним" вже знаходилося у відкладеному статусі)''
* Для керованого пристрою можна увімкнути/вимкнути опитування модулем usm_iferr
* У властивостях SMS-розсилки можна виключати абонентів за окремими адресами
* У розділі "Склад" лівого меню додано швидкий перехід на ТМЦ за його ID
* Для дільників/ущільнювачів заборонено подвійну комутацію на портах
* Виправлено помилка під час перегляду схеми комутації споруди зв'язку ''(у деяких випадках)''
* Виправлення помилок при імпорті інформації з білінгу ''(у деяких випадках)''
* Виправлено зміну маршруту кабельної лінії на карті покриття ''(у деяких випадках)''
* Виправлено неправильне сортування у списку завдань ''(у деяких випадках)''
* Виправлено застосування деяких властивостей для власних розділів, що настроюються.
* Виправлено зміну маршруту комутації у схемі комутації споруди зв'язку
* Виправлено відображення інформації по абонентам на схемі комутації у підказках ''(у деяких випадках)''

== 3.19.13 "Hafnium" - 16.08.2024 ==
* '''У прикріплених файлах можна повторно використовувати інший файл і прикріплювати його до інших об'єктів. Використовуючи його UUID ''(додаткова кнопка)'''''
* '''Для споруд зв'язку додано контекстне меню правою кнопкою миші на карті покриття'''
* При додаванні полігону з карти покриття – після додавання буде відкриватися форма редагування цього полігону
* У групових діях по кабельним лініям додано можливість зміни марки кабелю ''(без зміни кольору біля волокон)''
* У селекторі вибору власника для об'єкта додано швидкий пошук
* У властивостях типу завдань можна налаштувати індивідуальні норми часу на виконання для кожної будівлі
* При створенні завдання та призначення співробітника виконується перевірка чи не призначено його вже на цей час на інше завдання
* У плані робіт додано можливість фільтрації по групі абонента та ID абонента у білінгу. Також можна настроїти відображення даних полів у списку завдань
* При пошуку за MAC-адресою у глобальному пошуку - додано посилання на порт обладнання для перегляду списку всіх MAC-адрес по цьому порту
* У схемі комутації для з'єднання можна вказувати тип з'єднання ''(наприклад: гільза)''
* У картці завдання поле "Час на виконання з дати початку робіт" тепер підтримує дробові значення
* Виправлено відображення дублікатів ONU на головній сторінці ''(за серійним номером)''
* Виправлено помилка в роботі планувальника, пов'язана з переведенням відкладених завдань у звичайні ''(у деяких випадках)''
* Виправлено масштаб карти при зміні координат споруди зв'язку
* Виправлено перевірку на обов'язковість для додаткового поля типу "Транспорт"
* Виправлено побудова списку залежних абонентів від кабельної лінії

== 3.19.12 "Meitnerium" - 10.08.2024 ==
* '''Додано облік графіка роботи по кожному із співробітників'''
* Доопрацьовано метод API->task->[[API_task_UK#edit|edit]]
* Додано параметр "Приховувати версію ERP на загальнодоступних сторінках"
* Для списку завдань додано можливість виведення тарифу за завданням для співробітників
* Виправлено відображення/оновлення інформації щодо інтерфейсів у картці пристрою
* Виправлені неточності у відображенні в картці кросу/ODF поточної комутації та історії комутації
* Виправлено помилка при прив'язці пристрою до запису бази обладнання в каталозі товарів ''(у деяких випадках)''

== 3.19.11 "Hassium" - 08.08.2024 ==
* '''У картці співробітника додано параметр "Вимагати зміну пароля при наступному вході"'''
* '''Для полігонів на карті покриття додано контекстне меню'''
* '''Для кожної категорії кросів/ODF ''(патч-панелі, розетки)'' можна налаштовувати роздільні додаткові поля, роздільні мітки та роздільні налаштування полів таблиці відображення списку'''
* При створенні нового завдання по будівлі - відображається список невиконаних завдань за цією адресою
* Для об'єктів на карті додано можливість прикріплювати файли
* Перероблено інтерфейс та принципи взаємодії форми віддаленого закриття завдань співробітниками
* У плані робіт доопрацьовано фільтрацію за додатковими полями
* До картки транспорту додано посилання на перегляд списку завдань, де цей транспорт прикріплений у додаткових полях
* Виправлено непотрібну деінтеграцію дочірніх ТМЦ при скасуванні операції переміщення батьківського ТМЦ
* Виправлено відображення зображень обладнання у картці пристрою
* Виправлено помилка при імпорті довідників споруд зв'язку ''(у деяких випадках)''
* Виправлено помилка при побудові структурою схеми ''(у деяких випадках)''
* Виправлено вилучення кабельних ліній із завдання
* Виправлено відображення кольору посилань у списку завдань відповідно до налаштувань зовнішнього вигляду для типу завдання

== 3.19.10 "Dubnium" - 04.08.2024 ==
* '''При перекладі завдання до статусу "Відкладено" додано швидку можливість відкласти завдання на 1,2,3,4,6,8,12 годин'''
* У відомості робіт з персоналу додано фільтрацію за типом завдань
* Додано параметр налаштування для видалення старих записів з повідомленнями ''(e-mail, sms, messenger...)''
* У картці абонента інформація про невиконане завдання по абоненту виводиться у скороченому вигляді
* Заборонено відкладати завдання на дату, що раніше поточної
* Виправлення формування структурної схеми ''(у деяких випадках)''
* Виправлено помилка при збереженні значень додаткових полів ''(у деяких випадках)''
* Виправлено некоректне переміщення картки після першого переходу на карту з-під картки будівлі ''(у деяких випадках)''
* Виправлено помилка при вході в налаштування профілю абонента ''(у деяких випадках)''
* Виправлені неточності при оновленні даних по ONU на OLT ''(у деяких випадках)''
* Виправлено відображення підписів до запасів кабельних ліній на карті ''(у деяких випадках)''
* Виправлено ідентифікацію у списку ONU по OLT пристроїв, які на складі
* Виправлено відображення ниток повива на кабельних лініях у схемі комутації ''(у деяких випадках)''

== 3.19.9 "Yttrium" - 29.07.2024 ==
* '''У розділі "Налаштування - Основна - Персонал" додано звіт з логом невдалих спроб аутентифікації'''
* '''Для об'єктів на карті додані групові дії ''(додавання, зняття мітки)'''''
* '''Для рекламних кампаній доданий архів та у списку кампаній можливість фільтрації за наявності кампанії в архіві'''
* '''Нові типи додаткових полів: зв'язок, абонент, співробітник, підрозділ, транспорт, обладнання, кабельна лінія'''
* '''Виділено окреме право на додавання завдань ''(для кожного типу завдань)''. Раніше це право було включено до права на редагування завдань'''
* '''Винесено окреме право для абонентів - видалення системних пристроїв ''(раніше - це вирішувалося загальним правом на запис для системних пристроїв)'''''
* '''Для об'єктів на карті ''(наприклад полігони)'' додано поле "Нотатки". Також ці нотатки виводяться на карті у підказці по об'єкту на карті'''
* У повідомленнях між співробітниками доданий швидкий пошук одержувача
* Доданий тайм-аут в 10 секунд між повідомленнями співробітника ''(іншому співробітнику)''
* У картці дільника/ущільнювача змінено меню дій
* Доопрацювання у додаванні кросу/ODF зі схеми комутації
* У разі виключення ТМЦ з операції переміщення - також виключаються і всі інтегровані до неї дочірні ТМЦ
* Виправлено відображення додаткових полів під час редагування та виконання завдання
* Виправлено посилання вибору часу календаря при додаванні/редагуванні завдання
* Виправлено помилка у відображенні кінцевої точки у підказці схеми комутації ''(у деяких випадках)''
* Виправлено роботу фільтра за адресою ''(у деяких випадках)''
* Виправлено помилка при відкритті картки завдання ''(у деяких випадках)''
* Виправлено помилка при додаванні типового коментаря по завданням

== 3.19.8 "Vanadium" - 22.07.2024 ==
* '''У картці полігону ''(об'єкта на карті)'' виводиться список споруд зв'язку, які він покриває'''
* '''Додано можливість розділяти ТМЦ кратно ''(а не тільки поштучно або на дві частини як раніше)'''''
* '''У фільтрі для споруд зв'язку додано можливість вибірки за датою встановлення, додатковими полями, власним значком на карті'''
* Поле "Метраж кабелю" у картці абонента розширено до 5 символів
* Виправлено помилка при зміні координат споруди зв'язку ''(у деяких випадках)''
* Виправлено помилка у формі створення/редагування завдання ''(у деяких випадках)''
* Виправлено помилка при отриманні списку ONU з OLT ''(у деяких випадках)''

== 3.19.7 "Seaborgium" - 19.07.2024 ==
* '''Додано можливість налаштування кількості невірних спроб входу в систему для використання інтервалу між спробами входу ''(захист від перебору паролів)'''''
* '''У списку споруд зв'язку додано фільтр за адресним розміщенням ''(місто, вулиця і т.д.)'''''
* '''В історії дій абонентів додано можливість фільтрації за IP-адресою'''
* '''Новий тип додаткового поля "Час"'''
* У підказках на полігонах на карті виводяться призначені мітки
* При додаванні ТМЦ в операцію автоматично туди додаються та інтегровані ТМЦ
* Додано метод API->task->[[API_task_UK#overview_task|overview_task]]
* Виправлено помилка при збереженні значення додаткового поля в картці об'єкта ''(у деяких випадках)''
* Виправлено можливість вказувати для стійки глибину понад 999 мм.
* Виправлені неточності контекстного меню для портів кросу на схемі комутації ''(у деяких випадках)''
* Виправлено коректне підсвічування комутації до кросу/ODF у схемі комутації
* Виправлено відображення значень основних додаткових полів у картці абонента
* Виправлено робота правил поведінки у додаткових полях ''(у деяких випадках)''
* Виправлено сортування у списку ONU по OLT при перемиканні сторінок списку
* Виправлено редагування в картці кабельної лінії нотаток, в яких містяться лапки

== 3.19.6 "Rubidium" - 10.07.2024 ==
* Виправлено фільтрація за додатковим статусом у списку завдань ''(у деяких випадках)''
* Виправлено відображення колонки з точкою комутації для списку абонентів ''(у деяких випадках)''
* Виправлено робота з відображенням додаткових полів під час редагування картки абонента ''(у деяких випадках)''
* Виправлено робота умов додаткових полів ''(у деяких випадках)''
* Виправлено помилка імпорту обладнання ''(у деяких випадках)''
* Виправлено масове помилкове видалення комутації для кросів/ODF
* Виправлено створення кабельної траси з карти покриття
* Виправлено округлення довжини траси кабельних каналів при її створенні
* Виправлення в англійській локалізації

== 3.19.5 "Manganese" - 29.06.2024 ==
* Виправлено помилка під час перегляду картки транспорту ''(у деяких випадках)''
* Виправлено помилка при неможливості видалення споруди зв'язку ''(у деяких випадках)''
* Виправлено помилка при перегляді списку всіх завдань по абоненту ''(у деяких випадках)''
* Виправлено глобальний пошук по кросах/ODF
* Виправлено помилка при відкритті головної сторінки ''(у деяких випадках)''
* Виправлено помилка при поділі кабельної лінії ''(у деяких випадках)''
* Виправлено помилка при редагуванні кабелю в каталозі кабелів

== 3.19.4 "Potassium" - 23.06.2024 ==
* Додано метод API->map->[[API_map_UK#map_object_facilities_inside|map_object_facilities_inside]]
* Доопрацьовано перетягування об'єктів на схемі комутації для мобільних пристроїв
* Виправлено помилка роботи віджету головної сторінки "Флуд MAC-адрес на портах комутаторів" ''(у деяких випадках)''
* Виправлено помилка при спробі створити завдання з-під картки абонента без адреси
* Виправлено помилка при редагуванні пристрою ''(у деяких випадках)''
* Виправлено можливість зміни напрямку введення кабельної лінії на схемі комутації будівлі
* Виправлено відображення кабельних ліній на схемі комутації абонента
* Виправлено можливість редагування маршруту траси кабельних каналів
* Виправлено помилка при спробі встановлення кроса/ODF у шафу/стійку ''(у деяких випадках)''

== 3.19.3 "Tantalum" - 20.06.2024 ==
* Додано метод API->map->[[API_map_UK#map_object_mark_add|map_object_mark_add]]
* Додано метод API->map->[[API_map_UK#map_object_mark_delete|map_object_mark_delete]]
* Виправлено групове формування QR-кодів для ТМЦ
* Виправлено помилка при передачі ТМЦ-обладнання на абонента ''(у деяких випадках)''
* Виправлено помилка при редагуванні картки ONU ''(у деяких випадках)''
* Виправлено помилка при спробі вказати довільний запас на карті для кабельної лінії
* Виправлено помилка при відкритті картки комутатора ''(у деяких випадках)''
* Виправлено перехід посилань у карті трасами кабельних каналів

== 3.19.2 "Scandium" - 16.06.2024 ==
* Виправлено помилка під час перегляду в календарі робіт завдань по всіх співробітниках
* Виправлено перехід у картку ТМЦ з-під картки операцій по складу
* Виправлено помилка при відкритті картки обладнання ''(у деяких випадках)''
* Виправлено помилка під час роботи завдання планувальника "Перенесення інформації про підключених потенційних клієнтів у поточні" ''(у деяких випадках)''
* Виправлено помилка знімання даних по дистанціях ONU по OLT ''(у деяких випадках)''
* Виправлено помилка при відображенні підказки по транспорту на карті покриття ''(у деяких випадках)''
* Виправлено відображення списку тривог за модулем usm_observer

== 3.19.1 "Magnesium" - 14.06.2024 ==
* Доопрацьовано метод API->task->[[API_task_UK#get_catalog_state|get_catalog_state]]
* Виправлено помилка у відображенні схеми комутації ''(у деяких випадках)''
* Виправлено помилка під час перегляду картки завдання ''(у деяких випадках)''
* Виправлено можливість редагування додаткових полів для споруд зв'язку
* Виправлено помилка під час перегляду картки обладнання ''(у деяких випадках)''
* Виправлено відображення комутації кабельної лінії у схемі комутації, якщо вона починається і закінчується в одній споруді зв'язку
* Виправлено редагування координат будівлі з контекстного меню картки покриття
* Виправлені деякі помилки міграцій
* Виправлені помилки при опитуванні обладнання ''(у деяких випадках)''
* Виправлення помилок при опитуванні списку ONU по OLT
* Виправлено робота для карти параметра налаштування "На карті відкривати посилання на будинки/вузли та інші об'єкти в окремій вкладці/вікні"
* Виправлено відображення локалізованих символів в описі в картці завдання
* Виправлено відображення списку категорій за складом у розділі "ТМЦ" ''(у деяких випадках)''

== 3.19 "Oxygen" - 03.06.2024 ==
* Реліз версії 3.19
* Накопичувальні виправлення та зміни

== 3.19rc1 - 18.05.2024 ==
* Виправлення за підсумками бета-тестування
* Оптимізація та накопичувальні виправлення помилок версії 3.18

== 3.19beta2 - 04.05.2024 ==
* Виправлення за підсумками бета-тестування
* Оптимізація та накопичувальні виправлення помилок версії 3.18

== 3.19beta1 - 10.04.2024 ==
* Список змін див [[3.19_UK|3.19]]

Versions 3.19 EN

2026-11-12T09:38:42Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.19|uk]] | [[Версии_3.19|ru]]

Branch versions [[3.19_EN|3.19]]

Also see: [[Versions of ERP "USERSIDE"]]

== 3.19.55 "Plutonium" - 03.02.2026 ==
* Fixed link handling in task descriptions ''(in some cases)''
* Fixed an error when viewing the list of inventory items in the warehouse after changing task status
* Fixed minor bugs

== 3.19.54 "Lead" - 02.07.2025 ==
* Added possibility to display building manager in the list of buildings
* Added "Ignore duplicate E-mail addresses" parameter when sending group e-mails to customers
* Added possibility to specify the number of tasks in the statistics of problem customers
* Fixed sending of SMS notifications to employees of a subdivision when assigning a subdivision to a task
* Fixed error when viewing the list of tasks ''(in some cases)''
* Fixed sorting in FDB table survey results by device
* Fixed filtering by building in the list of warehouse operations ''(in some cases)''

== 3.19.53 "Samarium" - 10.06.2025 ==
* '''Added new connection type: "Planned object" in the switching scheme'''
* '''In personal settings for a user, added possibility to individually set the number of records in tables'''
* In group actions on tasks, added possibility to add/remove labels for users that are related to tasks
* In the news counter for tasks, news where the employee's subdivision is an observer are also counted
* Fixed filtering of grouped tasks by task status

== 3.19.52 "Nobelium" - 18.05.2025 ==
* For map tiles added setting parameter "Maximum scale (programmatically)"
* In the building card in the list of cable lines added separate filtering by types of cable lines
* In the work plan added filter for tasks that have no comments
* Fixed ruler operation on the coverage map ''(in some cases)''
* Fixed selection of modified task status in task chain setting for parent/child tasks
* Fixed bug when filtering tasks by status in the "Statistics" section
* Fixed an error when viewing an advertising campaign ''(in some cases)''
* Fixed correct output of the correct number of records in the equipment list

== 3.19.51 "Promethium" - 26.04.2025 ==
* For cable line types added "Minimum scale for displaying objects on the map" option
* Added "Send SMS (Additional field with phone number)" option to automation chains by task type
* Fixed operation of postponed task chains when creating the current one in terms of assigning/excluding employees

== 3.19.50 "Iodine" - 19.04.2025 ==
* Improved method API->fiber->[[API_fiber_EN#edit|edit]]
* Fixed rendering of switching arrows on multiplexer adapters ''(in some cases)''
* Fixed SMS templates text generation in the left menu
* Some other minor changes and fixes

== 3.19.49 "Sodium" - 12.04.2025 ==
* Added method API->vlan->[[API_vlan_EN#customer_add_to_vlan|customer_add_to_vlan]]
* Added method API->vlan->[[API_vlan_EN#customer_remove_from_vlan|customer_remove_from_vlan]]
* Fixed selecting/saving executors when changing task status
* Fixed error when viewing Vlan list by device ''(in some cases)''
* Fixed copy/no customer when creating a child task
* Fixed changing the status of the parent task in the chain
* Fixed quick search by task type when creating a child task ''(in some cases)''
* Fixed viewing the list of active customers now when navigating from the main page
* Fixed resetting of equipment access settings when saving a device card

== 3.19.48 "Erbium" - 05.04.2025 ==
* Improved method API->attach->[[API_attach_EN#add|add]]
* Added a quick search in the task type selector when creating a child task
* Ability to delete unused addresses is separated for buildings and for other address units
* Added a filter link to the general list of cable lines with filtering by lines of the given building in the building card in the tab with the list of cable lines
* When creating a child task, you can choose whether to copy the task description and customers from the parent task
* In the customer list table, added the ability to display a column with the customer's own coordinates
* In the customer card, if the customer has its own coordinates, added a link to go to Google Maps
* Improved changing the list of related equipment from under the task card
* Improved display of news by task
* Fixed display of the VlanID list in the switch port table ''(in some cases)''
* Fixed bug when creating a task/changing status when there is a chain of tasks ''(in some cases)''
* Fixed generation of links to customer list in growth chart
* Fixed display of labels on customer in customer information in task list
* Fixed display of * symbol in links in task text description
* Fixed filtering by "Address (does not contain)" filter in task list

== 3.19.47 "Rhenium" - 24.03.2025 ==
* Inventory selection menu will now be minimised when changing task status by default
* Fixed unnecessary SMS to translit conversion ''(in some cases)''
* Fixed bug when trying to edit the attachment file description ''(in some cases)''
* Fixed group action in task list "Transfer all customers from tasks to former customers"
* Fixed bug in task list when filtering by former customers ''(in some cases)''
* Fixed group change of value of additional field for buildings ''(in some cases)''

== 3.19.46 "Tungsten" - 09.03.2025 ==
* In the "Settings - Equipment base" section, added the ability to synchronise the local equipment base manually ''(automatically once a day)''
* Each employee can set up the property "Hide tasks from the main page, with the attribute "put on the main page"
* In task chains/automation by task type, added the option "Parent task. Add comment"
* When creating a duplicate polygon from the map - the duplicate is created directly on the map in the mode of changing its coordinates
* For task statuses added parameter "Forbid adding comments to tasks in this status"
* In coverage settings added option to specify default properties when adding new polygons
* In group actions on objects on the map ''(polygons)'' added possibility to change colour, transparency, border properties
* In the list of cable lines added filter by address
* When editing polygon coordinates on the coverage map, it is enough to press Enter key to save coordinates
* In the building card, added a tab with cable lines that are located on this building, communication facilities or customers on it
* Fixed display of customer information in the pop-up message of usm_asterisk module ''(in some cases)''
* Fixed transfer of information about potential customer's address when adding a customer and switching the physical/legal entity mode
* Fixed error in the window of creating a new communication facility ''(in some cases)''
* Fixed error in recalculation of building address when changing parent address object ''(in some cases)''
* Fixed an error when renaming an attached file to a name with apostrophe
* Fixed filter by owner in the task list
* Fixed bug when editing a billing card ''(in some cases)''

== 3.19.45 "Berkelium" - 02.03.2025 ==
* '''New permission "Allow export to Excel of the entire list" has been added for employee profiles'''
* Added method API->customer->[[API_customer_EN#msg_add_to_customer|msg_add_to_customer]]
* Added method API->node->[[API_node_EN#get_relation_customers|get_relation_customers]]
* Added method API->device->[[API_device_EN#get_relation_customers|get_relation_customers]]
* In the object card on a map with the type "Polygon", added display of other polygon objects that are included in this polygon. With the ability to filter
* Fixed duplication of subdivision sections in the "My Tasks" section ''(in some cases)''
* Fixed grouping in the task list
* Fixed creating a secondary task by chain when creating a primary task
* Fixed grouping/filtering by owner in the task list

== 3.19.44 "Lutetium" - 22.02.2025 ==
* Added method API->employee->[[API_employee_EN#division_employee_add|division_employee_add]]
* Added method API->employee->[[API_employee_EN#division_employee_remove|division_employee_remove]]
* Added ability to group by owner for the task list
* Ctrl+LeftClick on the coverage map on the object on the map with the "Polygon" type opens the card of this polygon, Alt+LeftClick on the coverage map on the object on the map with the ‘Polygon’ type enables the mode of changing the coordinates of this polygon
* In the pop-up message of incoming calls of the usm_asterisk module, customers with the regular status ''(instead of, for example, former ones)'' are displayed first
* Added quick search by task type name in the task type classifier
* Added fixation and displaying of the employee who closed/marked the task as completed
* Added a column with information whether inactivity informing is enabled in the equipment list fields setting
* Silhouettes of entrances are displayed with brighter lines in the logical scheme of the building
* In the configuration file it is possible to use an array of trusted IP addresses for access without 2FA authorisation ''(with 2FA authorisation enabled)''
* For objects on the map (polygons), added possibility to specify transparency and appearance of the object boundary
* Added possibility to create copies for objects on the map from under the object card or coverage map
* Fixed operation of the task chain on assigning the task author by the executor when creating a task
* Fixed filters in the list of tasks ''(in some cases)''
* Fixed a bug with the inability to select a inventory item when closing a task ''(in some cases)''
* Fixed adding comments to child tasks along the chain ''(in some cases)''

== 3.19.43 "Rhodium" - 16.02.2025 ==
* '''For cable lines the possibility to merge them has been added'''
* "Owner" column has been added to the list of tasks
* When adding a comment to a task, added possibility to use @ symbol to refer to a subdivision ''(with sending a notification to all employees of this subdivision)''
* In the customer's card, if the customer has an address of a building and the building has coordinates, a marker for quick jump to this building is displayed on the coverage map
* In the table settings by addresses ''(buildings)'' the possibility to display the column with the number of customers by building was added
* Columns with additional fields are hidden in the list of customers if there are no values in them
* Added "Ignore use of 2FA for employees with trusted login IP addresses" setting option
* Fixed cable tester working on separate ports on switches
* Fixed error with employee filtering when building a report on inventory balances
* Fixed operation of the setting parameter "Dividers/ Compactors. Allow switching only to free ports" setting parameter
* Fixed correct copying of settings of automatic assignment of employees/subdivisions for a task type

== 3.19.42 "Iron" - 10.02.2025 ==
* Improved search for owners by value of an additional field
* Grouping of tasks by type, status, building, author, month of creation added to the list of tasks
* Notes display added to the list of vehicle actions
* Improvement of sending messages by task from under the task card
* Fixed setting of chains by task type ''(in some cases)''
* Fixed editing of phone number for former customer
* Fixed filtering by value of additional field by buildings ''(in some cases)''
* Fixed filtering by optional fields in customer list ''(in some cases)''
* Fixed displaying of the list of automatic observer- subdivisions when creating a new task
* Fixed rendering of multiplexer shape on switching scheme ''(in some cases)''
* Fixed display of switching on multiplexer ports in its card ''(in some cases)''

== 3.19.41 "Francium" - 25.01.2025 ==
* API->task->[[API_task_EN#edit|edit]] method has been improved
* In task type for an employee, added possibility to copy assignment settings from another task type
* In the conditions of SMS-dispatch by customers, added possibility of filtering by discount size
* Modification of QR code generation for communication facilities
* Fixed an error when importing communication facilities ''(in some cases)''
* Fixed an error when deleting a subnet of a customer ''(in some cases)''
* Fixed error when creating a new employee ''(in case 2FA is used)''

== 3.19.40 "Barium" - 19.01.2025 ==
* API->employee->[[API_employee_EN#edit|edit]] method has been improved
* Added the ability to change the manager to the group actions on buildings
* Added link to view the ''(and related tasks)'' task on the map to the task card menu
* Added a quick link to exclude a customer linked to a task in the task card
* Improved hiding/displaying of a large list of bound customers in the task card
* For the list of employees it is possible to display a column with the name of the subdivision
* In the building card added filter on the list of communication facilities for this building
* In group actions on customers the possibility of mass addition and exclusion from a task has been added
* Correction of small errors and inaccuracies

== 3.19.39 "Neon" - 11.01.2025 ==
* In group actions on tasks, the possibility to exclude an observer has been added
* For types of communication facilities it is possible to set up a template for entering a number
* In group actions on communication facilities added possibility to add/exclude from the task
* Fixed saving of the template by type of communication structures for the tooltip on the coverage map
* Fixed sorting in ONU list by OLT when a specific PON-port is selected

== 3.19.38 "Argon" - 04.01.2025 ==
* In the task card, if cable lines are attached, a link to display these lines on the map is displayed
* Work with marks has been added for keys
* The parameter of displaying QR-code with coordinates of the communication facility, which refers to the task, has been added to the variables of the document template for the task
* Added setting parameter "Dividers/ Compactors. Allow switching to free ports only"
* Added action options "Child task. Change status to" and "Child task. Add comment"
* Fixed display of communication facilities on the map at very large scales ''(in some cases)''
* Fixed search on coverage map
* Fixed backslash when editing comments to tasks

== 3.19.37 "Bromine" - 27.12.2024 ==
* In chains/conditions by task types added possibility to specify additional condition of triggering ''(at the first stage - presence of a certain tag on the customer)''
* In the list of cable lines added group actions to add/exclude cable lines to the task
* Added filter on presence of specified VLAN to the list of customers
* Fixed bug when viewing the list of tasks ''(in some cases)''
* Fixed an error when viewing history of actions by employee ''(in some cases)''
* Fixed an error in the form of inventory receipt ''(in some cases)''
* Fixed an error when working an additional field with the "Counter" type ''(in some cases)''
* Fixed sorting by values of additional fields in the task list ''(in some cases)''
* Fixed calculation of the value in the additional field of the "Counter" type
* Fixed interface error when searching for information on communication facilities in the task card
* Fixed change of pigtail for cable line fibre that terminates at the customer

== 3.19.36 "Fermium" - 15.12.2024 ==
* In the building card it is now possible to add communication facilities of the required type and quantity in bulk
* When adding buildings to the advertising campaign - for a certain street, it is now possible to select several buildings of this street at once
* When selecting addresses for the advertising campaign, it is possible to add all buildings by owner at once
* Automation of sending SMS to customers when the status of a task is changed has been improved. You can choose one-time sending or every time the status is changed.
* Added setting of holiday and sick leave types for personnel
* The filter "Author of task ''(Employees of a subdivision. Including dismissed and transferred employees)'''" has been added to the list of tasks
* In the statistics on problem buildings added filter by address ''(settlement, district, etc.)''
* For the usm_observer module, added the ability to customise the text of alarm/cancellation messages for each monitored indicator
* When merging a potential customer and a current customer, the "Legal entity" attribute is transferred
* In group actions on objects on the map added possibility to delete them
* Fixed filtering by customer group ''(and not being in customer group)'' in the list of customers
* Fixed error when filtering task list by customer type ''(in some cases)''
* Fixed an error when displaying values of additional fields in the object header ''(in some cases)''

== 3.19.35 "Phosphorus" - 08.12.2024 ==
* Added API->fiber->[[API_fiber_EN#set_pigtail_type|set_pigtail_type]] method
* Added customisation of table fields for user list
* Added ability to select by "Building not connected" property in building filter
* In the form for selecting inventory items for replacement, only inventory items for the current employee/ or for all employees, if their sub-account is available
* Fixed adding a link to a task comment in a different comment
* Fixed sorting of task list by task author
* Fixed correct selection of tasks in the task list ''(in some cases)''
* Fixed auto-switching of customers to equipment ports (by scheduler assignment)
* Fixed work of the report on customers' cash receipts
* Fixed saving of empty comments for all device ports

== 3.19.34 "Tin" - 02.12.2024 ==
* Improved API->owner->[[API_owner_EN#add|add]] method
* Improved API->owner->[[API_owner_EN#edit|edit]] method
* Migration of basic owner/tenant data to additional fields
* In group actions on communication facilities added possibility of mass change of address
* In the list of cable lines added filter by polygon on the map, which covers these cable lines
* In the list of communication facilities, added filter by polygon on the map, which covers these communication facilities
* For devices the possibility to change comments on ports in bulk has been added
* In the list of works by personnel, added possibility of filtering by subdivision
* Added setting option "Tasks that are marked for output to the main page. Including closed tasks to be displayed"
* Added setting option "Dividers/Compactors. Allow double switching to ports"
* Fixed employee excluding himself/herself from a task ''(in some cases)''

== 3.19.33 "Carbon" - 23.11.2024 ==
* Added method API->employee->[[API_employee_EN#merge|merge]]
* Improved method API->employee->[[API_employee_EN#edit|edit]]
* In the list of customers in group actions when displaying them on the map - also displays and signals by ONU that they have installed ''(if any)''
* Up to 3 tenants/owners can be specified for communication facilities
* Support for filtering by tenant/owner in the list of communication facilities and cable lines ''(with possibility of displaying on the map)''
* "ONUs that are not switched to OLT" report integrated into the filter in the equipment list
* Improved filter for selecting buildings that are not marked on the map
* Improved search for a point on the map on the switching route by the entered metreage
* Fixed calculation of a point on the map on a switching route ''(in some cases)''
* Fixed display of values of additional fields in the list of owners/tenants
* Fixed error when adding inventory items ''(in some cases)''
* Fixed calculation of building centre coordinates ''(in some cases)''
* Fixed sending SMS to a customer when creating a task ''(by task chain)''

== 3.19.32 "Arsenic" - 17.11.2024 ==
* '''When creating a task or changing its status, it is possible to send SMS to the customer from this task ''(optional system of customisable templates)'''''
* '''The report "ONUs that are not switched to OLT" has been added to the ONU list'''
* '''For cable lines added possibility to display a point on the map by entered metre on the route ''(e.g. to find a break point)'''''
* Separate rights for viewing/changing owners and viewing/changing tenants have been added
* In the list of cable lines added filtering by cable brand ''(from cable catalogue)''
* Added setting option "Display to employee a list of his/her fines and bonuses"
* In the card of a communication facility it is possible to adjust the parameter "Direction of the object inscription on the map"
* In the list of ONUs/switches added filtering by presence/absence of switching on the specified port
* A separate report on all comments to tasks for the last 24 hours has been added to the page of news on tasks
* When creating a task by an employee who does not have rights to change executors, it is no longer possible to assign executors ''(only automatically assigned executors are used)''
* Information about the employee who performed the key transfer operation has been added to the key card in the key transfer history
* Added setting parameter "Disable ''Building not connected'' property when there are customers"
* Fixed an error with impossibility to change the password by an employee when the period of its replacement has expired
* Fixed check if objects must be filled in when creating a task ''(in some cases)''
* Fixed transfer of values of an additional field to another additional field
* Fixed check of mandatory filling for additional fields with the "Select from list ''(multiple values)''" type

== 3.19.31 "Nihonium" - 08.11.2024 ==
* API->customer->[[API_customer_EN#get_customers_id|get_customers_id]] method has been improved
* '''For cabinets/racks, you can specify the maximum electric power allocated to this object'''
* Added a menu link in the equipment card to quickly transfer this item to another location ''(similar to the action in the item card)''
* Added setting parameter "Network-wide messages to be considered as archived after ... days"
* Added possibility to attach UUIDs of files in group actions on tasks ''(file copies)''
* In group actions by tasks, added possibility to specify parent task number
* Customisation of table fields has been added to the ONU list in the ‘Equipment’ section
* In quick search in the list of employees searches by values of additional fields as well
* In the list of subdivision employees in the field with position, if it is not specified explicitly, the position of the employee in the company is displayed
* Correction of errors with interlocks in the system
* Fixed display of adapter types on the switching scheme for crosses/ODF with arbitrary adapter numbers
* Fixed bug with forming link to coordinates on Google maps ''(in some cases)''

== 3.19.30 "Uranium" - 05.11.2024 ==
* Improved API->task->[[API_task_EN#add|add]] method
* Improved API->task->[[API_task_EN#edit|edit]] method.
* Improved the report on the number and size of attached files ''(taking into account multiple uses of the same files)''
* Added accounting of payment for composite works by task in the list of works by employees
* Fixed transfer of all objects from a building to another building ''(in some cases)''
* Fixed a bug when viewing filtered customer list on the main page ''(in some cases)''

== 3.19.29 "Ruthenium" - 02.11.2024 ==
* '''Integration of all types of inventory items into each other ''(previously it was only possible to integrate inventory items into devices)'''''
* '''GPS tracks of vehicles and employees are now displayed with direction arrows on the map'''
* '''In the customer's card added the possibility of quick transfer of inventory items from those available for the current employee'''
* "Send notifications to employees when transit goods arrive" has been added to each warehouse settings
* In the work calendar filter added multiselection in task types
* In group actions on communication facilities added possibility to create group or separate tasks
* Added settings for inscriptions on the map "Text size of inscriptions", "Display inscriptions from different sides of objects"
* Improved checking of access rights to warehouses for an employee in the list of inventory items.
* Checking of access rights for employees with limited access by geography has been improved
* In the switching scheme the selected layer of the scheme backing ''(black, white, grey)'' is memorised for the employee
* In task type chains added ability to change status of parent task
* Added SC UPC Female/SC APC Female pigtail types
* Fixed deleting files from additional fields when editing and saving an object
* Fixed ruler work on coverage map ''(in some cases)''
* Fixed display of information in the list of buildings ''(in some cases)''
* Fixed changing the order of the system main menu items
* Fixed display of assignments in the work calendar ''(in some cases)'''
* Fixed auto-assignment of subdivisions to a task by chain ''(in some cases)''
* Fixed displaying of the list of related objects when trying to delete a warehouse
* Fixed saving a note for write-off operation
* Fixed display of days in the work calendar related to summer/winter time transition

== 3.19.28 "Aluminium" - 21.10.2024 ==
* '''Mass import of commodities ''(with transfer to communication facilities)'''''
* Improved change of task date with simultaneous change of assigned executor
* New type of additional field "Attached files"
* In group actions on buildings added possibility to set time intervals for works to default values or from default settings
* Improved setting of auto-assignment of employees/units in task types
* Improved moving of all inventory items from a transaction within one operation by warehouse
* Filtering by owner in the task list will also check buildings with such owner, which are attached to the task
* In the filter of the calls list the possibility of selection by IP-phone number of the employee/operator has been added
* On the coverage map when pointing at a building, if there is only one customer in the building, the information for this customer is displayed in the tooltip as well
* In group actions on buildings added operations with a work note on the building
* In the catalogue of goods the field with the maximum electric power has been added for the names of commodities.
* In the filter in the list of communication facilities added the possibility of selection by planned facilities
* In group actions on customers added possibility to change the status ''(for manual billing)''
* In the list of buildings in group actions added change of additional field
* For splitters/splitters added possibility to specify arbitrary numbering interval for outgoing ports
* Optimisation of "My tasks" page
* When entering SMS when sending in the left menu - the counter of the number of characters is displayed and the limitation on the maximum length of the message is used explicitly
* Improved checking of permissions for sending SMS to employees
* Added setting parameter for the work calendar "Show completed tasks in grey colour"
* Fix bug with impossibility to transfer goods and materials to the communication facility ''(in some cases)''
* Fixed changing the type of pigtails for cross/ODF via switching scheme
* Fixed error with empty IP/MAC addresses in the device card
* Fixed bug when performing group actions for a large list of customers
* Fixed numbering of cross/ODF adapters on the switching scheme for custom adapter number settings
* Fixed sending notifications to employees ''(in some cases)''

== 3.19.27 "Nitrogen" - 14.10.2024 ==
* New type of additional field ‘Rate’
* Added "Use equipment images for cabinet/rack layout" setting option
* Improved quick search by building in the top panel and search by building in the list of buildings works by partial match
* For task types, added "Use accounting of composite work by task" parameter
* Address simplification for buildings with two or more composite addresses has been improved
* More detailed information is displayed in the task calendar in the tooltip on the task ''(customisable by template for the task type)''
* Added a dark interface theme "(in test form)" and the ability to quickly switch between light/dark themes in the top panel
* Adding menu in the device card
* Addition of a button in the device card to quickly switch to the switching scheme with centring on this device
* Added setting parameter for customers "When switching to "Former" status, clear switching"
* Fixed quick search for content with apostrophe on "Addresses (Buildings)" page
* Fixed display of switching for crosses/ODFs on the switching scheme
* Fixed correct specification of comments for cross/ODF ports
* Fixed ability to change the type of communication installation in its card
* Fixed saving of comments on equipment ports
* Fixed group actions for the whole selected customer list

== 3.19.26 "Mercury" - 08.10.2024 ==
* In the card of ODF/cross, divider/compactor ''(as well as in rack/cabinet objects)'', a link to quickly switch to the switching scheme with centring on this device has been added
* Added support for working simultaneously with several SMS providers when sending messages in the left menu
* Added archive for cable line traces ''(customisable)''
* In billing settings added possibility to specify the interval how often to update data on customers' traffic
* For cable line traces added possibility to create a copy
* For inventory items added accounting and work with purchase price
* Separate rights for employee profiles to view and change the purchase price have been added
* Added the report "Turnover-salary statement (Purchase cost)"
* Added possibility to change the status to the required one after a time interval in task action chains
* Added transport types
* Added output of task type in uncompleted tasks in customer card
* For employee's work schedule it is possible to specify its validity period
* When specifying VlanID to a customer it is possible to specify tag/untag
* Displaying of cable lines on the coverage map when zooming in has been improved
* Improved display of lines on the switching scheme
* Fixed bug in scheduler and attempts to notify employees about equipment activity loss
* Fixed bug with displaying dependent customers for some types of devices ''(in some cases)''
* Fixed bug when importing equipment list ''(in some cases)''
* Fixed search by building name, which contains apostrophe in top bar search
* Fixed default adapter type for ODF/cross ports when adding them

== 3.19.25 "Dysprosium" - 02.10.2024 ==
* Added possibility to view old work schedules and copy records from existing ones in employee's working hours
* Improved specification of arbitrary coordinates for customers
* Improved display of selected communication installations on the map in group actions on them
* Fixed correct displaying of tasks that last several days in the calendar
* Fixed use of a template for Messenger notifications about dropping/raising equipment
* Fixed inaccurate display of additional information in "IP subnets" section
* Fixed OLT-RX capturing of signal levels from OLTs
* Fixed the operation of the "Prevent adding if phone number is already used in another entry" setting parameter

== 3.19.24 "Curium" - 28.09.2024 ==
* '''Added the ability to display devices with failed ports to the switch filter'''
* Added method API->task->[[API task EN#mark_add|mark_add]]
* Added method API->task->[[API task EN#mark_delete|mark_delete]]
* Added possibility to display filtered records on the map in the list of communication installations
* On the coverage map additional layers can be quickly selected/unselected with a link
* Improved transfer of inventory items to the task objects when the task is executed and the automation is triggered
* For task types it is possible to configure the parameter "Allow execution of tasks only if there are attached files"
* "MAC address" column can be added to the list of customers
* In the task list, if the display of additional field columns is enabled, the values of such additional fields are not displayed in the "Description" field
* Added "Add additional fields to the "Description" field" parameter to the task list setting
* Work with the selector for selecting object layers on the coverage map for mobile devices has been improved
* It is possible to reset the default order of conductors/fibres/core in the cable line switching scheme
* Improvement of adding and deleting manually route coordinates for a cable line
* In the chain of tasks and automation for the task type, the option "Assign the employee who changed the status of the task as the executor of the subdivision" has been added
* When adding a switch it is offered to specify Uplink-port at once
* The right to view the cost of inventory by warehouse has been added for the employee's profile
* For the list of calls the possibility to leave a comment for each call has been added
* For written off inventory items in the list the field with its previous location is displayed
* Pigtail/adapter type "E2000" added
* Added setting parameter for usm_asterisk module "Interval between calls from one number to create a new task (seconds)"
* Improved detection of tasks as expired ones
* Fixed duplication of coordinate change history records by cable lines, as well as fixed page navigation in the history window by objects
* Fixed bug when getting ONU signal levels by OLT ''(in some cases)''
* Fixed an error when adding a communication installation from the coverage map
* Fixed display of building logic scheme ''(in some cases)''
* Fixed hiding of edit panel on coverage map ''(in some cases)''
* Fixed filtering in task list by address object ''(in some cases)''
* Fixed highlighting of employee selection selector on task ''(in some cases)''

== 3.19.23 "Strontium" - 23.09.2024 ==
* '''For customers of different categories on the map you can customise the colour of the icons ''(individuals, legal entities, former customers, potential customers)''. It is also separately customisable to change the icon border for inactive customers'''
* '''Customers can specify a Vlan ''(multiple)''. In the Vlan card you can see the customers whose Vlan is specified'''
* '''A common page with setting of rates for all types of tasks has been added to the task types setting'''
* '''When adding a communication installation, you can specify its coordinates immediately using geolocation ''(if your device and browser support it)'''''
* The "Edit completed tasks" permission in the employee's profile now makes it impossible to change the status of a completed task
* Sorting by the number of free ports has been added to the equipment list
* Slightly changed appearance of LC-adapters on the switching scheme
* In the list of employees phone numbers are made active with the ability to call and other operations with them
* In group actions on customers added possibility to change value of additional field in bulk
* In the list of calls for unknown numbers it is now possible to quickly add a potential customer or attach a number to an existing customer
* Employees are now displayed in the list of calls if the call is received from them. Filtering by the calling employee has been added to the call filter
* Each employee can specify the parameter "In the list of tasks, display tasks with high priority first" in personal settings
* Filtering by availability of the configured time interval for work execution has been added to the list of buildings
* In the report on reserves in warehouses the possibility of filtering by specific warehouses has been added
* Customer statuses can be loaded with their own icon, which will be displayed in the list of customers.
* Added ‘Display VlanID list on interface’ parameter for equipment settings
* Filtering by discount added to customer list
* In the settings of the employee profile you can specify whether the information on balance, tariff of customers is available to this profile
* Additional fields are added for objects on the map (polygons, inscriptions, images)
* In the information on tasks in the customer's card ''(tab "Technical support")'', added output of information on the task author
* The possibility of customising table fields has been added for the list of tariffs
* The parameter "Transport speed for changing the route colour" in two variants was added to the settings. It allows to change the colour of transport route sections on the map depending on its speed on this section
* The column with checklists by tasks can be displayed in the setting of task list fields
* When creating a new address object, if it is a building, a button for quick saving and switching to the card of this building is offered
* In setting the colours of cable lines on the map depending on the cable capacity the possibility to specify the thickness of lines has been added
* Added autogeneration of user name for logging in when adding a new employee
* Added possibility to customise table fields for suppliers
* It is forbidden to dismiss an employee if there are inventory items on him/her
* When transferring inventory items to a customer, the address of the customer is also displayed in the quick search results
* In chains of task types added possibility of priority copying when creating a new task
* In the report on the number of customers in buildings, filtering by higher address object ''(by settlement, district, etc.)'' has been added
* When changing the cable line endpoints - it is suggested to clear the switching on the corresponding side
* It is possible to specify individual colour of display on the map for cable stocks of each cable line
* Filtering by device models and by the number of free ports has been added to the list of switches
* Permissions to view and change objects on the map ''(polygons, inscriptions...)'' have been added for operator profiles separately
* In the list of buildings, added filtering by the presence of a working note on the building
* Traffic counters on ports support petabyte display
* In the report of inventory balances added possibility to display detailed information on inventory when exporting to Excel
* For crosses/ODF added possibility to specify owner
* In additional fields added "filled" and "not filled" options in "Conditions and dependencies"
* For additional fields of "Select from list" type added possibility to specify delimiters in the list
* All uncompleted tasks for a customer are displayed in the upper part of the customer's card
* In the card of the task added possibility of quick exclusion of subdivisions from the task
* Added setting parameter "Automatically enable polling by usm_peleng module when specifying IP-address to the device"
* For types of communication installations added setting of tooltip template on the map
* In automation chains by task types, added possibility to copy comments from the primary task to the new one that is created
* Fixed bug when deleting a notebook entry
* Fixed calculation of "Run to date" for tasks ''(in some cases)''

== 3.19.22 "Technetium" - 18.09.2024 ==
* '''In tasks, added ability to notify employees and observers in Telegram/Messenger about task status changes'''
* '''"Scheduling’" functionality has been implemented for devices. You can mark a device as scheduled and it will not be actively polled, among other things'''
* '''In the layers of the coverage map, the option to display all layers at once or switch off all layers has been added'''
* '''In the left menu with communication installations, added a section with all planning schemes ''(in switching schemes)'''''
* '''Connection route calculation for switches has been added. To simplify VLAN assignment. Specifies the start device, end device and if there is switching - it will show a list of all devices and ports on them, where VLANs should be written'''
* For employees, a setting parameter "Full Name Template" has been added, which allows you to change the order of first and last names in the system as a whole
* In the table of equipment that is installed in the rack you can configure the output of additional fields by equipment
* The list of buildings that are not marked on the map is redesigned from a separate page as a filter condition in the general list of buildings.
* If a device has several IP addresses - it is possible to select which of them will be the main one ''(including for SNMP polling)''
* Link for hiding former customers added to the building logical diagram
* On the map, added a button to display tooltips for all objects in the visibility area on the screen ''(on large scales)''
* Added "Information template to be copied when clicking on task number" option to the task settings
* For each OLT, you can enable the "Disable auto-update of signal levels on connected ONUs" parameter, which eliminates the corresponding requests to that device
* For each task type it is possible to configure which objects are mandatory to be filled in ''(e.g.: communication installation, customer, building, etc.)''
* In properties of additional tabs in customer card added property ‘Load page from server side’, which allows to use server curl
* Added separate templates for sending notifications via mail and Messenger/Telegram about equipment down/up. New variables have been added to the templates.
* For equipment added "Count ports with switching to former customers as free" setting parameter
* For potential customers added setting parameter "Prevent adding if the phone number is already used in another record"
* Added setting parameter for customer card "Refresh activity on PING"
* When changing the comment on the equipment port - the text of the existing comment is substituted
* For task types it is possible to configure "Template of pop-up message on the map"
* For each type of cable line it is possible to set up a pop-up message template on the map ''(with possible display of additional fields)''
* In the list of cable lines it is possible to add a column displaying the number of free conductors
* The ability to drag and drop pop-up dialogue boxes has been returned
* Fixed selection of task types when creating a telecom building/customer task
* Fixed display of tasks on the coverage map ''(in some cases)''
* Fixed display of objects on the coverage map for employees with limited access rights ''(in some cases)''
* Fixed execution of task action chain ''(in some cases)''

== 3.19.21 "Beryllium" - 12.09.2024 ==
* Improved sorting of addresses in the quick search of the top panel
* Fixed display of the pop-up switching scheme of a communication installation on the map when there are no permissions to edit the communication installation
* Fix migration errors

== 3.19.20 "Cadmium" - 12.09.2024 ==
* '''When closing a task, you can select which inventory items from all available ones to transfer to the task and in what quantity ''(customisable)'''''
* '''Added separate rights for employees - to view and change the logical scheme of the building'''
* Report on status changes of tasks by employees for the period added to statistics
* A link to the printable version has been added to the communication installation card menu
* Improved display of employees' calendar in the dialogue window for changing the date of work execution
* Fixed display of occupied hours for an employee in the task calendar ''(in some cases)''
* Fixed editing of a task when there are no permissions to add this type of tasks
* Fixed filtering by an additional field in the customer list ''(in some cases)''
* Fixed copying of values of additional fields when creating a child task by chain
* Fixed error when viewing the equipment list ''(in some cases)''

== 3.19.19 "Meitnerium" - 08.09.2024 ==
* '''New additional field type "Password"'''
* Added method API->task->[[API task EN#add_owner_to_task|add_owner_to_task]]
* Added method API->task->[[API task EN#remove_owner_from_task|remove_owner_from_task]]
* Added option for task types to configure copy owners from attached objects ''(buildings, communication facilities)''
* Reworked quick search by inventory when adding a divider
* Confirmation added when creating a copy of a communication line
* Added mass renaming in Vlan group actions
* Added "Listen to call recordings" permission for employee profile
* Added possibility to load coordinates from KML file for an object on the map (polygon)
* Added customisation of fields of the table with inventory items in the warehouse operation card
* Composite building addresses ''(of 2/3/4... addresses)'' are now simplified in names by discarding matching initial parts of the address
* In the calendar of employee assignments by task - the time in which it is forbidden to work on a building is blocked for selection
* Customisable fields "Height above sea level (m.)" and "Dimensions (WxHxH) (cm.)" have been added for types of communication structures
* Corrected work with conditions and dependencies of additional fields
* Fixed an error when adding a working time schedule for an employee
* Fixed an error when assigning conditions for SMS distribution ''(in some cases)''
* Fixed handling of chains and dependencies for additional fields ''(in some cases)''
* Fixed handling of marks on coverage map when moving it ''(in some cases)''
* Fixed checking of editing permissions when saving a task
* Fixed disappearance of pigtails at cable line ends when editing a cable line
* Fixed exclusion of subdivisions from auto-observers for a task type
* Fixed scaling of objects on the coverage map ''(in some cases)''
* Fixed assignment of auto-executors in task chaining conditions
* Fixed display of additional fields in the form of call registration from a customer
* Fixed copying of values of additional fields when creating a child task ''(depending on different settings)''

== 3.19.18 "Lanthanum" - 01.09.2024 ==
* '''Added construction of dependent customers by specific device port, by divider/compactor ''(as well as separately for each adapter)'', by cross/ODF ''(as well as separately for each adapter)'''''
* '''"Vacation and sick leave" page has been added to the "Personnel" section'''
* In the employee's working time setting, it is possible to specify a 14-day schedule at once
* Added "not equal" option for conditions and dependencies for displaying additional fields
* Context menu displaying for communication installations has been improved ''(in the display mode without canvas)''
* Tooltips for additional fields of inventory items names are displayed in the card of inventory items
* Fixed hiding of inscriptions on the coverage map when moving the map
* Fixed error when moving a cross/ODF to another communication installation
* Fixed filtering by additional field in task list ''(in some cases)''
* Fixed working of dependencies and conditions on additional fields of "Flag" type

== 3.19.17 "Thorium" - 30.08.2024 ==
* '''In the document for the parameter "INVENTORY_OPERATION_INVENTORY_LIST_RU" and similar, it is possible to customise the fields of this table'''
* For buildings it is possible to configure intervals of work execution that include two or more intervals for each day
* Changed output of API->address->[[API address EN#get_house|get_house]] method
* Refined API->additional_data->[[API device EN#get_value|get_value]] method
* Improved filtering by comment date and comment author in the list of tasks
* New right "Exclude inventory from operation" ''(by warehouse)'' added for employee's profile
* The colour of polygons on the map is affected by the colour of marks assigned to the polygon
* In group actions on tasks added an option for mass change of values of an additional field
* For objects on the map with the type "Inscription", left mouse click has been added, which leads to the card of this object
* Fixed display of inactive buildings in red colour on the coverage map
* Fixed rendering of building colour depending on the assigned mark on the building
* Fixed bug when viewing the polygon card on the map ''(in some cases)''
* Fixed bug in system scheduler ''(in some cases)''
* Fixed display of names of special objects in additional fields in the task list
* Fixed processing of conditions and dependencies for additional fields for the field type "Select from list (multiple values)"

== 3.19.16 "Cobalt" - 27.08.2024 ==
* Added "Exclude other executors when selecting a specific executor via calendar" setting in the task type setting
* On the coverage map for objects on the map with the type "Inscription" added clickable transition to the card of this inscription and context menu with the possibility of editing
* Fixed unnecessary confirmations on employees when creating a work task ''(in some cases)''
* Fixed localisation of the calendar widget in the "Job log - Calendar" section
* Fixed inaccurate visualisation when selecting an employee from under the calendar when creating a task

== 3.19.15 "Actinium" - 25.08.2024 ==
* Works on optimisation and speed of the coverage map. '''At the first load, objects may take a long time to load due to the caching.'''
* Added "Minimum scale for inscriptions on infrastructure objects" setting parameter
* Improved API->device->[[API device EN#get_data|get_data]] method
* Improved API->customer->[[API customer EN#get_customers_id|get_customers_id]] method
* Improved the API->task->[[API task EN#edit|edit]] method
* Improvement of the focus of the selector for selecting executors when creating a task
* Context menu for all types of communication installations ''(including those with their own icons on the map)'' is displayed by right-clicking on the coverage map
* When merging a potential and current customer, the history of actions on the customer is transferred as well
* Improved displaying/hiding of additional fields in the chain depending on the value of the additional field
* In the cable line fibre switching menu the possibility of displaying customers dependent on this fibre has been added
* For cross/ODF ports the possibility of building a structure scheme by one port has been added
* The "Address (Building) ID" field has been added to the setting of the task list table
* In automation and chains by task types, added action options "Employee. Exclude", "Subdivision. Exclude", "Employee. Exclude all", "Subdivision. Exclude all", "Employee. Automatically Assignable. Assign", "Subdivision. Automatically assignable. Assign."
* When selecting an executor for a task via calendar - the number of hours of time for execution is taken into account and this value is taken into account in the calendar when selecting cells
* Added setting parameter "Allow assigning employees to unavailable hours in the calendar"
* For task types it is possible to assign automatic observers depending on the task address
* Fixed display of pigtails on fibres in the switching scheme
* Correct UP/DNLINK interface assignment for equipment corrected
* Fixed display of links to add a new task from under the left menu ''(in some cases)''
* Fixed switching colour change between objects in the switching scheme
* Fixed error when viewing the building logic diagram ''(in some cases)''

== 3.19.14 "Zirconium" - 20.08.2024 ==
* '''Added possibility to transfer inventory items to group actions on inventory items'''
* '''Added accounting of work schedules for each subdivision'''
* '''For additional fields you can specify profiles of employees for whom these fields will be available'''
* When assigning an employee/ subdivision to a task - the calendar displays information about the working hours of this employee according to his/her work schedule
* Added API->cwdm->[[API cwdm EN#get|get]] method
* When editing a customer, you can manually enter its coordinates
* Added output of the address by task in the tooltip on the task on the map
* In the work plan in group actions added possibility to add/exclude communication structure from the task
* In the task card template it is possible to display information about customer's contact persons
* In the list of tasks the address of the task has been made clickable and a marker has been added for quick transition to the coverage map
* For object labels a visual template for displaying on the map - a dashed line with two points - has been added
* When creating/modifying a task, the time "to be done before" can be specified both in the form of number of hours and a specific date/time.
* In the card of the communication installation for equipment and inventory items the dates of installation of these objects are displayed
* Added setting option "When deleting a potential customer, delete related tasks as well"
* Added quick search by inventory when adding a divider/compactor to a communication installation
* When editing mode is enabled on the map, controls are shifted lower
* Cross/ODF ports can be numbered arbitrarily
* When returning a task from pending - the task returns to the last non-pending status ''(for cases where the task was already in pending status before becoming "pending")''
* Polling can be enabled/disabled for the controlled device by usm_iferr module
* In SMS-dispatch properties it is possible to exclude customers by individual addresses
* In the "Warehouse" section of the left menu, a quick switch to a commodity item by its ID has been added
* Double switching on ports is prohibited for dividers/compactors
* Corrected an error when viewing the switching scheme of a communication installation ''(in some cases)''
* Correction of errors when importing information from billing ''(in some cases)''
* Fixed changing of cable line route on coverage map ''(in some cases)''
* Fixed incorrect sorting in task list ''(in some cases)''
* Fixed applying some properties to own customisable partitions
* Fixed changing the switching route in the switching scheme of a communication installation
* Fixed display of customer information on the switching scheme in tooltips ''(in some cases)''

== 3.19.13 "Hafnium" - 16.08.2024 ==
* '''In attachments, it is possible to reuse another file and attach it to other objects. Using its UUID ''(additional button)'''''
* '''Right-click context menu added for communication installations on the coverage map'''
* When adding a polygon from the coverage map - after adding it, the form of editing this polygon will be opened
* In group actions on cable lines added possibility to change cable brand ''(without changing fibre colour)'''
* Quick search has been added in the selector for selecting the owner of an object
* In the properties of the task type it is possible to configure individual time standards for each building
* When creating a task and assigning an employee, a check is performed to see if the employee is already assigned to another task at that time
* In the work plan you can filter by customer group and customer ID in the billing system. You can also customise the display of these fields in the task list
* When searching by MAC-address in global search - added link to the equipment port to view the list of all MAC-addresses for this port
* In the switching scheme for a connection it is possible to specify the connection type ''(for example: sleeve)''
* In the task card, the "Time to complete from work start date" field now supports fractional values
* Fixed display of duplicate ONUs on the main page ''(by serial number)''
* Fixed a bug in the scheduler related to turning pending tasks into regular tasks ''(in some cases)''
* Fixed map scale when changing coordinates of a communication installation
* Fixed mandatory check for additional field of "Transport" type
* Fixed building of the list of dependent customers on the cable line

== 3.19.12 "Meitnerium" - 10.08.2024 ==
* '''Added accounting of work schedule for each employee'''
* Improved API->task->[[API task EN#edit|edit]] method
* Added "Hide ERP version on publicly accessible pages" setting option
* Added option to display task rate for employees in the list of tasks
* Fixed displaying/updating of interface information in the device card
* Fixed inaccuracies in displaying current switching and switching history in the cross/ODF card
* Fixed an error when linking a device to the equipment base record in the product catalogue ''(in some cases)''

== 3.19.11 "Hassium" - 08.08.2024 ==
* '''"Require password change at the next login" has been added to the employee card'''
* '''Added context menu for polygons on coverage map'''
* '''Separate additional fields, separate labels and separate field settings of the list display table can be configured for each category of crosses/ODF ''(patch panels, sockets)'''''
* When creating a new task for a building - the list of uncompleted tasks for this address is displayed
* For objects on the map added the ability to attach files
* Redesigned interface and interaction principles of the form for remote closing of tasks by employees
* Filtering by additional fields has been improved in the work plan
* A link to view the list of tasks where this transport is attached in additional fields has been added to the transport card
* Fixed unnecessary de-integration of child items of inventory when cancelling the operation of moving a parent item of inventory
* Fixed displaying of equipment images in the device card
* Fixed error when importing directories of communication installations ''(in some cases)''
* Fixed an error when building a structure scheme ''(in some cases)''
* Fixed exclusion of cable lines from the task
* Fixed displaying the colour of links in the task list according to the appearance settings for the task type

== 3.19.10 "Dubnium" - 04.08.2024 ==
* '''When a task is transferred to "Postponed" status, a quick option to postpone the task for 1,2,3,4,6,8,12 hours has been added'''
* Filtering by task type has been added to the personnel task list
* Added setting option to delete old records with notifications ''(e-mail, sms, messenger...)''
* In the customer card the information about uncompleted task is displayed in the abbreviated form
* It is forbidden to postpone a task to a date earlier than the current one
* Corrects formation of the structure scheme ''(in some cases)''
* Fixed bug when saving values of additional fields ''(in some cases)''
* Fixed incorrect moving of the map after the first transition to the map from under the building card ''(in some cases)''
* Fixed bug when entering user profile settings ''(in some cases)''
* Fixed inaccuracies when updating ONU data on OLT ''(in some cases)''
* Fixed display of cable stock captions on map ''(in some cases)''
* Fixed identification in the ONU list by OLT of units that are in stock
* Fixed display of cable line strands on cable lines in the switching scheme ''(in some cases)''

== 3.19.9 "Yttrium" - 29.07.2024 ==
* '''A report with the log of failed authentication attempts has been added in the "Settings - Main - Personnel" section'''
* '''For objects on the map added group actions ''(add, unmark)'''''
* '''For advertising campaigns added archive and in the list of campaigns the possibility of filtering by the presence of the campaign in the archive'''
* '''New types of additional fields: communication installation, customer, employee, subdivision, transport, equipment, cable line'''
* '''Allocated a separate right to add tasks ''(for each type of task)''. Previously, this right was included in the right to edit tasks'''
* '''Separate right for users to delete system devices ''(previously this was handled by the general write right for system devices)'''''
* '''For objects on the map ''(e.g. polygons)'' added the field "Notes". Also these notes are displayed on the map in the tooltip of the object on the map'''
* Added quick recipient search in messages between employees
* Added 10 seconds timeout between messages from an employee to ''(another employee)''
* Changed the action menu in the divider/sealer card
* Improvements in adding cross/ODF from the switching scheme
* If an inventory item is excluded from a move operation, all child inventory items integrated into it are also excluded
* Fixed display of additional fields when editing and executing a task
* Fixed calendar time selection link when adding/editing a task
* Fixed endpoint display in the ''(in some cases)'' switching scheme tooltip
* Fixed filter by address ''(in some cases)''
* Fixed bug when opening a job card ''(in some cases)''
* Fixed an error when adding a type comment on tasks

== 3.19.8 "Vanadium" - 22.07.2024 ==
* '''In the card of the polygon ''(object on the map)'', the list of communication installations it covers is displayed'''
* '''Added the ability to divide inventory items by multiples ''(not just by piece or in two parts as before)'''''
* '''In the filter for communication installations, added possibility to select by date of installation, additional fields, own icon on the map'''
* The field "Cable metreage" in the customer card has been extended to 5 symbols
* Fixed an error when changing coordinates of a communication installation ''(in some cases)''
* Fixed error in the form of creating/editing a task ''(in some cases)''
* Fixed error when receiving ONU list from OLT ''(in some cases)''

== 3.19.7 "Seaborgium" - 19.07.2024 ==
* '''Added the ability to set the number of incorrect login attempts to use the interval between login attempts ''(password protection)'''''
* '''In the list of communication installations added filter by address location ''(city, street, etc.)'''''
* '''In the history of users’ actions the possibility of filtering by IP-address was added'''
* '''New type of additional field "Time"'''
* Assigned marks are displayed in tooltips on polygons on the map
* When adding inventory items to a transaction, integrated inventory items are automatically added to the transaction as well
* Added method API->task->[[API_task_EN#overview_task|overview_task]]
* Fixed an error when saving the value of an additional field in the object card ''(in some cases)''
* Fixed the ability to specify a depth for a rack greater than 999 mm
* Fixed inaccuracies of context menu for crossover ports on switching scheme ''(in some cases)''
* Fixed correct highlighting of switching to cross/ODF in the switching scheme
* Fixed displaying of values of main additional fields in customer card
* Fixed behaviour rules in additional fields ''(in some cases)''
* Fixed sorting in ONU list by OLT when switching list pages
* Fixed editing of notes containing inverted commas in the cable line card

== 3.19.6 "Rubidium" - 10.07.2024 ==
* Fixed filtering by additional status in task list ''(in some cases)''
* Fixed display of the switching point column for the customer list ''(in some cases)''
* Fixed display of additional fields when editing a customer card ''(in some cases)''
* Fixed additional field conditions ''(in some cases)''
* Fixed equipment import bug ''(in some cases)''
* Fixed mass incorrect deletion of switching for crosses/ODFs
* Fixed cable route creation from coverage map
* Fixed rounding of cable trace length when creating it
* Corrections in English localisation

== 3.19.5 "Manganese" - 29.06.2024 ==
* Fixed bug when viewing the transport card ''(in some cases)''
* Fixed bug when unable to delete a communication installation ''(in some cases)''
* Fixed bug when viewing the list of all tasks by customer ''(in some cases)''
* Fixed global search by cross/ODFs
* Fixed error when opening the main page ''(in some cases)''
* Fixed bug when splitting a cable line ''(in some cases)''
* Fixed bug when editing a cable in the cable catalogue

== 3.19.4 "Potassium" - 23.06.2024 ==
* Added method API->map->[[API map EN#map_object_facilities_inside|map_object_facilities_inside]]
* Improved dragging and dropping of objects on the switching scheme for mobile devices
* Fixed a bug in the main page widget "MAC address flood on switch ports" ''(in some cases)''
* Fixed bug when trying to create a task from under a customer card without an address
* Fixed an error when editing a device ''(in some cases)''
* Fixed the ability to change the direction of cable line entry on the building switching scheme
* Fixed display of cable lines on customer's switching scheme
* Fixed ability to edit the route of cable channels route
* Fixed an error when trying to install a cross-connector/ODF in a cabinet/rack ''(in some cases)''

== 3.19.3 "Tantalum" - 20.06.2024 ==
* Added method API->map->[[API map EN#map_object_mark_add|map_object_mark_add]]
* Added method API->map->[[API map EN#map_object_mark_delete|map_object_mark_delete]]
* Fixed group generation of QR codes for inventory items
* Fixed bug when transferring inventory items to a customer ''(in some cases)''
* Fixed error when editing ONU card ''(in some cases)''
* Fixed an error when trying to specify an arbitrary stock on the card for a cable line
* Fixed error when opening switch card ''(in some cases)''
* Fixed transition of links in the map by cable traces

== 3.19.2 "Scandium" - 16.06.2024 ==
* Fixed an error when viewing tasks for all employees in the work calendar
* Fixed transition to the inventory card from under the warehouse operations card
* Fixed error when opening equipment card ''(in some cases)''
* Fixed bug in scheduler task "Transfer information about connected potential clients to current clients" ''(in some cases)''
* Fixed an error in capturing data on ONU distances by OLT ''(in some cases)''
* Fixed bug when displaying vehicle tooltip on coverage map ''(in some cases)''
* Fixed displaying of alarm list by usm_observer module

== 3.19.1 "Magnesium" - 14.06.2024 ==
* Improved API->task->[[API task EN#get_catalog_state|get_catalog_state]] method
* Fixed an error in displaying the commutation scheme ''(in some cases)''
* Fixed bug when viewing a task card ''(in some cases)''
* Fixed ability to edit additional fields for communication installations
* Fixed error when viewing the equipment card ''(in some cases)''
* Fixed displaying of cable line switching in the switching diagram if it starts and ends in one communication installation
* Fixed editing of building coordinates from coverage map context menu
* Fixed some migration errors
* Fixed errors during equipment polling ''(in some cases)''
* Fixed errors when polling ONU list by OLT
* Fixed "On map, open links to houses/nodes and other objects in a separate tab/window" setting for the map
* Fixed display of localised characters in the description in the task card
* Fixed display of the list of categories by warehouse in the "Inventory" section ''(in some cases)''

== 3.19 "Oxygen" - 03.06.2024 ==
* Release of version 3.19
* Cumulative fixes and changes

== 3.19rc1 - 18.05.2024 ==
* Corrections based on the results of beta testing
* Optimisation and cumulative bug fixes for version 3.18

== 3.19beta2 - 04.05.2024 ==
* Corrections based on the results of beta testing
* Optimisation and cumulative bug fixes for version 3.18

== 3.19beta1 - 10.04.2024 ==
* For a list of changes, see [[3.19_EN|3.19]]

API employee UK

2026-11-12T09:38:40Z

IronBot: [IronBot] Sync UK localization from RU

[[API_employee_EN|en]] | '''uk''' | [[API employee|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Співробітники

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add_history ====

''Додано у: 3.21.72''

Опис: Додавання запису до історії дій співробітника
Обов'язкові параметри:
date_add - дата події
type_id - ID типу дій
Необов'язкові параметри:
employee_id - ID співробітника
object_id - ID пов'язаного об'єкта
object_name - назва пов'язаного об'єкта
description - нотатки

==== add_notification ====

''Додано у: 3.18beta1''

Опис: Створення PUSH-повідомлення для співробітника
Обов'язкові параметри:
employee_id - ID співробітника
body - текст
Необов'язкові параметри:
color - HTML-колір вікна з повідомленням

==== address_access_add ====

''Додано у: 3.18beta1''

Опис: Додавання адресного об'єкта до доступних адрес для співробітника
Обов'язкові параметри:
employee_id - id співробітника
address_id - id адресного об'єкта ''(-1 для всіх адрес, -2 для об'єктів без адреси)''
is_write - прапорець - доступ на запис

==== address_access_list ====

''Додано у: 3.18beta1''

Опис: Список доступних адресних об'єктів для співробітника
Обов'язкові параметри:
employee_id - id співробітника
is_write - прапорець - доступ на запис

==== address_access_remove ====

''Додано у: 3.18beta1''

Опис: Видалення адресного об'єкта з доступних адрес для співробітника
Обов'язкові параметри:
employee_id - id співробітника
address_id - id адресного об'єкта ''(-1 для всіх адрес, -2 для об'єктів без адреси)''

==== check_pass ====
''Додано у: 3.16dev2''
Опис: Перевірка збігу логіна і пароля для входу в UserSide
Обов'язкові параметри:
login - логін
pass - пароль

З версії 3.16.28 після успішної автентифікації оновлюється дата активності співробітника

==== division_employee_add ====
''Додано у: 3.19.44''
Опис: Призначення співробітника до підрозділу
Обов'язкові параметри:
division_id - ID підрозділу
employee_id - ID співробітника
Необов'язкові параметри:
position_type - тип посади [head|deputy|worker]
position_name - посада в підрозділі
date_add - дата призначення

==== division_employee_remove ====
''Додано у: 3.19.44''
Опис: Вилучення співробітника з підрозділу
Обов'язкові параметри:
division_id - ID підрозділу
employee_id - ID співробітника
Необов'язкові параметри:
date_remove - дата вилучення

==== edit ====

''Доопрацьовано у: 3.21.79 (додано параметр messenger_service_name)''

''Доопрацьовано у: 3.19.40 (додано параметр ip_phone)''

''Доопрацьовано у: 3.19.33 (додано параметр is_blocked)''

''Додано у: 3.18beta1''

Опис: Редагування запису про співробітника
Обов'язкові параметри:
id - id співробітника
Необов'язкові параметри:
date_birthday - дата народження
date_in - дата прийняття на роботу
date_out - дата звільнення
first_name - ім'я
gps_id - IMEI gps-треккера
ip_phone - номер IP-телефона
is_blocked - прапорець - заблокувати/розблокувати обліковий запис
middle_name - по батькові
last_name - прізвище
position - посада
short_name - скорочене ім'я/прізвище
messenger_service_name - messenger service_name
messenger_chat_id - messenger chat_id

==== get_data ====
''Додано з: 3.16dev2''
Опис: Отримання інформації про співробітника
Необов'язкові параметри:
id - id співробітника для вибірки ''(можна через кому)''

==== get_division ====
''Додано у: 3.16dev2''
Опис: Отримання інформації про підрозділ
Необов'язкові параметри:
id - ID підрозділу ''(можна через кому)''

==== get_division_list ====
''Додано у: 3.16dev2''
Опис: Список підрозділів

==== get_employee_id ====
''Доопрацьовано у: 3.18.7 (до параметра data_typer додано можливе значення messenger_chat_id)''

''Додано з: 3.16dev2''

Опис: Отримання ID співробітника за вхідними даними
Обов'язкові параметри:
data_typer - тип даних, які перевіряємо ''(можливі значення: additional_field_XXX, name, login, messenger_chat_id)''
data_value - значення

==== get_history ====
''Доопрацьовано у: 3.16dev6 (додано параметр object_id)''

''Додано у: 3.16dev2''
Опис: Історія дій ''(ліміт 10000 записів у результатах вибірки)''
Обов'язкові параметри:
date_from - дата початку вибірки ''(з)''
date_to - дата закінчення вибірки ''(до)''
Необов'язкові параметри:
employee_id - id співробітника ''(можна через кому)''
type_id - id типу дій ''(можна через кому)''
object_id - id пов'язаного об'єкта ''(можна через кому)''

==== get_history_type ====
''Додано у: 3.16dev2''
Опис: Типи дій в історії
Необов'язкові параметри:
id - id типу дій

==== get_timesheet_data ====
''Додано у: 3.16dev2''
Опис: Отримання інформації з табеля робіт
Обов'язкові параметри:
date_from - дата початку вибірки
date_to - дата закінчення вибірки
Необов'язкові параметри:
employee_id - id співробітника ''(можна через кому)''
division_id - id підрозділу ''(можна через кому)''

==== get_work_time_data ====
''Додано у: 3.17dev1''
Опис: Отримання інформації про робочий час співробітників
Обов'язкові параметри:
date_from - дата початку вибірки
date_to - дата закінчення вибірки
Необов'язкові параметри:
employee_id - id співробітника ''(можна через кому)''

==== get_unavailable_data ====
''Додано у: 3.18beta1''

Опис: Отримання інформації про недоступність співробітника ''(відпустка, лікарняний)''
Обов'язкові параметри:
немає
Необов'язкові параметри:
employee_id - id співробітника
date_from - дата початку періоду
date_to - дата закінчення періоду

==== set_timesheet_data ====
''Доопрацьовано у: 3.17dev1 (змінено логіку параметра value)''

''Додано у: 3.16dev2''

Опис: Додавання/зміна/видалення запису в табель робіт
Обов'язкові параметри:
employee_id - id співробітника
date - дата
type_id - id типу запису ''(1 - основний час, 2 - понаднормовий час, 3 - інше)''
value - кількість годин ''(після 3.17dev1: кількість годин або текстова літера для позначення неробочого періоду, або порожнє значення для видалення запису; до 3.17dev1: ціле значення, або: 994 - черговий, 995 - не вийшов, 996 - відпустка, 997 - вихідний, 998 - лікарняний, 999 - відрядження, або 0 для видалення запису)''

==== set_unavailable_data ====
''Додано у: 3.17dev1''

Опис: Додавання/зміна/видалення запису про недоступність співробітника ''(відпустка, лікарняний)''
Обов'язкові параметри:
employee_id - ID співробітника
date_from - дата початку періоду
date_to - дата закінчення періоду
Необов'язкові параметри:
type_id - id типу запису ''(1 - відпустка, 2 - лікарняний, не заповнено - видалити запис)''

==== task_address_access_add ====

''Додано у: 3.18beta1''

Опис: Додавання адресного об'єкта до списку адрес, куди співробітника можна призначити на роботи
Обов'язкові параметри:
employee_id - id співробітника
address_id - id адресного об'єкта ''(-1 для всіх адрес, -2 для об'єктів без адреси)''

==== task_address_access_list ====

''Додано у: 3.18beta1''

Опис: Список адрес, куди співробітника можна призначити на роботи
Обов'язкові параметри:
employee_id - id співробітника

==== task_address_access_remove ====

''Додано у: 3.18beta1''

Опис: Видалення адресного об'єкта зі списку адрес, куди співробітника можна призначити на роботи
Обов'язкові параметри:
employee_id - id співробітника
address_id - id адресного об'єкта ''(-1 для всіх адрес, -2 для об'єктів без адреси)''

==== work_time_finish ====
''Додано у: 3.16dev5''
Опис: Фіксація моменту закінчення робочого часу співробітника
Обов'язкові параметри:
employee_id - id співробітника
date - дата і час
Необов'язкові параметри:
comment - нотатки

==== work_time_start ====
''Додано у: 3.16dev5''
Опис: Фіксація моменту початку робочого часу співробітника
Обов'язкові параметри:
employee_id - id співробітника
date - дата і час
Необов'язкові параметри:
comment - нотатки

API employee EN

2026-11-12T09:38:27Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_employee_UK|uk]] | [[API employee|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Employees

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add_history ====

''Added in: 3.21.72''

Description: Add an entry to an employee's action history
Required parameters:
date_add - event date
type_id - action type ID
Optional parameters:
employee_id - employee ID
object_id - related object ID
object_name - related object name
description - notes

==== add_notification ====

''Added in: 3.18beta1''

Description: Create a PUSH notification for an employee
Required parameters:
employee_id - employee ID
body - text
Optional parameters:
color - HTML color of the notification window

==== address_access_add ====

''Added in: 3.18beta1''

Description: Add an address object to the available addresses for an employee
Required parameters:
employee_id - id of the employee
address_id - address object id ''(-1 for all addresses, -2 for objects without an address)''
is_write - flag - write access

==== address_access_list ====

''Added in: 3.18beta1''

Description: List of available address objects for an employee
Required parameters:
employee_id - employee id
is_write - flag - write access

==== address_access_remove ====

''Added in: 3.18beta1''

Description: Remove an address object from the available addresses for an employee
Required parameters:
employee_id - id of the employee
address_id - address object id ''(-1 for all addresses, -2 for objects without an address)''

==== check_pass ====
''Added to: 3.16dev2''
Description: Check whether the login and password match for UserSide authentication
Required parameters:
login - login
pass - password

Since version 3.16.28, the employee's activity date is updated upon successful authentication

==== edit ====

''Updated in: 3.21.79 (added messenger_service_name parameter)''

''Modified in: 3.19.40 (added ip_phone parameter)''

''Modified in: 3.19.33 (added is_blocked parameter)''

''Added in: 3.18beta1''

Description: Edit employee record
Required parameters:
id - id of the employee
Optional parameters:
date_birthday - date of birth
date_in - date of employment
date_out - date of resignation
first_name - name
gps_id - GPS tracker IMEI
ip_phone - IP phone number
is_blocked - flag - block/unblock the account
middle_name - middle name
last_name - surname
position - position
short_name - short name/surname
messenger_service_name - messenger service_name
messenger_chat_id - messenger chat_id

==== get_data ====
''Added in: 3.16dev2''
Description: Retrieve information about an employee
Optional parameters:
id - id of the employee to sample ''(can be comma separated)''

==== get_division ====
''Added in: 3.16dev2''
Description: Retrieve division information
Optional parameters:
id - division ID ''(can be comma separated)''

==== get_division_list ====
''Added in: 3.16dev2''
Description: List of divisions

==== get_employee_id ====
''Modified in: 3.18.7 (added possible messenger_chat_id value to data_typer parameter)''

''Added in: 3.16dev2''

Description: Retrieve employee ID from input data
Required parameters:
data_typer - type of data we are checking ''(possible values: additional_field_XXX, name, login, messenger_chat_id)''
data_value - value

==== get_history ====
''Modified in: 3.16dev6 (added object_id parameter)''

''Added in: 3.16dev2''
Description: Action history ''(limit 10000 records in the sample results)''
Required parameters:
date_from - sampling start date ''(from)''
date_to - sampling end date ''(to)''
Optional parameters:
employee_id - employee id ''(can be comma separated)''
type_id - id of action type ''(can be comma separated)''
object_id - id of related object ''(can be comma separated)''

==== get_history_type ====
''Added in: 3.16dev2''
Description: History action types
Optional parameters:
id - id of action type

==== get_timesheet_data ====
''Added in: 3.16dev2''
Description: Retrieve information from timesheets
Required parameters:
date_from - start date of sampling
date_to - sampling end date
Optional parameters:
employee_id - employee id ''(can be comma separated)''
division_id - division id ''(can be comma separated)''

==== get_work_time_data ====
''Added in: 3.17dev1''
Description: Retrieve employee working time information
Required parameters:
date_from - start date of sampling
date_to - date of sampling end
Optional parameters:
employee_id - employee id ''(can be comma separated)''

==== get_unavailable_data ====
''Added in: 3.18beta1''

Description: Retrieve employee unavailability information ''(holiday, sick leave)''
Required parameters:
None
Optional parameters:
employee_id - employee id
date_from - period start date
date_to - end date of the period

==== set_timesheet_data ====
''Modified in: 3.17dev1 (changed value parameter logic)''

''Added in: 3.16dev2''

Description: Add/modify/delete an entry in the timesheet
Required parameters:
employee_id - employee id
date - date
type_id - id of record type ''(1 - basic time, 2 - overtime, 3 - other)''
value - number of hours ''(after 3.17dev1: number of hours or text letter to mark non-working period, or empty value to delete the record; before 3.17dev1: integer value, or: 994 - on duty, 995 - off duty, 996 - holiday, 997 - day off, 998 - sick leave, 999 - business trip, or 0 to delete the record)''

==== set_unavailable_data ====
''Added in: 3.17dev1''

Description: Add/modify/delete employee unavailability record ''(holiday, sick leave)''
Required parameters:
employee_id - employee ID
date_from - period start date
date_to - period end date
Optional parameters:
type_id - record type id ''(1 - holiday, 2 - sick leave, not filled - delete record)''

==== task_address_access_add ====

''Added in: 3.18beta1''

Description: Add an address object to the list of addresses where an employee can be assigned to work
Required parameters:
employee_id - id of employee
address_id - address object id ''(-1 for all addresses, -2 for objects without an address)''

==== task_address_access_list ====

''Added in: 3.18beta1''

Description: List of addresses where an employee can be assigned to jobs
Required parameters:
employee_id - employee id

==== task_address_access_remove ====

''Added in: 3.18beta1''

Description: Remove an address object from the list of addresses where an employee can be assigned to work
Required parameters:
employee_id - id of employee
address_id - address object id ''(-1 for all addresses, -2 for objects without an address)''

==== work_time_finish ====
''Added to: 3.16dev5''
Description: Record the end of an employee's working time
Required parameters:
employee_id - employee id
date - date and time
Optional parameters:
comment - notes

==== work_time_start ====
''Added to: 3.16dev5''
Description: Record the start of an employee's working time
Required parameters:
employee_id - employee id
date - date and time
Optional parameters:
comment - notes

==== division_employee_add ====
''Added in: 3.19.44''
Description: Assign an employee to a division
Required parameters:
division_id - division ID
employee_id - employee ID
Optional parameters:
position_type - position type [head|deputy|worker]
position_name - position in the division
date_add - assignment date

==== division_employee_remove ====
''Added in: 3.19.44''
Description: Remove an employee from a division
Required parameters:
division_id - division ID
employee_id - employee ID
Optional parameters:
date_remove - removal date

API task UK

2026-11-12T09:38:25Z

IronBot: [IronBot] Sync UK localization from RU

[[API_task_EN|en]] | '''uk''' | [[API task|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Робота із завданнями

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====
''Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)''

''Доопрацьовано у: 3.18.43 (додано параметр device_id)''

''Доопрацьовано у: 3.18.29 (додано параметр deadline_hour)''

''Доопрацьовано у: 3.17dev1 (виключено параметри usercode, uzelcode і додано параметри customer_id, node_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметри unit_id, author_operator_id і додано параметри employee_id, author_employee_id)''

''Доопрацьовано у: 3.12.84 (додано параметр parent_task_id)''

''Доопрацьовано у: 3.12.38 (додано параметри unit_id, division_id)''

''Доопрацьовано у: 3.12.26 (додано параметр work_amount)''

''Доопрацьовано у: 3.12beta31 (додано параметр author_operator_id)''

Опис: Створення завдання

Обов'язкові параметри:
work_typer - ID типу завдання

Необов'язкові параметри:
apart - номер квартири
address_id - ''(для версії 3.13 і пізніше)'' id адресної одиниці
author_employee_id - ID співробітника-автора завдання
author_operator_id - ID оператора-автора завдання ''(до версії 3.16dev2)''
citycode - ''(для версії 3.12 і раніше)'' id населеного пункту. Якщо не вказано, то береться з даних за будинком housecode
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)''
device_id - ID обладнання
division_id - ID підрозділу ''(допускається кілька значень через кому)''
dopf_N - значення додаткового поля для поля ID N
employee_id - ID виконавця ''(допускається кілька значень через кому)''
fio - ПІБ клієнта ''(мається на увазі, що "клієнт" ще не є абонентом)''
housecode - ''(для версії 3.12 і раніше)'' id будівлі. Якщо не вказано, то береться з даних за абонентом - customer_id, або з даних за об'єктом інфраструктури - node_id
is_high_priority - прапорець - високий пріоритет
node_id - ''(для версії 3.17 і пізніше)'' ID об'єкта інфраструктури
opis - нотатки до завдання
parent_task_id - ID батьківського завдання
unit_id - ID виконавця ''(допускається кілька значень через кому) (до версії 3.16dev2)''
usercode - ''(для версії 3.16 і раніше)'' ID абонента
uzelcode - ''(для версії 3.16 і раніше)'' ID об'єкта інфраструктури
work_amount - обсяг робіт
work_datedo - дата, на яку призначено виконання завдання

==== add_cable_line_to_task ====
''Додано у: 3.20.2''

Опис: Додавання кабельної лінії до завдання

Обов'язкові параметри:
task_id - id завдання
cable_line_id - id кабельної лінії

==== add_customer_to_task ====
''Додано у: 3.13.70''

Опис: Додавання абонента до завдання

Обов'язкові параметри:
task_id - id завдання
customer_id - id абонента

==== add_device_to_task ====
''Додано у: 3.19beta1''

Опис: Додавання обладнання до завдання

Обов'язкові параметри:
task_id - id завдання
device_id - id обладнання

==== add_node_to_task ====
''Додано у: 3.20.17''

Опис: Додавання об'єкта інфраструктури до завдання

Обов'язкові параметри:
task_id - id завдання
node_id - id об'єкта інфраструктури

==== add_owner_to_task ====
''Додано у: 3.19.19''

Опис: Додавання власника до завдання

Обов'язкові параметри:
task_id - id завдання
owner_id - id власника

==== change_date_work ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.12.83''

Опис: Зміна дати і часу виконання завдання ''(дата, на яку призначені роботи)''

Обов'язкові параметри:
id - id завдання
value - дата
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== change_state ====
''Оновлено у версії 3.21.61 (додано параметр is_ignore_required_comment)''

''Оновлено у версії 3.21.56 (додано параметр comment)''

''Доопрацьовано у: 3.20.3 (додано параметр date_hold)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

Опис: Зміна стану (статусу) завдання

Обов'язкові параметри:
id - id завдання
state_id - id стану завдання
Необов'язкові параметри:
employee_id - id співробітника, від імені якого змінювати стан
operator_id - id оператора, від імені якого змінювати стан ''(до версії 3.16dev2)''
comment - коментар ''(обов'язковий, якщо в налаштуваннях статусу ввімкнено параметр «Потрібно вказати коментар»)''
date_hold - дата/час, до якої відкласти завдання ''(під час переведення у статус з роллю "Відкладено")''
is_ignore_required_comment - прапорець: не перевіряти обов'язковість коментаря

==== check_verify_code ====
Опис: Перевірка коду підтвердження для виконання заявки

Обов'язкові параметри:
id - ID завдання
verify_code - код підтвердження

==== checklist_item_add ====
''Додано у: 3.21.71''

Опис: Додавання пункту чекліста до завдання

Обов'язкові параметри:
task_id - ID завдання
body - текст
Необов'язкові параметри:
position - позиція пункту чекліста

==== checklist_item_check ====
''Додано у: 3.17dev1''

Опис: Позначення пункту чек-листа в завданні

Обов'язкові параметри:
id - id пункту чек-листа
task_id - id завдання
employee_id - id співробітника, від імені якого позначається пункт

==== checklist_item_uncheck ====
''Додано у: 3.17dev1''

Опис: Зняття позначення з пункту чек-листа в завданні

Обов'язкові параметри:
id - id пункту чек-листа
task_id - id завдання

==== comment_add ====
''Доопрацьовано у: 3.17dev1 (додано параметр dateadd)''

''Доопрацьовано у: 3.16.19 (додано параметр reply_comment_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.12.89 (додано параметр author_operator_id)''

Опис: Додавання коментаря

Обов'язкові параметри:
id - ID завдання
comment - текст
Необов'язкові параметри:
dateadd - дата й час коментаря
employee_id - id співробітника, від імені якого додається коментар
operator_id - id оператора, від імені якого додається коментар ''(до версії 3.16dev2)''
reply_comment_id - id коментаря, на який відповідаємо

==== comment_edit ====

''Додано у: 3.18beta1''

Опис: Зміна коментаря

Обов'язкові параметри:
id - ID коментаря
task_id - ID завдання
body - текст

==== delete ====
''Додано у: 3.14.35''

Опис: Видалення завдання

Обов'язкові параметри:
id - id завдання

==== division_add ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.13.36''

Опис: Додавання підрозділу

Обов'язкові параметри:
id - id завдання
division_id - id підрозділу
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== division_delete ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.13.36''

Опис: Вилучення підрозділу

Обов'язкові параметри:
id - id завдання
division_id - id підрозділу
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== edit ====

''Доопрацьовано у: 3.20.23 (додано параметр customer_name)''

''Доопрацьовано у: 3.19.41 (додано параметр author_employee_id)''

''Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)''

''Доопрацьовано у: 3.19.15 (додано параметр job_time_hour)''

''Доопрацьовано у: 3.19.12 (додано параметр apartment)''

''Доопрацьовано у: 3.18.30 (додано параметр deadline_hour)''

''Доопрацьовано у: 3.18beta1 (додано параметр address_id)''

''Доопрацьовано у: 3.16dev3 (додано параметр type_id)''

''Доопрацьовано у: 3.15.12 (додано параметр parent_task_id)''

''Додано у: 3.13.18''
Опис: Зміна завдання

Обов'язкові параметри:
id - id завдання
Необов'язкові параметри:
address_id - id адресної одиниці
apartment - номер квартири
author_employee_id - id співробітника - автора завдання
customer_name - довільне ім'я/назва клієнта ''(без прив'язки до абонента)''
body - текст завдання ''(описова частина)''
deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)''
is_high_priority - прапорець - високий пріоритет
job_time_hour - час на виконання завдання ''(з дати початку робіт. У годинах)''
parent_task_id - id батьківського завдання
type_id - id типу завдання

==== employee_add ====
''Додано у: 3.16dev2''
Опис: Додавання виконавця

Обов'язкові параметри:
id - id завдання
employee_id - id виконавця
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''

==== employee_delete ====
''Додано у: 3.16dev2''
Опис: Вилучення виконавця

Обов'язкові параметри:
id - id завдання
employee_id - id виконавця
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''

==== get_allow_staff ====
''Додано у: 3.15.23''
Опис: Список виконавців і підрозділів, які доступні для призначення на завдання ''(згідно з налаштуваннями)''

Обов'язкові параметри:
id - id завдання

==== get_catalog_type ====
''Додано у: 3.12.22''
Опис: Типи завдань

Необов'язкові параметри:
id - id типу завдань ''(можна через кому)''

==== get_catalog_type_group ====
''Додано у: 3.16dev3''
Опис: Групи типів завдань

==== get_catalog_state ====
''Доопрацьовано у: 3.19.1 (додано параметр type_id)''

''Додано у: 3.12.22''

Опис: Класифікатор станів завдань

Необов'язкові параметри:
type_id - id типу завдання
state_id - id стану ''(можна через кому)''

==== get_comment ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.14.67 (додано параметр id)''

''Доопрацьовано у: 3.14.53 (додано параметр operator_id)''

''Доопрацьовано у: 3.13.50 (додано параметри date_add_from і date_add_to)''

''Додано у: 3.12.75''
Опис: Коментарі

Необов'язкові параметри ''(але має бути хоча б один)'':
id - id коментаря ''(можна через кому)''
task_id - id завдання ''(можна через кому)''
date_add_from - дата додавання коментаря ''(з)''
date_add_to - дата додавання коментаря ''(до)''
employee_id - id співробітника-автора коментаря
operator_id - id оператора-автора коментаря ''(до версії 3.16dev2)''

==== get_list ====

''Доопрацьовано у: 3.18.43 (додано параметр device_id)''

''Доопрацьовано у: 3.18.40 (додано параметр apart)''

''Доопрацьовано у: 3.18.30 (додано параметри change_operation_type, change_employee_id)''

''Доопрацьовано у: 3.18beta1 (додано параметр address_id)''

''Доопрацьовано у: 3.16dev3 (додано параметри task_position, task_position_radius, з параметра order_by виключені можливі значення customer_id і house_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметри closer_operator_id, staff_id, author_id, watcher_id додано параметри closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''

''Доопрацьовано у: 3.15.23 (додано параметр is_expired)''

''Доопрацьовано у: 3.14.71 (додано параметр node_id)''

''Доопрацьовано у: 3.14.62 (додано параметр closer_operator_id)''

''Доопрацьовано у: 3.14.56 (додано параметр division_id_with_staff)''

''Доопрацьовано у: 3.14.41 (до параметра staff_id додано можливе значення -1)''

''Доопрацьовано у: 3.13.29 (додано параметри date_change_from, date_change_to)''

''Доопрацьовано у: 3.13.28 (до параметра order_by додано варіант date_change)''

''Доопрацьовано у: 3.12.91 (додано параметр watcher_id)''

''Доопрацьовано у: 3.12.83 (додано параметр author_id)''

''Доопрацьовано у: 3.12.78 (додано параметри order_by, limit, offset)''

''Доопрацьовано у: 3.12.62 (додано параметр customer_id)''

''Доопрацьовано у: 3.12.24 (додано параметри date_do_from, date_do_to)''

''Доопрацьовано у: 3.12beta29 (додано параметр house_id)''
Опис: Список завдань (ідентифікатори)

Необов'язкові параметри (умови вибірки):
address_id - ID адресного об'єкта ''(можна через кому)''
apart - номер квартири/приміщення
author_id - ID оператора - автора завдання ''(можна через кому) (до версії 3.16dev2)''
author_employee_id - ID співробітника - автора завдання ''(можна через кому)''
change_employee_id - ID співробітника - автора змін за завданням
change_operation_type - тип дій зі зміни завдання ''(можливі значення: add_comment, change_state)''
closer_employee_id - ID співробітника, який закрив ''(виконав)'' завдання ''(можна через кому)''
closer_operator_id - ID оператора, який закрив ''(виконав)'' завдання ''(можна через кому) (до версії 3.16dev2)''
customer_id - ID абонента ''(можна через кому)''
date_add_from - дата створення завдання (з)
date_add_to - дата створення завдання (до)
date_change_from - дата оновлення завдання (з)
date_change_to - дата оновлення завдання (до)
date_do_from - дата, на яку призначено виконання завдання (з)
date_do_to - дата, на яку призначено виконання завдання (до)
date_finish_from - дата виконання завдання (з)
date_finish_to - дата виконання завдання (до)
device_id - ID обладнання ''(можна через кому)''
division_id - ID підрозділу ''(можна через кому)''
division_id_with_staff - ID підрозділу ''(зокрема із завданнями співробітників цього підрозділу) (можна через кому)''
employee_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців)''
house_id - ID будинку робіт
is_expired - прапорець - виводити тільки прострочені завдання
node_id - ID об'єкта розміщення
staff_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців) (до версії 3.16dev2)''
state_id - ID статусу завдань ''(можна через кому)''
task_position - координати завдання ''(там, де це можливо. У форматі lat,lng. Напр: 40.245218,52.333384)''
task_position_radius - радіус від task_position ''(у метрах)''
type_id - ID типу завдань ''(можна через кому)''
watcher_id - ID оператора-спостерігача за завданням ''(можна через кому) (до версії 3.16dev2)''
watcher_employee_id - ID співробітника-спостерігача за завданням ''(можна через кому)''
order_by - поле для сортування ''(можливі варіанти: date_add, date_change, date_do, date_finish, state_id, type_id)''
limit - ліміт вибірки записів
offset - зміщення вибірки

==== get_related_task_id====
Опис: Список пов'язаних завдань із поточним завданням (ідентифікатори)

Обов'язкові параметри:
id - ID завдання

==== get_typical_comments ====
''Додано у: 3.14.70''

Опис: Отримання списку типових коментарів

==== get_work ====
''Додано у: 3.21.79''
Опис: Каталог складених робіт

Необов'язкові параметри:
id - ID роботи ''(можна через кому)''

==== get_work_group ====
''Додано у: 3.21.79''
Опис: Групи складених робіт

==== mark_add ====
''Додано у: 3.19.24''
Опис: Додавання мітки на завдання
Обов'язкові параметри:
task_id - id завдання
mark_id - id мітки

==== mark_delete ====
''Додано у: 3.19.24''
Опис: Видалення мітки із завдання
Обов'язкові параметри:
task_id - id завдання
mark_id - id мітки

==== overview_task ====
''Додано у: 3.19.7''

Опис: Фіксація факту перегляду завдання співробітником

Обов'язкові параметри:
task_id - id завдання
employee_id - id співробітника

==== remove_cable_line_from_task ====
''Додано у: 3.20.2''

Опис: Вилучення кабельної лінії із завдання

Обов'язкові параметри:
task_id - id завдання
cable_line_id - id кабельної лінії

==== remove_customer_from_task ====
''Додано у: 3.15.23''

Опис: Вилучення абонента із завдання

Обов'язкові параметри:
task_id - id завдання
customer_id - id абонента

==== remove_node_from_task ====
''Додано у: 3.20.17''

Опис: Вилучення об'єкта інфраструктури із завдання

Обов'язкові параметри:
task_id - id завдання
node_id - id об'єкта інфраструктури

==== remove_owner_from_task ====
''Додано у: 3.19.19''

Опис: Вилучення власника із завдання

Обов'язкові параметри:
task_id - id завдання
owner_id - id власника

==== set_rate ====
''Додано у: 3.12.63''
Опис: Вказання індивідуального тарифу ''(для співробітників)'' за завданням

Обов'язкові параметри:
task_id - ID завдання
rate - тариф

==== show ====
''Доопрацьовано у: 3.21.48 (додано параметри is_without_history, is_without_attaches, is_without_task_statuses_history, is_without_views_history)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.13.29 (у параметрі id можна подавати список через кому)''

''Доопрацьовано у: 3.13.25 (додано параметр is_without_comments)''

''Доопрацьовано у: 3.12.64 (додано параметр operator_id)''

Опис: Інформація про завдання

Обов'язкові параметри:
id - id завдання ''(можна через кому)''
Необов'язкові параметри:
employee_id - id співробітника, який переглядає це завдання ''(для фіксації в історії завдання)''
is_without_attaches - прапорець - не виводити прикріплені файли
is_without_comments - прапорець - не виводити коментарі в інформації за завданням
is_without_history - прапорець - не виводити історію дій
is_without_task_statuses_history - прапорець - не виводити історію зміни статусів
is_without_views_history - прапорець - не виводити історію переглядів
operator_id - id оператора, який переглядає це завдання ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== (*) staff_add ====
''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_add|employee_add]])''

''Додано у: 3.12.83''

Опис: Додавання виконавця

Обов'язкові параметри:
id - id завдання
staff_id - id виконавця
Необов'язкові параметри:
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)''

==== (*) staff_delete ====
''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_delete|employee_delete]])''

''Додано у: 3.12.83''

Опис: Вилучення виконавця

Обов'язкові параметри:
id - id завдання
staff_id - id виконавця
Необов'язкові параметри:
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)''

==== watcher_add ====
''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)''

''Додано у: 3.14.21''

Опис: Додавання спостерігача

Обов'язкові параметри:
id - id завдання
employee_id - id спостерігача
staff_id - id спостерігача ''(до версії 3.16dev2)''
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== watcher_delete ====
''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)''

''Додано у: 3.14.21''

Опис: Вилучення спостерігача

Обов'язкові параметри:
id - id завдання
employee_id - id спостерігача
staff_id - id спостерігача ''(до версії 3.16dev2)''
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

API task EN

2026-11-12T09:38:23Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_task_UK|uk]] | [[API task|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Working with tasks

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====
''Updated in: 3.19.30 (added is_high_priority parameter)''

''Updated in: 3.18.43 (added device_id parameter)''

''Modified in: 3.18.29 (added deadline_hour parameter)''

''Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)''

''Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)''

''Modified in: 3.12.84 (added parent_task_id parameter)''

''Modified in: 3.12.38 (added unit_id, division_id parameters)''

''Modified in: 3.12.26 (added work_amount parameter)''

''Modified in: 3.12beta31 (added author_operator_id parameter)''

Description: Task creation

Required parameters:
work_typer - task TYPE ID

Optional parameters:
apart - flat number
address_id - ''(for version 3.13 and later)'' address unit id
author_employee_id - ID of the employee author of the task
author_operator_id - task author operator ID ''(before version 3.16dev2)''
citycode - ''(for version 3.12 and earlier)'' location id. If not specified, it is taken from housecode data.
customer_id - ''(for version 3.17 and later)'' customer ID
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
device_id - equipment ID
division_id - division ID ''(multiple values separated by commas are allowed)''
dopf_N - value of additional field for field ID N
employee_id - employee ID ''(several values separated by commas are allowed)''
fio - client full name ''(the client is not yet a customer)''
housecode - ''(for version 3.12 and earlier)'' building id. If not specified, it is taken from customer data - customer_id, or from infrastructure facility data - node_id
is_high_priority - flag - high priority
node_id - ''(for version 3.17 and later)'' infrastructure facility ID
opis - task notes
parent_task_id - ID of parent task
unit_id - executor ID ''(multiple values separated by commas are allowed) (before version 3.16dev2)''
usercode - ''(for version 3.16 and earlier)'' customer ID
uzelcode - ''(for version 3.16 and earlier)'' infrastructure facility ID
work_amount - scope of work
work_datedo - date on which the task is scheduled to run

==== add_customer_to_task ====
''Added in: 3.13.70''

Description: Add a customer to a task

Required parameters:
task_id - task id
customer_id - id of customer

==== add_device_to_task ====
''Added in: 3.19beta1''

Description: Add equipment to a task

Required parameters:
task_id - task id
device_id - equipment id

==== add_node_to_task ====
''Added in: 3.20.17''

Description: Add an infrastructure facility to a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== change_date_work ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.12.83''

Description: Change the date and time of the task ''(date on which the work is scheduled)''

Required parameters:
id - id of the task
value - date
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== change_state ====
''Updated in: 3.21.61 (added is_ignore_required_comment parameter)''

''Updated in: 3.21.56 (added comment parameter)''

''Updated in: 3.20.3 (added date_hold parameter)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

Description: Change task state (status)

Required parameters:
id - id of the task
state_id - task state id
Optional parameters:
employee_id - id of the employee on whose behalf to change the state
operator_id - id of the operator on whose behalf to change the state ''(before version 3.16dev2)''
comment - comment ''(required when the task status setting "Comment required" is enabled)''
date_hold - date/time until which to postpone the task ''(when moving to a state with the role Postponed)''
is_ignore_required_comment - flag - skip the required comment check

==== check_verify_code ====
Description: Checks the verification code to perform the request

Required parameters:
id - task ID
verify_code - verification code

==== checklist_item_add ====
''Added in: 3.21.71''

Description: Add a checklist item to a task

Required parameters:
task_id - task ID
body - text
Optional parameters:
position - checklist item position

==== checklist_item_check ====
''Added in: 3.17dev1''

Description: Marks a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id
employee_id - id of the employee on whose behalf the item is marked

==== checklist_item_uncheck ====
''Added in: 3.17dev1''

Description: Clear a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id

==== comment_add ====
''Modified in: 3.17dev1 (added dateadd parameter)''

''Modified in: 3.16.19 (added reply_comment_id parameter)''

''Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)''

''Modified in: 3.12.89 (added author_operator_id parameter)''

Description: Add comment

Required parameters:
id - task ID
comment - text
Optional parameters:
dateadd - date-time of the comment
employee_id - id of the employee on whose behalf the comment is made
operator_id - id of the operator on whose behalf the comment is added ''(before version 3.16dev2)''
reply_comment_id - id of the comment we are replying to

==== comment_edit ====

''Added in: 3.18beta1''

Description: Edit comment

Required parameters:
id - comment ID
task_id - task ID
body - text

==== delete ====
''Added in: 3.14.35''

Description: Delete a task

Required parameters:
id - id of the task

==== division_add ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Add a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== division_delete ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Remove a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== edit ====
''Updated in: 3.20.23 (added customer_name parameter)''

''Updated in: 3.19.41 (added author_employee_id parameter)''

''Updated in: 3.19.30 (added is_high_priority parameter)''

''Updated in: 3.19.15 (added job_time_hour parameter)''

''Updated in: 3.19.12 (added apartment parameter)''

''Modified in: 3.18.30 (added deadline_hour parameter)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added type_id parameter)''

''Modified in: 3.15.12 (added parent_task_id parameter)''

''Added in: 3.13.18''
Description: Task modification

Required parameters:
id - task id
Optional parameters:
address_id - id of the address unit
apartment - apartment number
author_employee_id - id of the employee who authored the task
customer_name - arbitrary customer name/title ''(without binding to a customer)''
body - text of the task ''(descriptive part)''
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
is_high_priority - flag - high priority
job_time_hour - time to complete the task ''(from the start of work. In hours)''
parent_task_id - id of parent task
type_id - id of the task type

==== employee_add ====
''Added in: 3.16dev2''
Description: Add an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== employee_delete ====
''Added in: 3.16dev2''
Description: Remove an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== get_allow_staff ====
''Added in: 3.15.23''
Description: List of performers and divisions that are available for assignment to a task ''(according to settings)''

Required parameters:
id - task id

==== get_catalog_type ====
''Added in: 3.12.22''
Description: Task types

Optional parameters:
id - task type id ''(can be comma separated)''

==== get_catalog_type_group ====
''Added in: 3.16dev3''
Description: Task type groups

==== get_catalog_state ====
''Updated in: 3.19.1 (added type_id parameter)''

''Added in: 3.12.22''
Description: Task state classifier

Optional parameters:
type_id - task type id
state_id - state id ''(can be comma separated)''

==== get_comment ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.14.67 (added id parameter)''

''Modified in: 3.14.53 (added operator_id parameter)''

''Modified in: 3.13.50 (added date_add_from and date_add_to parameters)''

''Added in: 3.12.75''
Description: Comments

Optional parameters ''(but there must be at least one)'':
id - id of comment ''(can be comma separated)''
task_id - task id ''(can be comma separated)''
date_add_from - comment creation date ''(from)''
date_add_to - comment creation date ''(to)''
employee_id - id of the employee-author of the comment
operator_id - id of the operator who authored the comment ''(before version 3.16dev2)''

==== get_list ====
''Updated in: 3.18.43 (added device_id parameter)''

''Updated in: 3.18.40 (added apart parameter)''

''Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)''

''Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''

''Modified in: 3.15.23 (added is_expired parameter)''

''Modified in: 3.14.71 (added node_id parameter)''

''Modified in: 3.14.62 (added closer_operator_id parameter)''

''Modified in: 3.14.56 (added division_id_with_staff parameter)''

''Modified in: 3.14.41 (added possible value -1 to staff_id parameter)''

''Modified in: 3.13.29 (added date_change_from, date_change_to parameters)''

''Modified in: 3.13.28 (added date_change to order_by parameter)''

''Modified in: 3.12.91 (added watcher_id parameter)''

''Modified at: 3.12.83 (added author_id parameter)''

''Modified at: 3.12.78 (added order_by, limit, offset parameters)''

''Modified at: 3.12.62 (added customer_id parameter)''

''Modified in: 3.12.24 (added date_do_from, date_do_to parameters)''

''Modified in: 3.12beta29 (added house_id parameter)''
Description: List of tasks (identifiers)

Optional parameters (sampling conditions):
address_id - ID of the address object ''(can be comma separated)''
apart - apartment/premises number
author_id - ID of the operator who authored the task ''(comma separated) (before version 3.16dev2)''
author_employee_id - ID of the employee who authored the task ''(can be comma separated)''
change_employee_id - ID of the employee - author of the task changes
change_operation_type - type of actions to change the task ''(possible values: add_comment, change_state)''
closer_employee_id - ID of the employee who closed ''(completed)'' the task ''(can be comma separated)''
closer_operator_id - ID of the operator who closed ''(completed)'' the task ''(can be comma separated) (before version 3.16dev2)''
customer_id - customer ID ''(can be comma separated)''
date_add_from - task creation date (from)
date_add_to - task creation date (to)
date_change_from - task update date (from)
date_change_to - task update date (to)
date_do_from - date on which the task is scheduled to be executed (from)
date_do_to - date on which the task is scheduled to be executed (to)
date_finish_from - date on which the task is executed (from)
date_finish_to - date on which the task is executed (to)
device_id - equipment ID ''(can be comma separated)''
division_id - division ID ''(can be comma separated)''
division_id_with_staff - division ID ''(including tasks of employees of this division) (can be comma separated)''
employee_id - employee ID ''(can be comma separated, use -1 to get tasks without employees)''
house_id - building ID
is_expired - flag - output only expired tasks
node_id - ID of the location object
staff_id - executor ID ''(can be comma separated, use -1 to get tasks without executors) (before version 3.16dev2)''
state_id - task status ID ''(can be comma separated)''
task_position - task coordinates ''(where possible. In lat,lng format. e.g. 40.245218,52.333384)''
task_position_radius - radius from task_position ''(in meters)''
type_id - task type ID ''(can be comma separated)''
watcher_id - task observer operator ID ''(comma separated) (before version 3.16dev2)''
watcher_employee_id - ID of the task observer employee ''(comma separated)''
order_by - sorting field ''(possible variants: date_add, date_change, date_do, date_finish, state_id, type_id)''
limit - record sampling limit
offset - sampling offset

==== get_related_task_id====
Description: List of related tasks to the current task (identifiers)

Required parameters:
id - task ID

==== get_typical_comments ====
''Added in: 3.14.70''

Description: Get list of typical comments

==== remove_customer_from_task ====
''Added in: 3.15.23''

Description: Remove a customer from a task

Required parameters:
task_id - task id
customer_id - customer id

==== remove_node_from_task ====
''Added in: 3.20.17''

Description: Remove an infrastructure facility from a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== set_rate ====
''Added in: 3.12.63''
Description: Set an individual rate ''(for employees)'' for the task

Required parameters:
task_id - task ID
rate - rate

==== show ====
''Modified in: 3.21.48 (added is_without_history, is_without_attaches, is_without_task_statuses_history, is_without_views_history parameters)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.13.29 (the id parameter can be a comma separated list)''

''Modified in: 3.13.25 (added is_without_comments parameter)''

''Modified in: 3.12.64 (added operator_id parameter)''

Description: Information about the task

Required parameters:
id - task id ''(can be comma separated)''
Optional parameters:
employee_id - id of the employee who is viewing this task ''(to be recorded in the task history)''
is_without_attaches - flag - do not display attached files
is_without_comments - flag - do not display comments in the task information
is_without_history - flag - do not display action history
is_without_task_statuses_history - flag - do not display status-change history
is_without_views_history - flag - do not display view history
operator_id - id of the operator who is viewing this task ''(to be recorded in the task history) (before version 3.16dev2)''

==== (*) staff_add ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_add|employee_add]])''

''Added in: 3.12.83''

Description: Add an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== (*) staff_delete ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_delete|employee_delete]])''

''Added in: 3.12.83''

Description: Remove an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== watcher_add ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Add observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== watcher_delete ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Remove an observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== add_cable_line_to_task ====
''Added in: 3.20.2''

Description: Add a cable line to a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== add_owner_to_task ====
''Added in: 3.19.19''

Description: Add an owner to a task

Required parameters:
task_id - task id
owner_id - owner id

==== get_work ====
''Added in: 3.21.79''
Description: Catalog of composite work items

Optional parameters:
id - work item ID ''(comma separated)''

==== get_work_group ====
''Added in: 3.21.79''
Description: Groups of composite work items

==== mark_add ====
''Added in: 3.19.24''
Description: Add a mark to a task
Required parameters:
task_id - task id
mark_id - mark id

==== mark_delete ====
''Added in: 3.19.24''
Description: Delete a mark from a task
Required parameters:
task_id - task id
mark_id - mark id

==== overview_task ====
''Added in: 3.19.7''

Description: Record that an employee has viewed a task

Required parameters:
task_id - task id
employee_id - employee id

==== remove_cable_line_from_task ====
''Added in: 3.20.2''

Description: Remove a cable line from a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== remove_owner_from_task ====
''Added in: 3.19.19''

Description: Remove an owner from a task

Required parameters:
task_id - task id
owner_id - owner id

API device UK

2026-11-12T09:38:21Z

IronBot: [IronBot] Sync UK localization from RU

[[API_device_EN|en]] | '''uk''' | [[API device|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Обладнання

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add_mark ====

''Змінено у 3.19beta1 (параметр object_type виключено)''

Опис: Додавання мітки
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
mark_id - ID мітки

==== get_connected_ont_information ====
''Додано у: 3.14.13''

Опис: Отримання інформації про підключені ONU до OLT ''(збережена інформація з бази. Пряме опитування не виконується)''
Необов'язкові параметри:
device_id - ID OLT ''(можна через кому)''
level_onu_rx_min - мінімальний вхідний рівень сигналу на ONU ''(вибрати записи з рівнем менше ніж...)''
level_onu_rx_max - максимальний вхідний рівень сигналу на ONU ''(вибрати записи з рівнем вище ніж...)''

==== get_current_ont_data ====

''Додано з: 3.16dev4''

Опис: Отримання деякої поточної інформації про ONU з OLT
Обов'язкові параметри:
id - id пристрою ''(ONU)''

==== get_device_id ====
''Змінено у 3.19beta1 (параметр object_type виключено)''

''Доопрацьовано у: 3.13.63 (в data_typer додано можливе значення serial_number)''

''Доопрацьовано у: 3.12.95 (в data_typer додано можливе значення mac)''
Опис: Отримання ID пристрою за вхідними даними
Обов'язкові параметри:
object_type - тип пристрою [switch] ''(до версії 3.19beta1)''
data_typer - тип даних, які перевіряємо ''(можливі значення: ip, mac, inventory_number, serial_number, additional_field_XXX)''
data_value - значення

==== get_data ====

''Оновлено у версії 3.21.0 (додано параметр mark_id)''
''Доопрацьовано у 3.20.2 (додано параметр is_with_ip)''

''Доопрацьовано у 3.19.15 (додано параметр customer_id)''

''Доопрацьовано у 3.19beta1 (додано параметр dataset)''

''Доопрацьовано у: 3.18.4 (додано параметр is_hide_access_data)''

''Доопрацьовано у: 3.17beta1 (додано параметр node_id)''

''Доопрацьовано у: 3.15.18 (додано object_type=olt)''

''Доопрацьовано у: 3.14.14 (додано параметр is_hide_ifaces_data)''

''Доопрацьовано у: 3.12.38 (додано object_type=all)''
Опис: Отримання інформації про пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch|onu|olt|radio|all]
Необов'язкові параметри:
customer_id - id абонента ''(можна через кому)''
dataset - список полів, які виводити у видачі ''(через кому)''
is_online - прапорець - вибирати тільки активні пристрої ''(1 - активні, -1 - неактивні)''
is_hide_ifaces_data - прапорець - приховувати розгорнуту інформацію за інтерфейсами обладнання
is_hide_access_data - прапорець - приховувати інформацію за параметрами доступу до обладнання
is_with_ip - прапорець - тільки з IP-адресами
node_id - id об'єкта інфраструктури ''(можна через кому)''
mark_id - id мітки ''(можна через кому)''
object_id - id об'єкта для вибірки

==== get_iface_info ====

''Додано з: 3.17dev1''

Опис: Отримання поточної інформації за інтерфейсами ''(безпосередньо з пристрою)''
Обов'язкові параметри:
id - id пристрою

==== get_iface_mac ====
''Змінено у 3.19beta1 (параметр object_type виключено)''

''Додано з: 3.12beta25''

Опис: Список інтерфейсів з MAC-адресами на пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою для вибірки

==== get_mac_list ====

''Змінено у 3.19beta1 (параметр object_type виключено, список object_id зроблено необов'язковим)''

Опис: Отримання списку MAC-адрес, які були знайдені на пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
Необов'язкові параметри:
interface_list - Номер інтерфейсу, за яким виводити список (можна через кому)
object_id - id пристрою для вибірки

==== get_ont_data ====
''Доопрацьовано у: 3.16dev4 (додано параметр device_id)''

''Додано з: 3.12.81''

Опис: Отримання останньої інформації про ONU
Обов'язкові параметри:
id - MAC-адрес або серійний номер ''(id)''
або
device_id - id пристрою ''(ONU)''

==== get_pon_level_history ====
''Доопрацьовано у: 3.16.19 (додано параметр onu_device_id)''

''Доопрацьовано у: 3.16dev4 (додано параметр device_id)''

''Доопрацьовано у: 3.12.60 (додано параметри limit, order_by, is_desc)''

''Додано з: 3.12.53''

Опис: Отримання історії PON-рівнів сигналів за ONU
Обов'язкові параметри:
onu_name - MAC-адреса або серійний номер ONU ''(без розділювачів)''
або
device_id - id пристрою ''(OLT)''
або
onu_device_id - id пристрою ''(ONU)''
Необов'язкові параметри:
limit - обмеження списку даних, що виводяться
order_by - поле сортування даних
is_desc - прапорець - сортування у зворотному порядку

==== get_relation_customers ====
''Оновлено у версії 3.21.60 (додано параметр is_skip_dnlink)''

''Додано у: 3.19.45''

Опис: Отримання інформації про залежних абонентів
Обов'язкові параметри:
device_id - id пристрою
Необов'язкові параметри:
port_start - початковий номер порту
port_finish - кінцевий номер порту
is_skip_dnlink - прапорець: пропускати порти DNLINK

==== hot_change ====

''Додано у: 3.21.79''

Опис: Гаряча заміна пристрою
Обов'язкові параметри:
device_id - ID пристрою
inventory_id - ID ТМЦ
Необов'язкові параметри:
description - нотатки

==== delete_mark ====

''Змінено у 3.19beta1 (параметр object_type виключено)''

Опис: Зняття мітки
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
mark_id - ID мітки

==== read_fdb ====

''Додано з: 3.15.7''
Опис: Читання FDB-таблиці з пристрою ''(може виконуватися тривалий час)''
Обов'язкові параметри:
device_id - id пристрою

==== set_data ====

''Оновлено у версії 3.21.57 (параметр param тепер приймає значення is_auto_learning, is_polling_pon, is_polling_peleng та is_polling_iferr)''

''Змінено у 3.19beta1 (параметр object_type виключено)''

''Доопрацьовано у 3.17dev1 (до параметра param додано можливе значення date_last_activity)''

''Доопрацьовано у 3.14.53 (до параметра param додано можливе значення downlink_port, uplink_port)''

''Доопрацьовано у 3.13.61 (до параметра param додано можливе значення iface_count)''

''Доопрацьовано у 3.12.74 (до параметра param додано можливе значення comment)''
Опис: Зміна інформації про пристрій
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
param - тип параметра для зміни [ip|mac|comment|iface_count|is_auto_learning|is_polling_iferr|is_polling_peleng|is_polling_pon|downlink_port|uplink_port|date_last_activity]
value - дані ''(може бути порожнім)''

==== set_iface_state ====

''Додано з: 3.15beta3''
Опис: Зміна стану інтерфейсу на пристрої
Обов'язкові параметри:
device_id - id пристрою
iface - номер інтерфейсу
state - стан [1|0]

==== find_mac ====
''Додано з: 3.12beta25''
Опис: Пошук MAC-адреси в історії опитування обладнання
Обов'язкові параметри:
mac - MAC-адреса ''(верхній регістр без розділювачів)''

API device EN

2026-11-12T09:38:19Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_device_UK|uk]] | [[API device|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Equipment

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add_mark ====

''Modified in 3.19beta1 (object_type parameter removed)''

Description: Add a mark
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
mark_id - mark ID

==== get_connected_ont_information ====
''Added in: 3.14.13''

Description: Get information about ONUs connected to an OLT ''(stored database information. Direct polling is not performed)''
Optional parameters:
device_id - OLT ID ''(can be comma separated)''
level_onu_rx_min - minimum incoming signal level on ONU ''(select records with level less than...)''
level_onu_rx_max - maximum incoming signal level on ONU ''(select records with level higher than...)''

==== get_current_ont_data ====

''Added with: 3.16dev4''

Description: Get current ONU information ''(directly from OLT)''
Required parameters:
id - device id ''(ONU)''

==== get_device_id ====
''Modified in 3.19beta1 (object_type parameter removed)''

''Modified in: 3.13.63 (added possible serial_number value to data_typer)''

''Modified in: 3.12.95 (added possible mac value to data_typer)''
Description: Retrieve device ID from input data
Required parameters:
object_type - device type [switch] ''(before version 3.19beta1)''
data_typer - type of data to be checked ''(possible values: ip, mac, inventory_number, serial_number, additional_field_XXX)''
data_value - value

==== get_data ====

''Updated in 3.21.0 (added mark_id parameter)''
''Modified in 3.20.2 (added is_with_ip parameter)''

''Modified in 3.19.15 (added customer_id parameter)''

''Modified in 3.19beta1 (added dataset parameter)''

''Modified in: 3.18.4 (added is_hide_access_data parameter)''

''Modified in: 3.17beta1 (added node_id parameter)''

''Modified in: 3.15.18 (added object_type=olt)''

''Modified in: 3.14.14 (added is_hide_ifaces_data parameter)''

''Modified in: 3.12.38 (added object_type=all)''
Description: Retrieve device information
Required parameters:
object_type - Device type [switch|onu|olt|radio|all]
Optional parameters:
customer_id - customer id ''(can be comma separated)''
dataset - list of fields to output ''(comma separated)''
is_online - flag - select only active devices ''(1 - active, -1 - inactive)''
is_hide_ifaces_data - flag - hide detailed information on equipment interfaces
is_hide_access_data - flag - hide information on equipment access parameters
is_with_ip - flag - only with IP addresses
node_id - infrastructure facility id ''(can be comma separated)''
mark_id - mark ID ''(can be comma separated)''
object_id - id of the object to be selected

==== get_iface_info ====

''Added with: 3.17dev1''

Description: Get current interface information ''(directly from the device)''
Required parameters:
id - device id

==== get_iface_mac ====
''Modified in 3.19beta1 (object_type parameter removed)''

''Added with: 3.12beta25''

Description: List of interfaces with MAC addresses on the device
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - id of the device to be sampled

==== get_mac_list ====

''Modified in 3.19beta1 (object_type parameter removed, object_id list made optional)''

Description: Get a list of MAC addresses that were found on the device
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
Optional parameters:
interface_list - Interface number for which to output the list (can be comma separated)
object_id - id of the device to be sampled

==== get_ont_data ====
''Modified in: 3.16dev4 (added device_id parameter)''

''Added from: 3.12.81''

Description: Get the latest information on ONU
Required parameters:
id - MAC address or serial number ''(id)''
or
device_id - device id ''(ONU)''

==== get_pon_level_history ====
''Modified in: 3.16.19 (added onu_device_id parameter)''

''Modified in: 3.16dev4 (added device_id parameter)''

''Modified in: 3.12.60 (added parameters limit, order_by, is_desc)''

''Added from: 3.12.53''

Description: Get PON signal level history for an ONU
Required parameters:
onu_name - MAC address or serial number of ONU ''(without separators)''
or
device_id - device id ''(OLT)''
or
onu_device_id - device id ''(ONU)''
Optional parameters:
limit - output data limit
order_by - data sorting field
is_desc - flag - sorting in reverse order

==== hot_change ====

''Added in: 3.21.79''

Description: Hot-swap a device
Required parameters:
device_id - device ID
inventory_id - inventory item ID
Optional parameters:
description - notes

==== delete_mark ====

''Modified in 3.19beta1 (object_type parameter removed)''

Description: Remove a mark
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
mark_id - mark ID

==== read_fdb ====
''Added in: 3.15.7''
Description: Read FDB-table from device ''(may run for a long time)''
Required parameters:
device_id - device id

==== set_data ====

''Updated in 3.21.57 (param now accepts is_auto_learning, is_polling_pon, is_polling_peleng, and is_polling_iferr)''

''Modified in 3.19beta1 (object_type parameter removed)''

''Modified in 3.17dev1 (added possible value of date_last_activity to param)''

''Modified in 3.14.53 (added possible value of downlink_port, uplink_port to param)''

''Modified in 3.13.61 (added possible value of iface_count to param)''

''Modified in 3.12.74 (added possible value of comment to param)''
Description: Change device information
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
param - type of parameter to change [ip|mac|comment|iface_count|is_auto_learning|is_polling_iferr|is_polling_peleng|is_polling_pon|downlink_port|uplink_port|date_last_activity]
value - data ''(may be empty)''

==== set_iface_state ====

''Added with: 3.15beta3''
Description: Change interface state on a device
Required parameters:
device_id - device id
iface - interface number
state - state [1|0]

==== find_mac ====
''Added in: 3.12beta25''
Description: Search for a MAC address in equipment polling history
Required parameters:
mac - MAC address ''(upper case without separators)''

==== get_relation_customers ====

''Updated in 3.21.60 (added is_skip_dnlink parameter)''

''Added in: 3.19.45''

Description: Retrieve information about dependent customers
Required parameters:
device_id - device id
Optional parameters:
port_start - starting port number
port_finish - ending port number
is_skip_dnlink - flag - skip DNLINK ports

"Гарячі клавіші"

2026-11-12T09:38:18Z

IronBot: [IronBot] Sync UK localization from RU

[["Hot keys"|en]] | '''uk''' | [["Горячие клавиши"|ru]]

Ці сполучення клавіш спрощують роботу із системою:
* "'''Ctrl + LeftClick'''" на волокні або порту обладнання у схемі комутації об'єкта інфраструктури відразу виконує комутацію ''(без натискання додаткового значка комутації)''.
* "'''Ctrl + Z'''" у схемі комутації об'єкта інфраструктури скасовує попередню дію в цій схемі.
* "'''Ctrl + LeftClick'''" на назві типу завдання в картці завдання відкриває налаштування цього типу.
* "'''Ctrl + LeftClick'''" у схемі комутації об'єкта інфраструктури виділяє об'єкт ''(сплітер, крос, обладнання або кабельну лінію)''.
* "'''Ctrl + LeftClick'''" на карті покриття:
** на об'єкті типу «Полігон» відкриває його картку ''(починаючи з версії 3.19.44)''.
* "'''Alt + LeftClick'''" на карті покриття:
** на значку об'єкта інфраструктури відкриває його схему комутації ''(починаючи з версії 3.18)''.
** на полігоні будинку відкриває план цього будинку ''(починаючи з версії 3.19)''.
** на об'єкті типу «Полігон» перемикає до редагування його координат ''(починаючи з версії 3.19.44)''.
* "'''Alt + LeftClick'''" у логічній схемі будинку:
** на значку об'єкта інфраструктури відкриває його схему комутації ''(починаючи з версії 3.21.58)''.

До версії 3.19.1 сполучення з Ctrl + LeftClick не працювали в macOS.

Починаючи з версії 3.19.1, для сполучень із LeftClick у macOS використовуйте Cmd замість Ctrl.

API chapter UK

2026-11-12T09:38:17Z

IronBot: [IronBot] Sync UK localization from RU

[[API_chapter_EN|en]] | '''uk''' | [[API chapter|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Власні розділи/сторінки/посилання

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== link_add ====

''Доопрацьовано у: 3.21.69 (додано параметр is_frame)''

''Доопрацьовано у: 3.21.66 (додано параметр rights_employee_profiles)''

''Додано у: 3.20.23''

Опис: Створення нового посилання
Обов'язкові параметри:
section - розділ для розміщення посилання [header|dashboard|menu]
name - назва
url - посилання
Необов'язкові параметри:
rights_employee_profiles - ID профілів співробітників, яким дозволено доступ до цієї сторінки ''(можна через кому)''
sub_section - підрозділ меню для розміщення посилання ''(для section=menu)'' [accountancy | inventories | employees | customers | tariffs | customer_messages | equipments | tasks | coverage | advertisements | memos | statistics | operators | settings | nodes | cable_lines | transport | chapter]
is_blank - відкривати посилання на новій сторінці
is_frame - відкривати посилання у фреймі

==== link_get ====

''Додано у: 3.20.23''

Опис: Отримання списку посилань
Обов'язкові параметри:
немає
Необов'язкові параметри:
section - розділ для розміщення посилання [header|dashboard|menu]

==== link_remove ====

''Додано у: 3.20.23''

Опис: Видалення посилання
Обов'язкові параметри:
id - id об'єкта

==== page_add ====

''Доопрацьовано у: 3.21.66 (додано параметр rights_employee_profiles)''

''Додано у: 3.21.58''

Опис: Створення нової сторінки
Обов'язкові параметри:
section - місце розміщення сторінки [customer_card|device_card]
name - назва сторінки
Необов'язкові параметри:
rights_employee_profiles - ID профілів співробітників, яким дозволено доступ до цієї сторінки ''(можна через кому)''
sub_section - типи обладнання, для яких показувати сторінку ''(для section=device_card)'' [switch|radio|olt|onu|other] ''(кілька значень розділяйте комами)''
url - посилання
is_blank - відкривати посилання на новій сторінці
is_frame - відкривати посилання у фреймі
body - вміст сторінки

==== page_get ====

''Додано у: 3.21.58''

Опис: Отримання списку сторінок
Обов'язкові параметри:
section - місце розміщення сторінок [customer_card|device_card]

==== page_remove ====

''Додано у: 3.21.58''

Опис: Видалення сторінки
Обов'язкові параметри:
id - id об'єкта

"Hot keys"

2026-11-12T09:38:16Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [["Гарячі клавіші"|uk]] | [["Горячие клавиши"|ru]]

The following keyboard shortcuts make common tasks quicker:
* "'''Ctrl + LeftClick'''" on a fiber or equipment port in a facility's patching diagram connects it immediately ''(without clicking the additional connection icon)''.
* "'''Ctrl + Z'''" in a facility's patching diagram undoes the previous action in that diagram.
* "'''Ctrl + LeftClick'''" on the task type name in a task card opens the settings for that task type.
* "'''Ctrl + LeftClick'''" in a facility's patching diagram selects an object ''(splitter, distribution frame, equipment, or cable line)''.
* "'''Ctrl + LeftClick'''" on the coverage map:
** on an object of type "Polygon" opens its card ''(since version 3.19.44)''.
* "'''Alt + LeftClick'''" on the coverage map:
** on a facility icon opens that facility's patching diagram ''(since version 3.18)''.
** on a building polygon opens the building plan ''(since version 3.19)''.
** on an object of type "Polygon" switches to editing its coordinates ''(since version 3.19.44)''.
* "'''Alt + LeftClick'''" in a building's logical diagram:
** on a facility icon opens that facility's patching diagram ''(since version 3.21.58)''.

Before version 3.19.1, shortcuts using Ctrl + LeftClick did not work on macOS.

Since version 3.19.1, use Cmd instead of Ctrl for shortcuts with LeftClick on macOS.

API chapter EN

2026-11-12T09:38:05Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_chapter_UK|uk]] | [[API chapter|ru]]

Section '''[[API_EN|API_EN]]''' of the "UserSide" ERP

Purpose: Custom sections/pages/links

Additional parameters:
action - request subcategory ''(possible values: see below)''

== Subcategories ==

==== link_add ====

''Updated in: 3.21.69 (added is_frame parameter)''

''Updated in: 3.21.66 (added rights_employee_profiles parameter)''

''Added in: 3.20.23''

Description: Create a new link
Required parameters:
section - section where the link will be placed [header|dashboard|menu]
name - name
url - link
Optional parameters:
rights_employee_profiles - IDs of employee profiles allowed to access this page ''(comma separated)''
sub_section - menu subsection where the link will be placed ''(for section=menu)'' [accountancy | inventories | employees | customers | tariffs | customer_messages | equipments | tasks | coverage | advertisements | memos | statistics | operators | settings | nodes | cable_lines | transport | chapter]
is_blank - open the link in a new page
is_frame - open the link in a frame

==== link_get ====

''Added in: 3.20.23''

Description: Retrieve the list of links
Required parameters:
none
Optional parameters:
section - section where the link is placed [header|dashboard|menu]

==== link_remove ====

''Added in: 3.20.23''

Description: Delete a link
Required parameters:
id - object ID

==== page_add ====

''Updated in: 3.21.66 (added rights_employee_profiles parameter)''

''Added in: 3.21.58''

Description: Create a new page
Required parameters:
section - location for the page [customer_card|device_card]
name - page name
Optional parameters:
rights_employee_profiles - IDs of employee profiles allowed to access this page ''(comma separated)''
sub_section - device types that display the page ''(for section=device_card)'' [switch|radio|olt|onu|other] ''(separate multiple values with commas)''
url - link
is_blank - open the link in a new page
is_frame - open the link in a frame
body - page content

==== page_get ====

''Added in: 3.21.58''

Description: Get a list of pages
Required parameters:
section - location of the pages [customer_card|device_card]

==== page_remove ====

''Added in: 3.21.58''

Description: Delete a page
Required parameters:
id - object ID

FAQ. Збільшення лімітів

2026-11-12T09:38:03Z

IronBot: [IronBot] Sync UK localization from RU

[[FAQ._Increasing_limits|en]] | '''uk''' | [[FAQ. Увеличение лимитов|ru]]

'''Збільшення лімітів'''

* Оплатіть розширення [[Ліміти об'єктів|ліміту об'єктів]] і дочекайтеся підтвердження.
* Запустіть [[Інсталятор|інсталятор]] і виконайте звичайне оновлення до останньої версії. Під час оновлення буде завантажено оновлені файли з новими лімітами.
* Якщо останню версію вже встановлено, виконайте відновлення файлів. Воно повторно завантажить файли цієї версії з новими лімітами. Для відновлення виконайте команду ''(укажіть потрібне ім'я користувача)'':
Для USERSIDE 3.21 та новіших версій виконайте:
sudo -u www-data ./installer repair
Для попередніх версій USERSIDE виконайте:
sudo -u www-data php userside_install.phar repair
'''ВАЖЛИВО:''' Через кешування файлів відновлення може не допомогти, якщо оновлення системи, розширення лімітів і відновлення виконуються в один день. У такому разі дочекайтеся наступного дня та запустіть відновлення.

FAQ. Увеличение лимитов

2026-11-12T09:38:01Z

IronBot: [IronBot] Sync RU localization from RU

[[FAQ._Increasing_limits|en]] | [[FAQ. Збільшення лімітів|uk]] | '''ru'''

'''Увеличение лимитов'''

* Оплатите расширение [[Лимиты объектов|лимита объектов]] и дождитесь подтверждения
* Запустите [[Инсталлятор|инсталлятора]] и выполните обычное обновление до последней версии. В процессе обновления будут загружены обновлённые файлы с новыми лимитами.
* В случае если у вас уже установлена последняя версия то обновляться некуда и необходимо выполнить восстановление файлов, в процессе которого будут перезагружены те же файлы последней версии но с новыми лимитами. Восстановление осуществляется командой ''(укажите нужное имя пользователя)'':
Для USERSIDE 3.21 и более новых версий выполните:
sudo -u www-data ./installer repair
Для предыдущих версий USERSIDE выполните:
sudo -u www-data php userside_install.phar repair
'''ВАЖНО:''' Стоит также отметить, что существует определённый буфер файлов и восстановление не поможет в случае если вы в один и тот же день и обновлялись и расширяли лимиты и пытаетесь сделать восстановление файлов. Поэтому следует подождать следующего дня и запустить восстановление.

FAQ. Increasing limits

2026-11-12T09:37:58Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[FAQ. Збільшення лімітів|uk]] | [[FAQ. Увеличение лимитов|ru]]

'''Limit increase'''

* Pay for the [[Objects_limits|objects limits]] extension and wait for confirmation.
* Run [[Installer|installer]] and perform a regular upgrade to the latest version. The upgrade process will download the upgraded files with the new limits.
* In case you already have the latest version installed, there is no need to upgrade and you will need to restore files, which will reload the same files of the latest version, but with new limits. The restore is performed with the ''(specify required user name)'' command:
For USERSIDE 3.21 and newer run:
sudo -u www-data ./installer repair
For older versions of USERSIDE run:
sudo -u www-data php userside_install.phar repair
'''IMPORTANT:''' It is also necessary to note that there is a certain buffer of files and restoring will not help if you have both upgraded and expanded your limits on the same day and are trying to do a file restore. This is why you should wait for the next day and run the restore.

Версії 3.21

2026-11-12T09:37:56Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.92 (у розробці) ==
* Доопрацьовано API->address->[[API_address_UK#add_address|add_address]]
* Доопрацьовано API->address->[[API_address_UK#add_province|add_province]]
* Доопрацьовано API->address->[[API_address_UK#add_district|add_district]]
* Доопрацьовано API->address->[[API_address_UK#add_city|add_city]]
* Доопрацьовано API->address->[[API_address_UK#add_area|add_area]]
* Доопрацьовано API->address->[[API_address_UK#add_street|add_street]]
* Доопрацьовано API->address->[[API_address_UK#add_house|add_house]]
* Доопрацьовано API->address->[[API_address_UK#edit_address|edit_address]]
* Доопрацьовано API->address->[[API_address_UK#edit_province|edit_province]]
* Доопрацьовано API->address->[[API_address_UK#edit_district|edit_district]]
* Доопрацьовано API->address->[[API_address_UK#edit_city|edit_city]]
* Доопрацьовано API->address->[[API_address_UK#edit_area|edit_area]]
* Доопрацьовано API->address->[[API_address_UK#edit_street|edit_street]]
* Доопрацьовано API->address->[[API_address_UK#edit_house|edit_house]]
* Доопрацьовано API->address->[[API_address_UK#get|get]]
* Доопрацьовано API->address->[[API_address_UK#get_province|get_province]]
* Доопрацьовано API->address->[[API_address_UK#get_district|get_district]]
* Доопрацьовано API->address->[[API_address_UK#get_city|get_city]]
* Доопрацьовано API->address->[[API_address_UK#get_area|get_area]]
* Доопрацьовано API->address->[[API_address_UK#get_street|get_street]]
* Доопрацьовано API->address->[[API_address_UK#get_house|get_house]]

== 3.21.91 - 11.11.2026 ==
* '''Додано можливість опитувати список ONU на окремому PON-інтерфейсі''' (раніше опитування охоплювало весь пристрій)
* У планованих схемах комутації дії тепер можна розподіляти за етапами
* У контекстному меню сплітера, кроса або обладнання на схемі комутації додано можливість задавати колір усіх з'єднань, що входять до цього об'єкта
* На схемі комутації можна виділити кілька сплітерів за допомогою Ctrl і через контекстне меню правої кнопки виконати групові дії для всіх виділених об'єктів
* Виправлено дрібні помилки

== 3.21.90 - 10.11.2026 ==
* Виправлено дрібні помилки

== 3.21.89 - 07.11.2026 ==
* Виправлено дрібні помилки

== 3.21.88 - 05.11.2026 ==
* Виправлено дрібні помилки

== 3.21.87 - 03.11.2026 ==
* Виправлено дрібні помилки

== 3.21.86 - 02.11.2026 ==
* Лінійка на карті покриття більше не блокує додавання нових об'єктів на карту
* Виправлено дрібні помилки

== 3.21.85 - 29.10.2026 ==
* Виправлено дрібні помилки

== 3.21.84 - 28.10.2026 ==
* Виправлено дрібні помилки

== 3.21.83 - 27.10.2026 ==
* Виправлено дрібні помилки

== 3.21.82 - 24.10.2026 ==
* Виправлено дрібні помилки

== 3.21.81 - 24.10.2026 ==
* Виправлено дрібні помилки

== 3.21.80 - 23.10.2026 ==
* До графіків роботи співробітників додано режим: чотири робочі дні та два вихідні
* Фільтри списків (абонентів, завдань тощо) тепер зберігають стан згортання. У заголовку фільтра відображається кількість умов
* До контекстного меню пристрою на схемі комутації додано меню швидких дій
* Для міток об'єктів тепер можна окремо налаштувати права на їх перегляд
* Виправлено дрібні помилки

== 3.21.79 - 22.10.2026 ==
* Додано API->device->[[API_device_UK#hot_change|hot_change]]
* Додано API->employee->[[API_employee_UK#edit|edit]]
* Додано API->task->[[API_task_UK#get_work_group|get_work_group]]
* Додано API->task->[[API_task_UK#get_work|get_work]]
* У групових діях із завданнями додано зміну адреси ''(зокрема квартири, поверху та під'їзду)''
* Виправлено дрібні помилки

== 3.21.78 - 18.10.2026 ==
* Додано окреме право профілю співробітника на видалення невикористовуваних адрес
* Для додаткових вкладок у картках абонентів та обладнання тепер можна задавати порядок відображення
* Виправлено розмиття SVG-файлів під час збільшення у переглядачі файлів
* Виправлено дрібні помилки

== 3.21.77 - 17.10.2026 ==
* Виправлено дрібні помилки

== 3.21.76 - 15.10.2026 ==
* До контекстного меню схеми комутації додано можливість додати фактичний сплітер
* До меню картки завдання додано кнопку перегляду схеми робочого процесу для цього типу завдань
* Виправлено дрібні помилки

== 3.21.75 - 14.10.2026 ==
* Під час призначення власників у групових діях з об'єктами інфраструктури та будівлями можна додати власника до наявних або замінити поточного
* Налаштованим фільтром календаря робіт тепер можна поділитися з іншим співробітником
* У схемах комутації будівлі та абонента додано довільні текстові написи ''(раніше вони були доступні лише у схемах об'єктів інфраструктури)''
* До схеми комутації додано кнопку швидкого створення загальної схеми комутації
* Виправлено відображення кількості квартир у звіті про кількість абонентів у будівлях

== 3.21.74 - 13.10.2026 ==
* Виправлено дрібні помилки

== 3.21.73 - 12.10.2026 ==
* У завданнях додано облік під'їзду та поверху будівлі
* У списку завдань додано групування за тривалістю перебування в різних статусах із можливістю переглянути відповідні списки завдань
* Налаштування доступу співробітника до складів тепер можна скопіювати з іншого співробітника
* Виправлено встановлення порожнього значення для додаткових полів типу «Селектор»
* Виправлено дрібні помилки

== 3.21.72 - 09.10.2026 ==
* Додано API->employee->[[API_employee_UK#add_history|add_history]]
* У меню картки будівлі додано перегляд історії дій із цією будівлею
* Виправлено дрібні помилки

== 3.21.71 - 08.10.2026 ==
* Додано API->task->[[API_task_UK#checklist_item_add|checklist_item_add]]
* Виправлено приховування та відображення вибору пов'язаних об'єктів у картці завдання
* Виправлено відображення тексту коментарів під час наведення на завдання в картках будівель та об'єктів інфраструктури
* Виправлено відображення з'єднувальних гільз у схемі комутації ''(в окремих випадках)''
* Виправлено повторне екранування тексту в редакторі ''(в окремих випадках)''
* Виправлено дрібні помилки

== 3.21.70 - 07.10.2026 ==
* Додано швидке очищення всіх збережених адресних зв'язків співробітників ''(різних типів)''
* Виправлено фільтрацію залежних абонентів та обробку сторін ODF у списках і рівнях сигналу dBm
* Виправлено дрібні помилки

== 3.21.69 - 06.10.2026 ==
* Доопрацьовано API->chapter->[[API_chapter_UK#link_add|link_add]]
* Додано дії з планованим календарем завдань через контекстне меню
* Виправлено дрібні помилки

== 3.21.68 - 05.10.2026 ==
* Тепер можна додавати коментар без тексту, але з прикріпленим файлом
* Виправлено перевірку прав під час прикріплення об'єктів інфраструктури та обладнання до завдання
* Виправлено відображення прикріплених файлів після додавання коментаря до завдання
* Виправлено дрібні помилки

== 3.21.67 - 04.10.2026 ==
* Доопрацьовано API->chapter->[[API_chapter_UK#link_add|link_add]]
* Доопрацьовано API->chapter->[[API_chapter_UK#page_add|page_add]]
* Для сплітерів додано відображення рівнів PON-сигналів залежних абонентів на карті покриття
* Виправлено помилки

== 3.21.66 - 02.10.2026 ==
* Перероблено блок коментарів до завдання
* На карті покриття додано лічильник часу до оновлення ''(якщо ввімкнено відповідне налаштування)''. Під час редагування координат об'єктів оновлення призупиняється
* Удосконалено перевірку прав для операцій у планованому календарі робіт
* Удосконалено відображення новин за завданнями
* Виправлено відображення кольорів волокон із трьома мітками на схемі комутації
* Виправлено перевірку дублювання серійних номерів і MAC-адрес під час редагування обладнання
* Виправлено фільтрацію об'єктів інфраструктури за власним значком на карті ''(в окремих випадках)''
* Виправлено помилку збереження основної адреси власника ''(в окремих випадках)''

== 3.21.65 - 30.09.2026 ==
* Натискання на об'єкт інфраструктури на додатковій карті покриття у схемі комутації тепер відкриває схему цього об'єкта ліворуч
* Виправлено помилки формування статистики дзвінків
* Виправлено версію списку обладнання для друку та експорту в Excel
* Виправлено зміну адреси об'єктів інфраструктури (в окремих випадках)
* Виправлено перемикання шарів на додатковій карті покриття у схемі комутації
* Виправлено дрібні помилки

== 3.21.64 - 29.09.2026 ==
* Додано перетягування волокна в межах кабельної лінії. Утримуйте Ctrl під час перетягування, щоб змінити позицію волокна в кабелі
* Для порту ODF/кроса тепер можна задавати колір
* У групових діях списку абонентів розділено «Показати на карті» та «Показати на карті (з рівнями сигналів dBm)»
* Виправлено перевірку прав доступу до завдань під час призначення спостерігачів
* Виправлено фільтрацію об'єктів інфраструктури, яка враховувала лише першого власника
* Виправлено перевірку наявності будівлі під час створення завдання з її картки

== 3.21.63 - 28.09.2026 ==
* Додано API->vehicle->[[API_vehicle_UK#get_route|get_route]]
* Доопрацьовано API->tariff->[[API_tariff_UK#edit|edit]]
* У схемі комутації додано карту покриття із синхронним підсвічуванням кабельних ліній
* Удосконалено схему комутації, зокрема додано виділення та переміщення кількох об'єктів одночасно
* Додано сортування абонентів за полем «Рівень сигналу (dBm)»
* У логічній схемі будівлі рівень PON-сигналу абонента, що виходить за допустимі межі, тепер відображається на червоному тлі
* Для завдання планувальника «Автоматична прив'язка абонентів до портів» додано можливість дозволити перекомутацію нового абонента, якщо на порту знайдено лише одну MAC-адресу й вона належить іншому абоненту
* Вікно вибору «Під час входу пропонувати вибір одного з наведених номерів IP-телефонів» для співробітника тепер з'являється на будь-якій сторінці після входу ''(раніше лише на головній)''
* У групових діях з об'єктами інфраструктури та будівлями додано видалення всіх власників одночасно
* Додано налаштування «Показувати поле “Ціна за одиницю” під час додавання ТМЦ»
* Виправлено вплив посилання «Вибрати все/зняти вибір» на фільтри у списках
* Виправлено спливні підказки для запасів кабелю на карті покриття

== 3.21.62 - 25.09.2026 ==
* Додано API->[[API_map_UK#delete_poly|delete_poly]]
* Доопрацьовано API->[[API_map_UK#edit_poly|edit_poly]]
* Доопрацьовано API->[[API_map_UK#add_poly|add_poly]]
* Покращено фільтрацію залежних абонентів за портами пристрою
* Виправлено зміну порядку тайлів у налаштуваннях тайлів карт
* Виправлено вибір будинку під час створення завдання ''(в окремих випадках)''

== 3.21.61 - 24.09.2026 ==
* Доопрацьовано API->task->[[API_task_UK#change_state|change_state]]
* Виправлено відображення назв складів ''(в окремих випадках)''
* Виправлено вибір потрібних інтерфейсів під час пошуку абонентів, залежних від пристрою
* Виправлено вибір обладнання абонента в меню комутації ''(в окремих випадках)''
* Виправлено надсилання та формування SMS-повідомлень ''(в окремих випадках)''
* Виправлено дрібні помилки

== 3.21.60 - 23.09.2026 ==
* Доопрацьовано API->device->[[API_device_UK#get_relation_customers|get_relation_customers]]
* Для формування списку абонентів, залежних від пристрою, тепер потрібно вибрати конкретні інтерфейси
* Виправлено автоматизацію завдань «Призначати виконавцем підрозділ співробітника, який змінив статус завдання»
* Виправлено відкриття картки об'єкта інфраструктури в режимі редагування з карти покриття
* Виправлено перевірку збігу MAC-адреси в картці обладнання
* Виправлено втрату другого сегмента лінії під час перетягування центральної точки комутації на схемі
* Виправлено повторне відображення MAC-адреси в картці ТМЦ ''(в окремих випадках)''
* Виправлено експорт маршруту комутації у KML
* Виправлено дрібні помилки

== 3.21.59 - 22.09.2026 ==
* Прикріплені до об'єкта файли тепер можна сортувати за назвою, датою додавання або розміром. Вибраний порядок зберігається у браузері.
* Виправлено сортування у списку кабельних ліній ''(в окремих випадках)''
* Виправлено звіт «ONU, не скомутовані до OLT»
* Виправлено збереження позиції події або завдання під час переміщення у календарі запланованих робіт
* Виправлено збереження адресного об'єкта, який не є будинком, у картці завдання

== 3.21.58 - 21.09.2026 ==
* Додано API->chapter->[[API_chapter_UK#page_add|page_add]]
* Додано API->chapter->[[API_chapter_UK#page_get|page_get]]
* Додано API->chapter->[[API_chapter_UK#page_remove|page_remove]]
* Додано імпорт PON-даних абонентів із білінгу ABillS та використання цих даних під час опитування OLT
* Заборонено прив'язувати той самий об'єкт до завдання на роботу повторно
* Поле пошуку у вікні вибору виконавців завдання перенесено вгору
* До контекстного меню кабельної лінії у схемі комутації додано швидкі дії з її картки
* До контекстного меню волокна кабельної лінії у схемі комутації додано швидкі дії
* До контекстного меню порту обладнання у схемі комутації додано швидкі дії
* У властивостях типу завдання можна вказати адресу за замовчуванням ''(населений пункт, вулицю тощо)'', яка пропонуватиметься під час створення такого завдання
* У групових діях для будинків можна вказати групу тарифів
* У картці об'єкта інфраструктури тепер можна швидко скопіювати його назву до буфера обміну
* Історія дій з об'єктом інфраструктури тепер містить пов'язані складські операції

== 3.21.57 - 20.09.2026 ==
* Доопрацьовано API->device->[[API_device_UK#set_data|set_data]]
* До контекстного меню портів сплітерів у схемі комутації додано кнопки швидких дій
* До списку дзвінків додано статистику
* Додано підтримку тайлів карт у форматі .pbf
* Покращено фільтрацію списку дзвінків
* Під час формування списку абонентів, залежних від пристрою, пропускаються порти UPLINK
* Виправлено помилку на головній сторінці ''(в окремих випадках)''
* Виправлено відображення блоку файлів під час перемикання вкладок у картці абонента
* Покращено відображення нотаток до всіх об'єктів одразу на карті покриття
* Виправлено збереження файлів у складській операції оприбуткування ТМЦ
* Виправлено відображення кінцевої точки комутації під час наведення на волокно у схемі ''(в окремих випадках)''
* Виправлено фільтрацію звіту про залишки ТМЦ за всіма найменуваннями ТМЦ одночасно
* Виправлено посилання «Зняти вибір» у налаштуваннях доступу виконавців до адрес для типу завдання
* Виправлено кнопки на карті покриття, коли під ними відображалися об'єкти ''(в окремих випадках)''
* Виправлено відображення одержувачів у звіті про повідомлення ''(в окремих випадках)''
* Виправлено сортування у списках об'єктів інфраструктури та схем комутації ''(в окремих випадках)''
* Виправлено прив'язку абонента під час додавання коментаря до завдання
* Виправлено роботу лінійки на карті покриття під час натискання на об'єкти інфраструктури ''(в окремих випадках)''
* Виправлено редагування властивостей профілю сповіщень ''(в окремих випадках)''
* Виправлено перевірку прав під час перегляду або зміни файлів, прикріплених до будинку
* Виправлено експорт списку об'єктів інфраструктури у XLS
* Виправлено фільтрацію абонентів, залежних від об'єкта ''(в окремих випадках)''
* Виправлено відображення списку ТМЦ у картці об'єкта інфраструктури
* Виправлено розгортання списку пов'язаних завдань у картці абонента
* Виправлено можливість комутувати завдання на порт обладнання
* Виправлено помилку під час редагування ланцюжків автоматизації у типах завдань ''(в окремих випадках)''
* Виправлено відображення SFP-модулів у схемі комутації
* Виправлено фільтр комутації на портах пристроїв у списку обладнання
* Виправлено відображення прикріплених файлів пов'язаних завдань у картці об'єкта інфраструктури ''(в окремих випадках)''
* Виправлено посилання на профіль співробітника з його картки
* Виправлено встановлення порожньої адреси завдання
* Виправлено встановлення фокуса на полі пошуку після відкриття списку ТМЦ

== 3.21.56 - 17.09.2026 ==
* Доопрацьовано API->task->[[API_task_UK#change_state|change_state]]
* Дозволено заповнювати чек-лист для профілів користувачів із правом доступу "Зміна стану"
* Виправлення невеликих помилок

== 3.21.55 - 14.09.2026 ==
* Оптимізовано глобальну схему комутації
* Доопрацьовано пошук за адресою абонента у глобальному пошуку
* Виправлено швидкий пошук за точним збігом ''(із символом "!")'' у верхній панелі
* Виправлено перезавантаження пристрою/збереження конфігурації
* Виправлено роботу фільтра за завданнями ''(у деяких випадках)''
* Виправлено відкриття карток скомутованих об'єктів зі схеми комутації ''(у деяких випадках)''
* Виправлено збереження MAC-адреси під час надходження ТМЦ
* Виправлено швидкий пошук за ТМЦ у діалозі вибору ТМЦ у завданнях ''(у деяких випадках)''
* Виправлено перегляд абонентів за сторінками в картці будинку
* Виправлено швидкий пошук за назвою споруди зв'язку ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.54 - 13.09.2026 ==
* Доопрацьовано виведення об'єктів і підказок на карті покриття
* Виправлено заповнення додаткових полів ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.53 - 09.09.2026 ==
* Виправлення невеликих помилок

== 3.21.52 - 08.09.2026 ==
* Виправлення невеликих помилок

== 3.21.51 - 05.09.2026 ==
* Виправлення невеликих помилок

== 3.21.50 - 02.09.2026 ==
* Доопрацьовано виведення нотаток до назви кабельної лінії в результатах швидкого пошуку за кабельними лініями
* Виправлено фіксацію нотатки до складської операції під час передавання ТМЦ спеціального типу
* Виправлено відображення логічної схеми будинку ''(у деяких випадках)''
* Виправлено можливість вибору файла з основною фотографією/зображенням для співробітника ''(у деяких випадках)''
* Виправлено пошук співробітника в списку за номером телефону
* Виправлено зазначення доступних адрес для співробітника під час його створення
* Виправлення невеликих помилок

== 3.21.49 - 01.09.2026 ==
* Виправлено підсумкове групування значень додаткових полів у списку завдань
* Виправлено зайву заміну символів на HTML-сутності в нотатках щодо абонента
* Виправлено формування тексту повідомлень під час надсилання поштою ''(у деяких випадках)''
* Виправлення невеликих помилок
== 3.21.48 - 31.08.2026 ==
* Додано метод API->task->[[API_task_UK#show|show]]
* '''У запланованій схемі комутації можна виводити список дій у текстовому вигляді ''(з можливістю окремо роздрукувати/позначити виконані)'''''
* У картці споруди зв'язку під час редагування координат можна вставити значення з GPS-приймача пристрою
* Додано можливість створювати шаблони шарів/міток на карті
* У схемі комутації додано кнопку "Тільки маркування", яка приховує назви кабельних ліній і залишає на них лише написи маркування
* Доопрацьовано пошук абонентів за номерами телефонів у списку дзвінків
* Виправлено роботу додаткових полів з типом "Прикріплені файли" під час виконання завдання
* Виправлено перевірку прав під час пошуку MAC-адреси в загальному пошуку
* Виправлено відображення інвентарного номера в картці ТМЦ ''(у деяких випадках)''

== 3.21.47 - 29.08.2026 ==
* Під час зазначення батьківського завдання в картці завдання система одразу перевіряє, чи є таке завдання і чи є права доступу до нього. Якщо доступ є, одразу виводиться посилання на батьківське завдання.
* Виправлено розрив комутації у запланованій схемі комутації ''(у деяких випадках)''
* Виправлено помилку під час відкриття розділу з колірними схемами кабелів ''(у деяких випадках)''
* Виправлено пошук абонента за IP-підмережею
* Виправлено відображення будівель на мапі ''(у деяких випадках)''
* Виправлено перевірку прав під час створення дочірнього завдання
* Виправлено зайвий пошук серед звільнених співробітників
* Виправлено пошук абонентів за телефонними номерами з "+" на початку
* Виправлено сортування списку номерів будівель у селекторі вибору
* Виправлено відображення нотаток на волокнах кабельних ліній у схемі комутації ''(у деяких випадках)''

== 3.21.46 - 28.08.2026 ==
* Виправлено збереження прав доступу до завдань ''(у деяких випадках)''
* Виправлено клікабельний перехід за номером квартири у списку абонентів за будівлею
* Виправлено діалог об'єднання ТМЦ
* Виправлено відображення кількох абонентів у списку дзвінків, якщо номер телефону збігається
* Виправлено неможливість відповісти на коментар до завдання ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.45 - 27.08.2026 ==
* Виправлено пошук за абонентом у швидкому пошуку ''(у деяких випадках)''
* Виправлено помилку під час перегляду логічної схеми будівлі ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.44 - 26.08.2026 ==
* Додано параметр налаштування "Під час переходу до наступної схеми комутації центрувати схему на кабельній лінії, з якої був виконаний перехід"
* У картці ONU/ТМЦ/абонента виводиться окрема плашка, що показує поточний стан ONU ONLINE/OFFLINE
* Виправлено відображення значень додаткових полів з назвами об'єктів у списках завдань та інших списках

== 3.21.43 - 25.08.2026 ==
* Виправлено помилку під час зміни статусу завдання ''(у деяких випадках)''
* Виправлено помилку під час побудови маршруту комутації ''(у деяких випадках)''
* Виправлено фільтрацію за абонентами у списку дзвінків
* Виправлення невеликих помилок

== 3.21.42 - 24.08.2026 ==
* [[Імпорт будівель з КАІС (BG)]]
* Під час переходу у запланованій схемі комутації до схеми сусідньої споруди зв'язку ''(протилежного об'єкта на кабельній лінії)'' схема одразу відкривається у подвійному режимі поточна/запланована. Якщо запланованої схеми ще немає, система пропонує її створити.
* Правий клік на портах дільника у схемі комутації відкриває контекстне меню порту
* Під час ручного додавання VLAN на обладнанні виводиться селектор з портами цього обладнання
* Доопрацьовано автопобудову П-подібного маршруту комутації у схемі комутації
* У налаштуванні статусу завдання можна вказати у виборі ТМЦ, куди передавати вибрані ТМЦ ''(абонент/завдання)'', і на який субрахунок
* У запланованій схемі комутації для портів "пісочних" дільників додано можливість змінювати типи адаптерів
* У запланованій схемі комутації додано можливість масово комутувати волокна/порти між собою
* Зміна типу пігтейлів для портів/волокон у запланованій схемі комутації фіксується лише в ній і не впливає на поточну схему комутації
* Під час виведення розділеної сторінки з поточною/запланованою схемами комутації їх можна експортувати в SVG з різними налаштуваннями експорту
* Виправлено неточності генерації схеми комутації в SVG
* Виправлено можливість додавання локальних UNC-посилань у редактор WYSIWYG
* Виправлено помилки під час надсилання email-сповіщень ''(у деяких випадках)''
* Виправлено переміщення позиції схеми комутації на глобальній схемі комутації ''(у деяких випадках)''
== 3.21.41 - 21.08.2026 ==
* Оптимізовано відображення спливних підказок на мапі покриття
* Виправлено зміну кількості адаптерів під час гарячої заміни дільника
* Виправлено відображення SVG-файлів у галереї прикріплених файлів ''(у деяких випадках)''
* Виправлено помилку перегляду точки маршруту комутації на мапі покриття
* Виправлено помилку під час переходу до картки обладнання з картки завдання ''(у деяких випадках)''
* Виправлено зміну маршруту на мапі для кабельних трас
* Виправлено відображення співробітників у селекторах як звільнених ''(у деяких випадках)''
* Виправлено масштабування об'єктів на мапі ''(у деяких випадках)''
* Виправлено відображення нотаток у списку абонентів
* Виправлено ping довільної IP-адреси
* Виправлення невеликих помилок

== 3.21.40 - 17.08.2026 ==
* У запланованій схемі комутації в контекстному меню можна додавати кабельні лінії, зокрема з ємністю 12 і 48
* Для типів завдань виділено окреме право "Коментарі"
* Для обладнання можна будувати список залежних абонентів саме за потрібними портами
* Перероблено діалог гарячої заміни дільника: тепер можна вибирати дільник з усіх доступних складів
* У схемі комутації межу робочої області зроблено перетягуваною, що дає змогу швидко змінювати розмір поля схеми комутації
* У схемі комутації додано швидку можливість скомутувати N волокон/портів пристроїв між собою ''(починаючи з поточного, з розривом наявної комутації)''
* Виправлено задвоєння відображення співробітників у списку співробітників підрозділу ''(у деяких випадках)''
* Виправлено відображення записів таблиць відповідно до власного налаштування кожного співробітника щодо кількості записів у таблиці
* Виправлено завантаження списку автовиконавців для завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.39 - 14.08.2026 ==
* Доопрацьовано зовнішній вигляд спливних коментарів у списку завдань
* Виправлено вибір порту обладнання для переключення зайнятого порту
* Виправлення невеликих помилок

== 3.21.38 - 13.08.2026 ==
* Виправлено прикріплення файлів у додаткових полях для нових об'єктів
* Виправлення невеликих помилок

== 3.21.37 - 12.08.2026 ==
* Виправлення невеликих помилок

== 3.21.36 - 09.08.2026 ==
* У запланованій схемі комутації додано функції "пісочниці": можна створювати кабельні лінії та дільники без прив'язки до реальних об'єктів. Можна приховувати наявні об'єкти. Додано додаткові кнопки відображення.
* Додано архів за транспортом
* У ланцюжках дій за типами завдань додано нову дію "Підрозділ. Виключити з усіма його співробітниками"
* У налаштуваннях типів завдань додано властивість "Приховувати робочу нотатку за адресами в цьому типі завдань"

== 3.21.35 - 08.08.2026 ==
* Виправлення невеликих помилок

== 3.21.34 - 07.08.2026 ==
* Для типу споруд зв'язку можна налаштувати поєднання клавіш для швидкого додавання об'єкта такого типу на мапу
* У схемі комутації додано контекстне меню - можливість швидко додати запланований дільник потрібного типу
* Під час натискання правою кнопкою на об'єкт у схемі комутації одразу відкривається його контекстне меню
* Виправлено редагування параметрів CWDM у каталозі товарів
* Виправлено можливість розділення доступних ТМЦ для профілю співробітника з доступом лише до власного підзвіту

== 3.21.33 - 06.08.2026 ==
* У схемі комутації можна розділити екран на дві частини та виводити поточну і заплановану схему. Запланована схема тепер також підтримує можливість змінювати позиції об'єктів, напрямок портів та інше введення кабелів
* У списках об'єктів у групових діях додано можливість масово позначати об'єкти, що розташовані нижче у списку
* Виправлення деяких помилок міграції

== 3.21.32 - 05.08.2026 ==
* Під час додавання кабельної лінії з мапи покриття через кілька проміжних споруд зв'язку додано можливість позначати, на яких саме проміжних спорудах зв'язку потрібно розділити цю лінію і чи потрібно зберегти комутацію між цими сегментами
* Виправлено часткове копіювання інформації у списку пристроїв ''(у деяких випадках)''
* Виправлено помилку під час масового приходу ТМЦ ''(у деяких випадках)''
* Виправлено зазначення кольору для будь-якого порту дільника
* Виправлено виведення інформації про невиконані поточні завдання в картці абонента
* Виправлено роботу селектора вибору співробітника ''(у деяких випадках)''

== 3.21.31 - 02.08.2026 ==
* У глобальній схемі комутації додано можливість друку всієї цієї схеми
* З мапи можна створювати кабельні лінії одразу через усі проміжні споруди зв'язку ''(а не лише від початкового до кінцевого об'єкта)''
* Для SMS-розсилок додано виключення за міткою/значенням додаткового поля на абоненті
* У запланованій схемі комутації додано можливість змінювати маршрут проходження запланованої комутації
* Для міток можна окремо призначати їх застосування до абонентів-юридичних/фізичних осіб та/або потенційних абонентів
* Спливне вікно про вхідний виклик можна виводити зверху/знизу, ліворуч/по центру/праворуч. Можна вказати, щоб воно виводило нотатки за абонентом
* У логічній схемі будівлі можна окремо вказати структуру для кожного під'їзду
* Виправлено фільтрацію за завданнями після виконання групових дій із завданнями
* Виправлено можливість додавання файлів під час зміни статусу завдання
* Виправлено пошук за IP-адресою у списку комутаторів ''(у деяких випадках)''

== 3.21.30 - 31.07.2026 ==
* У картці будівлі можна вказувати довільну нумерацію під'їздів ''(зокрема текстові назви під'їздів)''
* У картці полігона додано посилання на зміну координат
* У списку повідомлень додано можливість фільтрації за наявністю абонента, а також групову дію - призначити/зняти мітку на абонентів із цих повідомлень
* У логічній схемі будівлі додано можливість приховати відображення абонентів і комутацій до них
* У звіті щодо залишків ТМЦ додано можливість фільтрації за найменуванням/категорією ТМЦ
* У картці абонента можна окремо вручну вносити координати в режимі редагування або змінювати їх на мапі
* Для мітки можна призначити права доступу за профілем співробітника
* Виправлено помилку під час перегляду історії за абонентом ''(у деяких випадках)''

== 3.21.29 - 30.07.2026 ==
* У профілях співробітників додано нове право "Управління своїм підзвітом"
* Для кожного типу завдань можна налаштувати, які мітки використовувати в завданнях такого типу
* Для типу завдань можна вибрати категорію абонентів цього типу завдань ''("Юридичні особи", "Фізичні особи")''
* У відомості робіт додано можливість сортування за різними полями
* Виправлено можливість згадувати співробітників у коментарях до завдань
* Виправлено додавання кабельної траси з мапи покриття
* Виправлено помилку під час виключення рівня в логічній схемі будівлі ''(у деяких випадках)''

== 3.21.28 - 29.07.2026 ==
* У списку ТМЦ додано фільтр за значенням додаткового поля
* Кожен співробітник може налаштувати для себе автооновлення головної сторінки
* Виправлення помилки у віджеті головної сторінки "Список завдань на сьогодні"
* Виправлено вибір ТМЦ для додавання в операцію
* Виправлено коректне відкриття картки абонента в логічній схемі будівлі
* Виправлено розрив комутації без перезавантаження сторінки в схемі комутації
* Виправлено селектор вибору адресних об'єктів для співробітників з обмеженими адресними правами

== 3.21.27 - 28.07.2026 ==
* Нове право для профілів співробітників "Склад - Звіти"
* Окремо для кожного типу споруд зв'язку додано можливість вмикати/вимикати виведення його номера/найменування на мапі та шаблон формування номера/найменування
* Новий тип додаткового поля "Крос/ODF"
* У розрахунку маршруту з'єднань додано можливість експортувати результат у KML-файл
* Додано настроювані "Кольорові схеми кабелів". Їх можна довільно використовувати, щоб змінювати розфарбування в кабельних лініях.
* Для кабельної лінії розфарбування провідників можна скопіювати з інших кабельних ліній, які є у спорудах зв'язку, де закінчується ця кабельна лінія.
* Виправлено перехід на картку конкретного ТМЦ за його ID з-під лівого меню
* Виправлено відображення кольору полігона на мапі покриття ''(у деяких випадках)''
* Виправлено відображення багаторядкових написів на мапі покриття
* Виправлено помилку під час відкриття картки стійки/шафи ''(у деяких випадках)''

== 3.21.26 - 27.07.2026 ==
* У режимі планування в схемі комутації додано можливість планувати розрив комутації
* У "Комутатори" додано звіт "Номінальне та SNMP-найменування обладнання"
* Для профілів співробітників можна налаштовувати, у які категорії співробітник має право переміщати ТМЦ
* Право на перегляд списаних ТМЦ окремо винесено для профілів співробітників ''(раніше перегляд і зміна були разом)''
* У ланцюжках завдань/автоматизації додано дію "Абонент. Створення"
* Для портів дільників можна вказувати їхній колір
* У списку ONU за пристроєм фільтр за назвою інтерфейсу дозволяє вибирати одночасно кілька інтерфейсів пристрою
* Під час редагування завдання можна додавати одразу кілька абонентів
* У картці завдання додано можливість створювати копію поточного завдання
* Виправлено вибір обладнання для гарячої заміни пристрою

== 3.21.25 - 25.07.2026 ==
* Якщо під час зміни статусу завдання налаштовано ланцюжок завдань/автоматизацію, ця інформація виводиться у спливній підказці на статусі завдання
* Доопрацьовано обробку номерів телефонів у додаткових полях картки завдання під потрібний формат системи
* У каталозі кабелів для марки кабелю додано параметр "Схема комутації. Колір написів"
* Зміна власних координат абонента фіксується в історії дій
* Виправлено перевірку прав доступу під час перегляду прикріплених файлів за абонентом
* Виправлено надсилання сповіщень співробітникам про недоступність/активність обладнання ''(у деяких випадках)''

== 3.21.24 - 24.07.2026 ==
* Якщо сторінку входу відкриває вже автентифікований користувач, відкривається головна сторінка системи
* У списку ТМЦ можна візуально групувати ТМЦ за найменуванням ''(об'єднувати кілька ТМЦ в одну групу, щоб швидко бачити кількість ТМЦ з таким найменуванням на об'єкті)''
* Доопрацьовано кольорове виділення запланованих кабельних ліній
* Виправлено перевірку доступу до адресних об'єктів ''(у деяких випадках)''

== 3.21.23 - 23.07.2026 ==
* Додано відображення прогресу імпорту споруд зв'язку
* Виправлено збереження chat_id для співробітника ''(у деяких випадках)''
* Виправлено відображення нотаток в історії за абонентом

== 3.21.22 - 22.07.2026 ==
* Написи на мапі виводяться з білим ореолом для кращої читабельності
* Виправлено помилку під час перегляду історії дій співробітника ''(у деяких випадках)''
* Виправлено неможливість виключення пов'язаних об'єктів із завдання ''(у деяких випадках)''
* Виправлено сортування пов'язаних завдань у картці завдання

== 3.21.21 - 21.07.2026 ==
* '''Для глобальної схеми комутації додано можливість експорту в SVG'''
* У картці ТМЦ можна формувати документи за цим ТМЦ
* Виправлено помилку під час відкриття операції за ТМЦ ''(у деяких випадках)''
* Виправлено редагування параметрів доступу для системних пристроїв
* Виправлено комутацію до портів системних пристроїв
* Виправлено відображення списку інтерфейсів/стекування за пристроєм ''(у деяких випадках)''
* Виправлено видалення поверху у структурі будівлі

== 3.21.20 - 20.07.2026 ==
* У діалоговому вікні призначення адресного доступу для співробітника додано пошук за адресним об'єктом
* Додано кнопки швидкого очищення нотаток на портах ODF/кроса у схемі комутації
* Виправлення невеликих помилок

== 3.21.19 - 18.07.2026 ==
* Для типів споруд зв'язку додано властивість "Дозволити збіг номерів об'єктів для різних населених пунктів"
* Для типів адресних одиниць додано налаштування, у яких батьківських адресних одиницях їх можна додавати ''(наприклад, "вулиці" тільки в "містах" тощо)''
* Для типів адресних об'єктів можна налаштувати доступ до редагування таких об'єктів за профілями співробітників
* Доопрацьовано відображення завжди повних ПІБ у списку співробітників
* Виправлено операції з мультиплексорами на схемі комутації
* Виправлено відображення нового доданого типу кабельної лінії в лівому меню

== 3.21.18 - 17.07.2026 ==
* Значки абонентів на мапі покриття виводяться з кольором контуру відповідно до кольору мітки на цьому абоненті
* У списку завдань додано фільтр за значенням додаткового поля на адресі завдання
* Виправлення невеликих помилок

== 3.21.17 - 16.07.2026 ==
* '''Обладнання можна встановлювати на будівлі ''(раніше тільки на споруді зв'язку або на абоненті)'''''
* '''Кабельна лінія тепер може починатися на абоненті або на будівлі ''(раніше тільки на споруді зв'язку)'''''
* У список абонентів додано поле "Загальна абонплата" з можливістю фільтрації за ним
* Виправлено помилку під час перегляду історії комутації за волокном кабельної лінії ''(у деяких випадках)''
* Виправлено збереження вибраної групи типів для властивостей типу споруди зв'язку
* Виправлено пошук за маркою кабелю під час додавання кабельної лінії ''(у деяких випадках)''

== 3.21.16 - 15.07.2026 ==
* '''ODF/кроси та дільники можна встановлювати в абонентів або на будівлях'''
* У списку ONU за OLT у фільтрації за інтерфейсом додано селектор наявних PON-інтерфейсів OLT
* Виправлено роботу операцій у запланованій схемі комутації
* Виправлено сортування персоналу в підрозділі у списку підрозділів
* Виправлено додавання ТМЦ із зазначенням IP/MAC-адреси
* Виправлено відображення історії за волокнами кабельних ліній

== 3.21.15 - 14.07.2026 ==
* Для типу завдань можна вказувати, що це завдання тільки для абонентів певних груп
* Додано можливість надсилати повідомлення всім співробітникам компанії з можливістю вказати дату видалення ''(за потреби)''
* Виправлено зовнішній вигляд картки підрозділу під час редагування
* Виправлено перебудову дочірніх схем під час перетягування схеми комутації на глобальній схемі
* Виправлено роботу параметра "Під час зміни полігона будівлі виводити на мапі й інші об'єкти" ''(у деяких випадках)''
* Виправлено неможливість вибрати будівлю під час створення нового завдання

== 3.21.14 - 13.07.2026 ==
* '''Додано можливість прив'язувати ТМЦ до завдання ''(як обладнання, абонент тощо)''. Без передачі ТМЦ на саме завдання. Для обліку виконання завдань, пов'язаних із ТМЦ.'''
* У звітах за ТМЦ додано новий звіт "Рух ТМЦ"
* У списку будинків додано фільтрацію за наявністю/відсутністю споруди зв'язку на будинку
* Додано нове право для профілів співробітників: "Налаштування - Статуси завдань"
* У календарі робіт додано фільтри для налаштування власного порядку/наявності підрозділів і співробітників у календарі
* Перероблено розділ зі списком підрозділів. Змінено зовнішній вигляд, додано швидкий пошук за співробітником/підрозділом
* Під час створення нового будинку в блоці вибору адреси нова адреса одразу підставляється без перезавантаження поточної сторінки
* Під час пошуку в блоці вибору адреси в результатах виводяться не лише будинки, а й інші типи адресних об'єктів, що дозволяє також швидко додавати нові будинки, вулиці тощо
* Доопрацьовано зовнішній вигляд картки завдання для мобільних пристроїв
* Виправлено швидкість роботи карти покриття під час відображення шару "Співробітники та автотранспорт"
* Виправлено фільтрацію у списку будинків ''(у деяких випадках)''
* Виправлено перегляд PDF-файлів у браузері ''(у деяких випадках)''
* Виправлено фільтрацію списку абонентів-боржників
* Виправлено відображення розділу "Налаштування-Адреси" для співробітників з обмеженим доступом за географією
* Виправлено відображення волокон на схемі комутації за наявності мітки на волокні
* Виправлено помилку під час відображення завдань поточного дня в календарі робіт ''(у деяких випадках)''

== 3.21.13 - 10.07.2026 ==
* '''Під час приходу ТМЦ тепер можна одразу вказувати кілька різних найменувань ТМЦ'''
* Доопрацювання у відображенні виконаних завдань у календарі
* У схемі комутації для дільників і ODF/кросів у меню об'єктів додано кнопки дій, як і в картках цих об'єктів ''(редагування, видалення, структурна схема тощо)''
* Виправлено комутацію у схемі комутації ''(у деяких випадках)''
* Виправлено дублювання запитів під час автооновлення рівня сигналу на ONU під час відкриття її картки
* Виправлено зовнішній вигляд відображення історії за завданням
* Виправлено редагування налаштувань карти покриття ''(у деяких випадках)''
* Виправлено вибір об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено перевірку прав доступу до списку ONU для співробітників
* Виправлено зовнішній вигляд картки стійки/шафи в темній схемі інтерфейсу

== 3.21.12 - 09.07.2026 ==
* Доопрацьовано метод API->[[API_redirect_UK|redirect]]
* Під час розділення ТМЦ на кілька частин за наявності прикріплених файлів вони закріплюються за всіма ТМЦ
* Доопрацьовано діалог додавання кабельної лінії з-під споруди зв'язку
* Додано параметр налаштування "Відображати виконані завдання з прозорістю (%)"
* Виправлено роботу параметра налаштування "Відображати виконані завдання сірим кольором"
* Виправлено виведення поля для зазначення MAC-адреси під час приходу ТМЦ
* Виправлено роботу залежностей додаткових полів
* Виправлено роботу з прикріпленими файлами в операціях з автотранспортом
* Виправлено перехід до налаштування полів таблиці споруд зв'язку
* Виправлено зовнішній вигляд інформації за завданнями у вкладці "Тех. підтримка" у картці абонента
* Виправлено помилки під час перегляду історії дій користувачів ''(у деяких випадках)''
* Виправлено помилку під час відкриття діалогового вікна вибору ТМЦ для інтеграції
* Виправлено переміщення позицій об'єктів на глобальній схемі комутації
* Виправлено зазначення резервів для кабельних ліній
* Виправлено помилку під час приходу ТМЦ та автопризначення інвентарних номерів ''(у деяких випадках)''
* Виправлено налаштування доступу до адрес для співробітників

== 3.21.11 - 08.07.2026 ==
* Виправлено зовнішній вигляд налаштування таблиці прав для типів завдань
* Виправлено зміну позиції окремої схеми комутації споруди зв'язку на загальній глобальній схемі комутації
* Виправлено фільтрацію завдань у розділі "Мої завдання" ''(у деяких випадках)''
* Виправлено зміну координат адресного об'єкта з-під картки будинку
* Виправлено сортування виконавців під час створення завдання
* Виправлено зміну координат сектора для радіообладнання
* Виправлено перевірку прав доступу під час відкриття картки пристрою ''(у деяких випадках)''
* Виправлено приховування/відображення споруди зв'язку на карті покриття

== 3.21.10 - 07.07.2026 ==
* Додано метод API->call->[[API_call_UK#edit|edit]]
* Додано нові права для профілів користувачів "Власники (доступ до фінансової інформації)" та "Орендарі (доступ до фінансової інформації)"
* '''Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником'''
* У групових діях за спорудами зв'язку створення спільного завдання/окремих завдань реалізовано через стандартний діалог додавання завдання
* Виправлено позначення завдання як прочитаного в новинах під час відкриття картки завдання
* Виправлено відображення дати останньої операції за ТМЦ у списку ТМЦ за об'єктом
* Виправлено генерацію документа на друк з-під картки завдання
* Виправлено комутацію вільних волокон кабелів між собою ''(у деяких випадках)''
* Виправлено редагування координат у лінії зв'язку
* Виправлено виведення сторонніх артефактів у глобальній схемі комутації ''(у деяких випадках)''
== 3.21.9 - 06.07.2026 ==
* У виключення для SMS-розсилок додано можливість виключати абонентів із певним періодом від'ємного балансу
* У статистиці "Проблемні будинки/абоненти" додано можливість налаштовувати власні фільтри
* У налаштуваннях типу завдань у секції додаткових полів окремо вказуються типи додаткових полів, які можна використовувати під час зміни статусу завдань. А в налаштуваннях статусів завдань додано властивість "Вивести додаткові поля"
* Додано можливість автоматично створювати завдання на роботу для невідповіджених телефонних викликів
* Зміну пароля користувача винесено в окреме діалогове вікно

== 3.21.8 - 04.07.2026 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доробки зовнішнього вигляду завдань у календарі робіт
* У групових діях за абонентами: створення завдань тепер використовує повноцінний діалог зазначення властивостей для створюваних завдань
* Оптимізація структурної схеми
* Виправлено помилку під час встановлення умов у SMS-розсилці ''(у деяких випадках)''
* Виправлено зазначення власних координат для абонента
* Виправлено помилку під час збереження системного пристрою
* Виправлено виведення об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено комутацію кабельної лінії до пристрою у схемі комутації абонента
* Виправлено зміну довільних координат для обладнання
* Виправлено роботу фільтра за виключенням тарифу в SMS-розсилці

== 3.21.7 - 03.07.2026 ==
* Режим планування в календарі робіт
* Виправлено пошук у списку споруд зв'язку ''(у деяких випадках)''
* Виправлено відображення прикріплених файлів у картці споруди зв'язку за наявності прав лише на читання
* Виправлено перегляд/формування SMS-розсилок ''(у деяких випадках)''
* Виправлено відображення рівнів сигналів для ONU ''(у деяких випадках)''
* Виправлено відображення затухань на структурній схемі для OLT ''(у деяких випадках)''
* Виправлено помилку під час перегляду історії за співробітниками ''(у деяких випадках)''
* Виправлено неправильне виведення дати активності у спливній підказці на мапі покриття за автотранспортом
* Виправлено можливість виключення абонента із завдання

== 3.21.6 - 02.07.2026 ==
* Додано історію використання IP-адрес
* Доопрацьовано використання лінійки на мапі покриття
* Виправлено зовнішній вигляд кабельних ліній на мапі покриття залежно від налаштувань міток ''(у деяких випадках)''
* Виправлено список обладнання у віджеті головної сторінки "Неактивні комутатори"
* Виправлено додавання нових схем споруд зв'язку на глобальну схему комутації
* Виправлено пошук за базою обладнання під час додавання найменування ТМЦ у каталозі товарів
* Виправлено очищення комутації портів обладнання ''(у деяких випадках)''
* Виправлено помилку у звіті щодо залишків ТМЦ ''(у деяких випадках)''
* Виправлено зазначення довільних запасів/об'єктів на маршруті кабельної лінії
* Виправлено перемикання комутації в порт іншого пристрою на споруді зв'язку
* Виправлено відображення об'єктів на мапі покриття у групових операціях за спорудами зв'язку
* Виправлено зміну шляху комутації у схемі комутації ''(у деяких випадках)''

== 3.21.5 - 01.07.2026 ==
* Додано сповіщення під час редагування завдання ''(налаштовується)''
* Доробка зі знімання інформації за інтерфейсами ONU
* Доопрацьовано зовнішній вигляд портів обладнання для темної схеми
* Для типів завдань додано можливість вказати дії з ТМЦ: передавати з абонента на вибраний склад потрібні ТМЦ, що знаходяться в абонента
* Виправлено швидкий пошук обладнання потрібної категорії у списку обладнання
* Виправлено вибір інших пристроїв на цій споруді зв'язку в діалоговому вікні перемикання порту
* Виправлено відображення доступних складів для співробітника ''(у деяких випадках)''
* Виправлено помилку під час перегляду картки ТМЦ ''(у деяких випадках)''
* Виправлено автовибір будинку під час додавання споруди зв'язку з картки будинку
* Виправлено перегляд списку опитуваних пристроїв у модулі usm_observer
* Виправлено можливість зміни кольору з'єднання між пристроями у схемі комутації

== 3.21.4 - 30.06.2026 ==
* Доопрацьовано метод API->attach->[[API_attach_UK#upload|upload]]
* Додано окремий профіль email-сповіщень для надсилання повідомлень абонентам-юридичним особам
* Доопрацьовано сортування у списку споруд зв'язку за будинком
* Календар робіт відкривається на поточній даті
* Доробка календаря завдань для випадків, коли кілька завдань призначаються на один час
* Впроваджено багаторівневі групи типів завдань
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email абонентам ''(за налаштовуваними шаблонами)''
* Доопрацьовано виведення спливного сповіщення під час призначення підрозділу співробітника на завдання
* Виправлено відображення блока з прикріпленими файлами у власних розділах за права лише на читання
* Виправлено перехід у картку абонента з мапи покриття
* Виправлено помилку під час налаштування доступності статусів для профілів співробітників у картці типу завдання
* Виправлено фільтрацію за датами у списку завдань ''(у деяких випадках)''
* Виправлено відображення автора завдання у списку завдань
* Виправлено відображення поля "Нотатки" у картці споруди зв'язку
* Виправлено помилку під час спроби видалення адресного об'єкта ''(у деяких випадках)''
* Виправлено можливість вимкнення/увімкнення порту пристрою
* Виправлено перегляд глобальних схем комутації ''(у деяких випадках)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Versions 3.21 EN

2026-11-12T09:37:54Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.92 (in development) ==
* Updated API->address->[[API_address_EN#add_address|add_address]]
* Updated API->address->[[API_address_EN#add_province|add_province]]
* Updated API->address->[[API_address_EN#add_district|add_district]]
* Updated API->address->[[API_address_EN#add_city|add_city]]
* Updated API->address->[[API_address_EN#add_area|add_area]]
* Updated API->address->[[API_address_EN#add_street|add_street]]
* Updated API->address->[[API_address_EN#add_house|add_house]]
* Updated API->address->[[API_address_EN#edit_address|edit_address]]
* Updated API->address->[[API_address_EN#edit_province|edit_province]]
* Updated API->address->[[API_address_EN#edit_district|edit_district]]
* Updated API->address->[[API_address_EN#edit_city|edit_city]]
* Updated API->address->[[API_address_EN#edit_area|edit_area]]
* Updated API->address->[[API_address_EN#edit_street|edit_street]]
* Updated API->address->[[API_address_EN#edit_house|edit_house]]
* Updated API->address->[[API_address_EN#get|get]]
* Updated API->address->[[API_address_EN#get_province|get_province]]
* Updated API->address->[[API_address_EN#get_district|get_district]]
* Updated API->address->[[API_address_EN#get_city|get_city]]
* Updated API->address->[[API_address_EN#get_area|get_area]]
* Updated API->address->[[API_address_EN#get_street|get_street]]
* Updated API->address->[[API_address_EN#get_house|get_house]]

== 3.21.91 - 11.11.2026 ==
* '''Added polling of ONUs on a specific PON interface''' (previously, polling covered the entire device)
* Actions in planned patching diagrams can now be organized into stages
* The context menu for a splitter, distribution frame, or device in a patching diagram now lets you set a color for all connections entering that object
* In a patching diagram, select several splitters with Ctrl and use the right-click context menu to apply bulk actions to all selected objects
* Minor bug fixes

== 3.21.90 - 10.11.2026 ==
* Minor bug fixes

== 3.21.89 - 07.11.2026 ==
* Minor bug fixes

== 3.21.88 - 05.11.2026 ==
* Minor bug fixes

== 3.21.87 - 03.11.2026 ==
* Minor bug fixes

== 3.21.86 - 02.11.2026 ==
* The coverage map ruler no longer blocks adding new objects to the map
* Minor bug fixes

== 3.21.85 - 29.10.2026 ==
* Minor bug fixes

== 3.21.84 - 28.10.2026 ==
* Minor bug fixes

== 3.21.83 - 27.10.2026 ==
* Minor bug fixes

== 3.21.82 - 24.10.2026 ==
* Minor bug fixes

== 3.21.81 - 24.10.2026 ==
* Minor bug fixes

== 3.21.80 - 23.10.2026 ==
* Added a four-days-on, two-days-off option to employee work schedules
* List filters (for customers, tasks, etc.) now retain their collapsed state. The filter header shows the number of conditions
* Added a quick actions menu to the device context menu in patching diagrams
* View permissions can now be configured separately for object marks
* Minor bug fixes

== 3.21.79 - 22.10.2026 ==
* Added API->device->[[API_device_EN#hot_change|hot_change]]
* Added API->employee->[[API_employee_EN#edit|edit]]
* Added API->task->[[API_task_EN#get_work_group|get_work_group]]
* Added API->task->[[API_task_EN#get_work|get_work]]
* Bulk task actions now support changing the address ''(including apartment, floor, and entrance)''
* Minor bug fixes

== 3.21.78 - 18.10.2026 ==
* Added a separate employee profile permission for deleting unused addresses
* The display order of additional tabs in customer and equipment cards can now be specified
* Fixed SVG files becoming blurred when zooming in the file viewer
* Minor bug fixes

== 3.21.77 - 17.10.2026 ==
* Minor bug fixes

== 3.21.76 - 15.10.2026 ==
* The patching diagram context menu now supports adding an actual splitter
* Added a button to the task card menu for viewing the workflow diagram for that task type
* Minor bug fixes

== 3.21.75 - 14.10.2026 ==
* When assigning owners through bulk actions for facilities/buildings, you can now add to the existing owners or replace the current owner
* Custom work calendar filters can now be shared with another employee
* Building/customer patching diagrams now support custom text labels ''(previously available only in facility diagrams)''
* Added a button to quickly create a combined patching diagram
* Fixed the apartment count in the report on customer counts in buildings

== 3.21.74 - 13.10.2026 ==
* Minor bug fixes

== 3.21.73 - 12.10.2026 ==
* Tasks now support recording the building entrance and floor
* The task list can now be grouped by time spent in different statuses, with access to the corresponding task lists
* An employee's warehouse access settings can now be copied from another employee
* Fixed setting an empty value for additional fields of type "Selector"
* Minor bug fixes

== 3.21.72 - 09.10.2026 ==
* Added API->employee->[[API_employee_EN#add_history|add_history]]
* The building card menu now provides access to the building's action history
* Minor bug fixes

== 3.21.71 - 08.10.2026 ==
* Added API->task->[[API_task_EN#checklist_item_add|checklist_item_add]]
* Fixed showing and hiding the related object selector in task cards
* Fixed comment text displayed when hovering over tasks in building and facility cards
* Fixed the display of splice sleeves in patching diagrams ''(in some cases)''
* Fixed repeated escaping of text in the editor ''(in some cases)''
* Minor bug fixes

== 3.21.70 - 07.10.2026 ==
* Added a quick way to clear all saved employee address associations ''(of different types)''
* Fixed filtering of dependent customers and handling of distribution frame sides in lists and dBm signal levels
* Minor bug fixes

== 3.21.69 - 06.10.2026 ==
* Updated API->chapter->[[API_chapter_EN#link_add|link_add]]
* Added context menu actions for the planned task calendar
* Minor bug fixes

== 3.21.68 - 05.10.2026 ==
* Comments can now contain an attachment without any text
* Fixed permission checks when attaching facilities/equipment to a task
* Fixed the display of attachments after adding a task comment
* Minor bug fixes

== 3.21.67 - 04.10.2026 ==
* Updated API->chapter->[[API_chapter_EN#link_add|link_add]]
* Updated API->chapter->[[API_chapter_EN#page_add|page_add]]
* Splitters can now display PON signal levels for dependent customers on the coverage map
* Bug fixes

== 3.21.66 - 02.10.2026 ==
* Refactored the task comments section
* Added a refresh countdown on the coverage map ''(when enabled in settings)''. Refreshing is suspended while object coordinates are being edited
* Improved permission checks for operations in the planned work calendar
* Improved the display of task news
* Fixed fiber color display for fibers with three marks in patching diagrams
* Fixed duplicate serial number/MAC address checks when editing equipment
* Fixed filtering facilities by their custom map icon ''(in some cases)''
* Fixed an error when saving an owner's primary address ''(in some cases)''

== 3.21.65 - 30.09.2026 ==
* Clicking a facility on the additional coverage map in a patching diagram now opens that facility's diagram on the left
* Fixed errors in call statistics generation
* Fixed the print/Excel export view of the equipment list
* Fixed changing facility addresses (in some cases)
* Fixed switching layers on the secondary coverage map in patching diagrams
* Minor bug fixes

== 3.21.64 - 29.09.2026 ==
* Added fiber dragging within a cable line. Hold Ctrl while dragging to change the fiber's position in the cable
* A port color can now be specified for distribution frame ports
* Separated "Show on map" and "Show on map (with dBm signal levels)" in customer list bulk actions
* Fixed task access permission checks when assigning task observers
* Fixed facilities being filtered only by their first owner
* Fixed the building existence check when creating a task from a building card

== 3.21.63 - 28.09.2026 ==
* Added API->vehicle->[[API_vehicle_EN#get_route|get_route]]
* Updated API->tariff->[[API_tariff_EN#edit|edit]]
* Patching diagrams can now display a coverage map with synchronized cable line highlighting
* Multiple patching diagram improvements, including selecting and moving several objects at once
* Added customer sorting by "Signal level (dBm)"
* In a building's logical diagram, PON signal levels outside the allowed range now appear on a red background for the affected customers
* The "Automatically assign customers to ports" scheduler task can now allow reassignment of a new customer's connection when the port has only one MAC address and it belongs to another customer
* The employee's "On login, offer a choice of the following IP phone numbers" dialog now appears on any page after login ''(previously only on the dashboard)''
* Bulk actions for facilities and buildings can now remove all owners at once
* Added the setting "Show the Unit price field when adding inventory items"
* Fixed the "Select all/Deselect all" link affecting filters in lists
* Fixed coverage map tooltips for cable reserves

== 3.21.62 - 25.09.2026 ==
* Added API->[[API_map_EN#delete_poly|delete_poly]]
* Updated API->[[API_map_EN#edit_poly|edit_poly]]
* Updated API->[[API_map_EN#add_poly|add_poly]]
* Improved filtering of customers dependent on device ports
* Fixed changes to tile order in map tile settings
* Fixed building selection when creating a task ''(in some cases)''

== 3.21.61 - 24.09.2026 ==
* Updated API->task->[[API_task_EN#change_state|change_state]]
* Fixed warehouse names appearing incorrectly ''(in some cases)''
* Fixed selection of the required interfaces when finding customers dependent on a device
* Fixed customer equipment selection in the patching menu ''(in some cases)''
* Fixed sending and generating SMS messages ''(in some cases)''
* Minor bug fixes

== 3.21.60 - 23.09.2026 ==
* Updated API->device->[[API_device_EN#get_relation_customers|get_relation_customers]]
* A list of customers dependent on a device now requires specific interfaces to be selected
* Fixed the task automation "Assign the department of the employee who changed the task status as the assignee"
* Fixed opening a facility card in edit mode from the coverage map
* Fixed MAC address matching in equipment cards
* Fixed the loss of the second line segment when dragging the central patching point in a diagram
* Fixed duplicate MAC addresses appearing in inventory item cards ''(in some cases)''
* Fixed exporting patching routes to KML
* Minor bug fixes

== 3.21.59 - 22.09.2026 ==
* Attached files for an object can now be sorted by name, date added, or size. The browser remembers the selected order.
* Fixed sorting in the cable line list ''(in some cases)''
* Fixed the "ONUs not connected to an OLT" report
* Fixed the position of an event or task being lost when moving it in the work schedule calendar
* Fixed saving an address object other than a building in a task card

== 3.21.58 - 21.09.2026 ==
* Added API->chapter->[[API_chapter_EN#page_add|page_add]]
* Added API->chapter->[[API_chapter_EN#page_get|page_get]]
* Added API->chapter->[[API_chapter_EN#page_remove|page_remove]]
* Added import of customer PON data from ABillS billing and use of that data when polling OLTs
* Prevented duplicate objects from being attached to a work order
* Moved the search field to the top of the task assignee selection dialog
* Added cable line card quick actions to the cable line context menu in the patching diagram
* Added quick actions to the cable fiber context menu in the patching diagram
* Added quick actions to the equipment port context menu in the patching diagram
* A task type can now specify a default address ''(town, street, etc.)'' suggested when creating a task of that type
* Building bulk actions can now set a tariff group
* Facility cards now provide a quick way to copy the object name to the clipboard
* Facility activity history now includes related warehouse operations

== 3.21.57 - 20.09.2026 ==
* Updated API->device->[[API_device_EN#set_data|set_data]]
* Added quick action buttons to the splitter port context menu in the patching diagram
* Added statistics to the call list
* Added support for .pbf map tiles
* Improved call list filtering
* The list of customers dependent on a device now skips UPLINK ports
* Fixed an error on the dashboard ''(in some cases)''
* Fixed the attached files block when switching tabs in a customer card
* Improved how notes for all objects are displayed together on the coverage map
* Fixed saving files to a warehouse receipt operation
* Fixed the displayed patching endpoint when hovering over a fiber in the patching diagram ''(in some cases)''
* Fixed filtering the inventory balance report by all inventory item names at once
* Fixed the "Deselect" link in assignee address access settings for task types
* Fixed coverage map buttons when objects were displayed beneath them ''(in some cases)''
* Fixed recipient names in the messages report ''(in some cases)''
* Fixed sorting in the facility and patching diagram lists ''(in some cases)''
* Fixed attaching a customer when adding a task comment
* Fixed the ruler on the coverage map when clicking facilities ''(in some cases)''
* Fixed editing notification profile properties ''(in some cases)''
* Fixed permission checks when viewing or changing files attached to a building
* Fixed exporting the facility list to XLS
* Fixed filtering customers dependent on an object ''(in some cases)''
* Fixed the inventory item list in a facility card
* Fixed expanding the related task list in a customer card
* Fixed the ability to connect a task to an equipment port
* Fixed an error when editing automation chains in task types ''(in some cases)''
* Fixed SFP modules appearing incorrectly in the patching diagram
* Fixed filtering equipment by device port connections
* Fixed attached files for related tasks in a facility card ''(in some cases)''
* Fixed the link to an employee profile from the employee card
* Fixed setting an empty task address
* Fixed focus on the search field when opening the inventory item list

== 3.21.56 - 17.09.2026 ==
* Updated API->task->[[API_task_EN#change_state|change_state]]
* Allow checklists to be filled in by user profiles with the "Change state" access right
* Minor bug fixes

== 3.21.55 - 14.09.2026 ==
* Optimized the global commutation scheme
* Improved address search for customers in global search
* Fixed quick search by exact match ''(with the "!" character)'' in the top panel
* Fixed device reboot/configuration saving
* Fixed the task filter ''(in some cases)''
* Fixed opening cards of commutated objects from the commutation scheme ''(in some cases)''
* Fixed saving the MAC address when receiving inventory items
* Fixed quick search by inventory item in the inventory item selection dialog in tasks ''(in some cases)''
* Fixed paginated customer browsing in the building card
* Fixed quick search by telecom facility name ''(in some cases)''
* Minor bug fixes

== 3.21.54 - 13.09.2026 ==
* Improved the display of objects and hints on the coverage map
* Fixed filling additional fields ''(in some cases)''
* Minor bug fixes

== 3.21.53 - 09.09.2026 ==
* Minor bug fixes

== 3.21.52 - 08.09.2026 ==
* Minor bug fixes

== 3.21.51 - 05.09.2026 ==
* Minor bug fixes

== 3.21.50 - 02.09.2026 ==
* Improved the display of notes for cable line names in quick search results for cable lines
* Fixed saving the note for a warehouse operation when transferring a special inventory item type
* Fixed the display of the building logical scheme ''(in some cases)''
* Fixed selecting a file for an employee's main photo/image ''(in some cases)''
* Fixed employee search in the list by phone number
* Fixed assigning available addresses when creating an employee
* Minor bug fixes

== 3.21.49 - 01.09.2026 ==
* Fixed total grouping of additional field values in the task list
* Fixed unnecessary replacement of characters with HTML entities in customer notes
* Fixed message text generation when sending email ''(in some cases)''
* Minor bug fixes
== 3.21.48 - 31.08.2026 ==
* Added the API->task->[[API_task_EN#show|show]] method
* '''The planned commutation scheme can display the list of actions as text ''(with the option to print it separately and mark completed actions)'''''
* In the communications installation card, coordinates from the device GPS receiver can be pasted when editing coordinates
* Added the ability to create layer/label templates on the map
* Added the "Labels only" button to the commutation scheme. It hides cable-line names and leaves only their label captions.
* Improved customer search by phone numbers in the call list
* Fixed operation of custom fields with the "Attached files" type when completing a task
* Fixed rights checking when searching for a MAC address in global search
* Fixed inventory number display in the inventory item card ''(in some cases)''

== 3.21.47 - 29.08.2026 ==
* When a parent task is specified in the task card, the system now immediately checks whether that task exists and whether the employee has access to it. If access is available, a link to the parent task is shown at once.
* Fixed commutation break in the planned commutation scheme ''(in some cases)''
* Fixed an error when opening the cable color schemes section ''(in some cases)''
* Fixed customer search by IP subnet
* Fixed building display on the map ''(in some cases)''
* Fixed rights checking when creating a child task
* Fixed unnecessary searching through dismissed employees
* Fixed customer search by phone numbers that start with "+"
* Fixed sorting of building numbers in the selection selector
* Fixed note display on cable-line fibers in the commutation scheme ''(in some cases)''

== 3.21.46 - 28.08.2026 ==
* Fixed saving access rights for tasks ''(in some cases)''
* Fixed clickable navigation by apartment number in the customer list for a building
* Fixed the inventory item merge dialog
* Fixed display of several customers in the call list when the phone number matches
* Fixed inability to reply to a task comment ''(in some cases)''
* Minor bug fixes

== 3.21.45 - 27.08.2026 ==
* Fixed customer search in quick search ''(in some cases)''
* Fixed an error when viewing the logical building scheme ''(in some cases)''
* Minor bug fixes

== 3.21.44 - 26.08.2026 ==
* Added the setting "When moving to the next commutation scheme, center the scheme on the cable line from which the transition was made"
* The ONU/inventory item/customer card now shows a separate badge indicating whether the ONU is currently ONLINE or OFFLINE
* Fixed display of custom-field values with object names in task lists and other lists

== 3.21.43 - 25.08.2026 ==
* Fixed an error when changing a task status ''(in some cases)''
* Fixed an error when building a commutation route ''(in some cases)''
* Fixed customer filtering in the call list
* Minor bug fixes

== 3.21.42 - 24.08.2026 ==
* [[Import buildings from KAIS (BG)]]
* When moving from the planned commutation scheme to the scheme of a neighboring communications installation ''(the opposite object on the cable line)'', the scheme now opens immediately in split current/planned mode. If the planned scheme does not exist yet, the system offers to create it.
* Right-clicking splitter ports in the commutation scheme now opens the port context menu
* When adding a VLAN manually on equipment, a selector with that equipment's ports is shown
* Improved automatic building of U-shaped commutation routes in the commutation scheme
* In task status settings, the inventory item selection can now specify where the selected inventory items should be transferred ''(Customer/Task)'' and to which subaccount
* Added the ability to change adapter types for ports of sandbox splitters in the planned commutation scheme
* Added the ability to mass-commutate fibers/ports in the planned commutation scheme
* Changing the pigtail type for ports/fibers in the planned commutation scheme is now saved only there and does not affect the current commutation scheme
* When a split page with current/planned commutation schemes is displayed, both schemes can be exported to SVG with different export settings
* Fixed inaccuracies in SVG commutation scheme generation
* Fixed adding local UNC links in the WYSIWYG editor
* Fixed errors when sending email notifications ''(in some cases)''
* Fixed moving the commutation scheme position on the global commutation scheme ''(in some cases)''
== 3.21.41 - 21.08.2026 ==
* Optimized display of pop-up hints on the coverage map
* Fixed changing the number of adapters during hot splitter replacement
* Fixed SVG files display in the attached-file gallery ''(in some cases)''
* Fixed an error when viewing a commutation route point on the coverage map
* Fixed an error when opening an equipment card from a task card ''(in some cases)''
* Fixed route changes on the map for cable routes
* Fixed employees being shown as dismissed in selectors ''(in some cases)''
* Fixed object scaling on the map ''(in some cases)''
* Fixed notes display in the customer list
* Fixed ping for an arbitrary IP address
* Minor bug fixes

== 3.21.40 - 17.08.2026 ==
* In the planned commutation scheme, cable lines can now be added from the context menu, including lines with capacities of 12 and 48
* A separate "Comments" right has been added for task types
* For equipment, a list of dependent customers can now be built for specific required ports
* The hot splitter replacement dialog has been redesigned: a splitter can now be selected from all available warehouses
* In the commutation scheme, the workspace boundary is now draggable, allowing the commutation-scheme field size to be changed quickly
* The commutation scheme now supports quickly commutating N fibers/ports of devices with each other ''(starting from the current one, with the existing commutation broken)''
* Fixed duplicate employee display in the department employee list ''(in some cases)''
* Fixed table entries display according to each employee's own setting for the number of records in a table
* Fixed loading the list of automatic executors for tasks ''(in some cases)''
* Minor bug fixes

== 3.21.39 - 14.08.2026 ==
* Improved the appearance of pop-up comments in the task list
* Fixed equipment port selection when switching a busy port
* Minor bug fixes

== 3.21.38 - 13.08.2026 ==
* Fixed attaching files in additional fields for new objects
* Minor bug fixes

== 3.21.37 - 12.08.2026 ==
* Minor bug fixes

== 3.21.36 - 09.08.2026 ==
* Added "sandbox" functions to the planned commutation scheme: cable lines and splitters can be created without binding them to real objects. Existing objects can be hidden. Additional display buttons were added.
* Added the transport archive
* Added the new "Department. Exclude with all its employees" action to task-type action chains
* Added the "Hide the working note by addresses in this task type" property to task-type settings

== 3.21.35 - 08.08.2026 ==
* Minor bug fixes

== 3.21.34 - 07.08.2026 ==
* For a communications installation type, a hotkey can now be configured for quickly adding an object of that type to the map
* Added a context menu to the commutation scheme, allowing a planned splitter of the required type to be added quickly
* Right-clicking an object in the commutation scheme now immediately opens its context menu
* Fixed editing CWDM parameters in the product catalog
* Fixed splitting available inventory items for an employee profile that has access only to its own accountability balance

== 3.21.33 - 06.08.2026 ==
* The commutation scheme can now be split into two panes to show the current and planned schemes. The planned scheme also now supports changing object positions, port direction, and alternative cable entries
* Added the ability to bulk-select objects lower in the list in group actions for object lists
* Fixed some migration errors

== 3.21.32 - 05.08.2026 ==
* When adding a cable line from the coverage map through several intermediate communications installations, it is now possible to mark exactly which intermediate installations should split the line and whether commutation between those segments should be preserved
* Fixed partial information copying in the device list ''(in some cases)''
* Fixed an error during bulk receipt of inventory items ''(in some cases)''
* Fixed color assignment for any splitter port
* Fixed displaying information about unfinished current tasks in the customer card
* Fixed employee selector operation ''(in some cases)''

== 3.21.31 - 02.08.2026 ==
* Added printing of the entire global commutation scheme
* Cable lines can now be created from the map through all intermediate communications installations at once ''(not only from the start object to the end object)''
* Added an exclusion by label/custom-field value on the customer for SMS mailings
* Added the ability to change the route of planned commutation in the planned commutation scheme
* Labels can now be assigned separately to legal-entity customers, individual customers, and/or potential customers
* The incoming-call pop-up can be shown at the top/bottom and left/center/right. It can also be configured to show customer notes
* The logical building scheme can now define the structure of each entrance separately
* Fixed task filtering after group actions with tasks are completed
* Fixed file attachment when changing a task status
* Fixed IP-address search in the switch list ''(in some cases)''

== 3.21.30 - 31.07.2026 ==
* The building card can now use arbitrary entrance numbering ''(including text entrance names)''
* Added a coordinate editing link to the polygon card
* Added filtering by customer presence to the message list, plus a group action to assign/remove a label on customers from those messages
* Added the ability to hide customers and commutations to them in the logical building scheme
* Added filtering by inventory item name/category to the inventory balance report
* The customer card now supports entering coordinates manually in edit mode or changing them on the map
* Access rights by employee profile can now be assigned to a label
* Fixed an error when viewing customer history ''(in some cases)''

== 3.21.29 - 30.07.2026 ==
* Added the new "Manage own accountability balance" right to employee profiles
* For each task type, the labels used in tasks of that type can now be configured
* A customer category can now be selected for a task type ''("Legal entities", "Individuals")''
* Added sorting by various fields to the work statement
* Fixed mentioning employees in task comments
* Fixed adding a cable route from the coverage map
* Fixed an error when excluding a level in the logical building scheme ''(in some cases)''

== 3.21.28 - 29.07.2026 ==
* Added filtering by custom-field value to the inventory item list
* Each employee can now configure main-page auto-refresh for themselves
* Fixed an error in the "Today's task list" main-page widget
* Fixed selecting inventory items to add to an operation
* Fixed correct opening of a customer card in the logical building scheme
* Fixed commutation break without reloading the page in the commutation scheme
* Fixed the address-object selector for employees with restricted address rights

== 3.21.27 - 28.07.2026 ==
* Added the new "Warehouse - Reports" right for employee profiles
* For each communications installation type, the display of its number/name on the map can now be enabled or disabled separately, and a number/name generation template can be configured
* Added the new "Distribution frame/ODF" custom-field type
* Added KML export for connection-route calculation results
* Added configurable "Cable color schemes". They can be used freely to change cable-line coloring.
* For a cable line, conductor coloring can be copied from other cable lines present in the communications installations where this cable line ends.
* Fixed opening a specific inventory item card by its ID from the left menu
* Fixed polygon color display on the coverage map ''(in some cases)''
* Fixed display of multi-line labels on the coverage map
* Fixed an error when opening a rack/cabinet card ''(in some cases)''

== 3.21.26 - 27.07.2026 ==
* Added the ability to plan commutation breaks in planning mode in the commutation scheme
* Added the "Nominal and SNMP equipment name" report to "Switches"
* Employee profiles can now configure which categories an employee is allowed to move inventory items to
* The right to view written-off inventory items was separated for employee profiles ''(previously viewing and editing were together)''
* Added the "Customer. Creation" action to task chains/automation
* Splitter ports can now have colors assigned
* In the ONU-by-device list, the interface-name filter can now select several device interfaces at once
* Several customers can now be added at once when editing a task
* Added the ability to create a copy of the current task from the task card
* Fixed equipment selection for hot device replacement

== 3.21.25 - 25.07.2026 ==
* If a task chain/automation is configured for a task status change, this information is shown in the tooltip on the task status
* Improved processing of phone numbers in task-card custom fields to match the required system format
* Added the "Commutation scheme. Label color" parameter for cable brands in the cable catalog
* Changes to a customer's custom coordinates are recorded in the action history
* Fixed access-right checks when viewing attached files for a customer
* Fixed sending employee notifications about equipment unavailability/activity ''(in some cases)''

== 3.21.24 - 24.07.2026 ==
* When the login page is opened by an already authenticated user, the system home page opens
* The inventory list can visually group inventory items by name ''(combine several inventory items into one group to quickly understand the quantity of items with that name on an object)''
* Improved color highlighting for planned cable lines
* Fixed access checks for address objects ''(in some cases)''

== 3.21.23 - 23.07.2026 ==
* Added progress display for communications installation import
* Fixed saving chat_id for an employee ''(in some cases)''
* Fixed displaying notes in customer history

== 3.21.22 - 22.07.2026 ==
* Map labels are shown with a white halo for better readability
* Fixed an error when viewing employee action history ''(in some cases)''
* Fixed inability to remove linked objects from a task ''(in some cases)''
* Fixed sorting of linked tasks in the task card

== 3.21.21 - 21.07.2026 ==
* '''Added SVG export for the global commutation scheme'''
* Documents can now be generated from an inventory item card for that item
* Fixed an error when opening an inventory operation ''(in some cases)''
* Fixed editing access parameters for system devices
* Fixed commutation to system device ports
* Fixed display of the interface/stacking list for a device ''(in some cases)''
* Fixed floor deletion in the building structure

== 3.21.20 - 20.07.2026 ==
* Added address object search to the employee address-access assignment dialog
* Added quick note-clear buttons for distribution frame/ODF ports in the commutation scheme
* Minor bug fixes

== 3.21.19 - 18.07.2026 ==
* Added the "Allow matching object numbers for different settlements" property for communications installation types
* Added a setting for address unit types that defines which parent address units they can be added under ''(for example, "streets" only under "cities", and so on)''
* Editing access for address object types can now be configured by employee profiles
* Improved display of always-full employee names in the employee list
* Fixed multiplexer operations on the commutation scheme
* Fixed display of a newly added cable line type in the left menu

== 3.21.18 - 17.07.2026 ==
* Customer icons on the coverage map are shown with an outline color that matches the customer's label color
* Added filtering by the value of a custom field on the task address to the task list
* Minor bug fixes

== 3.21.17 - 16.07.2026 ==
* '''Equipment can now be installed on a building ''(previously only on a communications installation or customer)'''''
* '''A cable line can now start at a customer or building ''(previously only at a communications installation)'''''
* Added the "Total subscription fee" field to the customer list, with filtering support
* Fixed an error when viewing cable-fiber commutation history ''(in some cases)''
* Fixed saving the selected type group for communications installation type properties
* Fixed cable brand search when adding a cable line ''(in some cases)''

== 3.21.16 - 15.07.2026 ==
* '''Distribution frames/ODFs and splitters can now be installed at customers or on buildings'''
* Added a selector with existing OLT PON interfaces to interface filtering in the ONU-by-OLT list
* Fixed operations in the planned commutation scheme
* Fixed personnel sorting by department in the department list
* Fixed adding inventory with an IP/MAC address
* Fixed display of cable-fiber history

== 3.21.15 - 14.07.2026 ==
* Task types can now be limited to customers from specific groups
* Added the ability to send messages to all company employees with an optional deletion date
* Fixed the department card appearance during editing
* Fixed rebuilding child schemes when dragging a commutation scheme on the global scheme
* Fixed the "When changing the building polygon, display other objects on the map" parameter ''(in some cases)''
* Fixed inability to select a building when creating a new task

== 3.21.14 - 13.07.2026 ==
* '''Added the ability to link inventory items to a task ''(such as equipment, customer, and so on)'' without transferring the items to the task itself. This is used to track completion of tasks related to inventory items.'''
* Added a new "Inventory movement" report to inventory reports
* Building list filtering now supports filtering by the presence or absence of a communications installation on the building
* Added a new employee profile right: "Settings - Task statuses"
* Work calendar filters now let users configure their own order and visibility of departments and employees in the calendar
* Reworked the department list section. The appearance was changed, and quick search by employee/department was added
* When creating a new building in the address selection block, the new address is inserted immediately without reloading the current page
* Search results in the address selection block now show buildings and other address object types, making it faster to add new buildings, streets, and similar objects
* Improved the task card appearance on mobile devices
* Fixed coverage map performance when displaying the "Employees and vehicles" layer
* Fixed filtering in the building list ''(in some cases)''
* Fixed PDF file preview in the browser ''(in some cases)''
* Fixed filtering in the debtor customer list
* Fixed display of the "Settings-Addresses" section for employees with geography-limited access
* Fixed fiber rendering on the commutation scheme when a fiber has a label
* Fixed an error when displaying current-day tasks in the work calendar ''(in some cases)''

== 3.21.13 - 10.07.2026 ==
* '''When receiving inventory, multiple different inventory item names can now be specified at once'''
* Improved display of completed tasks in the calendar
* In the commutation scheme, splitters and distribution frames now have action buttons in object menus, as in the object cards ''(edit, delete, structural scheme, and so on)''
* Fixed commutation in the commutation scheme ''(in some cases)''
* Fixed duplicate requests during automatic ONU signal level refresh when opening an ONU card
* Fixed the task history appearance
* Fixed editing coverage map settings ''(in some cases)''
* Fixed object selection on the global commutation scheme ''(in some cases)''
* Fixed access-right checks for the ONU list for employees
* Fixed the rack/cabinet card appearance in the dark interface theme

== 3.21.12 - 09.07.2026 ==
* Improved API->[[API_redirect_EN|redirect]] method
* When splitting inventory into several parts, attached files are linked to all resulting inventory items
* Improved the cable line add dialog opened from a communications installation
* Added the setting parameter "Display completed tasks with opacity (%)"
* Fixed the "Display completed tasks in gray" setting parameter
* Fixed display of the MAC address field when receiving inventory
* Fixed additional field dependency handling
* Fixed attached-file handling in vehicle operations
* Fixed navigation to communications installation table field settings
* Fixed task information appearance on the "Technical support" tab in the customer card
* Fixed errors when viewing user action history ''(in some cases)''
* Fixed an error when opening the inventory selection dialog for integration
* Fixed moving object positions on the global commutation scheme
* Fixed reserve specification for cable lines
* Fixed an error when receiving inventory and auto-assigning inventory numbers ''(in some cases)''
* Fixed employee access settings for addresses

== 3.21.11 - 08.07.2026 ==
* Fixed the appearance of the task type rights settings table
* Fixed changing the position of a separate communications installation commutation scheme on the shared global commutation scheme
* Fixed task filtering in the "My tasks" section ''(in some cases)''
* Fixed changing address object coordinates from the building card
* Fixed assignee sorting when creating a task
* Fixed changing sector coordinates for radio equipment
* Fixed access-right checks when opening a device card ''(in some cases)''
* Fixed hiding/showing a communications installation on the coverage map

== 3.21.10 - 07.07.2026 ==
* Added API->call->[[API_call_EN#edit|edit]] method
* Added new user profile rights "Owners (access to financial information)" and "Tenants (access to financial information)"
* '''Implemented inventory transfer to an employee with employee confirmation of receipt/refusal'''
* In group actions for communications installations, creating a common task or separate tasks now creates tasks through the standard task-add dialog
* Fixed marking a task as read in news when opening the task card
* Fixed display of the latest inventory operation date in the list of inventory by object
* Fixed document print generation from the task card
* Fixed commutation of free cable fibers to each other ''(in some cases)''
* Fixed editing coordinates for a communication line
* Fixed display of stray artifacts on the global commutation scheme ''(in some cases)''
== 3.21.9 - 06.07.2026 ==
* SMS mailing exclusions can now exclude customers with a specific period of negative balance
* The "Problem buildings/customers" statistics can now use custom filters
* In task type settings, the additional fields section now separately specifies the additional field types that can be used when changing task status. Task status settings also now include the "Display additional fields" property
* Added the ability to automatically create a work task for unanswered phone calls
* User password changes were moved to a separate dialog window

== 3.21.8 - 04.07.2026 ==
* Improved API method API->customer->[[API_customer_EN#get_customers_id|get_customers_id]]
* Improved the appearance of tasks in the work calendar
* In group actions for customers, task creation now uses a full dialog for specifying properties of the tasks being created
* Optimized the structural scheme
* Fixed setting conditions in SMS mailings ''(in some cases)''
* Fixed setting custom coordinates for a customer
* Fixed saving a system device
* Fixed object display on the global commutation scheme ''(in some cases)''
* Fixed commutating a cable line to a device in the customer's commutation scheme
* Fixed changing custom coordinates for equipment
* Fixed the tariff exclusion filter in SMS mailings

== 3.21.7 - 03.07.2026 ==
* Planning mode in the work calendar
* Fixed search in the communications installation list ''(in some cases)''
* Fixed attached-file display in a communications installation card when the user has read-only rights
* Fixed viewing/creating SMS mailings ''(in some cases)''
* Fixed signal level display for ONU ''(in some cases)''
* Fixed attenuation display on the structural scheme for OLT ''(in some cases)''
* Fixed an error when viewing employee history ''(in some cases)''
* Fixed incorrect activity date output in the coverage map tooltip for transport
* Fixed the ability to exclude a customer from a task

== 3.21.6 - 02.07.2026 ==
* Added IP address usage history
* Improved use of the ruler on the coverage map
* Fixed cable line appearance on the coverage map according to tag settings ''(in some cases)''
* Fixed the equipment list in the "Inactive switches" home-page widget
* Fixed adding new communications installation schemes to the global commutation scheme
* Fixed equipment database search when adding an inventory item name to the product catalog
* Fixed clearing equipment port commutation ''(in some cases)''
* Fixed an error in the inventory balance report ''(in some cases)''
* Fixed specifying custom reserves/objects on a cable line route
* Fixed switching commutation to a port of another device on a communications installation
* Fixed object display on the coverage map in group operations for communications installations
* Fixed changing the commutation path in the commutation scheme ''(in some cases)''

== 3.21.5 - 01.07.2026 ==
* Added notifications when editing a task ''(configurable)''
* Improved collecting information from ONU interfaces
* Improved equipment port appearance for the dark theme
* Task types can now specify actions with inventory: transfer the required inventory currently assigned to a customer from that customer to the selected warehouse
* Fixed quick search by the required equipment category in the equipment list
* Fixed selection of other devices on the same communications installation in the port switching dialog
* Fixed display of warehouses available to an employee ''(in some cases)''
* Fixed an error when viewing an inventory item card ''(in some cases)''
* Fixed automatic building selection when adding a communications installation from a building card
* Fixed viewing the list of polled devices in the usm_observer module
* Fixed the ability to change the color of a connection between devices in the commutation scheme

== 3.21.4 - 30.06.2026 ==
* Improved API method API->attach->[[API_attach_EN#upload|upload]]
* Added a separate email notification profile for sending messages to corporate customers
* Improved sorting by building in the communications installation list
* The work calendar opens on the current date
* Improved the task calendar for cases where several tasks are scheduled for the same time
* Implemented multilevel task type groups
* Task news can now partially mark events as read and group news by task
* Task automation can now send Email messages to customers ''(using configurable templates)''
* Improved popup notification output when assigning an employee department to a task
* Fixed attached-file block display in custom sections when the user has read-only rights
* Fixed opening a customer card from the coverage map
* Fixed an error when configuring status availability for employee profiles in a task type card
* Fixed filtering by dates in the task list ''(in some cases)''
* Fixed task author display in the task list
* Fixed display of the "Notes" field in the communications installation card
* Fixed an error when trying to delete an address object ''(in some cases)''
* Fixed the ability to disable/enable a device port
* Fixed viewing global commutation schemes ''(in some cases)''

== 3.21.3 - 28.06.2026 ==
* Improved API method API->inventory->[[API_inventory_EN#transfer_inventory|transfer_inventory]]
* Improved API method API->commutation->[[API_commutation_EN#delete|commutation]]
* Improved API method API->node->[[API_node_EN#get|get]]
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* The scheduler task "Send low-stock information" can now specify the delivery options "E-mail/Messenger"; the employee card also now lets you specify delivery options for this mailing in the "Notifications" section
* The inventory list in the task card can now transfer all inventory items to the selected recipient at once
* Quick value search was added to custom fields of the "List selection" type
* Improved the use of explicitly specified coordinates when editing a building card and selecting a polygon/point
* Fixed creating cable lines to a building from the coverage map
* Fixed an error when opening Settings - Modules ''(in some cases)''
* Fixed grouping in the task list ''(in some cases)''
* Fixed deleting a label from the switching scheme
* Fixed the "Show dismissed employees in selectors/search for N days after dismissal" parameter
* Fixed warehouse availability checks when selecting inventory items during task execution
* Fixed the "Show tasks by actual completion date" variable
* Fixed using task-type appearance color settings in the calendar
* Fixed coverage-map search ''(substituting the current locality in the search window)''
* Fixed navigation from a customer card to the map with the customer's building coordinates
* Fixed saving interfaces/stacking in the device card

== 3.21.2 - 26.06.2026 ==
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* When transferring inventory from a customer card, the sub-account receiving the inventory can now be selected
* When creating/editing a task for a building, information about building tags and the building note is shown
* When creating a task in a chain, a specific custom assignee/department can be specified separately
* Bulk inventory transfer now creates combined transfer operations instead of separate operations for each item
* The task list filter-result grouping now has a "Completion date (month)" option
* Fixed an error when creating a task ''(in some cases)''
* Fixed changing coordinates in building, communications installation, and customer cards ''(in some cases)''
* Fixed generation of communications-installation names when selecting a building floor ''(in some cases)''
* Fixed link handling in text values of custom fields
* Fixed assigning assignees when creating a task ''(in some cases)''

== 3.21.1 - 25.06.2026 ==
* Improved map centering when editing a polygon/building on the coverage map
* Fixed displaying global switching schemes ''(in some cases)''
* Fixed exporting the cable line list to XLS ''(in some cases)''
* Fixed correct rendering of customers on the building logical scheme ''(in some cases)''
* Fixed selecting parent objects when adding a building from the coverage map
* Fixed attaching a customer when adding a new task for a customer
* Fixed minor bugs

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

API vehicle UK

2026-11-12T09:37:52Z

IronBot: [IronBot] Sync UK localization from RU

[[API_vehicle_EN|en]] | '''uk''' | [[API vehicle|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Автотранспорт

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====

''Додано у: 3.20.10''

Опис: Додавання
Обов'язкові параметри:
brand - марка
Додаткові параметри:
model - модель
reg_number - реєстраційний номер
imei - IMEI трекера

==== delete ====

''Додано у: 3.20.10''

Опис: Видалення
Обов'язкові параметри:
id - ID транспорту

==== edit ====

''Додано у: 3.20.10''

Опис: Редагування
Обов'язкові параметри:
id - ID транспорту
Додаткові параметри:
brand - марка
model - модель
reg_number - реєстраційний номер
imei - IMEI трекера

==== get ====
''Додано у: 3.13.73''

Опис: Список транспорту
Необов'язкові параметри:
id - ID транспорту ''(можна через кому)''

==== get_route ====
''Додано у: 3.21.63''

Опис: Маршрут руху транспорту
Обов'язкові параметри:
id - ID транспорту
date_start - дата початку
date_finish - дата закінчення
Необов'язкові параметри:
is_compact - прапорець — компактний режим ''(лише підсумкові значення)''

API vehicle EN

2026-11-12T09:37:50Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_vehicle_UK|uk]] | [[API vehicle|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Motor transport

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== get ====
''Added in: 3.13.73''
Description: Transport list
Optional parameters:
id - id of transport ''(can be comma separated)''

==== add ====

''Added in: 3.20.10''

Description: Add
Required parameters:
brand - brand
Additional parameters:
model - model
reg_number - registration number
imei - tracker IMEI

==== delete ====

''Added in: 3.20.10''

Description: Delete
Required parameters:
id - vehicle ID

==== edit ====

''Added in: 3.20.10''

Description: Edit
Required parameters:
id - vehicle ID
Additional parameters:
brand - brand
model - model
reg_number - registration number
imei - tracker IMEI

==== get_route ====
''Added in: 3.21.63''

Description: Vehicle route
Required parameters:
id - vehicle ID
date_start - start date
date_finish - end date
Optional parameters:
is_compact - flag - compact mode ''(summary values only)''

API task EN

2026-09-25T14:54:14Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [[API_task_UK|uk]] | [[API task|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Working with tasks

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====
''Updated in: 3.19.30 (added is_high_priority parameter)''

''Updated in: 3.18.43 (added device_id parameter)''

''Modified in: 3.18.29 (added deadline_hour parameter)''

''Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)''

''Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)''

''Modified in: 3.12.84 (added parent_task_id parameter)''

''Modified in: 3.12.38 (added unit_id, division_id parameters)''

''Modified in: 3.12.26 (added work_amount parameter)''

''Modified in: 3.12beta31 (added author_operator_id parameter)''

Description: Task creation

Required parameters:
work_typer - task TYPE ID

Optional parameters:
apart - flat number
address_id - ''(for version 3.13 and later)'' address unit id
author_employee_id - ID of the employee author of the task
author_operator_id - task author operator ID ''(before version 3.16dev2)''
citycode - ''(for version 3.12 and earlier)'' location id. If not specified, it is taken from housecode data.
customer_id - ''(for version 3.17 and later)'' customer ID
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
device_id - equipment ID
division_id - division ID ''(multiple values separated by commas are allowed)''
dopf_N - value of additional field for field ID N
employee_id - employee ID ''(several values separated by commas are allowed)''
fio - client full name ''(the client is not yet a customer)''
housecode - ''(for version 3.12 and earlier)'' building id. If not specified, it is taken from customer data - customer_id, or from infrastructure facility data - node_id
is_high_priority - flag - high priority
node_id - ''(for version 3.17 and later)'' infrastructure facility ID
opis - task notes
parent_task_id - ID of parent task
unit_id - executor ID ''(multiple values separated by commas are allowed) (before version 3.16dev2)''
usercode - ''(for version 3.16 and earlier)'' customer ID
uzelcode - ''(for version 3.16 and earlier)'' infrastructure facility ID
work_amount - scope of work
work_datedo - date on which the task is scheduled to run

==== add_customer_to_task ====
''Added in: 3.13.70''

Description: Add a customer to a task

Required parameters:
task_id - task id
customer_id - id of customer

==== add_device_to_task ====
''Added in: 3.19beta1''

Description: Add equipment to a task

Required parameters:
task_id - task id
device_id - equipment id

==== add_node_to_task ====
''Added in: 3.20.17''

Description: Add an infrastructure facility to a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== change_date_work ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.12.83''

Description: Change the date and time of the task ''(date on which the work is scheduled)''

Required parameters:
id - id of the task
value - date
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== change_state ====
''Updated in: 3.21.61 (added is_ignore_required_comment parameter)''

''Updated in: 3.21.56 (added comment parameter)''

''Updated in: 3.20.3 (added date_hold parameter)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

Description: Change task state (status)

Required parameters:
id - id of the task
state_id - task state id
Optional parameters:
employee_id - id of the employee on whose behalf to change the state
operator_id - id of the operator on whose behalf to change the state ''(before version 3.16dev2)''
comment - comment ''(required when the task status setting "Comment required" is enabled)''
date_hold - date/time until which to postpone the task ''(when moving to a state with the role Postponed)''
is_ignore_required_comment - flag - skip the required comment check

==== check_verify_code ====
Description: Checks the verification code to perform the request

Required parameters:
id - task ID
verify_code - verification code

==== checklist_item_check ====
''Added in: 3.17dev1''

Description: Marks a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id
employee_id - id of the employee on whose behalf the item is marked

==== checklist_item_uncheck ====
''Added in: 3.17dev1''

Description: Clear a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id

==== comment_add ====
''Modified in: 3.17dev1 (added dateadd parameter)''

''Modified in: 3.16.19 (added reply_comment_id parameter)''

''Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)''

''Modified in: 3.12.89 (added author_operator_id parameter)''

Description: Add comment

Required parameters:
id - task ID
comment - text
Optional parameters:
dateadd - date-time of the comment
employee_id - id of the employee on whose behalf the comment is made
operator_id - id of the operator on whose behalf the comment is added ''(before version 3.16dev2)''
reply_comment_id - id of the comment we are replying to

==== comment_edit ====

''Added in: 3.18beta1''

Description: Edit comment

Required parameters:
id - comment ID
task_id - task ID
body - text

==== delete ====
''Added in: 3.14.35''

Description: Delete a task

Required parameters:
id - id of the task

==== division_add ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Add a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== division_delete ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Remove a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== edit ====
''Updated in: 3.20.23 (added customer_name parameter)''

''Updated in: 3.19.41 (added author_employee_id parameter)''

''Updated in: 3.19.30 (added is_high_priority parameter)''

''Updated in: 3.19.15 (added job_time_hour parameter)''

''Updated in: 3.19.12 (added apartment parameter)''

''Modified in: 3.18.30 (added deadline_hour parameter)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added type_id parameter)''

''Modified in: 3.15.12 (added parent_task_id parameter)''

''Added in: 3.13.18''
Description: Task modification

Required parameters:
id - task id
Optional parameters:
address_id - id of the address unit
apartment - apartment number
author_employee_id - id of the employee who authored the task
customer_name - arbitrary customer name/title ''(without binding to a customer)''
body - text of the task ''(descriptive part)''
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
is_high_priority - flag - high priority
job_time_hour - time to complete the task ''(from the start of work. In hours)''
parent_task_id - id of parent task
type_id - id of the task type

==== employee_add ====
''Added in: 3.16dev2''
Description: Add an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== employee_delete ====
''Added in: 3.16dev2''
Description: Remove an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== get_allow_staff ====
''Added in: 3.15.23''
Description: List of performers and divisions that are available for assignment to a task ''(according to settings)''

Required parameters:
id - task id

==== get_catalog_type ====
''Added in: 3.12.22''
Description: Task types

Optional parameters:
id - task type id ''(can be comma separated)''

==== get_catalog_type_group ====
''Added in: 3.16dev3''
Description: Task type groups

==== get_catalog_state ====
''Updated in: 3.19.1 (added type_id parameter)''

''Added in: 3.12.22''
Description: Task state classifier

Optional parameters:
type_id - task type id
state_id - state id ''(can be comma separated)''

==== get_comment ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.14.67 (added id parameter)''

''Modified in: 3.14.53 (added operator_id parameter)''

''Modified in: 3.13.50 (added date_add_from and date_add_to parameters)''

''Added in: 3.12.75''
Description: Comments

Optional parameters ''(but there must be at least one)'':
id - id of comment ''(can be comma separated)''
task_id - task id ''(can be comma separated)''
date_add_from - comment creation date ''(from)''
date_add_to - comment creation date ''(to)''
employee_id - id of the employee-author of the comment
operator_id - id of the operator who authored the comment ''(before version 3.16dev2)''

==== get_list ====
''Updated in: 3.18.43 (added device_id parameter)''

''Updated in: 3.18.40 (added apart parameter)''

''Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)''

''Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''

''Modified in: 3.15.23 (added is_expired parameter)''

''Modified in: 3.14.71 (added node_id parameter)''

''Modified in: 3.14.62 (added closer_operator_id parameter)''

''Modified in: 3.14.56 (added division_id_with_staff parameter)''

''Modified in: 3.14.41 (added possible value -1 to staff_id parameter)''

''Modified in: 3.13.29 (added date_change_from, date_change_to parameters)''

''Modified in: 3.13.28 (added date_change to order_by parameter)''

''Modified in: 3.12.91 (added watcher_id parameter)''

''Modified at: 3.12.83 (added author_id parameter)''

''Modified at: 3.12.78 (added order_by, limit, offset parameters)''

''Modified at: 3.12.62 (added customer_id parameter)''

''Modified in: 3.12.24 (added date_do_from, date_do_to parameters)''

''Modified in: 3.12beta29 (added house_id parameter)''
Description: List of tasks (identifiers)

Optional parameters (sampling conditions):
address_id - ID of the address object ''(can be comma separated)''
apart - apartment/premises number
author_id - ID of the operator who authored the task ''(comma separated) (before version 3.16dev2)''
author_employee_id - ID of the employee who authored the task ''(can be comma separated)''
change_employee_id - ID of the employee - author of the task changes
change_operation_type - type of actions to change the task ''(possible values: add_comment, change_state)''
closer_employee_id - ID of the employee who closed ''(completed)'' the task ''(can be comma separated)''
closer_operator_id - ID of the operator who closed ''(completed)'' the task ''(can be comma separated) (before version 3.16dev2)''
customer_id - customer ID ''(can be comma separated)''
date_add_from - task creation date (from)
date_add_to - task creation date (to)
date_change_from - task update date (from)
date_change_to - task update date (to)
date_do_from - date on which the task is scheduled to be executed (from)
date_do_to - date on which the task is scheduled to be executed (to)
date_finish_from - date on which the task is executed (from)
date_finish_to - date on which the task is executed (to)
device_id - equipment ID ''(can be comma separated)''
division_id - division ID ''(can be comma separated)''
division_id_with_staff - division ID ''(including tasks of employees of this division) (can be comma separated)''
employee_id - employee ID ''(can be comma separated, use -1 to get tasks without employees)''
house_id - building ID
is_expired - flag - output only expired tasks
node_id - ID of the location object
staff_id - executor ID ''(can be comma separated, use -1 to get tasks without executors) (before version 3.16dev2)''
state_id - task status ID ''(can be comma separated)''
task_position - task coordinates ''(where possible. In lat,lng format. e.g. 40.245218,52.333384)''
task_position_radius - radius from task_position ''(in meters)''
type_id - task type ID ''(can be comma separated)''
watcher_id - task observer operator ID ''(comma separated) (before version 3.16dev2)''
watcher_employee_id - ID of the task observer employee ''(comma separated)''
order_by - sorting field ''(possible variants: date_add, date_change, date_do, date_finish, state_id, type_id)''
limit - record sampling limit
offset - sampling offset

==== get_related_task_id====
Description: List of related tasks to the current task (identifiers)

Required parameters:
id - task ID

==== get_typical_comments ====
''Added in: 3.14.70''

Description: Get list of typical comments

==== remove_customer_from_task ====
''Added in: 3.15.23''

Description: Remove a customer from a task

Required parameters:
task_id - task id
customer_id - customer id

==== remove_node_from_task ====
''Added in: 3.20.17''

Description: Remove an infrastructure facility from a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== set_rate ====
''Added in: 3.12.63''
Description: Set an individual rate ''(for employees)'' for the task

Required parameters:
task_id - task ID
rate - rate

==== show ====
''Modified in: 3.21.48 (added is_without_history, is_without_attaches, is_without_task_statuses_history, is_without_views_history parameters)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.13.29 (the id parameter can be a comma separated list)''

''Modified in: 3.13.25 (added is_without_comments parameter)''

''Modified in: 3.12.64 (added operator_id parameter)''

Description: Information about the task

Required parameters:
id - task id ''(can be comma separated)''
Optional parameters:
employee_id - id of the employee who is viewing this task ''(to be recorded in the task history)''
is_without_attaches - flag - do not display attached files
is_without_comments - flag - do not display comments in the task information
is_without_history - flag - do not display action history
is_without_task_statuses_history - flag - do not display status-change history
is_without_views_history - flag - do not display view history
operator_id - id of the operator who is viewing this task ''(to be recorded in the task history) (before version 3.16dev2)''

==== (*) staff_add ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_add|employee_add]])''

''Added in: 3.12.83''

Description: Add an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== (*) staff_delete ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_delete|employee_delete]])''

''Added in: 3.12.83''

Description: Remove an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== watcher_add ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Add observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== watcher_delete ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Remove an observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== add_cable_line_to_task ====
''Added in: 3.20.2''

Description: Add a cable line to a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== add_owner_to_task ====
''Added in: 3.19.19''

Description: Add an owner to a task

Required parameters:
task_id - task id
owner_id - owner id

==== mark_add ====
''Added in: 3.19.24''
Description: Add a mark to a task
Required parameters:
task_id - task id
mark_id - mark id

==== mark_delete ====
''Added in: 3.19.24''
Description: Delete a mark from a task
Required parameters:
task_id - task id
mark_id - mark id

==== overview_task ====
''Added in: 3.19.7''

Description: Record that an employee has viewed a task

Required parameters:
task_id - task id
employee_id - employee id

==== remove_cable_line_from_task ====
''Added in: 3.20.2''

Description: Remove a cable line from a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== remove_owner_from_task ====
''Added in: 3.19.19''

Description: Remove an owner from a task

Required parameters:
task_id - task id
owner_id - owner id

"Горячие клавиши"

2026-09-25T14:52:30Z

IronBot: [IronBot] Sync RU language links

[["Hot keys"|en]] | [["Гарячі клавіші"|uk]] | '''ru'''

Есть ряд комбинаций клавиш, которые упрощают работу с системой:
* "'''Ctrl + LeftClick'''" в схеме коммутации сооружения связи на волокне/порту оборудования приводит к мгновенной коммутации этого волокна/порта ''(без необходимости нажимать дополнительный значок коммутации)''
* "'''Ctrl + Z'''" в схеме коммутации сооружения связи отменяет предыдущее действие в этой схеме
* "'''Ctrl + LeftClick'''" в карточке задания на названии типа задания открывает карточку настройки этого типа задания
* "'''Ctrl + LeftClick'''" на карте покрытия:
** на объект на карте с типом "Полигон" открывает карточку этого объекта ''(с версии 3.19.44)''
* "'''Alt + LeftClick'''" на карте покрытия:
** на значок сооружения связи открывает схему коммутации этого сооружения связи ''(с версии 3.18)''
** на полигон здания открывает план этого здания ''(с версии 3.19)''
** на объект на карте с типом "Полигон" переключает в режим изменения координат этого объекта ''(с версии 3.19.44)''
* "'''Alt + LeftClick'''" в логической схеме здания:
** на значок сооружения связи открывает схему коммутации этого сооружения связи ''(с версии 3.21.58)''

До версии 3.19.1 под Mac OS не работали сочетания клавиш, где используется Ctrl+LeftClick

Начиная с версии 3.19.1 для Mac OS - необходимо использовать клавишу "Cmd" вместо "Ctrl" для сочетаний с LeftClick

"Hot keys"

2026-09-25T14:52:27Z

IronBot: [IronBot] Sync EN localization from RU

'''en''' | [["Гарячі клавіші"|uk]] | [["Горячие клавиши"|ru]]

The following keyboard shortcuts make common tasks quicker:
* "'''Ctrl + LeftClick'''" on a fiber or equipment port in a facility's patching diagram connects it immediately ''(without clicking the additional connection icon)''.
* "'''Ctrl + Z'''" in a facility's patching diagram undoes the previous action in that diagram.
* "'''Ctrl + LeftClick'''" on the task type name in a task card opens the settings for that task type.
* "'''Ctrl + LeftClick'''" on the coverage map:
** on an object of type "Polygon" opens its card ''(since version 3.19.44)''.
* "'''Alt + LeftClick'''" on the coverage map:
** on a facility icon opens that facility's patching diagram ''(since version 3.18)''.
** on a building polygon opens the building plan ''(since version 3.19)''.
** on an object of type "Polygon" switches to editing its coordinates ''(since version 3.19.44)''.
* "'''Alt + LeftClick'''" in a building's logical diagram:
** on a facility icon opens that facility's patching diagram ''(since version 3.21.58)''.

Before version 3.19.1, shortcuts using Ctrl + LeftClick did not work on macOS.

Since version 3.19.1, use Cmd instead of Ctrl for shortcuts with LeftClick on macOS.

"Гарячі клавіші"

2026-09-25T14:52:25Z

IronBot: [IronBot] Sync UK localization from RU

[["Hot keys"|en]] | '''uk''' | [["Горячие клавиши"|ru]]

Ці сполучення клавіш спрощують роботу із системою:
* "'''Ctrl + LeftClick'''" на волокні або порту обладнання у схемі комутації об'єкта інфраструктури відразу виконує комутацію ''(без натискання додаткового значка комутації)''.
* "'''Ctrl + Z'''" у схемі комутації об'єкта інфраструктури скасовує попередню дію в цій схемі.
* "'''Ctrl + LeftClick'''" на назві типу завдання в картці завдання відкриває налаштування цього типу.
* "'''Ctrl + LeftClick'''" на карті покриття:
** на об'єкті типу «Полігон» відкриває його картку ''(починаючи з версії 3.19.44)''.
* "'''Alt + LeftClick'''" на карті покриття:
** на значку об'єкта інфраструктури відкриває його схему комутації ''(починаючи з версії 3.18)''.
** на полігоні будинку відкриває план цього будинку ''(починаючи з версії 3.19)''.
** на об'єкті типу «Полігон» перемикає до редагування його координат ''(починаючи з версії 3.19.44)''.
* "'''Alt + LeftClick'''" у логічній схемі будинку:
** на значку об'єкта інфраструктури відкриває його схему комутації ''(починаючи з версії 3.21.58)''.

До версії 3.19.1 сполучення з Ctrl + LeftClick не працювали в macOS.

Починаючи з версії 3.19.1, для сполучень із LeftClick у macOS використовуйте Cmd замість Ctrl.

API tariff UK

2026-09-25T14:52:16Z

IronBot: [IronBot] Sync localization from RU

[[API_tariff_EN|en]] | '''uk''' | [[API tariff|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Тарифи

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====
Опис: Додавання тарифу
Обов'язкові параметри:
name - найменування тарифу
billing_id - id білінгу
billing_tariff_id - id тарифу в сторонньому білінгу

==== add_group ====
''Додано у: 3.14.67''
Опис: Додавання групи тарифів
Обов'язкові параметри:
name - найменування

==== add_tariff_in_group ====
''Додано у: 3.14.67''
Опис: Додавання тарифу до групи тарифів
Обов'язкові параметри:
tariff_id - id тарифу
group_id - id групи тарифів

==== delete_group ====
''Додано у: 3.14.67''
Опис: Видалення групи тарифів
Обов'язкові параметри:
id - id групи

==== edit ====

''Оновлено у версії 3.21.63 (додано параметри description і additional_comment)''

Опис: Редагування тарифу
Обов'язкові параметри:
id - id тарифу
Додаткові параметри:
additional_comment - додатковий коментар
description - нотатки
is_in_billing - прапорець - чи є тариф у сторонньому білінгу
name - найменування тарифу
payment - розмір абонплати
payment_interval - інтервал списання абонплати ''(у днях)''
speed_rx - вхідна швидкість ''(у kbps)''
speed_tx - вихідна швидкість ''(у kbps)''
traffic - увімкнений трафік за тарифом ''(у MB)''

==== edit_group ====
''Додано у: 3.14.67''
Опис: Редагування групи тарифів
Обов'язкові параметри:
id - id групи
name - найменування

==== get ====
''Додано у: 3.12.2''
Опис: Список тарифів
Додаткові параметри:
billing_id - id білінгу
name - найменування тарифу

==== get_group ====
''Додано у: 3.13.19''
Опис: Інформація про групи тарифів
Додаткові параметри:
id - id групи (можна через кому)

==== remove_tariff_from_group ====
''Додано у: 3.14.67''
Опис: Вилучення тарифу з групи тарифів
Обов'язкові параметри:
tariff_id - id тарифу
group_id - id групи тарифів

API tariff EN

2026-09-25T14:52:14Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[API_tariff_UK|uk]] | [[API tariff|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Tariffs

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====
Description: Add a tariff
Required parameters:
name - name of tariff
billing_id - billing id
billing_tariff_id - id of tariff in third-party billing

==== add_group ====
''Added in: 3.14.67''
Description: Add a tariff group
Required parameters:
name - name

==== add_tariff_in_group ====
''Added in: 3.14.67''
Description: Add a tariff to a tariff group
Required parameters:
tariff_id - tariff id
group_id - id of tariff group

==== delete_group ====
''Added in: 3.14.67''
Description: Delete a tariff group
Required parameters:
id - id of the group

==== edit ====

''Updated in: 3.21.63 (added description and additional_comment parameters)''

Description: Edit tariff
Required parameters:
id - id of tariff
Optional parameters:
additional_comment - additional comment
description - notes
is_in_billing - flag - whether the tariff is available in third party billing
name - tariff name
payment - amount of subscription fee
payment_interval - subscription fee debiting interval ''(in days)''
speed_rx - incoming speed ''(in kbps)''
speed_tx - outgoing speed ''(in kbps)''
traffic - included traffic by tariff ''(in MB)''

==== edit_group ====
''Added in: 3.14.67''
Description: Editing a group of tariffs
Required parameters:
id - id of the group
name - name

==== get ====
''Added in: 3.12.2''
Description: List of tariffs
Additional parameters:
billing_id - billing id
name - name of tariff

==== get_group ====
''Added in: 3.13.19''
Description: Information about tariff groups
Additional parameters:
id - id of the group (can be comma separated)

==== remove_tariff_from_group ====
''Added in: 3.14.67''
Description: Excluding a tariff from a tariff group
Required parameters:
tariff_id - id of tariff
group_id - id of tariff group

Версії 3.21

2026-09-25T14:52:11Z

IronBot: [IronBot] Sync localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.63 (у розробці) ==
* Доопрацьовано API->tariff->[[API_tariff_UK#edit|edit]]
* Для завдання планувальника «Автоматична прив'язка абонентів до портів» додано можливість дозволити перекомутацію нового абонента, якщо на порту знайдено лише одну MAC-адресу й вона належить іншому абоненту
* Вікно вибору «Під час входу пропонувати вибір одного з наведених номерів IP-телефонів» для співробітника тепер з'являється на будь-якій сторінці після входу ''(раніше лише на головній)''
* Виправлено вплив посилання «Вибрати все/зняти вибір» на фільтри у списках

== 3.21.62 - 25.09.2026 ==
* Додано API->[[API_map_UK#delete_poly|delete_poly]]
* Доопрацьовано API->[[API_map_UK#edit_poly|edit_poly]]
* Доопрацьовано API->[[API_map_UK#add_poly|add_poly]]
* Покращено фільтрацію залежних абонентів за портами пристрою
* Виправлено зміну порядку тайлів у налаштуваннях тайлів карт
* Виправлено вибір будинку під час створення завдання ''(в окремих випадках)''

== 3.21.61 - 24.09.2026 ==
* Доопрацьовано API->task->[[API_task_UK#change_state|change_state]]
* Виправлено відображення назв складів ''(в окремих випадках)''
* Виправлено вибір потрібних інтерфейсів під час пошуку абонентів, залежних від пристрою
* Виправлено вибір обладнання абонента в меню комутації ''(в окремих випадках)''
* Виправлено надсилання та формування SMS-повідомлень ''(в окремих випадках)''
* Виправлено дрібні помилки

== 3.21.60 - 23.09.2026 ==
* Доопрацьовано API->device->[[API_device_UK#get_relation_customers|get_relation_customers]]
* Для формування списку абонентів, залежних від пристрою, тепер потрібно вибрати конкретні інтерфейси
* Виправлено автоматизацію завдань «Призначати виконавцем підрозділ співробітника, який змінив статус завдання»
* Виправлено відкриття картки об'єкта інфраструктури в режимі редагування з карти покриття
* Виправлено перевірку збігу MAC-адреси в картці обладнання
* Виправлено втрату другого сегмента лінії під час перетягування центральної точки комутації на схемі
* Виправлено повторне відображення MAC-адреси в картці ТМЦ ''(в окремих випадках)''
* Виправлено експорт маршруту комутації у KML
* Виправлено дрібні помилки

== 3.21.59 - 22.09.2026 ==
* Прикріплені до об'єкта файли тепер можна сортувати за назвою, датою додавання або розміром. Вибраний порядок зберігається у браузері.
* Виправлено сортування у списку кабельних ліній ''(в окремих випадках)''
* Виправлено звіт «ONU, не скомутовані до OLT»
* Виправлено збереження позиції події або завдання під час переміщення у календарі запланованих робіт
* Виправлено збереження адресного об'єкта, який не є будинком, у картці завдання

== 3.21.58 - 21.09.2026 ==
* Додано API->chapter->[[API_chapter_UK#page_add|page_add]]
* Додано API->chapter->[[API_chapter_UK#page_get|page_get]]
* Додано API->chapter->[[API_chapter_UK#page_remove|page_remove]]
* Додано імпорт PON-даних абонентів із білінгу ABillS та використання цих даних під час опитування OLT
* Заборонено прив'язувати той самий об'єкт до завдання на роботу повторно
* Поле пошуку у вікні вибору виконавців завдання перенесено вгору
* До контекстного меню кабельної лінії у схемі комутації додано швидкі дії з її картки
* До контекстного меню волокна кабельної лінії у схемі комутації додано швидкі дії
* До контекстного меню порту обладнання у схемі комутації додано швидкі дії
* У властивостях типу завдання можна вказати адресу за замовчуванням ''(населений пункт, вулицю тощо)'', яка пропонуватиметься під час створення такого завдання
* У групових діях для будинків можна вказати групу тарифів
* У картці об'єкта інфраструктури тепер можна швидко скопіювати його назву до буфера обміну
* Історія дій з об'єктом інфраструктури тепер містить пов'язані складські операції

== 3.21.57 - 20.09.2026 ==
* Доопрацьовано API->device->[[API_device_UK#set_data|set_data]]
* До контекстного меню портів сплітерів у схемі комутації додано кнопки швидких дій
* До списку дзвінків додано статистику
* Додано підтримку тайлів карт у форматі .pbf
* Покращено фільтрацію списку дзвінків
* Під час формування списку абонентів, залежних від пристрою, пропускаються порти UPLINK
* Виправлено помилку на головній сторінці ''(в окремих випадках)''
* Виправлено відображення блоку файлів під час перемикання вкладок у картці абонента
* Покращено відображення нотаток до всіх об'єктів одразу на карті покриття
* Виправлено збереження файлів у складській операції оприбуткування ТМЦ
* Виправлено відображення кінцевої точки комутації під час наведення на волокно у схемі ''(в окремих випадках)''
* Виправлено фільтрацію звіту про залишки ТМЦ за всіма найменуваннями ТМЦ одночасно
* Виправлено посилання «Зняти вибір» у налаштуваннях доступу виконавців до адрес для типу завдання
* Виправлено кнопки на карті покриття, коли під ними відображалися об'єкти ''(в окремих випадках)''
* Виправлено відображення одержувачів у звіті про повідомлення ''(в окремих випадках)''
* Виправлено сортування у списках об'єктів інфраструктури та схем комутації ''(в окремих випадках)''
* Виправлено прив'язку абонента під час додавання коментаря до завдання
* Виправлено роботу лінійки на карті покриття під час натискання на об'єкти інфраструктури ''(в окремих випадках)''
* Виправлено редагування властивостей профілю сповіщень ''(в окремих випадках)''
* Виправлено перевірку прав під час перегляду або зміни файлів, прикріплених до будинку
* Виправлено експорт списку об'єктів інфраструктури у XLS
* Виправлено фільтрацію абонентів, залежних від об'єкта ''(в окремих випадках)''
* Виправлено відображення списку ТМЦ у картці об'єкта інфраструктури
* Виправлено розгортання списку пов'язаних завдань у картці абонента
* Виправлено можливість комутувати завдання на порт обладнання
* Виправлено помилку під час редагування ланцюжків автоматизації у типах завдань ''(в окремих випадках)''
* Виправлено відображення SFP-модулів у схемі комутації
* Виправлено фільтр комутації на портах пристроїв у списку обладнання
* Виправлено відображення прикріплених файлів пов'язаних завдань у картці об'єкта інфраструктури ''(в окремих випадках)''
* Виправлено посилання на профіль співробітника з його картки
* Виправлено встановлення порожньої адреси завдання
* Виправлено встановлення фокуса на полі пошуку після відкриття списку ТМЦ

== 3.21.56 - 17.09.2026 ==
* Доопрацьовано API->task->[[API_task_UK#change_state|change_state]]
* Дозволено заповнювати чек-лист для профілів користувачів із правом доступу "Зміна стану"
* Виправлення невеликих помилок

== 3.21.55 - 14.09.2026 ==
* Оптимізовано глобальну схему комутації
* Доопрацьовано пошук за адресою абонента у глобальному пошуку
* Виправлено швидкий пошук за точним збігом ''(із символом "!")'' у верхній панелі
* Виправлено перезавантаження пристрою/збереження конфігурації
* Виправлено роботу фільтра за завданнями ''(у деяких випадках)''
* Виправлено відкриття карток скомутованих об'єктів зі схеми комутації ''(у деяких випадках)''
* Виправлено збереження MAC-адреси під час надходження ТМЦ
* Виправлено швидкий пошук за ТМЦ у діалозі вибору ТМЦ у завданнях ''(у деяких випадках)''
* Виправлено перегляд абонентів за сторінками в картці будинку
* Виправлено швидкий пошук за назвою споруди зв'язку ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.54 - 13.09.2026 ==
* Доопрацьовано виведення об'єктів і підказок на карті покриття
* Виправлено заповнення додаткових полів ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.53 - 09.09.2026 ==
* Виправлення невеликих помилок

== 3.21.52 - 08.09.2026 ==
* Виправлення невеликих помилок

== 3.21.51 - 05.09.2026 ==
* Виправлення невеликих помилок

== 3.21.50 - 02.09.2026 ==
* Доопрацьовано виведення нотаток до назви кабельної лінії в результатах швидкого пошуку за кабельними лініями
* Виправлено фіксацію нотатки до складської операції під час передавання ТМЦ спеціального типу
* Виправлено відображення логічної схеми будинку ''(у деяких випадках)''
* Виправлено можливість вибору файла з основною фотографією/зображенням для співробітника ''(у деяких випадках)''
* Виправлено пошук співробітника в списку за номером телефону
* Виправлено зазначення доступних адрес для співробітника під час його створення
* Виправлення невеликих помилок

== 3.21.49 - 01.09.2026 ==
* Виправлено підсумкове групування значень додаткових полів у списку завдань
* Виправлено зайву заміну символів на HTML-сутності в нотатках щодо абонента
* Виправлено формування тексту повідомлень під час надсилання поштою ''(у деяких випадках)''
* Виправлення невеликих помилок
== 3.21.48 - 31.08.2026 ==
* Додано метод API->task->[[API_task_UK#show|show]]
* '''У запланованій схемі комутації можна виводити список дій у текстовому вигляді ''(з можливістю окремо роздрукувати/позначити виконані)'''''
* У картці споруди зв'язку під час редагування координат можна вставити значення з GPS-приймача пристрою
* Додано можливість створювати шаблони шарів/міток на карті
* У схемі комутації додано кнопку "Тільки маркування", яка приховує назви кабельних ліній і залишає на них лише написи маркування
* Доопрацьовано пошук абонентів за номерами телефонів у списку дзвінків
* Виправлено роботу додаткових полів з типом "Прикріплені файли" під час виконання завдання
* Виправлено перевірку прав під час пошуку MAC-адреси в загальному пошуку
* Виправлено відображення інвентарного номера в картці ТМЦ ''(у деяких випадках)''

== 3.21.47 - 29.08.2026 ==
* Під час зазначення батьківського завдання в картці завдання система одразу перевіряє, чи є таке завдання і чи є права доступу до нього. Якщо доступ є, одразу виводиться посилання на батьківське завдання.
* Виправлено розрив комутації у запланованій схемі комутації ''(у деяких випадках)''
* Виправлено помилку під час відкриття розділу з колірними схемами кабелів ''(у деяких випадках)''
* Виправлено пошук абонента за IP-підмережею
* Виправлено відображення будівель на мапі ''(у деяких випадках)''
* Виправлено перевірку прав під час створення дочірнього завдання
* Виправлено зайвий пошук серед звільнених співробітників
* Виправлено пошук абонентів за телефонними номерами з "+" на початку
* Виправлено сортування списку номерів будівель у селекторі вибору
* Виправлено відображення нотаток на волокнах кабельних ліній у схемі комутації ''(у деяких випадках)''

== 3.21.46 - 28.08.2026 ==
* Виправлено збереження прав доступу до завдань ''(у деяких випадках)''
* Виправлено клікабельний перехід за номером квартири у списку абонентів за будівлею
* Виправлено діалог об'єднання ТМЦ
* Виправлено відображення кількох абонентів у списку дзвінків, якщо номер телефону збігається
* Виправлено неможливість відповісти на коментар до завдання ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.45 - 27.08.2026 ==
* Виправлено пошук за абонентом у швидкому пошуку ''(у деяких випадках)''
* Виправлено помилку під час перегляду логічної схеми будівлі ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.44 - 26.08.2026 ==
* Додано параметр налаштування "Під час переходу до наступної схеми комутації центрувати схему на кабельній лінії, з якої був виконаний перехід"
* У картці ONU/ТМЦ/абонента виводиться окрема плашка, що показує поточний стан ONU ONLINE/OFFLINE
* Виправлено відображення значень додаткових полів з назвами об'єктів у списках завдань та інших списках

== 3.21.43 - 25.08.2026 ==
* Виправлено помилку під час зміни статусу завдання ''(у деяких випадках)''
* Виправлено помилку під час побудови маршруту комутації ''(у деяких випадках)''
* Виправлено фільтрацію за абонентами у списку дзвінків
* Виправлення невеликих помилок

== 3.21.42 - 24.08.2026 ==
* [[Імпорт будівель з КАІС (BG)]]
* Під час переходу у запланованій схемі комутації до схеми сусідньої споруди зв'язку ''(протилежного об'єкта на кабельній лінії)'' схема одразу відкривається у подвійному режимі поточна/запланована. Якщо запланованої схеми ще немає, система пропонує її створити.
* Правий клік на портах дільника у схемі комутації відкриває контекстне меню порту
* Під час ручного додавання VLAN на обладнанні виводиться селектор з портами цього обладнання
* Доопрацьовано автопобудову П-подібного маршруту комутації у схемі комутації
* У налаштуванні статусу завдання можна вказати у виборі ТМЦ, куди передавати вибрані ТМЦ ''(абонент/завдання)'', і на який субрахунок
* У запланованій схемі комутації для портів "пісочних" дільників додано можливість змінювати типи адаптерів
* У запланованій схемі комутації додано можливість масово комутувати волокна/порти між собою
* Зміна типу пігтейлів для портів/волокон у запланованій схемі комутації фіксується лише в ній і не впливає на поточну схему комутації
* Під час виведення розділеної сторінки з поточною/запланованою схемами комутації їх можна експортувати в SVG з різними налаштуваннями експорту
* Виправлено неточності генерації схеми комутації в SVG
* Виправлено можливість додавання локальних UNC-посилань у редактор WYSIWYG
* Виправлено помилки під час надсилання email-сповіщень ''(у деяких випадках)''
* Виправлено переміщення позиції схеми комутації на глобальній схемі комутації ''(у деяких випадках)''
== 3.21.41 - 21.08.2026 ==
* Оптимізовано відображення спливних підказок на мапі покриття
* Виправлено зміну кількості адаптерів під час гарячої заміни дільника
* Виправлено відображення SVG-файлів у галереї прикріплених файлів ''(у деяких випадках)''
* Виправлено помилку перегляду точки маршруту комутації на мапі покриття
* Виправлено помилку під час переходу до картки обладнання з картки завдання ''(у деяких випадках)''
* Виправлено зміну маршруту на мапі для кабельних трас
* Виправлено відображення співробітників у селекторах як звільнених ''(у деяких випадках)''
* Виправлено масштабування об'єктів на мапі ''(у деяких випадках)''
* Виправлено відображення нотаток у списку абонентів
* Виправлено ping довільної IP-адреси
* Виправлення невеликих помилок

== 3.21.40 - 17.08.2026 ==
* У запланованій схемі комутації в контекстному меню можна додавати кабельні лінії, зокрема з ємністю 12 і 48
* Для типів завдань виділено окреме право "Коментарі"
* Для обладнання можна будувати список залежних абонентів саме за потрібними портами
* Перероблено діалог гарячої заміни дільника: тепер можна вибирати дільник з усіх доступних складів
* У схемі комутації межу робочої області зроблено перетягуваною, що дає змогу швидко змінювати розмір поля схеми комутації
* У схемі комутації додано швидку можливість скомутувати N волокон/портів пристроїв між собою ''(починаючи з поточного, з розривом наявної комутації)''
* Виправлено задвоєння відображення співробітників у списку співробітників підрозділу ''(у деяких випадках)''
* Виправлено відображення записів таблиць відповідно до власного налаштування кожного співробітника щодо кількості записів у таблиці
* Виправлено завантаження списку автовиконавців для завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.39 - 14.08.2026 ==
* Доопрацьовано зовнішній вигляд спливних коментарів у списку завдань
* Виправлено вибір порту обладнання для переключення зайнятого порту
* Виправлення невеликих помилок

== 3.21.38 - 13.08.2026 ==
* Виправлено прикріплення файлів у додаткових полях для нових об'єктів
* Виправлення невеликих помилок

== 3.21.37 - 12.08.2026 ==
* Виправлення невеликих помилок

== 3.21.36 - 09.08.2026 ==
* У запланованій схемі комутації додано функції "пісочниці": можна створювати кабельні лінії та дільники без прив'язки до реальних об'єктів. Можна приховувати наявні об'єкти. Додано додаткові кнопки відображення.
* Додано архів за транспортом
* У ланцюжках дій за типами завдань додано нову дію "Підрозділ. Виключити з усіма його співробітниками"
* У налаштуваннях типів завдань додано властивість "Приховувати робочу нотатку за адресами в цьому типі завдань"

== 3.21.35 - 08.08.2026 ==
* Виправлення невеликих помилок

== 3.21.34 - 07.08.2026 ==
* Для типу споруд зв'язку можна налаштувати поєднання клавіш для швидкого додавання об'єкта такого типу на мапу
* У схемі комутації додано контекстне меню - можливість швидко додати запланований дільник потрібного типу
* Під час натискання правою кнопкою на об'єкт у схемі комутації одразу відкривається його контекстне меню
* Виправлено редагування параметрів CWDM у каталозі товарів
* Виправлено можливість розділення доступних ТМЦ для профілю співробітника з доступом лише до власного підзвіту

== 3.21.33 - 06.08.2026 ==
* У схемі комутації можна розділити екран на дві частини та виводити поточну і заплановану схему. Запланована схема тепер також підтримує можливість змінювати позиції об'єктів, напрямок портів та інше введення кабелів
* У списках об'єктів у групових діях додано можливість масово позначати об'єкти, що розташовані нижче у списку
* Виправлення деяких помилок міграції

== 3.21.32 - 05.08.2026 ==
* Під час додавання кабельної лінії з мапи покриття через кілька проміжних споруд зв'язку додано можливість позначати, на яких саме проміжних спорудах зв'язку потрібно розділити цю лінію і чи потрібно зберегти комутацію між цими сегментами
* Виправлено часткове копіювання інформації у списку пристроїв ''(у деяких випадках)''
* Виправлено помилку під час масового приходу ТМЦ ''(у деяких випадках)''
* Виправлено зазначення кольору для будь-якого порту дільника
* Виправлено виведення інформації про невиконані поточні завдання в картці абонента
* Виправлено роботу селектора вибору співробітника ''(у деяких випадках)''

== 3.21.31 - 02.08.2026 ==
* У глобальній схемі комутації додано можливість друку всієї цієї схеми
* З мапи можна створювати кабельні лінії одразу через усі проміжні споруди зв'язку ''(а не лише від початкового до кінцевого об'єкта)''
* Для SMS-розсилок додано виключення за міткою/значенням додаткового поля на абоненті
* У запланованій схемі комутації додано можливість змінювати маршрут проходження запланованої комутації
* Для міток можна окремо призначати їх застосування до абонентів-юридичних/фізичних осіб та/або потенційних абонентів
* Спливне вікно про вхідний виклик можна виводити зверху/знизу, ліворуч/по центру/праворуч. Можна вказати, щоб воно виводило нотатки за абонентом
* У логічній схемі будівлі можна окремо вказати структуру для кожного під'їзду
* Виправлено фільтрацію за завданнями після виконання групових дій із завданнями
* Виправлено можливість додавання файлів під час зміни статусу завдання
* Виправлено пошук за IP-адресою у списку комутаторів ''(у деяких випадках)''

== 3.21.30 - 31.07.2026 ==
* У картці будівлі можна вказувати довільну нумерацію під'їздів ''(зокрема текстові назви під'їздів)''
* У картці полігона додано посилання на зміну координат
* У списку повідомлень додано можливість фільтрації за наявністю абонента, а також групову дію - призначити/зняти мітку на абонентів із цих повідомлень
* У логічній схемі будівлі додано можливість приховати відображення абонентів і комутацій до них
* У звіті щодо залишків ТМЦ додано можливість фільтрації за найменуванням/категорією ТМЦ
* У картці абонента можна окремо вручну вносити координати в режимі редагування або змінювати їх на мапі
* Для мітки можна призначити права доступу за профілем співробітника
* Виправлено помилку під час перегляду історії за абонентом ''(у деяких випадках)''

== 3.21.29 - 30.07.2026 ==
* У профілях співробітників додано нове право "Управління своїм підзвітом"
* Для кожного типу завдань можна налаштувати, які мітки використовувати в завданнях такого типу
* Для типу завдань можна вибрати категорію абонентів цього типу завдань ''("Юридичні особи", "Фізичні особи")''
* У відомості робіт додано можливість сортування за різними полями
* Виправлено можливість згадувати співробітників у коментарях до завдань
* Виправлено додавання кабельної траси з мапи покриття
* Виправлено помилку під час виключення рівня в логічній схемі будівлі ''(у деяких випадках)''

== 3.21.28 - 29.07.2026 ==
* У списку ТМЦ додано фільтр за значенням додаткового поля
* Кожен співробітник може налаштувати для себе автооновлення головної сторінки
* Виправлення помилки у віджеті головної сторінки "Список завдань на сьогодні"
* Виправлено вибір ТМЦ для додавання в операцію
* Виправлено коректне відкриття картки абонента в логічній схемі будівлі
* Виправлено розрив комутації без перезавантаження сторінки в схемі комутації
* Виправлено селектор вибору адресних об'єктів для співробітників з обмеженими адресними правами

== 3.21.27 - 28.07.2026 ==
* Нове право для профілів співробітників "Склад - Звіти"
* Окремо для кожного типу споруд зв'язку додано можливість вмикати/вимикати виведення його номера/найменування на мапі та шаблон формування номера/найменування
* Новий тип додаткового поля "Крос/ODF"
* У розрахунку маршруту з'єднань додано можливість експортувати результат у KML-файл
* Додано настроювані "Кольорові схеми кабелів". Їх можна довільно використовувати, щоб змінювати розфарбування в кабельних лініях.
* Для кабельної лінії розфарбування провідників можна скопіювати з інших кабельних ліній, які є у спорудах зв'язку, де закінчується ця кабельна лінія.
* Виправлено перехід на картку конкретного ТМЦ за його ID з-під лівого меню
* Виправлено відображення кольору полігона на мапі покриття ''(у деяких випадках)''
* Виправлено відображення багаторядкових написів на мапі покриття
* Виправлено помилку під час відкриття картки стійки/шафи ''(у деяких випадках)''

== 3.21.26 - 27.07.2026 ==
* У режимі планування в схемі комутації додано можливість планувати розрив комутації
* У "Комутатори" додано звіт "Номінальне та SNMP-найменування обладнання"
* Для профілів співробітників можна налаштовувати, у які категорії співробітник має право переміщати ТМЦ
* Право на перегляд списаних ТМЦ окремо винесено для профілів співробітників ''(раніше перегляд і зміна були разом)''
* У ланцюжках завдань/автоматизації додано дію "Абонент. Створення"
* Для портів дільників можна вказувати їхній колір
* У списку ONU за пристроєм фільтр за назвою інтерфейсу дозволяє вибирати одночасно кілька інтерфейсів пристрою
* Під час редагування завдання можна додавати одразу кілька абонентів
* У картці завдання додано можливість створювати копію поточного завдання
* Виправлено вибір обладнання для гарячої заміни пристрою

== 3.21.25 - 25.07.2026 ==
* Якщо під час зміни статусу завдання налаштовано ланцюжок завдань/автоматизацію, ця інформація виводиться у спливній підказці на статусі завдання
* Доопрацьовано обробку номерів телефонів у додаткових полях картки завдання під потрібний формат системи
* У каталозі кабелів для марки кабелю додано параметр "Схема комутації. Колір написів"
* Зміна власних координат абонента фіксується в історії дій
* Виправлено перевірку прав доступу під час перегляду прикріплених файлів за абонентом
* Виправлено надсилання сповіщень співробітникам про недоступність/активність обладнання ''(у деяких випадках)''

== 3.21.24 - 24.07.2026 ==
* Якщо сторінку входу відкриває вже автентифікований користувач, відкривається головна сторінка системи
* У списку ТМЦ можна візуально групувати ТМЦ за найменуванням ''(об'єднувати кілька ТМЦ в одну групу, щоб швидко бачити кількість ТМЦ з таким найменуванням на об'єкті)''
* Доопрацьовано кольорове виділення запланованих кабельних ліній
* Виправлено перевірку доступу до адресних об'єктів ''(у деяких випадках)''

== 3.21.23 - 23.07.2026 ==
* Додано відображення прогресу імпорту споруд зв'язку
* Виправлено збереження chat_id для співробітника ''(у деяких випадках)''
* Виправлено відображення нотаток в історії за абонентом

== 3.21.22 - 22.07.2026 ==
* Написи на мапі виводяться з білим ореолом для кращої читабельності
* Виправлено помилку під час перегляду історії дій співробітника ''(у деяких випадках)''
* Виправлено неможливість виключення пов'язаних об'єктів із завдання ''(у деяких випадках)''
* Виправлено сортування пов'язаних завдань у картці завдання

== 3.21.21 - 21.07.2026 ==
* '''Для глобальної схеми комутації додано можливість експорту в SVG'''
* У картці ТМЦ можна формувати документи за цим ТМЦ
* Виправлено помилку під час відкриття операції за ТМЦ ''(у деяких випадках)''
* Виправлено редагування параметрів доступу для системних пристроїв
* Виправлено комутацію до портів системних пристроїв
* Виправлено відображення списку інтерфейсів/стекування за пристроєм ''(у деяких випадках)''
* Виправлено видалення поверху у структурі будівлі

== 3.21.20 - 20.07.2026 ==
* У діалоговому вікні призначення адресного доступу для співробітника додано пошук за адресним об'єктом
* Додано кнопки швидкого очищення нотаток на портах ODF/кроса у схемі комутації
* Виправлення невеликих помилок

== 3.21.19 - 18.07.2026 ==
* Для типів споруд зв'язку додано властивість "Дозволити збіг номерів об'єктів для різних населених пунктів"
* Для типів адресних одиниць додано налаштування, у яких батьківських адресних одиницях їх можна додавати ''(наприклад, "вулиці" тільки в "містах" тощо)''
* Для типів адресних об'єктів можна налаштувати доступ до редагування таких об'єктів за профілями співробітників
* Доопрацьовано відображення завжди повних ПІБ у списку співробітників
* Виправлено операції з мультиплексорами на схемі комутації
* Виправлено відображення нового доданого типу кабельної лінії в лівому меню

== 3.21.18 - 17.07.2026 ==
* Значки абонентів на мапі покриття виводяться з кольором контуру відповідно до кольору мітки на цьому абоненті
* У списку завдань додано фільтр за значенням додаткового поля на адресі завдання
* Виправлення невеликих помилок

== 3.21.17 - 16.07.2026 ==
* '''Обладнання можна встановлювати на будівлі ''(раніше тільки на споруді зв'язку або на абоненті)'''''
* '''Кабельна лінія тепер може починатися на абоненті або на будівлі ''(раніше тільки на споруді зв'язку)'''''
* У список абонентів додано поле "Загальна абонплата" з можливістю фільтрації за ним
* Виправлено помилку під час перегляду історії комутації за волокном кабельної лінії ''(у деяких випадках)''
* Виправлено збереження вибраної групи типів для властивостей типу споруди зв'язку
* Виправлено пошук за маркою кабелю під час додавання кабельної лінії ''(у деяких випадках)''

== 3.21.16 - 15.07.2026 ==
* '''ODF/кроси та дільники можна встановлювати в абонентів або на будівлях'''
* У списку ONU за OLT у фільтрації за інтерфейсом додано селектор наявних PON-інтерфейсів OLT
* Виправлено роботу операцій у запланованій схемі комутації
* Виправлено сортування персоналу в підрозділі у списку підрозділів
* Виправлено додавання ТМЦ із зазначенням IP/MAC-адреси
* Виправлено відображення історії за волокнами кабельних ліній

== 3.21.15 - 14.07.2026 ==
* Для типу завдань можна вказувати, що це завдання тільки для абонентів певних груп
* Додано можливість надсилати повідомлення всім співробітникам компанії з можливістю вказати дату видалення ''(за потреби)''
* Виправлено зовнішній вигляд картки підрозділу під час редагування
* Виправлено перебудову дочірніх схем під час перетягування схеми комутації на глобальній схемі
* Виправлено роботу параметра "Під час зміни полігона будівлі виводити на мапі й інші об'єкти" ''(у деяких випадках)''
* Виправлено неможливість вибрати будівлю під час створення нового завдання

== 3.21.14 - 13.07.2026 ==
* '''Додано можливість прив'язувати ТМЦ до завдання ''(як обладнання, абонент тощо)''. Без передачі ТМЦ на саме завдання. Для обліку виконання завдань, пов'язаних із ТМЦ.'''
* У звітах за ТМЦ додано новий звіт "Рух ТМЦ"
* У списку будинків додано фільтрацію за наявністю/відсутністю споруди зв'язку на будинку
* Додано нове право для профілів співробітників: "Налаштування - Статуси завдань"
* У календарі робіт додано фільтри для налаштування власного порядку/наявності підрозділів і співробітників у календарі
* Перероблено розділ зі списком підрозділів. Змінено зовнішній вигляд, додано швидкий пошук за співробітником/підрозділом
* Під час створення нового будинку в блоці вибору адреси нова адреса одразу підставляється без перезавантаження поточної сторінки
* Під час пошуку в блоці вибору адреси в результатах виводяться не лише будинки, а й інші типи адресних об'єктів, що дозволяє також швидко додавати нові будинки, вулиці тощо
* Доопрацьовано зовнішній вигляд картки завдання для мобільних пристроїв
* Виправлено швидкість роботи карти покриття під час відображення шару "Співробітники та автотранспорт"
* Виправлено фільтрацію у списку будинків ''(у деяких випадках)''
* Виправлено перегляд PDF-файлів у браузері ''(у деяких випадках)''
* Виправлено фільтрацію списку абонентів-боржників
* Виправлено відображення розділу "Налаштування-Адреси" для співробітників з обмеженим доступом за географією
* Виправлено відображення волокон на схемі комутації за наявності мітки на волокні
* Виправлено помилку під час відображення завдань поточного дня в календарі робіт ''(у деяких випадках)''

== 3.21.13 - 10.07.2026 ==
* '''Під час приходу ТМЦ тепер можна одразу вказувати кілька різних найменувань ТМЦ'''
* Доопрацювання у відображенні виконаних завдань у календарі
* У схемі комутації для дільників і ODF/кросів у меню об'єктів додано кнопки дій, як і в картках цих об'єктів ''(редагування, видалення, структурна схема тощо)''
* Виправлено комутацію у схемі комутації ''(у деяких випадках)''
* Виправлено дублювання запитів під час автооновлення рівня сигналу на ONU під час відкриття її картки
* Виправлено зовнішній вигляд відображення історії за завданням
* Виправлено редагування налаштувань карти покриття ''(у деяких випадках)''
* Виправлено вибір об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено перевірку прав доступу до списку ONU для співробітників
* Виправлено зовнішній вигляд картки стійки/шафи в темній схемі інтерфейсу

== 3.21.12 - 09.07.2026 ==
* Доопрацьовано метод API->[[API_redirect_UK|redirect]]
* Під час розділення ТМЦ на кілька частин за наявності прикріплених файлів вони закріплюються за всіма ТМЦ
* Доопрацьовано діалог додавання кабельної лінії з-під споруди зв'язку
* Додано параметр налаштування "Відображати виконані завдання з прозорістю (%)"
* Виправлено роботу параметра налаштування "Відображати виконані завдання сірим кольором"
* Виправлено виведення поля для зазначення MAC-адреси під час приходу ТМЦ
* Виправлено роботу залежностей додаткових полів
* Виправлено роботу з прикріпленими файлами в операціях з автотранспортом
* Виправлено перехід до налаштування полів таблиці споруд зв'язку
* Виправлено зовнішній вигляд інформації за завданнями у вкладці "Тех. підтримка" у картці абонента
* Виправлено помилки під час перегляду історії дій користувачів ''(у деяких випадках)''
* Виправлено помилку під час відкриття діалогового вікна вибору ТМЦ для інтеграції
* Виправлено переміщення позицій об'єктів на глобальній схемі комутації
* Виправлено зазначення резервів для кабельних ліній
* Виправлено помилку під час приходу ТМЦ та автопризначення інвентарних номерів ''(у деяких випадках)''
* Виправлено налаштування доступу до адрес для співробітників

== 3.21.11 - 08.07.2026 ==
* Виправлено зовнішній вигляд налаштування таблиці прав для типів завдань
* Виправлено зміну позиції окремої схеми комутації споруди зв'язку на загальній глобальній схемі комутації
* Виправлено фільтрацію завдань у розділі "Мої завдання" ''(у деяких випадках)''
* Виправлено зміну координат адресного об'єкта з-під картки будинку
* Виправлено сортування виконавців під час створення завдання
* Виправлено зміну координат сектора для радіообладнання
* Виправлено перевірку прав доступу під час відкриття картки пристрою ''(у деяких випадках)''
* Виправлено приховування/відображення споруди зв'язку на карті покриття

== 3.21.10 - 07.07.2026 ==
* Додано метод API->call->[[API_call_UK#edit|edit]]
* Додано нові права для профілів користувачів "Власники (доступ до фінансової інформації)" та "Орендарі (доступ до фінансової інформації)"
* '''Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником'''
* У групових діях за спорудами зв'язку створення спільного завдання/окремих завдань реалізовано через стандартний діалог додавання завдання
* Виправлено позначення завдання як прочитаного в новинах під час відкриття картки завдання
* Виправлено відображення дати останньої операції за ТМЦ у списку ТМЦ за об'єктом
* Виправлено генерацію документа на друк з-під картки завдання
* Виправлено комутацію вільних волокон кабелів між собою ''(у деяких випадках)''
* Виправлено редагування координат у лінії зв'язку
* Виправлено виведення сторонніх артефактів у глобальній схемі комутації ''(у деяких випадках)''
== 3.21.9 - 06.07.2026 ==
* У виключення для SMS-розсилок додано можливість виключати абонентів із певним періодом від'ємного балансу
* У статистиці "Проблемні будинки/абоненти" додано можливість налаштовувати власні фільтри
* У налаштуваннях типу завдань у секції додаткових полів окремо вказуються типи додаткових полів, які можна використовувати під час зміни статусу завдань. А в налаштуваннях статусів завдань додано властивість "Вивести додаткові поля"
* Додано можливість автоматично створювати завдання на роботу для невідповіджених телефонних викликів
* Зміну пароля користувача винесено в окреме діалогове вікно

== 3.21.8 - 04.07.2026 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доробки зовнішнього вигляду завдань у календарі робіт
* У групових діях за абонентами: створення завдань тепер використовує повноцінний діалог зазначення властивостей для створюваних завдань
* Оптимізація структурної схеми
* Виправлено помилку під час встановлення умов у SMS-розсилці ''(у деяких випадках)''
* Виправлено зазначення власних координат для абонента
* Виправлено помилку під час збереження системного пристрою
* Виправлено виведення об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено комутацію кабельної лінії до пристрою у схемі комутації абонента
* Виправлено зміну довільних координат для обладнання
* Виправлено роботу фільтра за виключенням тарифу в SMS-розсилці

== 3.21.7 - 03.07.2026 ==
* Режим планування в календарі робіт
* Виправлено пошук у списку споруд зв'язку ''(у деяких випадках)''
* Виправлено відображення прикріплених файлів у картці споруди зв'язку за наявності прав лише на читання
* Виправлено перегляд/формування SMS-розсилок ''(у деяких випадках)''
* Виправлено відображення рівнів сигналів для ONU ''(у деяких випадках)''
* Виправлено відображення затухань на структурній схемі для OLT ''(у деяких випадках)''
* Виправлено помилку під час перегляду історії за співробітниками ''(у деяких випадках)''
* Виправлено неправильне виведення дати активності у спливній підказці на мапі покриття за автотранспортом
* Виправлено можливість виключення абонента із завдання

== 3.21.6 - 02.07.2026 ==
* Додано історію використання IP-адрес
* Доопрацьовано використання лінійки на мапі покриття
* Виправлено зовнішній вигляд кабельних ліній на мапі покриття залежно від налаштувань міток ''(у деяких випадках)''
* Виправлено список обладнання у віджеті головної сторінки "Неактивні комутатори"
* Виправлено додавання нових схем споруд зв'язку на глобальну схему комутації
* Виправлено пошук за базою обладнання під час додавання найменування ТМЦ у каталозі товарів
* Виправлено очищення комутації портів обладнання ''(у деяких випадках)''
* Виправлено помилку у звіті щодо залишків ТМЦ ''(у деяких випадках)''
* Виправлено зазначення довільних запасів/об'єктів на маршруті кабельної лінії
* Виправлено перемикання комутації в порт іншого пристрою на споруді зв'язку
* Виправлено відображення об'єктів на мапі покриття у групових операціях за спорудами зв'язку
* Виправлено зміну шляху комутації у схемі комутації ''(у деяких випадках)''

== 3.21.5 - 01.07.2026 ==
* Додано сповіщення під час редагування завдання ''(налаштовується)''
* Доробка зі знімання інформації за інтерфейсами ONU
* Доопрацьовано зовнішній вигляд портів обладнання для темної схеми
* Для типів завдань додано можливість вказати дії з ТМЦ: передавати з абонента на вибраний склад потрібні ТМЦ, що знаходяться в абонента
* Виправлено швидкий пошук обладнання потрібної категорії у списку обладнання
* Виправлено вибір інших пристроїв на цій споруді зв'язку в діалоговому вікні перемикання порту
* Виправлено відображення доступних складів для співробітника ''(у деяких випадках)''
* Виправлено помилку під час перегляду картки ТМЦ ''(у деяких випадках)''
* Виправлено автовибір будинку під час додавання споруди зв'язку з картки будинку
* Виправлено перегляд списку опитуваних пристроїв у модулі usm_observer
* Виправлено можливість зміни кольору з'єднання між пристроями у схемі комутації

== 3.21.4 - 30.06.2026 ==
* Доопрацьовано метод API->attach->[[API_attach_UK#upload|upload]]
* Додано окремий профіль email-сповіщень для надсилання повідомлень абонентам-юридичним особам
* Доопрацьовано сортування у списку споруд зв'язку за будинком
* Календар робіт відкривається на поточній даті
* Доробка календаря завдань для випадків, коли кілька завдань призначаються на один час
* Впроваджено багаторівневі групи типів завдань
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email абонентам ''(за налаштовуваними шаблонами)''
* Доопрацьовано виведення спливного сповіщення під час призначення підрозділу співробітника на завдання
* Виправлено відображення блока з прикріпленими файлами у власних розділах за права лише на читання
* Виправлено перехід у картку абонента з мапи покриття
* Виправлено помилку під час налаштування доступності статусів для профілів співробітників у картці типу завдання
* Виправлено фільтрацію за датами у списку завдань ''(у деяких випадках)''
* Виправлено відображення автора завдання у списку завдань
* Виправлено відображення поля "Нотатки" у картці споруди зв'язку
* Виправлено помилку під час спроби видалення адресного об'єкта ''(у деяких випадках)''
* Виправлено можливість вимкнення/увімкнення порту пристрою
* Виправлено перегляд глобальних схем комутації ''(у деяких випадках)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]

Versions 3.21 EN

2026-09-25T14:52:08Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[Версії_3.21|uk]] | [[Версии_3.21|ru]]

Versions of the [[3.21_EN|3.21]] branch

Also see: [[Versions_of_ERP_"USERSIDE"|ERP "USERSIDE" versions]]

== 3.21.63 (in development) ==
* Updated API->tariff->[[API_tariff_EN#edit|edit]]
* The "Automatically assign customers to ports" scheduler task can now allow reassignment of a new customer's connection when the port has only one MAC address and it belongs to another customer
* The employee's "On login, offer a choice of the following IP phone numbers" dialog now appears on any page after login ''(previously only on the dashboard)''
* Fixed the "Select all/Deselect all" link affecting filters in lists

== 3.21.62 - 25.09.2026 ==
* Added API->[[API_map_EN#delete_poly|delete_poly]]
* Updated API->[[API_map_EN#edit_poly|edit_poly]]
* Updated API->[[API_map_EN#add_poly|add_poly]]
* Improved filtering of customers dependent on device ports
* Fixed changes to tile order in map tile settings
* Fixed building selection when creating a task ''(in some cases)''

== 3.21.61 - 24.09.2026 ==
* Updated API->task->[[API_task_EN#change_state|change_state]]
* Fixed warehouse names appearing incorrectly ''(in some cases)''
* Fixed selection of the required interfaces when finding customers dependent on a device
* Fixed customer equipment selection in the patching menu ''(in some cases)''
* Fixed sending and generating SMS messages ''(in some cases)''
* Minor bug fixes

== 3.21.60 - 23.09.2026 ==
* Updated API->device->[[API_device_EN#get_relation_customers|get_relation_customers]]
* A list of customers dependent on a device now requires specific interfaces to be selected
* Fixed the task automation "Assign the department of the employee who changed the task status as the assignee"
* Fixed opening a facility card in edit mode from the coverage map
* Fixed MAC address matching in equipment cards
* Fixed the loss of the second line segment when dragging the central patching point in a diagram
* Fixed duplicate MAC addresses appearing in inventory item cards ''(in some cases)''
* Fixed exporting patching routes to KML
* Minor bug fixes

== 3.21.59 - 22.09.2026 ==
* Attached files for an object can now be sorted by name, date added, or size. The browser remembers the selected order.
* Fixed sorting in the cable line list ''(in some cases)''
* Fixed the "ONUs not connected to an OLT" report
* Fixed the position of an event or task being lost when moving it in the work schedule calendar
* Fixed saving an address object other than a building in a task card

== 3.21.58 - 21.09.2026 ==
* Added API->chapter->[[API_chapter_EN#page_add|page_add]]
* Added API->chapter->[[API_chapter_EN#page_get|page_get]]
* Added API->chapter->[[API_chapter_EN#page_remove|page_remove]]
* Added import of customer PON data from ABillS billing and use of that data when polling OLTs
* Prevented duplicate objects from being attached to a work order
* Moved the search field to the top of the task assignee selection dialog
* Added cable line card quick actions to the cable line context menu in the patching diagram
* Added quick actions to the cable fiber context menu in the patching diagram
* Added quick actions to the equipment port context menu in the patching diagram
* A task type can now specify a default address ''(town, street, etc.)'' suggested when creating a task of that type
* Building bulk actions can now set a tariff group
* Facility cards now provide a quick way to copy the object name to the clipboard
* Facility activity history now includes related warehouse operations

== 3.21.57 - 20.09.2026 ==
* Updated API->device->[[API_device_EN#set_data|set_data]]
* Added quick action buttons to the splitter port context menu in the patching diagram
* Added statistics to the call list
* Added support for .pbf map tiles
* Improved call list filtering
* The list of customers dependent on a device now skips UPLINK ports
* Fixed an error on the dashboard ''(in some cases)''
* Fixed the attached files block when switching tabs in a customer card
* Improved how notes for all objects are displayed together on the coverage map
* Fixed saving files to a warehouse receipt operation
* Fixed the displayed patching endpoint when hovering over a fiber in the patching diagram ''(in some cases)''
* Fixed filtering the inventory balance report by all inventory item names at once
* Fixed the "Deselect" link in assignee address access settings for task types
* Fixed coverage map buttons when objects were displayed beneath them ''(in some cases)''
* Fixed recipient names in the messages report ''(in some cases)''
* Fixed sorting in the facility and patching diagram lists ''(in some cases)''
* Fixed attaching a customer when adding a task comment
* Fixed the ruler on the coverage map when clicking facilities ''(in some cases)''
* Fixed editing notification profile properties ''(in some cases)''
* Fixed permission checks when viewing or changing files attached to a building
* Fixed exporting the facility list to XLS
* Fixed filtering customers dependent on an object ''(in some cases)''
* Fixed the inventory item list in a facility card
* Fixed expanding the related task list in a customer card
* Fixed the ability to connect a task to an equipment port
* Fixed an error when editing automation chains in task types ''(in some cases)''
* Fixed SFP modules appearing incorrectly in the patching diagram
* Fixed filtering equipment by device port connections
* Fixed attached files for related tasks in a facility card ''(in some cases)''
* Fixed the link to an employee profile from the employee card
* Fixed setting an empty task address
* Fixed focus on the search field when opening the inventory item list

== 3.21.56 - 17.09.2026 ==
* Updated API->task->[[API_task_EN#change_state|change_state]]
* Allow checklists to be filled in by user profiles with the "Change state" access right
* Minor bug fixes

== 3.21.55 - 14.09.2026 ==
* Optimized the global commutation scheme
* Improved address search for customers in global search
* Fixed quick search by exact match ''(with the "!" character)'' in the top panel
* Fixed device reboot/configuration saving
* Fixed the task filter ''(in some cases)''
* Fixed opening cards of commutated objects from the commutation scheme ''(in some cases)''
* Fixed saving the MAC address when receiving inventory items
* Fixed quick search by inventory item in the inventory item selection dialog in tasks ''(in some cases)''
* Fixed paginated customer browsing in the building card
* Fixed quick search by telecom facility name ''(in some cases)''
* Minor bug fixes

== 3.21.54 - 13.09.2026 ==
* Improved the display of objects and hints on the coverage map
* Fixed filling additional fields ''(in some cases)''
* Minor bug fixes

== 3.21.53 - 09.09.2026 ==
* Minor bug fixes

== 3.21.52 - 08.09.2026 ==
* Minor bug fixes

== 3.21.51 - 05.09.2026 ==
* Minor bug fixes

== 3.21.50 - 02.09.2026 ==
* Improved the display of notes for cable line names in quick search results for cable lines
* Fixed saving the note for a warehouse operation when transferring a special inventory item type
* Fixed the display of the building logical scheme ''(in some cases)''
* Fixed selecting a file for an employee's main photo/image ''(in some cases)''
* Fixed employee search in the list by phone number
* Fixed assigning available addresses when creating an employee
* Minor bug fixes

== 3.21.49 - 01.09.2026 ==
* Fixed total grouping of additional field values in the task list
* Fixed unnecessary replacement of characters with HTML entities in customer notes
* Fixed message text generation when sending email ''(in some cases)''
* Minor bug fixes
== 3.21.48 - 31.08.2026 ==
* Added the API->task->[[API_task_EN#show|show]] method
* '''The planned commutation scheme can display the list of actions as text ''(with the option to print it separately and mark completed actions)'''''
* In the communications installation card, coordinates from the device GPS receiver can be pasted when editing coordinates
* Added the ability to create layer/label templates on the map
* Added the "Labels only" button to the commutation scheme. It hides cable-line names and leaves only their label captions.
* Improved customer search by phone numbers in the call list
* Fixed operation of custom fields with the "Attached files" type when completing a task
* Fixed rights checking when searching for a MAC address in global search
* Fixed inventory number display in the inventory item card ''(in some cases)''

== 3.21.47 - 29.08.2026 ==
* When a parent task is specified in the task card, the system now immediately checks whether that task exists and whether the employee has access to it. If access is available, a link to the parent task is shown at once.
* Fixed commutation break in the planned commutation scheme ''(in some cases)''
* Fixed an error when opening the cable color schemes section ''(in some cases)''
* Fixed customer search by IP subnet
* Fixed building display on the map ''(in some cases)''
* Fixed rights checking when creating a child task
* Fixed unnecessary searching through dismissed employees
* Fixed customer search by phone numbers that start with "+"
* Fixed sorting of building numbers in the selection selector
* Fixed note display on cable-line fibers in the commutation scheme ''(in some cases)''

== 3.21.46 - 28.08.2026 ==
* Fixed saving access rights for tasks ''(in some cases)''
* Fixed clickable navigation by apartment number in the customer list for a building
* Fixed the inventory item merge dialog
* Fixed display of several customers in the call list when the phone number matches
* Fixed inability to reply to a task comment ''(in some cases)''
* Minor bug fixes

== 3.21.45 - 27.08.2026 ==
* Fixed customer search in quick search ''(in some cases)''
* Fixed an error when viewing the logical building scheme ''(in some cases)''
* Minor bug fixes

== 3.21.44 - 26.08.2026 ==
* Added the setting "When moving to the next commutation scheme, center the scheme on the cable line from which the transition was made"
* The ONU/inventory item/customer card now shows a separate badge indicating whether the ONU is currently ONLINE or OFFLINE
* Fixed display of custom-field values with object names in task lists and other lists

== 3.21.43 - 25.08.2026 ==
* Fixed an error when changing a task status ''(in some cases)''
* Fixed an error when building a commutation route ''(in some cases)''
* Fixed customer filtering in the call list
* Minor bug fixes

== 3.21.42 - 24.08.2026 ==
* [[Import buildings from KAIS (BG)]]
* When moving from the planned commutation scheme to the scheme of a neighboring communications installation ''(the opposite object on the cable line)'', the scheme now opens immediately in split current/planned mode. If the planned scheme does not exist yet, the system offers to create it.
* Right-clicking splitter ports in the commutation scheme now opens the port context menu
* When adding a VLAN manually on equipment, a selector with that equipment's ports is shown
* Improved automatic building of U-shaped commutation routes in the commutation scheme
* In task status settings, the inventory item selection can now specify where the selected inventory items should be transferred ''(Customer/Task)'' and to which subaccount
* Added the ability to change adapter types for ports of sandbox splitters in the planned commutation scheme
* Added the ability to mass-commutate fibers/ports in the planned commutation scheme
* Changing the pigtail type for ports/fibers in the planned commutation scheme is now saved only there and does not affect the current commutation scheme
* When a split page with current/planned commutation schemes is displayed, both schemes can be exported to SVG with different export settings
* Fixed inaccuracies in SVG commutation scheme generation
* Fixed adding local UNC links in the WYSIWYG editor
* Fixed errors when sending email notifications ''(in some cases)''
* Fixed moving the commutation scheme position on the global commutation scheme ''(in some cases)''
== 3.21.41 - 21.08.2026 ==
* Optimized display of pop-up hints on the coverage map
* Fixed changing the number of adapters during hot splitter replacement
* Fixed SVG files display in the attached-file gallery ''(in some cases)''
* Fixed an error when viewing a commutation route point on the coverage map
* Fixed an error when opening an equipment card from a task card ''(in some cases)''
* Fixed route changes on the map for cable routes
* Fixed employees being shown as dismissed in selectors ''(in some cases)''
* Fixed object scaling on the map ''(in some cases)''
* Fixed notes display in the customer list
* Fixed ping for an arbitrary IP address
* Minor bug fixes

== 3.21.40 - 17.08.2026 ==
* In the planned commutation scheme, cable lines can now be added from the context menu, including lines with capacities of 12 and 48
* A separate "Comments" right has been added for task types
* For equipment, a list of dependent customers can now be built for specific required ports
* The hot splitter replacement dialog has been redesigned: a splitter can now be selected from all available warehouses
* In the commutation scheme, the workspace boundary is now draggable, allowing the commutation-scheme field size to be changed quickly
* The commutation scheme now supports quickly commutating N fibers/ports of devices with each other ''(starting from the current one, with the existing commutation broken)''
* Fixed duplicate employee display in the department employee list ''(in some cases)''
* Fixed table entries display according to each employee's own setting for the number of records in a table
* Fixed loading the list of automatic executors for tasks ''(in some cases)''
* Minor bug fixes

== 3.21.39 - 14.08.2026 ==
* Improved the appearance of pop-up comments in the task list
* Fixed equipment port selection when switching a busy port
* Minor bug fixes

== 3.21.38 - 13.08.2026 ==
* Fixed attaching files in additional fields for new objects
* Minor bug fixes

== 3.21.37 - 12.08.2026 ==
* Minor bug fixes

== 3.21.36 - 09.08.2026 ==
* Added "sandbox" functions to the planned commutation scheme: cable lines and splitters can be created without binding them to real objects. Existing objects can be hidden. Additional display buttons were added.
* Added the transport archive
* Added the new "Department. Exclude with all its employees" action to task-type action chains
* Added the "Hide the working note by addresses in this task type" property to task-type settings

== 3.21.35 - 08.08.2026 ==
* Minor bug fixes

== 3.21.34 - 07.08.2026 ==
* For a communications installation type, a hotkey can now be configured for quickly adding an object of that type to the map
* Added a context menu to the commutation scheme, allowing a planned splitter of the required type to be added quickly
* Right-clicking an object in the commutation scheme now immediately opens its context menu
* Fixed editing CWDM parameters in the product catalog
* Fixed splitting available inventory items for an employee profile that has access only to its own accountability balance

== 3.21.33 - 06.08.2026 ==
* The commutation scheme can now be split into two panes to show the current and planned schemes. The planned scheme also now supports changing object positions, port direction, and alternative cable entries
* Added the ability to bulk-select objects lower in the list in group actions for object lists
* Fixed some migration errors

== 3.21.32 - 05.08.2026 ==
* When adding a cable line from the coverage map through several intermediate communications installations, it is now possible to mark exactly which intermediate installations should split the line and whether commutation between those segments should be preserved
* Fixed partial information copying in the device list ''(in some cases)''
* Fixed an error during bulk receipt of inventory items ''(in some cases)''
* Fixed color assignment for any splitter port
* Fixed displaying information about unfinished current tasks in the customer card
* Fixed employee selector operation ''(in some cases)''

== 3.21.31 - 02.08.2026 ==
* Added printing of the entire global commutation scheme
* Cable lines can now be created from the map through all intermediate communications installations at once ''(not only from the start object to the end object)''
* Added an exclusion by label/custom-field value on the customer for SMS mailings
* Added the ability to change the route of planned commutation in the planned commutation scheme
* Labels can now be assigned separately to legal-entity customers, individual customers, and/or potential customers
* The incoming-call pop-up can be shown at the top/bottom and left/center/right. It can also be configured to show customer notes
* The logical building scheme can now define the structure of each entrance separately
* Fixed task filtering after group actions with tasks are completed
* Fixed file attachment when changing a task status
* Fixed IP-address search in the switch list ''(in some cases)''

== 3.21.30 - 31.07.2026 ==
* The building card can now use arbitrary entrance numbering ''(including text entrance names)''
* Added a coordinate editing link to the polygon card
* Added filtering by customer presence to the message list, plus a group action to assign/remove a label on customers from those messages
* Added the ability to hide customers and commutations to them in the logical building scheme
* Added filtering by inventory item name/category to the inventory balance report
* The customer card now supports entering coordinates manually in edit mode or changing them on the map
* Access rights by employee profile can now be assigned to a label
* Fixed an error when viewing customer history ''(in some cases)''

== 3.21.29 - 30.07.2026 ==
* Added the new "Manage own accountability balance" right to employee profiles
* For each task type, the labels used in tasks of that type can now be configured
* A customer category can now be selected for a task type ''("Legal entities", "Individuals")''
* Added sorting by various fields to the work statement
* Fixed mentioning employees in task comments
* Fixed adding a cable route from the coverage map
* Fixed an error when excluding a level in the logical building scheme ''(in some cases)''

== 3.21.28 - 29.07.2026 ==
* Added filtering by custom-field value to the inventory item list
* Each employee can now configure main-page auto-refresh for themselves
* Fixed an error in the "Today's task list" main-page widget
* Fixed selecting inventory items to add to an operation
* Fixed correct opening of a customer card in the logical building scheme
* Fixed commutation break without reloading the page in the commutation scheme
* Fixed the address-object selector for employees with restricted address rights

== 3.21.27 - 28.07.2026 ==
* Added the new "Warehouse - Reports" right for employee profiles
* For each communications installation type, the display of its number/name on the map can now be enabled or disabled separately, and a number/name generation template can be configured
* Added the new "Distribution frame/ODF" custom-field type
* Added KML export for connection-route calculation results
* Added configurable "Cable color schemes". They can be used freely to change cable-line coloring.
* For a cable line, conductor coloring can be copied from other cable lines present in the communications installations where this cable line ends.
* Fixed opening a specific inventory item card by its ID from the left menu
* Fixed polygon color display on the coverage map ''(in some cases)''
* Fixed display of multi-line labels on the coverage map
* Fixed an error when opening a rack/cabinet card ''(in some cases)''

== 3.21.26 - 27.07.2026 ==
* Added the ability to plan commutation breaks in planning mode in the commutation scheme
* Added the "Nominal and SNMP equipment name" report to "Switches"
* Employee profiles can now configure which categories an employee is allowed to move inventory items to
* The right to view written-off inventory items was separated for employee profiles ''(previously viewing and editing were together)''
* Added the "Customer. Creation" action to task chains/automation
* Splitter ports can now have colors assigned
* In the ONU-by-device list, the interface-name filter can now select several device interfaces at once
* Several customers can now be added at once when editing a task
* Added the ability to create a copy of the current task from the task card
* Fixed equipment selection for hot device replacement

== 3.21.25 - 25.07.2026 ==
* If a task chain/automation is configured for a task status change, this information is shown in the tooltip on the task status
* Improved processing of phone numbers in task-card custom fields to match the required system format
* Added the "Commutation scheme. Label color" parameter for cable brands in the cable catalog
* Changes to a customer's custom coordinates are recorded in the action history
* Fixed access-right checks when viewing attached files for a customer
* Fixed sending employee notifications about equipment unavailability/activity ''(in some cases)''

== 3.21.24 - 24.07.2026 ==
* When the login page is opened by an already authenticated user, the system home page opens
* The inventory list can visually group inventory items by name ''(combine several inventory items into one group to quickly understand the quantity of items with that name on an object)''
* Improved color highlighting for planned cable lines
* Fixed access checks for address objects ''(in some cases)''

== 3.21.23 - 23.07.2026 ==
* Added progress display for communications installation import
* Fixed saving chat_id for an employee ''(in some cases)''
* Fixed displaying notes in customer history

== 3.21.22 - 22.07.2026 ==
* Map labels are shown with a white halo for better readability
* Fixed an error when viewing employee action history ''(in some cases)''
* Fixed inability to remove linked objects from a task ''(in some cases)''
* Fixed sorting of linked tasks in the task card

== 3.21.21 - 21.07.2026 ==
* '''Added SVG export for the global commutation scheme'''
* Documents can now be generated from an inventory item card for that item
* Fixed an error when opening an inventory operation ''(in some cases)''
* Fixed editing access parameters for system devices
* Fixed commutation to system device ports
* Fixed display of the interface/stacking list for a device ''(in some cases)''
* Fixed floor deletion in the building structure

== 3.21.20 - 20.07.2026 ==
* Added address object search to the employee address-access assignment dialog
* Added quick note-clear buttons for distribution frame/ODF ports in the commutation scheme
* Minor bug fixes

== 3.21.19 - 18.07.2026 ==
* Added the "Allow matching object numbers for different settlements" property for communications installation types
* Added a setting for address unit types that defines which parent address units they can be added under ''(for example, "streets" only under "cities", and so on)''
* Editing access for address object types can now be configured by employee profiles
* Improved display of always-full employee names in the employee list
* Fixed multiplexer operations on the commutation scheme
* Fixed display of a newly added cable line type in the left menu

== 3.21.18 - 17.07.2026 ==
* Customer icons on the coverage map are shown with an outline color that matches the customer's label color
* Added filtering by the value of a custom field on the task address to the task list
* Minor bug fixes

== 3.21.17 - 16.07.2026 ==
* '''Equipment can now be installed on a building ''(previously only on a communications installation or customer)'''''
* '''A cable line can now start at a customer or building ''(previously only at a communications installation)'''''
* Added the "Total subscription fee" field to the customer list, with filtering support
* Fixed an error when viewing cable-fiber commutation history ''(in some cases)''
* Fixed saving the selected type group for communications installation type properties
* Fixed cable brand search when adding a cable line ''(in some cases)''

== 3.21.16 - 15.07.2026 ==
* '''Distribution frames/ODFs and splitters can now be installed at customers or on buildings'''
* Added a selector with existing OLT PON interfaces to interface filtering in the ONU-by-OLT list
* Fixed operations in the planned commutation scheme
* Fixed personnel sorting by department in the department list
* Fixed adding inventory with an IP/MAC address
* Fixed display of cable-fiber history

== 3.21.15 - 14.07.2026 ==
* Task types can now be limited to customers from specific groups
* Added the ability to send messages to all company employees with an optional deletion date
* Fixed the department card appearance during editing
* Fixed rebuilding child schemes when dragging a commutation scheme on the global scheme
* Fixed the "When changing the building polygon, display other objects on the map" parameter ''(in some cases)''
* Fixed inability to select a building when creating a new task

== 3.21.14 - 13.07.2026 ==
* '''Added the ability to link inventory items to a task ''(such as equipment, customer, and so on)'' without transferring the items to the task itself. This is used to track completion of tasks related to inventory items.'''
* Added a new "Inventory movement" report to inventory reports
* Building list filtering now supports filtering by the presence or absence of a communications installation on the building
* Added a new employee profile right: "Settings - Task statuses"
* Work calendar filters now let users configure their own order and visibility of departments and employees in the calendar
* Reworked the department list section. The appearance was changed, and quick search by employee/department was added
* When creating a new building in the address selection block, the new address is inserted immediately without reloading the current page
* Search results in the address selection block now show buildings and other address object types, making it faster to add new buildings, streets, and similar objects
* Improved the task card appearance on mobile devices
* Fixed coverage map performance when displaying the "Employees and vehicles" layer
* Fixed filtering in the building list ''(in some cases)''
* Fixed PDF file preview in the browser ''(in some cases)''
* Fixed filtering in the debtor customer list
* Fixed display of the "Settings-Addresses" section for employees with geography-limited access
* Fixed fiber rendering on the commutation scheme when a fiber has a label
* Fixed an error when displaying current-day tasks in the work calendar ''(in some cases)''

== 3.21.13 - 10.07.2026 ==
* '''When receiving inventory, multiple different inventory item names can now be specified at once'''
* Improved display of completed tasks in the calendar
* In the commutation scheme, splitters and distribution frames now have action buttons in object menus, as in the object cards ''(edit, delete, structural scheme, and so on)''
* Fixed commutation in the commutation scheme ''(in some cases)''
* Fixed duplicate requests during automatic ONU signal level refresh when opening an ONU card
* Fixed the task history appearance
* Fixed editing coverage map settings ''(in some cases)''
* Fixed object selection on the global commutation scheme ''(in some cases)''
* Fixed access-right checks for the ONU list for employees
* Fixed the rack/cabinet card appearance in the dark interface theme

== 3.21.12 - 09.07.2026 ==
* Improved API->[[API_redirect_EN|redirect]] method
* When splitting inventory into several parts, attached files are linked to all resulting inventory items
* Improved the cable line add dialog opened from a communications installation
* Added the setting parameter "Display completed tasks with opacity (%)"
* Fixed the "Display completed tasks in gray" setting parameter
* Fixed display of the MAC address field when receiving inventory
* Fixed additional field dependency handling
* Fixed attached-file handling in vehicle operations
* Fixed navigation to communications installation table field settings
* Fixed task information appearance on the "Technical support" tab in the customer card
* Fixed errors when viewing user action history ''(in some cases)''
* Fixed an error when opening the inventory selection dialog for integration
* Fixed moving object positions on the global commutation scheme
* Fixed reserve specification for cable lines
* Fixed an error when receiving inventory and auto-assigning inventory numbers ''(in some cases)''
* Fixed employee access settings for addresses

== 3.21.11 - 08.07.2026 ==
* Fixed the appearance of the task type rights settings table
* Fixed changing the position of a separate communications installation commutation scheme on the shared global commutation scheme
* Fixed task filtering in the "My tasks" section ''(in some cases)''
* Fixed changing address object coordinates from the building card
* Fixed assignee sorting when creating a task
* Fixed changing sector coordinates for radio equipment
* Fixed access-right checks when opening a device card ''(in some cases)''
* Fixed hiding/showing a communications installation on the coverage map

== 3.21.10 - 07.07.2026 ==
* Added API->call->[[API_call_EN#edit|edit]] method
* Added new user profile rights "Owners (access to financial information)" and "Tenants (access to financial information)"
* '''Implemented inventory transfer to an employee with employee confirmation of receipt/refusal'''
* In group actions for communications installations, creating a common task or separate tasks now creates tasks through the standard task-add dialog
* Fixed marking a task as read in news when opening the task card
* Fixed display of the latest inventory operation date in the list of inventory by object
* Fixed document print generation from the task card
* Fixed commutation of free cable fibers to each other ''(in some cases)''
* Fixed editing coordinates for a communication line
* Fixed display of stray artifacts on the global commutation scheme ''(in some cases)''
== 3.21.9 - 06.07.2026 ==
* SMS mailing exclusions can now exclude customers with a specific period of negative balance
* The "Problem buildings/customers" statistics can now use custom filters
* In task type settings, the additional fields section now separately specifies the additional field types that can be used when changing task status. Task status settings also now include the "Display additional fields" property
* Added the ability to automatically create a work task for unanswered phone calls
* User password changes were moved to a separate dialog window

== 3.21.8 - 04.07.2026 ==
* Improved API method API->customer->[[API_customer_EN#get_customers_id|get_customers_id]]
* Improved the appearance of tasks in the work calendar
* In group actions for customers, task creation now uses a full dialog for specifying properties of the tasks being created
* Optimized the structural scheme
* Fixed setting conditions in SMS mailings ''(in some cases)''
* Fixed setting custom coordinates for a customer
* Fixed saving a system device
* Fixed object display on the global commutation scheme ''(in some cases)''
* Fixed commutating a cable line to a device in the customer's commutation scheme
* Fixed changing custom coordinates for equipment
* Fixed the tariff exclusion filter in SMS mailings

== 3.21.7 - 03.07.2026 ==
* Planning mode in the work calendar
* Fixed search in the communications installation list ''(in some cases)''
* Fixed attached-file display in a communications installation card when the user has read-only rights
* Fixed viewing/creating SMS mailings ''(in some cases)''
* Fixed signal level display for ONU ''(in some cases)''
* Fixed attenuation display on the structural scheme for OLT ''(in some cases)''
* Fixed an error when viewing employee history ''(in some cases)''
* Fixed incorrect activity date output in the coverage map tooltip for transport
* Fixed the ability to exclude a customer from a task

== 3.21.6 - 02.07.2026 ==
* Added IP address usage history
* Improved use of the ruler on the coverage map
* Fixed cable line appearance on the coverage map according to tag settings ''(in some cases)''
* Fixed the equipment list in the "Inactive switches" home-page widget
* Fixed adding new communications installation schemes to the global commutation scheme
* Fixed equipment database search when adding an inventory item name to the product catalog
* Fixed clearing equipment port commutation ''(in some cases)''
* Fixed an error in the inventory balance report ''(in some cases)''
* Fixed specifying custom reserves/objects on a cable line route
* Fixed switching commutation to a port of another device on a communications installation
* Fixed object display on the coverage map in group operations for communications installations
* Fixed changing the commutation path in the commutation scheme ''(in some cases)''

== 3.21.5 - 01.07.2026 ==
* Added notifications when editing a task ''(configurable)''
* Improved collecting information from ONU interfaces
* Improved equipment port appearance for the dark theme
* Task types can now specify actions with inventory: transfer the required inventory currently assigned to a customer from that customer to the selected warehouse
* Fixed quick search by the required equipment category in the equipment list
* Fixed selection of other devices on the same communications installation in the port switching dialog
* Fixed display of warehouses available to an employee ''(in some cases)''
* Fixed an error when viewing an inventory item card ''(in some cases)''
* Fixed automatic building selection when adding a communications installation from a building card
* Fixed viewing the list of polled devices in the usm_observer module
* Fixed the ability to change the color of a connection between devices in the commutation scheme

== 3.21.4 - 30.06.2026 ==
* Improved API method API->attach->[[API_attach_EN#upload|upload]]
* Added a separate email notification profile for sending messages to corporate customers
* Improved sorting by building in the communications installation list
* The work calendar opens on the current date
* Improved the task calendar for cases where several tasks are scheduled for the same time
* Implemented multilevel task type groups
* Task news can now partially mark events as read and group news by task
* Task automation can now send Email messages to customers ''(using configurable templates)''
* Improved popup notification output when assigning an employee department to a task
* Fixed attached-file block display in custom sections when the user has read-only rights
* Fixed opening a customer card from the coverage map
* Fixed an error when configuring status availability for employee profiles in a task type card
* Fixed filtering by dates in the task list ''(in some cases)''
* Fixed task author display in the task list
* Fixed display of the "Notes" field in the communications installation card
* Fixed an error when trying to delete an address object ''(in some cases)''
* Fixed the ability to disable/enable a device port
* Fixed viewing global commutation schemes ''(in some cases)''

== 3.21.3 - 28.06.2026 ==
* Improved API method API->inventory->[[API_inventory_EN#transfer_inventory|transfer_inventory]]
* Improved API method API->commutation->[[API_commutation_EN#delete|commutation]]
* Improved API method API->node->[[API_node_EN#get|get]]
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* The scheduler task "Send low-stock information" can now specify the delivery options "E-mail/Messenger"; the employee card also now lets you specify delivery options for this mailing in the "Notifications" section
* The inventory list in the task card can now transfer all inventory items to the selected recipient at once
* Quick value search was added to custom fields of the "List selection" type
* Improved the use of explicitly specified coordinates when editing a building card and selecting a polygon/point
* Fixed creating cable lines to a building from the coverage map
* Fixed an error when opening Settings - Modules ''(in some cases)''
* Fixed grouping in the task list ''(in some cases)''
* Fixed deleting a label from the switching scheme
* Fixed the "Show dismissed employees in selectors/search for N days after dismissal" parameter
* Fixed warehouse availability checks when selecting inventory items during task execution
* Fixed the "Show tasks by actual completion date" variable
* Fixed using task-type appearance color settings in the calendar
* Fixed coverage-map search ''(substituting the current locality in the search window)''
* Fixed navigation from a customer card to the map with the customer's building coordinates
* Fixed saving interfaces/stacking in the device card

== 3.21.2 - 26.06.2026 ==
* Improved API method API->address->[[API_address_EN#get_house|get_house]]
* When transferring inventory from a customer card, the sub-account receiving the inventory can now be selected
* When creating/editing a task for a building, information about building tags and the building note is shown
* When creating a task in a chain, a specific custom assignee/department can be specified separately
* Bulk inventory transfer now creates combined transfer operations instead of separate operations for each item
* The task list filter-result grouping now has a "Completion date (month)" option
* Fixed an error when creating a task ''(in some cases)''
* Fixed changing coordinates in building, communications installation, and customer cards ''(in some cases)''
* Fixed generation of communications-installation names when selecting a building floor ''(in some cases)''
* Fixed link handling in text values of custom fields
* Fixed assigning assignees when creating a task ''(in some cases)''

== 3.21.1 - 25.06.2026 ==
* Improved map centering when editing a polygon/building on the coverage map
* Fixed displaying global switching schemes ''(in some cases)''
* Fixed exporting the cable line list to XLS ''(in some cases)''
* Fixed correct rendering of customers on the building logical scheme ''(in some cases)''
* Fixed selecting parent objects when adding a building from the coverage map
* Fixed attaching a customer when adding a new task for a customer
* Fixed minor bugs

== 3.21.0 - 23.06.2026 ==
* Version release

== 3.21.0-beta.7 - 21.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.6 - 20.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.5 - 17.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.4 - 13.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.3 - 07.06.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.2 - 30.05.2026 ==
* Fixes based on beta testing results

== 3.21.0-beta.1 - 24.05.2026 ==
* See the list of changes in [[3.21_EN|3.21]]

API map UK

2026-09-25T14:52:05Z

IronBot: [IronBot] Sync localization from RU

[[API_map_EN|en]] | '''uk''' | [[API map|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Робота з картами покриття

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add_label ====

''Додано у: 3.19beta1''

Опис: Додавання напису
Обов'язкові параметри:
lat - широта
lon - довгота
text - текст напису

==== add_poly ====

''Оновлено у версії 3.21.62 (додано параметри border_color і description)''

''Додано у: 3.18beta1''

Опис: Додавання полігона
Обов'язкові параметри:
coord - координати ''(через кому)''
name - найменування
Необов'язкові параметри:
border_color - HTML-колір межі
color - HTML-колір полігона
description - нотатки

==== check_entry_point_in_polygon ====
''Додано у: 3.14.69''
Опис: Список полігонів, у які входить точка
Обов'язкові параметри:
lat - широта точки
lon - довгота точки

==== delete_poly ====

''Додано у: 3.21.62''

Опис: Видалення полігона
Обов'язкові параметри:
id - id об'єкта

==== edit_label ====

''Додано у: 3.19beta1''

Опис: Зміна напису
Обов'язкові параметри:
id - id об'єкта
Необов'язкові параметри:
lat - широта
lon - довгота
text - текст напису

==== edit_poly ====

''Оновлено у версії 3.21.62 (додано параметри border_color і description)''

''Додано у: 3.19beta1''

Опис: Зміна полігона
Обов'язкові параметри:
id - id об'єкта
Необов'язкові параметри:
border_color - HTML-колір межі
color - HTML-колір полігона
coord - координати ''(через кому)''
description - нотатки
name - найменування

==== get ====
''Додано у: 3.12.10''
Опис: Список об'єктів
Необов'язкові параметри:
id - перелік ID об'єктів ''(через кому)''

==== get_poly ====
''Додано у: 3.12.80''
Опис: Список полігонів
Необов'язкові параметри:
id - перелік ID об'єктів ''(через кому)''

==== map_object_facilities_inside ====
''Додано у: 3.19.4''
Опис: Отримання списку об'єктів, що знаходяться всередині об'єкта на карті ''(наприклад, всередині полігона)''
Обов'язкові параметри:
id - id об'єкта

==== map_object_mark_add ====
''Додано у: 3.19.3''
Опис: Додавання мітки на об'єкті на карті
Обов'язкові параметри:
id - id об'єкта
mark_id - id мітки

==== map_object_mark_delete ====
''Додано у: 3.19.3''
Опис: Видалення мітки з об'єкта на карті
Обов'язкові параметри:
id - id об'єкта
mark_id - id мітки

API map EN

2026-09-25T14:52:03Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[API_map_UK|uk]] | [[API map|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Coverage map management

Optional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add_label ====

''Added in: 3.19beta1''

Description: Add labelling
Required parameters:
lat - latitude
lon - longitude
text - text of inscription

==== add_poly ====

''Updated in: 3.21.62 (added border_color and description parameters)''

''Added in: 3.18beta1''

Description: Add polygon
Required parameters:
coord - coordinates ''(comma separated)''
name - name
Optional parameters:
border_color - HTML color of the border
color - HTML color of the polygon
description - notes

==== check_entry_point_in_polygon ====
''Added in: 3.14.69''
Description: List of polygons that include a point
Required parameters:
lat - latitude of the point
lon - longitude of the point

==== delete_poly ====

''Added in: 3.21.62''

Description: Delete a polygon
Required parameters:
id - object ID

==== edit_label ====

''Added in: 3.19beta1''

Description: Edit label
Required parameters:
id - id of the object
Optional parameters:
lat - latitude
lon - longitude
text - text of the inscription

==== edit_poly ====

''Updated in: 3.21.62 (added border_color and description parameters)''

''Added in: 3.19beta1''

Description: Edit polygon
Required parameters:
id - id of the object
Optional parameters:
border_color - HTML color of the border
color - HTML color of the polygon
coord - coordinates ''(comma separated)''
description - notes
name - name

==== get ====
''Added in: 3.12.10''
Description: List of objects
Optional parameters:
id - list of object IDs ''(comma separated)''

==== get_poly ====
''Added in: 3.12.80''
Description: List of polygons
Optional parameters:
id - list of object IDs ''(comma separated)''

==== map_object_facilities_inside ====
''Added in: 3.19.4''
Description: Retrieve the list of objects located inside an object on the map ''(for example inside a polygon)''
Required parameters:
id - object id

==== map_object_mark_add ====
''Added in: 3.19.3''
Description: Add a mark to an object on the map
Required parameters:
id - object id
mark_id - mark id

==== map_object_mark_delete ====
''Added in: 3.19.3''
Description: Delete a mark from an object on the map
Required parameters:
id - object id
mark_id - mark id

API task UK

2026-09-25T14:52:01Z

IronBot: [IronBot] Sync localization from RU

[[API_task_EN|en]] | '''uk''' | [[API task|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Робота із завданнями

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add ====
''Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)''

''Доопрацьовано у: 3.18.43 (додано параметр device_id)''

''Доопрацьовано у: 3.18.29 (додано параметр deadline_hour)''

''Доопрацьовано у: 3.17dev1 (виключено параметри usercode, uzelcode і додано параметри customer_id, node_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметри unit_id, author_operator_id і додано параметри employee_id, author_employee_id)''

''Доопрацьовано у: 3.12.84 (додано параметр parent_task_id)''

''Доопрацьовано у: 3.12.38 (додано параметри unit_id, division_id)''

''Доопрацьовано у: 3.12.26 (додано параметр work_amount)''

''Доопрацьовано у: 3.12beta31 (додано параметр author_operator_id)''

Опис: Створення завдання

Обов'язкові параметри:
work_typer - ID типу завдання

Необов'язкові параметри:
apart - номер квартири
address_id - ''(для версії 3.13 і пізніше)'' id адресної одиниці
author_employee_id - ID співробітника-автора завдання
author_operator_id - ID оператора-автора завдання ''(до версії 3.16dev2)''
citycode - ''(для версії 3.12 і раніше)'' id населеного пункту. Якщо не вказано, то береться з даних за будинком housecode
customer_id - ''(для версії 3.17 і пізніше)'' ID абонента
deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)''
device_id - ID обладнання
division_id - ID підрозділу ''(допускається кілька значень через кому)''
dopf_N - значення додаткового поля для поля ID N
employee_id - ID виконавця ''(допускається кілька значень через кому)''
fio - ПІБ клієнта ''(мається на увазі, що "клієнт" ще не є абонентом)''
housecode - ''(для версії 3.12 і раніше)'' id будівлі. Якщо не вказано, то береться з даних за абонентом - customer_id, або з даних за об'єктом інфраструктури - node_id
is_high_priority - прапорець - високий пріоритет
node_id - ''(для версії 3.17 і пізніше)'' ID об'єкта інфраструктури
opis - нотатки до завдання
parent_task_id - ID батьківського завдання
unit_id - ID виконавця ''(допускається кілька значень через кому) (до версії 3.16dev2)''
usercode - ''(для версії 3.16 і раніше)'' ID абонента
uzelcode - ''(для версії 3.16 і раніше)'' ID об'єкта інфраструктури
work_amount - обсяг робіт
work_datedo - дата, на яку призначено виконання завдання

==== add_cable_line_to_task ====
''Додано у: 3.20.2''

Опис: Додавання кабельної лінії до завдання

Обов'язкові параметри:
task_id - id завдання
cable_line_id - id кабельної лінії

==== add_customer_to_task ====
''Додано у: 3.13.70''

Опис: Додавання абонента до завдання

Обов'язкові параметри:
task_id - id завдання
customer_id - id абонента

==== add_device_to_task ====
''Додано у: 3.19beta1''

Опис: Додавання обладнання до завдання

Обов'язкові параметри:
task_id - id завдання
device_id - id обладнання

==== add_node_to_task ====
''Додано у: 3.20.17''

Опис: Додавання об'єкта інфраструктури до завдання

Обов'язкові параметри:
task_id - id завдання
node_id - id об'єкта інфраструктури

==== add_owner_to_task ====
''Додано у: 3.19.19''

Опис: Додавання власника до завдання

Обов'язкові параметри:
task_id - id завдання
owner_id - id власника

==== change_date_work ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.12.83''

Опис: Зміна дати і часу виконання завдання ''(дата, на яку призначені роботи)''

Обов'язкові параметри:
id - id завдання
value - дата
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== change_state ====
''Оновлено у версії 3.21.61 (додано параметр is_ignore_required_comment)''

''Оновлено у версії 3.21.56 (додано параметр comment)''

''Доопрацьовано у: 3.20.3 (додано параметр date_hold)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

Опис: Зміна стану (статусу) завдання

Обов'язкові параметри:
id - id завдання
state_id - id стану завдання
Необов'язкові параметри:
employee_id - id співробітника, від імені якого змінювати стан
operator_id - id оператора, від імені якого змінювати стан ''(до версії 3.16dev2)''
comment - коментар ''(обов'язковий, якщо в налаштуваннях статусу ввімкнено параметр «Потрібно вказати коментар»)''
date_hold - дата/час, до якої відкласти завдання ''(під час переведення у статус з роллю "Відкладено")''
is_ignore_required_comment - прапорець: не перевіряти обов'язковість коментаря

==== check_verify_code ====
Опис: Перевірка коду підтвердження для виконання заявки

Обов'язкові параметри:
id - ID завдання
verify_code - код підтвердження

==== checklist_item_check ====
''Додано у: 3.17dev1''

Опис: Позначення пункту чек-листа в завданні

Обов'язкові параметри:
id - id пункту чек-листа
task_id - id завдання
employee_id - id співробітника, від імені якого позначається пункт

==== checklist_item_uncheck ====
''Додано у: 3.17dev1''

Опис: Зняття позначення з пункту чек-листа в завданні

Обов'язкові параметри:
id - id пункту чек-листа
task_id - id завдання

==== comment_add ====
''Доопрацьовано у: 3.17dev1 (додано параметр dateadd)''

''Доопрацьовано у: 3.16.19 (додано параметр reply_comment_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.12.89 (додано параметр author_operator_id)''

Опис: Додавання коментаря

Обов'язкові параметри:
id - ID завдання
comment - текст
Необов'язкові параметри:
dateadd - дата й час коментаря
employee_id - id співробітника, від імені якого додається коментар
operator_id - id оператора, від імені якого додається коментар ''(до версії 3.16dev2)''
reply_comment_id - id коментаря, на який відповідаємо

==== comment_edit ====

''Додано у: 3.18beta1''

Опис: Зміна коментаря

Обов'язкові параметри:
id - ID коментаря
task_id - ID завдання
body - текст

==== delete ====
''Додано у: 3.14.35''

Опис: Видалення завдання

Обов'язкові параметри:
id - id завдання

==== division_add ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.13.36''

Опис: Додавання підрозділу

Обов'язкові параметри:
id - id завдання
division_id - id підрозділу
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== division_delete ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Додано у: 3.13.36''

Опис: Вилучення підрозділу

Обов'язкові параметри:
id - id завдання
division_id - id підрозділу
Необов'язкові параметри:
employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== edit ====

''Доопрацьовано у: 3.20.23 (додано параметр customer_name)''

''Доопрацьовано у: 3.19.41 (додано параметр author_employee_id)''

''Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)''

''Доопрацьовано у: 3.19.15 (додано параметр job_time_hour)''

''Доопрацьовано у: 3.19.12 (додано параметр apartment)''

''Доопрацьовано у: 3.18.30 (додано параметр deadline_hour)''

''Доопрацьовано у: 3.18beta1 (додано параметр address_id)''

''Доопрацьовано у: 3.16dev3 (додано параметр type_id)''

''Доопрацьовано у: 3.15.12 (додано параметр parent_task_id)''

''Додано у: 3.13.18''
Опис: Зміна завдання

Обов'язкові параметри:
id - id завдання
Необов'язкові параметри:
address_id - id адресної одиниці
apartment - номер квартири
author_employee_id - id співробітника - автора завдання
customer_name - довільне ім'я/назва клієнта ''(без прив'язки до абонента)''
body - текст завдання ''(описова частина)''
deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)''
is_high_priority - прапорець - високий пріоритет
job_time_hour - час на виконання завдання ''(з дати початку робіт. У годинах)''
parent_task_id - id батьківського завдання
type_id - id типу завдання

==== employee_add ====
''Додано у: 3.16dev2''
Опис: Додавання виконавця

Обов'язкові параметри:
id - id завдання
employee_id - id виконавця
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''

==== employee_delete ====
''Додано у: 3.16dev2''
Опис: Вилучення виконавця

Обов'язкові параметри:
id - id завдання
employee_id - id виконавця
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''

==== get_allow_staff ====
''Додано у: 3.15.23''
Опис: Список виконавців і підрозділів, які доступні для призначення на завдання ''(згідно з налаштуваннями)''

Обов'язкові параметри:
id - id завдання

==== get_catalog_type ====
''Додано у: 3.12.22''
Опис: Типи завдань

Необов'язкові параметри:
id - id типу завдань ''(можна через кому)''

==== get_catalog_type_group ====
''Додано у: 3.16dev3''
Опис: Групи типів завдань

==== get_catalog_state ====
''Доопрацьовано у: 3.19.1 (додано параметр type_id)''

''Додано у: 3.12.22''

Опис: Класифікатор станів завдань

Необов'язкові параметри:
type_id - id типу завдання
state_id - id стану ''(можна через кому)''

==== get_comment ====
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.14.67 (додано параметр id)''

''Доопрацьовано у: 3.14.53 (додано параметр operator_id)''

''Доопрацьовано у: 3.13.50 (додано параметри date_add_from і date_add_to)''

''Додано у: 3.12.75''
Опис: Коментарі

Необов'язкові параметри ''(але має бути хоча б один)'':
id - id коментаря ''(можна через кому)''
task_id - id завдання ''(можна через кому)''
date_add_from - дата додавання коментаря ''(з)''
date_add_to - дата додавання коментаря ''(до)''
employee_id - id співробітника-автора коментаря
operator_id - id оператора-автора коментаря ''(до версії 3.16dev2)''

==== get_list ====

''Доопрацьовано у: 3.18.43 (додано параметр device_id)''

''Доопрацьовано у: 3.18.40 (додано параметр apart)''

''Доопрацьовано у: 3.18.30 (додано параметри change_operation_type, change_employee_id)''

''Доопрацьовано у: 3.18beta1 (додано параметр address_id)''

''Доопрацьовано у: 3.16dev3 (додано параметри task_position, task_position_radius, з параметра order_by виключені можливі значення customer_id і house_id)''

''Доопрацьовано у: 3.16dev2 (виключено параметри closer_operator_id, staff_id, author_id, watcher_id додано параметри closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''

''Доопрацьовано у: 3.15.23 (додано параметр is_expired)''

''Доопрацьовано у: 3.14.71 (додано параметр node_id)''

''Доопрацьовано у: 3.14.62 (додано параметр closer_operator_id)''

''Доопрацьовано у: 3.14.56 (додано параметр division_id_with_staff)''

''Доопрацьовано у: 3.14.41 (до параметра staff_id додано можливе значення -1)''

''Доопрацьовано у: 3.13.29 (додано параметри date_change_from, date_change_to)''

''Доопрацьовано у: 3.13.28 (до параметра order_by додано варіант date_change)''

''Доопрацьовано у: 3.12.91 (додано параметр watcher_id)''

''Доопрацьовано у: 3.12.83 (додано параметр author_id)''

''Доопрацьовано у: 3.12.78 (додано параметри order_by, limit, offset)''

''Доопрацьовано у: 3.12.62 (додано параметр customer_id)''

''Доопрацьовано у: 3.12.24 (додано параметри date_do_from, date_do_to)''

''Доопрацьовано у: 3.12beta29 (додано параметр house_id)''
Опис: Список завдань (ідентифікатори)

Необов'язкові параметри (умови вибірки):
address_id - ID адресного об'єкта ''(можна через кому)''
apart - номер квартири/приміщення
author_id - ID оператора - автора завдання ''(можна через кому) (до версії 3.16dev2)''
author_employee_id - ID співробітника - автора завдання ''(можна через кому)''
change_employee_id - ID співробітника - автора змін за завданням
change_operation_type - тип дій зі зміни завдання ''(можливі значення: add_comment, change_state)''
closer_employee_id - ID співробітника, який закрив ''(виконав)'' завдання ''(можна через кому)''
closer_operator_id - ID оператора, який закрив ''(виконав)'' завдання ''(можна через кому) (до версії 3.16dev2)''
customer_id - ID абонента ''(можна через кому)''
date_add_from - дата створення завдання (з)
date_add_to - дата створення завдання (до)
date_change_from - дата оновлення завдання (з)
date_change_to - дата оновлення завдання (до)
date_do_from - дата, на яку призначено виконання завдання (з)
date_do_to - дата, на яку призначено виконання завдання (до)
date_finish_from - дата виконання завдання (з)
date_finish_to - дата виконання завдання (до)
device_id - ID обладнання ''(можна через кому)''
division_id - ID підрозділу ''(можна через кому)''
division_id_with_staff - ID підрозділу ''(зокрема із завданнями співробітників цього підрозділу) (можна через кому)''
employee_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців)''
house_id - ID будинку робіт
is_expired - прапорець - виводити тільки прострочені завдання
node_id - ID об'єкта розміщення
staff_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців) (до версії 3.16dev2)''
state_id - ID статусу завдань ''(можна через кому)''
task_position - координати завдання ''(там, де це можливо. У форматі lat,lng. Напр: 40.245218,52.333384)''
task_position_radius - радіус від task_position ''(у метрах)''
type_id - ID типу завдань ''(можна через кому)''
watcher_id - ID оператора-спостерігача за завданням ''(можна через кому) (до версії 3.16dev2)''
watcher_employee_id - ID співробітника-спостерігача за завданням ''(можна через кому)''
order_by - поле для сортування ''(можливі варіанти: date_add, date_change, date_do, date_finish, state_id, type_id)''
limit - ліміт вибірки записів
offset - зміщення вибірки

==== get_related_task_id====
Опис: Список пов'язаних завдань із поточним завданням (ідентифікатори)

Обов'язкові параметри:
id - ID завдання

==== get_typical_comments ====
''Додано у: 3.14.70''

Опис: Отримання списку типових коментарів

==== mark_add ====
''Додано у: 3.19.24''
Опис: Додавання мітки на завдання
Обов'язкові параметри:
task_id - id завдання
mark_id - id мітки

==== mark_delete ====
''Додано у: 3.19.24''
Опис: Видалення мітки із завдання
Обов'язкові параметри:
task_id - id завдання
mark_id - id мітки

==== overview_task ====
''Додано у: 3.19.7''

Опис: Фіксація факту перегляду завдання співробітником

Обов'язкові параметри:
task_id - id завдання
employee_id - id співробітника

==== remove_cable_line_from_task ====
''Додано у: 3.20.2''

Опис: Вилучення кабельної лінії із завдання

Обов'язкові параметри:
task_id - id завдання
cable_line_id - id кабельної лінії

==== remove_customer_from_task ====
''Додано у: 3.15.23''

Опис: Вилучення абонента із завдання

Обов'язкові параметри:
task_id - id завдання
customer_id - id абонента

==== remove_node_from_task ====
''Додано у: 3.20.17''

Опис: Вилучення об'єкта інфраструктури із завдання

Обов'язкові параметри:
task_id - id завдання
node_id - id об'єкта інфраструктури

==== remove_owner_from_task ====
''Додано у: 3.19.19''

Опис: Вилучення власника із завдання

Обов'язкові параметри:
task_id - id завдання
owner_id - id власника

==== set_rate ====
''Додано у: 3.12.63''
Опис: Вказання індивідуального тарифу ''(для співробітників)'' за завданням

Обов'язкові параметри:
task_id - ID завдання
rate - тариф

==== show ====
''Доопрацьовано у: 3.21.48 (додано параметри is_without_history, is_without_attaches, is_without_task_statuses_history, is_without_views_history)''

''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)''

''Доопрацьовано у: 3.13.29 (у параметрі id можна подавати список через кому)''

''Доопрацьовано у: 3.13.25 (додано параметр is_without_comments)''

''Доопрацьовано у: 3.12.64 (додано параметр operator_id)''

Опис: Інформація про завдання

Обов'язкові параметри:
id - id завдання ''(можна через кому)''
Необов'язкові параметри:
employee_id - id співробітника, який переглядає це завдання ''(для фіксації в історії завдання)''
is_without_attaches - прапорець - не виводити прикріплені файли
is_without_comments - прапорець - не виводити коментарі в інформації за завданням
is_without_history - прапорець - не виводити історію дій
is_without_task_statuses_history - прапорець - не виводити історію зміни статусів
is_without_views_history - прапорець - не виводити історію переглядів
operator_id - id оператора, який переглядає це завдання ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== (*) staff_add ====
''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_add|employee_add]])''

''Додано у: 3.12.83''

Опис: Додавання виконавця

Обов'язкові параметри:
id - id завдання
staff_id - id виконавця
Необов'язкові параметри:
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)''

==== (*) staff_delete ====
''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_delete|employee_delete]])''

''Додано у: 3.12.83''

Опис: Вилучення виконавця

Обов'язкові параметри:
id - id завдання
staff_id - id виконавця
Необов'язкові параметри:
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)''

==== watcher_add ====
''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)''

''Додано у: 3.14.21''

Опис: Додавання спостерігача

Обов'язкові параметри:
id - id завдання
employee_id - id спостерігача
staff_id - id спостерігача ''(до версії 3.16dev2)''
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

==== watcher_delete ====
''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)''

''Додано у: 3.14.21''

Опис: Вилучення спостерігача

Обов'язкові параметри:
id - id завдання
employee_id - id спостерігача
staff_id - id спостерігача ''(до версії 3.16dev2)''
Необов'язкові параметри:
author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)''
operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)''

API task EN

2026-09-25T14:51:58Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[API_task_UK|uk]] | [[API task|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Working with tasks

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add ====
''Modified in: 3.18.29 (added deadline_hour parameter)''

''Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)''

''Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)''

''Modified in: 3.12.84 (added parent_task_id parameter)''

''Modified in: 3.12.38 (added unit_id, division_id parameters)''

''Modified in: 3.12.26 (added work_amount parameter)''

''Modified in: 3.12beta31 (added author_operator_id parameter)''

Description: Task creation

Required parameters:
work_typer - task TYPE ID

Optional parameters:
apart - flat number
address_id - ''(for version 3.13 and later)'' address unit id
author_employee_id - ID of the employee author of the task
author_operator_id - task author operator ID ''(before version 3.16dev2)''
citycode - ''(for version 3.12 and earlier)'' location id. If not specified, it is taken from housecode data.
customer_id - ''(for version 3.17 and later)'' customer ID
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
device_id - equipment ID
division_id - division ID ''(multiple values separated by commas are allowed)''
dopf_N - value of additional field for field ID N
employee_id - employee ID ''(several values separated by commas are allowed)''
fio - client full name ''(the client is not yet a customer)''
housecode - ''(for version 3.12 and earlier)'' building id. If not specified, it is taken from customer data - customer_id, or from infrastructure facility data - node_id
is_high_priority - flag - high priority
node_id - ''(for version 3.17 and later)'' infrastructure facility ID
opis - task notes
parent_task_id - ID of parent task
unit_id - executor ID ''(multiple values separated by commas are allowed) (before version 3.16dev2)''
usercode - ''(for version 3.16 and earlier)'' customer ID
uzelcode - ''(for version 3.16 and earlier)'' infrastructure facility ID
work_amount - scope of work
work_datedo - date on which the task is scheduled to run

==== add_customer_to_task ====
''Added in: 3.13.70''

Description: Add a customer to a task

Required parameters:
task_id - task id
customer_id - id of customer

==== add_device_to_task ====
''Added in: 3.19beta1''

Description: Add equipment to a task

Required parameters:
task_id - task id
device_id - equipment id

==== add_node_to_task ====
''Added in: 3.20.17''

Description: Add an infrastructure facility to a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== change_date_work ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.12.83''

Description: Change the date and time of the task ''(date on which the work is scheduled)''

Required parameters:
id - id of the task
value - date
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== change_state ====
''Updated in: 3.21.61 (added is_ignore_required_comment parameter)''

''Updated in: 3.21.56 (added comment parameter)''

''Updated in: 3.20.3 (added date_hold parameter)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

Description: Change task state (status)

Required parameters:
id - id of the task
state_id - task state id
Optional parameters:
employee_id - id of the employee on whose behalf to change the state
operator_id - id of the operator on whose behalf to change the state ''(before version 3.16dev2)''
comment - comment ''(required when the task status setting "Comment required" is enabled)''
date_hold - date/time until which to postpone the task ''(when moving to a state with the role Postponed)''
is_ignore_required_comment - flag - skip the required comment check

==== check_verify_code ====
Description: Checks the verification code to perform the request

Required parameters:
id - task ID
verify_code - verification code

==== checklist_item_check ====
''Added in: 3.17dev1''

Description: Marks a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id
employee_id - id of the employee on whose behalf the item is marked

==== checklist_item_uncheck ====
''Added in: 3.17dev1''

Description: Clear a checklist item in a task

Required parameters:
id - id of checklist item
task_id - task id

==== comment_add ====
''Modified in: 3.17dev1 (added dateadd parameter)''

''Modified in: 3.16.19 (added reply_comment_id parameter)''

''Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)''

''Modified in: 3.12.89 (added author_operator_id parameter)''

Description: Add comment

Required parameters:
id - task ID
comment - text
Optional parameters:
dateadd - date-time of the comment
employee_id - id of the employee on whose behalf the comment is made
operator_id - id of the operator on whose behalf the comment is added ''(before version 3.16dev2)''
reply_comment_id - id of the comment we are replying to

==== comment_edit ====

''Added in: 3.18beta1''

Description: Edit comment

Required parameters:
id - comment ID
task_id - task ID
body - text

==== delete ====
''Added in: 3.14.35''

Description: Delete a task

Required parameters:
id - id of the task

==== division_add ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Add a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== division_delete ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Added in: 3.13.36''

Description: Remove a division

Required parameters:
id - task id
division_id - id of division
Optional parameters:
employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== edit ====
''Modified in: 3.18.30 (added deadline_hour parameter)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added type_id parameter)''

''Modified in: 3.15.12 (added parent_task_id parameter)''

''Added in: 3.13.18''
Description: Task modification

Required parameters:
id - task id
Optional parameters:
address_id - id of the address unit
apartment - apartment number
author_employee_id - id of the employee who authored the task
customer_name - arbitrary customer name/title ''(without binding to a customer)''
body - text of the task ''(descriptive part)''
deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
is_high_priority - flag - high priority
job_time_hour - time to complete the task ''(from the start of work. In hours)''
parent_task_id - id of parent task
type_id - id of the task type

==== employee_add ====
''Added in: 3.16dev2''
Description: Add an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== employee_delete ====
''Added in: 3.16dev2''
Description: Remove an employee

Required parameters:
id - task id
employee_id - employee id
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''

==== get_allow_staff ====
''Added in: 3.15.23''
Description: List of performers and divisions that are available for assignment to a task ''(according to settings)''

Required parameters:
id - task id

==== get_catalog_type ====
''Added in: 3.12.22''
Description: Task types

Optional parameters:
id - task type id ''(can be comma separated)''

==== get_catalog_type_group ====
''Added in: 3.16dev3''
Description: Task type groups

==== get_catalog_state ====
''Added in: 3.12.22''
Description: Task state classifier

Optional parameters:
type_id - task type id
state_id - state id ''(can be comma separated)''

==== get_comment ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.14.67 (added id parameter)''

''Modified in: 3.14.53 (added operator_id parameter)''

''Modified in: 3.13.50 (added date_add_from and date_add_to parameters)''

''Added in: 3.12.75''
Description: Comments

Optional parameters ''(but there must be at least one)'':
id - id of comment ''(can be comma separated)''
task_id - task id ''(can be comma separated)''
date_add_from - comment creation date ''(from)''
date_add_to - comment creation date ''(to)''
employee_id - id of the employee-author of the comment
operator_id - id of the operator who authored the comment ''(before version 3.16dev2)''

==== get_list ====
''Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)''

''Modified in: 3.18beta1 (added address_id parameter)''

''Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)''

''Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''

''Modified in: 3.15.23 (added is_expired parameter)''

''Modified in: 3.14.71 (added node_id parameter)''

''Modified in: 3.14.62 (added closer_operator_id parameter)''

''Modified in: 3.14.56 (added division_id_with_staff parameter)''

''Modified in: 3.14.41 (added possible value -1 to staff_id parameter)''

''Modified in: 3.13.29 (added date_change_from, date_change_to parameters)''

''Modified in: 3.13.28 (added date_change to order_by parameter)''

''Modified in: 3.12.91 (added watcher_id parameter)''

''Modified at: 3.12.83 (added author_id parameter)''

''Modified at: 3.12.78 (added order_by, limit, offset parameters)''

''Modified at: 3.12.62 (added customer_id parameter)''

''Modified in: 3.12.24 (added date_do_from, date_do_to parameters)''

''Modified in: 3.12beta29 (added house_id parameter)''
Description: List of tasks (identifiers)

Optional parameters (sampling conditions):
address_id - ID of the address object ''(can be comma separated)''
apart - apartment/premises number
author_id - ID of the operator who authored the task ''(comma separated) (before version 3.16dev2)''
author_employee_id - ID of the employee who authored the task ''(can be comma separated)''
change_employee_id - ID of the employee - author of the task changes
change_operation_type - type of actions to change the task ''(possible values: add_comment, change_state)''
closer_employee_id - ID of the employee who closed ''(completed)'' the task ''(can be comma separated)''
closer_operator_id - ID of the operator who closed ''(completed)'' the task ''(can be comma separated) (before version 3.16dev2)''
customer_id - customer ID ''(can be comma separated)''
date_add_from - task creation date (from)
date_add_to - task creation date (to)
date_change_from - task update date (from)
date_change_to - task update date (to)
date_do_from - date on which the task is scheduled to be executed (from)
date_do_to - date on which the task is scheduled to be executed (to)
date_finish_from - date on which the task is executed (from)
date_finish_to - date on which the task is executed (to)
device_id - equipment ID ''(can be comma separated)''
division_id - division ID ''(can be comma separated)''
division_id_with_staff - division ID ''(including tasks of employees of this division) (can be comma separated)''
employee_id - employee ID ''(can be comma separated, use -1 to get tasks without employees)''
house_id - building ID
is_expired - flag - output only expired tasks
node_id - ID of the location object
staff_id - executor ID ''(can be comma separated, use -1 to get tasks without executors) (before version 3.16dev2)''
state_id - task status ID ''(can be comma separated)''
task_position - task coordinates ''(where possible. In lat,lng format. e.g. 40.245218,52.333384)''
task_position_radius - radius from task_position ''(in meters)''
type_id - task type ID ''(can be comma separated)''
watcher_id - task observer operator ID ''(comma separated) (before version 3.16dev2)''
watcher_employee_id - ID of the task observer employee ''(comma separated)''
order_by - sorting field ''(possible variants: date_add, date_change, date_do, date_finish, state_id, type_id)''
limit - record sampling limit
offset - sampling offset

==== get_related_task_id====
Description: List of related tasks to the current task (identifiers)

Required parameters:
id - task ID

==== get_typical_comments ====
''Added in: 3.14.70''

Description: Get list of typical comments

==== remove_customer_from_task ====
''Added in: 3.15.23''

Description: Remove a customer from a task

Required parameters:
task_id - task id
customer_id - customer id

==== remove_node_from_task ====
''Added in: 3.20.17''

Description: Remove an infrastructure facility from a task

Required parameters:
task_id - task ID
node_id - infrastructure facility ID

==== set_rate ====
''Added in: 3.12.63''
Description: Set an individual rate ''(for employees)'' for the task

Required parameters:
task_id - task ID
rate - rate

==== show ====
''Modified in: 3.21.48 (added is_without_history, is_without_attaches, is_without_task_statuses_history, is_without_views_history parameters)''

''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''

''Modified in: 3.13.29 (the id parameter can be a comma separated list)''

''Modified in: 3.13.25 (added is_without_comments parameter)''

''Modified in: 3.12.64 (added operator_id parameter)''

Description: Information about the task

Required parameters:
id - task id ''(can be comma separated)''
Optional parameters:
employee_id - id of the employee who is viewing this task ''(to be recorded in the task history)''
is_without_attaches - flag - do not display attached files
is_without_comments - flag - do not display comments in the task information
is_without_history - flag - do not display action history
is_without_task_statuses_history - flag - do not display status-change history
is_without_views_history - flag - do not display view history
operator_id - id of the operator who is viewing this task ''(to be recorded in the task history) (before version 3.16dev2)''

==== (*) staff_add ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_add|employee_add]])''

''Added in: 3.12.83''

Description: Add an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== (*) staff_delete ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_delete|employee_delete]])''

''Added in: 3.12.83''

Description: Remove an executor

Required parameters:
id - task id
staff_id - id of the executor
Optional parameters:
operator_id - id of the initiating operator ''(to be recorded in the task history)''

==== watcher_add ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Add observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== watcher_delete ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''

''Added in: 3.14.21''

Description: Remove an observer

Required parameters:
id - task id
employee_id - id of observer
staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
author_employee_id - id of the initiating employee ''(to be recorded in the task history)''
operator_id - id of the initiating operator ''(to be recorded in the task history) (before version 3.16dev2)''

==== add_cable_line_to_task ====
''Added in: 3.20.2''

Description: Add a cable line to a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== add_owner_to_task ====
''Added in: 3.19.19''

Description: Add an owner to a task

Required parameters:
task_id - task id
owner_id - owner id

==== mark_add ====
''Added in: 3.19.24''
Description: Add a mark to a task
Required parameters:
task_id - task id
mark_id - mark id

==== mark_delete ====
''Added in: 3.19.24''
Description: Delete a mark from a task
Required parameters:
task_id - task id
mark_id - mark id

==== overview_task ====
''Added in: 3.19.7''

Description: Record that an employee has viewed a task

Required parameters:
task_id - task id
employee_id - employee id

==== remove_cable_line_from_task ====
''Added in: 3.20.2''

Description: Remove a cable line from a task

Required parameters:
task_id - task id
cable_line_id - cable line id

==== remove_owner_from_task ====
''Added in: 3.19.19''

Description: Remove an owner from a task

Required parameters:
task_id - task id
owner_id - owner id

API device UK

2026-09-25T14:51:55Z

IronBot: [IronBot] Sync localization from RU

[[API_device_EN|en]] | '''uk''' | [[API device|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Обладнання

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== add_mark ====

''Змінено у 3.19beta1 (параметр object_type виключено)''

Опис: Додавання мітки
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
mark_id - ID мітки

==== get_connected_ont_information ====
''Додано у: 3.14.13''

Опис: Отримання інформації про підключені ONU до OLT ''(збережена інформація з бази. Пряме опитування не виконується)''
Необов'язкові параметри:
device_id - ID OLT ''(можна через кому)''
level_onu_rx_min - мінімальний вхідний рівень сигналу на ONU ''(вибрати записи з рівнем менше ніж...)''
level_onu_rx_max - максимальний вхідний рівень сигналу на ONU ''(вибрати записи з рівнем вище ніж...)''

==== get_current_ont_data ====

''Додано з: 3.16dev4''

Опис: Отримання деякої поточної інформації про ONU з OLT
Обов'язкові параметри:
id - id пристрою ''(ONU)''

==== get_device_id ====
''Змінено у 3.19beta1 (параметр object_type виключено)''

''Доопрацьовано у: 3.13.63 (в data_typer додано можливе значення serial_number)''

''Доопрацьовано у: 3.12.95 (в data_typer додано можливе значення mac)''
Опис: Отримання ID пристрою за вхідними даними
Обов'язкові параметри:
object_type - тип пристрою [switch] ''(до версії 3.19beta1)''
data_typer - тип даних, які перевіряємо ''(можливі значення: ip, mac, inventory_number, serial_number, additional_field_XXX)''
data_value - значення

==== get_data ====

''Оновлено у версії 3.21.0 (додано параметр mark_id)''
''Доопрацьовано у 3.20.2 (додано параметр is_with_ip)''

''Доопрацьовано у 3.19.15 (додано параметр customer_id)''

''Доопрацьовано у 3.19beta1 (додано параметр dataset)''

''Доопрацьовано у: 3.18.4 (додано параметр is_hide_access_data)''

''Доопрацьовано у: 3.17beta1 (додано параметр node_id)''

''Доопрацьовано у: 3.15.18 (додано object_type=olt)''

''Доопрацьовано у: 3.14.14 (додано параметр is_hide_ifaces_data)''

''Доопрацьовано у: 3.12.38 (додано object_type=all)''
Опис: Отримання інформації про пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch|onu|olt|radio|all]
Необов'язкові параметри:
customer_id - id абонента ''(можна через кому)''
dataset - список полів, які виводити у видачі ''(через кому)''
is_online - прапорець - вибирати тільки активні пристрої ''(1 - активні, -1 - неактивні)''
is_hide_ifaces_data - прапорець - приховувати розгорнуту інформацію за інтерфейсами обладнання
is_hide_access_data - прапорець - приховувати інформацію за параметрами доступу до обладнання
is_with_ip - прапорець - тільки з IP-адресами
node_id - id об'єкта інфраструктури ''(можна через кому)''
mark_id - id мітки ''(можна через кому)''
object_id - id об'єкта для вибірки

==== get_iface_info ====

''Додано з: 3.17dev1''

Опис: Отримання поточної інформації за інтерфейсами ''(безпосередньо з пристрою)''
Обов'язкові параметри:
id - id пристрою

==== get_iface_mac ====
''Змінено у 3.19beta1 (параметр object_type виключено)''

''Додано з: 3.12beta25''

Опис: Список інтерфейсів з MAC-адресами на пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою для вибірки

==== get_mac_list ====

''Змінено у 3.19beta1 (параметр object_type виключено, список object_id зроблено необов'язковим)''

Опис: Отримання списку MAC-адрес, які були знайдені на пристрої
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
Необов'язкові параметри:
interface_list - Номер інтерфейсу, за яким виводити список (можна через кому)
object_id - id пристрою для вибірки

==== get_ont_data ====
''Доопрацьовано у: 3.16dev4 (додано параметр device_id)''

''Додано з: 3.12.81''

Опис: Отримання останньої інформації про ONU
Обов'язкові параметри:
id - MAC-адрес або серійний номер ''(id)''
або
device_id - id пристрою ''(ONU)''

==== get_pon_level_history ====
''Доопрацьовано у: 3.16.19 (додано параметр onu_device_id)''

''Доопрацьовано у: 3.16dev4 (додано параметр device_id)''

''Доопрацьовано у: 3.12.60 (додано параметри limit, order_by, is_desc)''

''Додано з: 3.12.53''

Опис: Отримання історії PON-рівнів сигналів за ONU
Обов'язкові параметри:
onu_name - MAC-адреса або серійний номер ONU ''(без розділювачів)''
або
device_id - id пристрою ''(OLT)''
або
onu_device_id - id пристрою ''(ONU)''
Необов'язкові параметри:
limit - обмеження списку даних, що виводяться
order_by - поле сортування даних
is_desc - прапорець - сортування у зворотному порядку

==== get_relation_customers ====
''Оновлено у версії 3.21.60 (додано параметр is_skip_dnlink)''

''Додано у: 3.19.45''

Опис: Отримання інформації про залежних абонентів
Обов'язкові параметри:
device_id - id пристрою
Необов'язкові параметри:
port_start - початковий номер порту
port_finish - кінцевий номер порту
is_skip_dnlink - прапорець: пропускати порти DNLINK

==== delete_mark ====

''Змінено у 3.19beta1 (параметр object_type виключено)''

Опис: Зняття мітки
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
mark_id - ID мітки

==== read_fdb ====

''Додано з: 3.15.7''
Опис: Читання FDB-таблиці з пристрою ''(може виконуватися тривалий час)''
Обов'язкові параметри:
device_id - id пристрою

==== set_data ====

''Оновлено у версії 3.21.57 (параметр param тепер приймає значення is_auto_learning, is_polling_pon, is_polling_peleng та is_polling_iferr)''

''Змінено у 3.19beta1 (параметр object_type виключено)''

''Доопрацьовано у 3.17dev1 (до параметра param додано можливе значення date_last_activity)''

''Доопрацьовано у 3.14.53 (до параметра param додано можливе значення downlink_port, uplink_port)''

''Доопрацьовано у 3.13.61 (до параметра param додано можливе значення iface_count)''

''Доопрацьовано у 3.12.74 (до параметра param додано можливе значення comment)''
Опис: Зміна інформації про пристрій
Обов'язкові параметри:
object_type - Тип пристрою [switch] ''(до версії 3.19beta1)''
object_id - id пристрою
param - тип параметра для зміни [ip|mac|comment|iface_count|is_auto_learning|is_polling_iferr|is_polling_peleng|is_polling_pon|downlink_port|uplink_port|date_last_activity]
value - дані ''(може бути порожнім)''

==== set_iface_state ====

''Додано з: 3.15beta3''
Опис: Зміна стану інтерфейсу на пристрої
Обов'язкові параметри:
device_id - id пристрою
iface - номер інтерфейсу
state - стан [1|0]

==== find_mac ====
''Додано з: 3.12beta25''
Опис: Пошук MAC-адреси в історії опитування обладнання
Обов'язкові параметри:
mac - MAC-адреса ''(верхній регістр без розділювачів)''

API device EN

2026-09-25T14:51:53Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[API_device_UK|uk]] | [[API device|ru]]

Section '''[[API_EN|API]]''' ERP "UserSide"

Purpose: Equipment

Additional parameters:
action - request subcategory ''(possible value: see below)''

== Subcategories ==

==== add_mark ====

''Modified in 3.19beta1 (object_type parameter removed)''

Description: Add a mark
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
mark_id - mark ID

==== get_connected_ont_information ====
''Added in: 3.14.13''

Description: Get information about ONUs connected to an OLT ''(stored database information. Direct polling is not performed)''
Optional parameters:
device_id - OLT ID ''(can be comma separated)''
level_onu_rx_min - minimum incoming signal level on ONU ''(select records with level less than...)''
level_onu_rx_max - maximum incoming signal level on ONU ''(select records with level higher than...)''

==== get_current_ont_data ====

''Added with: 3.16dev4''

Description: Get current ONU information ''(directly from OLT)''
Required parameters:
id - device id ''(ONU)''

==== get_device_id ====
''Modified in 3.19beta1 (object_type parameter removed)''

''Modified in: 3.13.63 (added possible serial_number value to data_typer)''

''Modified in: 3.12.95 (added possible mac value to data_typer)''
Description: Retrieve device ID from input data
Required parameters:
object_type - device type [switch] ''(before version 3.19beta1)''
data_typer - type of data to be checked ''(possible values: ip, mac, inventory_number, serial_number, additional_field_XXX)''
data_value - value

==== get_data ====

''Updated in 3.21.0 (added mark_id parameter)''
''Modified in 3.20.2 (added is_with_ip parameter)''

''Modified in 3.19.15 (added customer_id parameter)''

''Modified in 3.19beta1 (added dataset parameter)''

''Modified in: 3.18.4 (added is_hide_access_data parameter)''

''Modified in: 3.17beta1 (added node_id parameter)''

''Modified in: 3.15.18 (added object_type=olt)''

''Modified in: 3.14.14 (added is_hide_ifaces_data parameter)''

''Modified in: 3.12.38 (added object_type=all)''
Description: Retrieve device information
Required parameters:
object_type - Device type [switch|onu|olt|radio|all]
Optional parameters:
customer_id - customer id ''(can be comma separated)''
dataset - list of fields to output ''(comma separated)''
is_online - flag - select only active devices ''(1 - active, -1 - inactive)''
is_hide_ifaces_data - flag - hide detailed information on equipment interfaces
is_hide_access_data - flag - hide information on equipment access parameters
is_with_ip - flag - only with IP addresses
node_id - infrastructure facility id ''(can be comma separated)''
mark_id - mark ID ''(can be comma separated)''
object_id - id of the object to be selected

==== get_iface_info ====

''Added with: 3.17dev1''

Description: Get current interface information ''(directly from the device)''
Required parameters:
id - device id

==== get_iface_mac ====
''Modified in 3.19beta1 (object_type parameter removed)''

''Added with: 3.12beta25''

Description: List of interfaces with MAC addresses on the device
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - id of the device to be sampled

==== get_mac_list ====

''Modified in 3.19beta1 (object_type parameter removed, object_id list made optional)''

Description: Get a list of MAC addresses that were found on the device
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
Optional parameters:
interface_list - Interface number for which to output the list (can be comma separated)
object_id - id of the device to be sampled

==== get_ont_data ====
''Modified in: 3.16dev4 (added device_id parameter)''

''Added from: 3.12.81''

Description: Get the latest information on ONU
Required parameters:
id - MAC address or serial number ''(id)''
or
device_id - device id ''(ONU)''

==== get_pon_level_history ====
''Modified in: 3.16.19 (added onu_device_id parameter)''

''Modified in: 3.16dev4 (added device_id parameter)''

''Modified in: 3.12.60 (added parameters limit, order_by, is_desc)''

''Added from: 3.12.53''

Description: Get PON signal level history for an ONU
Required parameters:
onu_name - MAC address or serial number of ONU ''(without separators)''
or
device_id - device id ''(OLT)''
or
onu_device_id - device id ''(ONU)''
Optional parameters:
limit - output data limit
order_by - data sorting field
is_desc - flag - sorting in reverse order

==== delete_mark ====

''Modified in 3.19beta1 (object_type parameter removed)''

Description: Remove a mark
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
mark_id - mark ID

==== read_fdb ====
''Added in: 3.15.7''
Description: Read FDB-table from device ''(may run for a long time)''
Required parameters:
device_id - device id

==== set_data ====

''Updated in 3.21.57 (param now accepts is_auto_learning, is_polling_pon, is_polling_peleng, and is_polling_iferr)''

''Modified in 3.19beta1 (object_type parameter removed)''

''Modified in 3.17dev1 (added possible value of date_last_activity to param)''

''Modified in 3.14.53 (added possible value of downlink_port, uplink_port to param)''

''Modified in 3.13.61 (added possible value of iface_count to param)''

''Modified in 3.12.74 (added possible value of comment to param)''
Description: Change device information
Required parameters:
object_type - Device type [switch] ''(before version 3.19beta1)''
object_id - device id
param - type of parameter to change [ip|mac|comment|iface_count|is_auto_learning|is_polling_iferr|is_polling_peleng|is_polling_pon|downlink_port|uplink_port|date_last_activity]
value - data ''(may be empty)''

==== set_iface_state ====

''Added with: 3.15beta3''
Description: Change interface state on a device
Required parameters:
device_id - device id
iface - interface number
state - state [1|0]

==== find_mac ====
''Added in: 3.12beta25''
Description: Search for a MAC address in equipment polling history
Required parameters:
mac - MAC address ''(upper case without separators)''

==== get_relation_customers ====

''Updated in 3.21.60 (added is_skip_dnlink parameter)''

''Added in: 3.19.45''

Description: Retrieve information about dependent customers
Required parameters:
device_id - device id
Optional parameters:
port_start - starting port number
port_finish - ending port number
is_skip_dnlink - flag - skip DNLINK ports

API chapter UK

2026-09-25T14:51:51Z

IronBot: [IronBot] Sync localization from RU

[[API_chapter_EN|en]] | '''uk''' | [[API chapter|ru]]

Розділ '''[[API_UK|API]]''' ERP "UserSide"

Призначення: Власні розділи/сторінки/посилання

Додаткові параметри:
action - підкатегорія запиту ''(можливе значення: див. нижче)''

== Підкатегорії ==

==== link_add ====

''Додано у: 3.20.23''

Опис: Створення нового посилання
Обов'язкові параметри:
section - розділ для розміщення посилання [header|dashboard|menu]
name - назва
url - посилання
Необов'язкові параметри:
sub_section - підрозділ меню для розміщення посилання ''(для section=menu)'' [accountancy | inventories | employees | customers | tariffs | customer_messages | equipments | tasks | coverage | advertisements | memos | statistics | operators | settings | nodes | cable_lines | transport | chapter]
is_blank - відкривати посилання на новій сторінці

==== link_get ====

''Додано у: 3.20.23''

Опис: Отримання списку посилань
Обов'язкові параметри:
немає
Необов'язкові параметри:
section - розділ для розміщення посилання [header|dashboard|menu]

==== link_remove ====

''Додано у: 3.20.23''

Опис: Видалення посилання
Обов'язкові параметри:
id - id об'єкта

==== page_add ====

''Додано у: 3.21.58''

Опис: Створення нової сторінки
Обов'язкові параметри:
section - місце розміщення сторінки [customer_card|device_card]
name - назва сторінки
Необов'язкові параметри:
sub_section - типи обладнання, для яких показувати сторінку ''(для section=device_card)'' [switch|radio|olt|onu|other] ''(кілька значень розділяйте комами)''
url - посилання
is_blank - відкривати посилання на новій сторінці
is_frame - відкривати посилання у фреймі
body - вміст сторінки

==== page_get ====

''Додано у: 3.21.58''

Опис: Отримання списку сторінок
Обов'язкові параметри:
section - місце розміщення сторінок [customer_card|device_card]

==== page_remove ====

''Додано у: 3.21.58''

Опис: Видалення сторінки
Обов'язкові параметри:
id - id об'єкта

API chapter EN

2026-09-25T14:51:48Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[API_chapter_UK|uk]] | [[API chapter|ru]]

Section '''[[API_EN|API_EN]]''' of the "UserSide" ERP

Purpose: Custom sections/pages/links

Additional parameters:
action - request subcategory ''(possible values: see below)''

== Subcategories ==

==== link_add ====

''Added in: 3.20.23''

Description: Create a new link
Required parameters:
section - section where the link will be placed [header|dashboard|menu]
name - name
url - link
Optional parameters:
sub_section - menu subsection where the link will be placed ''(for section=menu)'' [accountancy | inventories | employees | customers | tariffs | customer_messages | equipments | tasks | coverage | advertisements | memos | statistics | operators | settings | nodes | cable_lines | transport | chapter]
is_blank - open the link in a new page

==== link_get ====

''Added in: 3.20.23''

Description: Retrieve the list of links
Required parameters:
none
Optional parameters:
section - section where the link is placed [header|dashboard|menu]

==== link_remove ====

''Added in: 3.20.23''

Description: Delete a link
Required parameters:
id - object ID

==== page_add ====

''Added in: 3.21.58''

Description: Create a new page
Required parameters:
section - location for the page [customer_card|device_card]
name - page name
Optional parameters:
sub_section - device types that display the page ''(for section=device_card)'' [switch|radio|olt|onu|other] ''(separate multiple values with commas)''
url - link
is_blank - open the link in a new page
is_frame - open the link in a frame
body - page content

==== page_get ====

''Added in: 3.21.58''

Description: Get a list of pages
Required parameters:
section - location of the pages [customer_card|device_card]

==== page_remove ====

''Added in: 3.21.58''

Description: Delete a page
Required parameters:
id - object ID

HOWTO: Клонування USERSIDE

2026-09-25T14:51:46Z

IronBot: [IronBot] Sync localization from RU

[[HOWTO:_USERSIDE_cloning|en]] | '''uk''' | [[HOWTO:_Клонирование_USERSIDE|ru]]

== Копія системи для тестування або досліджень ==

Якщо потрібно зробити копію системи, щоб перевірити нову версію перед фактичним оновленням або виконати інші дії, потрібно пройти кілька простих кроків:

* скопіюйте файли застосунку
cd /var/www/
sudo cp -r userside userside-copy

* налаштуйте web-сервер для роботи з копією: скопіюйте файл конфігурації, відредагуйте його та перечитайте конфігурацію nginx:
sudo cp /etc/nginx/conf.d/userside.conf /etc/nginx/conf.d/userside-copy.conf
sudo sed -i "s@/var/www/userside/userside3@/var/www/userside-copy/userside3@" "/etc/nginx/conf.d/userside-copy.conf"
sudo sed -i "s@/var/log/nginx/userside@/var/log/nginx/userside-copy@" "/etc/nginx/conf.d/userside-copy.conf"
sudo sed -i "s@old.domain.name@new.domain.name@" "/etc/nginx/conf.d/userside-copy.conf"
sudo systemctl reload nginx

* скопіюйте базу даних ''(або створіть нову базу даних і відновіть її з резервної копії)'':
sudo -u postgres createdb -e --encoding="UTF-8" --locale="uk_UA.UTF-8" --owner=userside --template=userside userside_copy
Якщо база даних копіюється на інший сервер, перед відновленням потрібно створити роль, обов'язково з такою самою назвою, як у дампі:
sudo -u postgres createuser userside -P

* У версії 3.13 і новіших перейдіть до каталогу з новою копією та відредагуйте змінні середовища у файлі .env так, щоб вони працювали з новою базою даних і з іншою ''(вільною)'' базою Redis. В основній інсталяції, найімовірніше, використовується база Redis з номером 0; можна використати одну з інших 15 баз, доступних за замовчуванням. За це відповідають змінні:
US_URL=http://new.domain.name
US_DB_DSN=pgsql:host=localhost;dbname=userside_copy;port=5432
US_REDIS_DB=1

* Очистьте базу даних Redis, яку плануєте використовувати:
redis-cli -n 1 -a пароль_redis FLUSHDB

* Для версій до 3.13 відредагуйте параметри підключення до бази даних у common/config/db.php і URL у userside3/main/config/config.php.

* У версії 3.16 і новіших потрібно створити додатковий vhost для RabbitMQ, а потім указати його у файлі .env для змінної '''US_AMQP_DSN'''. У прикладі нижче як назву нового vhost використано '''copy''' ''(за потреби змініть на зручнішу назву)''. Спочатку виконайте команду створення vhost, а потім додайте права для користувачів у межах цього vhost:
sudo rabbitmqctl add_vhost copy
sudo rabbitmqctl set_permissions -p "copy" "admin" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "userside" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
sudo rabbitmqctl --vhost copy set_user_tags "userside" "monitoring"

Після цього змініть змінну US_AMQP_DSN у файлі .env так:
US_AMQP_DSN=amqp://userside:yourpassword@127.0.0.1:5672/copy

* Відновіть роботу копії за допомогою інсталятора (починаючи з версії 3.19):
sudo -u www-data ./installer repair
Для попередніх версій:
sudo -u www-data php userside_install.phar repair

* У версії 3.16 і новіших також потрібно перестворити venv для мікросервісу poller:
cd /var/www/userside-copy/microservice/poller
sudo rm -rf venv
sudo -u www-data python3 -m venv venv
sudo -u www-data venv/bin/pip install --upgrade -r requirements.txt

* Також, починаючи з версії 3.16, потрібно скопіювати конфігурацію supervisor для фонових процесів ядра та мікросервісу poller. Зверніть увагу, що до версії 3.18 файл usm_poller.conf називався us-poller-microservice.conf:
sudo cp /etc/supervisor/conf.d/us-core-worker.conf /etc/supervisor/conf.d/us-copy-core-worker.conf
sudo sed -i "s@us-core-worker@us-copy-core-worker@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-copy/@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"

sudo cp /etc/supervisor/conf.d/usm_poller.conf /etc/supervisor/conf.d/usm_poller_copy.conf
sudo sed -i "s@usm_poller@usm_poller_copy@" "/etc/supervisor/conf.d/usm_poller_copy.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-copy/@" "/etc/supervisor/conf.d/usm_poller_copy.conf"

sudo systemctl restart supervisor

* після цього копію можна відкрити в браузері.

HOWTO: USERSIDE cloning

2026-09-25T14:51:44Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[HOWTO:_Клонування_USERSIDE|uk]] | [[HOWTO:_Клонирование_USERSIDE|ru]]

== Copy of system for testing or research ==

If you need to make a copy of the system to try out the new version before the actual upgrade, or to do anything else, there are a few simple steps to follow:

* copy the application files
cd /var/www/
sudo cp -r userside userside-copy

* configure the web server to work with the copy - copy the configuration file, edit and re-read the nginx configuration:
sudo cp /etc/nginx/conf.d/userside.conf /etc/nginx/conf.d/userside-copy.conf
sudo sed -i "s@/var/www/userside/userside3@/var/www/userside-copy/userside3@" "/etc/nginx/conf.d/userside-copy.conf"
sudo sed -i "s@/var/log/nginx/userside@/var/log/nginx/userside-copy@" "/etc/nginx/conf.d/userside-copy.conf"
sudo sed -i "s@old.domain.name@new.domain.name@" "/etc/nginx/conf.d/userside-copy.conf"
sudo systemctl reload nginx

* Copy the database (or create a new database and restore it from a backup):
sudo -u postgres createdb -e --encoding="UTF-8" --locale="uk_UA.UTF-8" --owner=userside --template=userside userside_copy
If you are copying the database to another server, you will need to create a role, necessarily the same as in the dump, before restoring it:
sudo -u postgres createuser userside -P

* In version 3.13 and newer, go to the directory with the new copy, edit the environment variables in the .env file so that they work with the new database and with the other (free) redis database (in the main installation you probably have the redis database number 0; you can use the other 15 available by default). Variables are responsible for this:
US_URL=http://new.domain.name
US_DB_DSN=pgsql:host=localhost;dbname=userside_copy;port=5432
US_REDIS_DB=1

* Clear the Redis database you plan to use:
redis-cli -n 1 -a redis_password FLUSHDB

* For versions up to 3.13, edit the database connection parameters in common/config/db.php and the URL in userside3/main/config/config.php

* In version 3.16 and newer you need to create an additional vhost for RabbitMQ, and then specify it in the .env file for the '''US_AMQP_DSN''' variable. The example below uses '''copy''' as the name of the new vhost (change to something more convenient for you if necessary). First run the command that creates the vhost, then add permissions for users within that vhost:
sudo rabbitmqctl add_vhost copy
sudo rabbitmqctl set_permissions -p "copy" "admin" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "userside" ".*" ".*" ".*"
sudo rabbitmqctl set_permissions -p "copy" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
sudo rabbitmqctl --vhost copy set_user_tags "userside" "monitoring"

Now change the variable US_AMQP_DSN of the .env file this way:
US_AMQP_DSN=amqp://userside:yourpassword@127.0.0.1:5672/copy

* Repair the copy with the installer (starting with version 3.19):
sudo -u www-data ./installer repair
For earlier versions:
sudo -u www-data php userside_install.phar repair

* In version 3.16 and newer you will also need to recreate the venv for the poller microservice:
cd /var/www/userside-copy/microservice/poller
sudo rm -rf venv
sudo -u www-data python3 -m venv venv
sudo -u www-data venv/bin/pip install --upgrade -r requirements.txt

* Also starting with version 3.16 you will need to copy the supervisor configuration for the kernel background processes and the poller microservice. Also note that before version 3.18 the usm_poller.conf file was called us-poller-microservice.conf:
sudo cp /etc/supervisor/conf.d/us-core-worker.conf /etc/supervisor/conf.d/us-copy-core-worker.conf
sudo sed -i "s@us-core-worker@us-copy-core-worker@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-copy/@" "/etc/supervisor/conf.d/us-copy-core-worker.conf"

sudo cp /etc/supervisor/conf.d/usm_poller.conf /etc/supervisor/conf.d/usm_poller_copy.conf
sudo sed -i "s@usm_poller@usm_poller_copy@" "/etc/supervisor/conf.d/usm_poller_copy.conf"
sudo sed -i "s@/var/www/userside/@/var/www/userside-copy/@" "/etc/supervisor/conf.d/usm_poller_copy.conf"

sudo systemctl restart supervisor

* it is now possible to open your copy in the browser.

Internal API UK

2026-09-25T14:51:39Z

IronBot: [IronBot] Sync localization from RU

[[Internal_API_EN|en]] | '''uk''' | [[Internal_API|ru]]

Custom Events v2 - це локальна система внутрішніх подій ERP. Вона виконує клієнтський PHP-код усередині поточного PHP-процесу ERP без HTTP-запитів, вебхуків і зовнішніх черг.

Старий механізм <code>legacy/Config/custom_api.txt</code> з функцією <code>api_function(...)</code> залишається legacy-контрактом. У v2 старі назви використовуються лише для карти сумісності. Новий клієнтський код має використовувати константи <code>CustomEvent::...</code>.

== Файли ==

Робочий клієнтський файл один:

<pre>evolution/CustomEvents/v2/handlers.php</pre>

Приклад:

<pre>evolution/CustomEvents/v2/handlers.example.php</pre>

Список усіх констант:

<pre>evolution/CustomEvents/Runtime/v2/CustomEvent.php</pre>

Карта старих назв у нові події:

<pre>evolution/CustomEvents/Runtime/v2/CustomEventLegacyEventMap.php</pre>

Кеш:

<pre>var/cache/CustomEvents/handlers.v2.cache.php</pre>

Лог:

<pre>var/log/custom-events-v2.log</pre>

== Як писати обробники ==

Використовується одна функція реєстрації: <code>internal_event(...)</code>.

В одному файлі можна зареєструвати кілька обробників поспіль:

<syntaxhighlight lang="php">

declare(strict_types=1);

use Evolution\CustomEvents\Runtime\v2\CustomEvent;

internal_event(
CustomEvent::TASK_CREATED,
static function ($event): bool {
$taskId = $event->get('task_id');

return true;
},
);

internal_event(
CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE,
static function ($event): bool|string {
if ((int)$event->get('new_status_id') === 0) {
return 'Заборонено переводити абонента в цей статус';
}

return true;
},
);

internal_event(
CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER,
static function ($event): string {
$customerId = (int)$event->get('customer_id');

return '<div>Додаткова інформація щодо абонента #' . $customerId . '</div>';
},
);
</syntaxhighlight>

В обробник завжди надходить один параметр: <code>$event</code>.

Дані читаються без типових обгорток:

<syntaxhighlight lang="php">
$taskId = $event->get('task_id');
$customerId = $event->get('customer_id');
$data = $event->all();
</syntaxhighlight>

Якщо потрібен конкретний тип, приведіть значення у своєму коді:

<syntaxhighlight lang="php">
$taskId = (int)$event->get('task_id');
$comment = (string)$event->get('comment');
</syntaxhighlight>

== Результат обробника ==

Обробник повертає просте значення:

{| class="wikitable"
! Повернення
! Значення
|-
| <code>true</code>
| Обробник виконано успішно
|-
| <code>false</code>
| Для події <code>*.before</code> заборонити штатну операцію
|-
| <code>null</code>
| Нічого не змінювати
|-
| рядок
| Для <code>*.before</code> заборонити операцію з текстом причини; для <code>*.render</code> вивести рядок або HTML
|}

Події <code>*.before</code> можуть скасовувати штатну операцію. Інші події не повинні скасовувати вже виконану дію.

== Приклад заборони операції ==

<syntaxhighlight lang="php">
internal_event(
CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE,
static function ($event): bool|string {
if ((int)$event->get('new_status_id') === 0) {
return 'Заборонено переводити абонента в цей статус';
}

return true;
},
);
</syntaxhighlight>

== Приклад виведення HTML ==

<syntaxhighlight lang="php">
internal_event(
CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER,
static function ($event): string {
$customerId = (int)$event->get('customer_id');

return '<div>Додаткова інформація щодо абонента #' . $customerId . '</div>';
},
);
</syntaxhighlight>

== Перевірка, кеш і лог ==

Після зміни <code>evolution/CustomEvents/v2/handlers.php</code> ERP перевіряє синтаксис через <code>php -l</code>. Якщо синтаксис коректний, файл копіюється до <code>var/cache/CustomEvents/handlers.v2.cache.php</code>.

Runtime-лог записується у форматі JSON Lines до <code>var/log/custom-events-v2.log</code>. Один рядок - це один виклик обробника, помилка або факт відсутності обробників.

Приклад рядка:

<syntaxhighlight lang="json">
{"ts":"2026-05-10T12:01:03+03:00","event":"task.created","has_handlers":true,"handlers":1,"handler_index":0,"duration_ms":2.341,"memory_kb":18,"result":"allow","message":null}
</syntaxhighlight>

Лог ротується в:

<pre>var/log/custom-events-v2.log.1</pre>

== Помилки ==

Якщо в обробнику виникне помилка, ERP запише її в лог і продовжить роботу за правилами конкретної події.

Обробник виконується всередині того самого PHP-процесу, що й ядро ERP. Через ядро проходять тисячі операцій, тому повільний або помилковий клієнтський код може зупинити чи дестабілізувати роботу всієї системи. Не використовуйте <code>exit</code>, <code>die</code>, нескінченні цикли, важкі SQL-запити без обмежень і тривалі зовнішні операції. Тримайте обробники короткими та передбачуваними.

== Рекомендації ==

* Використовуйте лише константи <code>CustomEvent::...</code>.
* Не пишіть рядок події вручну.
* Робіть обробники короткими.
* Не викликайте HTTP/webhook із високочастотних подій.
* Не використовуйте <code>exit</code>, <code>die</code>, нескінченні цикли та важкі вибірки без обмежень.
* Повертайте <code>true</code>, <code>false</code>, <code>null</code> або рядок.

== Усі події ==

Нижче перелічені всі події v2. Повний технічний список констант міститься в <code>evolution/CustomEvents/Runtime/v2/CustomEvent.php</code>.

Поля <code>event</code> вказані як поточний контракт даних.

=== Будинки ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::BUILDING_CREATED</code>
| Після створення будинку
| <code>building_id</code>, <code>data</code>
|-
| <code>CustomEvent::BUILDING_CHANGED</code>
| Після редагування будинку
| <code>building_id</code>, <code>data</code>
|}

=== Комутація ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::COMMUTATION_CREATE_BEFORE</code>
| Перед створенням комутації між об'єктами
| <code>source_type</code>, <code>source_id</code>, <code>target_type</code>, <code>target_id</code>, <code>data</code>
|-
| <code>CustomEvent::COMMUTATION_DELETE_BEFORE</code>
| Перед видаленням комутації між об'єктами
| <code>source_type</code>, <code>source_id</code>, <code>target_type</code>, <code>target_id</code>, <code>data</code>
|}

=== Головна сторінка ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::DASHBOARD_TOP_CONTENT_RENDER</code>
| Під час виведення тексту у верхній частині головної сторінки
| <code>employee_id</code>, <code>data</code>
|}

=== Обладнання ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::DEVICE_CHANGED</code>
| Після редагування обладнання
| <code>device_id</code>, <code>device_type</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_NOTIFICATION_DOWN</code>
| Під час фіксації недоступності обладнання
| <code>device_id</code>, <code>device_type</code>, <code>ip</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_NOTIFICATION_UP</code>
| Під час відновлення доступності обладнання
| <code>device_id</code>, <code>device_type</code>, <code>ip</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_INTERFACE_PORT_NUMBER_RENDER</code>
| Під час виведення номера порту в таблиці інтерфейсів
| <code>device_id</code>, <code>interface_id</code>, <code>port_number</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_INTERFACE_ADDITIONAL_DATA_RENDER</code>
| Під час виведення додаткового вмісту в картці обладнання
| <code>device_id</code>, <code>data</code>
|}

=== Абоненти ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::CUSTOMER_CREATED</code>
| Після створення абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CHANGE_BEFORE</code>
| Перед редагуванням абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CHANGED</code>
| Після редагування абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_MERGED</code>
| Після об'єднання абонентів
| <code>customer_id</code>, <code>target_customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE</code>
| Перед зміною статусу абонента
| <code>customer_id</code>, <code>new_status_id</code>, <code>old_status_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_STATUS_CHANGED</code>
| Після зміни статусу абонента
| <code>customer_id</code>, <code>new_status_id</code>, <code>old_status_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TARIFF_CHANGE_BEFORE</code>
| Перед зміною тарифу абонента
| <code>customer_id</code>, <code>billing_id</code>, <code>new_tariff_id</code>, <code>old_tariff_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TARIFF_CHANGED</code>
| Після зміни тарифу абонента
| <code>customer_id</code>, <code>billing_id</code>, <code>new_tariff_id</code>, <code>old_tariff_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_BALANCE_CHANGED</code>
| Під час зміни балансу абонента
| <code>customer_id</code>, <code>amount</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_TRANSFER_BEFORE</code>
| Перед переведенням абонента в колишні абоненти
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_TRANSFERRED</code>
| Після переведення абонента в колишні абоненти
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_RESTORE_BEFORE</code>
| Перед відновленням абонента з колишніх абонентів
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_RESTORED</code>
| Після відновлення абонента з колишніх абонентів
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_PLAN_BEFORE</code>
| Перед постановкою абонента на відключення
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_PLANNED</code>
| Після постановки абонента на відключення
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_BEFORE</code>
| Перед відключенням абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECTED</code>
| Після відключення абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_CANCEL_BEFORE</code>
| Перед скасуванням відключення абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_CANCELLED</code>
| Після скасування відключення абонента
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_ENABLE_BEFORE</code>
| Перед підключенням послуги абоненту
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_ENABLED</code>
| Після підключення послуги абоненту
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_DISABLE_BEFORE</code>
| Перед відключенням послуги абоненту
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_DISABLED</code>
| Після відключення послуги абоненту
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|}

==== IP/MAC абонента ====

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::CUSTOMER_IP_ADD_BEFORE</code>
| Перед додаванням IP/MAC-адреси
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_ADDED</code>
| Після додавання IP/MAC-адреси
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_DELETE_BEFORE</code>
| Перед видаленням IP/MAC-адреси
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_DELETED</code>
| Після видалення IP/MAC-адреси
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|}

==== Мітки абонента ====

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_ADD_BEFORE</code>
| Перед додаванням мітки абоненту
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_ADDED</code>
| Після додавання мітки абоненту
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_DELETE_BEFORE</code>
| Перед видаленням мітки абонента
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_DELETED</code>
| Після видалення мітки абонента
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|}

==== Особистий кабінет абонента ====

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_REGISTRATION_BEFORE</code>
| Перед реєстрацією абонента в особистому кабінеті
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_REGISTERED</code>
| Після реєстрації абонента в особистому кабінеті
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_LOGIN_BEFORE</code>
| Перед входом абонента в особистий кабінет
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_DASHBOARD_RENDER</code>
| Під час виведення вмісту на головній сторінці особистого кабінету
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_PAGE_RENDER</code>
| Під час виведення вмісту на сторінках особистого кабінету
| <code>customer_id</code>, <code>page_mode</code>, <code>page_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_HEAD_RENDER</code>
| Під час виведення вмісту після <code>head</code> в особистому кабінеті
| <code>customer_id</code>, <code>data</code>
|}

==== Картка абонента ====

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER</code>
| Під час виведення основного вмісту в картці абонента
| <code>customer_id</code>, <code>mode</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_SECONDARY_CONTENT_RENDER</code>
| Під час виведення додаткового вмісту в картці абонента
| <code>customer_id</code>, <code>mode</code>, <code>employee_id</code>, <code>ip_mac</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_IP_MAC_CONTENT_RENDER</code>
| Під час виведення інформації біля IP/MAC-адрес абонента
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_SMS_CONTENT_RENDER</code>
| Під час виведення вмісту надсилання SMS у картці абонента
| <code>customer_id</code>, <code>data</code>
|}

=== Співробітники ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::EMPLOYEE_MESSAGE_CREATED</code>
| Після створення повідомлення співробітнику
| <code>receiver_employee_id</code>, <code>message_id</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_CHANGED</code>
| Після редагування співробітника
| <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_PERSONAL_SECTION_CONTENT_RENDER</code>
| Під час виведення інформації в персональному розділі співробітника
| <code>employee_id</code>, <code>data</code>
|}

==== Табель робіт ====

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::EMPLOYEE_TIMESHEET_PRINT_HEADER_RENDER</code>
| Під час виведення шапки друкованого табеля
| <code>employee_id</code>, <code>period</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_TIMESHEET_PRINT_FOOTER_RENDER</code>
| Під час виведення підвала друкованого табеля
| <code>employee_id</code>, <code>period</code>, <code>data</code>
|}

=== Склад ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::INVENTORY_TRANSFER_BEFORE</code>
| Перед переміщенням ТМЦ
| <code>inventory_id</code>, <code>operation_id</code>, <code>data</code>
|-
| <code>CustomEvent::INVENTORY_TRANSFERRED</code>
| Після переміщення ТМЦ
| <code>inventory_id</code>, <code>operation_id</code>, <code>data</code>
|}

=== Завдання ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::TASK_CARD_RENDER</code>
| Під час виведення вмісту в картці завдання
| <code>task_type_id</code>, <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WORK_DATE_RENDER</code>
| Під час виведення вмісту біля дати робіт
| <code>task_type_id</code>, <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CREATE_BEFORE</code>
| Перед створенням завдання
| <code>task_type_id</code>, <code>author_employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CREATED</code>
| Після створення завдання
| <code>task_id</code>, <code>task_type_id</code>, <code>author_employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DELETE_BEFORE</code>
| Перед видаленням завдання
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CHANGE_BEFORE</code>
| Перед редагуванням завдання
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CHANGED</code>
| Після редагування завдання
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CREATE_BEFORE</code>
| Перед додаванням коментаря до завдання
| <code>task_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CREATED</code>
| Після додавання коментаря до завдання
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CHANGED</code>
| Після редагування коментаря до завдання
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_TEXT_RENDER</code>
| Під час виведення тексту коментаря завдання
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DIVISION_ASSIGN_BEFORE</code>
| Перед додаванням підрозділу до завдання
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DIVISION_REMOVE_BEFORE</code>
| Перед виключенням підрозділу із завдання
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_EMPLOYEE_ASSIGN_BEFORE</code>
| Перед додаванням виконавця до завдання
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_EMPLOYEE_REMOVE_BEFORE</code>
| Перед виключенням виконавця із завдання
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WATCHER_DIVISION_ASSIGN_BEFORE</code>
| Перед додаванням підрозділу спостерігачем
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WATCHER_EMPLOYEE_ASSIGN_BEFORE</code>
| Перед додаванням співробітника спостерігачем
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_OBJECT_ATTACHED</code>
| Після додавання об'єкта до завдання
| <code>task_id</code>, <code>object_type</code>, <code>object_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_OBJECT_DETACHED</code>
| Після виключення об'єкта із завдання
| <code>task_id</code>, <code>object_type</code>, <code>object_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_RETURNED_TO_AUTHOR</code>
| Після повернення завдання автору
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_STATE_CHANGE_BEFORE</code>
| Перед зміною статусу завдання
| <code>task_id</code>, <code>old_state_id</code>, <code>new_state_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_STATE_CHANGED</code>
| Після зміни статусу завдання
| <code>task_id</code>, <code>old_state_id</code>, <code>new_state_id</code>, <code>data</code>
|}

=== Споруди зв'язку ===

{| class="wikitable"
! Константа
! Коли викликається
! Дані <code>$event</code>
|-
| <code>CustomEvent::NODE_CARD_ADDITIONAL_DATA_RENDER</code>
| Під час виведення додаткового вмісту в картці споруди зв'язку
| <code>node_id</code>, <code>data</code>
|-
| <code>CustomEvent::NODE_CARD_PRIMARY_CONTENT_RENDER</code>
| Під час виведення основного вмісту в картці споруди зв'язку
| <code>node_id</code>, <code>data</code>
|}

Internal API EN

2026-09-25T14:51:35Z

IronBot: [IronBot] Sync localization from RU

'''en''' | [[Internal_API_UK|uk]] | [[Internal_API|ru]]

Custom Events v2 is a local ERP internal event system. It runs customer PHP code inside the current ERP PHP process without HTTP requests, webhooks, or external queues.

The old <code>legacy/Config/custom_api.txt</code> mechanism with the <code>api_function(...)</code> function remains a legacy contract. In v2, old names are used only for the compatibility map. New customer code must use <code>CustomEvent::...</code> constants.

== Files ==

There is one working customer file:

<pre>evolution/CustomEvents/v2/handlers.php</pre>

Example:

<pre>evolution/CustomEvents/v2/handlers.example.php</pre>

List of all constants:

<pre>evolution/CustomEvents/Runtime/v2/CustomEvent.php</pre>

Map of old names to new events:

<pre>evolution/CustomEvents/Runtime/v2/CustomEventLegacyEventMap.php</pre>

Cache:

<pre>var/cache/CustomEvents/handlers.v2.cache.php</pre>

Log:

<pre>var/log/custom-events-v2.log</pre>

== How to write handlers ==

One registration function is used: <code>internal_event(...)</code>.

Several handlers can be registered one after another in the same file:

<syntaxhighlight lang="php">

declare(strict_types=1);

use Evolution\CustomEvents\Runtime\v2\CustomEvent;

internal_event(
CustomEvent::TASK_CREATED,
static function ($event): bool {
$taskId = $event->get('task_id');

return true;
},
);

internal_event(
CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE,
static function ($event): bool|string {
if ((int)$event->get('new_status_id') === 0) {
return 'Changing the customer to this status is forbidden';
}

return true;
},
);

internal_event(
CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER,
static function ($event): string {
$customerId = (int)$event->get('customer_id');

return '<div>Additional customer information #' . $customerId . '</div>';
},
);
</syntaxhighlight>

The handler always receives one parameter: <code>$event</code>.

Data is read without type wrappers:

<syntaxhighlight lang="php">
$taskId = $event->get('task_id');
$customerId = $event->get('customer_id');
$data = $event->all();
</syntaxhighlight>

If a specific type is required, cast the value in your code:

<syntaxhighlight lang="php">
$taskId = (int)$event->get('task_id');
$comment = (string)$event->get('comment');
</syntaxhighlight>

== Handler result ==

The handler returns a simple value:

{| class="wikitable"
! Return
! Meaning
|-
| <code>true</code>
| The handler completed successfully
|-
| <code>false</code>
| For a <code>*.before</code> event, block the standard operation
|-
| <code>null</code>
| Do not change anything
|-
| string
| For <code>*.before</code>, block the operation with a reason text; for <code>*.render</code>, output a string or HTML
|}

<code>*.before</code> events can cancel the standard operation. Other events must not cancel an action that has already been completed.

== Example: blocking an operation ==

<syntaxhighlight lang="php">
internal_event(
CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE,
static function ($event): bool|string {
if ((int)$event->get('new_status_id') === 0) {
return 'Changing the customer to this status is forbidden';
}

return true;
},
);
</syntaxhighlight>

== Example: outputting HTML ==

<syntaxhighlight lang="php">
internal_event(
CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER,
static function ($event): string {
$customerId = (int)$event->get('customer_id');

return '<div>Additional customer information #' . $customerId . '</div>';
},
);
</syntaxhighlight>

== Validation, cache, and log ==

When <code>evolution/CustomEvents/v2/handlers.php</code> changes, ERP checks the syntax with <code>php -l</code>. If the syntax is valid, the file is copied to <code>var/cache/CustomEvents/handlers.v2.cache.php</code>.

The runtime log is written as JSON Lines to <code>var/log/custom-events-v2.log</code>. One line is one handler call, error, or fact that no handlers exist.

Example line:

<syntaxhighlight lang="json">
{"ts":"2026-05-10T12:01:03+03:00","event":"task.created","has_handlers":true,"handlers":1,"handler_index":0,"duration_ms":2.341,"memory_kb":18,"result":"allow","message":null}
</syntaxhighlight>

The log is rotated to:

<pre>var/log/custom-events-v2.log.1</pre>

== Errors ==

If an error occurs in a handler, ERP writes it to the log and continues according to the rules of the specific event.

The handler runs inside the same PHP process as the ERP core. Thousands of operations pass through the core, so slow or faulty customer code can stop or destabilize the entire system. Do not use <code>exit</code>, <code>die</code>, endless loops, heavy SQL queries without limits, or long external operations. Keep handlers short and predictable.

== Recommendations ==

* Use only <code>CustomEvent::...</code> constants.
* Do not write the event string manually.
* Keep handlers short.
* Do not call HTTP/webhook from high-frequency events.
* Do not use <code>exit</code>, <code>die</code>, endless loops, or heavy selections without limits.
* Return <code>true</code>, <code>false</code>, <code>null</code>, or a string.

== All events ==

All v2 events are listed below. The complete technical list of constants is in <code>evolution/CustomEvents/Runtime/v2/CustomEvent.php</code>.

The <code>event</code> fields are the current data contract.

=== Buildings ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::BUILDING_CREATED</code>
| After creating a building
| <code>building_id</code>, <code>data</code>
|-
| <code>CustomEvent::BUILDING_CHANGED</code>
| After editing a building
| <code>building_id</code>, <code>data</code>
|}

=== Commutation ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::COMMUTATION_CREATE_BEFORE</code>
| Before creating commutation between objects
| <code>source_type</code>, <code>source_id</code>, <code>target_type</code>, <code>target_id</code>, <code>data</code>
|-
| <code>CustomEvent::COMMUTATION_DELETE_BEFORE</code>
| Before deleting commutation between objects
| <code>source_type</code>, <code>source_id</code>, <code>target_type</code>, <code>target_id</code>, <code>data</code>
|}

=== Dashboard ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::DASHBOARD_TOP_CONTENT_RENDER</code>
| When rendering text at the top of the dashboard
| <code>employee_id</code>, <code>data</code>
|}

=== Equipment ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::DEVICE_CHANGED</code>
| After editing equipment
| <code>device_id</code>, <code>device_type</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_NOTIFICATION_DOWN</code>
| When equipment unavailability is recorded
| <code>device_id</code>, <code>device_type</code>, <code>ip</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_NOTIFICATION_UP</code>
| When equipment availability is restored
| <code>device_id</code>, <code>device_type</code>, <code>ip</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_INTERFACE_PORT_NUMBER_RENDER</code>
| When rendering the port number in the interface table
| <code>device_id</code>, <code>interface_id</code>, <code>port_number</code>, <code>data</code>
|-
| <code>CustomEvent::DEVICE_INTERFACE_ADDITIONAL_DATA_RENDER</code>
| When rendering additional content in the equipment card
| <code>device_id</code>, <code>data</code>
|}

=== Customers ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::CUSTOMER_CREATED</code>
| After creating a customer
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CHANGE_BEFORE</code>
| Before editing a customer
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CHANGED</code>
| After editing a customer
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_MERGED</code>
| After merging customers
| <code>customer_id</code>, <code>target_customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_STATUS_CHANGE_BEFORE</code>
| Before changing a customer status
| <code>customer_id</code>, <code>new_status_id</code>, <code>old_status_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_STATUS_CHANGED</code>
| After changing a customer status
| <code>customer_id</code>, <code>new_status_id</code>, <code>old_status_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TARIFF_CHANGE_BEFORE</code>
| Before changing a customer tariff
| <code>customer_id</code>, <code>billing_id</code>, <code>new_tariff_id</code>, <code>old_tariff_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TARIFF_CHANGED</code>
| After changing a customer tariff
| <code>customer_id</code>, <code>billing_id</code>, <code>new_tariff_id</code>, <code>old_tariff_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_BALANCE_CHANGED</code>
| When a customer balance changes
| <code>customer_id</code>, <code>amount</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_TRANSFER_BEFORE</code>
| Before moving a customer to former customers
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_TRANSFERRED</code>
| After moving a customer to former customers
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_RESTORE_BEFORE</code>
| Before restoring a customer from former customers
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_FORMER_RESTORED</code>
| After restoring a customer from former customers
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_PLAN_BEFORE</code>
| Before scheduling customer disconnection
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_PLANNED</code>
| After scheduling customer disconnection
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_BEFORE</code>
| Before disconnecting a customer
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECTED</code>
| After disconnecting a customer
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_CANCEL_BEFORE</code>
| Before cancelling customer disconnection
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_DISCONNECT_CANCELLED</code>
| After cancelling customer disconnection
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_ENABLE_BEFORE</code>
| Before enabling a service for a customer
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_ENABLED</code>
| After enabling a service for a customer
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_DISABLE_BEFORE</code>
| Before disabling a service for a customer
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_SERVICE_DISABLED</code>
| After disabling a service for a customer
| <code>customer_id</code>, <code>service_id</code>, <code>data</code>
|}

==== Customer IP/MAC ====

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::CUSTOMER_IP_ADD_BEFORE</code>
| Before adding an IP/MAC address
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_ADDED</code>
| After adding an IP/MAC address
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_DELETE_BEFORE</code>
| Before deleting an IP/MAC address
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_IP_DELETED</code>
| After deleting an IP/MAC address
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>subnet_property</code>, <code>data</code>
|}

==== Customer tags ====

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::CUSTOMER_TAG_ADD_BEFORE</code>
| Before adding a tag to a customer
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_ADDED</code>
| After adding a tag to a customer
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_DELETE_BEFORE</code>
| Before deleting a customer tag
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_TAG_DELETED</code>
| After deleting a customer tag
| <code>customer_id</code>, <code>tag_id</code>, <code>data</code>
|}

==== Customer portal ====

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::CUSTOMER_PORTAL_REGISTRATION_BEFORE</code>
| Before registering a customer in the customer portal
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_REGISTERED</code>
| After registering a customer in the customer portal
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_LOGIN_BEFORE</code>
| Before a customer logs in to the customer portal
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_DASHBOARD_RENDER</code>
| When rendering content on the customer portal dashboard
| <code>customer_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_PAGE_RENDER</code>
| When rendering content on customer portal pages
| <code>customer_id</code>, <code>page_mode</code>, <code>page_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_PORTAL_HEAD_RENDER</code>
| When rendering content after <code>head</code> in the customer portal
| <code>customer_id</code>, <code>data</code>
|}

==== Customer card ====

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::CUSTOMER_CARD_PRIMARY_CONTENT_RENDER</code>
| When rendering the main content in the customer card
| <code>customer_id</code>, <code>mode</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_SECONDARY_CONTENT_RENDER</code>
| When rendering additional content in the customer card
| <code>customer_id</code>, <code>mode</code>, <code>employee_id</code>, <code>ip_mac</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_IP_MAC_CONTENT_RENDER</code>
| When rendering information near customer IP/MAC addresses
| <code>customer_id</code>, <code>ip</code>, <code>mac</code>, <code>data</code>
|-
| <code>CustomEvent::CUSTOMER_CARD_SMS_CONTENT_RENDER</code>
| When rendering SMS sending content in the customer card
| <code>customer_id</code>, <code>data</code>
|}

=== Employees ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::EMPLOYEE_MESSAGE_CREATED</code>
| After creating a message for an employee
| <code>receiver_employee_id</code>, <code>message_id</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_CHANGED</code>
| After editing an employee
| <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_PERSONAL_SECTION_CONTENT_RENDER</code>
| When rendering information in an employee personal section
| <code>employee_id</code>, <code>data</code>
|}

==== Timesheet ====

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::EMPLOYEE_TIMESHEET_PRINT_HEADER_RENDER</code>
| When rendering the printed timesheet header
| <code>employee_id</code>, <code>period</code>, <code>data</code>
|-
| <code>CustomEvent::EMPLOYEE_TIMESHEET_PRINT_FOOTER_RENDER</code>
| When rendering the printed timesheet footer
| <code>employee_id</code>, <code>period</code>, <code>data</code>
|}

=== Warehouse ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::INVENTORY_TRANSFER_BEFORE</code>
| Before moving inventory items
| <code>inventory_id</code>, <code>operation_id</code>, <code>data</code>
|-
| <code>CustomEvent::INVENTORY_TRANSFERRED</code>
| After moving inventory items
| <code>inventory_id</code>, <code>operation_id</code>, <code>data</code>
|}

=== Tasks ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::TASK_CARD_RENDER</code>
| When rendering content in the task card
| <code>task_type_id</code>, <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WORK_DATE_RENDER</code>
| When rendering content near the work date
| <code>task_type_id</code>, <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CREATE_BEFORE</code>
| Before creating a task
| <code>task_type_id</code>, <code>author_employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CREATED</code>
| After creating a task
| <code>task_id</code>, <code>task_type_id</code>, <code>author_employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DELETE_BEFORE</code>
| Before deleting a task
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CHANGE_BEFORE</code>
| Before editing a task
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_CHANGED</code>
| After editing a task
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CREATE_BEFORE</code>
| Before adding a task comment
| <code>task_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CREATED</code>
| After adding a task comment
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_CHANGED</code>
| After editing a task comment
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_COMMENT_TEXT_RENDER</code>
| When rendering task comment text
| <code>task_id</code>, <code>comment_id</code>, <code>comment</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DIVISION_ASSIGN_BEFORE</code>
| Before adding a division to a task
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_DIVISION_REMOVE_BEFORE</code>
| Before removing a division from a task
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_EMPLOYEE_ASSIGN_BEFORE</code>
| Before adding an assignee to a task
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_EMPLOYEE_REMOVE_BEFORE</code>
| Before removing an assignee from a task
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WATCHER_DIVISION_ASSIGN_BEFORE</code>
| Before adding a division as a watcher
| <code>task_id</code>, <code>division_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_WATCHER_EMPLOYEE_ASSIGN_BEFORE</code>
| Before adding an employee as a watcher
| <code>task_id</code>, <code>employee_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_OBJECT_ATTACHED</code>
| After adding an object to a task
| <code>task_id</code>, <code>object_type</code>, <code>object_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_OBJECT_DETACHED</code>
| After removing an object from a task
| <code>task_id</code>, <code>object_type</code>, <code>object_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_RETURNED_TO_AUTHOR</code>
| After returning a task to the author
| <code>task_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_STATE_CHANGE_BEFORE</code>
| Before changing a task status
| <code>task_id</code>, <code>old_state_id</code>, <code>new_state_id</code>, <code>data</code>
|-
| <code>CustomEvent::TASK_STATE_CHANGED</code>
| After changing a task status
| <code>task_id</code>, <code>old_state_id</code>, <code>new_state_id</code>, <code>data</code>
|}

=== Communications installations ===

{| class="wikitable"
! Constant
! When called
! <code>$event</code> data
|-
| <code>CustomEvent::NODE_CARD_ADDITIONAL_DATA_RENDER</code>
| When rendering additional content in the communications installation card
| <code>node_id</code>, <code>data</code>
|-
| <code>CustomEvent::NODE_CARD_PRIMARY_CONTENT_RENDER</code>
| When rendering the main content in the communications installation card
| <code>node_id</code>, <code>data</code>
|}

Usm abills UK

2026-09-16T18:15:45Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_abills_EN|en]] | '''uk''' | [[Usm_abills|ru]]

{{activ}}

'''usm_abills''' - модуль для організації імпорту даних із білінгової системи ABillS в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_abills_UK|us_abills]]''' - див.: [[Переход_с_us_abills_на_usm_abills_UK|Перехід з us_abills на usm_abills]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.eu/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[ABillS_UK|ABillS]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_abills.zip містить файли:

usm_abills.php
usm_abills.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля і розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_abills.conf.php-example потрібно перейменувати на usm_abills.conf.php і внести до нього необхідні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів запустіть модуль вручну командою:

php usm_abills.php

Він має відпрацювати без помилок і повернути дані:

usm_abills
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(вкажіть потрібні шляхи)'':

*/10 * * * * php usm_abills.php

== Параметри конфігурації ==

Налаштування модуля виконується у файлі '''usm_abills.conf.php'''.

Також можна використовувати стандартні параметри з модуля [[usm_billing_UK#Параметри_конфігурації|usm_billing]].

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide" ''("Налаштування - Білінги")''
$logPath - шлях для запису логів
$isSilence - прапорець "режим тиші" ''(приховати виведення інформаційних повідомлень модуля в консоль)''

$billingDBHost - адреса сервера білінгу
$billingDBPort - порт mysql-підключення до бази білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу

$confAdrDistrictMode - режим обробки району в адресі
$confAddressListCityIds - список ID населених пунктів
$confDateConnectSrc - джерело дати підключення абонента до мережі
$confUserImportExpr - додаткова умова для імпорту абонентів
$confAddFieldPhone - поле таблиці users_pi з номером телефону
$confAddFieldCellPhone - поле таблиці users_pi з номером мобільного телефону
$confAddFieldEntrance - поле таблиці users_pi з номером під'їзду
$confAddFieldFloor - поле таблиці users_pi з номером поверху
$confIsSavePasswordToComment - зберігати пароль абонента в примітках
$confIsCidIp - поле dv/internet_log.CID містить IP-адресу абонента
$confIsIpAdrOnlyFromDhcpHosts - імпортувати IP-адресу тільки з dhcphosts_hosts
$confIsIpAdrSkipFromDhcpHosts - не імпортувати IP-адреси з dhcphosts_hosts
$confUserStateSrc - джерело стану абонента в білінгу
$confWorkState2 - перетворення стану "Не активізований" у статус ERP
$confWorkState5 - перетворення стану "Занадто малий депозит" у статус ERP
$confIsHideDvLogData - не імпортувати дані з таблиці dv/internet_log
$confIsHideIpAdrFromDvCalls - не імпортувати IP-адресу з таблиці dv/internet_calls
$confIsHideCidFromDvMain - не імпортувати CID з таблиці dv/internet_main
$confUserAccountSrc - джерело особового рахунку абонента
$confIsImportTags - імпортувати абонентські позначки (tags)
$confAddressSrc - джерело інформації про адресу абонента
$confIsImportMsg - імпортувати повідомлення абонентів
$confPasswordSecretKey - Secret Key для розшифрування паролів абонентів
$confIsImportPasswordToUsPassword - імпортувати пароль абонента в пароль UserSide
$confIsImportOnlyUsedAddress - імпортувати тільки використовувані адреси
$confIsPrimaryDvModule - використовувати тільки інформацію модуля DV
$confWorkStateArray - масив відповідності ID статусів абонента в білінгу та в ERP
$confImportCustomerTaxNumber - імпортувати податковий номер абонента в додаткові поля
$confTaxNumberField - поле з податковим номером у таблиці users
$confImportCustomerPassport - імпортувати паспорт абонента в додаткові поля
$confPassportField - поле з паспортом у таблиці users
$confImportCustomerNasIp - імпортувати NAS IP-адресу абонента в додаткові поля
$confImportCustomerNasPort - імпортувати NAS-порт абонента в додаткові поля
$confImportCustomerNasName - імпортувати NAS-ім'я абонента в додаткові поля
$confImportCustomerNasVlan - імпортувати NAS VLAN абонента в додаткові поля
$confImportCustomerGroup - імпортувати групу абонента в додаткові поля
$confContactTypeIdPhone - Type Id для імпорту телефонного номера
$confContactTypeIdCellPhone - Type Id для імпорту мобільного номера
$confAddFieldPhone1 - поле з додатковим телефоном N1
$confAddFieldPhone2 - поле з додатковим телефоном N2
$confIsImportTriplePay - імпортувати тарифи Triple Pay
$confTariffIdSrcField - поле з id у таблиці тарифів

== Запуск у Docker-оточенні ==

Якщо ви використовуєте USERSIDE в Docker-оточенні, зовнішні модулі usm зручно запускати в окремих Docker-контейнерах.

Ми надаємо Docker-оточення для запуску модуля usm_abills ''(оточення не містить файлів модуля, їх потрібно самостійно завантажити з особистого кабінету)''.

Завантажити Docker-оточення можна за посиланням: https://github.com/userside/usm_abills-docker-env/releases

Usm utm5 UK

2026-09-16T18:11:15Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_utm5_EN|en]] | '''uk''' | [[Usm_utm5|ru]]

{{activ}}

'''usm_utm5''' - модуль для організації імпорту даних із білінгової системи UTM5 в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_utm5_UK|us_utm5]]''' - див.: [[Переход_с_us_utm5_на_usm_utm5_UK|Перехід з us_utm5 на usm_utm5]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.eu/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[UTM5_UK|UTM5]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_utm5.zip містить файли:

usm_utm5.php
usm_utm5.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_utm5.conf.php-example потрібно перейменувати на usm_utm5.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_utm5.php

Він має відпрацювати без помилок і повернути дані:

usm_utm5
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_utm5.php

== Параметри конфігурації ==

Налаштування модуля виконується у файлі '''usm_utm5.conf.php'''.

Також можна використовувати стандартні параметри з модуля [[usm_billing_UK#Параметри_конфігурації|usm_billing]].

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для запису логів
$isSilence - режим тиші
$billingDBHost - адреса сервера білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу
$billingCodePage - кодування бази білінгу
$billingDbProvider - тип СУБД [mysql|postgresql]

$confServiceData - використовувати зв'язки послуг замість зв'язок тарифів
$confIsHideShablonsFromTariffList - не включати шаблони в імпорт тарифів
$confServiceDataServiceTypeRestrict - імпортувати тарифи/абонентів із вказаним service_type
$confRentId - ID поля з абонплатою тарифу
$confDontImportTariffWithComment - не імпортувати тарифи з таким коментарем
$confMultiplicationTariffFees - коефіцієнт множення абонплати
$confIsUseDateConnect - використовувати users.connect_date як дату підключення
$confIsCustomerConnectFix - додавати інформацію про підключення абонентів до комутаторів
$confIsImportBankInformation - імпортувати банківські реквізити абонента
$confDontImportCustomerFromGroupId - не імпортувати абонентів із вказаної групи
$confImportCustomerOnlyFromGroupId - імпортувати абонентів тільки з вказаної групи
$confImportCustomerExpr - умова імпорту абонентів
$confImportCustomerExpr2 - додаткова умова імпорту абонентів
$confTrafficRxClass - клас вхідного трафіку
$confTrafficTxClass - клас вихідного трафіку
$confUseIpMethod - варіант роботи з IP
$confIsUseDhcpData - завантажувати DHCP-дані
$confDhcpServiceLinkId - ID зв'язку послуги з dhs_sessions_log
$confIsHostByteOrder - host byte order у Framed_IP_Address
$confIsActiveAllDhcp - використовувати поточну дату для активних DHCP-записів
$confDhsSessionLogCondition - умова вибірки з dhs_sessions_log
$confIsDhcpLeasesLogUse - завантажувати DHCP-дані з dhcp_leases_log
$confIsBlockType1IsPause - вважати block_type #1 паузою
$confIsBlockType2IsStop - вважати block_type #2 стопом
$confIsUseIdToAgreement - використовувати ID абонента як номер договору
$confIsSavePasswordToComment - зберігати пароль абонента в коментарі
$confIsImportPaidHistory - імпортувати історію платежів
$confVersionFramedIp - тип імпорту Framed_IP_Address
$confIsImportHistoryTariff - імпортувати історію зміни тарифів
$confCustomerAccountSrc - джерело номера особового рахунку
$confImportCustomerUnlimited - імпортувати accounts.unlimited у додаткові дані
$confImportCustomerPassport - імпортувати паспортні дані
$confIsDontUpdateDateConnect - не імпортувати дату підключення
$confIsImportAdditionalServices - імпортувати додаткові послуги
$confIsImportSwitchCommutation - імпортувати комутацію абонента до обладнання
$confIsImportSwitchTableCommutation - імпортувати комутацію з таблиці комутаторів білінгу
$confImportPaidLimit - ліміт кількості платежів за один імпорт
$confIsImportLessPhone - імпортувати порожні телефони
$confIsSaveVpnPasswordToComment - зберігати VPN-пароль у коментарі
$confAddressSrc - джерело адреси абонента
$confExprIpImport - умова імпорту IP-адрес
$lastPaidIdPlus - початковий лічильник імпорту платежів
$confIsSkipCustomerBuilding - не імпортувати номер будинку
$confImportPaidDisableMethod - список ігнорованих способів оплати
$confIsSkipDhsSessionsLogTraffic - ігнорувати трафік із dhs_sessions_log
$confIsImportServiceWithAddressAsAliasCustomer - імпортувати послугу з адресою як дочірній запис абонента
$confIsIgnoreHouseBlock - ігнорувати корпус будинку
$confAdditionalFieldWithAgreementNumber - додаткове поле білінгу з номером договору
$confAdditionalFieldWithAgreementDate - додаткове поле білінгу з датою договору
$confImportCustomerAllowedCid - імпортувати User Allowed Cid у додаткові дані
$confImportCustomerPassword - імпортувати пароль абонента в додаткові дані
$confAccountPattern - шаблон номера особового рахунку
$confImportGateway - імпортувати шлюз абонента
$confImportMask - імпортувати маску абонента в додаткові дані UserSide ''(потрібно вказати id додаткового поля)''
$confIsRegionAddressSystem - імпортувати області/регіони з адресної системи білінгу ''(тільки якщо $confAddressSrc = 0)''
$confIsImportServiceLinksAsChild - імпортувати сервісні зв'язки як дочірні записи абонентів ''(тільки для UTM+)''
$confIsImportWorkPhoneToPhone - імпортувати робочий телефон як "звичайний" телефон
$confImportCustomerUnlimited - імпортувати факт безліміту в додаткові дані UserSide ''(потрібно вказати id додаткового поля)''
$confImportCustomerVlanId - імпортувати VlanID у додаткові дані UserSide ''(потрібно вказати id додаткового поля)''
$confImportCustomerTaxNumber - імпортувати податковий номер у додаткові дані UserSide ''(потрібно вказати id додаткового поля)''
$confIsImportPaidServiceHistory - імпортувати історію оплат за послугами
$confIsAgreementNumberFromContractNumber - імпортувати номер договору з accounts.contract_number
$confIsAgreementDateFromSignatureDate - імпортувати дату договору з accounts.signature_date
$confImportBankName - імпортувати найменування банку
$confServiceTypeTv - тип послуг для ТВ-тарифів
$confServiceTypePhone - тип послуг для телефонних тарифів
$confAddressRemoveStr1 - рядок N1 для заміни в текстовій адресі
$confAddressRemoveStr2 - рядок N2 для заміни в текстовій адресі
$confAddressRemoveStr3 - рядок N3 для заміни в текстовій адресі

// Якщо під час імпорту зовнішньої IP-адреси потрібно додати абоненту внутрішню IP-адресу, заповніть такі параметри
$confIpGrayNet - яку підмережу IP-адрес вважати зовнішньою, наприклад "172.16.0.0", або "0" - не обробляти
$confIpWhiteNet - яку підмережу IP-адрес додавати, наприклад "10.0.0.0", або "0" - не додавати

// Можна налаштувати додавання додаткових міток абоненту залежно від значення додаткового поля в білінгу
$markMerge[6]['id'] = 1; - [utm5.uaddparams_desc.paramid]['id'] = userside.id
$markMerge[6]['value'] = 'test_string'; - [utm5.uaddparams_desc.paramid]['value'] = Compare String

// Можна налаштувати імпорт додаткових полів із білінгу в додаткові поля абонента ERP "UserSide" ''(за потреби)''
// Заповнюється масив $additionalDataMerge ''(для userside 3.13 і раніше)'' або масив $additionalCustomerDataMerge ''(для userside 3.14 і пізніше)''. Можна додавати власні поля. Якщо значення коду поля дорівнює нулю, імпорт не виконується
// Імпорт виконується у вже створені додаткові поля. Тобто попередньо це додаткове поле має бути створене в UserSide для картки абонента
$additionalCustomerDataMerge[1] = 1; - [utm5.uaddparams_desc.paramid] = userside.id
$additionalCustomerDataMerge[2] = 2; - [utm5.uaddparams_desc.paramid] = userside.id

Usm utm5 UK

2026-09-16T18:09:11Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_utm5_EN|en]] | '''uk''' | [[Usm_utm5|ru]]

{{activ}}

'''usm_utm5''' - модуль для організації імпорту даних із білінгової системи UTM5 в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_utm5_UK|us_utm5]]''' - див.: [[Переход_с_us_utm5_на_usm_utm5_UK|Перехід з us_utm5 на usm_utm5]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.eu/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[UTM5_UK|UTM5]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_utm5.zip містить файли:

usm_utm5.php
usm_utm5.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_utm5.conf.php-example потрібно перейменувати на usm_utm5.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_utm5.php

Він має відпрацювати без помилок і повернути дані:

usm_utm5
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_utm5.php

== Параметри конфігурації ==

Налаштування модуля виконується у файлі '''usm_utm5.conf.php'''.

Також можна використовувати стандартні параметри з модуля [[usm_billing_UK#Параметри_конфігурації|usm_billing]].

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для запису логів
$isSilence - режим тиші
$billingDBHost - адреса сервера білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу
$billingCodePage - кодування бази білінгу
$billingDbProvider - тип СУБД [mysql|postgresql]

$confServiceData - використовувати зв'язки послуг замість зв'язок тарифів
$confIsHideShablonsFromTariffList - не включати шаблони в імпорт тарифів
$confServiceDataServiceTypeRestrict - імпортувати тарифи/абонентів із вказаним service_type
$confRentId - ID поля з абонплатою тарифу
$confDontImportTariffWithComment - не імпортувати тарифи з таким коментарем
$confMultiplicationTariffFees - коефіцієнт множення абонплати
$confIsUseDateConnect - використовувати users.connect_date як дату підключення
$confIsCustomerConnectFix - додавати інформацію про підключення абонентів до комутаторів
$confIsImportBankInformation - імпортувати банківські реквізити абонента
$confDontImportCustomerFromGroupId - не імпортувати абонентів із вказаної групи
$confImportCustomerOnlyFromGroupId - імпортувати абонентів тільки з вказаної групи
$confImportCustomerExpr - умова імпорту абонентів
$confImportCustomerExpr2 - додаткова умова імпорту абонентів
$confTrafficRxClass - клас вхідного трафіку
$confTrafficTxClass - клас вихідного трафіку
$confUseIpMethod - варіант роботи з IP
$confIsUseDhcpData - завантажувати DHCP-дані
$confDhcpServiceLinkId - ID зв'язку послуги з dhs_sessions_log
$confIsHostByteOrder - host byte order у Framed_IP_Address
$confIsActiveAllDhcp - використовувати поточну дату для активних DHCP-записів
$confDhsSessionLogCondition - умова вибірки з dhs_sessions_log
$confIsDhcpLeasesLogUse - завантажувати DHCP-дані з dhcp_leases_log
$confIsBlockType1IsPause - вважати block_type #1 паузою
$confIsBlockType2IsStop - вважати block_type #2 стопом
$confIsUseIdToAgreement - використовувати ID абонента як номер договору
$confIsSavePasswordToComment - зберігати пароль абонента в коментарі
$confIsImportPaidHistory - імпортувати історію платежів
$confVersionFramedIp - тип імпорту Framed_IP_Address
$confIsImportHistoryTariff - імпортувати історію зміни тарифів
$confCustomerAccountSrc - джерело номера особового рахунку
$confImportCustomerUnlimited - імпортувати accounts.unlimited у додаткові дані
$confImportCustomerPassport - імпортувати паспортні дані
$confIsDontUpdateDateConnect - не імпортувати дату підключення
$confIsImportAdditionalServices - імпортувати додаткові послуги
$confIsImportSwitchCommutation - імпортувати комутацію абонента до обладнання
$confIsImportSwitchTableCommutation - імпортувати комутацію з таблиці комутаторів білінгу
$confImportPaidLimit - ліміт кількості платежів за один імпорт
$confIsImportLessPhone - імпортувати порожні телефони
$confIsSaveVpnPasswordToComment - зберігати VPN-пароль у коментарі
$confAddressSrc - джерело адреси абонента
$confExprIpImport - умова імпорту IP-адрес
$lastPaidIdPlus - початковий лічильник імпорту платежів
$confIsSkipCustomerBuilding - не імпортувати номер будинку
$confImportPaidDisableMethod - список ігнорованих способів оплати
$confIsSkipDhsSessionsLogTraffic - ігнорувати трафік із dhs_sessions_log
$confIsImportServiceWithAddressAsAliasCustomer - імпортувати послугу з адресою як дочірній запис абонента
$confIsIgnoreHouseBlock - ігнорувати корпус будинку
$confAdditionalFieldWithAgreementNumber - додаткове поле білінгу з номером договору
$confAdditionalFieldWithAgreementDate - додаткове поле білінгу з датою договору
$confImportCustomerAllowedCid - імпортувати User Allowed Cid у додаткові дані
$confImportCustomerPassword - імпортувати пароль абонента в додаткові дані
$confAccountPattern - шаблон номера особового рахунку
$confImportGateway - імпортувати шлюз абонента
$confIsImportPaidServiceHistory - імпортувати історію оплат за послугами
$confIsAgreementNumberFromContractNumber - імпортувати номер договору з accounts.contract_number
$confIsAgreementDateFromSignatureDate - імпортувати дату договору з accounts.signature_date
$confImportBankName - імпортувати найменування банку
$confServiceTypeTv - тип послуг для ТВ-тарифів
$confServiceTypePhone - тип послуг для телефонних тарифів
$confAddressRemoveStr1 - рядок N1 для заміни в текстовій адресі
$confAddressRemoveStr2 - рядок N2 для заміни в текстовій адресі
$confAddressRemoveStr3 - рядок N3 для заміни в текстовій адресі

// Якщо під час імпорту зовнішньої IP-адреси потрібно додати абоненту внутрішню IP-адресу, заповніть такі параметри
$confIpGrayNet - яку підмережу IP-адрес вважати зовнішньою, наприклад "172.16.0.0", або "0" - не обробляти
$confIpWhiteNet - яку підмережу IP-адрес додавати, наприклад "10.0.0.0", або "0" - не додавати

// Можна налаштувати додавання додаткових міток абоненту залежно від значення додаткового поля в білінгу
$markMerge[6]['id'] = 1; - [utm5.uaddparams_desc.paramid]['id'] = userside.id
$markMerge[6]['value'] = 'test_string'; - [utm5.uaddparams_desc.paramid]['value'] = Compare String

// Можна налаштувати імпорт додаткових полів із білінгу в додаткові поля абонента ERP "UserSide" ''(за потреби)''
// Заповнюється масив $additionalDataMerge ''(для userside 3.13 і раніше)'' або масив $additionalCustomerDataMerge ''(для userside 3.14 і пізніше)''. Можна додавати власні поля. Якщо значення коду поля дорівнює нулю, імпорт не виконується
// Імпорт виконується у вже створені додаткові поля. Тобто попередньо це додаткове поле має бути створене в UserSide для картки абонента
$additionalCustomerDataMerge[1] = 1; - [utm5.uaddparams_desc.paramid] = userside.id
$additionalCustomerDataMerge[2] = 2; - [utm5.uaddparams_desc.paramid] = userside.id

Usm abills UK

2026-09-16T18:09:11Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_abills_EN|en]] | '''uk''' | [[Usm_abills|ru]]

{{activ}}

'''usm_abills''' - модуль для організації імпорту даних із білінгової системи ABillS в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_abills_UK|us_abills]]''' - див.: [[Переход_с_us_abills_на_usm_abills_UK|Перехід з us_abills на usm_abills]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.eu/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[ABillS_UK|ABillS]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_abills.zip містить файли:

usm_abills.php
usm_abills.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля і розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_abills.conf.php-example потрібно перейменувати на usm_abills.conf.php і внести до нього необхідні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів запустіть модуль вручну командою:

php usm_abills.php

Він має відпрацювати без помилок і повернути дані.

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(вкажіть потрібні шляхи)'':

*/10 * * * * php usm_abills.php

== Параметри конфігурації ==

Налаштування модуля виконується у файлі '''usm_abills.conf.php'''.

Також можна використовувати стандартні параметри з модуля [[usm_billing_UK#Параметри_конфігурації|usm_billing]].

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide" ''("Налаштування - Білінги")''
$logPath - шлях для запису логів
$isSilence - прапорець "режим тиші" ''(приховати виведення інформаційних повідомлень модуля в консоль)''

$billingDBHost - адреса сервера білінгу
$billingDBPort - порт mysql-підключення до бази білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу

$confAdrDistrictMode - режим обробки району в адресі
$confAddressListCityIds - список ID населених пунктів
$confDateConnectSrc - джерело дати підключення абонента до мережі
$confUserImportExpr - додаткова умова для імпорту абонентів
$confAddFieldPhone - поле таблиці users_pi з номером телефону
$confAddFieldCellPhone - поле таблиці users_pi з номером мобільного телефону
$confAddFieldEntrance - поле таблиці users_pi з номером під'їзду
$confAddFieldFloor - поле таблиці users_pi з номером поверху
$confIsSavePasswordToComment - зберігати пароль абонента в примітках
$confIsCidIp - поле dv/internet_log.CID містить IP-адресу абонента
$confIsIpAdrOnlyFromDhcpHosts - імпортувати IP-адресу тільки з dhcphosts_hosts
$confIsIpAdrSkipFromDhcpHosts - не імпортувати IP-адреси з dhcphosts_hosts
$confUserStateSrc - джерело стану абонента в білінгу
$confWorkState2 - перетворення стану "Не активізований" у статус ERP
$confWorkState5 - перетворення стану "Занадто малий депозит" у статус ERP
$confIsHideDvLogData - не імпортувати дані з таблиці dv/internet_log
$confIsHideIpAdrFromDvCalls - не імпортувати IP-адресу з таблиці dv/internet_calls
$confIsHideCidFromDvMain - не імпортувати CID з таблиці dv/internet_main
$confUserAccountSrc - джерело особового рахунку абонента
$confIsImportTags - імпортувати абонентські позначки (tags)
$confAddressSrc - джерело інформації про адресу абонента
$confIsImportMsg - імпортувати повідомлення абонентів
$confPasswordSecretKey - Secret Key для розшифрування паролів абонентів
$confIsImportPasswordToUsPassword - імпортувати пароль абонента в пароль UserSide
$confIsImportOnlyUsedAddress - імпортувати тільки використовувані адреси
$confIsPrimaryDvModule - використовувати тільки інформацію модуля DV
$confWorkStateArray - масив відповідності ID статусів абонента в білінгу та в ERP
$confImportCustomerTaxNumber - імпортувати податковий номер абонента в додаткові поля
$confTaxNumberField - поле з податковим номером у таблиці users
$confImportCustomerPassport - імпортувати паспорт абонента в додаткові поля
$confPassportField - поле з паспортом у таблиці users
$confImportCustomerNasIp - імпортувати NAS IP-адресу абонента в додаткові поля
$confImportCustomerNasPort - імпортувати NAS-порт абонента в додаткові поля
$confImportCustomerNasName - імпортувати NAS-ім'я абонента в додаткові поля
$confImportCustomerNasVlan - імпортувати NAS VLAN абонента в додаткові поля
$confImportCustomerGroup - імпортувати групу абонента в додаткові поля
$confContactTypeIdPhone - Type Id для імпорту телефонного номера
$confContactTypeIdCellPhone - Type Id для імпорту мобільного номера
$confAddFieldPhone1 - поле з додатковим телефоном N1
$confAddFieldPhone2 - поле з додатковим телефоном N2
$confIsImportTriplePay - імпортувати тарифи Triple Pay
$confTariffIdSrcField - поле з id у таблиці тарифів

== Запуск у Docker-оточенні ==

Якщо ви використовуєте USERSIDE в Docker-оточенні, зовнішні модулі usm зручно запускати в окремих Docker-контейнерах.

Ми надаємо Docker-оточення для запуску модуля usm_abills ''(оточення не містить файлів модуля, їх потрібно самостійно завантажити з особистого кабінету)''.

Завантажити Docker-оточення можна за посиланням: https://github.com/userside/usm_abills-docker-env/releases

Usm nodeny UK

2026-09-16T18:09:11Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_nodeny_EN|en]] | '''uk''' | [[Usm_nodeny|ru]]

{{activ}}

'''usm_nodeny''' - модуль для організації імпорту даних із білінгової системи NoDeny в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_nodeny_UK|us_nodeny]]''' - див.: [[Переход_с_us_nodeny_на_usm_nodeny_UK|Перехід з us_nodeny на usm_nodeny]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.ua/price.php Платний]

Додаткову інформацію та перелік імпортованих даних див. на сторінці: [[NoDeny_UK|NoDeny]]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_nodeny.zip містить файли:

usm_nodeny.php
usm_nodeny.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_nodeny.conf.php-example потрібно перейменувати на usm_nodeny.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_nodeny.php

Він має відпрацювати без помилок і повернути дані:

usm_nodeny
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_nodeny.php

== Параметри ==

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для логів
$isSilence - режим тиші
$billingDBHost - адреса сервера білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу
$billingCodePage - кодування бази білінгу
$billingDBPort - порт бази білінгу
$confListIgnoreImportCustomerState - список статусів користувачів, з якими їх не потрібно імпортувати
$confIsDisableImportAlias - не імпортувати дочірні записи (aliases)
$confPasswordAESDecryptString - кодовий рядок для AES-розшифрування пароля в білінгу
$confIdGroupDeleteCustomers - ID групи, зарезервованої для видалених користувачів
$confIdGroupCustomersOnPause - ID групи для стану "пауза"
$confIsSavePasswordToComment - зберігати пароль користувача в додаткових даних
$confImportCustomerExpr - додаткова умова імпорту користувачів
$confIsSwapTrafCounter - міняти місцями вхідний/вихідний трафік
$confIsImportPaidCodeInComment - імпортувати персональний платіжний код у коментарі
$confFieldDateConnect - імпортувати дату підключення користувача до UserSide
$confAddFieldIdCity - код поля "Населений пункт"
$confAddFieldIdStreet - код додаткового поля "Вулиця"
$confAddFieldIdHouseNumber - код додаткового поля "Будинок"
$confAddFieldIdHouseBlock - код додаткового поля "Корпус"
$confAddFieldIdEntrance - код додаткового поля "Під'їзд"
$confAddFieldIdFloor - код поля "Поверх"
$confAddFieldIdApartment - код додаткового поля "Квартира"
$confAddFieldIdMac - код додаткового поля "MAC-адреса"
$confAddFieldIdPhone - код додаткового поля "Телефон"
$confAddFieldIdPhone2 - код додаткового поля "Домашній телефон"
$confAddFieldIdEMail - код додаткового поля "E-mail"
$confAddFieldIdRealIp - код додаткового поля "Реальна IP-адреса"
$confAddFieldIdDateConnect - код додаткового поля "Дата підключення"

Usm bgbilling UK

2026-09-16T18:09:11Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_bgbilling_EN|en]] | '''uk''' | [[Usm_bgbilling|ru]]

{{activ}}

'''usm_bgbilling''' - модуль для організації імпорту даних із білінгової системи BGBilling в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_bgbilling_UK|us_bgbilling]]''' - див.: [[Переход_с_us_bgbilling_на_usm_bgbilling_UK|Перехід з us_bgbilling на usm_bgbilling]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.ua/price.php Платний]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_bgbilling.zip містить файли:

usm_bgbilling.php
usm_bgbilling.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_bgbilling.conf.php-example потрібно перейменувати на usm_bgbilling.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_bgbilling.php

Він має відпрацювати без помилок і повернути дані:

usm_bgbilling
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_bgbilling.php

== Параметри ==

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для логів
$isSilence - режим тиші
$billingDBHost - адреса сервера білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу
$billingCodePage - кодування бази білінгу
$confIsIgroneTtlTable - ігнорувати дані з таблиці tariff_tree_link
$confPidAddressContract - PID із contract_parameter_type_2 з полем адреси
$confIsUseCustomerNameTable - використовувати contract_parameter_type_1 для отримання імені користувача
$confIsWoPaymentParent - не використовувати значення батьківських платежів у тарифах
$confIsSkipCustomerWoLogin - не імпортувати користувачів без логінів
$confModuleInetNumber - номер inet-модуля
$confModuleDialupNumber - номер dialup-модуля
$confModuleIpnNumber - номер ipn-модуля
$confAddFieldAgreementNumber - id додаткового поля з номером договору
$confImportCustomerAgreementDateClose - id додаткового поля ERP для імпорту дати закінчення договору
$confImportCustomerVlan - id додаткового поля ERP для імпорту VLAN користувача
$confImportPppoeLogin - id додаткового поля ERP для імпорту PPPoE-логіна
$confImportPppoePass - id додаткового поля ERP для імпорту PPPoE-пароля
$confBillingState0 - статус у білінгу "0 - підключений"
$confBillingState1 - статус у білінгу "1 - відключений"
$confBillingState2 - статус у білінгу "2 - відключений"
$confBillingState3 - статус у білінгу "3 - закритий"
$confBillingState4 - статус у білінгу "4 - призупинений"
$confBillingState5 - статус у білінгу "5 - на підключенні"
$contractAddString - додатковий рядок для імпорту інформації про договори
$confAddFieldPhone - id додаткового поля з номером телефону
$confIsImportAgreementAsLogin - імпортувати номер договору як логін
$confIsSkipReplaceSlashInHouseBlock - не замінювати слеш (/) у блоці/корпусі адреси будівлі

Usm billing UK

2026-09-16T18:09:01Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_billing_EN|en]] | '''uk''' | [[Usm_billing|ru]]

{{activ}}

'''usm_billing''' - модуль для організації імпорту даних із білінгових систем в ERP "UserSide" з використанням [[Универсальное_API_UK|універсального API]].

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Підтримувані стандартні білінги:''' [[uBilling_UK|uBilling]] v.0.7.2+, [[MikBill_UK|MikBill]] v.2.8.16+, [[Carbon_Billing_UK|Carbon Billing]] v.5.15.06+, [[ABillS_UK|ABillS]] v.0.77.50+, [[Platex_UK|Platex]] v.7+

'''Статус модуля:''' [http://userside.eu/price.php Безкоштовний]

== Перелік імпортованих даних * ==

''* - може змінюватися залежно від того, які саме дані віддає білінг''

'''Тарифні плани'''
* назва
* розмір абонентської плати
* щоденна або щомісячна абонентська плата
* вхідна швидкість
* вихідна швидкість
* обсяг включеного трафіку

'''Абоненти'''
* обліковий запис
* ПІБ
* номер договору та дата
* номер особового рахунку
* поточний тарифний план
* наступний тарифний план
* дата останньої активності в інтернеті
* обсяг трафіку, спожитого абонентом за поточний місяць
* адреса абонента ''(населений пункт, вулиця, номер будинку, корпус будинку, квартира)''
* IP/MAC-адреси
* статус роботи в білінгу
* нотатки щодо абонента
* баланс
* кредит
* знижка абонента
* 2 номери телефону
* фізична/юридична особа
* дата підключення до мережі
* адреса електронної пошти
* додаткові поля/дані щодо абонента ''(налаштовується)''

== Інформація щодо встановлення модуля ==

Архів usm_billing.zip містить файли:

usm_billing.php
usm_billing.conf.php-example

1. Виділіть окремий ''(довільний)'' каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля. Надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_billing.conf.php-example потрібно перейменувати на usm_billing.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_billing.php

Він має відпрацювати без помилок і повернути дані:

usm_billing
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_billing.php

== Параметри конфігурації ==

$billingName - тип білінгу [standart|carbon5]
$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingUrl - URL до API білінгу
$billingId - номер білінгу в ERP "UserSide" ''("Налаштування - Білінги")''
$logPath - шлях для запису логів
$isSilence - прапорець "Режим тиші" ''(приховати виведення інформаційних повідомлень модуля в консоль)''
// Можна налаштувати імпорт додаткових полів із білінгу в додаткові поля абонента ERP "UserSide" ''(за потреби)''
// Заповнюється масив $additionalDataMerge ''(для userside 3.13 і раніше)'' або масив $additionalCustomerDataMerge ''(для userside 3.14 і пізніше)''. Можна додавати власні поля. Якщо значення коду поля дорівнює нулю, імпорт не виконується
// Імпорт виконується у вже створені додаткові поля. Тобто попередньо це додаткове поле має бути створене в UserSide для картки абонента
$additionalCustomerDataMerge - налаштування імпорту додаткових даних/полів

Ці параметри можна використовувати також у модулях взаємодії зі стандартними білінгами ''(usm_utm5, usm_abills тощо)'', оскільки вони побудовані на базі цього модуля.

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для логів
$isSilence - режим тиші
$confIsSkipUpdateAgreementDate - не оновлювати дату договору
$confIsDisableCreateAddress - не створювати нові адресні об'єкти під час імпорту
$confIsSkipDeleteEmptyIp - не видаляти в абонентів невикористовувані IP-адреси
$confIsForceDeleteEmptyIp - примусово видаляти невикористовувані IP-адреси
$confSkipDeleteIp - масив діапазонів IP-адрес, які не потрібно видаляти
$confIsImportLessPhone - імпортувати порожні значення телефонів
$confIsImportLessAddress - імпортувати порожню адресу абонента
$confIsUpdateEmptyLevel - імпортувати порожній поверх абонента
$confIsUpdateEmptyEntrance - імпортувати порожній під'їзд абонента
$confIsImportPasswordToUsPassword - імпортувати пароль абонента з білінгу в пароль особистого кабінету UserSide
$confIsSkipUpdateDateActivity - не оновлювати дату активності абонентів у білінгу
$confIsSkipSyncCustomerIsCorporate - не оновлювати ознаку "юридична особа"
$confIsSkipUnusedAddress - не імпортувати невикористовувані адреси
$isWithoutLog - не створювати файли логів
$confAlwaysSetCustomerGroupId - встановлювати ID групи для всіх імпортованих абонентів
$confIsUseStreetFullName - використовувати повну назву імпортованої вулиці
$confIsImportMessage - імпортувати повідомлення абонентів із білінгу
$confIsRemoveEmptyGroups - видаляти невикористовувані групи з ERP
$confIsRemoveEmptyMarkMerge - знімати з абонентів позначки, яких немає в білінгу
$confIsDoNotUpdateAddPhone - не імпортувати додаткові телефони з білінгу
$confIsSkipSlashInNewBuildingNumber - пропускати слеш (/) в адресі під час створення нових будівель

== Використання модуля в Docker ==

Починаючи з версії 3.16.6, Docker-bundle містить сервіс, до складу якого входить usm_billing.

Сервіс налаштовується за допомогою змінних оточення безпосередньо в compose.yaml. Назви змінних оточення ідентичні назвам конфігураційних змінних, наведених у попередньому розділі.

Для розширенішої конфігурації можна підключити додатковий конфігураційний файл, який містить лише спеціальні змінні, значення яких неможливо встановити через змінні оточення. Для цього в compose.yaml для служби usm_billing додайте або розкоментуйте рядок у volumes:
- ${ERP_BASE_DIR}/config/usm_billing_config.php:/module/usm_billing_config.php
І змініть ''(створіть)'' файл config/usm_billing_config.php у підкаталозі бандла для зазначення спеціальних змінних. Першим рядком цього файла обов'язково має бути рядок <code><?php</code>.

Щоб увімкнути періодичний запуск модуля, потрібно розкоментувати відповідний рядок у /etc/cron.d/userside.

Також можна запускати модуль поза docker-бандлом. Для цього потрібно вказати URL вашого USERSIDE у змінній оточення <code>USERSIDE_API_URL</code>.

Usm lanbilling UK

2026-09-16T18:08:50Z

IronBot: [IronBot] Sync UK localization from RU

[[Usm_lanbilling_EN|en]] | '''uk''' | [[Usm_lanbilling|ru]]

{{activ}}

'''usm_lanbilling''' - модуль для організації імпорту даних із білінгової системи LANBilling в ERP "UserSide".

'''Цей модуль є заміною застарілого модуля [[us_lanbilling_UK|us_lanbilling]]''' - див.: [[Переход_с_us_lanbilling_на_usm_lanbilling_UK|Перехід з us_lanbilling на usm_lanbilling]]

'''Мова модуля:''' PHP

'''Поточна версія:''' див. на сторінці: [[Модули_UK|Модулі]]

'''Статус модуля:''' [http://userside.ua/price.php Платний]

== Інформація щодо встановлення модуля ==

'''Переконайтеся, що в системі, де працюватиме модуль, наявна бібліотека php_mysqli'''

Архів usm_lanbilling.zip містить файли:

usm_lanbilling.php
usm_lanbilling.conf.php-example

1. На будь-якому сервері ''(сервер білінгу, userside або окрема машина)'' виділіть окремий довільний каталог для модуля та розмістіть у ньому ці файли.

2. Виділіть окремий каталог для логів роботи модуля та надайте права на запис у цей каталог.

3. Приклад конфігураційного файла usm_lanbilling.conf.php-example потрібно перейменувати на usm_lanbilling.conf.php і внести до нього потрібні зміни ''(перелік параметрів наведено нижче)''.

4. Кілька разів (*) запустіть модуль вручну командою:

php usm_lanbilling.php

Він має відпрацювати без помилок і повернути дані:

usm_lanbilling
====================================
Start module at 2015-11-22 17:32:03
Finish module at 2015-11-22 17:32:14
====================================

''* - Під час першого запуску попередньо буде лише створено багато об'єктів. Що більше об'єктів імпортує модуль, то довше це триватиме. Під час другого та наступних запусків звіряються змінені дані, і оновлюються тільки вони. Другий запуск також триватиме довго, оскільки після першого запуску новостворені об'єкти практично не містять даних. Третій і наступні запуски працюватимуть значно швидше.''

5. Візуально перевірте повноту імпортованих даних в ERP "UserSide".

6. Коли стане зрозуміло, що модуль працює стабільно, додайте його до системного cron для періодичного запуску ''(укажіть потрібні шляхи)''.

*/10 * * * * php usm_lanbilling.php

== Параметри ==

$usersideUrl - URL до ERP "UserSide"
$usersideApiKey - [[UserSide_API_Key_UK|API-ключ ERP "UserSide"]]
$billingId - номер білінгу в ERP "UserSide"
$logPath - шлях для логів
$isSilence - режим тиші
$billingDBHost - адреса сервера білінгу
$billingDBUser - ім'я користувача для доступу до бази білінгу
$billingDBPassword - пароль для доступу до бази білінгу
$billingDBName - ім'я бази даних білінгу
$billingCodePage - кодування бази білінгу
$billingDBPort - порт бази білінгу
$confTariffImportList - типи імпортованих послуг
$confAdrImportSrc - джерело імпорту адреси
$confImportOnlyVgroupsId - імпортувати тільки з конкретним vgroups.id
$confCollectorType - тип колектора
$confCollectorId - код колектора трафіку
$confIsSkipUpdateAgreementDate - не оновлювати дату договору
$confIsSkipCustomerWithClosedAgreement - не імпортувати користувачів із закритими договорами
$confIsOldBillingIp - старий формат IP-адреси
$accountAddString - додатковий рядок під час імпорту особових рахунків
$confAddFieldForPhone - додаткове поле для номера телефону
$confIsSkipLoadIp - не завантажувати IP-адреси
$confIsAddCityTypeToName - додавати тип населеного пункту до назви населеного пункту (усі типи)
$confIsAddCityTypeToName2 - додавати тип населеного пункту до назви населеного пункту (тільки для типів "місто")
$confIsAddStreetTypeToName - додавати тип вулиці до назви вулиці
$confIsImportAlias - імпортувати дочірні записи
$confParameterTypePhone - суфікс поля contract_parameter_type_ з номером телефону
$confImportPassport - імпортувати паспортні дані в додаткове поле
$confImportVgroupsCurrentShape - імпортувати Vgroups CurrentShape Data в додаткове поле
$confImportVgroupsAmount - імпортувати Vgroups Amount Data в додаткове поле
$confIsCityNameInStreetName - додавати назву населеного пункту до назви вулиці
$confIsImportOnlyWithVgroup - імпортувати абонентів тільки за наявності vgroup
$confTrafLimitSelection - мінімальне значення для імпорту трафіку користувача
$confAccountsTable - ім'я таблиці з рахунками абонентів
$confIsDoNotUpdateAddPhone - не оновлювати значення додаткових телефонів абонентів
$confIsOnlyAdrSrc0 - імпортувати адреси тільки з accounts_addr.type = 0
$confIsOnlyAdrSrc1 - імпортувати адреси тільки з accounts_addr.type = 1
$accountExprString - додатковий рядок з умовою імпорту абонентів
$confIsImportCustomerWoTariff - імпортувати також абонентів без тарифів
$confImportFaxNumber - імпортувати номер факсу
$confIsImportArea - імпортувати райони міста
$confIsSecondaryCityToPrimary - використовувати дочірній населений пункт в адресі як основний населений пункт
$confImportAgreementCode - імпортувати номер договору як номер особового рахунку
$confIsImportAliasSame - імпортувати абонентів з однаковими Accounts/Vgroups Login
$confBillingBlockState0 - ID статусу роботи в USERSIDE для стану блокування #0 у білінгу
$confBillingBlockState1 - ID статусу роботи в USERSIDE для стану блокування #1 у білінгу
$confBillingBlockState2 - ID статусу роботи в USERSIDE для стану блокування #2 у білінгу
$confBillingBlockState3 - ID статусу роботи в USERSIDE для стану блокування #3 у білінгу
$confBillingBlockState4 - ID статусу роботи в USERSIDE для стану блокування #4 у білінгу
$confBillingBlockState5 - ID статусу роботи в USERSIDE для стану блокування #5 у білінгу
$confBillingBlockState10 - ID статусу роботи в USERSIDE для стану блокування #10 у білінгу

Дані доступу до другого колектора ''(статистики)'' LANBilling ''(якщо значення порожні, ці облікові дані не використовуватимуться)''

$confStat2DBHost - адреса сервера статистики
$confStat2DBUser - ім'я користувача для доступу до бази статистики
$confStat2DBPassword - пароль для доступу до бази статистики
$confStat2DBName - ім'я бази даних статистики

Дані доступу до третього колектора ''(статистики)'' LANBilling ''(якщо значення порожні, ці облікові дані не використовуватимуться)''

$confStat3DBHost - адреса сервера статистики
$confStat3DBUser - ім'я користувача для доступу до бази статистики
$confStat3DBPassword - пароль для доступу до бази статистики
$confStat3DBName - ім'я бази даних статистики
$confCollector3Type - тип колектора ''(варіанти "user", "rad")''
$confCollector3Id - код колектора трафіку, що використовується для таблиць білінгу: usernnnyyyymmdd або radnnnyyyymmdd

Версії 3.21

2026-09-16T18:03:46Z

IronBot: [IronBot] Sync UK localization from RU

[[Versions_3.21_EN|en]] | '''uk''' | [[Версии_3.21|ru]]

Версії гілки [[3.21_UK|3.21]]

Див. також: [[Версії_ERP_"USERSIDE"|Версії ERP "USERSIDE"]]

== 3.21.56 (у розробці) ==
* Дозволено заповнювати чек-лист для профілів користувачів із правом доступу "Зміна стану"
* Виправлення невеликих помилок

== 3.21.55 - 14.09.2026 ==
* Оптимізовано глобальну схему комутації
* Доопрацьовано пошук за адресою абонента у глобальному пошуку
* Виправлено швидкий пошук за точним збігом ''(із символом "!")'' у верхній панелі
* Виправлено перезавантаження пристрою/збереження конфігурації
* Виправлено роботу фільтра за завданнями ''(у деяких випадках)''
* Виправлено відкриття карток скомутованих об'єктів зі схеми комутації ''(у деяких випадках)''
* Виправлено збереження MAC-адреси під час надходження ТМЦ
* Виправлено швидкий пошук за ТМЦ у діалозі вибору ТМЦ у завданнях ''(у деяких випадках)''
* Виправлено перегляд абонентів за сторінками в картці будинку
* Виправлено швидкий пошук за назвою споруди зв'язку ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.54 - 13.09.2026 ==
* Доопрацьовано виведення об'єктів і підказок на карті покриття
* Виправлено заповнення додаткових полів ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.53 - 09.09.2026 ==
* Виправлення невеликих помилок

== 3.21.52 - 08.09.2026 ==
* Виправлення невеликих помилок

== 3.21.51 - 05.09.2026 ==
* Виправлення невеликих помилок

== 3.21.50 - 02.09.2026 ==
* Доопрацьовано виведення нотаток до назви кабельної лінії в результатах швидкого пошуку за кабельними лініями
* Виправлено фіксацію нотатки до складської операції під час передавання ТМЦ спеціального типу
* Виправлено відображення логічної схеми будинку ''(у деяких випадках)''
* Виправлено можливість вибору файла з основною фотографією/зображенням для співробітника ''(у деяких випадках)''
* Виправлено пошук співробітника в списку за номером телефону
* Виправлено зазначення доступних адрес для співробітника під час його створення
* Виправлення невеликих помилок

== 3.21.49 - 01.09.2026 ==
* Виправлено підсумкове групування значень додаткових полів у списку завдань
* Виправлено зайву заміну символів на HTML-сутності в нотатках щодо абонента
* Виправлено формування тексту повідомлень під час надсилання поштою ''(у деяких випадках)''
* Виправлення невеликих помилок
== 3.21.48 - 31.08.2026 ==
* Додано метод API->task->[[API_task_UK#show|show]]
* '''У запланованій схемі комутації можна виводити список дій у текстовому вигляді ''(з можливістю окремо роздрукувати/позначити виконані)'''''
* У картці споруди зв'язку під час редагування координат можна вставити значення з GPS-приймача пристрою
* Додано можливість створювати шаблони шарів/міток на карті
* У схемі комутації додано кнопку "Тільки маркування", яка приховує назви кабельних ліній і залишає на них лише написи маркування
* Доопрацьовано пошук абонентів за номерами телефонів у списку дзвінків
* Виправлено роботу додаткових полів з типом "Прикріплені файли" під час виконання завдання
* Виправлено перевірку прав під час пошуку MAC-адреси в загальному пошуку
* Виправлено відображення інвентарного номера в картці ТМЦ ''(у деяких випадках)''

== 3.21.47 - 29.08.2026 ==
* Під час зазначення батьківського завдання в картці завдання система одразу перевіряє, чи є таке завдання і чи є права доступу до нього. Якщо доступ є, одразу виводиться посилання на батьківське завдання.
* Виправлено розрив комутації у запланованій схемі комутації ''(у деяких випадках)''
* Виправлено помилку під час відкриття розділу з колірними схемами кабелів ''(у деяких випадках)''
* Виправлено пошук абонента за IP-підмережею
* Виправлено відображення будівель на мапі ''(у деяких випадках)''
* Виправлено перевірку прав під час створення дочірнього завдання
* Виправлено зайвий пошук серед звільнених співробітників
* Виправлено пошук абонентів за телефонними номерами з "+" на початку
* Виправлено сортування списку номерів будівель у селекторі вибору
* Виправлено відображення нотаток на волокнах кабельних ліній у схемі комутації ''(у деяких випадках)''

== 3.21.46 - 28.08.2026 ==
* Виправлено збереження прав доступу до завдань ''(у деяких випадках)''
* Виправлено клікабельний перехід за номером квартири у списку абонентів за будівлею
* Виправлено діалог об'єднання ТМЦ
* Виправлено відображення кількох абонентів у списку дзвінків, якщо номер телефону збігається
* Виправлено неможливість відповісти на коментар до завдання ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.45 - 27.08.2026 ==
* Виправлено пошук за абонентом у швидкому пошуку ''(у деяких випадках)''
* Виправлено помилку під час перегляду логічної схеми будівлі ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.44 - 26.08.2026 ==
* Додано параметр налаштування "Під час переходу до наступної схеми комутації центрувати схему на кабельній лінії, з якої був виконаний перехід"
* У картці ONU/ТМЦ/абонента виводиться окрема плашка, що показує поточний стан ONU ONLINE/OFFLINE
* Виправлено відображення значень додаткових полів з назвами об'єктів у списках завдань та інших списках

== 3.21.43 - 25.08.2026 ==
* Виправлено помилку під час зміни статусу завдання ''(у деяких випадках)''
* Виправлено помилку під час побудови маршруту комутації ''(у деяких випадках)''
* Виправлено фільтрацію за абонентами у списку дзвінків
* Виправлення невеликих помилок

== 3.21.42 - 24.08.2026 ==
* [[Імпорт будівель з КАІС (BG)]]
* Під час переходу у запланованій схемі комутації до схеми сусідньої споруди зв'язку ''(протилежного об'єкта на кабельній лінії)'' схема одразу відкривається у подвійному режимі поточна/запланована. Якщо запланованої схеми ще немає, система пропонує її створити.
* Правий клік на портах дільника у схемі комутації відкриває контекстне меню порту
* Під час ручного додавання VLAN на обладнанні виводиться селектор з портами цього обладнання
* Доопрацьовано автопобудову П-подібного маршруту комутації у схемі комутації
* У налаштуванні статусу завдання можна вказати у виборі ТМЦ, куди передавати вибрані ТМЦ ''(абонент/завдання)'', і на який субрахунок
* У запланованій схемі комутації для портів "пісочних" дільників додано можливість змінювати типи адаптерів
* У запланованій схемі комутації додано можливість масово комутувати волокна/порти між собою
* Зміна типу пігтейлів для портів/волокон у запланованій схемі комутації фіксується лише в ній і не впливає на поточну схему комутації
* Під час виведення розділеної сторінки з поточною/запланованою схемами комутації їх можна експортувати в SVG з різними налаштуваннями експорту
* Виправлено неточності генерації схеми комутації в SVG
* Виправлено можливість додавання локальних UNC-посилань у редактор WYSIWYG
* Виправлено помилки під час надсилання email-сповіщень ''(у деяких випадках)''
* Виправлено переміщення позиції схеми комутації на глобальній схемі комутації ''(у деяких випадках)''
== 3.21.41 - 21.08.2026 ==
* Оптимізовано відображення спливних підказок на мапі покриття
* Виправлено зміну кількості адаптерів під час гарячої заміни дільника
* Виправлено відображення SVG-файлів у галереї прикріплених файлів ''(у деяких випадках)''
* Виправлено помилку перегляду точки маршруту комутації на мапі покриття
* Виправлено помилку під час переходу до картки обладнання з картки завдання ''(у деяких випадках)''
* Виправлено зміну маршруту на мапі для кабельних трас
* Виправлено відображення співробітників у селекторах як звільнених ''(у деяких випадках)''
* Виправлено масштабування об'єктів на мапі ''(у деяких випадках)''
* Виправлено відображення нотаток у списку абонентів
* Виправлено ping довільної IP-адреси
* Виправлення невеликих помилок

== 3.21.40 - 17.08.2026 ==
* У запланованій схемі комутації в контекстному меню можна додавати кабельні лінії, зокрема з ємністю 12 і 48
* Для типів завдань виділено окреме право "Коментарі"
* Для обладнання можна будувати список залежних абонентів саме за потрібними портами
* Перероблено діалог гарячої заміни дільника: тепер можна вибирати дільник з усіх доступних складів
* У схемі комутації межу робочої області зроблено перетягуваною, що дає змогу швидко змінювати розмір поля схеми комутації
* У схемі комутації додано швидку можливість скомутувати N волокон/портів пристроїв між собою ''(починаючи з поточного, з розривом наявної комутації)''
* Виправлено задвоєння відображення співробітників у списку співробітників підрозділу ''(у деяких випадках)''
* Виправлено відображення записів таблиць відповідно до власного налаштування кожного співробітника щодо кількості записів у таблиці
* Виправлено завантаження списку автовиконавців для завдань ''(у деяких випадках)''
* Виправлення невеликих помилок

== 3.21.39 - 14.08.2026 ==
* Доопрацьовано зовнішній вигляд спливних коментарів у списку завдань
* Виправлено вибір порту обладнання для переключення зайнятого порту
* Виправлення невеликих помилок

== 3.21.38 - 13.08.2026 ==
* Виправлено прикріплення файлів у додаткових полях для нових об'єктів
* Виправлення невеликих помилок

== 3.21.37 - 12.08.2026 ==
* Виправлення невеликих помилок

== 3.21.36 - 09.08.2026 ==
* У запланованій схемі комутації додано функції "пісочниці": можна створювати кабельні лінії та дільники без прив'язки до реальних об'єктів. Можна приховувати наявні об'єкти. Додано додаткові кнопки відображення.
* Додано архів за транспортом
* У ланцюжках дій за типами завдань додано нову дію "Підрозділ. Виключити з усіма його співробітниками"
* У налаштуваннях типів завдань додано властивість "Приховувати робочу нотатку за адресами в цьому типі завдань"

== 3.21.35 - 08.08.2026 ==
* Виправлення невеликих помилок

== 3.21.34 - 07.08.2026 ==
* Для типу споруд зв'язку можна налаштувати поєднання клавіш для швидкого додавання об'єкта такого типу на мапу
* У схемі комутації додано контекстне меню - можливість швидко додати запланований дільник потрібного типу
* Під час натискання правою кнопкою на об'єкт у схемі комутації одразу відкривається його контекстне меню
* Виправлено редагування параметрів CWDM у каталозі товарів
* Виправлено можливість розділення доступних ТМЦ для профілю співробітника з доступом лише до власного підзвіту

== 3.21.33 - 06.08.2026 ==
* У схемі комутації можна розділити екран на дві частини та виводити поточну і заплановану схему. Запланована схема тепер також підтримує можливість змінювати позиції об'єктів, напрямок портів та інше введення кабелів
* У списках об'єктів у групових діях додано можливість масово позначати об'єкти, що розташовані нижче у списку
* Виправлення деяких помилок міграції

== 3.21.32 - 05.08.2026 ==
* Під час додавання кабельної лінії з мапи покриття через кілька проміжних споруд зв'язку додано можливість позначати, на яких саме проміжних спорудах зв'язку потрібно розділити цю лінію і чи потрібно зберегти комутацію між цими сегментами
* Виправлено часткове копіювання інформації у списку пристроїв ''(у деяких випадках)''
* Виправлено помилку під час масового приходу ТМЦ ''(у деяких випадках)''
* Виправлено зазначення кольору для будь-якого порту дільника
* Виправлено виведення інформації про невиконані поточні завдання в картці абонента
* Виправлено роботу селектора вибору співробітника ''(у деяких випадках)''

== 3.21.31 - 02.08.2026 ==
* У глобальній схемі комутації додано можливість друку всієї цієї схеми
* З мапи можна створювати кабельні лінії одразу через усі проміжні споруди зв'язку ''(а не лише від початкового до кінцевого об'єкта)''
* Для SMS-розсилок додано виключення за міткою/значенням додаткового поля на абоненті
* У запланованій схемі комутації додано можливість змінювати маршрут проходження запланованої комутації
* Для міток можна окремо призначати їх застосування до абонентів-юридичних/фізичних осіб та/або потенційних абонентів
* Спливне вікно про вхідний виклик можна виводити зверху/знизу, ліворуч/по центру/праворуч. Можна вказати, щоб воно виводило нотатки за абонентом
* У логічній схемі будівлі можна окремо вказати структуру для кожного під'їзду
* Виправлено фільтрацію за завданнями після виконання групових дій із завданнями
* Виправлено можливість додавання файлів під час зміни статусу завдання
* Виправлено пошук за IP-адресою у списку комутаторів ''(у деяких випадках)''

== 3.21.30 - 31.07.2026 ==
* У картці будівлі можна вказувати довільну нумерацію під'їздів ''(зокрема текстові назви під'їздів)''
* У картці полігона додано посилання на зміну координат
* У списку повідомлень додано можливість фільтрації за наявністю абонента, а також групову дію - призначити/зняти мітку на абонентів із цих повідомлень
* У логічній схемі будівлі додано можливість приховати відображення абонентів і комутацій до них
* У звіті щодо залишків ТМЦ додано можливість фільтрації за найменуванням/категорією ТМЦ
* У картці абонента можна окремо вручну вносити координати в режимі редагування або змінювати їх на мапі
* Для мітки можна призначити права доступу за профілем співробітника
* Виправлено помилку під час перегляду історії за абонентом ''(у деяких випадках)''

== 3.21.29 - 30.07.2026 ==
* У профілях співробітників додано нове право "Управління своїм підзвітом"
* Для кожного типу завдань можна налаштувати, які мітки використовувати в завданнях такого типу
* Для типу завдань можна вибрати категорію абонентів цього типу завдань ''("Юридичні особи", "Фізичні особи")''
* У відомості робіт додано можливість сортування за різними полями
* Виправлено можливість згадувати співробітників у коментарях до завдань
* Виправлено додавання кабельної траси з мапи покриття
* Виправлено помилку під час виключення рівня в логічній схемі будівлі ''(у деяких випадках)''

== 3.21.28 - 29.07.2026 ==
* У списку ТМЦ додано фільтр за значенням додаткового поля
* Кожен співробітник може налаштувати для себе автооновлення головної сторінки
* Виправлення помилки у віджеті головної сторінки "Список завдань на сьогодні"
* Виправлено вибір ТМЦ для додавання в операцію
* Виправлено коректне відкриття картки абонента в логічній схемі будівлі
* Виправлено розрив комутації без перезавантаження сторінки в схемі комутації
* Виправлено селектор вибору адресних об'єктів для співробітників з обмеженими адресними правами

== 3.21.27 - 28.07.2026 ==
* Нове право для профілів співробітників "Склад - Звіти"
* Окремо для кожного типу споруд зв'язку додано можливість вмикати/вимикати виведення його номера/найменування на мапі та шаблон формування номера/найменування
* Новий тип додаткового поля "Крос/ODF"
* У розрахунку маршруту з'єднань додано можливість експортувати результат у KML-файл
* Додано настроювані "Кольорові схеми кабелів". Їх можна довільно використовувати, щоб змінювати розфарбування в кабельних лініях.
* Для кабельної лінії розфарбування провідників можна скопіювати з інших кабельних ліній, які є у спорудах зв'язку, де закінчується ця кабельна лінія.
* Виправлено перехід на картку конкретного ТМЦ за його ID з-під лівого меню
* Виправлено відображення кольору полігона на мапі покриття ''(у деяких випадках)''
* Виправлено відображення багаторядкових написів на мапі покриття
* Виправлено помилку під час відкриття картки стійки/шафи ''(у деяких випадках)''

== 3.21.26 - 27.07.2026 ==
* У режимі планування в схемі комутації додано можливість планувати розрив комутації
* У "Комутатори" додано звіт "Номінальне та SNMP-найменування обладнання"
* Для профілів співробітників можна налаштовувати, у які категорії співробітник має право переміщати ТМЦ
* Право на перегляд списаних ТМЦ окремо винесено для профілів співробітників ''(раніше перегляд і зміна були разом)''
* У ланцюжках завдань/автоматизації додано дію "Абонент. Створення"
* Для портів дільників можна вказувати їхній колір
* У списку ONU за пристроєм фільтр за назвою інтерфейсу дозволяє вибирати одночасно кілька інтерфейсів пристрою
* Під час редагування завдання можна додавати одразу кілька абонентів
* У картці завдання додано можливість створювати копію поточного завдання
* Виправлено вибір обладнання для гарячої заміни пристрою

== 3.21.25 - 25.07.2026 ==
* Якщо під час зміни статусу завдання налаштовано ланцюжок завдань/автоматизацію, ця інформація виводиться у спливній підказці на статусі завдання
* Доопрацьовано обробку номерів телефонів у додаткових полях картки завдання під потрібний формат системи
* У каталозі кабелів для марки кабелю додано параметр "Схема комутації. Колір написів"
* Зміна власних координат абонента фіксується в історії дій
* Виправлено перевірку прав доступу під час перегляду прикріплених файлів за абонентом
* Виправлено надсилання сповіщень співробітникам про недоступність/активність обладнання ''(у деяких випадках)''

== 3.21.24 - 24.07.2026 ==
* Якщо сторінку входу відкриває вже автентифікований користувач, відкривається головна сторінка системи
* У списку ТМЦ можна візуально групувати ТМЦ за найменуванням ''(об'єднувати кілька ТМЦ в одну групу, щоб швидко бачити кількість ТМЦ з таким найменуванням на об'єкті)''
* Доопрацьовано кольорове виділення запланованих кабельних ліній
* Виправлено перевірку доступу до адресних об'єктів ''(у деяких випадках)''

== 3.21.23 - 23.07.2026 ==
* Додано відображення прогресу імпорту споруд зв'язку
* Виправлено збереження chat_id для співробітника ''(у деяких випадках)''
* Виправлено відображення нотаток в історії за абонентом

== 3.21.22 - 22.07.2026 ==
* Написи на мапі виводяться з білим ореолом для кращої читабельності
* Виправлено помилку під час перегляду історії дій співробітника ''(у деяких випадках)''
* Виправлено неможливість виключення пов'язаних об'єктів із завдання ''(у деяких випадках)''
* Виправлено сортування пов'язаних завдань у картці завдання

== 3.21.21 - 21.07.2026 ==
* '''Для глобальної схеми комутації додано можливість експорту в SVG'''
* У картці ТМЦ можна формувати документи за цим ТМЦ
* Виправлено помилку під час відкриття операції за ТМЦ ''(у деяких випадках)''
* Виправлено редагування параметрів доступу для системних пристроїв
* Виправлено комутацію до портів системних пристроїв
* Виправлено відображення списку інтерфейсів/стекування за пристроєм ''(у деяких випадках)''
* Виправлено видалення поверху у структурі будівлі

== 3.21.20 - 20.07.2026 ==
* У діалоговому вікні призначення адресного доступу для співробітника додано пошук за адресним об'єктом
* Додано кнопки швидкого очищення нотаток на портах ODF/кроса у схемі комутації
* Виправлення невеликих помилок

== 3.21.19 - 18.07.2026 ==
* Для типів споруд зв'язку додано властивість "Дозволити збіг номерів об'єктів для різних населених пунктів"
* Для типів адресних одиниць додано налаштування, у яких батьківських адресних одиницях їх можна додавати ''(наприклад, "вулиці" тільки в "містах" тощо)''
* Для типів адресних об'єктів можна налаштувати доступ до редагування таких об'єктів за профілями співробітників
* Доопрацьовано відображення завжди повних ПІБ у списку співробітників
* Виправлено операції з мультиплексорами на схемі комутації
* Виправлено відображення нового доданого типу кабельної лінії в лівому меню

== 3.21.18 - 17.07.2026 ==
* Значки абонентів на мапі покриття виводяться з кольором контуру відповідно до кольору мітки на цьому абоненті
* У списку завдань додано фільтр за значенням додаткового поля на адресі завдання
* Виправлення невеликих помилок

== 3.21.17 - 16.07.2026 ==
* '''Обладнання можна встановлювати на будівлі ''(раніше тільки на споруді зв'язку або на абоненті)'''''
* '''Кабельна лінія тепер може починатися на абоненті або на будівлі ''(раніше тільки на споруді зв'язку)'''''
* У список абонентів додано поле "Загальна абонплата" з можливістю фільтрації за ним
* Виправлено помилку під час перегляду історії комутації за волокном кабельної лінії ''(у деяких випадках)''
* Виправлено збереження вибраної групи типів для властивостей типу споруди зв'язку
* Виправлено пошук за маркою кабелю під час додавання кабельної лінії ''(у деяких випадках)''

== 3.21.16 - 15.07.2026 ==
* '''ODF/кроси та дільники можна встановлювати в абонентів або на будівлях'''
* У списку ONU за OLT у фільтрації за інтерфейсом додано селектор наявних PON-інтерфейсів OLT
* Виправлено роботу операцій у запланованій схемі комутації
* Виправлено сортування персоналу в підрозділі у списку підрозділів
* Виправлено додавання ТМЦ із зазначенням IP/MAC-адреси
* Виправлено відображення історії за волокнами кабельних ліній

== 3.21.15 - 14.07.2026 ==
* Для типу завдань можна вказувати, що це завдання тільки для абонентів певних груп
* Додано можливість надсилати повідомлення всім співробітникам компанії з можливістю вказати дату видалення ''(за потреби)''
* Виправлено зовнішній вигляд картки підрозділу під час редагування
* Виправлено перебудову дочірніх схем під час перетягування схеми комутації на глобальній схемі
* Виправлено роботу параметра "Під час зміни полігона будівлі виводити на мапі й інші об'єкти" ''(у деяких випадках)''
* Виправлено неможливість вибрати будівлю під час створення нового завдання

== 3.21.14 - 13.07.2026 ==
* '''Додано можливість прив'язувати ТМЦ до завдання ''(як обладнання, абонент тощо)''. Без передачі ТМЦ на саме завдання. Для обліку виконання завдань, пов'язаних із ТМЦ.'''
* У звітах за ТМЦ додано новий звіт "Рух ТМЦ"
* У списку будинків додано фільтрацію за наявністю/відсутністю споруди зв'язку на будинку
* Додано нове право для профілів співробітників: "Налаштування - Статуси завдань"
* У календарі робіт додано фільтри для налаштування власного порядку/наявності підрозділів і співробітників у календарі
* Перероблено розділ зі списком підрозділів. Змінено зовнішній вигляд, додано швидкий пошук за співробітником/підрозділом
* Під час створення нового будинку в блоці вибору адреси нова адреса одразу підставляється без перезавантаження поточної сторінки
* Під час пошуку в блоці вибору адреси в результатах виводяться не лише будинки, а й інші типи адресних об'єктів, що дозволяє також швидко додавати нові будинки, вулиці тощо
* Доопрацьовано зовнішній вигляд картки завдання для мобільних пристроїв
* Виправлено швидкість роботи карти покриття під час відображення шару "Співробітники та автотранспорт"
* Виправлено фільтрацію у списку будинків ''(у деяких випадках)''
* Виправлено перегляд PDF-файлів у браузері ''(у деяких випадках)''
* Виправлено фільтрацію списку абонентів-боржників
* Виправлено відображення розділу "Налаштування-Адреси" для співробітників з обмеженим доступом за географією
* Виправлено відображення волокон на схемі комутації за наявності мітки на волокні
* Виправлено помилку під час відображення завдань поточного дня в календарі робіт ''(у деяких випадках)''

== 3.21.13 - 10.07.2026 ==
* '''Під час приходу ТМЦ тепер можна одразу вказувати кілька різних найменувань ТМЦ'''
* Доопрацювання у відображенні виконаних завдань у календарі
* У схемі комутації для дільників і ODF/кросів у меню об'єктів додано кнопки дій, як і в картках цих об'єктів ''(редагування, видалення, структурна схема тощо)''
* Виправлено комутацію у схемі комутації ''(у деяких випадках)''
* Виправлено дублювання запитів під час автооновлення рівня сигналу на ONU під час відкриття її картки
* Виправлено зовнішній вигляд відображення історії за завданням
* Виправлено редагування налаштувань карти покриття ''(у деяких випадках)''
* Виправлено вибір об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено перевірку прав доступу до списку ONU для співробітників
* Виправлено зовнішній вигляд картки стійки/шафи в темній схемі інтерфейсу

== 3.21.12 - 09.07.2026 ==
* Доопрацьовано метод API->[[API_redirect_UK|redirect]]
* Під час розділення ТМЦ на кілька частин за наявності прикріплених файлів вони закріплюються за всіма ТМЦ
* Доопрацьовано діалог додавання кабельної лінії з-під споруди зв'язку
* Додано параметр налаштування "Відображати виконані завдання з прозорістю (%)"
* Виправлено роботу параметра налаштування "Відображати виконані завдання сірим кольором"
* Виправлено виведення поля для зазначення MAC-адреси під час приходу ТМЦ
* Виправлено роботу залежностей додаткових полів
* Виправлено роботу з прикріпленими файлами в операціях з автотранспортом
* Виправлено перехід до налаштування полів таблиці споруд зв'язку
* Виправлено зовнішній вигляд інформації за завданнями у вкладці "Тех. підтримка" у картці абонента
* Виправлено помилки під час перегляду історії дій користувачів ''(у деяких випадках)''
* Виправлено помилку під час відкриття діалогового вікна вибору ТМЦ для інтеграції
* Виправлено переміщення позицій об'єктів на глобальній схемі комутації
* Виправлено зазначення резервів для кабельних ліній
* Виправлено помилку під час приходу ТМЦ та автопризначення інвентарних номерів ''(у деяких випадках)''
* Виправлено налаштування доступу до адрес для співробітників

== 3.21.11 - 08.07.2026 ==
* Виправлено зовнішній вигляд налаштування таблиці прав для типів завдань
* Виправлено зміну позиції окремої схеми комутації споруди зв'язку на загальній глобальній схемі комутації
* Виправлено фільтрацію завдань у розділі "Мої завдання" ''(у деяких випадках)''
* Виправлено зміну координат адресного об'єкта з-під картки будинку
* Виправлено сортування виконавців під час створення завдання
* Виправлено зміну координат сектора для радіообладнання
* Виправлено перевірку прав доступу під час відкриття картки пристрою ''(у деяких випадках)''
* Виправлено приховування/відображення споруди зв'язку на карті покриття

== 3.21.10 - 07.07.2026 ==
* Додано метод API->call->[[API_call_UK#edit|edit]]
* Додано нові права для профілів користувачів "Власники (доступ до фінансової інформації)" та "Орендарі (доступ до фінансової інформації)"
* '''Реалізовано передачу ТМЦ співробітнику з підтвердженням отримання/відмови від отримання співробітником'''
* У групових діях за спорудами зв'язку створення спільного завдання/окремих завдань реалізовано через стандартний діалог додавання завдання
* Виправлено позначення завдання як прочитаного в новинах під час відкриття картки завдання
* Виправлено відображення дати останньої операції за ТМЦ у списку ТМЦ за об'єктом
* Виправлено генерацію документа на друк з-під картки завдання
* Виправлено комутацію вільних волокон кабелів між собою ''(у деяких випадках)''
* Виправлено редагування координат у лінії зв'язку
* Виправлено виведення сторонніх артефактів у глобальній схемі комутації ''(у деяких випадках)''
== 3.21.9 - 06.07.2026 ==
* У виключення для SMS-розсилок додано можливість виключати абонентів із певним періодом від'ємного балансу
* У статистиці "Проблемні будинки/абоненти" додано можливість налаштовувати власні фільтри
* У налаштуваннях типу завдань у секції додаткових полів окремо вказуються типи додаткових полів, які можна використовувати під час зміни статусу завдань. А в налаштуваннях статусів завдань додано властивість "Вивести додаткові поля"
* Додано можливість автоматично створювати завдання на роботу для невідповіджених телефонних викликів
* Зміну пароля користувача винесено в окреме діалогове вікно

== 3.21.8 - 04.07.2026 ==
* Доопрацьовано метод API->customer->[[API_customer_UK#get_customers_id|get_customers_id]]
* Доробки зовнішнього вигляду завдань у календарі робіт
* У групових діях за абонентами: створення завдань тепер використовує повноцінний діалог зазначення властивостей для створюваних завдань
* Оптимізація структурної схеми
* Виправлено помилку під час встановлення умов у SMS-розсилці ''(у деяких випадках)''
* Виправлено зазначення власних координат для абонента
* Виправлено помилку під час збереження системного пристрою
* Виправлено виведення об'єктів на глобальній схемі комутації ''(у деяких випадках)''
* Виправлено комутацію кабельної лінії до пристрою у схемі комутації абонента
* Виправлено зміну довільних координат для обладнання
* Виправлено роботу фільтра за виключенням тарифу в SMS-розсилці

== 3.21.7 - 03.07.2026 ==
* Режим планування в календарі робіт
* Виправлено пошук у списку споруд зв'язку ''(у деяких випадках)''
* Виправлено відображення прикріплених файлів у картці споруди зв'язку за наявності прав лише на читання
* Виправлено перегляд/формування SMS-розсилок ''(у деяких випадках)''
* Виправлено відображення рівнів сигналів для ONU ''(у деяких випадках)''
* Виправлено відображення затухань на структурній схемі для OLT ''(у деяких випадках)''
* Виправлено помилку під час перегляду історії за співробітниками ''(у деяких випадках)''
* Виправлено неправильне виведення дати активності у спливній підказці на мапі покриття за автотранспортом
* Виправлено можливість виключення абонента із завдання

== 3.21.6 - 02.07.2026 ==
* Додано історію використання IP-адрес
* Доопрацьовано використання лінійки на мапі покриття
* Виправлено зовнішній вигляд кабельних ліній на мапі покриття залежно від налаштувань міток ''(у деяких випадках)''
* Виправлено список обладнання у віджеті головної сторінки "Неактивні комутатори"
* Виправлено додавання нових схем споруд зв'язку на глобальну схему комутації
* Виправлено пошук за базою обладнання під час додавання найменування ТМЦ у каталозі товарів
* Виправлено очищення комутації портів обладнання ''(у деяких випадках)''
* Виправлено помилку у звіті щодо залишків ТМЦ ''(у деяких випадках)''
* Виправлено зазначення довільних запасів/об'єктів на маршруті кабельної лінії
* Виправлено перемикання комутації в порт іншого пристрою на споруді зв'язку
* Виправлено відображення об'єктів на мапі покриття у групових операціях за спорудами зв'язку
* Виправлено зміну шляху комутації у схемі комутації ''(у деяких випадках)''

== 3.21.5 - 01.07.2026 ==
* Додано сповіщення під час редагування завдання ''(налаштовується)''
* Доробка зі знімання інформації за інтерфейсами ONU
* Доопрацьовано зовнішній вигляд портів обладнання для темної схеми
* Для типів завдань додано можливість вказати дії з ТМЦ: передавати з абонента на вибраний склад потрібні ТМЦ, що знаходяться в абонента
* Виправлено швидкий пошук обладнання потрібної категорії у списку обладнання
* Виправлено вибір інших пристроїв на цій споруді зв'язку в діалоговому вікні перемикання порту
* Виправлено відображення доступних складів для співробітника ''(у деяких випадках)''
* Виправлено помилку під час перегляду картки ТМЦ ''(у деяких випадках)''
* Виправлено автовибір будинку під час додавання споруди зв'язку з картки будинку
* Виправлено перегляд списку опитуваних пристроїв у модулі usm_observer
* Виправлено можливість зміни кольору з'єднання між пристроями у схемі комутації

== 3.21.4 - 30.06.2026 ==
* Доопрацьовано метод API->attach->[[API_attach_UK#upload|upload]]
* Додано окремий профіль email-сповіщень для надсилання повідомлень абонентам-юридичним особам
* Доопрацьовано сортування у списку споруд зв'язку за будинком
* Календар робіт відкривається на поточній даті
* Доробка календаря завдань для випадків, коли кілька завдань призначаються на один час
* Впроваджено багаторівневі групи типів завдань
* У новинах за завданнями додано можливість частково позначати події як прочитані, а також групувати новини за завданнями
* В автоматизації за завданнями додано можливість надсилати Email абонентам ''(за налаштовуваними шаблонами)''
* Доопрацьовано виведення спливного сповіщення під час призначення підрозділу співробітника на завдання
* Виправлено відображення блока з прикріпленими файлами у власних розділах за права лише на читання
* Виправлено перехід у картку абонента з мапи покриття
* Виправлено помилку під час налаштування доступності статусів для профілів співробітників у картці типу завдання
* Виправлено фільтрацію за датами у списку завдань ''(у деяких випадках)''
* Виправлено відображення автора завдання у списку завдань
* Виправлено відображення поля "Нотатки" у картці споруди зв'язку
* Виправлено помилку під час спроби видалення адресного об'єкта ''(у деяких випадках)''
* Виправлено можливість вимкнення/увімкнення порту пристрою
* Виправлено перегляд глобальних схем комутації ''(у деяких випадках)''

== 3.21.3 - 28.06.2026 ==
* Доопрацьовано метод API->inventory->[[API_inventory_UK#transfer_inventory|transfer_inventory]]
* Доопрацьовано метод API->commutation->[[API_commutation_UK#delete|commutation]]
* Доопрацьовано метод API->node->[[API_node_UK#get|get]]
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Для завдання планувальника "Розсилання інформації про зниження резервів на складі" додано можливість указувати варіанти надсилання "E-mail/Messenger", а також у картці співробітника в розділі "Сповіщення" можна вказати варіанти отримання цієї розсилки
* У списку ТМЦ у картці завдання додано можливість одразу передавати всі ТМЦ вибраному отримувачу
* У додаткових полях із типом "Вибір зі списку" додано швидкий пошук значення
* Доопрацьовано використання явно вказаних координат під час редагування картки будівлі та вибору полігона/точки
* Виправлено створення кабельних ліній до будівлі з мапи покриття
* Виправлено помилку під час переходу до розділу Налаштування - Модулі ''(у деяких випадках)''
* Виправлено групування у списку завдань ''(у деяких випадках)''
* Виправлено видалення напису зі схеми комутації
* Виправлено роботу параметра "Відображати у селекторах/пошуку звільнених співробітників протягом N днів після їх звільнення"
* Виправлено перевірку доступності складів під час вибору ТМЦ при виконанні завдання
* Виправлено роботу змінної "Виводити завдання за датою фактичного виконання"
* Виправлено використання колірних налаштувань зовнішнього вигляду типів завдань у календарі
* Виправлено пошук на мапі покриття ''(підставляння поточного населеного пункту у вікні пошуку)''
* Виправлено перехід із картки клієнта на мапу з координатами будівлі клієнта
* Виправлено збереження інтерфейсів/стекування в картці пристрою

== 3.21.2 - 26.06.2026 ==
* Доопрацьовано метод API->address->[[API_address_UK#get_house|get_house]]
* Під час передавання ТМЦ із картки клієнта можна вибрати субрахунок, на який передаємо
* Під час створення/зміни завдання для будівлі виводиться інформація про мітки на будівлі та примітку до будівлі
* Під час створення завдання за ланцюжком можна окремо вказати потрібного довільного виконавця/підрозділ
* У масовому передаванні ТМЦ тепер створюються об'єднані операції передавання, а не кожна окремо
* У списку завдань у групуванні результатів фільтрації додано варіант "Дата виконання (місяць)"
* Виправлено помилку під час створення завдання ''(у деяких випадках)''
* Виправлено зміну координат у картці будівлі, споруди зв'язку, клієнта ''(у деяких випадках)''
* Виправлено формування назви споруди зв'язку під час вибору поверху будівлі ''(у деяких випадках)''
* Виправлено обробку посилань у текстових значеннях додаткових полів
* Виправлено призначення виконавців під час створення завдання ''(у деяких випадках)''

== 3.21.1 - 25.06.2026 ==
* Доопрацьовано центрування мапи під час редагування полігона/будівлі на мапі покриття
* Виправлено відображення глобальних схем комутації ''(у деяких випадках)''
* Виправлено експорт у XLS списку кабельних ліній ''(у деяких випадках)''
* Виправлено коректне відображення клієнтів на логічній схемі будівлі ''(у деяких випадках)''
* Виправлено вибір батьківських об'єктів під час додавання будівлі з мапи покриття
* Виправлено прикріплення клієнта під час додавання нового завдання для клієнта
* Виправлення невеликих помилок

== 3.21.0 - 23.06.2026 ==
* Реліз версії

== 3.21.0-beta.7 - 21.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.6 - 20.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.5 - 17.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.4 - 13.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.3 - 07.06.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.2 - 30.05.2026 ==
* Виправлення за підсумками бета-тестування

== 3.21.0-beta.1 - 24.05.2026 ==
* Перелік змін див. у [[3.21_UK|3.21]]