Техническое задание на создание сервиса взаимодействия с

Техническое задание
на создание сервиса взаимодействия с
государственной информационной системой о
государственных и муниципальных платежах
(ГИС ГМП)
Аннотация
В настоящем Документе описывается программный интерфейс
взаимодействия с ГИС ГМП.
В ходе создания интерфейса должны использоваться форматы сущностей
ИС УНИФО и спецификаций методов веб-сервиса УНИФО, которые
вызываются внешними информационными системами.
Программный продукт должен относиться к многопользовательской
территориально
распределенной
информационно-телекоммуникационной
системе обработки и передачи информации с различным уровнем доступа
пользователей к обрабатываемой информации, а также обеспечивать защиту
служебной информации ограниченного доступа, получаемой в рамках
выполнения участниками своих функций.
Оглавление
Аннотация
3
Оглавление
4
1.
Общие положения
6
1.1. Термины и обозначения
6
1.2. Наименование системы
8
1.3. Основание для разработки
8
1.4. Информация о версии форматов взаимодействия
8
2.
ОПИСАНИЕ УНИФО
8
2.1. Описание параметров сущностей УНИФО
9
2.2. Начисление
10
2.3. Платеж
12
2.4. Зачисление
14
2.5. Квитанция
16
2.6. Вспомогательные типы
19
2.6.1. Тип Organization
19
2.6.2. Тип AccountType
20
2.6.3. Тип BankType
21
2.6.4. Тип AddressType
22
2.6.5. Тип ContactInfoType
23
2.6.6. Тип Bill
24
2.6.7. Тип PaymentType
25
2.6.8. Тип PaymentIdentificationDataType
27
2.6.9. Тип BudgetIndexType
27
2.6.10.
Простые типы
30
3.
Порядок взаимодействия СЕРВИСА и УНИФО
31
3.1. Структура имен файлов при взаимодействии посредством СЭД ФК
31
3.2. Порядок обработки файлов запросов
32
3.3. Порядок формирования файлов ответов
32
3.4. Порядок взаимодействия Сервиса с УНИФО посредством СЭД ФК
32
3.5. Порядок обработки запросов к веб-сервису
33
3.6. Порядок формирования ответов веб-сервиса
33
3.7. Содержание ответов УНИФО
33
4.
Форматы запросов и ответов
33
4.1. Экспорт начислений, зачислений, платежей и квитанций из УНИФО 33
4.1.1. Экспорт начислений, зачислений, платежей и квитанций из УНИФО
посредством СЭД ФК
33
4.1.2. Экспорт начислений, зачислений, платежей и квитанций из УНИФО
посредством вызова метода веб-сервиса
35
4.2. Экспорт начислений из УНИФО
35
4.2.1. Экспорт начислений из УНИФО посредством СЭД ФК
35
4.2.2. Экспорт начислений из УНИФО посредством вызова метода веб-сервиса
37
4.3. Экспорт начислений и статусов их квитирования из УНИФО
37
4.3.1. Экспорт начислений и статусов их квитирования из УНИФО посредством
СЭД ФК
37
4.3.2. Экспорт начислений и статусов их квитирования из УНИФО посредством
вызова метода веб-сервиса
39
4.4. Экспорт зачислений из УНИФО
39
4.4.1. Экспорт зачислений из УНИФО посредством СЭД ФК
39
4.4.2. Экспорт зачислениий из УНИФО посредством вызова метода веб-сервиса
40
4.5. Экспорт платежей из УНИФО
40
4.5.1. Экспорт платежей из УНИФО посредством СЭД ФК
40
4.5.2. Экспорт платежей из УНИФО посредством вызова метода веб-сервиса41
4.6. Экспорт квитанций из УНИФО
41
4.6.1. Экспорт квитанций из УНИФО посредством СЭД ФК
41
4.6.2. Экспорт квитанций из УНИФО посредством вызова метода веб-сервиса
42
4.7. Импорт начислений, зачислений и платежей в УНИФО из внешних
систем
42
4.7.1. Импорт начислений, зачислений и платежей в УНИФО из внешних
систем посредством СЭД ФК
42
4.7.2. Импорт начислений, зачислений и платежей в УНИФО из внешних
систем посредством вызова метода веб-сервиса
42
4.8. Вспомогательные типы
44
4.8.1. Тип RequestTemplate
44
4.8.2. Тип ResponseTemplate
45
4.8.3. Тип PostBlock
46
4.8.4. Тип ErrInfo
46
4.9. Техническая квитанция
47
4.10. Перечень контролей
48
1.Общие положения
Термины и обозначения
Термин (сокращение)
Определение
SOAP
Simple Object Access Protocol – простой протокол обмена
структурированными сообщениями
World Wide Web Consortium – Консорциум Всемирной паутины
Web Services Description Language– язык описания веб-сервисов
Extensible Markup Language - расширяемый язык разметки
XML Schema definition - зык описания структуры XML-документа.
Спецификация XML Schema является рекомендацией W3C
Частный случай сервиса - программная система, идентифицируемая
URI и предназначенная для поддержки интероперабельных
межмашинных взаимодействий в сетевой среде
Главный администратор доходов бюджета (поставщик услуг)
Документ, содержащий информацию о поступлении денежных
средств, направленных физическим лицом в оплату государственных
пошлин, денежных платежей (штрафов) и сборов, на счет УФК,
открытый в подразделении расчетной сети Центрального банка
Российской Федерации на балансовом счете № 40101 «Доходы,
распределяемые органами Федерального казначейства между
бюджетами бюджетной системы Российской Федерации»
Информационная система
Информационная система организации – поставщика
государственных услуг (администратора доходов бюджета)
Документ, сформированный администратором доходов бюджета для
оплаты физическим лицом государственных пошлин, денежных
платежей (штрафов) и сборов
Проект, который выполняется Федеральным казначейством в рамках
исполнения Протокола заседания Правительственной комиссии по
внедрению информационных технологий в деятельность
государственных органов и органов местного самоуправления от
20.04.2010 № СС-П10-14пр, и предназначен для разработки и
апробации в пилотных регионах технологии оказания услуг по учету
начислений и фактов оплаты физическими лицами государственных
пошлин, денежных платежей (штрафов) и сборов, администраторами
которых являются Министерство внутренних дел Российской
Федерации (в части Государственной инспекции безопасности
дорожного движения), Федеральная миграционная служба России,
Федеральная налоговая служба России
Документ, содержащий информацию о факте оплаты
государственных пошлин, денежных платежей (штрафов) и сборов в
бюджеты бюджетной системы Российской Федерации,
осуществленной физическим лицом в кредитной организации.
Платеж может быть связан с начислением по идентификатору
начисления в УНИФО
Физическое лицо, осуществляющее внесение денежных средств
платежному агенту или кредитной организации, с целью оплаты
государственных услуг
Администратор доходов бюджета или главный администратор
доходов бюджета. По тексту документа также используется более
общий термин «Поставщик услуг»
Платежное поручение
W3C
WSDL
XML
XSD
Веб-сервис
ГАДБ
Зачисление
ИС
ИСП
Начисление
Пилотный проект
Платеж
Плательщик
Поставщик
государственных услуг
п/п
Термин (сокращение)
Определение
РФ
Российская Федерация
Система поддержки
плательщиков, банковские
приложения
СПП
Информационная система, предоставляющая юридическим и/или
физическим лицам функционал по просмотру выставленных счетов и
осуществлению оплаты в пользу поставщиков
Система поддержки плательщиков
СЭД
Система электронного документооборота
СЭД ФК
Система электронного документооборота Федерального
казначейства
Система учета начислений и фактов оплаты
УНИФО
УФК
ФАП ФК
Управление Федерального казначейства РФ по субъекту Российской
Федерации
Фонд алгоритмов и программ Федерального казначейства
ФК
Федеральное казначейство
ЦБ РФ
Центральный Банк Российской Федерации
Наименование системы
Полное наименование системы:
Сервис учета начислений и фактов
оплаты.
Сокращенное наименование системы: Сервис.
Основание для разработки
Основанием для разработки Сервиса является пункт 2 части 1 статьи 7
Федерального закона от 27.07.2010 года № 210-ФЗ «Об организации
предоставления государственных и муниципальных услуг» (в редакции
Федеральным законом от 27.06.2011 года № 162-ФЗ «О внесении изменений
в отдельные законодательные акты Российской Федерации в связи с
принятием Федерального закона «О национальной платежной системе»).
2. Описание сущностей УНИФО
УНИФО оперирует следующими сущностями:
Начисление.
Платеж.
Зачисление.
Квитанция.
Запрос.
Назначения сущностей и состав параметров сущностей приведены в
подпунктах настоящего пункта.
Схематично потоки данных начислений, платежей, зачислений и квитанций
можно представить, как показано на Рисунке № 1. «Схема потоков данных».
Схема потоков данных, затрагивающих УНИФО
Федеральное
казначейство
Информационные системы
поставщиков услуг (ИСП)
Начисления
(выставленные
счета)
Зачисления
(подтверждения
поступлений
средств в УФК)
Платежи,
Зачисления,
Квитанции
ИС УНИФО
Заявки
Начисления
(выставленные
счета)
Начисления
(выставленные
счета)
Портал
государственных услуг
Кредитные организации
Оплата
начислений
Личный кабинет
Система
идентификации и
аутентификации
Платежи
Пользователь
Система
идентификации и
аутентификации
Личный кабинет
Рисунок №1. «Схема потоков данных»
Описание параметров сущностей УНИФО
Сущности УНИФО описаны в формате XSD как XML-типы. Каждый
параметр сущности является тегом XML-типа.
Параметры приводимых сущностей сведены в таблицу со следующими
полями:
Наименование. Наименование тега XML-типа.
Кол-во тегов. Указывает на количество тегов формируемого XML. Формат
поля: <min>..<max>, где <min> - минимальное количество тегов, <max> максимальное количество тегов («n» указывает на неограниченное
количество тегов). Если значение в поле не указано, то присутствует 1 тег.
Тип данных. Возможные значения:
String. Строка произвольной длины.
Date. Дата
Decimal. Вещественное число.
Boolean. Логический тип (Истина/Ложь).
Контейнер. Указывает на присутствие вложенных тегов. Наименования
тегов, вложенных в контейнер, включаются в поле «Наименование» таблицы
параметров со смещением вправо.
Другой тип. В поле «Комментарий» таблицы параметров присутствует
ссылка на соответсвующий пункт, в котором описан тип.
Комментарий. Объясняет назначение тега.
Начисление
Данные начислений, выставляемых администраторами доходов бюджетов –
поставщиками государственных услуг - в адрес физических лиц, приведены в
файле Charge.xsd (пункт 5. «XSD-схемы сущностей УНИФО») и схематично
представлены на Рисунке № 2. «Начисление».
Рисунок № 2. «Начисление»
Таблица № 1 «Тип ChargeType. За основу взят тип Bill»
Наименование
Кол-во
тегов
Тип данных
Комментарий
ChangeStatus
String
TreasureBranch
String
KBK
OKATO
BudgetIndex
0..1
String
String
BudgetIndexType
ApplicationID
UnifiedPayerIdentifier
AltPayerIdentifier
0..1
0..1
0..1
String
String
String
Signature
0..1
ds:SignatureType
Статус, отражающий изменение данных
начисления.
Возможные значения:
1 – новое
2 – изменение
УФК, на счет которого должны поступать
средства плательщика
КБК, указанный в начислении
Код ОКАТО, указанный в начислении
Дополнительные реквизиты платежа,
заполняемые в платёжном поручении
при оплате гос. услуги
Уникальный идентификатор заявки
Единый идентификатор плательщика
Альтернативный идентификатор
плательщика
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта XMLSignature находится в сети Интернет по
адресу http://www.w3.org/TR/xmldsigcore/)
Платеж
Данные о платежах, импортируемых в УНИФО из кредитно-финансовых
организаций, приведены в файле Payment.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлены на Рисунке № 3.
«Платеж».
Рисунок № 3. «Платеж»
Таблица № 2 «Тип PaymentInfoType»
Наименование
Кол-во
тегов
Тип данных
Комментарий
Данные платежного поручения.
ChangeStatus
Расширение
PaymentType
String
payeeINN
String
payeeKPP
String
KBK
OKATO
Signature
String
String
ds:SignatureType
PaymentInfoType
0..1
Статус, отражающий изменение
данных платежа.
Возможные значения:
1 – новое
2 – изменение
ИНН получателя (администратора
доходов)
КПП получателя (администратора
доходов)
Код КБК
Код ОКАТО
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Зачисление
Данные о зачислениях, импортируемых в УНИФО из СЭД УФК,
приведены в файле Payment.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлены на Рисунке № 4.
«Зачисление».
Рисунок № 4. «Зачисление»
Таблица № 3 «Тип IncomeInfo»
Наименование
Кол-во
тегов
Тип данных
Комментарий
ChangeStatus
String
ConsDocNumber
String
ConsDocDate
Date
Статус, отражающий изменение данных
зачисления.
Возможные значения:
1 – новое
2 – изменение
Порядковый номер электронного
сообщения, содержащего сводное п/п
Дата электронного сообщения,
содержащего сводное п/п
Наименование
Кол-во
тегов
Тип данных
Комментарий
payeeINN
String
payeeKPP
String
KBK
OKATO
IncomeRows
IncomeRow
1..n
String
String
Контейнер
PaymentType
Signature
0..1
ds:SignatureType
ИНН получателя (администратора
доходов)
КПП получателя (администратора
доходов)
Код КБК
Код ОКАТО
Перечень строк зачисления
Данные строки зачисления с
информацией о единичном платеже.
Цифровая подпись xml-документа. В теге
содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта XMLSignature находится в сети Интернет по
адресу http://www.w3.org/TR/xmldsigcore/)
Квитанция
Данные о квитанциях, содержащих данные результатов квитирования
начислений с платежами и с зачислениями, приведены в файле Quittance.xsd
(пункт 5 «XSD-схемы сущностей УНИФО») и схематично представлены на
Рисунке № 5. «Квитанция».
Рисунок № 5. «Квитанция»
Таблица № 4 «Тип QuittanceType»
Наименование
Тип данных
Комментарий
SupplierBillID
Кол-во
тегов
0..1
String
ApplicationID
payeeINN
0..1
0..1
String
String
payeeKPP
0..1
String
KBK
0..1
String
OKATO
0..1
String
Balance
0..1
Long
PayerIdentifier
0..1
String
Уникальный идентификатор начисления в
ИСП. Значение совпадает со значением
одноименного тега типа Bill, являющегося
базовым для начислений.
Уникальный идентификатор заявки
ИНН получателя (администратора доходов).
Заполняется в случае несовпадения этого
реквизита в данных платежа или зачисления
с данными начисления.
КПП получателя (администратора доходов).
Заполняется в случае несовпадения этого
реквизита в данных платежа или зачисления
с данными начисления.
Код бюджетной классификации. Заполняется
в случае несовпадения этого реквизита в
данных платежа или зачисления с данными
начисления.
Код ОКАТО. Заполняется в случае
несовпадения этого реквизита в данных
платежа или зачисления с данными
начисления.
Сумма в рублях РФ. Целое число,
показывающее сумму в копейках.
Заполняется в случае несовпадения суммы
платежа или зачисления с суммой
начисления.
Уникальный идентификатор плательщика
(единый или альтернативный). Заполняется в
случае несовпадения этого реквизита в
данных платежа или зачисления с данными
начисления.
Дата квитирования (создания квитанции)
Статус, присвоенный начислению (счету) при
создании Квитанции.
Возможные значения:
1 - сквитировано
2 - предварительно сквитировано
Данные, необходимые для идентификации
зачисления, сквитированного с начислением.
Наличие данного тега исключает появление
тега PaymentIdentificationData.
Данные, необходимые для идентификации
платежа, сквитированного с начислением.
Наличие данного тега исключает появление
тега IncomeIdentificationData.
CreationDate
BillStatus
Date
String
IncomeIdentificationDa
ta
0..1
PaymentIdentifi
cationDataType
PaymentIdentificationD
ata
0..1
PaymentIdentifi
cationDataType
Вспомогательные типы
Тип Organization
Тип предназначен для описания данных организаций, являющимися
поставщиками услуг, обслуживаемых УНИФО.
Описание типа приведено в файле Оrganization.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 6.
«Организация».
Рисунок № 6. «Организация»
Таблица № 5 «Тип OrganizationType»
Наименование
Name
INN
KPP
OGRN
Account
Addresses
Address
Кол-во тегов Тип данных
String
String
String
0..1
String
1..n
AccountType
0..1
Контейнер
1..n
AddressType
Комментарий
Наименование организации
ИНН
КПП организации
ОГРН
Перечень банковских счетов.
Перечень адресов организации.
Наименование
Contacts
Contact
Кол-во тегов Тип данных
0..1
Контейнер
1..n
ContactInfoType
Комментарий
Перечень контактов организации
Тип AccountType
Тип предназначен для описания данных банковских счетов УФК для
зачисления поступлений в бюджеты бюджетной системы РФ.
Описание типа приведено в файле Organization.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 7. «Счета
организаций».
Рисунок № 7. «Счета организаций»
Таблица № 6 «Атрибуты типа AccountType»
Наименование
kind
Кол-во
тегов
0..1
Тип данных
Комментарий
String
Тип банковского счета.
Возможные значения:
1 - расчетный
2 - текущий
3 – корреспондентский
При отсутствии тега тип счета принимается равным
1
Таблица № 7 «Элементы типа AccountType»
Наименование
Кол-во
Тип данных
тегов
Комментарий
Account
SubAccount
Номер банковского счета.
Номер субсчета.
0..1
AccountNumType
String
Наименование
Кол-во
тегов
Bank
Тип данных
Комментарий
BankType
Данные Банка, в котором открыт
счет.
Тип BankType
Тип предназначен для описания данных банков, в которых открыты счета
УФК.
Описание типа приведено в файле Organization.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 8. «Банк».
Рисунок № 8. «Банк»
Таблица № 8 «Тип BankType»
Наименование
Кол-во
тегов
Тип данных
Комментарий
Name
0..1
String
CorrespondentBankAccount
BIK
0..1
String
String
Наименование Банка, в котором
открыт счет
Номер коррсчета Банка в ЦБ РФ
БИК Банка, в котором открыт
счет. Наличие этого тега
исключает тег SWIFT.
Наименование
Кол-во
тегов
SWIFT
Address
Contacts
Contact
0..1
0..1
1..n
Тип данных
Комментарий
String
Код SWIFT Банка, в котором
открыт счет. Наличие этого тега
исключает тег BIK.
Адрес банка.
AddressType
Контейнер
ContactInfoType
Перечень контактов банка
Тип AddressType
Тип предназначен для описания данных адреса.
Описание типа приведено в файле Сommon.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 9. «Адрес».
Рисунок № 9. «Адрес»
Таблица № 9 «Атрибуты типа AddressType»
Наименование
AddressKind
Кол-во
тегов
0..1
Тип данных
Комментарий
String
Вид адреса
Возможные значения:
1 - юридический
2 - фактический
3 - почтовый
Таблица № 10 «Элементы типа AddressType»
Наименование
Кол-во
Тип данных
тегов
Комментарий
Наименование
View
Comment
AddressField
Кол-во
тегов
0..1
0..10
Type
Value
Тип данных
Комментарий
String
String
Контейнер
Строковое представление адреса.
Произвольный комментарий.
Структурированный адрес контрагента или
любого другого участника бизнес-процесса
Тип элемента адреса
Значение элемента структурированного
адреса
AddressKindType
String
Тип ContactInfoType
Тип предназначен для описания данных контакта организации, будь то
телефон, e-mail, факс и т.д.
Описание типа приведено в файле Сommon.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 10.
«Контакты».
Рисунок № 10. «Контакты»
Таблица № 11 «Тип ContactInfoType»
Наименование
Кол-во тегов
Тип данных
Комментарий
Kind
String
Value
Comment
String
String
Вид контакта.
Возможные значения:
"Internal number"
"Work phone" – рабочий телефон
"Mobile phone" – мобильный телефон
"Home phone" – домашний телефон
"Pager" – номер пейджера
"Fax" - факс
"Mail" – электронная почта
"ICQ" – номер ICQ
"Web site" – веб-сайт
Значение контакта.
Произвольный комментарий.
0..1
Тип Bill
Базовый тип для описания начислений, выставляемых поставщиками услуг
(администраторами доходов бюджетов).
Описание типа приведено в файле Bill.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлено на Рисунке № 11. «Счет».
Рисунок № 11. «Счет»
Таблица № 12 «Атрибуты типа Bill»
Наименование
SupplierBillID
Кол-во
тегов
Тип данных
Комментарий
String
Уникальный идентификатор начисления (счета).
Таблица № 13 «Элементы типа Bill»
Наименование
Кол-во тегов Тип данных
BillDate
ValidUntil
0..1
Date
Date
SupplierOrgInfo
BillFor
0..1
Organization
String
TotalAmount
URL
AdditionalData
FieldName
FieldValue
Long
0..1
0..n
AnyURI
Контейнер
String
String
Комментарий
Дата выставления начисления (счета)
Дата, вплоть до которой актуален выставленный
счет
Данные поставщика, указанные в счете
Наименование начисления.
Описание, за что выставлен счет
Полная сумма начисления (счета). Целое число,
показывающее сумму в копейках.
URL печатной формы счета
Дополнительные поля счета
Наименование поля
Значение поля
Тип PaymentType
Тип является базовым для строки зачисления и для описания данных
платежа.
Описание типа приведено в файле Payment.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 12. «Данные
платежа».
Рисунок № 12. «Данные платежа»
Таблица № 14 «Тип PaymentType»
Наименование
Тип данных
Комментарий
SupplierBillID
Кол-во
тегов
0..1
String
ApplicationID
0..1
String
Narrative
Amount
0..1
String
Long
Уникальный идентификатор
начисления в ИСП.
Уникальный идентификатор
заявки
Назначение платежа
Полная сумма. Целое число,
показывающее сумму в копейках.
Дата произведения платежа
PaymentDate
Date
Наименование
BudgetIndex
Кол-во
тегов
0..1
PaymentIdentificationData
PayerIdentifier
Тип данных
Комментарий
BudgetIndexType
Дополнительные реквизиты
платежа, заполняемые в
платёжном поручении при оплате
гос. услуги
Данные, необходимые для
идентификации платежного
поручения.
Уникальный идентификатор
плательщика (единый или
альтернативный).
PaymentIdentificationDataType
0..1
String
Тип PaymentIdentificationDataType
Тип описывает данные, необходимые и достаточные для идентификации
платежа или строки зачисления.
Описание типа приведено в файле PaymentInfo.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 13.
«Идентификация платежа».
Рисунок № 13. «Идентификация платежа»
Таблица № 15 «PaymentIdentificationDataType»
Наименование
Кол-во
тегов
Тип данных
Комментарий
Bank
BankType
SystemIdentifier
String
Данные Банка плательщика.
Обязателен к заполнению только код
БИК или SWIFT.
Уникальный1 системный
идентификатор платежа,
присваиваемый Банком плательщика.
Рекомендуется в качестве
идентификатора платежа указывать
UUID (GUID), описанный в главе 0.
Тип BudgetIndexType
Тип описывает дополнительные реквизиты платежа, заполняемые в
платёжном поручении при оплате гос. услуги.
1 Уникальность системного идентификатора должна быть обеспечена на всё время работы
УНИФО.
Описание типа приведено в файле BudgetIndex.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 14.
«Дополнительные реквизиты платежа на оплату гос. услуги».
Рисунок № 14. «Дополнительные реквизиты платежа на оплату гос. услуги»
Таблица № 16 «Тип BudgetIndexType»
Наименование
Кол-во Тип данных
Комментарий
тегов
Наименование
Кол-во
тегов
Тип данных
Комментарий
Status
String
PaymentType
String
Статус плательщика (физического
лица):
Перечень возможных значений
02 | 08 | 09 | 10 | 11 | 12 | 13 | 14 | 0
02 -налоговый агент,
08 - плательщик иных обязательных
платежей
09 - налогоплательщик (плательщик
сборов) – индивидуальный
предприниматель,
10 - налогоплательщик (плательщик
сборов) – частный нотариус ,
11 - налогоплательщик (плательщик
сборов) – адвокат, учредивший
адвокатский кабинет ,
12 - налогоплательщик (плательщик
сборов) – глава крестьянского
(фермерского) хозяйства
13 налогоплательщик (плательщик
сборов) – иное физическое лицо –
клиент банка (владелец счета)
14 - налогоплательщик,
производящий выплаты физическим
лицам (п.п. 1 п.1 ст. 235 Налогового
кодекса Российской Федерации),
0 – для начислений и платежей не в
пользу ФНС
Тип платежа
Перечень возможных значений:
Принимает значение: ПЕ | ПЦ | 0
"ПЕ" - уплата пени;
"ПЦ" - уплата процентов.
0 - При уплате налога, сбора, платежа,
пошлины, взноса, аванса
(предоплаты), налоговых санкций,
установленных Налоговым кодексом
Российской Федерации,
административных штрафов, иных
штрафов, установленных
соответствующими
законодательными или иными
нормативными актами
Наименование
Тип данных
Комментарий
Purpose
String
TaxPeriod
String
Основание платежа
Перечень возможных значений:
ТП | ЗД | ТР | PC | ОТ | АП | АР | 0
ТП - платежи текущего года;
ЗД - добровольное погашение
задолженности по истекшим
налоговым периодам при отсутствии
требования об уплате налогов
(сборов) от налогового органа;
ТР - погашение задолженности по
требованию об уплате налогов
(сборов) от налогового органа;
PC - погашение рассроченной
задолженности;
ОТ - погашение отсроченной
задолженности;
АП - погашение задолженности по
акту проверки;
АР - погашение задолженности по
исполнительному документу.
0 – для начислений и платежей не в
пользу ФНС
Налоговый период
Значение по умолчанию: «0».
Показатель номера документа
Показатель даты документа
TaxDocNumber
TaxDocDate
Кол-во
тегов
0..1
0..1
String
String
Простые типы
Тип AccountNumType
Тип предназначен для описания номера банковского счета.
Основан на типе xsd:string, ограничен 20 знаками.
Тип AddressKindType
Тип предназначен для описания элемента адреса.
Основан на типе xsd:string.
Возможные значения:
«Zip» - Почтовый индекс,
«Country» - Страна,
«Region» - Регион,
«State» - Район,
«Town» - Населенный пункт,
«City» - Город,
«Street» - Улица,
«House» - Дом,
«Building» - Корпус,
«Flat» - Квартира.
Тип UUID
Тип предназначен для описания глобального идентификатора.
Основан на типе xsd:string, ограничен 36 знаками, маска ввода: «([0-9]|[af]|[A-F]){8}(-([0-9]|[a-f]|[A-F]){4})(-([0-9]|[a-f]|[A-F]){4})(-([0-9]|[a-f]|[AF]){4})(-([0-9]|[a-f]|[A-F]){12})»
Порядок взаимодействия Сервиса с УНИФО
Взаимодействие Сервиса с УНИФО реализовано как посредством СЭД ФК с
использованием передачи файлов, так и посредством веб-сервиса,
развёрнутого на стороне УНИФО. Данные между системами передаются в
формате согласно системному проекту по внедрению технологии оказания
услуг по учету начислений и факту оплаты физическими лицами,
государственных пошлин, денежных платежей (штрафов) и сборов.
Структура имен файлов при взаимодействии посредством СЭД ФК
Файлам, формируемым УНИФО, необходимо присваивать имена так, чтобы
обеспечить их автоматическую маршрутизацию между участниками
процесса.
Для этого имя файла с информацией должно иметь следующую структуру:
MDTTNNNNYYYYYYYYXXXXXSSSSFFFFFFFFZZZZZPPPP,
где:
1-й разряд. M – месяц формирования файла: 1–9, A–C в 36-ричной системе.
2-й разряд. D – день месяца формирования файла: 1–9, A–V в 36-ричной
системе;
3-4-й разряды. TT – тип документа. Возможны следующие типы документов:
01 - начисление;
02 – платеж;
03 – зачисление;
04 – результаты квитирования;
05 – запрос;
07 – техническая квитанция о результатах принятия информации.
5-8-й разряды. NNNN – порядковый номер файла за дату формирования: 0–9,
A–Z в 36-ричной системе;
9-16-й разряды. YYYYYYYY – код бюджета организации отправителя. Для
файлов, направляемых в УНИФО участниками Пилотного проекта,
указывается значение кода бюджета из справочника бюджетов. Для файлов,
формируемых УНИФО, указывается значение «00000000»;
17-21-й разряды. XXXXX – код организации отправителя – УБП или НУБП.
Для файлов, направляемых в УНИФО участниками Пилотного проекта,
указывается значение в соответствии с кодом организации-отправителя,
присвоенным в справочниках участников и неучастников бюджетного
процесса. Для файлов, формируемых УНИФО, указывается значение
«00000»;
22-25-й разряды. SSSS – код ТОФК организации-отправителя. Для файлов,
формируемых УНИФО, указывается значение «9500». Для файлов,
формируемых участниками Пилотного проекта, указывается значение
«0000»;
26-33-й разряды. FFFFFFFF – код бюджета организации получателя. Для
файлов, формируемых УНИФО, указывается значение кода бюджета из
справочника бюджетов. Для файлов, направляемых в УНИФО участниками
Пилотного проекта, указывается значение «00000000»;
34-38-й разряды. ZZZZZ – код организации получателя – УБП или НУБП.
Для файлов, формируемых УНИФО, указывается значение в соответствии с
кодом организации-получателя, присвоенным в справочниках участников и
неучастников бюджетного процесса. Для файлов, направляемых в УНИФО
участниками Пилотного проекта, указывается значение «00000»;
39-42-й разряды. PPPP – код ТОФК организации-получателя. Для файлов,
направляемых в УНИФО участниками Пилотного проекта, указывается
значение «9500». Для файлов, формируемых УНИФО, указывается значение
«0000».
Расширение формируемого файла должно быть «xml».
Порядок обработки файлов запросов
УНИФО принимает от внешних информационных систем файл с именем,
соответствующим структуре, описанной в пункте 3.1. «Структура имен
файла», и расширением zip. В файле должен быть архив с 2 другими
файлами: файлом с информацией запроса (.xml) и с файлом ЭЦП (.isf).
В ходе обработки файла запроса УНИФО формирует файл ответа и
выкладывает его в каталог выгрузки для СЭД ФК.
Порядок формирования файлов ответов
По результатам обработки файла с запросом, вне зависимости от результата
обработки файла, необходимо формировать файл с ответом и отправлять его
инициатору запроса.
При сбое в обработке файла с запросом файл ответа должен содержать
информацию о произошедшем сбое.
Имя ответного файла должно формироваться по следующему алгоритму:
Разряды M и D формируются на основании текущей даты на сервере
УНИФО.
Разряды TT формируются на основании данных файла запроса согласно
алгоритму, описанному в пункте 3.1. «Структура имен файла».
Разряды YYYYYYYY, XXXXX, SSSS заполняются значениями, описанными
в пункте 0. «Структура имен файла».
Разряды FFFFFFFF, ZZZZZ, PPPP заполняются значениями из разрядов
YYYYYYYY, XXXXX, SSSS принятого файла запроса соответственно.
Содержание файла представлено в пункте 5. «XSD-схемы сущностей
УНИФО».
Порядок взаимодействия внешних информационных систем с УНИФО
посредством СЭД ФК
Информационная система при взаимодействии с УНИФО выгружает запросы
к УНИФО в СЭД ФК в виде файла с расширением xml с именем,
соответствующим структуре, описанной в пункте 3.1. «Структура имен
файла».
Информационная система получает ответ от УНИФО посредством СЭД ФК в
виде файла архива с расширением zip, содержащим 2 файла: файл с данными
с расширением xml и файл с ЭЦП с расширением isf. Наименования всех
файлов в ответе описано в пункте «Порядок формирования файлов ответов».
Порядок обработки запросов к веб-сервису
Веб-сервис УНИФО принимает от внешних информационных систем
запросы, в ходе обработки которых УНИФО формирует ответ и возвращает
его во внешнюю систему.
Порядок формирования ответов веб-сервиса
По результатам обработки запроса к методу веб-сервиса, вне зависимости от
результата его обработки, необходимо формировать ответ веб-сервиса и
возвращать его инициатору запроса.
При сбое в обработке запроса ответ должен содержать информацию о
произошедшем сбое.
Содержание ответов УНИФО
Данные об ошибках, возникающих в процессе загрузки документов,
представлены в пункте 0.
Форматы запросов и ответов УНИФО
Взаимодействие УНИФО с внешними информационными системами
реализовано посредством СЭД ФК с использованием передачи файлов в
формате XML и посредством веб-сервиса, развёрнутого на стороне УНИФО.
В подглавах данной главы приведены форматы запросов к УНИФО
передаваемых, как посредством СЭД ФК, так и посредством веб-сервиса и
форматы ответов в разрезе функциональности УНИФО.
Все типы запросов являются расширениями типа RequestTemplate,
описанного в пункте 5. «XSD-схемы сущностей УНИФО».
Экспорт начислений, зачислений, платежей и квитанций из УНИФО
Экспорт начислений, зачислений, платежей и квитанций из УНИФО
посредством СЭД ФК
Файлы запросов на экспорт начислений, зачислений, платежей и квитанций
имеет одинаковую структуру, которая приведена в файле DataRequest.xsd
(пункт 5. «XSD-схемы сущностей УНИФО») и схематично представлена на
Рисунке № 15. «Запрос на экспорт начислений, платежей, зачислений и
квитанций».
Рисунок № 15. «Запрос на экспорт начислений, платежей, зачислений и
квитанций»
Таблица № 17 «Тип DataRequest»
Наименование
Тип данных
Комментарий
SupplierBillIDs
Кол-во
тегов
0..1
Контейнер
SupplierBillID
1..n
Xsd:string
Payers
0..1
Контейнер
PayerIdentifier
1..n
Xsd:string
ApplicationIDs
0..1
Контейнер
ApplicationID
Signature
1..n
0..1
Xsd:string
ds:SignatureType
Перечень УИН, по которым
запрашиваются начисления, платежи,
зачисления и квитанции.
Уникальный идентификатор
начисления
Перечень идентификаторов
плательщиков, по которым
запрашиваются начисления, платежи,
зачисления и квитанции.
Единый или альтернативный
идентификатор плательщика
Перечень заявок, по которым
запрашиваются начисления, платежи,
зачисления и квитанции.
Уникальный идентификатор заявки
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Экспорт начислений, зачислений, платежей и квитанций из УНИФО
посредством вызова метода веб-сервиса
Экспорт начислений, зачислений, платежей и квитанций осуществляется
посредством вызова метода exportData веб-сервиса УНИФО. Описание
метода exportData приведено в файлах wsgateService.wsdl и wsgate.wsdl
(пункт 6. «WSDL веб-сервиса УНИФО»). Запросы на экспорт начислений,
зачислений, платежей и квитанций имеют одинаковую структуру, которая
приведена в файле DataRequest.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и полностью соответсвуют формату файла запросов на экспорт
начислений, зачислений, платежей и квитанций, описанному в главе 0.
Экспорт начислений из УНИФО
Экспорт начислений из УНИФО посредством СЭД ФК
Файл запроса
Структура файлов запросов на экспорт начислений описана в пункте 5.
«XSD-схемы сущностей УНИФО».
Значение атрибута kind = CHARGE
Файл ответа
Структура файлов ответов на запрос на экспорт начислений приведена в
файле ExportChargesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 16. «Экспорт
начислений из УНИФО. Файл ответа».
Рисунок № 16. «Экспорт начислений из УНИФО. Файл ответа»
Таблица № 18 «Тип ExportChargesResponse»
Наименование
Charges
ChargeInfo
ChargeData
ChargeSignature
Кол-во
тегов
0..1
1..n
Тип данных
Комментарий
Контейнер
Контейнер
xsd:Base64Binary
0..1
xsd:Base64Binary
Перечень начислений.
Данные начисления
Данные файла с начислением,
импортированным в УНИФО из
ИС АДБ.
Данные файла ЭЦП к файлу с
начислением, импортированным
в УНИФО из ИС АДБ.
Остаток задолженности по
начислению (в копейках).
Не заполняются для данного
запроса
Не заполняются для данного
запроса
AmountToPay
xsd:long
QuittanceWithPaymentStatus
0..1
xsd:string
QuittanceWithIncomeStatus
0..1
xsd:string
Наименование
Signature
Кол-во
тегов
0..1
Тип данных
Комментарий
ds:SignatureType
Цифровая подпись xmlдокумента. В теге содержатся
реквизиты цифровой подписи,
соответствующие стандарту XMLSignature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsigcore/)
Экспорт начислений из УНИФО посредством вызова метода веб-сервиса
Формат запроса
Структура запросов на экспорт начислений описана в пункте 5. «XSD-схемы
сущностей УНИФО».
Значение атрибута kind = CHARGE
Формат ответа
Структура ответа на запрос к веб-сервису на экспорт начислений приведена в
файле ExportChargesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунок № 16. «Экспорт
начислений из УНИФО. Файл ответа».
Экспорт начислений и статусов их квитирования из УНИФО
Экспорт начислений и статусов их квитирования из УНИФО посредством
СЭД ФК
Файл запроса
Структура файлов запросов на экспорт начислений и статусов их
квитирования описана в пункте 5. «XSD-схемы сущностей УНИФО».
Значение атрибута kind = CHARGESTATUS
Файл ответа
Структура файлов ответов на запрос на экспорт начислений приведена в
файле ExportChargesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 17. «Экспорт
начислений и статусов их квитирования из УНИФО. Файл ответа».
Рисунок № 17. «Экспорт начислений и статусов их квитирования из УНИФО.
Файл ответа»
Таблица № 19 «Тип ExportChargesResponse»
Наименование
Charges
ChargeInfo
ChargeData
ChargeSignature
Кол-во
тегов
0..1
1..n
Тип данных
Комментарий
Контейнер
Контейнер
xsd:Base64Binary
0..1
xsd:Base64Binary
Перечень начислений.
Данные начисления
Данные файла с начислением,
импортированным в УНИФО из
ИС АДБ.
Данные файла ЭЦП к файлу с
начислением, импортированным
в УНИФО из ИС АДБ.
Остаток задолженности по
начислению (в копейках).
Статус квитирования с платежами
(запролнен всегда).
Статус квитирования со строками
зачислений (запролнен всегда).
AmountToPay
xsd:long
QuittanceWithPaymentStatus
0..1
xsd:string
QuittanceWithIncomeStatus
0..1
xsd:string
Наименование
Signature
Кол-во
тегов
0..1
Тип данных
Комментарий
ds:SignatureType
Цифровая подпись xmlдокумента. В теге содержатся
реквизиты цифровой подписи,
соответствующие стандарту XMLSignature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsigcore/)
Экспорт начислений и статусов их квитирования из УНИФО посредством
вызова метода веб-сервиса
Формат запроса
Структура запросов на экспорт начислений и статусов их квитирования
описана в пункте 5. «XSD-схемы сущностей УНИФО».
Значение атрибута kind = CHARGESTATUS
Формат ответа
Структура ответа на запрос к веб-сервису на экспорт начислений приведена в
файле ExportChargesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунок №17. «Экспорт
начислений и статусов их квитирования из УНИФО. Файл ответа».
Экспорт зачислений из УНИФО
Экспорт зачислений из УНИФО посредством СЭД ФК
Файл запроса
Структура файлов запросов на экспорт зачислений описана в пункте 5.
«XSD-схемы сущностей УНИФО».
Значение атрибута kind = INCOME
Файл ответа
Структура файлов ответов на запрос на экспорт зачислений приведена в
файле ExportIncomesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 18. «Экспорт
зачислений из УНИФО. Файл ответа».
Рисунок № 18. «Экспорт зачислений из УНИФО. Файл ответа»
Таблица № 20 «Тип ExportIncomesResponse»
Наименование
Incomes
IncomeInfo
IncomeData
IncomeSignature
Signature
Кол-во
тегов
0..1
1..n
Тип данных
Комментарий
0..1
Контейнер
Контейнер
xsd:Base64Binary
xsd:Base64Binary
0..1
ds:SignatureType
Перечень зачислений
Данные зачисления
Данные файла с зачислением.
Данные файла ЭЦП к файлу с
зачислением.
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Экспорт зачислениий из УНИФО посредством вызова метода веб-сервиса
Формат запроса
Структура запросов на экспорт зачислений описана в пункте 5. «XSD-схемы
сущностей УНИФО».
Значение атрибута kind = INCOME
Формат ответа
Структура ответа на запрос к веб-сервису на экспорт зачислений приведена в
файле ExportIncomesResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 18. «Экспорт
зачислений из УНИФО. Файл ответа».
Экспорт платежей из УНИФО
Экспорт платежей из УНИФО посредством СЭД ФК
Файл запроса
Структура файлов запросов на экспорт платежей описана в пункте 5. «XSDсхемы сущностей УНИФО».
Значение атрибута kind = PAYMENT
Файл ответа
Структура файлов ответов на запрос на экспорт платежей приведена в файле
ExportPaymentsResponse.xsd (пункт 5. «XSD-схемы сущностей УНИФО») и
схематично представлена на Рисунке № 19. «Экспорт платежей из УНИФО.
Файл ответа».
Рисунок № 19. «Экспорт платежей из УНИФО. Файл ответа»
Таблица № 21 «Тип ExportPaymentsResponse»
Наименование
Кол-во
тегов
0..1
1..n
Тип данных
Комментарий
Контейнер
Контейнер
xsd:Base64Binary
PaymentSignature
0..1
xsd:Base64Binary
Signature
0..1
ds:SignatureType
Перечень платежей
Данные платежа
Данные файла с платежом,
импортированным в УНИФО из ИС
кредитной организации.
Данные файла ЭЦП к файлу с
платежом, импортированным в
УНИФО из ИС кредитной
организации.
Цифровая подпись xml-документа. В
теге содержатся реквизиты
цифровой подписи,
соответствующие стандарту XMLSignature (описание стандарта XMLSignature находится в сети Интернет
по адресу
http://www.w3.org/TR/xmldsig-core/)
Payments
PaymentInfo
PaymentData
Экспорт платежей из УНИФО посредством вызова метода веб-сервиса
Формат запроса
Структура запросов на экспорт платежей описана в пункте 5. «XSD-схемы
сущностей УНИФО».
Значение атрибута kind = PAYMENT
Формат ответа
Структура ответа на запрос к веб-сервису на экспорт платежей приведена в
файле ExportPaymentsResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 19. «Экспорт платежей
из УНИФО. Файл ответа».
Экспорт квитанций из УНИФО
Экспорт квитанций из УНИФО посредством СЭД ФК
Файл запроса
Структура файлов запросов на экспорт платежей описана в пункте 5. «XSDсхемы сущностей УНИФО».
Значение атрибута kind = QUITTANCE
Файл ответа
Структура файлов ответов на запрос на экспорт квитанций приведена в
файле ExportQuittanceResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 20. «Экспорт квитанций
из УНИФО. Файл ответа».
Рисунок № 20. «Экспорт квитанций из УНИФО. Файл ответа»
Таблица № 22 «Тип ExportQuittanceResponse»
Наименование
Кол-во
Тип данных
тегов
Quittances
0..1
Контейнер
Quittance
1..n
QuittanceType
Signature
0..1
ds:SignatureType
Комментарий
Перечень квитанций.
Данные Квитанции.
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Экспорт квитанций из УНИФО посредством вызова метода веб-сервиса
Формат запроса
Структура запросов на экспорт платежей описана в пункте 5. «XSD-схемы
сущностей УНИФО».
Значение атрибута kind = QUITTANCE
Формат ответа
Структура ответа на запрос к веб-сервису на экспорт квитанций приведена в
файле ExportQuittanceResponse.xsd (пункт 5. «XSD-схемы сущностей
УНИФО») и схематично представлена на Рисунке № 20. «Экспорт квитанций
из УНИФО. Файл ответа».
Импорт начислений, зачислений и платежей в УНИФО из внешних систем
Импорт начислений, зачислений и платежей в УНИФО из внешних систем
посредством СЭД ФК
Файл запроса
Структуры файлов запросов на импорт начислений, зачислений и платежей
соответствуют структурам соответсвующих сущностей УНИФО, описанным
в пункте 0. «Сущности УНИФО» и пункте 5. «XSD-схемы сущностей
УНИФО».
Файл ответа
Структура файлов ответов на запрос на импорт начислений, зачислений,
платежей и квитанций соответсвует структуре тега Ticket «Техническая
квитанция», приведённом в файле Ticket.xsd (пункт 5. «XSD-схемы
сущностей УНИФО»).
Импорт начислений, зачислений и платежей в УНИФО из внешних систем
посредством вызова метода веб-сервиса
Импорт начислений, зачислений и платежей осуществляется посредством
вызова метода ImportData веб-сервиса УНИФО. Описание метода ImportData
приведено в файлах wsgateService.wsdl и wsgate.wsdl (пункт 6. «WSDL вебсервиса УНИФО»).
Формат запроса
Запросы на импорт начислений, зачислений и платежей имеют одинаковую
структуру, которая приведена в файле ImportRequest.xsd (пункт 5. «XSDсхемы сущностей УНИФО») и схематично представлена на Рисунке № 21.
«Импорт начислений, зачислений, платежей и квитанций из УНИФО. Запрос
к веб-сервису».
Рисунок № 21. «Импорт начислений, зачислений, платежей и квитанций из
УНИФО. Запрос к веб-сервису»
Таблица № 23 «Тип ImportRequest»
Наименование
Тип данных
Комментарий
PostBlock
Charge
Кол-во
тегов
1
1
PostBlock
ChargeType
StartPayment
FinalPayment
1
PaymentInfoType
Income
1
IncomeInfoType
Блок почтовой информации
Данные начисления. Наличие этого
тега исключает присутствие в запросе
тегов FinalPayment и Income
Не используется
Данные платежа. Наличие этого тега
исключает присутствие в запросе
тегов Charge и Income
Данные зачисления. Наличие этого
тега исключает присутствие в запросе
тегов Charge и FinalPayment
Наименование
Signature
Кол-во
тегов
0..1
Тип данных
Комментарий
ds:SignatureType
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Формат ответа
Структура ответа на запрос к веб-сервису на импорт начислений, зачислений,
платежей и квитанций соответсвует структуре тега Ticket «Техническая
квитанция», приведённом в файле Ticket.xsd (пункт 5. «XSD-схемы
сущностей УНИФО»).
Вспомогательные типы
Тип RequestTemplate
Тип является базовым для всех запросов к УНИФО.
Описание типа приведено в файле RequestTemplate.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 22. «Базовый
тип запроса к УНИФО».
Рисунок № 22. «Базовый тип запроса к УНИФО»
Таблица № 24 «Тип RequestTemplate»
Наименование
Кол-во
тегов
Тип данных
Комментарий
Наименование
Кол-во
тегов
kind
Тип данных
Комментарий
xsd:string
Тип запрашиваемых объектов:
PAYMENT - платежи,
INCOME - зачисления,
CHARGE – неоплаченные начисления,
CHARGESTATUS - начисления и
статусы их квитирования с платежами
и строками зачислений, включая
оплаченные,
QUITTANCE - результат квитирования
Блок почтовой информации
Начальные дата и время временного
запроса. Время учитывается только
при запросе результатов
квитирования. Значение тега должно
содержать дату и время с указанием
их отклонения от универсального
времени (например, 2011-0209T12:07:00.000+03:00), так как
УНИФО приводит дату и время из
значения тега в соответсвие со своим
часовым поисом
Конечные дата и время временного
запроса. Время учитывается только
при запросе результатов
квитирования. Значение тега должно
содержать дату и время с указанием
их отклонения от универсального
времени (например, 2011-0209T12:07:00.000+03:00), так как
УНИФО приводит дату и время из
значения тега в соответсвие со своим
часовым поисом
PostBlock
StartDate
0..1
PostBlock
dateTime
EndDate
0..1
dateTime
Тип ResponseTemplate
Тип является базовым для всех ответов УНИФО.
Описание типа приведено в файле ResponseTemplate.xsd (пункт 5. «XSDсхемы сущностей УНИФО») и схематично представлено на Рисунке № 23.
«Базовый тип ответа УНИФО».
Рисунок № 23. «Базовый тип ответа УНИФО»
Таблица № 25 «Тип ResponseTemplate»
Наименование
PostBlock
RequestProcessResult
Кол-во
тегов
0..1
Тип данных
Комментарий
PostBlock
ErrInfo
Блок почтовой информации
Результат обработки запроса. При
успешной обработке не включается в
ответ
Тип PostBlock
Тип описывает данные блока почтовой информации в запросах и ответах
УНИФО.
Описание типа приведено в файле PostBlock.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке № 24. «Блок
почтовой информации».
Рисунок № 24. «Блок почтовой информации»
Таблица № 26 «Тип PostBlock»
Наименование
Кол-во
тегов
ID
Тип данных
Комментарий
string
Для запроса: идентификатор запроса
Для ответа: идентификатор запроса,
на который сформирован ответ
Время формирования запроса или
ответа
ИНН/БИК отправителя
TimeStamp
DateTime
SenderIdentifier
Тип ErrInfo
String
Тип описывает данные ошибки обработки запросов к УНИФО.
Описание типа приведено в файле ErrInfo.xsd (пункт 5. «XSD-схемы
сущностей УНИФО») и схематично представлено на Рисунке 25.
«Информация об ошибке».
Рисунок № 25. «Информация об ошибке»
Таблица № 27 «Тип ErrInfo»
Наименование
Кол-во
Тип данных
тегов
ErrorCode
string
ErrorDescription
0..1
string
ErrorData
0..1
String
Комментарий
Код ошибки
Описание ошибки для пользователя
Информация об ошибке для
администратора или системного
анализа
Техническая квитанция
Техническая квитанция (тег Ticket) возвращается в ответе на импорт любой
сущности (начислениея, платёж, зачисление), как при взаимодействии через
СЭД ФК, так и при вызове веб-сервиса. Также она возвращается в ответе при
возникновении ошибки. Описание структуры тега Ticket приведено в файле
Ticket.xsd (пункт 5. «XSD-схемы сущностей УНИФО»), а также схематично
представлено на Рисунке № 26. «Техническая квитанция».
Рисунок № 27. «Техническая квитанция»
Таблица № 28 «Элементы тега Ticket»
Наименование
Кол-во
Тип данных
тегов
PostBlock
PostBlock
RequestProcessResult
0..1
ErrInfo
Комментарий
Блок почтовой информации
Результат обработки запроса. При
успешной обработке не включается в
ответ
Наименование
Кол-во
тегов
0..1
Signature
Тип данных
Комментарий
ds:SignatureType
Цифровая подпись xml-документа. В
теге содержатся реквизиты цифровой
подписи, соответствующие стандарту
XML-Signature (описание стандарта
XML-Signature находится в сети
Интернет по адресу
http://www.w3.org/TR/xmldsig-core/)
Перечень контролей
По результатам приемки файлов необходимо осуществлять контроли и
доводить до автора документа описание выявленных ошибок.
В таблице ниже приводится перечень проводимых контролей и возможных
ошибок.
Таблица № 29 «Перечень контролей»
Описание
Коды
Описание ошибок
Текст в протоколе
контролей
ошибок
(ErrorDescription)
(ErrorCo
de)
Технический
контроль
Валидация файла,
загружаемого через
файловый шлюз
Контроль
взаимодействия со
внешними
системами
1
Ошибка целостности принятого
архива
Ошибка целостности
принятого файла-архива
27
Ошибка проверки ЭЦП запроса к
веб-сервису УНИФО
Произошла ошибка при
проверке ЭЦП. Ваш запрос
не был обработан