Лицевые счета

Owned by Aleksandra Mishina
Last updated: Aug 08, 2023
5 min read

ФОРМАТ ИМПОРТА ЛИЦЕВЫХ СЧЕТОВ В ДОМОПУЛЬТ

1. Формат файла – CSV(UTF-8) с разделителями-точка с запятой.Название файла – ДД.ММ.ГГГГ загрузки. В таблице шапка отделена от содержимого пустой строкой (Кол-во разделителей= кол-во заголовков).

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

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

ДЕТАЛИЗАЦИЯ СТОЛБЦОВ

  1. Системный ID (AccountID) лицевого счета в биллинговой системе.(Обязательно)
    Строка, идентификатор лицевого счета. До 50 символов. Обязательно.
    Пример:24a5046a-62fc-11e3-acb1-a4badb318150.

    1. AccountID л/с, связанного с каждым адресом, должен быть уникальным и консистентным (не меняться в разных выгрузках).

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

    3. Если л/с с указанным AccountID отсутствует в системе, то Домопульт создает новый лицевой счет и связывает ее с соответствующей недвижимостью.

    4. Если у л/с с AccountID, который уже есть в Домопульте, поданным файла импорта изменяются номер л/с, общая площадь, жилая площадь - эти параметры перезаписываются в Домопульте.

    5. Если у л/с с AccountID, который уже есть в Домопульте, изменяется связанная недвижимость (сверка по EstateID),то существующая недвижимость отвязывается от данногоЛС и привязывается новая недвижимость.

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

    7. Если новая недвижимость с указанным EstateID есть в Домопульте с таким адресом, л/с отвязывается от старой недвижимости и привязывается к новой

    8. Если новой недвижимости нет в базе Домопульта, то Домопульт ее создает и связывает с указанным л/с67

  2. Номер ЛС(AccountName).(Обязательно)
    Строка, наименование лицевого счета в 1С (номер л/с). До 50 символов.
    Пример: 0801001. Этот номер отображается клиенту.

  3. Общая площадь (SpaceTotal).(Не обязательно)
    Число,соответствующее общему кол-ву м2 общей площади связанного с лицевым счетом объекта недвижимости. До 4символов + 2 после запятой.
    Пример: 65,80 м2.

  4. Жилая площадь (Houseroom).(Не обязательно)
    Число,соответствующее общему кол-ву м2 жилой площади связанногос лицевым счетом объекта недвижимости. До 4 символов + 2после запятой.
    Пример: 60,05 м2.

  5. Системный ID объекта недвижимости (EstateID).(Необязательно)
    Строка, идентификатор связанного с данным лицевым счетом. До 50 символов.
    Пример: 24a5046a-62fc-11e3-acb1-a4badb318150.
    Должен быть уникальным для каждого объекта недвижимости.
    Если в системе, из которой осуществляется набор дангныъ, такого поля нет, то соответсвующую ячейку следует оставить пустой, но это может затруднить процесс синхронизации справочников и привести к конфликтам(создание дублей и т.п.)
    Если Вы не знаете зачем нужен данный параметр – то лучше оставить его пустым, поскольку некорректная работа с данным параметром может вызвать проблемы с загрузкой данных в систему.

    1. Если у указанного лс нет EstateID, то этот атрибут пропускается при загрузке. Синхронизация осуществляется по адресу недвижимости и AccountID

    2. Если недвижимость с указанным адресом хранится в БД Домопульта без EstateID, а в файле импорта для данной недвижимости указан EstateID, то он присваевается данной недвижимости

    3. Если EstateID был указан в Домопульте для недвижимости, но в импорте для недвижимости с таким же адресом EstateID пришел пустой или вообще не пришел - EstateID не обовляется, он перезапишется только в случае, если по такому же адресу пришел другой EstateID, отличный от NULL

    4. В адресе с присвоенным EstateID изменять можно только номер помещения. Если у недвижимости с EstateID, который уже есть в Домопульте, изменяются город, улица, дом, корпус, подъезд, этаж - Домопульт пропускает такую строчку.

    5. Если значение подъездов и этажей нулевое, а в базе Домопульта есть данные по подъездам и этажам, то при импорте изменения в адрес не вносятся, но строчка записывается в базу.

    6. Если значение подъездов и этажей не нулевое и отличается от данных адреса недвижимости в Домопульте, то при импорте такая строчка будет пропущена

    7. Если у недвижимости с EstateID, который уже есть в Домопульте, изменяется связанный лицевой счет (см AccountID), то эта недвижимость отвязывается от текущего Л/С и связывается с новым. Если такого л/с нет -Домопульт его создает.

  6. Город. (CityName).(Обязательно)
    Строка, наименование города, в котором расположен объект недвижимости, связанный с лицевым счетом.
    Пример: Москва

  7. Улица (StreetName).(Обязательно)
    Строка, до 255 символов. Название улицы, на которой расположен объект недвижимости, связанный с лицевым счетом. Обязательно, если не указан EstateID. Если заполнен EstateID, который уже есть в Домопульте, адрес можно не заполнять.
    Пример: Ленинский проспект

  8. Дом (HouseNumber).(Обязаельно)
    Строка, до 50 символов.Номер дома. Обязательно, если не указан EstateID. Если заполнен EstateID, который уже есть в Домопульте, адрес можно не заполнять.
    Пример: 25

  9. Корпус (BuildingNumber).(Не обязательно)
    Строка, до 50символов, номер корпуса, если есть (если нет корпуса – пустаяячейка).
    Пример: 2

  10. Подъезд (LobbyNumber).(Не обязательно)
    Строка, до 50 символов, номер подъезда, если есть (если нет подъезда –пустая ячейка). Если данное поле не присутствовало в первоначальной выгрузке – указать подъезд в адресе в автоматическом режиме будет впоследствии невозможно.
    Пример: 11А

  11. Этаж (FloorNumber).(Не обязательно)
    Строка, до 50 символов, номер этажа, если есть (если нет этажа – пустая ячейка). Еслиданное поле не присутствовало в первоначальной выгрузке –указать Этаж в адресе в автоматическом режиме будетвпоследствии невозможно.
    Пример: -5Б

  12. Помещение (RoomNumber).(Обязательно для МКД)
    Строка, до 50 символов, номер помещения.
    Пример: 100
    Для кладовых, офисов, машиномест и тд необходимо добавлять суффикс «к.», «оф,» «а/м» или аналогичные, если суффикс не добавлен, то помещение не будет считаться уникальным.

  13. Вид помещения (RoomType).(Необязательно)
    В системе можно задать вид для импортируемых помещений как число в диапазоне от 1 до 8: {Квартира = 1; Апартаменты = 2;Офис =3;Кладовая = 4;Машиноместо = 5;Участок = 6;Коттедж =7;Помещение = 8}

    1. В зависимости от указанного вида помещения, после импорта в базу Домопульта будет иметь соответствующее сокращение ;(суффикс после номера помещения) для адреса: {кв.},{апарт.}.,{оф.},{к.},{а/м},{уч.},{пом.}, . Если вид помещения = "Коттедж", то в адресе такие помещения указываются без сокращения, просто "№ХХХ"

    2. Название помещения по-умолчанию зависит от указанного вида: "Квартира ХХХ", "Апартаменты ХХХ","Офис ХХХ", "Кладовая ХХХ", "Машиноместо ХХХ","Участок ХХХ", "Коттедж ХХХ", "Помещение ХХХ"

    3. Если столбца нет в файле или если столбец есть, но незаполнен, то все импортируемые помещения будут созданы с видом “Квартира”

    4. Если вид помещения уже был задан ранее, но потом из файла обмена пропал столбец RoomType или его значения, то вид существующих в базе Домопульт помещений не будет измене. Если в столбце RoomType есть значения, отличные от существующих в базе, то они будут перезаписаны и вид помещения будет изменен

    5. Столбец нужно заполнять только если импортируется помещение (заполнен столбец RoomNumber).

  14. Статус помещения (RoomResidence).(Необязательно)
    В Домопульт можно задать статус для импортируемых помещений как число в диапазоне от 1 до 2: {Жилое = 1;Нежилое = 2}

    1. Если столбца нет в файле или если столбец есть, но не заполнен, то все импортируемые помещения будут созданы со статусом “Жилое”

    2. Если сначала вид помещения уже был задан, но потом из файла обмена пропал столбец“RoomResidence” или его значения, то статус существующих в базе Домопульта помещений не будет изменен

    3. Если в столбце RoomResidence есть значения, отличные от существующих в базе, то они будут перезаписаны и вид помещения будет изменен

    4. Столбец нужно заполнять только если импортируется помещение (заполнен столбец RoomNumber).

ПРИМЕР ЗАПОЛНЕННОГО ФАЙЛА