OMOBUS Long-Time-Storage (LTS) database

В данном проекте описываются механизмы интеграции и структуры входящих/исходящих потоков данных, передаваемых между сервером OMOBUS и источником данных, в качестве которого выступает аналитическое (далее по тексту - LTS) хранилище данных OMOBUS, предназначенное для использования в системах принятия решений (Decision Support Systems - DSS). Обратите внимание на то, что LTS хранилище позволяет агрегировать данные с нескольких серверов OMOBUS.

Также в проекте приводится эталонная реализация схемы базы данных и процедур ее заполнения для СУБД PostgreSQL 9.4 и выше и/или Microsoft SQL 2005 и выше. На основе предлагаемых SQL скриптов, возможно создание LTS хранилищ на базе любых реляционных СУБД.

Варианты размещения LTS базы данных OMOBUS

ВНИМАНИЕ! Во всех приведенных вариантах размещения LTS базы данных, наполнение хранилища данными выполняется с помощью специализированного програмного обеспечения OMOBUS, которое выполняет передачу только данных, изменившихся с момента предыдущей успешной передачи данных.

База данных в зоне ответственности заказчика под управлением СУБД Microsoft SQL Server или PostgreSQL

В данном случае, заказчик предоставляет удаленный доступ (вариант 1) к серверу базы данных по протоколу TCP/IP с доступом к нему через сеть Internet, или же, в локальной сети заказчика размещается специализированная версия серверного программного обеспечения OMOBUS (вариант 2), которое осуществляет доступ к базе данных и выполняет обмен с сервером OMOBUS. Набор таблиц базы данных соответствует описываемым в данном документе потокам данных.

Пример создание базы omobus-lts-db в СУБД Microsoft SQL Server с помощью утилит, входящих в комплект библиотеки FreeTDS:

$ fisql -I freetds.conf -S srv1 -U sa -P pwd -i omobus-lts-db.sql
$ fisql -I freetds.conf -S srv1 -U omobus -P 0 -D omobus-lts-db -i version.sql

В ходе выполнения будет создан пользователь с именем omobus и паролем 0. Не забудьте изменить пароль, использованный по-умолчанию!

База данных в зоне ответственности OMOBUS под управлением СУБД PostgreSQL

В данном случае, заказчику предоставляется удаленный доступ к серверу базы данных по протоколу TCP/IP с доступом к нему через сеть Internet, находящемуся в зоне ответственности системы OMOBUS. Набор таблиц базы данных соответствует описываемым в данном документе потокам данных.

Типы данных

Допустимо использование следующих типов данных:

address_t = VARCHAR(256) - Строка длиной до 256 символов.
blob_t = VARCHAR(256) - Строка длиной до 256 символов, представляющая собой имя ссылки на двоичный объект (файл), который расположен в том же месте, что и поток, содержащий данное поле. Двоичный объект должен иметь расширение «.blob».
bool_t = INT2 - Целое число размером 1 или 2 байта (может принимать значение 0 или 1).
code_t = VARCHAR(24) - Строка длиной до 24 символов.
codes_t = VARCHAR(24) ARRAY - Строковое представление массива элементов типа code_t. В качестве разделителя между элементами выступает символ ‘,’.
color_t = INT4 - Цвет в кодировке RGB (десятичная запись).
country_t = VARCHAR(2) - Код страны в формате ISO:3166-1 alpha-2.
countries_t = VARCHAR(2) ARRAY - Строковое представление массива элементов типа country_t. В качестве разделителя между элементами выступает символ ‘,’.
currency_t = NUMERIC(18,4) - Число с дробной частью. В качестве десятичного разделителя используется точка. Разделитель групп разрядов не используется.
date_t = VARCHAR(10) - Строка длиной 10 символов, содержащая дату в формате ISO:8601.
datetime_t = VARCHAR(19) - Строка длиной 19 символов, содержащая дату и время в формате ISO:8601, с пробелом в качестве разделителя даты и времени.
datetimetz_t = VARCHAR(32) - Строковое представление даты в формате ISO:8601, с пробелом в качестве разделителя даты и времени, с указанием часового пояса в виде смещения относительно UTC в часах и минутах.
descr_t = VARCHAR(256) - Строка длиной до 256 символов.
doctype_t = VARCHAR(24) - Тип документа.
double_t = FLOAT8 - Число с плавающей точкой.
ean13_t = EAN13 - Строковое представление штрихкода в формате EAN13.
ean13s_t = EAN13 ARRAY - Строковое представление штрихкодов в формате EAN13. В качестве разделителя между элементами выступает символ ‘,’.
email_t = VARCHAR(254) - Строковое представление адреса электронной почты.
hstore_t = VARCHAR(4096) - Хранилище вида “ключ”=>“значение” с разделителем параметров в виде ‘,’. При этом, в том случае, если ключ или значение содержит ["], данный символ должен заменяться на [\"].
gps_t = NUMERIC(10,6) - Географические координаты.
int32_t = INT4 - Целое число размером 4 байта.
int64_t = INT8 - Целое число размером 8 байта.
note_t = VARCHAR(1024) - Строка длиной до 1024 символов.
numeric_t = NUMERIC(16,4) - Число с дробной частью. В качестве десятичного разделителя используется точка. Разделитель групп разрядов не используется.
phone_t = VARCHAR(32) - Номер телефона.
uid_t = VARCHAR(48) - Строка длиной до 48 символов. Допускается использование только: (1) десятичных цифр от 0 до 9; (2) букв латинского алфавита; (3) букв кириллического алфавита; (4) пробела; (5) символов -. _ / : ( ).
uids_t = VARCHAR(48) ARRAY - Строковое представление массива элементов типа uid_t. В качестве разделителя между элементами выступает символ ‘,’.
wf_t = NUMERIC(3,2) - Число с дробной частью. В качестве десятичного разделителя используется точка. Разделитель групп разрядов не используется.

Справочные данные

Система OMOBUS разработана таким образом, что не накладывает никакие искусственных ограничения на ссылочную целостность исходных справочных данных, загружаемых в систему из различных источников данных (КИС производителя и/или дистрибуторов и т.д.). Проверка ссылочной целостности и автоматическое разрешение конфликтов производится только в момент подготовки данных, используемых при работе мобильного терминала OMOBUS. Исходя из этого, в системе хранения OMOBUS могут в любой момент времени находится ссылочно не целостные данные, полученные из внешних источников. В LTS хранилище данные передаются в том виде, в котором они хранятся в системе OMOBUS т. е. возможно несоблюдение ссылочной целостности в справочных данных, описываемых в данном разделе.

accounts

Клиенты. В качестве клиентов могут выступать любые физические объекты, в которых возможен ввод данных или выполнение каких либо активностей, например, торговые точки, аптеки, медицинские учреждения и т.п. Данный справочник формируется на основе данных, загруженных в OMOBUS, и данных, которые собраны сотрудниками с помощью мобильного терминала OMOBUS.

	Код	Тип	Ссылка	Описание
PK	account_id	uid_t		ID клиента.
	pid	uid_t	accounts	ID родительского элемента.
	code	code_t		Код клиента.
M	ftype	ftype_t		Элемент является папкой (1) или клиентом (0).
M	descr	descr_t		Название клиента.
M	address	address_t		Адрес клиента.
	region_id	uid_t	regions	ID региона.
	city_id	uid_t	cities	ID города.
	rc_id	uid_t	retail_chains	ID торговой сети.
	chan_id	uid_t	channels	ID канала рынка.
	poten_id	uid_t	potentials	ID категории клиента.
	latitude	gps_t		Географическое положение клиента (широта) в градусах (десятичная запись).
	longitude	gps_t		Географическое положение клиента (долгота) в градусах (десятичная запись).
	phone	phone_t		Номер городского телефона.
	workplaces	int32_t		Количество рабочих мест у клиента (например, количество касс в т/точке, количество кресел в стоматологической клинике и т.п.).
	team	int32_t		Количество сотрудников.
	interaction_type_id	uid_t	interaction_types	ID разрешенной формы взаимодействия.
	attr_ids	uids_t	attributes	Дополнительные параметры клиента.
	extra_info	note_t		Дополнительная информация, связанная с клиентом.
	locked	bool_t		Клиент заблокирован (0 или 1) по причине подачи заявки на удаление клиента.
	approved	bool_t		Клиент «подтвержден» (0 или 1).
	props	hstore_t		Дополнительные параметры.
M	hidden	bool_t		Клиент удален (выведен из активной клиентской базы - АКБ).

Реквизит cities используется для определения связи клиента с административно-территориальным устройством страныю

Клиент считается подтвержденным (approved=1) в том случае, если он получен из подключенной к OMOBUS КИС. Данный флаг актуален для тех случаев, когда сотрудникам разрешено регистрировать новых клиентов с помощью мобильного устройства. Данный параметр равен 0 для зарегистрированных новых клиентов до тех пор, пока он не будет зарегистрирован в КИС и выгружен в OMOBUS.

activity_types

Виды активностей. Данный справочник формируется непосредственно в системе OMOBUS. Изменение в его состава может вносится без предварительного уведомления.

	Код	Тип	Описание
PK	activity_type_id	uid_t	ID вида активности.
M	descr	descr_t	Название вида активности.
M	strict	bool_t	Вид активности выполняется строго при физическом посещение клиента (0 или 1).
M	joint	bool_t	Вид активности представляет собой совместное посещение клиента (0 или 1).
M	hidden	bool_t	Данные удалены.

addition_types

Типы новых клиентов.

	Код	Тип	Описание
PK	addition_type_id	uid_t	ID типа нового клиента.
M	descr	descr_t	Название типа нового клиента.
M	hidden	bool_t	Данные удалены.

agencies

Список агентств, в которых трудоустроены сотрудники.

	Код	Тип	Описание
PK	agency_id	uid_t	ID агентства.
M	descr	descr_t	Название агентства.
M	hidden	bool_t	Данные удалены.

agreements1

Договоренности на размещение рекламных материалов в торговом зале клиента. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных ().
PK	account_id	uid_t	accounts	ID клиента.
PK	placement_id	uid_t	placements	ID места размещения.
PK	posm_id	uid_t	pos_materials	ID PoS/PoP материала.
	cookie	uid_t		Метка для взаимосвязи аналогичных PoS/PoP материалов.

ВНИМАНИЕ! Данные актуальны только для активностей, выполненных в дату указанную в реквизите slice_date.

Реквизит cookie используемая для определения случаев, когда размещение одного PoS/PoP материала может покрывать недостаточное размещение другого.

agreements2

Договоренности на размещение продукции на полке. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
	facing	int32_t		Минимальное количества продукции размещенной лицевой стороной к покупателю.
	cookie	uid_t		Метка для взаимосвязи продуктов.

ВНИМАНИЕ! Данные актуальны только для активностей, выполненных в дату указанную в реквизите slice_date.

Реквизит cookie используемая для определения случаев, когда размещение одного продукта может покрывать недостаточное размещение другого.

agreements3

Договоренности по минимальному остатку продукции на складе клиента. Данные переданные в рамках данного потока никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	stock	int32_t		Минимальный остаток продукции на складе клиента.
	cookie	uid_t		Метка для взаимосвязи продуктов.

ВНИМАНИЕ! Данные актуальны только для активностей, выполненных в дату указанную в реквизите slice_date.

Реквизит cookie используется для определения случаев, когда остаток одного продукта может покрывать недостаточный остаток другого.

agreements4

Договоренности по проведению ценового промо у клиента. Данные переданные в рамках данного потока никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	descr	descr_t		Название ценового промо.
M	b_date	date_t		Дата начала ценового промо.
M	e_date	date_t		Дата окончания ценового промо.
	extra_info	note_t		Дополнительная информация, связанная с ценовым промо.

ВНИМАНИЕ! Данные актуальны только для активностей, выполненных в дату указанную в реквизите slice_date.

asp_types

Типы дополнительных мест продаж (ДМП — Additional-Sales-Place).

	Код	Тип	Описание
PK	asp_type_id	uid_t	ID типа ДМП.
M	descr	descr_t	Название типа доставки.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

attributes

Дополнительные параметры клиента.

	Код	Тип	Описание
PK	attr_id	uid_t	ID дополнительного параметра.
M	descr	descr_t	Название дополнительного параметра.
M	hidden	bool_t	Данные удалены.

audit_criterias

Критерии аудита (SLA — Service-Level-Agreement) результатов размещения продукции в торговом зале.

	Код	Тип	Описание
PK	audit_criteria_id	uid_t	ID критерия аудита.
M	descr	descr_t	Название критерия.
	row_no	int32_t	Порядок сортировки (приоритета).
M	hidden	bool_t	Данные удалены.

audit_scores

Список возможных баллов оценки при проведение аудита результатов размещения продукции в торговом зале.

	Код	Тип	Описание
PK	audit_score_id	uid_t	ID оценки.
M	descr	descr_t	Полное наименование балла.
M	score	int32_t	Значение балла.
M	hidden	bool_t	Данные удалены.

brands

Бренды.

	Код	Тип	Ссылка	Описание
PK	brand_id	uid_t		ID бренда.
M	descr	descr_t		Название бренда.
M	manuf_id	uid_t	manufacturers	ID производителя.
M	hidden	bool_t		Данные удалены.

canceling_types

Причины отмены рабочего дня.

	Код	Тип	Описание
PK	canceling_type_id	uid_t	ID агентства.
M	descr	descr_t	Название причины отмены рабочего дня.
M	hidden	bool_t	Данные удалены.

	Код	Тип	Описание
PK	categ_id	uid_t	ID категории размещения продуктов.
M	descr	descr_t	Название категории размещения.
M	hidden	bool_t	Данные удалены.

channels

Каналы рынка.

	Код	Тип	Описание
PK	chan_id	uid_t	ID канала рынка.
M	descr	descr_t	Название канала рынка.
M	hidden	bool_t	Данные удалены.

cities

Описание административно-территориального устройства страны. Данные организованы в виде линейной иерархии, начиная с самой крупной административно-территориальной единицы страны, и заканчивая нанесенным пунктом.

	Код	Тип	Ссылка	Описание
PK	city_id	uid_t		ID города (населенного пункта) или административно-территориального образования.
	pid	uid_t		ID родительского элемента.
M	ftype	bool_t		Элемент является населенным пунктом (0) или административно-территориальным образованием (1).
M	descr	descr_t		Название города.
M	country_id	country_t	countries	ID страны.
	hidden	bool_t		Данные удалены.

cohorts

Категории контактов.

	Код	Тип	Описание
PK	cohort_id	uid_t	ID категории контакта.
M	descr	descr_t	Название категории контакта.
M	hidden	bool_t	Данные удалены.

comment_types

Виды комментариев.

	Код	Тип	Описание
PK	comment_type_id	uid_t	ID вида комментария.
M	descr	descr_t	Название вида комментария.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

confirmation_types

Типы подтверждения выполнения задачи.

	Код	Тип	Описание
PK	confirmation_type__id	uid_t	ID подтверждения.
M	descr	descr_t	Название подтверждения.
	succeeded	varchar(6)	Задача успешно выполнена. Возможные значения: `yes`, `no`, `partly`.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

countries

Страны.

	Код	Тип	Описание
PK	country_id	country_t	ID страны ы формате ISO 3166-1 alpha-2.
M	descr	descr_t	Название страны.
M	hidden	bool_t	Данные удалены.

delivery_types

Типы доставки продукции.

	Код	Тип	Описание
PK	delivery_type_id	uid_t	ID типа доставки продукции.
M	descr	descr_t	Название типа доставки.
M	hidden	bool_t	Данные удалены.

departments

Подразделения, в которых работают сотрудники. Данный справочник используется для разделения отображаемых продуктов между разными сотрудниками. Например, подразделение MASS работает с продукцией массового спроса (торговые представители), подразделение OTC — с нерецептурными фармакологическими препаратами, подразделение PHARMA — с рецептурными фармакологическими препаратами.

	Код	Тип	Описание
PK	dep_id	uid_t	ID подразделения.
M	descr	descr_t	Название подразделения.
M	hidden	bool_t	Данные удалены.

discard_types

Причины исключения клиента из маршрута.

	Код	Тип	Описание
PK	discard_type_id	uid_t	ID причины исключения из маршрута.
M	descr	descr_t	Название причины исключения из маршрута.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

distributors

Дистрибьюторы. В данном потоке перечисляются все организационные единицы (центральный офис, филиалы, дистрибьюторы, распределительные центы сетей и т. д.), через которые возможна отгрузка продукции клиентам.

	Код	Тип	Ссылка	Описание
PK	distr_id	uid_t		ID дистрибутора.
M	descr	descr_t		Название причины исключения из маршрута.
M	country_id	country_t	countries	ID страны, в которой действует дистрибьютор.
M	hidden	bool_t		Данные удалены.

equipment_conditions

Состояние торгового оборудования (например, Оборудование доступно покупателю, Оборудование требует ремонта и т.п.).

	Код	Тип	Описание
PK	equipment_type_id	uid_t	ID состояния т/оборудования.
M	descr	descr_t	Название состояния т/оборудования.
M	hidden	bool_t	Данные удалены.

equipment_types

Виды торгового оборудования.

	Код	Тип	Описание
PK	equipment_type_id	uid_t	ID вида т/оборудования.
M	descr	descr_t	Название вида т/оборудования.
M	hidden	bool_t	Данные удалены.

fault_types

Виды проблем размещения продукции в торговом зале.

	Код	Тип	Описание
PK	fault_type_id	uid_t	ID вида проблемы размещения.
M	descr	descr_t	Название вида проблемы размещения.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

holidays

Государственные праздники, отменяющие рабочие дни. В данном потоке перечисленны только те дни, которые фактически отменяются. Переносы рабочих дней не включаются в данный поток, т.к. они автоматически учитываются в маршрутах.

	Код	Тип	Ссылка	Описание
PK	h_date	date_t		Дата отменяемого рабочего дня.
PK	country_id	uid_t	countries	ID страны, в которой действует данная отмена рабочего дня.
	note	note_t		Описание причины отмены рабочего дня.
M	hidden	bool_t		Данные удалены.

influence_levels

Уровни влияния контактов.

	Код	Тип	Описание
PK	influence_level_id	uid_t	ID уровня влияния.
M	descr	descr_t	Название уровня влияния.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

intensity_levels

Интенсивность работы контактов.

	Код	Тип	Описание
PK	intensity_level_id	uid_t	ID уровня интенсивности работы.
M	descr	descr_t	Название уровня интенсивности работы.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

interaction_types

Разрешенные формы взаимодействия (работы) сотрудников на территории клиента.

	Код	Тип	Описание
PK	interaction_type_id	uid_t	ID разрешенной формы взаимодействия.
M	descr	descr_t	Название разрешенной формы взаимодействия.
M	hidden	bool_t	Данные удалены.

job_titles

Должности сотрудников клиента (контактов).

	Код	Тип	Описание
PK	job_title_id	uid_t	ID должности.
M	descr	descr_t	Название должности.
M	hidden	bool_t	Данные удалены.

kindes

Виды (группы) продуктов.

	Код	Тип	Описание
PK	kind_id	uid_t	ID вида (группы) продукта.
M	descr	descr_t	Название продуктовой группы.
M	hidden	bool_t	Данные удалены.

loyalty_levels

Уровни лояльности контактов.

	Код	Тип	Описание
PK	loyalty_level_id	uid_t	ID уровня лояльности контакта.
M	descr	descr_t	Название уровня лояльности контакта.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

manufacturers

Производители, в том числе и конкуренты.

	Код	Тип	Описание
PK	manuf_id	uid_t	ID производителя.
M	descr	descr_t	Название производителя.
	competitor	bool_t	Конкурент (0 или 1).
M	hidden	bool_t	Данные удалены.

matrices

Предписанные для клиента матрицы продуктов. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных (данные актуальны только для активностей, выполненных в указанную дату).
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
	row_no	int32_t		Порядок сортировки (приоритета) продуктов в матрице.
	props	hstore_t		Дополнительные параметры.

mileages

Пробег сотрудников. Считается как сумма расстояний между двумя соседними координатами мобильного устройства, без учета перепада высот.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	fix_date	date_t		Дата получения данных.
M	total	int32_t		Общий пробег за день в метрах (от момента получения первой и до момент получения последней информации о положении мобильного устройства).
	route	int32_t		Пробег по маршруту в метрах (от момента начала первой активности с параметром `activity_types→strict`=1 до момента завершения последней активности с параметром `activity_types→strict`=1, с учетом пробегов в рамках посещения, передаваемых в user_activities→mileage).

my_accounts

Список торговых точек, закрепленных за сотрудником (АКБ - Активная Клиентская База). Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных (АКБ актуальна только на указанную дату).
PK	user_id	uid_t	users	ID сотрудника.
PK	account_id	uid_t	accounts	ID клиента.

my_routes

Список торговых точек, предписанных сотруднику к посещению (маршруты). В данном потоке передаются маршруты только за будущие даты. Фактически, стратегия загрузки данных должна выглядеть следующим образом: (1) удалить все будущие маршруты; (2) загрузить данные из потока.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	account_id	uid_t	accounts	ID клиента.
PK	activity_type_id	uid_t	activity_types	ID вида активности.
M	p_date	date_t		Дата посещения клиента.
	row_no	int32_t		Порядок посещения клиентов.
	duration	int32_t		Рекомендуемая продолжительность посещения клиента.

oos_types

Виды причин отсутствия товарного запаса (OOS — Out-of-Stock).

	Код	Тип	Описание
PK	oos_type_id	uid_t	ID причины OOS.
M	descr	descr_t	Название причины OOS.
	props	hstore_t	Дополнительные параметры.
M	hidden	bool_t	Данные удалены.

order_params

Дополнительные параметры документа [Заказ продукции]. Данные параметры определяются дистрибьютором и загружаются в omobus из КИС дистрибьютора.

	Код	Тип	Ссылка	Описание
PK	distr_id	uid_t	distributors	ID дистрибутора.
PK	order_param_id	uid_t		ID параметра заказа.
M	descr	descr_t		Название параметра заказа.
M	hidden	bool_t		Данные удалены.

order_types

Типы заказов продукции.

	Код	Тип	Описание
PK	order_type_id	uid_t	ID типа заказа.
M	descr	descr_t	Название типа заказа.
M	hidden	bool_t	Данные удалены.

packs

Упаковки. Обязательно наличие базовой упаковки, для которой значение pack равно 1.

	Код	Тип	Ссылка	Описание
PK	pack_id	uid_t		ID упаковки.
PK	prod_id	uid_t	products	ID продукта.
M	descr	descr_t		Название упаковки.
M	pack	numeric_t		Размерность упаковки относительно базовой упаковки.
	weight	weight_t		Вес.
	volume	volume_t		Объем.
	precision	int32_t		Точность значений (количество знаков после запятой).
M	hidden	bool_t		Данные удалены.

payment_methods

Методы оплаты.

	Код	Тип	Ссылка	Описание
PK	payment_method_id	uid_t		ID метода оплаты.
M	descr	descr_t		Название метода оплаты.
M	hidden	bool_t	Данные удалены.

pending_types

Причины переноса планового посещения (“отложить посещение”).

	Код	Тип	Описание
PK	pending_type_id	uid_t	ID причины переноса.
M	descr	descr_t	Название причины переноса.
M	hidden	bool_t	Данные удалены.

photo_params

Дополнительные параметры фотографий торгового места.

	Код	Тип	Описание
PK	photo_param_id	uid_t	ID дополнительного параметра фотографии.
M	descr	descr_t	Название дополнительного параметра фотографии.
M	hidden	bool_t	Данные удалены.

photo_types

Типы фотографий торгового места.

	Код	Тип	Описание
PK	photo_type_id	uid_t	ID типа фотографии.
M	descr	descr_t	Название типа фотографии.
M	hidden	bool_t	Данные удалены.

placements

Места размещения продукции в торговом зале.

	Код	Тип	Описание
PK	placement_id	uid_t	ID места размещения.
M	descr	descr_t	Название места размещения.
M	hidden	bool_t	Данные удалены.

pmlist

Предписанные для клиента списки продуктов, используемы для проведения мониторинга цен. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных (данные актуальны только для активностей, выполненных в указанную дату).
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
	props	hstore_t		Дополнительные параметры.

pos_materials

PoS/PoP материалы.

	Код	Тип	Ссылка	Описание
PK	pos_id	uid_t		ID PoS/PoP материала.
M	descr	descr_t		Название PoS/PoP материала.
M	brand_ids	uids_t	brands	Список ID брендов, для которых предназначен материал.
	placement_ids	uids_t	placements	Список ID мест размещения, в которых может располагаться материал.
	chan_ids	uids_t	channels	Список ID каналов рынка, в которых действует материал.
	dep_ids	uids_t	departments	Список ID подразделений, для которых доступен материал.
	country_ids	uids_t	countries	Список ID стран, в которых действует материал.
	b_date	date_t		Дата начали действия данного материала.
	e_date	date_t		Дата окончания действия данного материала.
	author_id	uid_t	users	ID сотрудника (автора последних изменений).
M	hidden	bool_t		Данные удалены.

Пустое значение в реквизитах placement_ids, chan_ids, dep_ids и country_ids означает, что данный материал действует без ограничений.

potentials

Категории клиентов.

	Код	Тип	Описание
PK	poten_id	uid_t	ID категории клиента.
M	descr	descr_t	Название категории клиента.
M	hidden	bool_t	Данные удалены.

priorities

Список брендов, на которые нужно уделять особое внимание в определенные периоды. В данном потоке передаются только актуальные и будущие периоды. При загрузке необходимо учитывать данный факт. Фактически, стратегия загрузки данных должна выглядеть следующим образом: (1) удалить все актуальные и будущие периоды; (2) загрузить данные из потока.

	Код	Тип	Ссылка	Описание
PK	brand_id	uid_t	brands	ID приоритетного бренда.
PK	b_date	date_t		Дата начали действия данного приоритетного бренда.
PK	e_date	date_t		Дата окончания действия данного приоритетного бренда.
PK	country_id	uid_t	countries	ID страны, в которой действует данный приоритет.

products

Продукты. В данном потоке возможна организация иерархического подчинения путем задания реквизитов prod_id, pid и ftype. При этом, корневые элементы иерархического списка должны содержать в поле pid пустое значение. Кроме того, в данном справочнике могут присутствовать продукты конкурентов.

	Код	Тип	Ссылка	Описание
PK	prod_id	uid_t		ID продукта.
	pid	uid_t	products	ID родительского элемента.
M	ftype	bool_t		Элемент является папкой (1) или продуктом (0).
	code	code_t		Код (артикул) продукта.
M	descr	descr_t		Полное наименование продукта.
	kind_id	uid_t	kinds	ID вида (группы) продукта.
	brand_id	uid_t	brands	ID бренда.
	categ_id	uid_t	categories	ID категории.
	shelf_life_id	uid_t	self_lifes	ID срока годности.
	obsolete	bool_t		Продукт больше не производится, но еще имеется в наличии на складе.
	novelty	bool_t		Новинка.
	promo	bool_t		ПРОМО продукт.
	barcodes	codes_t		Список штрих-кодов, связанных с продуктом.
M	units	int32_t		Гранулярность продукта (шт, мл, ..).
	country_ids	countries_t	countries	Список ID стран или пустое значение.
	dep_ids	uids_t	departments	Список ID подразделений или пустое значение.
	row_no	int32_t		Порядок сортировки (приоритета).
	props	hstore_t		Дополнительные параметры.
M	hidden	bool_t		Данные удалены.

Реквизит units показывает, из скольки элементов состоит данный продукт, например, для продукта «Салфетки бумажные 4 рул.» данное поле будет иметь значение, равное 4 (рулона). Данный показатель используется для расчета стоимости продукта (Мониторинг цен) из расчета на одну минимально неделимую единицу продукта. По-умолчанию, значение равно 1.

promo_types

Возможные формы (виды, типы) проведения промо, например, «По личной договоренности», «Контракт» и т.п.

	Код	Тип	Описание
PK	promo_type_id	uid_t	ID типа промо.
M	descr	descr_t	Название типа промо.
M	hidden	bool_t	Данные удалены.

quest_entities

Типы фотографий анкеты.

	Код	Тип	Ссылка	Описание
PK	qname_id	uid_t	quest_names	ID названия анкеты.
PK	qentity_id	uid_t		ID типа фотографии анкеты.
M	descr	descr_t		Название типа фотографии анкеты.
M	hidden	bool_t		Данные удалены.

quest_items

Набор элементов, которые можно выбрать в том случае, если вопрос анкеты имеет тип selector.

	Код	Тип	Ссылка	Описание
PK	qname_id	uid_t	quest_names	ID названия анкеты.
PK	qrow_id	uid_t	quest_rows	ID вопроса анкеты.
PK	qitem_id	uid_t		ID элемента вопроса анкеты.
M	descr	descr_t		Название анкеты.
M	hidden	bool_t		Данные удалены.

quest_names

Названия анкет.

	Код	Тип	Описание
PK	qname_id	uid_t	ID названия анкеты.
M	descr	descr_t	Название анкеты.
	row_no	int32_t	Порядок сортировки (приоритета).
M	hidden	bool_t	Данные удалены.

quest_rows

Набор вопросов для анкет.

	Код	Тип	Ссылка	Описание
PK	qname_id	uid_t		ID названия анкеты.
PK	qrow_id	uid_t		ID вопроса анкеты или раздела анкетирования.
	pid	uid_t	quest_rows	ID родительского элемента.
M	ftype	bool_t		Элемент является разделом (1) или критерием оценки (0).
M	descr	descr_t		Вопрос анкеты или название раздела.
	qtype	varchar(10)		Тип вопроса анкеты.
	row_no	int32_t		Порядок сортировки (приоритета).
M	hidden	bool_t		Данные удалены.

Реквизит qtype может принимать одно из следующих значений:

Значение	Описание
boolean	Ответ Да или Нет.
triboolean	Ответ Да, Нет или Неизвестно.
integer	Целочисленное значение.
float	Дробное значение.
text	Текстовое значение.
selector	Выбор варианта ответа из списка (варианты ответов задаются в потоке `quest_items`).

rating_criterias

Список вопросов, по которым проводится оценка сотрудников проводимая в рамках совместного маршрута.

	Код	Тип	Описание
PK	rating_criteria_id	uid_t	ID критерия оценки.
M	descr	descr_t	Полное наименование критерия.
	row_no	int32_t	Порядок сортировки (приоритета).
M	hidden	bool_t	Данные удалены.

rating_scores

Список возможных баллов оценки сотрудников, проводимой в рамках совместного маршрута.

	Код	Тип	Описание
PK	rating_score_id	uid_t	ID оценки.
M	descr	descr_t	Полное наименование балла.
	score	int32_t	Значение балла. Возможно наличие оценок без значение балла.
	rating_criteria_id	uid_t	ID критерия оценки, для которого действует данное значение, или пустое значение, если оценка действует для всех критериев.
M	hidden	bool_t	Данные удалены.

reclamation_types

Причины возврата продукции.

	Код	Тип	Описание
PK	reclamation_type_id	uid_t	ID причины возврата продукции.
M	descr	descr_t	Название причины возврата продукции.
M	hidden	bool_t	Данные удалены.

regions

Набор логически выделенных, согласно организационной структуре компании, территорий. Данный список может не соответствовать административно-территориальному устройству страны, которое описывается в потоке cities.

	Код	Тип	Ссылка	Описание
PK	region_id	uid_t		ID региона.
M	descr	descr_t		Название региона.
	country_id	country_t	countries	ID страны.
	hidden	bool_t		Данные удалены.

retail_chains

Торговые сети.

	Код	Тип	Ссылка	Описание
PK	rc_id	uid_t		ID торговой сети.
M	descr	descr_t		Название торговой сети.
	ka_type	code_t		Тип торговой сети (NKA, LKA, …).
M	country_id	country_t	countries	ID страны, в которой действует торговая сеть.
M	hidden	bool_t		Данные удалены.

shelf_lifes

Сроки годности.

	Код	Тип	Описание
PK	shelf_life_id	uid_t	ID срока годности.
M	descr	descr_t	Описание срок годности, например, 8 мес.
M	hidden	bool_t	Данные удалены.

shelf_types

Категории полочного пространства (зона размещения продукции на полке) с точки зрения маркетинга.

	Код	Тип	Описание
PK	shelf_type_id	uid_t	ID категории полочного пространства.
M	descr	descr_t	Описание категории полочного пространства.
M	hidden	bool_t	Данные удалены.

specialities

Специальности сотрудников клиента (контактов).

	Код	Тип	Описание
PK	spec_id	uid_t	ID специальности контакта.
M	descr	descr_t	Название специализации контакта.
M	hidden	bool_t	Данные удалены.

speclist

Предписанные для клиента спецификации продуктов. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	slice_date	date_t		Дата актуальности данных (данные актуальны только для активностей, выполненных в указанную дату).
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
	props	hstore_t		Дополнительные параметры.

targets

Список задач, поставленных для выполнения у клиента. В отличие от других потоков справочных данных, в данном потоке передаются только данные, которые были вставлены или изменены в системе OMOBUS за последние 10 дней, в том числе и помеченные как удаленные.

	Код	Тип	Ссылка	Описание
PK	target_id	uid_t		ID задачи.
M	target_type_id	uid_t		ID типа задачи.
M	subject	descr_t		Заголовок задачи.
M	body	varchar(2048)		Описание задачи.
M	b_date	date_t		Дата начала действия задачи.
M	e_date	date_t		Дата окончания действия задачи.
	image	uid_t	thumbnails	Прилагаемая к задаче фотография.
	author_id	uid_t	users	ID сотрудника, создавшего задачу.
M	myself	bool_t		Персональная задача (0 или 1).
	cookie	uid_t		Метка задачи.
M	hidden	bool_t		Удаленная задача (0 или 1).
	pid	uid_t		ID документа, на основе которого создана задача. Тип документа можно определить через поток `user_documents` (реквизит - `doc_id`).
	props	hstore_t		Дополнительные параметры.

Список клиентов, у которых данная задача выполнялась, можно получить через поток confirmations.

Реквизит author_id Для задач, полученных из внешних источников, данный параметр не заполняется. В данном реквизите могут присутствовать коды сотрудников, отсутствующих в таблице users.

Реквизит cookie используется для пометки схожих задач и их дальшейшей группировки при анализе их выполнения.

Реквизит myself устанавливается в значение 1 только для задач, которые сотрудник поставил с помощью мобильного устройства для самого себя. В данном случае реквизит author_id будет всегда заполнен.

target_types

Типы задач.

	Код	Тип	Описание
PK	target_type_id	uid_t	ID типа задачи.
M	descr	descr_t	Название типа задачи.
M	hidden	bool_t	Данные удалены.

training_materials

Обучающие материалы.

	Код	Тип	Ссылка	Описание
PK	tm_id	uid_t		ID обучающего материала.
M	descr	descr_t		Название обучающего материала.
	brand_ids	uids_t	brands	Список ID брендов, для которых предназначен материал.
	training_type_ids	uids_t	training_types	Список ID видов обучений.
	dep_ids	uids_t	departments	Список ID подразделений, для которых доступен материал.
	country_ids	uids_t	countries	Список ID стран, в которых действует материал.
	b_date	date_t		Дата начали действия данного материала.
	e_date	date_t		Дата окончания действия данного материала.
	author_id	uid_t	users	ID сотрудника (автора последних изменений).
M	hidden	bool_t		Данные удалены.

Пустое значение в реквизитах brand_ids, training_type_ids, chan_ids, dep_ids и country_ids означает, что данный материал действует без ограничений.

training_types

Виды проводимых обучений.

	Код	Тип	Описание
PK	training_type_id	uid_t	ID вида проводимого обучения.
M	descr	descr_t	Название вида проводимого обучения.
M	hidden	bool_t	Данные удалены.

unsched_types

Виды причин выполнения внепланового действия.

	Код	Тип	Описание
PK	unsched_type_id	uid_t	ID причины внепланового действия.
M	descr	descr_t	Название внепланового действия.
M	hidden	bool_t	Данные удалены.

users

Сотрудники.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t		ID сотрудника.
	pids	uids_t	users	Список ID руководителей.
M	descr	descr_t		ФИО сотрудника.
M	role	code_t		Роль сотрудника.
M	country_id	countriy_t	countries	Код страны, на территории которой работает сотрудник.
	dep_ids	uids_t	departments	Список ID подразделений.
	distr_ids	uids_t	distributors	Список ID дистрибуторов.
	agency_id	uid_t	agencies	ID агентства.
	mobile	mobile_t		Сотовый телефон сотрудника.
	email	email_t		Электронная почта сотрудника.
	area	descr_t		Название территории.
	executivehead_id	uid_t	users	ID ответственного руководителя.
	dev_login	uid_t		Номер маршрута.
	props	hstore_t		Дополнительные параметры.
	rules:wd_begin	time_t		Максимально допустимое время начала рабочего дня по маршруту.
	rules:wd_end	time_t		Минимально допустимое время окончания рабочего дня по маршруту.
	rules:wd_duration	time_t		Минимальная продолжительность рабочего дня по маршруту.
	rules:timing	time_t		Минимальная продолжительность работы сотрудника у клиента.
M	hidden	bool_t		Данные удалены.

В реквизите role возможно одно из следующих значений:

merch — мерчендайзер;
sr — торговый представитель;
mr — медицинский представитель;
sv — торговый представитель;
ise - InStore executive;
asm - Area Sales (or InStore) manager;
kam – key account manager;
tme – trade marketing executive.

ВНИМАНИЕ! Список ролей может изменяться без предварительного согласования.

В реквизите rules:wd_duration указывается минимальная продолжительность рабочего дня по маршруту, которая расчитывается от момента начала первого посещения и до момента завершения последнего посещения.

warehouses

Склады дистрибьютора.

	Код	Тип	Ссылка	Описание
PK	distr_id	uid_t	distributors	ID дистрибутора.
PK	wareh_id	uid_t		ID склада.
M	descr	descr_t		Название склада.
M	hidden	bool_t		Данные удалены.

Собранные с помощью системы OMOBUS данные

В потоках, описываемых в данном разделе, передаются все данные, собранные с помощью мобильных терминалов данные. Потоки, имеющие префикс dyn_, проходят предварительную первичную обработку на сервере OMOBUS, которая заключается в удаление повторяющихся данных, снятых в течении дня сотрудниками у одного и того же клиента. Данные остальных потоков не проходят каких либо значимых обработок на стороне сервера OMOBUS.

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

Ко всем переданным фотографиям возможен доступ в виде ссылок, которые используются для формирования URI конкретной фотографии, хранящейся на сервере OMOBUS или в архивном хранилище LTS. При этом, URI фотографии формируется следующим образом:

https://[omobusserver]/console/photo?ref=[photo]

или, для получения фотографии с маркировкой (параметры фотографии нанесены непосредственно на фото; данные фотографии формируются только по согласованию с заказчиком)

https://[omobusserver]/console/thumb?ref=[photo]&labeled=yes

или, для получения миниатюры фотографии

https://[omobusserver]/console/thumb?ref=[photo]

где [omobusserver] – DNS имя сервера OMOBUS™, [photo] – значение ссылки, которое передается в рамках потока.

additions

Заявки на регистрацию новых клиентов. В случае внесения нового клиента в КИС, необходимо в обязательном поряке выгружать данного клиента в OMOBUS.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t		ID документа заявки.
M	fix_dt	datetime_t		Дата/время фиксации заявки.
M	user_id	uid_t	users	ID сотрудника, подавшего заявку на регистрацию новой клиента.
M	account	descr_t		Название клиента.
M	address	address_t		Фактический адрес клиента.
	tax_number	code_t		Уникальный номер клиента получаемый при ее регистрации в налоговых органах.
	addition_type_id	uid_t	addition_types	ID типа нового клиента.
	note	note_t		Дополнительная информация о клиенте.
	chan_id	uid_t	channels	ID канала рынка.
	attr_ids	uids_t	attributes	Список ID атрибутов клиента.
	photos	uids_t	thumbnails	Фотографии клиента.
M	account_id	uid_t		ID, который присвоен клиенту в системе OMOBUS. ВНИМАНИЕ! Для дальнейшего обмена с OMOBUS должен использоваться передаваемый в данном поле идентификатор, а не идентификатор КИС.
	validator_id	uid_t	users	ID сотрудника, подтвердившего заявку на регистрацию нового клиента. ВНИМАНИЕ! Возможны ситуации, когда данное поле будет содержать, данные отсутствующие в потоке users. Это не является ошибкой.
M	validated	bool_t		Заявка подтверждена (0 или 1).
M	hidden	bool_t		Заявка аннулирована (0 или 1).
	geo_address	address_t		Адрес клиента, полученный по результатам обработки его географических координат.

cancellations

Отмененные рабочие дни.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	route_date	date_t		Дата отменяемого рабочего дня.
	canceling_type_id	uid_t	canceling_types	ID причины отмены рабочего дня.
	note	note_t		Описание причины отмены рабочего дня.
	altered_dt	datetime_t		Дата/время последней корректировки.
	censor_id	uid_t	users	ID сотрудника, выполнившего последнюю корректировку.
M	hidden	bool_t		Отмена рабочего дня аннулирована (0 или 1).

Реквизит censor_id могут содержать данные отсутствующие в потоке users. Это не является ошибкой.

Реквизиты censor_id и altered_dt только в тех случаях, когда отмена маршрута была добавлена или отредактирована через web-console OMOBUS.

comments

Комментарии, сделанные сотрудниками. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t		ID документа.
M	fix_dt	datetime_t		Дата/время создания документа.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	comment_type_id	uid_t	comment_types	ID вида комментария.
	doc_note	note_t		Примечание.
	photo	uid_t	thumbnails	Фотография.

consents

Согласия контактов на сбор и обработку персональных данных и/или на получение информационных сообщений (далее - ПД).

	Код	Тип	Ссылка	Описание
PK	consent_id	uid_t		ID согласия.
M	contact_id	uid_t		ID контакта.
M	consent_status	varchar(24)		Набор подписанных согласий.
M	consent_data	blob_t		Согласие на обработку ПД.
M	consent_type	varchar(32)		Тип данных, передаваемых в consent_data.
M	consent_dt	datetime_t		Дата и время получения согласия.
M	consent_country	country_t	countries	Код страны оформления согласия.
M	consent_validity	int32_t		Срок действия согласия (лет).
M	guid	uid_t		Уникальный идентификатор согласия.

Реквизит consent_status может принимать одно из следующих значений:

collecting — подписано согласие на сбор и обработку персональных данных;
collecting_and_informing — аналогично предыдущему плюс согласие на получение информационных сообщений.

Реквизит consent_type может принимать одно из следующих значений: application/pdf – данные в формате PDF.

contacts

Список контактов клиента. Данный поток формируется на основе данных, собираемых сотрудниками с помощью мобильных устройств, и данных, полученных из КИС производителя.

	Код	Тип	Ссылка	Описание
PK	contact_id	uid_t		ID контакта.
M	account_id	uid_t	accounts	ID клиента.
M	name	descr_t		Имя контакта.
M	surname	descr_t		Фамилия контакта.
	patronymic	descr_t		Отчество контакта.
M	job_title_id	uid_t	job_titles	ID должности.
	spec_id	uid_t	specialities	ID специальности контакта.
	cohort_id	uid_t	cohorts	ID категории контакта.
	loyalty_level_id	uid_t	loyalty_levels	ID уровня лояльности контакта.
	influence_level_id	uid_t	influence_levels	ID уровня влияния контакта.
	intensity_level_id	uid_t	intensity_levels	ID уровня интенсивности работы.
	start_year	int32_t		Год начала трудовой деятельности.
	mobile	phone_t		Номер мобильного телефона.
	email	email_t		Адрес электронной почты.
	extra_info	note_t		Дополнительная информация о контакте.
	consent_id	uid_t		ID согласия на обработку ПД.
	founded_dt	datetime_t		Дата первичной регистрации контакта.
	founder_id	uid_t	users	Автор первичной регистрации контакта.
	fix_dt	datetime_t		Дата последней корректировки параметров контакта.
	user_id	uid_t	users	Автор последней корректировки параметров контакта.
M	hidden	bool_t		Данные удалены.
	cookie	uid_t		Метка для объединения контактов.

Реквизит cookie фактически представляет собой «дедуплицированный» идентификатор контакта.

confirmations

Подтверждение выполнения задач сотрудниками. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t		ID документа.
M	fix_dt	datetime_t		Дата/время создания документа.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	target_id	uid_t	targets	ID задачи.
M	confirmation_type_id	uid_t	confirmation_types	ID типа подтверждения задачи.
	doc_note	note_t		Примечание.
	photos	uids_t	thumbnails	Фотографии.

deletions

Заявки на удаление клиентов. После подтверждения факта удаления клиента, заявка на удаление автоматически аннулируется. Подтверждением факта удаления считается отсутствие клиента во входном потоке accounts.

	Код	Тип	Ссылка	Описание
PK	account_id	uid_t	accounts	ID клиента.
M	user_id	uid_t	users	ID сотрудника, подавшего заявку на удаление клиента.
M	fix_dt	datetime_t		Дата/время фиксации заявки.
	note	note_t		Дополнительная информация о причине удаления клиента.
	photo	uid_t	thumbnails	Фотография клиента. Передается в виде ссылки на поток thumbnails.
	validator_id	uid_t	users	ID сотрудника, подтвердившего заявку на удаление клиента. ВНИМАНИЕ! Возможны ситуации, когда данное поле будет содержать, данные отсутствующие в потоке users. Это не является ошибкой.
M	validated	bool_t		Заявка подтверждена (0 или 1). Клиенты, для которых подтверждена заявка на удаление, автоматически блокируются на стороне OMOBUS. Факт блокировки не запрещает возможность выполнения активности с данными клиентами.
M	hidden	bool_t		Заявка аннулирована (0 или 1).

discards

Заявки на исключение клиента из маршрута.

	Код	Тип	Ссылка	Описание
PK	account_id	uid_t	accounts	ID клиента.
PK	user_id	uid_t	users	ID сотрудника, подавшего заявку на исключение клиента из маршрута.
M	fix_dt	datetime_t		Дата/время фиксации заявки.
PK	activity_type_id	uid_t	activity_types	ID вида активности.
PK	route_date	date_t		Дата планового маршрута.
	discard_type_id	uid_t	discard_types	ID причины исключения активности из маршрута.
	note	note_t		Дополнительная информация о причине исключения клиента из маршрута.
	validator_id	uid_t	users	ID сотрудника, подтвердившего заявку на исключение клиента из маршрута. ВНИМАНИЕ! Возможны ситуации, когда данное поле будет содержать, данные отсутствующие в потоке users. Это не является ошибкой.
M	validated	bool_t		Заявка подтверждена (0 или 1).
M	hidden	bool_t		Заявка аннулирована (0 или 1).

dyn_asps

Представленность продукции на дополнительных местах продажи (ДМП).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	asp_guid	uid_t		Уникальный идентификатор ДМП.
PK	prod_id	uid_t	products	ID продукта.
	promo_type_id	uid_t	promo_types	ID вида ПРОМО.
PK	placement_id	uid_t	placements	ID места размещения.
PK	asp_type_id	uid_t	asp_types	ID типа ДМП.
	asp_note	note_t		Описание размещенного ДМП.
M	facing	int32_t		Значение фейсинга.
	stock	int32_t		Значение остатка продукта на полке.
	price	currency_t		Значение регулярной цены.
	promo	currency_t		Значение акционной (промо) цены.
	discount	bool_t		Действует скидка (0 или 1).
	note	note_t		Дополнительная информация, связанная с ценой.
	rrp	currency_t		Рекомендуемая розничная цена (`РРЦ`).
	capacity	int32_t		Вместимость полки.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

Под вместимостью (ёмкостью) полки (реквизит capacity) понимается количество продуктов, которые можно установить в один ряд вглубь ДМП.

В том случае, если действует скидка, т.е. ревизит discount=1, обязательно заполняется реквизит промо цены (promo), при этом значение регулярной цены (price) может отсутствовать.

Реквизит scratch содержит значение NULL в том случае, если данные введены или однозначно подтверждены сотрудником. Значение отличное от NULL говорит о том, что сотрудник не подтверждал ранее внесенные данные.

dyn_asps2

Представленность продукции на дополнительных местах продажи (ДМП) (приложенные фотографии).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	asp_guid	uid_t		Уникальный идентификатор ДМП.
PK	guid	uid_t		ID фотографии ДМП.
	promo_type_id	uid_t	promo_types	ID вида ПРОМО.
PK	placement_id	uid_t	placements	ID места размещения.
PK	asp_type_id	uid_t	asp_types	ID типа ДМП.
	asp_note	note_t		Описание размещенного ДМП.
	photo	uid_t	thumbnails	Фотография, приложенная к документу.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

Наличие пустого значения в реквизите photo говорит о том, что ранее существовавшее значение удалено из документа.

Реквизит scratch содержит значение отличное от NULL в том случае, если фото сделано ранее (не в день фактического выполнения активности). Указанная ситуамия может возникать только в случаях, когда сотрудник не вносит каких-либо корректировок в ранее внесенные данные. Если после этого, сотрудник делает хотя-бы одно фото, транслированные фото помечаются как удаленные.

dyn_audits

Результаты аудита размещения продукции (работы мерчендайзера). Описание методики расчета итоговых оценок аудита приводится в документе [OMOBUS. Tech. Аудит размещения продукции (формула расчета SLA).xlsx].

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	categ_id	uid_t	categories	ID категории, в которой проводился аудит.
PK	audit_criteria_id	uid_t	audit_criterias	ID критерия проводимого аудита.
	audit_score_id	uid_t	audit_scores	ID оценки.
M	criteria_wf	wf_t		Весовой коэффициент критерия оценки.
	score_wf	wf_t		Весовой коэффициент оценки.
	score	int32_t		Значение оценки.
	note	note_t		Дополнительная информация об обнаруженных нарушениях.
M	wf	wf_t		Весовой коэффициент категории в общей оценке результатов аудита.
	sla	numeric(6,5)		Результрующая оценка аудита категории (SLA — Service-Level-Agreement).
	photos	uids_t	thumbnails	Фотографии обнаруженных нарушений во всей категории проводимого аудита.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, проведшего аудит.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.

dyn_checkups

Наличие продукции в торговом зале (осмотр торгового зала).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	exist	int32_t		Наличие продукта: `0` — нет; `1` — есть; `2` — мало.
	fault_type_ids	uids_t	fault_types	Список ID видов проблемы размещения.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

dyn_oos

Результат выявления причин отсутствия товарного запаса (OOS — Out-of-Stock) в торговом зале.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	oos_type_id	uid_t	oos_types	ID вида OOS.
	note	note_t		Дополнительная информация о причинах OOS.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.

dyn_presences

Представленность продукции на полке.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	facing	int32_t		Значение фейсинга.
	stock	int32_t		Значение остатка продукта на полке.
	price	currency_t		Значение регулярной цены.
	promo	currency_t		Значение акционной (промо) цены.
	discount	bool_t		Действует скидка (0 или 1).
	note	note_t		Дополнительная информация, связанная с ценой.
	rrp	currency_t		Рекомендуемая розничная цена (`РРЦ`).
	shelf_type_id	uid_t	shelf_types	ID категории полочного пространства.
	fault_type_ids	uids_t	fault_types	Список ID видов проблемы размещения.
	capacity	int32_t		Вместимость полки.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

Под вместимостью (ёмкостью) полки (реквизит capacity) понимается количество продуктов, которые можно установить в один ряд вглубь полки.

dyn_prices

Результаты мониторинга цен продукции.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
	price	currency_t		Значение регулярной цены.
	promo	currency_t		Значение акционной (промо) цены.
	discount	bool_t		Действует скидка (0 или 1).
	note	note_t		Дополнительная информация, связанная с ценой.
	photo	uid_t	thumbnails	Фотография ценника.
	rrp	currency_t		Рекомендуемая розничная цена (`РРЦ`).
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

dyn_quests

Результаты проведения анкетирований (ответы на вопросы анкеты).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	qname_id	uid_t	quest_names	ID названия анкеты.
PK	qrow_id	uid_t	quest_rows	ID вопроса анкеты.
	value	note_t		Зафиксированное значение.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	vstamp	code_t		Версия ПО, с помощью которого были созданы данные.
M	doc_id	uid_t	user_documents	ID документа.
M	founder_dt	datetime_t		Дата/время первичного создания анкеты.
M	founder_id	uid_t	users	ID сотрудника, первично создавшего анкету.
	founder_vstamp	code_t		Версия ПО, с помощью которого была первично создана анкета.
	altered_dt	datetime_t		Дата/время последней корректировки анкеты.
	censor_id	uid_t	users	ID сотрудника, выполнившего последнюю корректировку анкеты.
	hidden	bool_t		Вопрос анкеты удален.
	_isRecentData	bool_t		Строка содержит актуальные данные (0 или 1).

Наличие пустого значения в реквизите value говорит о том, что ранее существовавшее значение удалено из анкеты.

Реквизиты user_id и censor_id могут содержать данные отсутствующие в потоке users. Это не является ошибкой.

dyn_quests2

Результаты проведения анкетирований (приложенные фотографии).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	qname_id	uid_t	quest_names	ID названия анкеты.
PK	guid	uid_t		ID фотографии анкеты.
M	qentity_id	uid_t	quest_entities	ID типа фотографии анкеты.
	photo	uid_t	thumbnails	Фотография, приложенная к анкете.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	vstamp	code_t		Версия ПО, с помощью которого были созданы данные.
M	doc_id	uid_t	user_documents	ID документа.
M	founder_dt	datetime_t		Дата/время первичного создания анкеты.
M	founder_id	uid_t	users	ID сотрудника, первично создавшего анкету.
	founder_vstamp	code_t		Версия ПО, с помощью которого была первично создана анкета.
	altered_dt	datetime_t		Дата/время последней корректировки анкеты.
	censor_id	uid_t	users	ID сотрудника, выполнившего последнюю корректировку анкеты.
	hidden	bool_t		Вопрос анкеты удален через `web-console` OMOBUS.
	_isRecentData	bool_t		Строка содержит актуальные данные (0 или 1).

Наличие пустого значения в реквизите photo говорит о том, что ранее существовавшее значение удалено из анкеты.

Реквизиты user_id и censor_id могут содержать данные отсутствующие в потоке users. Это не является ошибкой.

dyn_ratings

Оценки, выставленные в ходе совместного маршрута руководителя с подчиненным.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	employee_id	uid_t	users	ID сотрудника, с которым осуществлялся совместный маршрут (подчиненный).
PK	rating_criteria_id	uid_t	rating_criterias	ID критерия оценки.
	rating_score_id	uid_t	rating_scores	ID оценки.
M	criteria_wf	wf_t		Весовой коэффициент критерия оценки.
	score_wf	wf_t		Весовой коэффициент оценки.
	score	int32_t		Значение выставленной оценки.
	note	note_t		Дополнительная информация.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, который проводил совместный маршрут (руководителя).
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.

dyn_reviews

Результаты проведенного совместного маршрута.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	employee_id	uid_t	users	ID сотрудника, с которым осуществлялся совместный маршрут (подчиненный).
M	sla	numeric(6,5)		Результирующая оценка (Service-Level-Agreement), полученная в ходе совместного маршрута (значение измеряется в диапазоне от 0 до 1, где 1 соответствует 100%).
M	assessment	numeric(5,3)		Средняя оценка, полученная в ходе совместного маршрута.
	note0	note_t		Сильные стороны облучаемого.
	note1	note_t		Области для развития.
	note2	note_t		Рекомендации для развития.
	unmarked	uids_t		Список рекомендованных критериев (`mandatory`=1), для которых не была проставлена значимая оценка.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, который проводил совместный маршрут (руководителя).
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.

dyn_shelfs

Доля продукции производителя на полке клиента, размещенной лицом к покупателю (фейсинг).

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	categ_id	uid_t	categories	ID категории.
PK	brand_id	uid_t	brands	ID бренда. ВНИМАНИЕ! В качестве данного параметра может возвращаться пустое значение, что означает – данные получены для остальных продуктов.
	facing	int32_t		Количество фейсингов продукции на полке в категории по бредну. Может принимать значение >= 0.
	assortment	int32_t		Количество уникальной продукции на полке в категории по бредну. Может принимать значение >= 0.
	sos	numeric(6,5)		Значение доли полки (`SOS` — Share-of-Shelf) продукции в категории.
	soa	numeric(6,5)		Значение доли в ассортименте (`SOA` — Share-of-Assortment) продукции в категории.
	photos	uids_t	thumbnails	Фотографии полки во всей категории.
	sos_target	wf_t		Целевой показатель доли полки в момент фиксации данных на устройстве.
	soa_target	wf_t		Целевой показатель доли в ассортименте в момент фиксации данных на устройстве.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.

dyn_stocks

Результаты выполнения ревизии складских остатков продукции. Данный поток содержит фактические остатки продукции или остатки продукции по данным КИС клиента.

	Код	Тип	Ссылка	Описание
PK	fix_date	date_t		Дата фиксации данных.
PK	account_id	uid_t	accounts	ID клиента.
PK	prod_id	uid_t	products	ID продукта.
M	stock	int32_t		Остаток продукции.
M	fix_dt	datetime_t		Дата/время фиксации данных.
M	user_id	uid_t	users	ID сотрудника, зафиксировавшего данные.
M	doc_id	uid_t	user_documents	ID документа.
	_isRecentData	bool_t		Маркировка последних (актуальных) данных.
	scratch	date_t		Маркер неизменности данных с предыдущей итерации их ввода.

equipments

Список торгового оборудования, установленного у клиентов.

	Код	Тип	Ссылка	Описание
PK	equipment_id	uid_t		ID т/оборудования.
M	account_id	uid_t	accounts	ID клиента.
M	serial_number	varchar(40)		Серийный номер установленного т/оборудования.
M	equipment_type_id	uid_t	equipment_types	ID вида т/оборудованием.
	equipment_cond_id	uid_t		ID состояния т/оборудования.
	extra_info	note_t		Дополнительная информация.
	photos	uids_t	thumbnails	Фотографии.
	founded_dt	datetime_t		Дата регистрации факта установки т/оборудования.
	founder_id	uid_t	users	Автор регистрации факта установки т/оборудования.
	fix_dt	datetime_t		Дата последней инвентаризации т/оборудования.
	user_id	uid_t	users	Автор последней инвентаризации т/оборудования.
M	hidden	bool_t		Данные удалены.

Реквизит equipment_id определяет факт размещения торгового оборудования у клиента. Исходя из этого, одно и то-же торговое оборудование (оборудование с одинаковым серийным номером) может фигурировать в данном потоке несколько раз.

locations

Координаты клиентов, зафиксированные сотрудниками с помощью мобильных устройств. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были ранее загружены в хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата/время создания документа.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	latitude	gps_t		Широта.
M	longitude	gps_t		Долгота.
M	accuracy	double_t		Точность определения данных в метрах.
	dist	double_t		Расстояние до клиента (получается на основе ранее полученной координаты клиента).

orders

Заказ продукции. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	distr_id	uid_t	distributors	ID дистрибутора.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
	order_type_id	uid_t	order_types	ID вида заказа.
	group_price_id	uid_t	group_prices	ID групповой цены.
M	wareh_id	uid_t	warehouses	ID склада.
M	delivery_date	date_t		Дата доставки.
	delivery_type_id	uid_t	delivery_types	ID типа доставки.
	doc_note	note_t		Комментарий.
	payment_method_id	uid_t	payment_methods	ID типа оплаты.
	payment_delay	int32_t		Отсрочка платежа.
	order_param_ids	uids_t	order_params	Дополнительные параметры заказа.
M	rows	int32_t		Количество строк в документе.
PK	prod_id	uid_t	products	ID продукта.
M	row_no	int32_t		Номер строки в документе.
M	pack_id	uid_t	packs	ID упаковки.
M	pack	int32_t		Размерность упаковки.
M	qty	numeric_t		Количество в упаковке, заданной в `pack_id`.
M	unit_price	currency_t		Цена.
	discount	int32_t		Значение скидки в %.
M	amount	currency_t		Сумма строки с учетом скидки.
	weight	numeric_t		Вес.
	volume	numeric_t		Объём.
	promo_guid	uid_t		Уникальный идентификатор промо.

Поле pack_id содержит идентификатор упаковки в нотации производителя. Поле pack содержит размерность упаковки относительно базовой упаковки, которая определяется в штуках. Размерность базовой упаковки всегда равна 1.

photos

Фотографии торговых мест. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	placement_id	uid_t	placements	ID места размещения.
	brand_id	uid_t	brands	ID бренда.
	asp_type_id	uid_t	asp_types	ID типа ДМП.
	photo_type_id	uid_t	photo_types	ID типа фотографии.
M	photo	uid_t	thumbnails	Фотография.
	doc_note	note_t		Примечание.
	photo_param_ids	uids_t	photo_params	ID дополнительного параметра фотографии.

posms

Фотографии размещения PoS/PoP материалов. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	placement_id	uid_t	placements	ID места размещения.
M	posm_id	uid_t		ID PoS материала.
M	photo	uid_t	thumbnails	Фотография.
	qty	int32_t		Количество размещенных материалов (на фото).
	doc_note	note_t		Примечание.

presentations

Проведенные презентации продукции. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	participants	int32_t		Количество участников.
	tm_ids	uids_t	training_materials	Список ID показанных обучающих материалов.
	doc_note	note_t		Примечание.
	photos	uids_t	thumbnails	Фотографии.

profiles

Изменение параметров клиента. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
	chan_id	uid_t	channels	ID канала рынка.
	poten_id	uid_t	potentials	ID категории клиента.
	phone	phone_t		№ телефона.
	workplaces	int32_t		Количество рабочих мест у клиента (например, количество касс в т/точке, количество кресел в стоматологической клинике и т.п.).
	team	int32_t		Количество сотрудников.
	interaction_type_id	uid_t	interaction_types	ID разрешенной формы взаимодействия.
	attr_ids	uids_t	attributes	Дополнительные параметры клиента.

reclamations

Возврат продукции. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата создания документа на устройстве.
M	distr_id	uid_t	distributors	ID дистрибутора.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
	doc_note	note_t		Комментарий.
M	rows	int32_t		Количество строк в документе.
PK	prod_id	uid_t	products	ID продукта.
M	row_no	int32_t		Номер строки в документе.
M	reclamation_type_id	uid_t	reclamation_types	ID причины возврата.
M	pack_id	uid_t	packs	ID упаковки.
M	pack	int32_t		Размерность упаковки.
M	qty	numeric_t		Количество в упаковке, заданной в `pack_id`.
M	unit_price	currency_t		Цена.
M	amount	currency_t		Сумма строки с учетом скидки.
	weight	numeric_t		Вес.
	volume	numeric_t		Объём.

remarks

Список отметок с обратной связью по подтверждениям выполненных сотрудниками задач.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	confirmations	ID документа.
M	status	varchar(8)		Статус: `accepted` или `rejected`.
	note	note_t		Дополнительная информация.

revocations

Отозванные сотрудником документы. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	confirmations	ID документа.
M	doc_type	doctype_t		Тип документа. Список возможных типов документов приводится в описание потока `user_documents`.
M	hidden	bool_t		Отзыв документа аннулирован (0 или 1).

trainings

Обучение персонала клиента. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	confirmations	ID документа.
M	fix_dt	datetime_t		Дата/время создания документа.
M	user_id	uid_t	users	ID сотрудника.
M	account_id	uid_t	accounts	ID клиента.
M	training_type_id	uid_t	training_types	ID вида обучения.
M	contact_ids	uids_t	contacts	Список ID обученных контактов.
M	tm_ids	uids_t	training_materials	Список ID показанных обучающих материалов.
	doc_note	note_t		Примечание.
	photos	uids_t	thumbnails	Фотографии.

thumbnails

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

	Код	Тип	Описание
PK	ref_id	uid_t	Уникальная ссылка на объект.
M	photo	blob_t	Фотография.
	thumb	blob_t	Миниатюра.
	thumb_width	int32_t	Ширина миниатюры в пикселях.
	thumb_height	int32_t	Высота миниатюры в пикселях.
	labeled	blob_t	Фотография с нанесенной на нее маркировкой.

unsched

Внеплановые действия выполненные сотрудником в рамках рабочего дня. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	doc_id	uid_t	user_documents	ID документа.
M	fix_dt	datetime_t		Дата/время создания документа.
M	user_id	uid_t	users	ID сотрудника.
	unsched_type_id	uid_t	unsched_types	ID причины внепланового действия.
	doc_note	note_t		Детальное описание внепланового действия.

user_activities

Активности сотрудников.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	account_id	uid_t	accounts	ID клиента.
PK	w_cookie	uid_t		Метка рабочего дня.
PK	a_cookie	uid_t		Метка активности.
PK	activity_type_id	uid_t	activity_types	ID вида активности.
M	fix_date	date_t		Дата выполнения активности.
	route_date	date_t		Плановая дата активности.
	b_dt	datetime_t		Дата/время начала активности.
	b_la	gps_t		Местоположение начала активности (широта).
	b_lo	gps_t		Местоположение начала активности (долгота).
	b_sat_dt	datetime_t		Дата/время начала активности по данным нав. системы (UTC).
	e_dt	datetime_t		Дата/время окончания активности.
	e_la	gps_t		Местоположение окончания активности (широта).
	e_lo	gps_t		Местоположение окончания активности (долгота).
	e_sat_dt	datetime_t		Дата/время окончания активности по данным нав. системы (UTC).
	c_cookie	uid_t		Метка совместного маршрута.
	employee_id	uid_t		ID подчиненного сотрудника.
	extra_info	note_t		Дополнительная информация.
	docs	int32_t		Количество созданных документов в рамках активности.
	received_docs	int32_t		Количество доставленных документов.
	mileage	int32_t		Пробег сотрудника в рамках активности в метрах.
	zstatus	varchar(8)		Статус выполнения активности.
	znote	note_t		Примечание статуса активности.
	zauthor_id	uid_t	users	Автор статуса активности.
	zreq_dt	datetime_t		Дата/время изменения статуса активности.
	road_dt	datetime_t		Дата/время момента начала перемещения к клиенту.
	road_mileage	int32_t		Пробег от момента начала перемещения до момента начала активности.

Обратите внимание на то, что время начала или окончания посещения может отсутствовать. Это говорит о том, что на момент формирования данных информация о факте завершения не поступила в систему OMOBUS.

Реквизит employee_id заполняется только в случае выполнения совместного маршрута.

Реквизит extra_info содержит объяснение сотрудником причины невыполнения всех операция предписанных для данного вида активности.

Реквизит mileage содержит информацию о пробеге сотрудника в ходе выполнения активности. Расчет ведется только для активностей, у которых реквизит activity_type→strict=1.

Реквизит route_date заполняется только в случае, если данное посещение было запланировано в рамках планового маршрута. Возможны ситуации, при которых плановая дата маршрута может отличаться от фактической даты активности.

Реквизиты zstatus, znote,zauthor_idиzreq_dt` заполняются ответственным сотрудником в ходе контроля выполнения активности в wev-console OMOBUS.

Реквизит zstatus может принимать одно из следующих значений:

accepted — активность принята;
rejected — активность отклонена;
unknown - ранее выставленный статус активности был аннулирован.

Реквизит zstatus может содержать, данные отсутствующие в потоке users. Это не является ошибкой.

user_documents

Документы, созданные сотрудником.

	Код	Тип	Ссылка	Описание
PK	act_id	uid_t		ID пользовательской активности.
M	user_id	uid_t	users	ID сотрудника.
M	w_cookie	uid_t		Метка рабочего дня.
M	fix_date	date_t		Дата создания документа.
M	doc_type	doctype_t		Тип документа.
	doc_id	uid_t		ID документа.
M	doc_no	uid_t		№ документа на мобильном устройстве.
M	duration	int32_t		Продолжительность создания документа в сек.
	rows	int32_t		Количество строк данных в документе.
M	fix_dt	datetime_t		Дата/время фиксации документа.
	latitude	gps_t		Местоположение сотрудника (широта).
	longitude	gps_t		Местоположение сотрудника (долгота).
	satellite_dt	datetime_t		Дата/время по данным навигационной системы (UTC).
	a_cookie	uid_t		Метка активности.
	account_id	uid_t	accounts	ID клиента.
	activity_type_id	uid_t	activity_types	ID вида активности.
	c_cookie	uid_t		Метка совместного маршрута.
	employee_id	uid_t	users	ID подчиненного сотрудника.

Пустое значение doc_id говорит о том, что данные документа не доставлены в систему с мобильного устройства на текущий момент времени. Это вполне штатная ситуация. Как только данные документа будут доставлены, информация в doc_id будет передана в LTS.

В реквизите doc_type может передаваться одно из следующих значений:

addition - регистрация нового клиента;
asp - контроль размещения ДМП;
audit - аудит размещения продукции в т/зале;
canceling - отмена маршрута;
checkup - осмотр т/зала;
comment - комментарий;
confirmation - подтверждение выполнение задачи (у клиента);
contact - регистрация/изменение контакта;
deletion - заявка на удаление клиента;
discard - заявка на исключениеклиента из маршрута;
dismiss - заявка на удаление напоминания (задачи вне клиента);
equipment — регистрация/изменение торгового оборудования установленного у клиента;
location - фиксация положения клиента;
oos - выявление причин OOS;
order - заказ продукции;
pending - отложить посещение;
photo - фото т/места;
presence - представленность продукции на полке;
presentation — презентация прдукции;
price - мониторинг цен;
profile - профиль клиента;
quest — анкета;
rating - оценка работы подчиненного сотрудника;
reclamation — возврат продукции;
review - итоги совместного маршрута;
shelf - доля полки/доля в ассортименте;
stock - ревизия складских остатков;
target - новая задача (у клиента);
training - обучение контакта;
unsched - внеплановое действие.

ВНИМАНИЕ! Список видов документов может изменяться без предварительного согласования.

Реквизит employee_id заполняется только случае выполнения совместного маршрута.

user_joints

Совместный маршрут с подчиненными сотрудниками.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	employee_id	uid_t		ID подчиненного сотрудника.
PK	w_cookie	uid_t		Метка рабочего дня.
PK	c_cookie	uid_t		Метка совместного маршрута.
M	fix_date	date_t		Дата выполнения совместного маршрута.
	b_dt	datetime_t		Дата/время начала совместного маршрута..
	b_la	gps_t		Местоположение начала совместного маршрута. (широта).
	b_lo	gps_t		Местоположение начала совместного маршрута. (долгота).
	b_sat_dt	datetime_t		Дата/время начала совместного маршрута. по данным нав. системы (UTC).
	e_dt	datetime_t		Дата/время окончания совместного маршрута..
	e_la	gps_t		Местоположение окончания совместного маршрута. (широта).
	e_lo	gps_t		Местоположение окончания совместного маршрута. (долгота).
	e_sat_dt	datetime_t		Дата/время окончания совместного маршрута. по данным нав. системы (UTC).

user_locations

Перемещения сотрудников (опорные точки, фиксируемые 1 раз в 5 минут в обязательном порядке и детальная трасса, фиксируемая 1 раз в 4 секунды, если устройство включено). Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	act_id	uid_t		ID пользовательской активности.
PK	row_no	int32_t		№ элемента трассы, для опорной точки данный параметр равен -1.
M	user_id	uid_t	users	ID сотрудника.
M	fix_date	date_t		Дата создания документа.
M	latitude	gps_t		Местоположение сотрудника (широта).
M	longitude	gps_t		Местоположение сотрудника (долгота).
M	fix_dt	datetime_t		Дата/время фиксации местоположение.
M	satellite_dt	datetime_t		Дата/время по данным навигационной системы (UTC).
M	accuracy	double_t		Точность координат в метрах.
M	altitude	double_t		Возвышение над уровнем моря в метрах.
M	bearing	double_t		Азимут.
M	speed	double_t		Скорость.
	seconds	int32_t		Время устаревания координат в секундах.
M	provider	varchar(8)		Источник данных.
	satellites	int32_t		Количество спутников в зоне видимости в момент определения координаты.

user_reports

Отчеты, просмотренные сотрудником. Данные, переданные в рамках данного потока, никогда не меняются. Это означает, что, если данные ранее были загружены в LTS хранилище, они гарантированно не потребуют внесения в них изменений. Стратегия загрузки данного потока: вставка только новых данных.

	Код	Тип	Ссылка	Описание
PK	act_id	uid_t		ID пользовательской активности.
M	user_id	uid_t	users	ID сотрудника.
M	w_cookie	uid_t		Метка рабочего дня.
M	fix_date	date_t		Дата просмотра отчета.
M	doc_type	doctype_t		Тип отчета.
M	duration	int32_t		Продолжительность просмотра отчета в сек.
M	fix_dt	datetime_t		Дата/время фиксации.
	latitude	gps_t		Местоположение сотрудника (широта).
	longitude	gps_t		Местоположение сотрудника (долгота).
	satellite_dt	datetime_t		Дата/время по данным навигационной системы (UTC).
	a_cookie	uid_t		Метка активности.
	account_id	uid_t	accounts	ID клиента.
	activity_type_id	uid_t	activity_types	ID вида активности.
	c_cookie	uid_t		Метка совместного маршрута.
	employee_id	uid_t		ID подчиненного сотрудника.

Реквизит employee_id заполняется только случае выполнения совместного маршрута.

user_works

Рабочий день сотрудников.

	Код	Тип	Ссылка	Описание
PK	user_id	uid_t	users	ID сотрудника.
PK	w_cookie	uid_t		Метка рабочего дня.
M	fix_date	date_t		Дата выполнения рабочего дня.
	b_dt	datetime_t		Дата/время начала рабочего дня.
	b_la	gps_t		Местоположение сотрудника, зафиксированное в момент начала рабочего дня (широта).
	b_lo	gps_t		Местоположение сотрудника, зафиксированное в момент начала рабочего дня (долгота).
	b_sat_dt	datetime_t		Дата/время начала рабочего дня по данным навигационной системы (UTC).
	e_dt	datetime_t		Дата/время окончания рабочего дня.
	e_la	gps_t		Местоположение сотрудника, зафиксированное в момент окончания рабочего дня (широта).
	e_lo	gps_t		Местоположение сотрудника, зафиксированное в момент окончания рабочего дня (долгота).
	e_sat_dt	datetime_t		Дата/время окончания рабочего дня по данным навигационной системы (UTC).

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

COPYRIGHT

Разрешено распространение и использование исходного кода с модификациями или без модификаций, с учетом ограничений, указанных в файле COPYRIGHT.

OMOBUS Long-Time-Storage (LTS) database

Варианты размещения LTS базы данных OMOBUS

База данных в зоне ответственности заказчика под управлением СУБД Microsoft SQL Server или PostgreSQL

База данных в зоне ответственности OMOBUS под управлением СУБД PostgreSQL

Типы данных

Справочные данные

accounts

activity_types

addition_types

agencies

agreements1

agreements2

agreements3

agreements4

asp_types

attributes

audit_criterias

audit_scores

brands

canceling_types

categories

channels

cities

cohorts

comment_types

confirmation_types

countries

delivery_types

departments

discard_types

distributors

equipment_conditions

equipment_types

fault_types

holidays

influence_levels

intensity_levels

interaction_types

job_titles

kindes

loyalty_levels

manufacturers

matrices

mileages

my_accounts

my_routes

oos_types

order_params

order_types

packs

payment_methods

pending_types

photo_params

photo_types

placements

pmlist

pos_materials

potentials

priorities

products

promo_types

quest_entities

quest_items

quest_names

quest_rows

rating_criterias

rating_scores

reclamation_types

regions

retail_chains

shelf_lifes

shelf_types

specialities

speclist

targets

target_types

training_materials

training_types

unsched_types

users