Миграция абонентов в Гидру версии 6.2+

Общие сведения

Миграция абонентов в Гидру из других биллинговых систем (АСР) выполняется через промежуточный набор таблиц, представленных файлами формата CSV:

Данные абонентов выгружаются из старого биллинга в формате промежуточной схемы.
Полученные файлы загружаются в приложение миграции.
Выполняются различные автоматизированные проверки корректности и целостности данных.
Производится сопоставление выгруженных записей таблиц-справочников с аналогичными справочниками Гидры.
Выполняются дополнительные автоматизированные проверки корректности данных с учётом справочников.
Осуществляется миграция данных абонентов в Гидру.

Для отладки процесса формирования выгрузки и самой миграции все работы сначала выполняются итеративно на тестовом экземпляре Гидры:

Формируется выгрузка и выполняется пробная миграция на тестовую Гидру
Выполняется совместная проверка результатов пробной миграции:
- Сверка совокупных показателей по отчётам;
- Выборочная сверка отдельных абонентов с исходными данными в старом биллинге;
- Выявление недостающих биллинговых или технических реквизитов абонентов для интеграций Гидры с внешними системами и управления доступом к услугам.
- Обнаружение несоответствия настроенных в Гидре тарифных планов и услуг: цен, параметров схем оказания, ассортимента доступных услуги для той или иной группы абонентов.
Устраняется как можно больше расхождений и ошибок данных:
- Исправляются данные в старом биллинге;
- Корректируются скрипты формирования выгрузки;
- Исправляются и дополняются тарифные планы и услуги в основном экземпляре Гидры;
- Меняются настройки миграции.
Тестовый экземпляр Гидры перезагружается снимком данных с основного, формируется новая выгрузка данных из старого биллинга и процесс повторяется.
Когда результат пробной миграции признаётся качественным и достаточным для запуска в эксплуатацию, процесс повторяется на основном экземпляре Гидры.

Формат данных

Каждая таблица выгружается в отдельный CSV-файл, имя которого совпадает с названием таблицы.
Для текста используется кодировка UTF-8.
Поля (столбцы) разделяются точкой с запятой — ;
Значения полей обрамляются двойными кавычками — "
В первой строке указываются названия полей таблицы.
Символы переноса строк (LF, \n) в значениях полей не допускаются.
- Если перенос строки в значении необходим (например для комментария в столбце REMARK), он должен быть представлен уникальным символом, например ¶ (знак абзаца).
Первичные ключи (поля ID) и внешние ключи (поля *_ID) — натуральные (целые положительные) числа.
Все файлы выгрузки упаковываются в ZIP-архив.
- В архиве должны содержаться только CSV-файлы выгрузки, без директорий и посторонних файлов.
- В архиве должны присутствовать файлы всех таблиц промежуточной схемы. Необязательность таблиц относится только к их заполнению, но файл с заголовочной строкой должен быть всегда.
Для значений с типом Дата и Дата с временем (поля *_DATE кроме BILLING_DATE) допускается два формата:
- С указанием времени: ДД.ММ.ГГГГ чч:мм:сс (в Oracle — DD.MM.YYYY HH24:MI:SS), например 12.04.1961 09:07:00. Время может быть указано без минут или секунд: отсутствующие данные считаются равными нулю.
- Без указания времени: ДД.ММ.ГГГГ (в Oracle — DD.MM.YYYY), например 12.04.1961. В таком случае время считается равным полуночи.

Примеры

Архив с полным набором файлов, содержащими только заголовочные строки без данных:
headers_only.zip

Используйте данный архив в качестве основы для формирования выгрузки

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

"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";"Открыт при заключении договора.¶Списание бонусов производить только по согласованию с Фёдором Сумкиным."

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

Упрощения и допущения процесса миграции

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

Таблицы промежуточной схемы данных

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

Столбцы ID — это первичные ключи таблиц: их значения должен быть уникальны в пределах таблицы.
Столбцы *_ID — это внешние ключи таблиц, ссылки на записи других таблиц. Контролируйте их целостность:
- В выгрузке не должно быть ссылок на несуществующие записи.
  Например в таблице CONTRACTS не должно быть договоров для отсутствующих в CUSTOMERS абонентов: если отдельный абонент по каким-то причинам исключён из выгрузки, то по нему не должно быть данных в других таблицах.
- Ссылки в одной записи не должны противоречить друг другу.
  Например в таблице SUBSCRIPTIONS для подписки на услуги обязательно должны быть заполнены ссылки на договор (столбец CONTRACT_ID) и лицевой счёт (столбец ACCOUNT_ID) — эти договор и лицевой счёт должны принадлежать одному абоненту.

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

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

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

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

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

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

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

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

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

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

В Гидре: Справочники → Базовые → Типы счетов.

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

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

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

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

В Гидре: Справочники → Базовые → Тип удостоверения личности.

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

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

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

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

В Гидре: Справочники → Банки.

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

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

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

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

В Гидре: Справочники → Базовые → Типы комментариев.

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

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

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

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

В Гидре: Справочники → Базовые → Справочник валют.

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

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

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

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

В Гидре: Справочники → Группы → Абонент.

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

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

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

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

В Гидре: Справочники → Абоненты → Состояние.

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

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

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

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

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

В Гидре: Справочники → Номенклатура → ТМЦ.

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

FIRMS — фирмы

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

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

В Гидре: Справочники → Организационная структура.

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

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

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

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

В Гидре: Оборудование → Сетевые службы.

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

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

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

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

В Гидре:

Справочники → Базовые → Виртуальные платежи.
Справочники → Базовые → Реальные платежи.

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

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

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

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

В Гидре: Справочники → Базовые → Вид адреса.

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

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

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

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

В Гидре:

Справочники → Номенклатура → Пакеты услуг.
Справочники → Номенклатура → Услуги.
Справочники → Номенклатура → Корректировки.

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

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.

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

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

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

В Гидре: Справочники → Базовые → Вид адреса.

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

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

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

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

В Гидре:

Справочники → Базовые → Единица измерения количества.
Справочники → Базовые → Единицы измерения времени.
Справочники → Базовые → Единицы измерения данных.
Справочники → Базовые → Единицы измерения скорости передачи данных.

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

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

Данные из этих таблиц используются при миграции для создания сущностей соответствующего вида.

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

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

Основная таблица, с которой связаны так или иначе все остальные.

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

Столбец	Источник значений	Описание
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		Краткое примечание к абоненту (или к базовому субъекту при раздельной выгрузке).

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

Каждый абонент должен входить хотя бы в одну группу.

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

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

Множественные заметки к абонентам с разделением по типам, в Гидре будут доступны во вкладке Комментарии страницы абонента.

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

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

Заполняется только для «домиграции» дополнительных данных в состав ранее созданных абонентов.

Столбец

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

Описание

CUSTOMER_ID

CUSTOMERS.ID

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

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

CUSTOMER_DST_CODE

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

REMARK

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

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

Расширенный вариант привязки контактных номеров с различными видами (предназначением) и примечаниями.

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

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

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		Краткое примечание к адресу.

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		Краткое примечание к счёту.

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

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

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

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		Краткое примечание к оборудованию.

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

Множественные заметки к абонентскому оборудованию (точке оказания услуги) с разделением по типам, в Гидре будут доступны во вкладке Комментарии этого оборудования.

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

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		Краткое примечание к адресу.

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		В текущей версии не используется, оставьте пустым.

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		В текущей версии не используется, оставьте пустым.

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

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

Для корректного формирования актуальных актов начислений необходимо наличие подписок на услуги в таблице 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		Краткое примечание к начислению.

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

Миграция абонентов в Гидру версии 6.2+

Общие сведения

Формат данных

Примеры

Упрощения и допущения процесса миграции

Таблицы промежуточной схемы данных

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

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 — история платежей