Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Общие

...

сведения

Info

Миграция абонентов в Гидру из других биллинговых систем (АСР

...

) выполняется через промежуточный набор таблиц, представленных файлами формата CSV

...

  • Экранирование точки с запятой внутри значений не используется

...

  • В том числе пустые значения, которые представляются пустыми кавычками (;"";)
  • Экранирование двойных кавычек внутри значений не используется

:

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


Info

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

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

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

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

Примеры

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

    View file
    nameheaders_only.zip
    height250

    Tip

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

Пример записи:

  • (wink)


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

    Code Block
    themeConfluence
    linenumberstrue
    "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"

...

Info

Пример выгрузки: new_example_load.zip

Далее с помощью специального инструмента CSV-файлы загружаются в 

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

Note

Для полей с типом «Дата и время» допускается два формата:

  • С указанием времени: 26.04.2009 13:04:55 (в Oracle — DD.MM.YYYY HH24:MI:SS). Время может быть указано без минут или секунд: отсутствующие данные считаются равными нулю.
  • Без указания времени: 26.04.2009 (в Oracle — DD.MM.YYYY). В таком случае время считается равным полуночи.

Для полей с типом «Дата» допускается только один формат: 26.04.2009 (в Oracle — DD.MM.YYYY).

...

  • ;"Открыт при заключении договора.¶Списание бонусов производить только по согласованию с Фёдором Сумкиным."


  • Архив с упрощённой выгрузкой, включающей только базовый набор данных:

    View file
    nameexample_basic.zip
    height250

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

    View file
    nameexample_extended.zip
    height250

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

  • Юридические и физические лица находятся в

...

  • единой таблице CUSTOMERS и различаются по значению поля ORGANIZATION.
  • Из реквизитов

...

                1. Текущий объём потреблённых услуг (трафик, минуты) никак не мигрирует, но дата окончания текущего периода мигрирует.

...

Выгрузка из старой АСР

Info

К каждой таблице можно добавить поле REMARK, в которое будут выгружаться полезные текстовые данные. Выгруженные в него данные станут комментарием к соответствующей сущности: абоненту, оборудованию, договору и т. д.

Info

Первичный ключ в каждой таблице всегда называется ID

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

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

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

Tip

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


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


Info

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

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

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

Anchor
ref-tables
ref-tables

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

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

Справочник состояний абонента

Таблица CUSTOMER_STATUSES

...

Поле

...

Описание

...

ID

...

ID состояния

...

NAME

...

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

...

В простейшем случае в справочнике всего два состояния (включен, отключен).

Справочник сетевых служб

Таблица NETWORK_SERVICES

...

ID

...

ID сетевой службы

...

NAME

...

Название сетевой службы

...

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

Справочник единиц измерения

Таблица UNITS

...

ID

...

ID единицы измерения

...

NAME

...

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

...

Примечание: значения сопоставляются со справочником единиц измерения в Гидре.

Справочник услуг и тарифных планов

Таблица PRODUCTS

...

ID

...

ID услуги (тарифного плана)

...

NAME

...

Наименование услуги (ТП)

...

TYPE

...

Признак тарифного плана (если Y, то ТП; если N, то услуга)

...

UNIT_ID

...

ID единицы измерения — ссылка на UNITS_LIST.ID

...

Должна соответствовать единице измерения в номенклатуре.

Если в номенклатуре единица не задана (прочерк), оставляйте поле пустым

...

Примечание: значения данного справочника не мигрируют, а сопоставляются с Номенклатурой.

Справочник валют

Таблица CURRENCIES

...

ID

...

ID валюты

...

NAME

...

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

...

Примечание: значения сопоставляются со справочником единиц измерения в Гидре.

Справочник типов оборудования

Таблица EQUIPMENT_TYPES

...

ID

...

ID типа

...

NAME

...

Название оборудования

...

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

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

Таблица PROVIDER_EQUIPMENT

...

ID

...

ID оборудования

...

EQUIPMENT_TYPE_ID

...

ID типа оборудования

...

CODE

...

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

...

IP

...

IP-адрес для управления

...

FIRM_ID

...

ID филиала

...

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

Справочник абонентских групп

Таблица CUSTOMER_GROUPS

...

ID

...

ID группы

...

NAME

...

Название группы

...

Примечание: значения сопоставляются со справочником групп. Если в вашей системе нет групп, то имеет смысл всё равно добавить значения в этот справочник и привязать всех абонентов к группам в зависимости от их категории, например, Физические лица, Юридические лица, Сотрудники и т.п.

Справочник банков

Таблица BANKS

...

ID

...

ID банка

...

NAME

...

Название банка

...

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

Справочник типов счетов

Таблица ACCOUNT_TYPES

...

ID

...

ID типа счета

...

NAME

...

Тип счета

...

Примечание: значения сопоставляются со справочником типов счетов

Справочник типов удостоверений личности

Таблица AUTH_DOC_TYPES

...

ID

...

ID типа документа

...

NAME

...

Тип документа

...

Примечание: значения сопоставляются со справочником типов документов - удостоверений личности

Справочник типов платежей

Таблица PAYMENT_TYPES

...

ID

...

ID типа платежа

...

NAME

...

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

...

VIRTUAL

...

Флаг. 'Y' если корректировка

...

Примечание: справочник служит для разделения платежей по разным видам (исправление ошибки, наличные, безналичные банк, ОСМП, Visa, Webmoney и тп), тип используется для удобства построения отчётов.

Необязательные таблицы сопоставлений

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

Справочник видов телефонов

Таблица PHONE_TYPES

...

ID

...

ID вида привязки телефона

...

NAME

...

Вид привязки (Мобильный, Домашний, Рабочий и т. д.)

...

Примечание: значения сопоставляются со справочником видов адресов

Справочник видов привязки обычных адресов

Таблица STREET_ADDRESS_PURPOSES

...

ID

...

ID вида привязки обычного адреса

...

NAME

...

Вид привязки (Фактический, Юридический, Адрес обслуживания и т. д.)

...

Примечание: значения сопоставляются со справочником видов адресов

Многофилиальная структура

При наличии многофилиальной структуры используется справочник филиалов, на который ссылаются поля FIRM_ID в таблицах CUSTOMERS и PROVIDER_EQUIPMENT

Таблица FIRMS

...

ID

...

ID филиала

...

NAME

...

Наименование филиала

...

Сопоставляется с организационной структурой предприятия.

Таблицы с данными для миграции

Данные из следующих справочных записей исходной системы с аналогичными в Гидре.

Tip

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


Info

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

Anchor
account_types
account_types

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
auth_doc_types
auth_doc_types

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
banks
banks

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
comment_types
comment_types

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
currencies
currencies

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
customer_groups
customer_groups

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
customer_statuses
customer_statuses

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
equipment_types
equipment_types

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

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
firms
firms

FIRMS — фирмы

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
network_services
network_services

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
payment_types
payment_types

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

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

Столбец

Описание

ID

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

NAME

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

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

В Гидре:

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

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

Anchor
phone_types
phone_types

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
products
products

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

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

Столбец

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

Описание

ID


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

NAME


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

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

В Гидре:

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

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

Anchor
provider_equipment
provider_equipment

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.

Anchor
street_address_purposes
street_address_purposes

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

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

Столбец

Описание

ID

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

NAME

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

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

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

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

Anchor
units
units

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

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

Столбец

Описание

ID

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

NAME

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

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

В Гидре:

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

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

Anchor
data-tables
data-tables

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

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

Абоненты и базовые субъекты учёта

Таблица CUSTOMERS

...

ID

...

ID абонента

...

STATUS_ID

...

ID состояния абонента

...

CODE

...

Код абонента

...

JUR

...

Физическое или юридическое лицо (0 — физическое, 1 — юридическое)

...

NAME

...

ФИО (физ. лица) / Наименование (юр. лица)

...

ADDRESS

...

Info

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

Anchor
customers
customers

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

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

Info

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


...

Примечание: поля PROVIDER_EQUIPMENT_ID, PROVIDER_EQUIPMENT_PORT_CODEPROVIDER_EQUIPMENT_PORT_TYPE используются для указания привязки абонентского оборудования к операторскому и не являются необходимыми.

Подписки абонентов на сетевые службы и доступы к приложениям

Таблица CUSTOMER_NET_SERVICE_BINDS

...

ID

...

ID привязки

...

CUSTOMER_ID

...

ID абонента

...

NETWORK_SERVICE_ID

...

ID сетевой службы

...

EQUIPMENT_ID

...

ID абонентского оборудования

...

Ссылка на EQUIPMENT.ID

Заполняется только для подписок на службы, в которых должно быть указано оборудование. В строках доступа к приложениям (например Личный кабинет абонента) поле должно быть пустым.

...

LOGIN

...

Логин

...

PASSWORD

...

Пароль

...

PASSWORD_HASH_TYPE

...

Тип хеширования пароля

...

Если пароль выгружается открытым текстом, оставлять пустым.

Типы шифрования не сопоставляются. Значение из базового справочника «Поддерживаемые типы хэшей паролей» подбирается по совпадению наименования: SSHA1, MD5 и т. д.

...

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

Договоры на оказание услуг

Таблица CONTRACTS

...

ID

...

ID договора

...

CUSTOMER_ID

...

ID абонента

...

CONTRACT_NUMBER

...

Номер договора

...

SIGNATURE_DATE

...

Дата заключения договора

...

START_DATE

...

Дата начала действия договора

...

END_DATE

...

Дата окончания действия договора

...

Контрактные условия и обязательства

Таблица CONTRACT_TERMS

...

ID контрактного условия

...

Наименование контрактного условия

...

Подписки абонентов на услуги

Таблица SUBSCRIPTIONS

...

ID

...

ID подписки

...

ACCOUNT_ID

...

ID лицевого счёта

...

CONTRACT_ID

...

ID договора

...

PRODUCT_ID

...

ID услуги (тарифного плана)

...

EQUIPMENT_ID

...

ID абонентского оборудования

...

START_DATE

...

Дата и время начала подписки

...

END_DATE

...

Дата и время окончания подписки

...

QUANTITY

...

Заказанное количество услуги

...

В единицах измерения, указанных для услуги PRODUCT_ID в PRODUCTS.UNIT_ID

...

BILLING_DATE

...

Расчетный день

...

Примечание: выгружаются услуги и тарифный план на следующий период. Если у вас фиксированный расчётный день, привязанный к 1 числу месяца, то выгружайте BILLING_DATE = 1 (обычно для юридических лиц).

Платежи

Таблица PAYMENTS

...

ID

...

ID операции

...

ACCOUNT_ID

...

ID лицевого счёта

...

BANK_ID

...

ID банка

...

TRANSACTION_DATE

...

Дата и время операции (платежа)

...

PAYMENT_AMOUNT

...

Сумма платежа, умноженная на 100 (целое число)

...

PAYMENT_TYPE_ID

...

Тип платежа

...

Списания

Таблица CHARGES

...

ID

...

ID операции

...

ACCOUNT_ID

...

ID лицевого счёта

...

CONTRACT_ID

...

ID договора

...

CHARGE_DATE

...

Дата и время операции (списания)

...

PRODUCT_ID

...

ID услуги (тарифного плана)

...

EQUIPMENT_ID

...

ID абонентского оборудования

...

AMOUNT

...

Сумма списания, умноженная на 100

...

CHARGING_PERIOD_START_DATE

...

Дата и время начала периода списания

...

CHARGING_PERIOD_END_DATE

...

Дата и время окончания периода списания

...

QUANTITY

...

Количество, умноженное на 100

...

В единицах измерения, указанных для услуги PRODUCT_ID в PRODUCTS.UNIT_ID

Если единица измерения PRODUCTS.UNIT_ID не указана, оставьте пустым

...

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

Дополнительные таблицы

Множественные комментарии

Поддерживается загрузка множественных комментариев к абонентам и абонентскому оборудованию

Таблица COMMENT_TYPES

...

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

Таблица CUSTOMER_COMMENTS

...

Таблица EQUIPMENT_COMMENTS

...

Структурированные адреса

В процессе миграции некоторые поля разбираются, и данные из них записываются в дополнительные таблицы. В частности, адрес из CUSTOMERS.ADDRESS подвергается парсингу и записывается в таблицу CUSTOMER_STREET_ADDRESSES. Таким образом, если в биллинге, из которого выгружаются данные, информация об адресе хранится в разобранном виде, то нет нужды писать его в одну строку — можно сразу заполнить таблицу.

Структурированные адреса базовых субъектов учёта

Таблица CUSTOMER_STREET_ADDRESSES

...

CUSTOMER_ID

...

Соответствующий ID из таблицы CUSTOMERS

...

Вид адреса

...

VC_CITY

...

Название населенного пункта

...

VC_CITY_TYPE

...

Тип населенного пункта

...

VC_STREET

...

Название улицы

...

VC_STREET_TYPE

...

Тип улицы

...

VC_HOUSE

...

Номер дома

...

VC_BUILDING

...

Корпус

...

ENTRANCE

...

Номер подъезда

...

VC_FLOOR

...

Номер этажа

...

VC_FLAT

...

Квартира

...

INTERCOM_CODE

...

Код домофона

...

 

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

Таблица EQUIPMENT_STREET_ADDRESSES

...

EQUIPMENT_ID

...

Соответствующий ID из таблицы EQUIP

...

Вид адреса

...

VC_CITY

...

Название населенного пункта

...

VC_CITY_TYPE

...

Тип населенного пункта

...

VC_STREET

...

Название улицы

...

VC_STREET_TYPE

...

Тип улицы

...

VC_HOUSE

...

Номер дома

...

VC_BUILDING

...

Корпус

...

ENTRANCE

...

Номер подъезда

...

VC_FLOOR

...

Номер этажа

...

VC_FLAT

...

Квартира

...

INTERCOM_CODE

...

Код домофона

...

Телефоны базовых субъектов учёта

Таблица CUSTOMER_PHONES

...

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

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

Таблица CUSTOMER_MAPPINGS

...

Сотрудники компании

Часто число сотрудников достаточно велико, и вводить их вручную нецелесообразно. Для этого необходимо добавить сотрудников как абонентов в таблицу CUSTOMERS, выдать доступ к приложениям с помощью CUSTOMER_NET_SERVICE_BINDS (по аналогии с доступом в ЛК) и заполнить следующие таблицы.

Таблица DEPARTMENTS (Отделы)

...

Таблица EMPLOYEE_TYPES (типы сотрудников)

...

Таблица EMPLOYEES (сотрудники)

нет, то оставляйте пустые , 5к2345к234Формат DD.MM.YYYYОПФ не сопоставляются. По наименованию подбирается запись из базового справочника Только для физических лиц, у которых в поле JUR указано 0
ПолеОписаниеПримечание
IDИдентификатор 
CUSTOMER_ID
АбонентСсылка на CUSTOMERS.ID
FIRM_IDФирма, сотрудником которой является абонентСсылка на FIRMS.ID
DEPARTMENT_IDОтдел (может быть использован в Гидре для разграничения прав)Ссылка на DEPARTMENTS.ID
EMPLOYEE_TYPE_IDТип сотрудника (может быть использован в Гидре для разграничения прав)Ссылка на EMPLOYEE_TYPES.ID
NAME_GENITIVEФИО в родительном падеже 
APPOINTMENTДолжность 
APPOINTMENT_GENITIVEДолжность в родительном падеже 
ACT_AUTHORITYДействует на основании 
TAB_NOТабельный номер 
D_BEGINДата принятия на работу 
D_FIREДата увольнения 
REMARKКомментарий 
СтолбецИсточник значенийОписание

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) Дата рождения

Формат DD.MM.YYYY

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

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

Контактный email


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

FIRM_ID

ID филиала

Ссылка на FIRMS.ID. Используется только при миграции с учетом многофилиальностиREMARKКомментарий

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

Счета абонентов и базовых субъектов учёта

Таблица ACCOUNTS

...

ID

...

ID лицевого счёта

...

CUSTOMER_ID

...

ID абонента

...

ACCOUNT_NUMBER

...

Номер счёта

...

ACCOUNT_TYPE_ID

...

ID типа счета (ЛС, РС итд)

...

CURRENCY_ID

...

ID валюты

...

BANK_ID

...

ID банка

...

BALANCE

...

Баланс счёта

...

CREDIT

...

Текущий кредит абонента

...

CREDIT_END_DATE

...

Дата и время окончания кредитного лимита

...

BALANCE_DATE

...

Дата и время расчёта баланса

...

Нужно учитывать, что все платежи из PAYMENTS, которые пришли позже, чем дата указанная здесь, будут добавляться к балансу указанному в ACCOUNTS.BALANCE.

...

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

Таблица CUSTOMER_GROUP_BINDS

...

ID

...

ID записи об участии

...

CUSTOMER_ID

...

ID абонента

...

GROUP_ID

...

ID группы

...

C_MAIN

...

Признак основной группы - 'Y'

...

Примечание: если в системе, откуда производится выгрузка, нет понятия групп, то желательно хотя бы разделить всех выгружаемых абонентов на три группы: юридические лица, физические лица и сотрудники. То есть добавьте эти три группы в таблицу CUSTOMER_GROUPS и укажите к ним привязку (определите кому какую группу добавлять по своим критериям во время выгрузки).

Абонентское оборудование

Таблица EQUIPMENT

...

ID

...

ID оборудования

...

CUSTOMER_ID

...

ID абонента

...

EQUIPMENT_TYPE_ID

...

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

...

Ссылка на EQUIPMENT_TYPES.ID

Оставлять пустым для компонентов служб с единственным типом спецификации

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

...

PROVIDER_EQUIPMENT_ID

...

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

...

PROVIDER_EQUIPMENT_PORT_CODE

...

Номер (код) порта операторского оборудования

...

CODE

...

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

...

MAC

...

Физический адрес (MAC) в формате 01-23-45-67-89-AB

...

IP

...

IPv4 адрес или подсеть (в CIDR-нотации)

...

IP6

...

IPv6 подсеть

...

PHONE

...

Абонентский телефонный номер в формате E.164

...

ADDRESS

...

Адрес обслуживания

...

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

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

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

Anchor
customer_group_binds
customer_group_binds

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

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

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

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

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

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

Anchor
customer_comments
customer_comments

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) Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.

Anchor
customer_mappings
customer_mappings

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

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

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

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

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

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

Anchor
customer_phones
customer_phones

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

Anchor
customer_street_addresses
customer_street_addresses

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

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

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

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

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

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

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID

(green star) Идентификатор вида адреса, если выгружаете отдельную таблицу STREET_ADDRESS_PURPOSES. По умолчанию — Фактический адрес.

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

Anchor
accounts
accounts

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

Anchor
contracts
contracts

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

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

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

Anchor
equipment
equipment

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 или XXXXXXXXXXXX. Должен быть индивидуальным (юникастовым).

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

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

Anchor
equipment_comments
equipment_comments

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) Дата и время исполнения комментария в формате ДД.ММ.ГГГГ чч:мм:сс.

Anchor
equipment_street_addresses
equipment_street_addresses

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

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

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

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

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

ADDRESS_PURPOSE_IDSTREET_ADDRESS_PURPOSES.ID(green star) Идентификатор вида адреса, если выгружаете отдельную таблицу STREET_ADDRESS_PURPOSES. По умолчанию — Адрес обслуживания.
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) Краткое примечание к адресу.

Anchor
customer_net_service_binds
customer_net_service_binds

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

Anchor
subscriptions
subscriptions

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

Anchor
charges
charges

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

Note

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

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

Anchor
payments
payments

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