Экспорт информации о начислениях из ИС УНП
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
CHARGE — используется для запроса неоплаченных начислений;
CHARGENOTFULLMATCHED — используется для запроса начислений, не полностью сквитированных с платежами (в т.ч. таких, по которым оставшаяся сумма к оплате равна «0», но при этом в начислении и соответствующем ему платеже попарно могут не совпадать какой-либо или несколько атрибутов из следующего набора: КБК, ОКТМО, ИНН, КПП, номер счета, БИК, идентификатор плательщика);
CHARGESTATUS — используется для запроса начислений и статусов их квитирования;
Запросы CHARGE, CHARGENOTFULLMATCHED, доступны для КО и РПГУ. Запрос CHARGESTATUS доступен АН, КО, РПГУ.
Особенности формирования запроса на экспорт извещений о начислениях, администрируемых налоговыми органами Российской Федерации
В ответе на запрос экспорта извещений о начислениях (CHARGE, CHARGESTATUS, CHARGENOTFULLMATCHED) вернутся в том числе и начисления, администрируемые налоговыми органами Российской Федерации, при выполнении хотя бы одного из следующих условий:
запрос начисления по УИН;
запрос начислений по идентификатору плательщика.
Возможность запроса начислений, администрируемых налоговыми органами Российской Федерации, по идентификатору плательщика определяется внутренними настройками ГИС ГМП.
Условие, при котором в ответе на экспорт начислений по УИН из ИС УНП возвращаются начисления, администрируемые налоговыми органами Российской Федерации:
Значение (значения) УИН в контейнере с условиями для получения сущностей из ГИС ГМП (атрибута (ов) «SupplierBillID» элемента «Filter»/«Conditions»/«ChargesIdentifiers») соответствует маске: «^182\w{17}$|^182\d{22}$».
Условия, при которых в ответе на экспорт начислений по идентификатору плательщика из ИС УНП возвращаются начисления, администрируемые налоговыми органами Российской Федерации:
значение идентификатора плательщика в контейнере с условиями для получения сущностей из ИС УНП (атрибута (ов) «PayerIdentifier» элемента «Filter»/«Conditions»/«Payers») соответствует маске: «^2[0-9]{14}[A-Z0-9]{2}[0-9]{3}$|^4[0-9]{12}$|}$|^21[0-9]{23}$»;
наличие блока с информацией, подтверждающей аутентификацию плательщика в системе ЕСИА («EsiaUserInfo»). Также должны быть выполнены проверки соответствия значений идентификатора плательщика («PayerIdentifier») данным из блока информации, подтверждающей аутентификацию плательщика (физического лица/индивидуального предпринимателя) в ЕСИА (EsiaUserInfo) описание которых приведено в п.2.1.1 настоящего раздела.
Проверки соответствия значений идентификатора плательщика («PayerIdentifier») данным из блока информации, подтверждающей аутентификацию плательщика (пользователя) в ЕСИА («EsiaUserInfo»):
Атрибут «PayerIdentifier» соответствует маске «^21[0-9]{23}» (ИНН физического лица):
Осуществляется проверка соответствия значения, указанного в 11-22 разрядах атрибута «PayerIdentifier», значению атрибута «personINN» (блок данных «EsiaUserInfo»/«Person»).
Если проверка не пройдена, то в ответе на запрос будут возвращены извещения о начислениях, удовлетворяющие параметрам фильтрации, за исключением извещений о начислениях, администрируемых налоговыми органами Российской Федерации.
Атрибут «PayerIdentifier» соответствует маске «^4[0-9]{12}» (ИНН индивидуального предпринимателя):
Осуществляется проверка соответствия значения, указанного в 2-13 разрядах атрибута «PayerIdentifier», значению атрибута «personINN» (блок данных «EsiaUserInfo»/«IndividualBussnes»).
Если проверка не пройдена, то в ответе на запрос будут возвращены извещения о начислениях, удовлетворяющие параметрам фильтрации, за исключением извещений о начислениях, администрируемых налоговыми органами Российской Федерации.
Формат ответа на запрос начислений
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportChargesResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ИС УНП» настоящего документа), описание параметров приведено в Таблице 26.
Таблица . «Структура ответа на запрос экспорта начислений»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных
|
Комментарий для типов запроса CHARGE, CHARGENOTFULLMATCHED
|
Комментарий для типов запроса CHARGESTATUS
|
ExportChargesResponse
|
1, обязательно
|
ExportChargesResponseType
|
Ответ на запрос начислений.
|
Ответ на запрос начислений.
|
Charges
|
1, обязательно
|
Контейнер
|
Перечень начислений и признак конца выборки
|
Перечень начислений.
|
hasMore (атрибут)
|
1, обязательно
|
boolean
|
Признак конца выборки: false — достигнут конец выборки, true — после последней выгруженной сущности в выборке имеются другие.
|
Признак конца выборки: false — достигнут конец выборки, true — после последней выгруженной сущности в выборке имеются другие.
|
needReRequest (атрибут)
|
0..1, необязательно
|
boolean
|
true — требуется повторный запрос. В случае, если для получения ответа потребовалось задействовать внешнюю систему и ответ от нее не был получен (внешняя система недоступна либо получена ошибка).
Для получения полного объема информации требуется послать новую серию запросов, с новым идентификатором серии запросов(RequestMessage/id), начиная с первой страницы.
|
true — требуется повторный запрос. В случае, если запрос был транслирован во внешнюю систему (ГИС ГМП) и ответ от нее не был получен (система недоступна либо получена ошибка).
Для получения полного объема информации требуется послать новую серию запросов, с новым идентификатором серии запросов (RequestMessage/id), начиная с первой страницы.
|
ChargeInfo
|
0..n, необязательно
|
Контейнер
|
Данные начислений, полученных из ИС УНП (или из ГИС ГМП).
|
Данные начислений, полученных из ИС УНП (или из ГИС ГМП).
|
ChargeData
|
1, обязательно
|
Base64Binary
|
Данные начисления
|
Данные начисления.
|
ChargeSignature
|
0..1, необязательно
|
Base64Binary
|
Данные файла ЭП начисления, переданного от АН/ГАН в ИС УНП (или в ГИС ГМП).
|
Данные файла ЭП начисления, переданного от АН в ИС УНП (или в ГИС ГМП).
|
AmountToPay
|
1, обязательно
|
long
|
Остаток суммы подлежащей оплате, указанной в начислении (в копейках).
|
Остаток суммы подлежащей оплате, указанной в начислении (в копейках). При переплате начисления принимает отрицательное значение; при полной оплате — значение «0».
|
QuittanceWithPaymentStatus
|
0..1, необязательно
|
String
|
Не заполняется для данного запроса.
|
Статус квитирования с платежами (заполнен всегда).
Возможные значения:
1 — сквитировано;
2 — предварительно. сквитировано;
3 — не сквитировано;
4 — сквитировано с отсутствующим в системе платежом.
|
IsRevoked
|
0..1, необязательно
|
boolean
|
Не заполняется для данного запроса. Возвращаются только действующие неоплаченные начисления / частично оплаченные.
|
Показатель аннулированного начисления.
Возможные значения:
true — начисление аннулировано;
false — начисление действующее.
|
date (атрибут)
|
0..1, необязательно
|
dateTime
|
Не заполняется для данного запроса.
|
Дата аннулирования начисления
|
В случае возникновения ошибки при обработке запроса на экспорт начислений код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в п. 5.2.4 настоящего документа.
Экспорт информации о платежах из ИС УНП
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
PAYMENT — все активные (неаннулированные) платежи;
PAYMENTMODIFIED — все платежи, имеющие статус уточнения (ChangeStatus@meaning имеет значение «2») или статус аннулирования (ChangeStatus@meaning имеет значение «3»);
PAYMENTUNMATCHED — все активные (неаннулированные) платежи, для которых в системе отсутствуют соответствующие начисления (не создана ни одна квитанция);
PAYMENTCANCELLED — аннулированные платежи (ChangeStatus@meaning имеет значение «3»).
Формат ответа на запрос платежей
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportPaymentsResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ИС УНП» настоящего документа), описание параметров приведено в таблице 27.
Таблица . «Структура ответа на запрос экспорта платежей»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных
|
Комментарий
|
ExportPaymentsResponse
|
1, обязательно
|
ExportPaymentsResponseType
|
Ответ на запрос платежей.
|
Payments
|
1, обязательно
|
Контейнер
|
Перечень платежей и признак конца выборки.
|
hasMore (атрибут)
|
1, обязательно
|
boolean
|
Признак конца выборки:
false — достигнут конец выборки,
true — после последней выгруженной сущности в выборке имеются другие.
|
needReRequest (атрибут)
|
0..1, необязательно
|
boolean
|
true — требуется повторный запрос. В случае, если запрос транслировался во внешнюю систему (ГИС ГМП) и ответ от нее не был получен (система недоступна либо получена ошибка).
Для получения полного объема информации требуется послать новую серию запросов, с новым идентификатором серии запросов(RequestMessage/id), начиная с первой страницы.
|
PaymentInfo
|
0..n, необязательно
|
Контейнер
|
Данные платежа.
|
PaymentData
|
1, обязательно
|
Base64Binary
|
Данные платежа, полученного от участника ИС УНП (или из ГИС ГМП).
|
PaymentSignature
|
0..1, необязательно
|
Base64Binary
|
Данные файла ЭП платежа, полученного от участника ИС УНП (или из ГИС ГМП).
|
PaymentStatus
|
0..n, необязательно
|
Контейнер
|
Признак “Сквитировано с начислением”.
|
name (атрибут)
|
1, обязательно
|
String
|
Обозначение.
Для обозначения факта квитирования данных платежа с данными начисления в поле name указывается значение «Сквитировано с начислением».
|
value (атрибут)
|
0..1, необязательно
|
String
|
Код, уточнение.
Для обозначения факта квитирования данных платежа с данными начисления в поле value указывается УИН, c которым сквитирован платеж.
|
В случае возникновения ошибки при обработке запроса на экспорт начислений код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в п. 5.2.4.
Экспорт квитанций из ИС УНП
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
QUITTANCE — для запросов результатов квитирования, за исключением неактивных (возвращается результат квитирования с последним полученным платежом). В квитанции передается статус квитирования начисления со всеми платежами, но отражается результат квитирования только с последним полученным платежом;
ALLQUITTANCE — для запросов всех результатов квитирования.
Запрос QUITTANCE доступен для АН/ГАН, АП/ГАП и АЗ/ГАЗ.
Запрос ALLQUITTANCE доступен для АН/ГАН и АП/ГАП.
Формат ответа на запрос квитанций
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportQuittanceResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ИС УНП» настоящего документа), описание параметров приведено в таблице 28.
Таблица «Структура ответа на запрос квитанций»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных
|
Комментарий
|
ExportQuittanceResponse
|
1, обязательно
|
ExportQuittanceResponseType
|
Ответ на запрос квитанций.
|
Quittances
|
0..1, необязательно
|
Контейнер
|
Перечень квитанций.
|
hasMore
(атрибут)
|
1, обязательно
|
boolean
|
Признак конца выборки: false — достигнут конец выборки, true — после последней выгруженной квитанции в выборке имеются другие.
|
Quittance
|
1..n, обязательно
|
Расширение типа QuittanceType (см. описание в п. 2.4)
|
Данные квитанции.
|
IsRevoked
|
0..1, необязательно
|
boolean
|
Не возвращаются для запроса типа QUITTANCE. При запросе типа ALLQUITTANCE возвращаются следующие значения:
true — неактивная квитанция;
false — квитанция действующая.
|
В случае возникновения ошибки при обработке запроса на экспорт квитанций код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в п. 5.2.4.
Экспорт Каталога услуг поставщика из ИС УНП
Для запроса каталога услуг из ИС УНП в сообщении запроса в теге RequestMessage/ExportRequest атрибут kind должен иметь значение CATALOG, в теге RequestMessage/ExportRequest/Filter/Conditions/AllDateCatalog должно быть задано значение атрибута AllDateCatalog, определяющее признак для выгрузки полного каталога или изменений каталога. При указании для атрибута AllDateCatalog значения True, будет выгружаться полный каталог услуг, содержащий все активные (действующие) услуги, тег Timeslot, задающий временной интервал, в этом случае должен отсутствовать в запросе. При указании для атрибута AllDateCatalog значения False будут выгружаться последние изменения по услугам за указанный период (последнее состояние по каждой из услуг вне зависимости от статуса активности, попадающее в заданный диапазон дат), в запросе тег Timeslot должен содержать значения, задающие временной интервал.
В теге RequestMessage/ExportRequest/Filter/Conditions может быть задано значение атрибута code, определяющее код услуги для выгрузки. При указании значения кода услуги в запросе, из УНП будет выгружена соответствующая активная услуга. Тег Timeslot, задающий временной интервал, в этом случае должен отсутствовать в запросе.
Формат ответа на экспорта каталога услуг из ИС УНП
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportCatalogResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ИС УНП» настоящего документа), описание параметров приведено в таблице 29.
Таблица . «Структура ответа на запрос квитанций»
Наименование
|
Кол-во тегов, обязательность тега или атрибута
|
Тип данных
|
Комментарий
|
ExportCatalogResponse
|
1, обязательно
|
ExportPaymentsResponseType
|
Ответ на запрос платежей.
|
Catalog
|
1
|
Контейнер
|
Каталог услуг Поставщика
|
hasMore (атрибут)
|
1, обязательно
|
boolean
|
Признак конца выборки: false — достигнут конец выборки, true — после последней выгруженной сущности в выборке имеются другие.
|
Service
|
1..n
|
Service_Type
|
Услуги из Каталога услуг Поставщика
|
В случае возникновения ошибки при обработке запроса на экспорт каталога код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в п. 5.2.4.
|
