+ 7 (495) 777-25-43 otr@rarus.ru
Меню

Документация к API загрузки Зданий, Помещений, Лицевых счетов

Введение

Загрузка зданий

Функция ЗагрузитьЗдания()

Таблица данных

Особенности

Пример

Еще один пример

Объектная модель

Загрузка помещений

Функция ЗагрузитьПомещения()

Таблица данных

Пример

Еще один пример

Объектная модель

Загрузка лицевых счетов

Функция ЗагрузитьЛицевыеСчета()

Таблица данных

Особенности

Пример

Еще один пример

Объектная модель

Введение

В программе 1С: Учет в управляющих компаниях ЖКХ, ТСЖ и ЖСК реализован программный интерфейс для массовой загрузки в программу новых Зданий, Помещений, Лицевых счетов.

Программный интерфейс (API) упрощает добавление новых объектов, теперь не приходится держать в голове тонкости внутреннего устройства программы.

Рассмотрим пример загрузки Зданий, чтобы понять разницу между тем как было раньше и как теперь.

Загрузка зданий раньше
Загрузка зданий теперь

Чтобы правильно загрузить список Зданий, раньше было необходимо для каждого Здания:

  • Подготовить таблицу с данными о Зданиях;

  • Реализовать логику:

    • Добавления нового элемента справочника «Здание»;

    • Заполнения реквизиты справочника «Здание»;

    • Отражения почтового и/или строительного адресов в табличной части «Контактная информация»;

    • Заполнения площади здания в регистре сведений «Площади здания».

Теперь, чтобы загрузить список Зданий, необходимо:

  • Подготовить таблицу с загружаемыми данными о Зданиях;

  • Вызвать функцию программного интерфейса;

  • Готово!

Аналогичная ситуация с Помещениями и Лицевыми счетами.

Программный интерфейс для загрузки объектов реализован в общем модуле УПЖКХ_ИнтерфейсЗагрузкиДанных.

Далее подробно описана загрузка:

  • Зданий;

  • Помещений;

  • Лицевых счетов.

Загрузка Зданий

Программный интерфейс для формирования списка Зданий предоставляет функцию ЗагрузитьЗдания().

Функция ЗагрузитьЗдания()

Функция ЗагрузитьЗдания(

    ТаблицаДанных,

    ИскатьСуществующие = Истина,

    ОбновлятьСуществующие = Истина,

    СоздаватьНеСопоставленные = Истина,

    ИскатьСоздаватьРеквизитыСсылочногоТипа = Истина,

    РежимОбменаДанными = Истина

) Экспорт


У функции один обязательный параметр — ТаблицаДанных (подробнее см. след. подраздел).

И пять необязательных параметров:

Параметр

Описание

Значение по умолчанию

Тип

ИскатьСуществующие

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

Истина

Булево

ОбновлятьСуществующие

Определяет нужно ли обновить найденное уже существующие Здание

Истина

Булево

СоздаватьНеСопоставленные

Определяет нужно ли создавать Здание, если он не существует в информационной базе

Истина

Булево

ИскатьСоздаватьРеквизитыСсылочногоТипа

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

Истина

Булево

РежимОбменаДанными

Параметр используется для установки свойства ОбменДанными.
Здание.ОбменДанными.Загрузка = РежимОбменаДанными;

Истина

Булево


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

Колонка

Описание

Тип

Успех

Определяет успешность добавления/обновления Здания

Булево

РезультатЗагрузки

Содержит ссылку на добавленное/обновленное Здание или пустую ссылку на справочника “Здания”.

Ссылка на созданное Здание или

Пустая ссылка

РезультатЗагрузкиСтрокой

Определяет статус добавления/обновления Здания, возможные опции:

  • Пропущен

  • Обновлен

  • Создан

Строка

Таблица данных

Самостоятельно структуру таблицы данных формировать не нужно. Пустую таблицу данных можно получить, вызвав функцию ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Здания") программного интерфейса.

Структура таблицы данных формируется на основании реквизитов, колонок табличных частей Здания и состава связанных объектов.

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

Таблица данных содержит обязательные для заполнения поля:

Поля

Описание

Тип

Пример

НомерДома

Номер здания

Строка

1

ПочтовыйАдрес

Почтовый адрес здания

Строка

г. Москва, ул. Ленина, дом 1


И необязательные для заполнения поля:

Поля

Описание

Тип

Общее

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

Представление Здания в информационной базе

Строка

СтроительныйАдрес

Строительный адрес здания

Строка

Родитель

Группа, к которой принадлежит здание

Строка

или

СправочникСсылка.КВП_Здания

ТипСооружения

Тип Здания:

  • Здание

  • Паркинг

Строка

или

ПеречислениеСсылка.УПЖКХ_ТипСооружения

ВидСооружения

Вид здания: Коттедж, Многоквартирный дом

Строка

или

СправочникСсылка.КВП_ВидыЗданийСооружений

Этажей

Количество этажей в Здании

Число

Подъездов

Количество подъездов в Здании

Число

Многоквартирное

Указывает является ли здание многоквартирным

Булево

ЖилойДомБлокированнойЗастройки

Указывает является ли здание жилым домом блокированной застройки

Булево

ТипЖилФонда

Тип жилого фонда:

  • Товарищество собственников жилья

  • Дома в управлении коммерческих организаций

  • Муниципальный фонд

  • ЖСК на обслуживании ДЕЗ

  • ЖСК на самообслуживании

  • Ведомства

Строка

или

ПеречислениеСсылка.КВП_ТипыЖилогоФонда

ОВД

Орган внутренних дел, к которому относить здание

Строка

или

СправочникСсылка.КВП_ОВД

НоменклатурнаяГруппа

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

Строка

или

СправочникСсылка.НоменклатурныеГруппы

Участок

Участок трубопровода, в котором расположено здание/сооружение

Строка

или

СправочникСсылка.КВП_Участки

Площади

ПлощадьЗданияОбщая

Общая площадь всех помещений в здании

Число

ПлощадьЗданияЖилыхНежилыхПомещений

Общая площадь всех жилых и нежилых помещений в здании

Число

ПлощадьЗданияМестОбщегоПользования

Общая площадь помещений, входящих в состав общего имущества здания

Число

ПлощадьЗданияСИндивидуальнымОтоплением

Общая площадь помещений с индивидуальным отоплением

Число

ПлощадьЧленовЖКХ

Площадь, принадлежащая членам ЖКХ

Число

ОПЛестниц

Общая площадь лестниц

Число

ОППридомовойТерритории

Общая площадь придомовой территории

Число

ОПЧердака

Общая площадь чердака

Число

ОПНежилыхПомещений

Общая площадь нежилых помещений

Число

Приватизировано

Общая площадь приватизированной территории

Число

ОППодвала

Общая площадь подвала

Число

Арендовано

Общая площадь арендованной территории

Число

ОПКровли

Общая площадь кровли

Число

ПлощадьЗастройки

Площадь застройки

Число

ПолезнаяПлощадь

Полезная площадь

Число

Технические характеристики

СерияДома

Серия здания

Строка

ГодПостройки

Год постройки здания

Число

ГодКапРемонта

Год последнего капитального ремонта здания

Число

ПроцентИзноса

Процент износа здания

Число

ВысотаПомещений

Высота помещений здания

Число

Объем

Объем здания

Число

МатериалСтен

Материал стен здания

Строка

или

СправочникСсылка.КВП_МатериалСтен

ВидКровли

Вид кровли здания

Строка

или

СправочникСсылка.КВП_ВидКровли

ДатаВводаВЭксплуатацию

Дата ввода здания в эксплуатацию

Строка

или

Дата

Благоустройство

Благоустройство

Категория благоустройства здания:

  • Благоустроенное жилье

  • Жилье с частичным благоустройством

  • Жилье без благоустройства

Строка

или

ПеречислениеСсылка.КВП_КатегорииБлагоустройства

Сведения для ГИС ЖКХ

УникальныйНомерВГИСЖКХ

Уникальный номер здания в ГИС ЖКХ

Строка

КодДомаПоФИАС

Кода здания в ГИС ЖКХ/Код по ФИАС

Строка

КодРодительскогоОбъектаПоФИАС

Код родительского объекта (улицы) по ФИАС

Строка

ОКТМО

Код ОКТМО здания

Строка

Состояние

Состояние здания:

  • Аварийный

  • Исправный

  • Ветхий

Строка

или

ПеречислениеСсылка.УПЖКХ_СостоянияДомов

ОбъектКультурногоНаследия

Указывается является ли Здание объектом культурного наследия города

Булево

КоличествоПодземныхЭтажей

Количество подземных этажей здания

Число

ЧасоваяЗонаПоOslon

Часовая зона по Oslon здания:

  • Анадырь

  • Владивосток

    ...

  • Москва

    ...

  • Якутск

Строка

или

СправочникСсылка.УПЖКХ_ЧасовыеЗоныПоOslon

КадастровыйНомер

Кадастровый номер здания

Строка

СтадияЖизненногоЦикла

Стадия жизненного цикла:

  • Эксплуатация

  • Реконструкция

  • Капитальный ремонт с отселением

  • Капитальный ремонт без отселения

Строка

или

ПеречислениеСсылка.УПЖКХ_СтадииЖизненногоЦикла

Особенности

  1. Если поле «Наименование» не передано, в качестве наименования используется значение поля «Почтовый адрес».
  2. Если данные поля «Тип сооружения» не передано, по умолчанию данное поле заполняется значением «Здание».

Пример

Пример ниже создает два Здания «г. Москва, ул. Ленина, дом 1» и «г. Москва, ул. Ленина, дом 2».

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Здания");

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.НомерДома = "1";

НоваяСтр.ПочтовыйАдрес = "г. Москва, ул. Ленина, дом 1";

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.НомерДома = "2";

НоваяСтр.ПочтовыйАдрес = "г. Москва, ул. Ленина, дом 2";

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьЗдания(ТаблицаДанных);



Тип сооружения - здание

Еще один пример

Пример ниже создает одно Здание «ул. Ленина, дом 1», при этом заполняются необязательная информация, такая как:

  • Наименование здания

  • Родительская группа

  • Строительный адрес

  • Количество этажей и подъездов

  • Площадь

  • Сведения для ГИС ЖКХ

 

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Здания");

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "ул. Ленина, дом 1";

НоваяСтр.Родитель = "ул. Ленина";

НоваяСтр.НомерДома = "1";

НоваяСтр.ПочтовыйАдрес = "г. Москва, ул. Ленина, дом 1";

НоваяСтр.СтроительныйАдрес = "г. Москва, ул. Ленина, дом 1";

НоваяСтр.Этажей = 9;

НоваяСтр.Подъездов = 5;

НоваяСтр.Многоквартирное = Истина;

НоваяСтр.ВидСооружения = "Многоквартирный дом";

НоваяСтр.ТипЖилФонда = "ЖСК на самообслуживании"     ;

НоваяСтр.ПлощадьЗданияОбщая = 2000;

НоваяСтр.ПлощадьЗданияЖилыхНежилыхПомещений = 2000;

НоваяСтр.ПлощадьЗданияМестОбщегоПользования = 500;

НоваяСтр.ПлощадьЗданияСИндивидуальнымОтоплением = 1500;

НоваяСтр.Благоустройство = "Благоустроенное жилье";

НоваяСтр.КодДомаПоФИАС = "1111";

НоваяСтр.КодРодительскогоОбъектаПоФИАС = "111";

НоваяСтр.Состояние = "Исправный";

НоваяСтр.ОбъектКультурногоНаследия = Ложь;

НоваяСтр.КоличествоПодземныхЭтажей = 1;

НоваяСтр.ЧасоваяЗонаПоOslon = "Москва";

НоваяСтр.КадастровыйНомер = "11";

НоваяСтр.СтадияЖизненногоЦикла = "Эксплуатация";

 

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьЗдания(ТаблицаДанных);



Здание 1, Здание 2 – Здания, сооружения

Объектная модель

Схема – объектная модель

При добавлении нового Здания программный интерфейс:

  1. Создает элемент справочника «Здания»;

  2. Сохраняет почтовый и строительный адреса в табличной части «Контактная информация» справочника «Здания»;


  3. Адрес здания
  4. Сохраняет сведения о площадях в регистре сведений «Площади здания».

    Площади здания

Загрузка Помещений

Программный интерфейс для формирования списка Помещений предоставляет функцию ЗагрузитьПомещения().

 

Функция ЗагрузитьПомещения()

Функция ЗагрузитьПомещения(

    ТаблицаДанных,

    ИскатьСуществующие = Истина,

    ОбновлятьСуществующие = Истина,

    СоздаватьНеСопоставленные = Истина,

    ИскатьСоздаватьРеквизитыСсылочногоТипа = Истина,

    РежимОбменаДанными = Истина

) Экспорт

 

У функции один обязательный параметр — ТаблицаДанных (подробнее см. след. подраздел).

 

И пять необязательных параметров:

Параметр

Описание

Значение по умолчанию

Тип

ИскатьСуществующие

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

Истина

Булево

ОбновлятьСуществующие

Определяет нужно ли обновить найденное уже существующие Помещение

Истина

Булево

СоздаватьНеСопоставленные

Определяет нужно ли создавать Помещение, если он не существует в информационной базе

Истина

Булево

ИскатьСоздаватьРеквизитыСсылочногоТипа

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

Истина

Булево

РежимОбменаДанными

Параметр используется для установки свойства ОбменДанными.
Здание.ОбменДанными.Загрузка = РежимОбменаДанными;

Истина

Булево

 

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

Колонка

Описание

Тип

Успех

Определяет успешность добавления/обновления Помещение

Булево

РезультатЗагрузки

Содержит ссылку на добавленное/обновленное Помещение или пустую ссылку на справочника “Помещения”.

Ссылка на созданное Здание или

Пустая ссылка

РезультатЗагрузкиСтрокой

Определяет статус добавления/обновления Здания, возможные опции:

  • Пропущен

  • Обновлен

  • Создан

Строка

 

Таблица данных

Самостоятельно структуру таблицы данных формировать не нужно. Пустую таблицу данных можно получить, вызвав функцию ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Помещения") программного интерфейса.

 

Структура таблицы данных формируется на основании реквизитов справочника Помещения, вида площадей, вида благоустройств и состава ряда связанных объектов (подробнее см. раздел «Объектная модель»).

 

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

 

Таблица данных содержит обязательные для заполнения поля:

Поля

Описание

Тип

Пример

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

Наименование помещения

Строка

Кв. 1

Владелец

Здание, к которому относится данное помещение

Строка

или

СправочникСсылка.КВП_Здания

ул. Ленина, дом 1

ВидПомещения

Вид помещения: квартира, офис и т.п.

Строка

или

СправочникСсылка.УПЖКХ_ВидыПомещений

Квартира

 

И необязательные для заполнения поля:

Поля

Описание

Тип

Общие данные

Код

Номер помещения

Строка

Суффикс

Суффикс, добавляемый к наименованию элемента справочника

Строка

СтроительныйНомер

Номер помещения, указанных в проектной документации

Строка

Подъезд

Подъезд, к которому относится данное помещение (поле доступно только для многоквартирных домов)

Строка

или

СправочникСсылка.КВП_Подъезды

НомерБлока

Номер блока, в котором находится помещение

Строка

ПроектПомещения

Проект помещения, который относиться к зданию

Строка

или

СправочникСсылка.УПЖКХ_ПроектыПомещений

КоличествоКомнат

Количество комнат в помещении

Число

Этаж

Этаж здания, на котором расположено помещение

 

Число

ДатаЗагрузки

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

 

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

 

Формат заполнения: “ДД.ММ.ГГГГ”

Строка

Площадь

ОбщаяПлощадь

Размер общей площади

Число

ЖилаяПлощадь

Размер жилой площади

Кухня

Размер площади кухни

Лоджия

Размер площади лоджии

ПлощадьМОПБезКухни

Размер площади МОП без кухни

ДополнительнаяПлощадь

Размер дополнительной площади

Список может быть расширен добавлением новых элементов справочника “Виды площадей”

 

 

Благоустройство

Ванная

Список благоустройств помещения

Число

или

Строка

или

Дата

или

Булево

или

ПеречислениеСсылка.УПЖКХ_ВидыСанУзла

или

ПеречислениеСсылка.КВП_Канализация

или ПеречислениеСсылка.УПЖКХ_ТипыГорячегоВодоснабжения

или

ПеречислениеСсылка.КВП_Плита

или ПеречислениеСсылка.УПЖКХ_ТипЗапирающегоУстройства

или

ПеречислениеСсылка.УПЖКХ_ТипыХолодногоВодоснабжения

Горячее водоснабжение

Канализация

Количество кухонь

Количество лестниц

Количество лифтовых шахт

Лифт

Мусоропровод

Освещение кухни

Отопление

Плита

Расположение кухни

Санузел

Соответствует стандартам благоустройства

Тип запирающего устройства

Холодное водоснабжение

Централизованное отопление

Список может быть расширен добавлением новых элементов справочника “Виды благоустройства объектов”

 

 

Объекты учета и оборудование

Оборудование

Оборудование, установленное на помещение.

 

Если в справочнике “Прочие объекты учета, оборудование” отсутствует оборудование с указанным наименованием, то автоматически будет создано новое оборудование по переданному наименованию

Строка

или

СправочникСсылка.УПЖКХ_ПрочиеОбъектыУчета

КоличествоОборудования

Количество оборудования

Число

СостояниеОборудования

Состояние оборудования:

  • Введено в эксплуатацию

  • Снято с эксплуатации

Строка

или

ПеречислениеСсылка.УПЖКХ_СостоянияОборудования

Сведения для ГИС ЖКХ

ИдентификаторВГИСЖКХ

Идентификатор помещения в ГИС ЖКХ

Строка

НазначениеПомещения

Назначение помещения

Строка

или

СправочникСсылка.УПЖКХ_НазначенияПомещений

РасположениеПомещения

Расположение помещения в здании:

  • Встроенное

  • Пристроенное

  • Встроенно-пристроенное

Строка

или

ПеречислениеСсылка.УПЖКХ_РасположенияПомещений

ХарактеристикаПомещения

Характеристика помещения:

  • Отдельная квартира

  • Квартира коммунального заселения

  • Общежитие

Строка

или

ПеречислениеСсылка.УПЖКХ_ХарактеристикиПомещений

СоставляетОбщееИмуществоВМКД

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

Булево

КадастровыйНомер

Кадастровый номер помещения

Строка

Дополнительная информация

СостояниеПомещения

Состояние помещения:

  • Свободна

  • Наем

  • Аренда

  • Бронирована

  • Не используется

  • В собственности

  • Принята по акту

  • Инвест. договор

  • Не реализована

  • Получены ключи

  • Частично свободна

  • Заселена

  • Наем коммерческий

  • Субаренда

  • В безвозмездной собственности

Строка

или

ПеречислениеСсылка.КВП_СостоянияПомещения

КатегорияПомещения

Категория помещения:

  • Гостиничного типа

  • Коммунальная

  • Нежилое помещение

  • Нереализованная

  • Общежитие

  • Общежитие коридорного типа

  • Отдельная

  • Разделенные лицевые счета

  • Индивидуальный жилой дом

Строка

или

ПеречислениеСсылка.КВП_КатегорииКвартир

КодПомещенияПоФИАС

Код помещения по ФИАС

Строка

Характеристика

Краткая характеристика помещения

Строка

Описание

Описание помещения

Строка

 

Пример

Пример ниже создает два Помещения «кв. 1» и «кв. 2».

 

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Помещения");

    

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "Кв. 1";

НоваяСтр.Владелец = "ул. Ленина, дом 1";

НоваяСтр.ВидПомещения = "Квартира";

    

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "Кв. 2";

НоваяСтр.Владелец = "ул. Ленина, дом 1";

НоваяСтр.ВидПомещения = "Квартира";

    

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьПомещения(ТаблицаДанных);



Помещения в здании

Еще один пример

Пример ниже создает одно Помещение «Кв. 1», при этом заполняются необязательная информация, такая как:

  • Номер помещения (код)

  • Строительный номер

  • Подъезд

  • Количество комнат

  • Этаж

  • Дата загрузки

  • Площадь

  • Благоустройство

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("Помещения");

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Код = "1";

НоваяСтр.Наименование = "Кв. 1";

НоваяСтр.Владелец = "ул. Ленина, дом 1";

НоваяСтр.ВидПомещения = "Квартира";

НоваяСтр.СтроительныйНомер = "Кв. 1";

НоваяСтр.Подъезд = "Подъезд 1";

НоваяСтр.КоличествоКомнат = 2;

НоваяСтр.Этаж = 1;

НоваяСтр.ДатаЗагрузки = "01.01.2020";

НоваяСтр.ОбщаяПлощадь = 56;

НоваяСтр.ЖилаяПлощадь = 50;

НоваяСтр.Кухня = 10;

НоваяСтр.Ванная = Истина;

НоваяСтр.ГорячееВодоснабжение = Истина;

НоваяСтр.Канализация = Истина;

 

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьПомещения(ТаблицаДанных);


Помещения - Квартира 1

Объектная модель

Объектная модель

При добавлении нового Помещения программный интерфейс:

  • Создает элемент справочника «Помещения»;

  • Сохраняет сведения о площадях в регистре сведений «Площадь помещения»;

  • Общая площадь
  • Сохраняет сведения о состоянии помещения в регистре сведений «Состояние помещения»;

  • Состояние помещения
  • Сохраняет сведения о благоустройстве помещения в регистре сведений «Благоустройство объектов»;

  • Вид благоустройства
  • Сохраняет сведения об оборудовании помещения в регистрах сведений «Сведения об оборудовании» и «Взаимосвязь оборудования и объектов учета».

  • Объект учета

Загрузка Лицевых счетов

Программный интерфейс для формирования списка Лицевых счетов предоставляет функцию ЗагрузитьЛицевыеСчета().

 

Функция ЗагрузитьЛицевыеСчета()

Функция ЗагрузитьЛицевыеСчета(

    ТаблицаДанных,

    ИскатьСуществующие = Истина,

    ОбновлятьСуществующие = Истина,

    СоздаватьНеСопоставленные = Истина,

    ИскатьСоздаватьРеквизитыСсылочногоТипа = Истина,

    РежимОбменаДанными = Истина

) Экспорт

 

У функции один обязательный параметр — ТаблицаДанных (подробнее см. след. подраздел).

 

И пять необязательных параметров:

Параметр

Описание

Значение по умолчанию

Тип

ИскатьСуществующие

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

Истина

Булево

ОбновлятьСуществующие

Определяет нужно ли обновить найденное уже существующий Лицевой счет

Истина

Булево

СоздаватьНеСопоставленные

Определяет нужно ли создавать Лицевой счет, если он не существует в информационной базе

Истина

Булево

ИскатьСоздаватьРеквизитыСсылочногоТипа

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

Истина

Булево

РежимОбменаДанными

Параметр используется для установки свойства ОбменДанными.
Здание.ОбменДанными.Загрузка = РежимОбменаДанными;

Истина

Булево

 

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

Колонка

Описание

Тип

Успех

Определяет успешность добавления/обновления Лицевого счета

Булево

РезультатЗагрузки

Содержит ссылку на добавленное/обновленное Лицевого счета или пустую ссылку на справочника “Лицевые счета”.

Ссылка на созданное Здание или

Пустая ссылка

РезультатЗагрузкиСтрокой

Определяет статус добавления/обновления Лицевого счета, возможные опции:

  • Пропущен

  • Обновлен

  • Создан

Строка

 

Таблица данных

Самостоятельно структуру таблицы данных формировать не нужно. Пустую таблицу данных можно получить, вызвав функцию ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки(«ЛицевыеСчета») программного интерфейса.

 

Структура таблицы данных формируется на основании реквизитов справочника Лицевые счета и полями необходимыми для заполнения документов «Открытие лицевого счета» и «Управление сведениями для взаиморасчетов по лицевым счетам».

 

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

 

Таблица данных содержит обязательные для заполнения поля:

Поля

Описание

Тип

Пример

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

Наименование лицевого счета

Строка

л/с №0000000001

Организация

Организация, с которой заключен договор

Строка

или

Органзация

УК “Престиж”

Контрагент

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

Строка

или

Контрагент

Трофимов Денис Михайлович

Здание

Здание, которому принадлежит л/с

Строка

или

Здание

ул. Ленина, дом 1

Адрес

Помещение, на которое открыт лицевой счет

Строка

или

Помещение

Кв. 1

 

И необязательные для заполнения поля:

Поля

Описание

Тип

Общие данные

ИдентификаторЛС

Номер или набор символов, по которому можно точно идентифицировать этот лицевой счет

Строка

Родитель

Группа, к которой предлежит л/с

Строка

НеПечататьКвитанцииНаБумажныхНосителях

Указывается “Истина”, если не нужно выводить квитанции на бумажном носителе

Булево

КоличествоПроживающих

Количество проживающих по лицевому счету

Число

КоличествоЗарегистрированных

Количество зарегистрированных по лицевому счету

Число

ДоляЧислитель

Доля собственности текущего лицевого счета в указанном помещении

Число

ДоляЗнаменатель

ДатаЗагрузки

Дата открытия л/с, используется для формирования документов “Открытие лицевого счета”, "Управление сведениями для взаиморасчетов по лицевым счетам”.

 

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

 

Формат заполнения: “ДД.ММ.ГГГГ”

Строка

Контакты

Телефон

Контактный телефон лицевого счета

Строка

АдресЭлектроннойПочты

Адрес электронной почты лицевого счета

Строка

Данные по документам

ДатаДоговораОПриватизации

Дата договора о приватизации жилой площади

 

Дата

ДатаВыдачиДокНаЖилье

Дата выдачи документов на жилье

Дата

ДокументОснованиеЛС

Документ открытия лицевого счета

Строка

НомерДоговораОПриватизации

Номер договора о приватизации

Строка

НомерДокумента

Номер ордера или другого документа на жилую площадь

Строка

Сведения о собственнике

ЛогинДоступа

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

Строка

Сведения для ГИС ЖКХ

ЕдиныйЛицевойСчет

Номер единого лицевого счета в ГИС ЖКХ

Строка

ИдентификаторЖКУ

Идентификатор ЖКУ, присвоенный лицевому счету на стороне ГИС ЖКХ при экспорте лицевых счетов из информационной базы в ГИС ЖКХ. Идентификатор используется для идентификации лицевого счета при выгрузке платежных документов

Строка

ЕдиныйЛицевойСчетКР

Номер единого лицевого счета в ГИС ЖКХ с типом "Капитальный ремонт"

Строка

ИдентификаторЖКУКР

Идентификатор ЖКУ КР лицевого счета в ГИС ЖКХ с типом "Капитальный ремонт"

Строка

 

Особенности

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

 

Пример

Пример ниже создает два Лицевых счета «л/с №0000000001» и «л/с №0000000002».

 

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("ЛицевыеСчета");

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "л/с №0000000001";

НоваяСтр.Организация = "УК ""Престиж""";

НоваяСтр.Контрагент = "Трофимов Денис Михайлович";

НоваяСтр.Здание = "ул. Ленина, дом 1";

НоваяСтр.Адрес = "Кв. 1";

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "л/с №0000000002";

НоваяСтр.Организация = "УК ""Престиж""";

НоваяСтр.Контрагент = "Петров Николай Владимирович";

НоваяСтр.Здание = "ул. Ленина, дом 1";

НоваяСтр.Адрес = "Кв. 2";

 

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьЛицевыеСчета(ТаблицаДанных);

 

Еще один пример

Пример ниже создает один Лицевой счет «л/с №0000000001», при этом заполняются необязательная информация, такая как:

  • Родитель лицевого счета;

  • Необходимость печатать бумажные квитанции;

  • Доля собственности;

  • Дата открытия лицевого счета (дата загрузки);

  • Контактная информация (телефон, email).

 

ТаблицаДанных = УПЖКХ_ИнтерфейсЗагрузкиДанных.ПолучитьПустуюТаблицуДанныхПоВариантуЗагрузки("ЛицевыеСчета");

 

НоваяСтр = ТаблицаДанных.Добавить();

НоваяСтр.Наименование = "л/с №0000000001";

НоваяСтр.Организация = "УК ""Престиж""";

НоваяСтр.Контрагент = "Трофимов Денис Михайлович";

НоваяСтр.Здание = "ул. Ленина, дом 1";

НоваяСтр.Адрес = "Кв. 1";

НоваяСтр.Родитель = "ул. Ленина";

НоваяСтр.НеПечататьКвитанцииНаБумажныхНосителях = Ложь;

НоваяСтр.ДоляЧислитель = 1;

НоваяСтр.ДоляЗнаменатель = 1;

НоваяСтр.ДатаЗагрузки = "01.01.2020";

НоваяСтр.Телефон = "+79666334455";

НоваяСтр.АдресЭлектроннойПочты = "trofimov.den@ya.ru";

 

Результат = УПЖКХ_ИнтерфейсЗагрузкиДанных.ЗагрузитьЛицевыеСчета(ТаблицаДанных);

 

Объектная модель

Объектная модель – лицевые счета

При добавлении нового Лицевого счета программный интерфейс:

  • Создает элемент справочника «Лицевые счета»;

    Лицевые счета
  • Вводит документ «Открытие лицевого счета»;

    Открытие лицевого счета
  • Вводит документ «Управление сведениями для взаиморасчетов по лицевым счетам».

    Управление сведениями для взаиморасчетов по лицевым счетам

Назад


Материалы по теме: