Документация по АСР «Гидра»
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

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

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

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

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

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

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

  • Каждая таблица выгружается в отдельный 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

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

  • Образец содержимого файла 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) — эти договор и лицевой счёт должны принадлежать одному абоненту.


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

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

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

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

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

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

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

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

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

Столбец

Описание

ID

Идентификатор типа счёта

NAME

Наименование типа счёта

REMARKПримечание для правильного выбора соответствия

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

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

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

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

Столбец

Описание

ID

Идентификатор типа документа

NAME

Наименование типа документа

REMARKПримечание для правильного выбора соответствия

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

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

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

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

Столбец

Описание

ID

Идентификатор банка.

NAME

Наименование банка.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор типа комментариев.

NAME

Наименование типа комментариев.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор валюты.

NAME

Наименование валюты.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор группы.

NAME

Наименование группы.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор состояния.

NAME

Наименование состояния.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

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

Столбец

Описание

ID

Идентификатор типа оборудования.

NAME

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

REMARKПримечание для правильного выбора соответствия.

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

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

FIRMS — фирмы

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

Столбец

Описание

ID

Идентификатор фирмы.

NAME

Наименование фирмы.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

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

NAME

Наименование службы.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор типа платежей.

NAME

Наименование типа платежей.

VIRTUALY для виртуальных платежей и N — для реальных.
REMARKПримечание для правильного выбора соответствия.

В Гидре:

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

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

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

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

Столбец

Описание

ID

Идентификатор вида телефонов.

NAME

Наименование вида телефонов.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

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

Описание

ID


Идентификатор услуги.

NAME


Наименование услуги.

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

В Гидре:

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

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

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

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

Столбец

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

Описание

ID


Идентификатор оборудования.

EQUIPMENT_TYPE_IDEQUIPMENT_TYPES.IDИдентификатор типа оборудования.

CODE


Код оборудования.

IP
Фактический IPv4 адрес оборудования. Может использоваться для автоматического сопоставления вместо кода.
FIRM_IDFIRMS.IDИдентификатор фирмы для многофилиальной Гидры.
REMARK
Примечание для правильного выбора соответствия.

В Гидре: Оборудование → Активное оборудование.

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

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

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

Столбец

Описание

ID

Идентификатор вида адреса.

NAME

Наименование вида адреса.

REMARKПримечание для правильного выбора соответствия.

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

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

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

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

Столбец

Описание

ID

Идентификатор единицы измерения.

NAME

Наименование единицы измерения.

REMARKПримечание для правильного выбора соответствия.

В Гидре:

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

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

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

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

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

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

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

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

СтолбецИсточник значенийОписание

ID


(warning) Идентификатор абонента (базового субъекта, если выгружаются раздельно).

STATUS_ID

CUSTOMER_STATUSES.ID

(warning) Идентификатор состояния абонента. Базовые субъекты всегда создаются в состоянии Активен.

PARENT_IDCUSTOMERS.ID

Идентификатор базового субъекта при раздельной выгрузке.

(green star) Оставьте пустым для автоматического формирования базовых субъектов и привязки к ним абонентов.

CODE


(warning) Код абонента — уникальное краткое наименование, идентифицирующее абонента. Является логином по умолчанию для ЛК и сетевых служб.

ORGANIZATION


(warning) Y для юридических лиц, N — для физических.

NAME


(warning) Имя физлица или наименование юрлица.

SECOND_NAME

(green star) Отчество физлица, оставьте пустым для юрлица.

SURNAME

(green star) Фамилия физлица, оставьте пустым для юрлица.

ADDRESS


Фактический адрес физического или юридического лица в формате <Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира>,<Код домофона>

Если каких-то данных не хватает, оставьте только запятые, например: Самара г.,Пролетарская ул.,5,,,78,к78#234

Номер дома может быть дополнен номером корпуса: Самара г.,Пролетарская ул.,5 корп. 7,,,78,к78#234

(green star) Оставьте пустым, если выгружаете эти адреса в отдельную таблицу CUSTOMER_STREET_ADDRESSES.

ADDRESS_REMARK

Примечание к фактическому адресу.

(green star) Оставьте пустым, если выгружаете эти адреса в отдельную таблицу CUSTOMER_STREET_ADDRESSES.

AUTH_DOC_TYPE_ID

AUTH_DOC_TYPES.ID

(green star) Тип документа-удостоверения личности физлица, оставьте пустым для юрлица.

AUTH_DOC_SERIAL


(green star) Серия документа физлица, оставьте пустым для юрлица.

AUTH_DOC_NUMBER


(green star) Номер документа физлица, оставьте пустым для юрлица.

AUTH_DOC_DATE


(green star) Дата выдачи документа физлица в формате ДД.ММ.ГГГГ, оставьте пустым для юрлица.

AUTH_DOC_ISSUING_AUTHORITY


(green star) Кем выдан документ физлица, оставьте пустым для юрлица.

BIRTH_DATE

(green star) Дата рождения физлица в формате ДД.ММ.ГГГГ, оставьте пустым для юрлица.

BIRTH_PLACE

(green star) Место рождения физлица, оставьте пустым для юрлица.

TAX_ID_NUMBER


(green star) Идентификационный номер налогоплательщика (ИНН).

LEGAL_FORM_CODE


Код или наименование организационно-правовой формы. Например: ИП или Индивидуальный предприниматель, ООО или Общество с ограниченной ответственностью.

Все значения должны быть указаны в Гидре: Справочники → Базовые → Организационно-правовые формы предприятий.

(green star) Оставьте пустым для обычных абонентов-физлиц, не являющихся предпринимателями или нотариусами.

W_PHONE


Контактный рабочий телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.

(green star) Оставьте пустым, если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.

H_PHONE


Контактный домашний телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.

(green star) Оставьте пустым для юрлица или если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.

M_PHONE


Контактный мобильный телефон в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Можно указать несколько номеров, разделив их запятыми.

(green star) Оставьте пустым, если выгружаете телефоны в отдельную таблицу CUSTOMER_PHONES.

EMAIL


(green star) Контактный адрес электронной почты. Можно указать несколько адресов, разделив их запятыми.

FIRM_ID

FIRMS.ID

Идентификатор фирмы для многофилиальной Гидры.

(green star) Оставьте пустым, если в вашей Гидре всего одна фирма.

REMARK
(green star) Краткое примечание к абоненту (или к базовому субъекту при раздельной выгрузке).


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

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор привязки к группе.
CUSTOMER_IDCUSTOMERS.ID(warning) Идентификатор абонента.
GROUP_IDCUSTOMER_GROUPS.ID(warning) Идентификатор группы.
PRIMARY

(warning) Y для главной группы, N — для дополнительных.

Главная группа у каждого абонента должна быть только одна.

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


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

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор комментария.
CUSTOMER_IDCUSTOMERS.ID(warning) Идентификатор абонента.
COMMENT_TYPE_IDCOMMENT_TYPES.ID(warning) Тип комментария.
COMMENT_TEXT

(warning) Текст комментария. Используйте символ ¶ для разделения строк в тексте.

CREATED_DATE
(warning) Дата и время комментария в формате ДД.ММ.ГГГГ чч:мм:сс.
REMINDER_DATE
(green star) Дата и время напоминания о комментарии в формате ДД.ММ.ГГГГ чч:мм:сс.
EXECUTION_DATE
(green star) Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.


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

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

СтолбецИсточник значенийОписание
CUSTOMER_IDCUSTOMERS.ID

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

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

CUSTOMER_DST_CODE
(warning) Код целевого абонента в Гидре, которому необходимо добавить выгруженные счета, договоры, оборудование и подписки.
REMARK
(green star) В текущей версии не используется, оставьте пустым.


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

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

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор телефона.
CUSTOMER_IDCUSTOMERS.ID

(warning) Идентификатор абонента.

При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта.

PHONE_TYPE_IDPHONE_TYPES.ID(warning) Идентификатор вида телефона.
PHONE
(warning) Номер телефона в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры.
REMARK
(green star) Краткое примечание к телефону.


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

(green star) Расширенный вариант привязки к базовым субъектам множества адресов с различными видами (предназначением).

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор адреса.
CUSTOMER_IDCUSTOMERS.ID

(warning) Идентификатор абонента.

При раздельной выгрузке абонентов и базовых субъектов — идентификатор базового субъекта.

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID(warning) Идентификатор вида адреса.
DISTRICT
(green star) Район федерального уровня, в составе которого находится населённый пункт. Тип региона в Гидре — Район с кодом REGION_TYPE_District.
CITY
(warning) Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ульяновск.
CITY_TYPE
(warning) Полное или краткое наименование типа населённого пункта. Например: г. или Город, пос. или Посёлок.

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

STREET
(warning) Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ленина.
STREET_TYPE
(warning) Полное или краткое наименование типа улицы. Например: ул. или Улица, наб. или Набережная.

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

HOUSE

Эти четыре столбца совокупно определяют здание:

  • HOUSE — номер дома,
  • BUILDING — корпус,
  • CONSTRUCT — строение,
  • OWNERSHIP — владение.

(warning) Хотя бы одно из значений должно быть заполнено, иначе адрес не будет мигрирован.

BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE
(green star) Подъезд дома.
FLOOR
(green star) Номер этажа, должен быть числом.
FLAT
(green star) Номер квартиры.
INTERCOM_CODE
(green star) Код домофона.
CUSTOM_ADDRESS
(green star) Нестандартный адрес, например: третья дверь налево.
REMARK
(green star) Краткое примечание к адресу.


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

(warning) У каждого абонента для оказания услуг должен быть хотя бы один лицевой счёт: электронный кошелёк в биллинге, по которому зачисляются платежи и списываются средства за оказание услуг.

СтолбецИсточник значенийОписание

ID


(warning) Идентификатор лицевого счёта.

CUSTOMER_ID

CUSTOMERS.ID

(warning) Идентификатор абонента. При раздельной выгрузке абонентов и базовых субъектов для расчётного счёта — идентификатор базового субъекта.

ACCOUNT_NUMBER


(warning) Уникальный номер счёта.

ACCOUNT_TYPE_ID

ACCOUNT_TYPES.ID

(warning) Идентификатор типа счёта.

CURRENCY_ID

CURRENCIES.ID

(warning) Идентификатор валюты.

BANK_ID

BANKS.ID

(green star) Идентификатор банка расчётного счёта, оставьте пустым для лицевого счёта.

BALANCE


(green star) Баланс лицевого счёта, оставьте пустым для расчётного счёта.

CREDIT


(green star) Кредитный лимит лицевого счёта, оставьте пустым если не нужен.

CREDIT_END_DATE


(green star) Дата и время окончания кредитного лимита в формате ДД.ММ.ГГГГ чч:мм:сс. Оставьте пустым, если кредитного лимита нет или он постоянный.

BALANCE_DATE


(warning) Дата и время расчёта баланса лицевого счёта в формате ДД.ММ.ГГГГ чч:мм:сс.

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

REMARK
(green star) Краткое примечание к счёту.


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

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

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


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

(warning) Абонентское оборудование в Гидре необходимо для учёта адреса оказания услуги, её технических реквизитов и автоматического управления доступом к ней.

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор оборудования.
CUSTOMER_IDCUSTOMERS.ID(warning) Идентификатор абонента.
EQUIPMENT_TYPE_IDEQUIPMENT_TYPES.ID(warning) Идентификатор типа оборудования.
PROVIDER_EQUIPMENT_IDPROVIDER_EQUIPMENT.ID

(green star) Идентификатор операторского оборудования (например коммутатора или OLT), к которому должно быть привязано абонентское.

Оставьте пустым, если привязка не требуется.

PROVIDER_EQUIPMENT_PORT_CODE

(green star) Код компонента (номер порта) операторского оборудования.

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

PROVIDER_EQUIPMENT_PORT_TYPE

(green star) Код типа компонента операторского оборудования (позиции спецификации типа этого оборудования).

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

CODE
(warning) Уникальный код (краткое наименование) оборудования.
MAC

(green star) Физический адрес (MAC) абонентского оборудования в формате XX-XX-XX-XX-XX-XX или XX:XX:XX:XX:XX:XX. Должен быть индивидуальным (юникастовым).

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

IP

(green star) IPv4 адрес (например 128.66.125.125) или IPv4-подсеть в CIDR-нотации (например 128.66.25.48/29).

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

IP6

(green star) IPv6 подсеть (например 2001:db8:7df5::/64).

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

PHONE

(green star) Номер телефона, по которому необходимо тарифицировать звонки, в формате E.164: без пробелов, дефисов, плюса и скобок — только цифры. Например: 78122128506.

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

VLAN
(green star) В текущей версии не используется, оставьте пустым.
ADDRESS

Адрес обслуживания в формате <Город>,<Улица>,<Дом>,<Подъезд>,<Этаж>,<Квартира>,<Код домофона>

Если каких-то данных не хватает, оставьте только запятые, например: Самара г.,Пролетарская ул.,5,,,78,к78#234

Номер дома может быть дополнен номером корпуса: Самара г.,Пролетарская ул.,5 корп. 7,,,78,к78#234

(green star) Оставьте пустым, если выгружаете эти адреса в отдельную таблицу EQUIPMENT_STREET_ADDRESSES.

ADDRESS_REMARK

Примечание к адресу обслуживания.

(green star) Оставьте пустым, если выгружаете эти адреса в отдельную таблицу EQUIPMENT_STREET_ADDRESSES.

REMARK
(green star) Краткое примечание к оборудованию.


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

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор комментария.
EQUIPMENT_IDEQUIPMENT.ID(warning) Идентификатор абонентского оборудования.
COMMENT_TYPE_IDCOMMENT_TYPES.ID(warning) Тип комментария.
COMMENT_TEXT

(warning) Текст комментария. Используйте символ ¶ для разделения строк в тексте.

CREATED_DATE
(warning) Дата и время комментария в формате ДД.ММ.ГГГГ чч:мм:сс.
REMINDER_DATE
(green star) Дата и время напоминания о комментарии в формате ДД.ММ.ГГГГ чч:мм:сс.
EXECUTION_DATE
(green star) Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.


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

(green star) Расширенный вариант привязки к оборудованию множества адресов с различными видами (предназначением).

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор адреса.
EQUIPMENT_IDEQUIPMENT.ID

(warning) Идентификатор абонентского оборудования (точки оказания услуги).

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID(warning) Идентификатор вида адреса.
DISTRICT
(green star) Район федерального уровня, в составе которого находится населённый пункт. Тип региона в Гидре — Район с кодом REGION_TYPE_District.
CITY
(warning) Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ульяновск.
CITY_TYPE
(warning) Полное или краткое наименование типа населённого пункта. Например: г. или Город, пос. или Посёлок.

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

STREET
(warning) Название населённого пункта. В справочнике регионов Гидры — код региона. Например: Ленина.
STREET_TYPE
(warning) Полное или краткое наименование типа улицы. Например: ул. или Улица, наб. или Набережная.

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

HOUSE

Эти четыре столбца совокупно определяют здание:

  • HOUSE — номер дома,
  • BUILDING — корпус,
  • CONSTRUCT — строение,
  • OWNERSHIP — владение.

(warning) Хотя бы одно из значений должно быть заполнено, иначе адрес не будет мигрирован.

BUILDING
CONSTRUCT
OWNERSHIP
ENTRANCE
(green star) Подъезд дома.
FLOOR
(green star) Номер этажа, должен быть числом.
FLAT
(green star) Номер квартиры.
INTERCOM_CODE
(green star) Код домофона.
CUSTOM_ADDRESS
(green star) Нестандартный адрес, например: третья дверь налево.
REMARK
(green star) Краткое примечание к адресу.


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

(green star) Оставьте таблицу пустой, если не хотите предоставлять абонентам доступ в ЛК и для управления доступом к услугам абонентам в Гидре не нужны логины и пароли.

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор подписки.
CUSTOMER_IDCUSTOMERS.ID(warning) Идентификатор абонента.
NETWORK_SERVICE_IDNETWORK_SERVICES.ID(warning) Идентификатор сетевой службы.
EQUIPMENT_IDEQUIPMENT.ID

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

(green star) Оставьте пустым для доступа в личный кабинет и подписок на службы уведомлений.

(warning) Обязательно заполните для подписок на управляемые Гидрой внешние службы (например PPPoE или Смотрёшка).

LOGIN

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

(green star) Оставьте пустым, если логин не требуется, например для подписки на уведомления.

PASSWORD

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

(green star) Оставьте пустым, если пароль для службы не требуется, например для подписки на уведомления.

PASSWORD_HASH_TYPE
(green star) В текущей версии не используется, оставьте пустым.
REMARK
(green star) В текущей версии не используется, оставьте пустым.


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

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

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

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор подписки.
ACCOUNT_IDACCOUNTS.ID(warning) Идентификатор лицевого счёта.
CONTRACT_IDCONTRACTS.ID(warning) Идентификатор договора на оказание услуг.
PRODUCT_IDPRODUCTS.ID

(warning) Идентификатор услуги (тарифного плана).

В подписках могут участвовать только периодические услуги.

EQUIPMENT_IDEQUIPMENT.ID

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

(green star) Рекомендуется указывать оборудование и для неуправляемых услуг, чтобы хотя бы была привязка услуги к адресу обслуживания, но можно для них оставить пустым.

START_DATE
(warning) Дата и время начала подписки в формате ДД.ММ.ГГГГ чч:мм:сс — когда абонент заказал данную услугу или тарифных план.
END_DATE

Дата и время окончания подписки в формате ДД.ММ.ГГГГ чч:мм:сс — когда оказание услуги должно завершиться.

(green star) Оставьте пустым для текущих услуг — они будут оказываться бессрочно.

(lightbulb) Если в будущем запланирована смена тарифного плана: в подписке на старый тарифный план укажите дату и время его окончания, а в подписке на новый — только дату и время начала (на секунду больше окончания старого).

QUANTITY

Количество заказанной услуги в единице измерения PRODUCTS.UNIT_ID. Является множителем к её цене: например для аренды двух телефонных линий по 100 ₽ укажите 2 — тогда абонентская плата составит 2 × 100 ₽ = 200 ₽.

(green star) Оставьте пустым для тарифных планов (пакетов услуг) и услуг без единицы измерения.

BILLING_DATE

Фиксированный расчётный день месяца — натуральное число от 1 до 28. Для абонентов-юрлиц как правило 1 — расчётные периоды строго привязаны к календарным месяцам.

(green star) Оставьте пустым, если расчётный день должен быть плавающим: этот режим как правило используется для абонентов-физлиц.

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


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

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

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

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


(green star) Историю начислений как правило достаточно выгружать с начала текущего года — для возможности формирования финансовых отчётов из одного биллинга. История мигрирует «как есть» в виде архивированных актов начислений — для неё не нужны приказы по ценам и подписки на услуги.

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор начисления.
ACCOUNT_IDACCOUNTS.ID(warning) Идентификатор лицевого счёта.
CONTRACT_IDCONTRACTS.ID(warning) Идентификатор договора на оказание услуг.
CHARGE_DATE

(warning) Дата и время начисления (списания средств с ЛС) в формате ДД.ММ.ГГГГ чч:мм:сс. При миграции будет сопоставлена с ACCOUNTS.BALANCE_DATE для определения итогового баланса лицевого счёта.

Как правило совпадает с датой начала или окончания расчётного периода, но не должна выходить за пределы этого периода.

PRODUCT_IDPRODUCTS.ID

(warning) Идентификатор услуги, тарифного плана или корректировки баланса.

EQUIPMENT_IDEQUIPMENT.ID

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

(green star) Можете оставить пустым для истории начислений, если нет необходимости привязывать её к конкретным точкам оказания услуг.

AMOUNT

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

Для корректировок баланса допустимы отрицательные значения, увеличивающие баланс лицевого счёта, — возвраты средств.

CHARGING_PERIOD_START_DATE

(warning) Дата и время начала расчётного периода в формате ДД.ММ.ГГГГ чч:мм:сс. Время для обычных периодических услуг, как правило, указывается 00:00:00 — полночь.

Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE.

CHARGING_PERIOD_END_DATE

(warning) Дата и время окончания расчётного периода в формате ДД.ММ.ГГГГ чч:мм:сс. Время для обычных периодических услуг, как правило, указывается 23:59:59 — последняя секунда.

Для мгновенных разовых услуг и корректировок баланса совпадает с CHARGE_DATE.

QUANTITY

Количество оказанной услуги в единице измерения PRODUCTS.UNIT_ID, умноженное на 100.

(green star) Оставьте пустым для тарифных планов (пакетов услуг) и услуг без единицы измерения.

REMARK
(green star) Краткое примечание к начислению.


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

(green star) Историю платежей как правило достаточно выгружать с начала текущего года — для возможности формирования финансовых отчётов из одного биллинга.

СтолбецИсточник значенийОписание
ID
(warning) Идентификатор платежа.
ACCOUNT_IDACCOUNTS.ID(warning) Идентификатор лицевого счёта.
BANK_IDBANKS.ID(warning) Идентификатор банка — источника платежа.
TRANSACTION_DATE
(warning) Дата и время платежа в формате ДД.ММ.ГГГГ чч:мм:сс. При миграции будет сопоставлена с ACCOUNTS.BALANCE_DATE для определения итогового баланса лицевого счёта.
PAYMENT_AMOUNT
(warning) Сумма платежа в валюте лицевого счёта, умноженная на 100.
PAYMENT_TYPE_IDPAYMENT_TYPES.ID

Идентификатор типа платежа.

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

REMARK
(green star) Краткое примечание к платежу.
  • No labels