Файлы платежных документов
ПД можно добавлять только у размещенных ДРСО в ГИС ЖКХ.
Формат обменного файла для загрузки платежных документов в РИАС ЖКХ
Версия 2.3 от 06.12.2019
Формат файла XML.
Размер не более 5 МБ.
Пример файла
Примечание. Импорт ПД в РИАС возможен только по размещенным в ГИС ЖКХ лицевым счетам, объектам и договорам.
Элементы, помеченные как необязательные, могут отсутсвовать.
Файл с данными платёжных документов имеет следующую структуру:
- Заголовок
- Корневой узел
- Результаты импорта
1. Заголовок
<?xml version="1.0" encoding="UTF-8"?>
2. Корневой узел
Элемент
root
2.1. Платёжный документ
Элемент
payment_document
Атрибуты
- num_contract
-
Номер договора.
Формат: Строка.
Номер договора должен быть указан точно так же как и в РИАС. По данному полю будет производится сопоставление. Например, если в РИАС указан “№ 123/ ХВ”, но неправильно будет указать: 123/ХВ, №123/ХВ и т.п.
- date_of_contract
-
Дата заключения договора.
Формат: дд.мм.гггг
Дата должна быть указана точно такая же как и в РИАС. По данному полю будет производится сопоставление при импорте в РИАС.
- account
-
Номер лицевого счёта.
Формат: Строка.
Л/с должен быть уникальный в рамках одного договора. Он должен быть указан точно так же как в РИАС. По данному полю будет производится сопоставление.
- period
-
Период.
Формат: мм.гггг
Указывается месяц и год, за который сформирован ПД.
- bik
-
БИК кредитной организации, куда будет поступать платеж по данному ПД.
Формат: Строка.
Платежные реквизиты должны быть внесены в личном кабинете на сайте ГИС ЖКХ у поставщика информации.
- bank_account
-
Расчетный счет в кредитной организации, куда будет поступать платеж по данному ПД.
Формат: Строка.
Платежные реквизиты должны быть внесены в личном кабинете на сайте ГИС ЖКХ у поставщика информации.
- num_payment_doc
-
Номер платежного документа.
Формат: Строка.
Не обязательное поле.
- debts
-
Задолженность за предыдущий период.
Формат: РРРРРР.кк
Сумма в рублях.
- prepaid_expense
-
Аванс на начало расчетного периода.
Формат: РРРРРР.кк
Сумма в рублях.
- amount_installments_interest
-
Сумма к оплате с учетом рассрочки платежа и процентов за рассрочку.
Формат: РРРРРР.кк
Итого по всему платежному документу.
- accounting_date
-
Учтены платежи, поступившие до указанного числа расчетного периода включительно.
Формат: Целое число от 1 до 31
Не обязательное поле. Если данных нет, то будет подставляться значение 25.
- paid_cash
-
Оплачено денежных средств, руб.
Формат: РРРРРРРРРРРРР.кк
Не обязательное поле.
- date_of_last_received_payment
-
Дата последней поступившей оплаты.
Формат: дд.мм.гггг
Не обязательное поле.
- total
-
Итого к оплате за расчетный период всего.
Формат: РРРРРР.кк
По всему платежному документу - суммируется плата за коммунальные услуги, штрафы и пени.
Не учитываются переплаты и задолженности.
Сумма в рублях.
- total_with_debts
-
Итого к оплате за расчетный период с учетом задолженностей и переплат всего.
Формат: РРРРРР.кк
По всему платежному документу - суммируется плата за коммунальные услуги, штрафы, пени,
а также переплаты и задолженности на начало расчетного периода
Сумма в рублях.
- confirm_amount_correct
-
Не проверять правильность сумм на стороне ГИС ЖКХ
Формат: true
Необязательный узел. Может либо отсутствовать, либо содержать значение "true".
Внимание!При наличии данного узла флаг "confirm_amount_correct" формируемого платежного документа будет установлен вне зависимости от значения данного узла.
2.1.1. Начисление
Элементы
charges
Атрибуты
- rate
-
Тариф.
Формат: РРРРРР.кк
Размер платы за единицу измерения ресурса. Сумма в рублях.
Значение не может быть пустым.
- pay_indiv
-
К оплате за индивидуальное потребление коммунальной услуги.
Формат: РРРРРР.кк
Рассчитываемое поле = тариф * инд. потребление за период. Сумма в рублях.
- pay_houses
-
К оплате за общедомовое потребление коммунальной услуги.
Формат: РРРРРР.кк
Рассчитываемое поле = тариф * инд. потребление за период. Сумма в рублях.
- pay_accrued
-
Всего начислено за расчетный период (без перерасчетов и льгот).
Формат: РРРРРР.кк
Расчетное поле = к оплате за инд. + общедом. Сумма в рублях.
- pay_total
-
Итого к оплате за расчетный период.
Формат: РРРРРР.кк
Расчетное поле = к оплате за инд. + общедом. Сумма в рублях.
2.1.1.1. Услуга
Элемент:
service
Содержимое
Значение элемента - наименование услуги
Атрибуты
- code
-
Код услуги по справочнику НСИ 51.
- Холодное водоснабжение - 1.1
- Горячее водоснабжение - 2.1
- Водоотведение - 3.1
- Электроснабжение - 4.1
- Газоснабжение - 5.1
- Отопление - 6.1
- Обращение с твердыми коммунальными отходами - 7
Узнать другие коды, а так возможность добавить свои услуги можно в личном кабинете ГИС ЖКХ - https://my.dom.gosuslugi.ru/organization-cabinet/#!/org-nsi/MunicipalService
Размер платы за единицу измерения ресурса. Сумма в рублях.
2.1.1.2. Объем услуги
Элемент:
scope_of_service
2.1.1.2.1. Индивидуальное потребление
Элемент:
individual
Атрибуты
- value_in_period
-
Потребление за период.
Формат: Число
Единицы измерения не указываются и берутся автоматически из договора.
- computation
-
Потребление за период.
Формат: N, M, O
N - Norm - Норматив, M - Metering device - прибор учета, O - Other - иное
2.1.1.2.2. Общедомовые нужды
Элемент:
common_houses
Атрибуты
- value_in_period
-
Потребление за период.
Формат: Число
Единицы измерения не указываются и берутся автоматически из договора.
- computation
-
Потребление за период.
Формат: N, M, O
N - Norm - Норматив, M - Metering device - прибор учета, O - Other - иное
2.1.1.3. Справочная информация
Элемент:
reference_info
2.1.1.3.1. Норматив потребления коммунальных ресурсов
Элемент:
norm
Атрибуты
- living_spaces
-
Норматив потребления в жилых помещениях.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
- house
-
Норматив потребления при содержании общего имущества.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
2.1.1.3.2. Текущие показания приборов учёта коммунальных ресурсов
Элемент:
reading_of_meters
Атрибуты
- indived
-
Текущие показания индивидуальных (квартирных) приборов учёта.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
- collective
-
Текущие показания коллективных (общедомовых) приборов учёта.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
2.1.1.3.3. Суммарный объём коммунальных ресурсов в доме
Элемент:
total_volume_in_house
Атрибуты
- in_premises
-
Суммарный объём коммунальных ресурсов в помещениях дома.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
- common_property
-
Суммарный объём коммунальных ресурсов в целях содержания общего имущества.
Формат: Число
Без указания единиц измерений. 4 знака после точки. Всего 10 знаков.
2.1.1.4. Льготы и субсидиине обязательное
Элемент:
discounts
Атрибуты
- recalculations
-
Перерасчеты, корректировки в рублях.
Формат: Положительное число
Не обязательное.
- privileges
-
Льготы, субсидии, скидки в рублях.
Формат: Число
Не обязательное.
2.1.1.5. Рассрочкане обязательное
Элемент:
installments
Атрибуты
- amount_current_period
-
Сумма платы с учетом рассрочки платежа - от платы за расчетный период.
Формат: Число
Не обязательное.
- amount_previous_period
-
Сумма платы с учётом рассрочки платежа - от платы за предыдущие расчётные периоды.
Формат: Число
Не обязательное.
- percent_rub
-
Проценты за рассрочку в рублях.
Формат: Число
Итого по услуге.
- percent
-
Проценты за рассрочку в процентах.
Формат: Число
Итого по услуге.
- total
-
Сумма к оплате с учётом рассрочки платежа и процентов за рассрочку.
Формат: Число
Итого по услуге.
2.1.1.6. Перерасчетыне обязательное
Элемент:
recalculations
Атрибуты
- base
-
Основания перерасчетов.
Формат: Строка
Не обязательное.
- amount
-
Сумма.
Формат: Число
Может быть отрицательным с точкой.
2.1.1.7. Повышающий коэффициентне обязательное
Элемент:
increasing_factor
Атрибуты
- size_factor
-
Размер повышающего коэффициента.
Формат: Число
Может быть с точкой.
- size_pay
-
Размер превышения платы, рассчитанной с применением повышающего коэффициента над размером платы, рассчитанной без учета повышающего коэффициента. В рублях.
Формат: Число
Не обязательное.
2.1.2. Неустойки и судебные расходыне обязательное
Элементы
penalties
2.1.2.1 Вид неустойки и судебных расходов
Элемент:
service_type
Содержимое
Код по справочнику НСИ 329 "Неустойки и судебные расходы".
Значение не может быть пустым и должно соответствовать одному из значений справочника:
1 - Пени
2 - Штрафы
3 - Государственные пошлины
4 - Судебные издержки
2.1.2.2 Основания начислений
Элемент:
cause
Содержимое
Значение не может быть пустым
2.1.2.3 Итого к оплате
Элемент:
total_payable
Содержимое
Итого к оплате за расчетный период, руб. - по данному виду начислений.
Формат - число с разделителем-точкой.
Значение не может быть пустым
3. Ответ от РИАС
При удачной обработке файла будет доступна ссылка для скачивания файла с результатами обработки.
Для каждого узла payment_document будет добавлен узел import_result, который, в зависимости от результата обработки,
будет содержать либо узлы import_message (сообщение об успешном импорте) и rias_id (идентификатор созданного в РИАС платежного документа),
либо узел error с дочерними узлами error_code (в данной версии содержит слово "Ошибка") и error_message (содержит развернутое описание ошибки).
Кроме того, если ошибка была вызвана одним из дочерних узлов платежного документа, узел error будет дублироваться для этого дочернего узла.
