Page History

...

Архив с полным набором файлов, содержащими только заголовочные строки без данных:
View file
name headers_only.zip
height 250
Tip
Используйте данный архив в качестве основы для формирования выгрузки

Образец содержимого файла ACCOUNTS.csv для таблицы ACCOUNTS:

Code Block

theme	Confluence
linenumbers	true

"ID";"CUSTOMER_ID";"ACCOUNT_NUMBER";"ACCOUNT_TYPE_ID";"CURRENCY_ID";"BANK_ID";"BALANCE";"CREDIT";"CREDIT_END_DATE";"BALANCE_DATE";"REMARK"
"10";"1";"14170";"1";"643";"";"802.00";"";"";"29.02.2024 23:59:59";""
"11";"1";"14170★";"3";"999";"";"560";"";"";"29.02.2024 23:59:59";"Открыт при заключении договора.¶Списание бонусов производить только по согласованию с Фёдором Сумкиным."

Архив с упрощённой выгрузкой, включающей только базовый набор данных:
View file
name example_basic.zip
height 250
Архив с расширенной выгрузкой, включающей дополнительные таблицы и поля:
View file
name example_extended.zip
height 250

...

Юридические и физические лица находятся в единой таблице CUSTOMERS и различаются по значению поля ORGANIZATION.
Из реквизитов юридических лиц по умолчанию мигрируют только наименование, организационно-правовая форма и ИНН.
История начислений мигрирует «как есть» в виде архивированных актов начислений.
Для текущих расчётных периодов при миграции акты начислений формируются Гидрой на основании настроенных схем оказания услуг и приказов по ценам, с учётом выгруженных дат начала расчётных периодов и подписок на услуги.
- Объём потреблённых потоковых услуг в текущем периоде: интернет-трафик, «минуты» услуг телефонии — не мигрирует.
Тарифные планы, услуги и их особенности: периодичность, квоты, цены, ограничения скоростей доступа — не мигрируют, а настраиваются вручную в Гидре и затем сопоставляются с выгруженным справочником (таблица PRODUCTS).
Внутренние идентификаторы мигрированных сущностей в Гидре будут отличаться от выгруженных. Но соответствия выгруженных и результирующих идентификаторов в ходе миграции сохраняются в БД Гидры для возможностей последующей обработки абонентов.

...

Info

Обязательные для заполнения таблицы и столбцы в описании отмечены знаком

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

По договорённости в выгрузку могут быть добавлены дополнительные таблицы и дополнительные столбцы стандартных таблиц.

Anchor

	ref-tables
	ref-tables

Сопоставляемые справочники

...

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

Anchor

	account_types
	account_types

ACCOUNT_TYPES — типы счетов

Необходимы хотя бы лицевые счета.

Столбец	Описание
ID	Идентификатор типа счёта
NAME	Наименование типа счёта
REMARK	Примечание для правильного выбора соответствия

...

Примеры: Лицевой счёт, Расчётный счёт.

Anchor

	auth_doc_types
	auth_doc_types

AUTH_DOC_TYPES — типы документов, удостоверяющих личность

Оставьте таблицу пустой, если не выгружаете реквизиты удостоверений личности абонентов-физлиц.

Столбец	Описание
ID	Идентификатор типа документа
NAME	Наименование типа документа
REMARK	Примечание для правильного выбора соответствия

...

Примеры: Паспорт, Справка.

Anchor

	banks
	banks

BANKS — банки счетов и источники платежей

Оставьте таблицу пустой, если не выгружаете расчётные счета и историю платежей.

Столбец	Описание
ID	Идентификатор банка.
NAME	Наименование банка.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Сбербанк, Касса в офисе, Платёжная система Киберплат.

Anchor

	comment_types
	comment_types

COMMENT_TYPES — типы комментариев

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

Столбец	Описание
ID	Идентификатор типа комментариев.
NAME	Наименование типа комментариев.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Запрос в службу поддержки, Отзыв, Авария.

Anchor

	currencies
	currencies

CURRENCIES — валюты счетов

Необходима хотя бы одна валюта, в которой ведутся расчёты с абонентам.

Столбец	Описание
ID	Идентификатор валюты.
NAME	Наименование валюты.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Российский рубль, Бонус.

Anchor

	customer_groups
	customer_groups

CUSTOMER_GROUPS — группы абонентов

Необходимы хотя бы главные группы абонентов.

Столбец	Описание
ID	Идентификатор группы.
NAME	Наименование группы.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Физлица МКД, Частники, Бизнес, Бюджетники, Сотрудники.

Anchor

	customer_statuses
	customer_statuses

CUSTOMER_STATUSES — состояния абонентов

Необходимы хотя бы два состояния: для активных и отключенных абонентов.

Столбец	Описание
ID	Идентификатор состояния.
NAME	Наименование состояния.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Активен, Заблокирован вручную, Отключен.

Anchor

	equipment_types
	equipment_types

EQUIPMENT_TYPES — типы абонентского и операторского оборудования

Необходим хотя бы один тип абонентского оборудования (точки оказания услуги).

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

Столбец	Описание
ID	Идентификатор типа оборудования.
NAME	Наименование типа оборудования.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Оконечное оборудование, ТВ-приставка, Eltex LTP-8X.

Anchor

	firms
	firms

FIRMS — фирмы

Оставьте таблицу пустой, если в вашей Гидре всего одна фирма.

...

Примеры: Оффлайн Телеком, Cloud Express.

Anchor

	network_services
	network_services

NETWORK_SERVICES — сетевые службы

Необходим хотя бы личный кабинет абонента.

Столбец	Описание
ID	Идентификатор службы.
NAME	Наименование службы.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Личный кабинет, PPPoE, SIP-телефония, Смотрёшка, SMS-уведомления.

Anchor

	payment_types
	payment_types

PAYMENT_TYPES — типы платежей

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

...

Примеры: Наличные (реальный), Платёжная система (реальный), Перерасчёт (виртуальный), Бонусы (виртуальный).

Anchor

	phone_types
	phone_types

PHONE_TYPES — виды телефонов физлиц и юрлиц

Оставьте таблицу пустой, если не выгружаете контактные телефонные номера физлиц и юрлиц в отдельную таблицу CUSTOMER_PHONES.

Столбец	Описание
ID	Идентификатор вида телефонов.
NAME	Наименование вида телефонов.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Мобильный, Домашний, Для уведомлений, Рабочий.

Anchor

	products
	products

PRODUCTS — тарифные планы, услуги и корректировки

Необходимы хотя бы текущие тарифные планы и периодические услуги абонентов, если не выгружаете историю начислений.

Столбец	Источник значений	Описание
ID		Идентификатор услуги.
NAME		Наименование услуги.
TYPE		Y для тарифных планов, N — для всего остального.
UNIT_ID	UNITS.ID	Идентификатор единицы измерения для услуг с количеством из таблицы UNITS. Должна соответствовать единице измерения услуги в номенклатуре Гидры. Если в номенклатуре единица не задана (прочерк), оставляйте поле пустым.
REMARK		Примечание для правильного выбора соответствия.

...

Примеры: Безлимитный Космос (тарифный план), Аренда ТВ-приставки (услуга), Перерасчёт (корректировка).

Anchor

	provider_equipment
	provider_equipment

PROVIDER_EQUIPMENT — операторское оборудование

Оставьте таблицу пустой, если не выгружаете его связи абонентского оборудования с операторским для технического учёта или управления доступом (например IPoE с DHCP Option 82).

Столбец	Источник значений	Описание
ID		Идентификатор оборудования.
EQUIPMENT_TYPE_ID	EQUIPMENT_TYPES.ID	Идентификатор типа оборудования.
CODE		Код оборудования.
IP		Фактический IPv4 адрес оборудования. Может использоваться для автоматического сопоставления вместо кода.
FIRM_ID	FIRMS.ID	Идентификатор фирмы для многофилиальной Гидры.
REMARK		Примечание для правильного выбора соответствия.

...

Примеры: olt-ш.Космонавтов-д25, switch-T3KZ1C7001304.

Anchor

	street_address_purposes
	street_address_purposes

STREET_ADDRESS_PURPOSES — виды обычных адресов физлиц, юрлиц и абонентского оборудования

Оставьте таблицу пустой, если не выгружаете адреса в отдельные таблицы CUSTOMER_STREET_ADDRESSES и EQUIPMENT_STREET_ADDRESSES.

Столбец	Описание
ID	Идентификатор вида адреса.
NAME	Наименование вида адреса.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: Фактический адрес, Адрес постоянной регистрации, Юридический адрес, Адрес обслуживания.

Anchor

	units
	units

UNITS — единицы измерения количества услуг

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

Столбец	Описание
ID	Идентификатор единицы измерения.
NAME	Наименование единицы измерения.
REMARK	Примечание для правильного выбора соответствия.

...

Примеры: штука, метр, мегабайт, минута, мегабит в секунду.

Anchor

	data-tables
	data-tables

Мигрируемые данные абонентов

...

Info

Если описанной промежуточной схемы недостаточно для переноса в Гидру всех необходимых данных, по согласованию с ответственным за миграцию инженером Латеры в выгрузку могут быть добавлены как дополнительные столбцы в стандартные таблицы, так и дополнительные таблицы.

Anchor

	customers
	customers

CUSTOMERS — абоненты и базовые субъекты

...

Столбец	Источник значений	Описание
ID		Идентификатор абонента (базового субъекта, если выгружаются раздельно).
STATUS_ID	CUSTOMER_STATUSES.ID	Идентификатор состояния абонента. Базовые субъекты всегда создаются в состоянии Активен.
PARENT_ID	CUSTOMERS.ID	Идентификатор базового субъекта при раздельной выгрузке. Оставьте пустым для автоматического формирования базовых субъектов и привязки к ним абонентов.
CODE		Код абонента — уникальное краткое наименование, идентифицирующее абонента. Является логином по умолчанию для ЛК и сетевых служб.
ORGANIZATION		Y для юридических лиц, N — для физических.
NAME		Имя физлица или наименование юрлица.
SECOND_NAME		Отчество физлица, оставьте пустым для юрлица.
SURNAME		Фамилия физлица, оставьте пустым для юрлица.
ADDRESS		Фактический адрес физического или юридического лица в формате `<Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира>,<Код домофона>` Если каких-то данных не хватает, оставьте только запятые, например: `Самара г.,Пролетарская ул.,5,,,78,к78#234` Номер дома может быть дополнен номером корпуса: `Самара г.,Пролетарская ул.,5 корп. 7,,,78,к78#234` Оставьте пустым, если выгружаете эти адреса в отдельную таблицу CUSTOMER_STREET_ADDRESSES.
ADDRESS_REMARK		Примечание к фактическому адресу. Оставьте пустым, если выгружаете эти адреса в отдельную таблицу CUSTOMER_STREET_ADDRESSES.
AUTH_DOC_TYPE_ID	AUTH_DOC_TYPES.ID	Тип документа-удостоверения личности физлица, оставьте пустым для юрлица.
AUTH_DOC_SERIAL		Серия документа физлица, оставьте пустым для юрлица.
AUTH_DOC_NUMBER		Номер документа физлица, оставьте пустым для юрлица.
AUTH_DOC_DATE		Дата выдачи документа физлица в формате ДД.ММ.ГГГГ, оставьте пустым для юрлица.
AUTH_DOC_ISSUING_AUTHORITY		Кем выдан документ физлица, оставьте пустым для юрлица.
BIRTH_DATE		Дата рождения физлица в формате ДД.ММ.ГГГГ, оставьте пустым для юрлица.
BIRTH_PLACE		Место рождения физлица, оставьте пустым для юрлица.
TAX_ID_NUMBER		Идентификационный номер налогоплательщика (ИНН).
LEGAL_FORM_CODE		Код или наименование организационно-правовой формы. Например: ИП или Индивидуальный предприниматель, ООО или Общество с ограниченной ответственностью. Все значения должны быть указаны в Гидре: Справочники → Базовые → Организационно-правовые формы предприятий. Оставьте пустым для обычных абонентов-физлиц, не являющихся предпринимателями или нотариусами.
W_PHONE		Контактный рабочий телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры.Можно указать несколько номеров, разделив их запятыми. Оставьте пустым, если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.
H_PHONE		Контактный домашний телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми. Оставьте пустым для юрлица или если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.
M_PHONE		Контактный мобильный телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми. Оставьте пустым, если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.
EMAIL		Контактный адрес электронной почты. Можно указать несколько адресов, разделив их запятыми.
FIRM_ID	FIRMS.ID	Идентификатор фирмы для многофилиальной Гидры. Оставьте пустым, если в вашей Гидре всего одна фирма.
REMARK		Краткое примечание к абоненту (или к базовому субъекту при раздельной выгрузке).

Anchor

	customer_group_binds
	customer_group_binds

CUSTOMER_GROUP_BINDS — участие абонентов в группах

...

Столбец	Источник значений	Описание
ID		Идентификатор привязки к группе.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента.
GROUP_ID	CUSTOMER_GROUPS.ID	Идентификатор группы.
PRIMARY		Y для главной группы, N — для дополнительных. Главная группа у каждого абонента должна быть только одна.
REMARK		В текущей версии не используется, оставьте пустым.

Anchor

	customer_comments
	customer_comments

CUSTOMER_COMMENTS — расширенные комментарии к абонентам

...

Столбец	Источник значений	Описание
ID		Идентификатор комментария.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента.
COMMENT_TYPE_ID	COMMENT_TYPES.ID	Тип комментария.
COMMENT_TEXT		Текст комментария. Используйте символ ¶ для разделения строк в тексте.
CREATED_DATE		Дата и время комментария в формате ДД.ММ.ГГГГ чч:мм:сс.
REMINDER_DATE		Дата и время напоминания о комментарии в формате ДД.ММ.ГГГГ чч:мм:сс.
EXECUTION_DATE		Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.

Anchor

	customer_mappings
	customer_mappings

CUSTOMER_MAPPINGS — соответствие выгруженных абонентов уже имеющимся в Гидре

...

Столбец

Источник значений

Описание

CUSTOMER_ID

CUSTOMERS.ID

Идентификатор выгруженного абонента.

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

CUSTOMER_DST_CODE

Код целевого абонента в Гидре, которому необходимо добавить выгруженные счета, договоры, оборудование и подписки.

REMARK

В текущей версии не используется, оставьте пустым.

Anchor

	customer_phones
	customer_phones

CUSTOMER_PHONES — контактные телефоны физлиц и юрлиц

...

Если примечания не нужны и достаточно стандартных видов: Рабочий, Домашний и Мобильный — оставьте эту таблицу пустой и заполните столбцы W_PHONE, H_PHONE и M_PHONE в таблице CUSTOMERS.

Столбец	Источник значений	Описание
ID		Идентификатор телефона.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента. При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта.
PHONE_TYPE_ID	PHONE_TYPES.ID	Идентификатор вида телефона.
PHONE		Номер телефона в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры.
REMARK		Краткое примечание к телефону.

Anchor

	customer_street_addresses
	customer_street_addresses

CUSTOMER_STREET_ADDRESSES — структурированные обычные адреса физлиц и юрлиц

...

Если достаточно одного фактического адреса, оставьте эту таблицу пустой и заполните столбцы ADDRESS и ADDRESS_REMARK в таблице CUSTOMERS.

Столбец	Источник значений	Описание
ID		Идентификатор адреса.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента. При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта.
ADDRESS_PURPOSE_ID	STREET_ADDRESS_PURPOSES.ID	Идентификатор вида адреса.
DISTRICT		Район федерального уровня, в составе которого находится населённый пункт. Тип региона в Гидре — Район с кодом REGION_TYPE_District.
CITY		Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ульяновск.
CITY_TYPE		Полное или краткое наименование типа населённого пункта. Например: г. или Город, пос. или Посёлок. Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
STREET		Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ленина.
STREET_TYPE		Полное или краткое наименование типа улицы. Например: ул. или Улица, наб. или Набережная. Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
HOUSE		Эти четыре столбца совокупно определяют здание: HOUSE — номер дома, BUILDING — корпус, CONSTRUCT — строение, OWNERSHIP — владение. Хотя бы одно из значений должно быть заполнено, иначе адрес не будет мигрирован.
BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE		Подъезд дома.
FLOOR		Номер этажа, должен быть числом.
FLAT		Номер квартиры.
INTERCOM_CODE		Код домофона.
CUSTOM_ADDRESS		Нестандартный адрес, например: третья дверь налево.
REMARK		Краткое примечание к адресу.

Anchor

	accounts
	accounts

ACCOUNTS — cчета абонентов и базовых субъектов

...

Столбец	Источник значений	Описание
ID		Идентификатор лицевого счёта.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента. При раздельной выгрузке абонентов и базовых субъектов для расчётного счёта — идентификатор базового субъекта.
ACCOUNT_NUMBER		Уникальный номер счёта.
ACCOUNT_TYPE_ID	ACCOUNT_TYPES.ID	Идентификатор типа счёта.
CURRENCY_ID	CURRENCIES.ID	Идентификатор валюты.
BANK_ID	BANKS.ID	Идентификатор банка расчётного счёта, оставьте пустым для лицевого счёта.
BALANCE		Баланс лицевого счёта, оставьте пустым для расчётного счёта.
CREDIT		Кредитный лимит лицевого счёта, оставьте пустым если не нужен.
CREDIT_END_DATE		Дата и время окончания кредитного лимита в формате ДД.ММ.ГГГГ чч:мм:сс. Оставьте пустым, если кредитного лимита нет или он постоянный.
BALANCE_DATE		Дата и время расчёта баланса лицевого счёта в формате ДД.ММ.ГГГГ чч:мм:сс. Мигрированный итоговый баланс будет отличаться на разницу платежей из PAYMENTS и начислений из CHARGES, произошедших позже указанной даты.
REMARK		Краткое примечание к счёту.

Anchor

	contracts
	contracts

CONTRACTS — договоры на оказание услуг

...

Столбец	Источник значений	Описание
ID		Идентификатор договора.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента.
CONTRACT_NUMBER		Уникальный номер договора.
SIGNATURE_DATE		Дата заключения договора в формате ДД.ММ.ГГГГ.
START_DATE		Дата начала периода действия договора в формате ДД.ММ.ГГГГ. Обычно совпадает с датой заключения.
END_DATE		Дата окончания периода действия (расторжения) договора в формате ДД.ММ.ГГГГ. Для текущих договоров обычно отсутствует: договор действует бессрочно.
REMARK		Краткое примечание к договору.

Anchor

	equipment
	equipment

EQUIPMENT — абонентское оборудование (точки оказания услуг)

...

Столбец	Источник значений	Описание
ID		Идентификатор оборудования.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента.
EQUIPMENT_TYPE_ID	EQUIPMENT_TYPES.ID	Идентификатор типа оборудования.
PROVIDER_EQUIPMENT_ID	PROVIDER_EQUIPMENT.ID	Идентификатор операторского оборудования (например коммутатора или OLT), к которому должно быть привязано абонентское. Оставьте пустым, если привязка не требуется.
PROVIDER_EQUIPMENT_PORT_CODE		Код компонента (номер порта) операторского оборудования. Оставьте пустым, если привязка нужна к самому оборудованию, а не к его компоненту.
PROVIDER_EQUIPMENT_PORT_TYPE		Код типа компонента операторского оборудования (позиции спецификации типа этого оборудования). Оставьте пустым, если у оборудования коды компонентов уникальны.
CODE		Уникальный код (краткое наименование) оборудования.
MAC		Физический адрес (MAC) абонентского оборудования в формате XX-XX-XX-XX-XX-XX или XX:XX:XX:XX:XX:XX. Должен быть индивидуальным (юникастовым). Можно указать несколько адресов, разделив их запятыми.
IP		IPv4 адрес (например 128.66.125.125) или IPv4-подсеть в CIDR-нотации (например 128.66.25.48/29). Можно указать несколько адресов и подсетей, разделив их запятыми.
IP6		IPv6 подсеть (например 2001:db8:7df5::/64). Можно указать несколько подсетей, разделив их запятыми.
PHONE		Номер телефона, по которому необходимо тарифицировать звонки, в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Например: 78122128506. Можно указать несколько номеров, разделив их запятыми.
VLAN		В текущей версии не используется, оставьте пустым.
ADDRESS		Адрес обслуживания в формате `<Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира>,<Код домофона>` Если каких-то данных не хватает, оставьте только запятые, например: `Самара г.,Пролетарская ул.,5,,,78,к78#234` Номер дома может быть дополнен номером корпуса: `Самара г.,Пролетарская ул.,5 корп. 7,,,78,к78#234` Оставьте пустым, если выгружаете эти адреса в отдельную таблицу EQUIPMENT_STREET_ADDRESSES.
ADDRESS_REMARK		Примечание к адресу обслуживания. Оставьте пустым, если выгружаете эти адреса в отдельную таблицу EQUIPMENT_STREET_ADDRESSES.
REMARK		Краткое примечание к оборудованию.

Anchor

	equipment_comments
	equipment_comments

EQUIPMENT_COMMENTS — расширенные комментарии к абонентскому оборудованию

...

Столбец	Источник значений	Описание
ID		Идентификатор комментария.
EQUIPMENT_ID	EQUIPMENT.ID	Идентификатор абонентского оборудования.
COMMENT_TYPE_ID	COMMENT_TYPES.ID	Тип комментария.
COMMENT_TEXT		Текст комментария. Используйте символ ¶ для разделения строк в тексте.
CREATED_DATE		Дата и время комментария в формате ДД.ММ.ГГГГ чч:мм:сс.
REMINDER_DATE		Дата и время напоминания о комментарии в формате ДД.ММ.ГГГГ чч:мм:сс.
EXECUTION_DATE		Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.

Anchor

	equipment_street_addresses
	equipment_street_addresses

EQUIPMENT_STREET_ADDRESSES — структурированные обычные адреса абонентского оборудования

...

Если достаточно одного адреса обслуживания, оставьте эту таблицу пустой и заполните столбцы ADDRESS и ADDRESS_REMARK в таблице EQUIPMENT.

Столбец	Источник значений	Описание
ID		Идентификатор адреса.
EQUIPMENT_ID	EQUIPMENT.ID	Идентификатор абонентского оборудования (точки оказания услуги).
ADDRESS_PURPOSE_ID	STREET_ADDRESS_PURPOSES.ID	Идентификатор вида адреса.
DISTRICT		Район федерального уровня, в составе которого находится населённый пункт. Тип региона в Гидре — Район с кодом REGION_TYPE_District.
CITY		Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ульяновск.
CITY_TYPE		Полное или краткое наименование типа населённого пункта. Например: г. или Город, пос. или Посёлок. Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
STREET		Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ленина.
STREET_TYPE		Полное или краткое наименование типа улицы. Например: ул. или Улица, наб. или Набережная. Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона.
HOUSE		Эти четыре столбца совокупно определяют здание: HOUSE — номер дома, BUILDING — корпус, CONSTRUCT — строение, OWNERSHIP — владение. Хотя бы одно из значений должно быть заполнено, иначе адрес не будет мигрирован.
BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE		Подъезд дома.
FLOOR		Номер этажа, должен быть числом.
FLAT		Номер квартиры.
INTERCOM_CODE		Код домофона.
CUSTOM_ADDRESS		Нестандартный адрес, например: третья дверь налево.
REMARK		Краткое примечание к адресу.

Anchor

	customer_net_service_binds
	customer_net_service_binds

CUSTOMER_NET_SERVICE_BINDS — доступы к ЛК и подписки на сетевые службы

...

Столбец	Источник значений	Описание
ID		Идентификатор подписки.
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор абонента.
NETWORK_SERVICE_ID	NETWORK_SERVICES.ID	Идентификатор сетевой службы.
EQUIPMENT_ID	EQUIPMENT.ID	Идентификатор абонентского оборудования. Оставьте пустым для доступа в личный кабинет и подписок на службы уведомлений. Обязательно заполните для подписок на управляемые Гидрой внешние службы (например PPPoE или Смотрёшка).
LOGIN		Логин (имя пользователя). Должен быть уникален в пределах службы (приложения). Оставьте пустым, если логин не требуется, например для подписки на уведомления.
PASSWORD		Пароль открытым текстом. В тестовых выгрузках для безопасности можете для всех указать одинаковое значение. Оставьте пустым, если пароль для службы не требуется, например для подписки на уведомления.
PASSWORD_HASH_TYPE		В текущей версии не используется, оставьте пустым.
REMARK		В текущей версии не используется, оставьте пустым.

Anchor

	subscriptions
	subscriptions

SUBSCRIPTIONS — подписки абонентов на периодические услуги

...

Столбец	Источник значений	Описание
ID		Идентификатор подписки.
ACCOUNT_ID	ACCOUNTS.ID	Идентификатор лицевого счёта.
CONTRACT_ID	CONTRACTS.ID	Идентификатор договора на оказание услуг.
PRODUCT_ID	PRODUCTS.ID	Идентификатор услуги (тарифного плана). В подписках могут участвовать только периодические услуги.
EQUIPMENT_ID	EQUIPMENT.ID	Идентификатор абонентского оборудования — точки оказания услуги. Необходимо указывать для всех услуг, управляемых Гидрой. Рекомендуется указывать оборудование и для неуправляемых услуг, чтобы хотя бы была привязка услуги к адресу обслуживания, но можно для них оставить пустым.
START_DATE		Дата и время начала подписки в формате ДД.ММ.ГГГГ чч:мм:сс — когда абонент заказал данную услугу или тарифных план.
END_DATE		Дата и время окончания подписки в формате ДД.ММ.ГГГГ чч:мм:сс — когда оказание услуги должно завершиться. Оставьте пустым для текущих услуг — они будут оказываться бессрочно. Если в будущем запланирована смена тарифного плана: в подписке на старый тарифный план укажите дату и время его окончания, а в подписке на новый — только дату и время начала (на секунду больше окончания старого).
QUANTITY		Количество заказанной услуги в единице измерения PRODUCTS.UNIT_ID. Является множителем к её цене: например для аренды двух телефонных линий по 100 ₽ укажите 2 — тогда абонентская плата составит 2 × 100 ₽ = 200 ₽. Оставьте пустым для тарифных планов (пакетов услуг) и услуг без единицы измерения.
BILLING_DATE		Фиксированный расчётный день месяца — натуральное число от 1 до 28. Для абонентов-юрлиц как правило 1 — расчётные периоды строго привязаны к календарным месяцам. Оставьте пустым, если расчётный день должен быть плавающим: этот режим как правило используется для абонентов-физлиц.
REMARK		В текущей версии не используется, оставьте пустым.

Anchor

	charges
	charges

CHARGES — история начислений и текущие расчётные периоды

Note

Заполнение данной таблицы не является критичным для миграции, но как правило в ней ожидаются хотя бы текущие расчётные периоды абонентов по всем услугам.

Для корректного формирования актуальных актов начислений необходимо наличие подписок на услуги в таблице SUBSCRIPTIONS: с теми же лицевым счётом, договором, услугой, оборудованием и с подходящим периодом действия.

Если выгрузить эти данные невозможно, обязательно обсудите варианты выставления первых актов начислений в Гидре с ответственным за миграцию инженером Латеры. По умолчанию Гидра при запуске периодических заданий после миграции начнёт оказание услуг на основании подписок с текущего момента.

...

Столбец	Источник значений	Описание
ID		Идентификатор начисления.
ACCOUNT_ID	ACCOUNTS.ID	Идентификатор лицевого счёта.
CONTRACT_ID	CONTRACTS.ID	Идентификатор договора на оказание услуг.
CHARGE_DATE		Дата и время начисления (списания средств с ЛС) в формате ДД.ММ.ГГГГ чч:мм:сс. При миграции будет сопоставлена с ACCOUNTS.BALANCE_DATE для определения итогового баланса лицевого счёта. Как правило совпадает с датой начала или окончания расчётного периода, но не должна выходить за пределы этого периода.
PRODUCT_ID	PRODUCTS.ID	Идентификатор услуги, тарифного плана или корректировки баланса.
EQUIPMENT_ID	EQUIPMENT.ID	Идентификатор абонентского оборудования. Для текущих расчётных периодов должен совпадать с указанным для этой услуги в SUBSCRIPTIONS.EQUIPMENT_ID. Можете оставить пустым для истории начислений, если нет необходимости привязывать её к конкретным точкам оказания услуг.
AMOUNT		Полная сумма (не цена) начисления по услуге в валюте лицевого счёта за весь расчётный период, умноженная на 100. Для корректировок баланса допустимы отрицательные значения, увеличивающие баланс лицевого счёта, — возвраты средств.
CHARGING_PERIOD_START_DATE		Дата и время начала расчётного периода в формате ДД.ММ.ГГГГ чч:мм:сс. Время для обычных периодических услуг, как правило, указывается 00:00:00 — полночь. Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE.
CHARGING_PERIOD_END_DATE		Дата и время окончания расчётного периода в формате ДД.ММ.ГГГГ чч:мм:сс. Время для обычных периодических услуг, как правило, указывается 23:59:59 — последняя секунда. Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE.
QUANTITY		Количество оказанной услуги в единице измерения PRODUCTS.UNIT_ID, умноженное на 100. Оставьте пустым для тарифных планов (пакетов услуг) и услуг без единицы измерения.
REMARK		Краткое примечание к начислению.

Anchor

	payments
	payments

PAYMENTS — история платежей

...

Столбец	Источник значений	Описание
ID		Идентификатор платежа.
ACCOUNT_ID	ACCOUNTS.ID	Идентификатор лицевого счёта.
BANK_ID	BANKS.ID	Идентификатор банка — источника платежа.
TRANSACTION_DATE		Дата и время платежа в формате ДД.ММ.ГГГГ чч:мм:сс. При миграции будет сопоставлена с ACCOUNTS.BALANCE_DATE для определения итогового баланса лицевого счёта.
PAYMENT_AMOUNT		Сумма платежа в валюте лицевого счёта, умноженная на 100.
PAYMENT_TYPE_ID	PAYMENT_TYPES.ID	Идентификатор типа платежа. Оставьте пустым, если выгружаете только реальные платежи и их не нужно разделять по типам — будет использован тип по умолчанию из настроек миграции.
REMARK		Краткое примечание к платежу.

...

Page tree

Versions Compared

Old Version 18

New Version 19

Key

Сопоставляемые справочники

ACCOUNT_TYPES — типы счетов

AUTH_DOC_TYPES — типы документов, удостоверяющих личность

BANKS — банки счетов и источники платежей

COMMENT_TYPES — типы комментариев

CURRENCIES — валюты счетов

CUSTOMER_GROUPS — группы абонентов

CUSTOMER_STATUSES — состояния абонентов

EQUIPMENT_TYPES — типы абонентского и операторского оборудования

FIRMS — фирмы

NETWORK_SERVICES — сетевые службы

PAYMENT_TYPES — типы платежей

PHONE_TYPES — виды телефонов физлиц и юрлиц

PRODUCTS — тарифные планы, услуги и корректировки

PROVIDER_EQUIPMENT — операторское оборудование

STREET_ADDRESS_PURPOSES — виды обычных адресов физлиц, юрлиц и абонентского оборудования

UNITS — единицы измерения количества услуг

Мигрируемые данные абонентов

CUSTOMERS — абоненты и базовые субъекты

CUSTOMER_GROUP_BINDS — участие абонентов в группах

CUSTOMER_COMMENTS — расширенные комментарии к абонентам

CUSTOMER_MAPPINGS — соответствие выгруженных абонентов уже имеющимся в Гидре

CUSTOMER_PHONES — контактные телефоны физлиц и юрлиц

CUSTOMER_STREET_ADDRESSES — структурированные обычные адреса физлиц и юрлиц

ACCOUNTS — cчета абонентов и базовых субъектов

CONTRACTS — договоры на оказание услуг

EQUIPMENT — абонентское оборудование (точки оказания услуг)

EQUIPMENT_COMMENTS — расширенные комментарии к абонентскому оборудованию

EQUIPMENT_STREET_ADDRESSES — структурированные обычные адреса абонентского оборудования

CUSTOMER_NET_SERVICE_BINDS — доступы к ЛК и подписки на сетевые службы

SUBSCRIPTIONS — подписки абонентов на периодические услуги

CHARGES — история начислений и текущие расчётные периоды

PAYMENTS — история платежей