РИАС ЖКХ
Обратная связь
Пример
Формат

Файлы платежных документов

ПД можно добавлять только у размещенных ДРСО в ГИС ЖКХ.


Формат обменного файла для загрузки платежных документов в РИАС


Версия 2.3


Версия 2.3 от 06.12.2019

Формат файла XML.
Размер не более 5 МБ.
Пример файла

Примечание. Импорт ПД в РИАС возможен только по размещенным в ГИС ЖКХ лицевым счетам, объектам и договорам.

Элементы, помеченные как необязательные, могут отсутствовать.


Файл с данными платёжных документов имеет следующую структуру:

  1. Заголовок
  2. Корневой узел
    1. Платёжный документ
      1. Начисление
        1. Услуга
        2. Объем услуг
          1. Индивидуальное потребление
          2. Общедомовые нужды
        3. Справочная информация
          1. Норматив потребления коммунальных ресурсов
          2. Текущие показания приборов учёта коммунальных ресурсов
          3. Суммарный объём коммунальных ресурсов в доме
        4. Льготы, субсидии
        5. Рассрочка
        6. Перерасчеты
        7. Повышающий коэффициент
      2. Неустойки и судебные расходы
        1. Вид неустойки
        2. Основание
        3. Итого к оплате
  3. Результаты импорта

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 будет дублироваться для этого дочернего узла.

Произошла непредвиденная ошибка

Сообщение об ошибке уже отправлено разработчикам сервиса.
При необходимости они с Вами свяжутся.