Page History

Общие

...

сведения

...

...

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

...

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

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

...

...

...

...

...

Примеры

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

  View file
  name headers_only.zip height 250

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

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

• 
  

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

  Code Block
  theme Confluence linenumbers true
  "ID";"CUSTOMER_ID";"ACCOUNT_NUMBER";"ACCOUNT_TYPE_ID";"CURRENCY_ID";"BANK_ID";"BALANCE";"CREDIT";"CREDIT_END_DATE";"BALANCE_DATE"

...

• ;"

...

• REMARK" "10";"

...

• 1";"

...

• 14170";"1";"643";"";"802.00";"";"";"29.02.2024 23:59:59";"" "11";"1";"14170★";"

...

• 3";"

...

• 999";"";"

...

• 560";"";"";"29.02.2024 23:59:59"

...

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

...

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

  
  

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

  View file
  name example_basic.zip height 250

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

  View file
  name example_extended.zip height 250

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

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

...

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

...

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

...

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

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

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

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

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

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

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

Таблица 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 в таблицах USERS и OP_EQUIP

Таблица FIRMS

...

ID

...

ID филиала

...

NAME

...

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

...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FIRMS — фирмы

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

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

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

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

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

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

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

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

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

В Гидре:

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

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

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

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

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

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

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

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

В Гидре:

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

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

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

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

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

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

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

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

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

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

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

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

В Гидре:

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

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

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

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

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

Таблица CUSTOMERS

...

ID

...

ID абонента

...

STATUS_ID

...

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

...

CODE

...

Код абонента

...

JUR

...

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

...

NAME

...

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

...

ADDRESS

...

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

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

...

Примечание: поля OP_EQUIP_ID, OP_EQUIP_PORT, OP_EQUIP_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

...

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

...

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

...

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 числу месяца, то выгружайте PAY_DAY = 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

...

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

...

QUANTIY

...

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

...

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

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

...

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

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

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

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

Таблица COMMENT_TYPES

...

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

Таблица CUSTOMER_COMMENTS

...

Таблица EQUIPMENT_COMMENTS

...

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

В процессе миграции некоторые поля разбираются, и данные из них записываются в дополнительные таблицы. В частности, адрес из USERS.ADDR подвергается парсингу и записывается в таблицу PARSED_USER_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

...

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

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

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

...

Примечание: если в системе, откуда производится выгрузка, нет понятия групп, то желательно хотя бы разделить всех выгружаемых абонентов на три группы: юридические лица, физические лица и сотрудники. То есть добавьте эти три группы в таблицу 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

...

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

...

	Идентификатор фирмы для многофилиальной Гидры.  Оставьте пустым, если в вашей Гидре всего одна фирма.
REMARK		Краткое примечание к абоненту (или к базовому субъекту при раздельной выгрузке).

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

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

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

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

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

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

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

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

Столбец	Источник значений	Описание
CUSTOMER_ID	CUSTOMERS.ID	Идентификатор выгруженного абонента. Первичный ключ в данной таблице: для одного выгруженного абонента здесь возможна только одна запись.
CUSTOMER_DST_CODE		Код целевого абонента в Гидре, которому необходимо добавить выгруженные счета, договоры, оборудование и подписки.
REMARK		В текущей версии не используется, оставьте пустым.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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