Общие сведения
Миграция абонентов в Гидру из других биллинговых систем (АСР) выполняется через промежуточный набор таблиц, представленных файлами формата 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. В таком случае время считается равным полуночи.
Примеры
Архив с полным набором файлов, содержащими только заголовочные строки без данных:
Используйте данный архив в качестве основы для формирования выгрузки
Образец содержимого файла 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";"Открыт при заключении договора.¶Списание бонусов производить только по согласованию с Фёдором Сумкиным."
Архив с упрощённой выгрузкой, включающей только базовый набор данных:
Архив с расширенной выгрузкой, включающей дополнительные таблицы и поля:
Упрощения и допущения процесса миграции
- Юридические и физические лица находятся в единой таблице 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 | ||
NAME |
| |
SECOND_NAME |
| |
SURNAME |
| |
ADDRESS | Фактический адрес физического или юридического лица в формате Если каких-то данных не хватает, оставьте только запятые, например: Номер дома может быть дополнен номером корпуса:
| |
ADDRESS_REMARK | Примечание к фактическому адресу.
| |
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: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.
| |
H_PHONE | Контактный домашний телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.
| |
M_PHONE | Контактный мобильный телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.
| |
| ||
FIRM_ID | FIRMS.ID | Идентификатор фирмы для многофилиальной Гидры.
|
REMARK |
CUSTOMER_GROUP_BINDS — участие абонентов в группах
Каждый абонент должен входить хотя бы в одну группу.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID | |
GROUP_ID | CUSTOMER_GROUPS.ID | |
PRIMARY |
Главная группа у каждого абонента должна быть только одна. | |
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 | ||
REMARK |
CUSTOMER_STREET_ADDRESSES — структурированные обычные адреса физлиц и юрлиц
Расширенный вариант привязки к базовым субъектам множества адресов с различными видами (предназначением).
Если достаточно одного фактического адреса, оставьте эту таблицу пустой и заполните столбцы ADDRESS и ADDRESS_REMARK в таблице CUSTOMERS.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
CUSTOMER_ID | CUSTOMERS.ID |
При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта. |
ADDRESS_PURPOSE_ID | STREET_ADDRESS_PURPOSES.ID | |
DISTRICT | ||
CITY | ||
CITY_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
STREET | ||
STREET_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
HOUSE | Эти четыре столбца совокупно определяют здание:
| |
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 |
Оставьте пустым, если привязка не требуется. |
PROVIDER_EQUIPMENT_PORT_CODE |
Оставьте пустым, если привязка нужна к самому оборудованию, а не к его компоненту. | |
PROVIDER_EQUIPMENT_PORT_TYPE |
Оставьте пустым, если у оборудования коды компонентов уникальны. | |
CODE | ||
MAC |
Можно указать несколько адресов, разделив их запятыми. | |
IP |
Можно указать несколько адресов и подсетей, разделив их запятыми. | |
IP6 |
Можно указать несколько подсетей, разделив их запятыми. | |
PHONE |
Можно указать несколько номеров, разделив их запятыми. | |
VLAN | ||
ADDRESS | Адрес обслуживания в формате Если каких-то данных не хватает, оставьте только запятые, например: Номер дома может быть дополнен номером корпуса:
| |
ADDRESS_REMARK | Примечание к адресу обслуживания.
| |
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 | ||
CITY | ||
CITY_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
STREET | ||
STREET_TYPE | Все значения должны быть указаны в Гидре: Справочники → Базовые → Тип региона. | |
HOUSE | Эти четыре столбца совокупно определяют здание:
| |
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 | Идентификатор абонентского оборудования.
|
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 |
Как правило совпадает с датой начала или окончания расчётного периода, но не должна выходить за пределы этого периода. | |
PRODUCT_ID | PRODUCTS.ID |
|
EQUIPMENT_ID | EQUIPMENT.ID | Идентификатор абонентского оборудования. Для текущих расчётных периодов должен совпадать с указанным для этой услуги в SUBSCRIPTIONS.EQUIPMENT_ID.
|
AMOUNT |
Для корректировок баланса допустимы отрицательные значения, увеличивающие баланс лицевого счёта, — возвраты средств. | |
CHARGING_PERIOD_START_DATE |
Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE. | |
CHARGING_PERIOD_END_DATE |
Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE. | |
QUANTITY | Количество оказанной услуги в единице измерения PRODUCTS.UNIT_ID, умноженное на 100.
| |
REMARK |
PAYMENTS — история платежей
Историю платежей как правило достаточно выгружать с начала текущего года — для возможности формирования финансовых отчётов из одного биллинга.
Столбец | Источник значений | Описание |
---|---|---|
ID | ||
ACCOUNT_ID | ACCOUNTS.ID | |
BANK_ID | BANKS.ID | |
TRANSACTION_DATE | ||
PAYMENT_AMOUNT | ||
PAYMENT_TYPE_ID | PAYMENT_TYPES.ID | Идентификатор типа платежа.
|
REMARK |