Государственная информационная система о государственных и муниципальных платежах “Форматы взаимодействия Государственной информационной системы о государственных и муниципальных платежах с информационными системами участников” версия 1.16.0 (утв. Федеральным казначейством 25 сентября 2014 г.)
Краткое содержание изменений
Глава | Предмет изменения |
---|---|
2.2 Начисление | Внесены теги из отмененного типа Bill. Добавлен тег Origin (для начислений с признаком «предварительное начисление»). Удален атрибут version. Удален атрибут mainSupplierBillID; добавлен контейнер MainSupplierBillIDList. Внесены изменения в структуру элемента ChangeStatus. Возможные значения атрибута ChangeStatus@meaning расширены значением «4» - деаннулирование начисления. Добавлен элемент ChangeStatus/Reason для указания основания аннулирования. Изменена обязательность указания атрибута billDate для возможности импорта предварительных начислений без указания даты и времени начисления суммы, подлежущей уплате. Элемент Signature, в котором должна содержаться подпись под сущностью, стал обязательным. Добавлены элементы DocDispatchDate, AcptTerm, PaytCondition. |
2.3 Платеж | Внесены теги типа PaymentType. Изменен порядок следования тегов. Добавлен атрибут Id, удален элемент ApplicationID, тип элемента PaymentDate изменен на dateTime. Убран атрибут version. Внесены изменения в структуру элемента ChangeStatus. Возможные значения атрибута ChangeStatus@meaning расширены значением «3» - аннулирование платежа. Добавлен элемент ChangeStatus/Reason для указания основания аннулирования. Элемент Signature, в котором должна содержаться подпись под сущностью, стал обязательным. Существенно расширен перечень элементов для передачи полей распоряжения, принятого в банке. |
2.4 Квитанция | Добавлен атрибут Id, удален элемент ApplicationID, добавлены элементы AccountNumber и BIK, добавлено значение «4» для элемента BillStatus, элемент PaymentIdentificationData стал необязательным для заполнения (только в случае, если элемент BillStatus имеет значение «4»). Изменен порядок следования тегов. |
2.5 Вспомогательные типы | Удалено описание типа Bill в связи с переносом его элементов в тип Charge. |
2.5.1 Тип OrganizationType | Удалены теги Contacts и Addresses. |
2.5.2 Тип AccountType | Удалены тег SubAccount и атрибут kind. |
2.5.3 Тип BankType | Изменена маска тега SWIFT. |
2.5.4 PaymentIdentificationDataType | Добавлен тег Other. |
2.5.5 Тип BudgetIndexType | Добавлены ограничения на возможные значения тегов, изменен порядок следования тегов. |
2.5.6 «Простые типы» | Добавлены описания типов INNType, KPPType, OKTMOType, KBKType, OGRNType, BIKType, SWIFTType, SupplierBillIDType, URNType для обозначения, соответственно, ИНН юридических лиц, КПП, кода ОКТМО, КБК, ОГРН, номера банковского счета, БИК, кода SWIFT, УИН, УРН. |
3.1 Идентификация начисления | Изменены алгоритмы формирования УИН. Размер УИН для АН и ГАН, являющихся органами государственной власти субъектов Российской Федерации, органами местного самоуправления, государственными (муниципальными) учреждениями, увеличен до 25 символов. |
3.2 Идентификация плательщика | Внесены изменения в алгоритм формирования идентификатора плательщика для ЮЛ-нерезидента РФ, а добавлен алгоритм формирования идентификатора плательщика для ИП. Изменен алгоритм формирования идентификатора плательщика с использованием СНИЛС. Изменен перечень кодов документов, которые могут использоваться для идентификации плательщика. |
4. Порядок взаимодействия ГИС ГМП с информационными системами участников | Наличие подписи под сущностью стало обязательным. Добавлена ЭП под запросом. |
5 Форматы сообщений веб-сервиса, размещенного в СМЭВ | Изменены форматы сообщений. Описание элемента AppData приведено в соответствии с методическими рекомендациями СМЭВ версии 2.5.6. Добавлен атрибут senderRole для указания полномочия, с которым участник обращается к ГИС ГМП. |
5.2 Порядок импорта новых сущностей, уточнения или аннулирования ранее загруженных сущностей в ГИС ГМП | Реализован пакетный режим импорта, допускающий передачу в ГИС ГМП нескольких сущностей в составе одного сообщения. Метод запроса окончательного статуса обработки пакета описан в главе . Добавлен атрибут originatorID для указания УРН участника, сформировавшего начисление (платеж). |
5.4 Экспорт сущностей из ГИС ГМП | Реализован постраничный режим выгрузки данных, расширены параметры поиска данных. |
5.4.1 Общий формат запроса | Общий формат изменен значительно. В частности, для ГАН добавлена возможность ограничения выборки (фильтр) по ИНН и КПП или УРН участника косвенного взаимодействия. Добавлен фильтр по ОКТМО, КБК; добавлена возможность выборки платежей с УИН, не равным значению «0». Для реализации постраничной выгрузки добавлены атрибуты, показывающие номер страницы выгрузки и число элементов на странице. Добавлены необязательные атрибут originatorID и Signature для передачи УРН и ЭП участника, от имени которого производится запрос. |
5.4.2 Передача ГИС ГМП извещений о начислениях | Добавлены типы запросов PRIORCHARGE, PRIORCHARGENOTFULLMATCHED, PRIORCHARGESTATUS, TEMPCHARGE, TEMPCHARGENOTFULLMATCHED, TEMP CHARGESTATUS для запроса неоплаченных, неполностью сквитированных и предварительных начислений со статусом квитирования соответственно. Определены права участников для выполнение новых запросов. |
5.4.4 Передача ГИС ГМП извещений о приеме к исполнению распоряжений | Изменена логика формирования ответов на запросы платежей, в связи с возможностью аннулирования платежа. Добавлен тип запроса PAYMENTCANCELLED для выгрузки только аннулированных платежей. |
5.5 Квитирование начисления с платежами по инициативе АН/ГАН | Добавлены возможности квитирования начисления с отсутствующим в системе платежом. |
5.6 Квитирование начисления с отсутствующим в ГИС ГМП | Новый раздел. |
5.7 Установление платежу статуса «Услуга предоставлена» | Новый раздел. |
5.8 Формирование начисления с признаком «Предварительное начисление» | Новый раздел. |
5.9 Загрузка и обновление сертификатов ключа проверки ЭП участников | Новый раздел. |
6. Перечень контролей | Значительно расширен перечень контролей. |
Введение
В настоящем документе описываются форматы взаимодействия Государственной информационной системы о государственных и муниципальных платежах (ГИС ГМП) с информационными системами участников.
1. Общие положения
1.1. Термины и обозначения
№ | Термин | Содержание |
---|---|---|
1. | Base64 | Алгоритм кодирования. Идентификатор алгоритма, описывающего преобразования: http://www.ietf.org/rfc/rfc2045#base64. |
2. | GUID | Globally Unique Identifier - статистически уникальный 128-битный идентификатор. |
3. | SOAP | Simple Object Access Protocol - простой протокол обмена структурированными сообщениями. |
4. | SWIFT | Society for Worldwide Interbank Financial Telecommunications - Сообщество всемирных межбанковских финансовых телекоммуникаций. |
5. | URL | Uniform Resource Locator - единообразный локатор (определитель местонахождения) ресурса. |
6. | W3C | World Wide Web Consortium - консорциум Всемирной паутины. |
7. | WSDL | Web Services Description Language - язык описания веб-сервисов. |
8. | XAdES-T | XML Advanced Electronic Signatures (timestamp) - формат улучшенной электронной подписи, накладываемой на XML-структуры, позволяющий запись метки времени. |
9. | XML | Extensible Markup Language - расширяемый язык разметки. |
10. | XSD | XML Schema definition - язык описания структуры XML-документа. Спецификация XML Schema является рекомендацией W3C. |
11. | АЗ | Администратор запросов. |
12. | АН | Администратор начислений. |
13. | АП | Администратор платежей. |
14. | БД | База данных. |
15. | БИК | Банковский идентификационный код. |
16. | Веб-сервис | Программная система, идентифицируемая URI и предназначенная для поддержки интероперабельных межмашинных взаимодействий в сетевой среде. |
17. | ГАЗ | Главный администратор запросов. |
18. | ГАН | Главный администратор начислений. |
19. | ГАП | Главный администратор платежей. |
20. | ГИС ГМП, Система | Государственная информационная система о государственных и муниципальных платежах. |
21. | Извещение о начислении, начисление | Электронный документ, содержащий информацию, необходимую для осуществления перевода денежных средств. |
22. | Извещение об аннулировании начисления, аннулирование начисления | Электронный документ, содержащий информацию об аннулировании ранее направленного в ГИС ГМП извещения о начислении и основание аннулирования. |
23. | Извещение об уточнении начисления, уточнение начисления | Электронный документ, содержащий информацию, уточняющую ранее направленную в извещении о начислении. |
24. | Извещение о приеме к исполнению распоряжений, платеж | Электронный документ, содержащий информацию о приеме к исполнению распоряжения о переводе денежных средств либо наличных денежных средств плательщика при условии достаточности денежных средств для исполнения обязательств. |
25. | Извещение об аннулировании распоряжения, аннулирование платежа | Электронный документ, содержащий информацию об аннулировании ранее направленного в ГИС ГМП извещения о приеме к исполнению распоряжения и основание аннулирования. |
26. | Извещение об уточнении распоряжения, уточнение платежа | Электронный документ, содержащий информацию, уточняющую ранее направленную в извещении о приеме к исполнению распоряжения. |
27. | ИНН | Индивидуальный номер налогоплательщика. |
28. | ИП | Индивидуальный предприниматель. |
29. | ИС | Информационная система. |
30. | КБК | Код бюджетной классификации Российской Федерации. |
31. | КПП | Код причины постановки на учет. |
32. | Начисление с признаком «Предварительное начисление», предварительное начисление | Извещение о начислении, передаваемое АН (ГАН) в ГИС ГМП до факта осуществления АН (ГАН) начисления суммы, подлежащей уплате. |
33. | НПА | Нормативные правовые акты. |
34. | ОГРН | Основной государственный регистрационный номер. |
35. | ОКТМО | Общероссийский классификатор территорий муниципальных образований. |
36. | Орган ЗАГС | Орган записи актов гражданского состояния. |
37. | Параметры квитирования | Параметры, по которым осуществляется сопоставление данных начисления и платежей: УИН, сумма, КБК, код ОКТМО, ИНН, КПП, номер счета, БИК, идентификатор плательщика. |
38. | Подпись под запросом | ЭП, накладываемая на теги ExportRequest, DoAcknowledgmentRequest и их содержимое. |
39. | Подпись под сущностью | ЭП, накладываемая на теги Charge или FinalPayment и их содержимое. |
40. | РФ | Российская Федерация. |
41. | Сертификат ключа проверки ЭП, сертификат | Квалифицированный сертификат ключа проверки электронной подписи. |
42. | СМЭВ | Система межведомственного электронного взаимодействия. |
43. | СНИЛС | Страховой номер индивидуального лицевого счета. |
44. | Сущность | Начисление, платеж (в т.ч. уточнения и аннулирования начислений и платежей), квитанция. |
45. | ТОФК | Территориальный орган Федерального казначейства. |
46. | УИН | Уникальный идентификатор начисления. |
47. | УИП | Уникальный идентификатор платежа. |
48. | УРН | Уникальный регистрационный номер. |
49. | Участник | Участник ГИС ГМП, осуществляющий информационное взаимодействие с ГИС ГМП (администратор начислений, главный администратор начислений, администратор платежей, главный администратор платежей, администратор запросов, главный администратор запросов). |
50. | Участник косвенного взаимодействия | Администратор начислений, администратор платежей и администратор запросов, осуществляющие информационное взаимодействие с ГИС ГМП через главного администратора начислений, главного администратора платежей и главного администратора запросов соответственно. |
51. | Участник прямого взаимодействия | Администратор начислений, администратор платежей и администратор запросов, осуществляющие самостоятельное информационное взаимодействие с ГИС ГМП, а также главный администратор начислений, главный администратор платежей и главный администратор запросов. |
52. | Финансовый орган | Орган, осуществляющий открытие и ведение лицевых счетов в соответствии с бюджетным законодательством Российской Федерации. |
53. | ФК | Федеральное казначейство. |
54. | ФЛ | Физическое лицо. |
55. | ФССП | Федеральная служба судебных приставов. |
56. | ЭП | Электронная подпись. |
57. | ЭП-ОВ | Электронная подпись органа власти, определенная в документе «Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии» версии 2.5.6. |
58. | ЮЛ | Юридическое лицо. |
1.2. Наименование системы
Полное наименование системы: Государственная информационная система о государственных и муниципальных платежах.
Сокращенное наименование системы: ГИС ГМП, Система.
1.3. Информация о версии форматов взаимодействия
Версия форматов - 1.16.0.
2. Сущности ГИС ГМП
ГИС ГМП принимает, хранит и выдает по запросам участников следующие сущности:
Извещение о начислении, извещение об уточнении начисления, извещение об аннулировании начисления (далее при совместном упоминании - начисление);
Извещение о приеме к исполнению распоряжения, извещение об уточнении распоряжения, извещение об аннулировании распоряжения (далее при совместном упоминании - платеж).
ГИС ГМП в результате сопоставления данных начисления и платежей создает новые сущности - квитанции, которые могут быть предоставлены по запросу участника.
Далее в настоящей главе описываются назначения сущностей и состав параметров сущностей. Перемещение сущностей между ГИС ГМП и участниками взаимодействия схематически показано на Рисунке № 1 и фактически осуществляется с учетом полномочий участника.
Рисунок №1 «Потоки данных между ГИС ГМП и участниками взаимодействия»
2.1. Описание параметров сущностей ГИС ГМП и запросов участников
Сущности ГИС ГМП и запросы участников описаны в формате XSD как XML-типы. Каждый параметр является тегом или атрибутом XML-типа.
Параметры сведены в таблицу со следующими полями:
Наименование. Наименование тега или атрибута XML-типа.
Кол-во тегов, обязательность тега или атрибута. Указывает на количество тегов формируемого XML. Формат поля: <min>..<max>, где <min> - минимальное количество тегов, <max> - максимальное количество тегов («n» указывает на неограниченное количество тегов).
Тип данных. Возможные значения:
String. Строка произвольной длины.
unsignedLong. Целое неотрицательное число от 0 до 18446744073709551615.
Long. Целое число от -9223372036854775808 до 9223372036854775807.
Integer. Целое число от -2147483648 до 147483647.
dateTime. Дата и время, формат определен стандартом XML/XSD, опубликованным по адресу http://www.w3.org/TR/xmlschema-2/#dateTime.
Date. Дата, формат определен стандартом XML/XSD, опубликованным по адресу http://www.w3.org/TR/xmlschema-2/#date.
Boolean. Логический тип (Истина/Ложь).
base64Binary. Данные в кодировке Base64, формат определен стандартом XML/XSD, опубликованным по адресу http://www.w3.org/TR/xmlschema-2/#base64Binary.
Контейнер. Указывает на присутствие вложенных тегов. Наименования тегов и атрибутов, вложенных в контейнер, включаются в поле «Наименование» таблицы параметров со смещением вправо.
ID. Уникальный в рамках XML-документа идентификатор, начинающийся с латинской буквы.
Token. Формат определен стандартом XML/XSD, опубликованным по адресу http://www.w3.org/TR/xmlschema-2/#token.
Другой тип. В поле «Тип данных» таблицы присутствует ссылка на соответствующий пункт, в котором описан тип.
Комментарий. Объясняет назначение тега.
2.2. Начисление
Данные начисления описываются типом ChargeType, приведенным в файле Charge.xsd (глава 7. «XML-схемы сущностей XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 1. «Тип ChargeType»
Таблица № 1. «Тип ChargeType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Id (атрибут) | 1, обязателен | ID | Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>. |
SupplierBillID (атрибут) | 1, обязательно | SupplierBillIDType (описание см. в п. 2.5.6.9) | УИН. Алгоритм формирования УИН описан в главе 3.1. |
BillDate (атрибут) | 1, обязательно | dateTime | Дата и время начисления суммы, подлежащей уплате плательщиком. Заполнение атрибута является обязательным для всех начислений, в том числе для начислений с признаком «Предварительное начисление». |
ValidUntil | 0..1, необязательно | Date | Дата, вплоть до которой актуально выставленное начисление. |
DocDispatchDate | 0..1, необязательно | Date | Дата отсылки (вручения) плательщику документов в случае, если эти документы были отосланы (вручены) получателем средств плательщику. |
MainSupplierBillIDList | 0..1, необязательно | Контейнер | Уникальные идентификаторы начислений, на основании которых выставлено данное начисление (до 9 штук). Заполняется только в начислениях, выставляемых ФССП. |
MainSupplierBillID | 1..9, обязательно | String | УИН, на основании которого выставлено данное начисление (связанное начисление). |
SupplierOrgInfo | 1, обязательно | OrganizationType (см. описание в пункте 2.5.1) | Данные организации, являющейся получателем средств. |
BillFor | 1, обязательно | String | Назначение платежа. |
TotalAmount | 1, обязательно | unsignedLong | Сумма начисления. Целое число, показывающее сумму в копейках. |
ChangeStatus | 1, обязательно | Контейнер | Сведения о статусе начисления и основаниях его изменения. |
meaning (атрибут) | 1, обязательно | String | Статус, отражающий изменение данных начисления. Возможные значения: 1 - новое; 2 - уточнение; 3 - аннулирование; 4 - деаннулирование (отмена аннулирования). |
Reason | 0..1, необязательно | String | Основание изменения начисления. Указание основания является обязательным, если meaning= «3». |
KBK | 1, обязательно | KBKType (см. описание в п. 2.5.6.5) | КБК или двадцатизначный код, содержащий в 1 - 17 разрядах нули, в 18 - 20 разрядах - код классификации операций сектора государственного управления бюджетной классификации Российской Федерации. В случае отсутствия следует указывать значение «0». |
OKTMO | 1, обязательно | OKTMOType (см. описание в п. 2.5.6.4) | Код ОКТМО, указываемый АН или ГАН в соответствии с НПА. В случае отсутствия следует указывать значение «0». |
BudgetIndex | 1, обязательно | BudgetIndexType (см. описание в п. 2.5.5) | Реквизиты платежа 101, 106 - 110, предусмотренные приказом Министерства финансов Российской Федерации от 12 ноября 2013 г. №107н «Об утверждении Правил указания информации в реквизитах распоряжений о переводе денежных средств в уплату платежей в бюджетную систему Российской Федерации» (далее - приказ Минфина России от 12 ноября 2013 г. №107н). |
UnifiedPayerIdentifier | 1, обязательно | String | Идентификатор плательщика для ЮЛ или ИП. Алгоритм формирования идентификатора плательщика для ЮЛ или ИП описан в пункте 3.2. Наличие данного тега исключает наличие тега AltPayerIdentifier. |
AltPayerIdentifier | 1, обязательно | String | Идентификатор плательщика для ФЛ. Алгоритм формирования идентификатора плательщика для ФЛ описан в пункте 3.2. Наличие данного тега исключает наличие тега UnifiedPayerIdentifier. |
TreasureBranch | 1, обязательно | String | Сокращенное наименование ТОФК. |
TOFK | 0..1, необязательно | String | Код ТОФК, в котором открыт лицевой счет получателю или финансовому органу. |
FOName | 0..1, необязательно | String | Наименование финансового органа. |
LSvUFK | 0..1, необязательно | String | Номер лицевого счета получателя или финансового органа в ТОФК. |
LsvFO | 0..1, необязательно | String | Номер лицевого счета получателя в финансовом органе. |
AcptTerm | 0..1, необязательно | Integer | Количество дней для получения акцепта плательщика. |
PaytCondition | 0..1, необязательно | Integer | Условие оплаты. Возможные значения: 1 - заранее данный акцепт плательщика; 2 - требуется получение акцепта плательщика. |
Origin | 0..1, необязательно | String | Признак начисления с признаком «Предварительное начисление» (предварительное начисление): PRIOR - для предварительных начислений, загруженных в ГИС ГМП участником (например, при направлении дела на рассмотрение в суд); TEMP - для предварительных начислений, сформированных ГИС ГМП по запросу участника и имеющих срок действия. |
AdditionalData | 0..n, необязательно | Контейнер | Дополнительные поля начисления. |
Name | 1, обязательно | String | Наименование поля. |
Value | 1, обязательно | String | Значение поля. |
Signature | 1, обязательно | SignatureType | ЭП xml-документа. В теге содержатся реквизиты ЭП, соответствующие стандарту XML Advanced Electronic Signatures with Time-Stamp (описание стандарта находится в сети Интернет по адресу http://www.w3.org/TR/XAdES/). |
2.3. Платеж
Данные о платежах приведены в файле Payment.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 2. «Тип PaymentType».
Таблица № 2. «Тип PaymentType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Id (атрибут) | 1, обязателен | ID | Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>. |
SupplierBillID | 1, обязательно | SupplierBillIDType (описание см. в п. 2.5.6.9) или значение «0» | УИН. В случае отсутствия УИН указывается значение «0». |
Narrative | 1, обязательно | String | Назначение платежа. |
Amount | 1, обязательно | unsignedLong | Сумма платежа. Целое число, показывающее сумму в копейках. |
ReceiptDate | 0..1, необязательно | date | Дата поступления распоряжения в банк плательщика. Обязательно для заполнения в случае поступления распоряжения в кредитную организацию. |
PaymentDate | 1, обязательно | dateTime | Дата и время приема к исполнению распоряжения плательщика. |
BudgetIndex | 1, обязательно | BudgetIndexType (см. описание в пункте 2.5.5) | Реквизиты платежа 101, 106-110, предусмотренные приказом Минфина России от 12 ноября 2013 г. №107н. |
PaymentIdentificationData | 1, обязательно | PaymentIdentificationDataType (см. Описание в пункте 2.5.4) | Данные, необходимые для идентификации распоряжения о переводе денежных средств. |
AccDoc | 0..1, необязательно | Контейнер | Реквизиты платежного документа. |
AccDocNo | 0..1, необязательно | string | Номер платежного документа. |
AccDocDate | 1, обязательно | date | Дата платежного документа. |
Payer | 1, обязательно | Контейнер | Cведения о плательщике. |
PayerIdentifier | 1, обязательно | String | Идентификатор плательщика. Алгоритм формирования идентификатора плательщика описан в пункте 3.1.3. |
PayerName | 0..1, необязательно | String | Наименование плательщика. Указывается только для плательщиков - ЮЛ. |
PayerAccount | 0..1, необязательно | String | Номер счета плательщика (при наличии) в организации, принявшей платеж. |
Payee | 1, обязательно | Контейнер | Сведения о получателе средств. |
PayeeName | 1, обязательно | String | Наименование получателя средств и иная информация, содержащаяся в реквизите «Получатель» распоряжения о переводе денежных средств, за исключением ИНН, КПП. |
PayeeINN | 1, обязательно | INNType (см. описание в пункте 2.5.6.2) | ИНН получателя средств. |
PayeeKPP | 1, обязательно | KPPType (см. описание в пункте 2.5.6.3) | КПП получателя средств. |
PayeeBankAcc | 1, обязательно | AccountType (см. описание в пункте 2.5.2) | Реквизиты счета получателя средств. |
AdditionalData | 0..n, необязательно | Контейнер | Дополнительные поля платежа. |
Name | 1, обязательно | String | Наименование поля. |
Value | 1, обязательно | String | Значение поля. |
RecipientServicesIdentifier | 0..1, необязательно | String | Идентификатор получателя услуги / плательщика. Алгоритм формирования идентификатора получателя услуги совпадает с алгоритмом формирования идентификатора плательщика, описанного в пункте 3.2. Заполняется в случае, если плательщик не является получателем услуги. |
PayerPA | 0..1, необязательно | String | Дополнительный идентификатор получателя услуги в учетной системе получателя средств. |
ChangeStatus | 1, обязательно | Контейнер | Сведения о статусе платежа и основаниях его изменения. |
meaning (атрибут) | 1, обязательно | String | Статус, отражающий изменение данных платежа. Возможные значения: 1 - новое; 2 - уточнение; 3 - аннулирование. |
Reason | 0..1, необязательно | String | Основание изменения. Указание является обязательным, если meaning= «3». |
KBK | 1, обязательно | KBKType (см. описание в п. 2.5.6.5) | КБК или двадцатизначный код, содержащий в 1 - 17 разрядах нули, в 18 - 20 разрядах - код классификации операций сектора государственного управления бюджетной классификации Российской Федерации. В случае отсутствия следует указывать значение «0». |
TransKind | 0..1, необязательно | String | Вид операции. Указывается шифр платежного документа. Возможные значения: 01 - платежное поручение; 06 - инкассовое поручение; 02 - платежное требование; 16 - платежный ордер; ПД - платежный документ ФЛ |
TransContent | 0..1, необязательно | String | Содержание операции. Указывается при частичном исполнении. |
PaytCondition | 0..1, необязательно | Integer | Условие оплаты. Возможные значения: 1 - заранее данный акцепт плательщика; 2 - требуется получение акцепта плательщика. |
AcptTerm | 0..1, необязательно | Integer | Количество дней для получения акцепта плательщика. |
MaturityDate | 0..1, необязательно | Date | Окончание срока акцепта. |
DocDispatchDate | 0..1, необязательно | Date | Дата отсылки (вручения) плательщику документов в случае, если эти документы были отосланы (вручены) получателем средств плательщику. |
PartialPayt | 0..1, необязательно | Контейнер | Информация о частичном платеже. |
PaytNo | 0..1, необязательно | String | Номер частичного платежа. Соответствует значению соответствующего реквизита распоряжения, по которому осуществляется частичное исполнение. |
TransKind | 1, обязательно | String | Вид операции. Проставляется шифр исполняемого распоряжения. |
SumResidualPayt | 0..1, необязательно | Integer | Сумма остатка платежа. |
AccDoc | 1, обязательно | Контейнер | Реквизиты платежного документа по которому осуществляется частичное исполнение. |
AccDocNo | 1, обязательно | String | Номер платежного документа, по которому осуществляется частичное исполнение. |
AccDocDate | 1, обязательно | date | Дата платежного документа, по которому осуществляется частичное исполнение. |
Priority | 0..1, необязательно | String | Очередность платежа. Возможные значения: 0, 1-6. |
OKTMO | 1, обязательно | OKTMOType (см. описание в п. 2.5.6.4) | Код ОКТМО, указанный в распоряжении о переводе денежных средств. В случае отсутствия следует указывать значение «0», а также в случае формирования извещения при приеме наличных денежных средств в кассу получателя платежа, следует указывать значение «0». |
Signature | 1, обязательно | SignatureType | ЭП xml-документа. В теге содержатся реквизиты ЭП, соответствующие стандарту XML Advanced Electronic Signatures with Time-Stamp (описание стандарта находится в сети Интернет по адресу http://www.w3.org/TR/XAdES/). |
2.4. Квитанция
В ГИС ГМП выполняется автоматическое квитирование (сопоставление данных начисления и платежей). Квитирование может осуществляться по следующим параметрам (параметрам квитирования): УИН, сумма, КБК, код ОКТМО, ИНН получателя, КПП получателя, номер банковского счета, БИК банка получателя, идентификатор плательщика. Перечислен полный перечень параметров, которые могут участвовать в квитировании. В зависимости от внутренних настроек ГИС ГМП, может быть исключен из процедуры квитирования любой из перечисленных параметров квитирования, кроме УИН и суммы.
Данные квитанций приведены в файле Quittance.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 3. «Тип QuittanceType».
Таблица № 3. «Тип QuittanceType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
SupplierBillID | 1, обязательно | Token | УИН. Значение совпадает со значением одноименного тега начисления. |
CreationDate | 1, обязательно | Date | Дата квитирования (создания квитанции). |
BillStatus | 1, обязательно | String | Статус, присвоенный начислению при создании квитанции. Возможные значения: 1 - сквитировано (полностью совпали все параметры квитирования); 2 - предварительно сквитировано (не совпал хотя бы один из параметров квитирования, за исключением УИН); 3 - не сквитировано (не был получен ни один платеж, соответствующий начислению); 4 - сквитировано с отсутствующим платежом (устанавливается при получении запроса на квитирование начисления с отсутствующим в ГИС ГМП платежом, см. п. 5.6). |
payeeINN | 0..1, необязательно | INNType (см. описание в п. 2.5.6.2) | ИНН получателя средств из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
payeeKPP | 0..1, необязательно | KPPType (см. описание в п. 2.5.6.3) | КПП получателя средств из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
KBK | 0..1, необязательно | KBKType (см. описание в п. 2.5.6.5) | КБК из начисления. Заполняется в случае несовпадения этого реквизита в данных платежа с данными начисления. |
OKTMO | 0..1, необязательно | OKTMOType (см. описание в п. 2.5.6.4) | Код ОКТМО из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
PayerIdentifier | 0..1, необязательно | Token | Идентификатор плательщика из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
AccountNumber | 0..1, необязательно | AccountNumType (см. описание в п. 2.5.6.1) | Номер счета получателя средств из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
BIK | 0..1, необязательно | BIKType (см. описание в п. 2.5.6.7) | БИК банка получателя средств из начисления. Присутствует в квитанции в случае несовпадения значения этого реквизита в платеже и начислении. |
Balance | 0..1, необязательно | Long | Разность между суммой, указанной в начислении и суммой платежей. Целое число, показывающее сумму в копейках. Отрицательное значение информирует о переплате. |
PaymentIdentificationData | 0..1, необязательно | PaymentIdentificationDataType (см. описание в п. 2.5.4) | Данные, необходимые для идентификации платежа, сквитированного с начислением. Наличие данного тега обязательно, если в теге BillStatus указано значение, не равное «4». |
2.5. Вспомогательные типы
2.5.1. Тип OrganizationType
Тип предназначен для описания данных организаций, являющихся получателями средств.
Описание типа приведено в файле Оrganization.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 4. «Тип OrganizationType».
Таблица № 4. «Тип OrganizationType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Name | 1, обязательно | String | Наименование организации. |
INN | 1, обязательно | INNType (см. описание в п. 2.5.6.2) | ИНН организации. |
KPP | 1, обязательно | KPPType (см. описание в п. 2.5.6.3) | КПП организации. |
OGRN | 0..1, необязательно | OGRNType (см. описание в п. 2.5.6.6) | ОГРН организации. |
Account | 1, обязательно | AccountType (см. описание в п. 2.5.2) | Реквизиты счета организации. |
2.5.2. Тип AccountType
Тип предназначен для описания реквизитов банковских счетов, открытых следующим организациям:
- ТОФК (для учета поступлений в бюджеты бюджетной системы РФ);
- финансовым органам (для учета средств соответствующих государственных (муниципальных) учреждений);
- государственным (муниципальным) учреждениям (для учета средств государственных (муниципальных) автономных учреждений).
Описание типа приведено в файле Organization.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 5. «Параметры типа AccountType».
Таблица № 5. «Параметры типа AccountType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Account | 1, обязательно | AccountNumType (см. описание в пункте 2.5.6.1) | Номер банковского счета. |
Bank | 1, обязательно | BankType (см. описание в пункте 2.5.3) | Данные банка, в котором открыт счет. |
2.5.3. Тип BankType
Тип предназначен для указания реквизитов структурных подразделений кредитных организаций, или подразделений Банка России, являющихся банками получателя, банками плательщика.
Описание типа приведено в файле Organization.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП») и, описание параметров приведено в Таблице № 6. «Тип BankType».
Таблица № 6. «Тип BankType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Name | 0..1, необязательно | String | Наименование структурного подразделения кредитной организации или подразделения Банка России, в котором открыт счет. |
BIK | 1, обязательно | BIKType (описание см. в п. 2.5.6.7) | БИК структурного подразделения кредитной организации или подразделения Банка России, в котором открыт счет. Наличие этого тега исключает тег SWIFT. |
SWIFT | 1, обязательно | SWIFTType (описание см. в п. 2.5.6.8) | Код SWIFT иностранного банка, в котором открыт счет. Наличие этого тега исключает тег BIK. |
2.5.4. Тип PaymentIdentificationDataType
Тип описывает данные, необходимые и достаточные для идентификации платежа.
Описание типа приведено в файле Payment.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 7. «PaymentIdentificationDataType».
Таблица № 7. «PaymentIdentificationDataType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Bank | 1, обязательно | BankType (см. описание в пункте 2.5.3) | Реквизиты структурного подразделения кредитной организации, принявшего платеж. Наличие данного тега исключает появление тегов UFK и Other. |
Other | 1, обязательно | String | В случае приема в кассу получателя платежа наличных денежных средств от плательщика, тег должен быть заполнен значением «CASH». Наличие данного тега исключает появление тегов Bank и UFK. |
UFK | 1, обязательно | String | Если платеж принят ТОФК, то тег должен быть заполнен значением четырехсимвольного кода ТОФК. Если платеж принят организацией, не являющейся кредитной организацией или не являющейся ТОФК, указывается УРН организации. Наличие данного тега исключает появление тегов Bank и Other. |
SystemIdentifier | 1, обязательно | String | УИП, присвоенный участником, принявшим платеж. Алгоритм формирования УИП описан в пункте 3.3. |
2.5.5. Тип BudgetIndexType
Тип описывает реквизиты платежа 101, 106-110, предусмотренные приказом Минфина России от 12 ноября 2013 г. №107н и положением Банка России от 19 июня 2012 г. №383-П «О правилах осуществления перевода денежных средств».
Описание типа приведено в файле BudgetIndex.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 8. «Тип BudgetIndexType».
Таблица № 8. «Тип BudgetIndexType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
Status | 1, обязательно | String | Статус плательщика - реквизит 101 Распоряжения. |
Purpose | 1, обязательно | String | Показатель основания платежа - реквизит 106 Распоряжения. |
TaxPeriod | 1, обязательно | String | Налоговый период или код таможенного органа - реквизит 107 Распоряжения. |
TaxDocNumber | 1, обязательно | Token | Показатель номера документа - реквизит 108 Распоряжения. |
TaxDocDate | 1, обязательно | String | Показатель даты документа - реквизит 109 Распоряжения. |
PaymentType | 1, обязательно | String | Показатель типа платежа - реквизит 110 Распоряжения. |
2.5.6. Простые типы
2.5.6.1. AccountNumType
Тип предназначен для указания номера банковского счета.
Основан на типе Token, 20 цифр [0-9].
2.5.6.2. INNType
Тип предназначен для указания ИНН юридического лица.
Основан на типе String, 10 цифр [0-9].
2.5.6.3. KPPType
Тип предназначен для указания КПП юридического лица.
Основан на типе String, 9 цифр [0-9].
2.5.6.4. OKTMOType
Тип предназначен для указания кода по ОКТМО.
Основан на типе String, 11 цифр [0-9] или 8 цифр [0-9] или значение «0».
2.5.6.5. KBKType
Тип предназначен для указания КБК.
Основан на типе String, 20 цифр или значение «0».
2.5.6.6. OGRNType
Тип предназначен для указания ОГРН юридического лица.
Основан на типе String, 13 цифр [0-9].
2.5.6.7. BIKType
Тип предназначен для указания банковского идентификационного кода.
Основан на типе String, 9 цифр [0-9].
2.5.6.8. SWIFTType
Тип предназначен для указания SWIFT кода банка .
Основан на типе String, 11 или 8 символов [A-Z, 0-9].
2.5.6.9. SupplierBillIDType
Тип предназначен для указания УИН.
Основан на типе String, 20 или 25 цифр [0-9].
2.5.6.10. URNType
Тип предназначен для указания УРН участника.
Основан на типе String, 6 символов.
3. Порядок формирования идентификаторов в Системе
3.1. Идентификатор начисления
3.1.1. Структура УИН для АН и ГАН, являющихся федеральными органами государственной власти
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
A | B | C |
А | Код главы КБК. |
---|---|
В | Уникальный номер начисления - 16 цифр. Алгоритм формирования, обеспечивающий уникальность номера, определяется участником самостоятельно. |
С | Контрольный разряд. Алгоритм расчета представлен в п. 3.1.3. |
3.1.2. Структура УИН для АН и ГАН, являющихся органами государственной власти субъектов Российской Федерации, органами местного самоуправления, государственными (муниципальными) учреждениями
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | … | 24 | 25 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
A | B | C |
A | УРН участника, сформировавшего начисление. УРН указывается в десятичном представлении. Например, УРН участника равен значению «AA11B4»; после перевода в десятичное представление получается «11145652». Если при переводе УРН участника в десятичное представление получается менее восьми символов, то значение дополняется нулями слева до 8 цифр. |
---|---|
B | Уникальный номер начисления - 16 цифр. Алгоритм формирования, обеспечивающий уникальность номера, определяется участником самостоятельно. |
C | Контрольный разряд. Алгоритм расчета описан в п. 3.1.3. |
3.1.3. Правила расчета контрольного разряда УИН
Контрольный разряд УИН формируется по следующим правилам:
каждому разряду УИН, начиная со старшего разряда, присваивается набор весов, соответствующий натуральному ряду чисел от 1 до 10, далее набор весов повторяется;
каждая цифра УИН умножается на присвоенный вес разряда и вычисляется сумма полученных произведений;
контрольный разряд для УИН представляет собой остаток от деления полученной суммы на модуль «11». Контрольный разряд должен иметь значение от 0 до 9;
если получается остаток, равный 10, то для обеспечения одноразрядного контрольного разряда необходимо провести повторный расчет, применяя вторую последовательность весов, сдвинутую на два разряда влево (3, 4, 5, 6, 7, 8, 9, 10, 1, 2). Если, в случае повторного расчета, остаток от деления вновь сохраняется равным 10, то значение контрольного разряда проставляется равным «0».
3.2. Идентификатор плательщика
Правила формирования идентификатора плательщика для ЮЛ - резидентов РФ следующие:
1 разряд - значение «2» (признак ЮЛ - резидента РФ);
2 - 11 разряды - ИНН ЮЛ (10 цифр);
12 - 20 разряды - КПП ЮЛ (9 цифр).
Правила формирования идентификатора плательщика для ЮЛ - нерезидентов РФ следующие:
1 разряд - значение «3» (признак ЮЛ - нерезидента РФ);
2 - 11 разряды - ИНН ЮЛ (10 цифр);
12 - 20 разряды - КПП ЮЛ (9 цифр).
Правила формирования идентификатора плательщика для ИП следующие:
1 разряд - значение «4» (признак ИП);
2 - 13 разряды - ИНН ИП (12 цифр).
Правила формирования идентификатора плательщика для ФЛ следующие:
Таблица № 9. «Правила формирования идентификатора плательщика для ФЛ»
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | … | 22 | 23 | 24 | 25 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Тип документа | Серия и номер документа (в одну строку, без разделителей) | Гражданство |
где:
1 - 2 разряды - код типа документа. Применяются следующие коды типов документов:
Таблица № 10. «Коды типов документов»
Значение | Описание |
---|---|
01 | Паспорт гражданина Российской Федерации |
02 | Свидетельство органов ЗАГС, органа исполнительной власти или органа местного самоуправления о рождении гражданина |
03 | Паспорт моряка (удостоверение личности моряка) |
04 | Удостоверение личности военнослужащего |
05 | Военный билет военнослужащего |
06 | Временное удостоверение личности гражданина Российской Федерации |
07 | Справка об освобождении из мест лишения свободы |
08 | Паспорт иностранного гражданина либо иной документ, установленный федеральным законом или признаваемый в соответствии с международным договором Российской Федерации в качестве документа, удостоверяющего личность иностранного гражданина |
09 | Вид на жительство |
10 | Разрешение на временное проживание (для лиц без гражданства) |
11 | Удостоверение беженца |
12 | Миграционная карта |
13 | Паспорт гражданина СССР |
14 | CНИЛС |
15 | Удостоверение личности гражданина Российской Федерации |
16 - 20 | Зарезервировано |
21 | ИНН |
22 | Водительское удостоверение |
23 | Зарезервировано |
24 | Свидетельство о регистрации транспортного средства в органах Министерства внутренних дел Российской Федерации |
25..99 | Зарезервировано |
3 - 22 разряды - серия и номер документа (в одну строку, без разделителей; знаки «N» и «-» не указываются; при наличии букв, они должны указываться как заглавные), ссылка на который дана в коде типа документа (1 - 2 разряды). Если номер документ содержит менее 20 символов, он дополняется слева нулями до 20 символов.
23 - 25 разряды - цифровой код страны, гражданином которой является плательщик, в соответствии с документом, удостоверяющим личность (в соответствии с Общероссийским классификатором стран мира). Для плательщиков - граждан РФ - указывается значение «643» (код РФ); для лиц без гражданства используется код «999».
3.3. Идентификатор платежа
Каждый платеж должен иметь УИП.
УИП для кредитных организаций должен иметь следующую структуру:
Таблица № 11. «Структура УИП для кредитных организаций»
1 | 2 | … | 10 | 11 | 12 | … | 16 | 17 | 18 | … | 22 | 23 | … | 31 | 32 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | БИК | Номер подразделения | Дата платежа | Уникальный номер платежа в течение дня для данного подразделения |
где:
1 разряд - значение «1».
2 - 10 разряды - БИК кредитной организации, структурного подразделения кредитной организации, принявшей платеж.
11 - 16 разряды - номер внутреннего структурного подразделения кредитной организации (филиала, дополнительного офиса, кредитно-кассового офиса, операционного офиса, операционной кассы вне кассового узла), принявшего платеж. Номер слева дополняется нулями до 6 символов.
17 - 22 разряды - дата платежа в формате «ДДММГГ».
23 - 32 разряды - уникальный номер платежа в течение дня для структурного подразделения кредитной организации. Номер слева дополняется нулями до 10 символов.
УИП для ТОФК должен иметь следующую структуру:
Таблица № 12. «Структура УИП для ТОФК»
1 | 2 | 3 | 4 | 5 | 6 | 7 | … | 16 | 17 | 18 | … | 22 | 23 | … | 31 | 32 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
2 | ТОФК | Резерв | Дата платежа | Уникальный номер платежа в течение дня для данного ТОФК |
где:
1 разряд - значение «2».
2-5 разряды - код ТОФК.
6-16 разряды - резерв, заполнется нулями.
17-22 разряды - дата платежа в формате «ДДММГГ».
23-32 разряды - уникальный номер платежа в течение дня для данного ТОФК. Номер слева дополняется нулями до 10 символов.
УИП для остальных участников, принимающих платежи, должен иметь следующую структуру:
Таблица № 13. «Структура УИП для остальных участников»
1 | 2 | … | 7 | 8 | 9 | … | 13 | 14 | 15 | … | 19 | 20 | … | 28 | 32 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
3 | УРН | Уникальный номер платежа в учетной системе участника |
где:
1 разряд - значение «3».
2-7 разряды - УРН участника, принявшего платеж.
8-32 разряды - уникальный номер платежа в учетной системе участника. Номер слева дополняется нулями до 25 символов.
4. Порядок взаимодействия ГИС ГМП с информационными системами участников
ГИС ГМП взаимодействует с ИС участников посредством веб-сервиса ГИС ГМП SmevGISGMPService, размещенного в СМЭВ.
Веб-сервис ГИС ГМП отвечает требованиям документа «Методические рекомендации по разработке электронных сервисов и применению технологии электронной подписи при межведомственном электронном взаимодействии» версии 2.5.6 (далее - Методические рекомендации версии 2.5.6).
Описание веб-сервиса SmevGISGMPService приведено в файле SmevGISGMPService.wsdl (глава 8. «WSDL веб-сервиса, размещенного в СМЭВ»).
4.1. Порядок формирования ответов веб-сервиса на запросы участников
Для обслуживания входящих запросов веб-сервис предоставляет один метод GISGMPTransferMsg, который обрабатывает все запросы от ИС участников. По результатам обработки запроса к веб-сервису, вне зависимости от результата его обработки, формируется ответ веб-сервиса и возвращается ИС участника, направившему запрос. Форматы сообщений запросов и ответов веб-сервиса описаны в главе 5. «Форматы сообщений веб-сервиса, размещенного в СМЭВ».
В случае несоответствия формата запроса настоящим Форматам, отсутствия или невалидности ЭП и прочих ошибках в запросе, участник получит уведомление об отказе в приеме к обработке запроса с информацией о выявленной в запросе ошибке. Информация об ошибках, возникающих в процессе обработки запросов, представлена в главе 6. «Перечень контролей».
4.2. Электронные подписи запросов и ответов
Все сообщения от ИС участников должны содержать ЭП-ОВ (ЭП информационной системы, передающей запрос). ЭП должна находиться в заголовке SOAP-пакета сообщения-запроса и соответствовать Методическим рекомендациям версии 2.5.6 (глава 5. «Электронные подписи субъектов взаимодействия - информационных систем»).
При отправке ответа на запрос ИС участника ГИС ГМП накладывает ЭП-ОВ. Подпись располагается в заголовке SOAP-пакета сообщения-ответа и соответствует Методическим рекомендациям версии 2.5.6 (глава 5. «Электронные подписи субъектов взаимодействия - информационных систем»).
В формате каждой импортируемой в ГИС ГМП сущности (в тегах Charge и FinalPayment) присутствует тег Signature, предназначенный для передачи ЭП участника, сформировавшего сущность (далее - подпись под сущностью). Наличие подписи под сущностью является обязательным. Если участник, сформировавший сущность, самостоятельно передал ее в ГИС ГМП, допустимо для создания подписи под сущностью и ЭП-ОВ, которая находится в заголовке SOAP-пакета сообщения-запроса, использовать одну и ту же ключевую пару. Если же сущность была сформирована участником косвенного взаимодействия, то указание в качестве подписи под сущностью ЭП участника прямого взаимодействия, который передает сущность в ГИС ГМП, недопустимо.
В формате запроса веб-сервиса теги ExportRequest, DoAcknowledgmentRequest, ChargeCreationRequest содержат вложенный тег Signature, предназначенный для указания ЭП (далее - подпись под запросом) сформировавшего запрос участника (участника, от имени которого направлен запрос в ГИС ГМП). Наличие подписи под запросом обязательно для тех случаев, когда запрос сформирован участником косвенного взаимодействия.
Подпись под сущностью и подпись под запросом должны накладываться в соответствии с алгоритмом, описанным в пункте 4.3.
4.3. Подпись под сущностью, запросом
Значение ЭП должно рассчитываться для элемента сущности, запроса и его составных элементов.
В процессе создания электронной подписи информационной системы должны использоваться алгоритмы для расчета хеш-сумм, формирования подписи и каноникализации, приведенные в Таблице № 14. «Алгоритмы формирования подписи».
Таблица № 14. «Алгоритмы формирования подписи»
Наименование | URI | |
---|---|---|
Расчет хэш-сумм | ГОСТ Р 34.11-94 | http://www.w3.org/2001/04/xmldsig-more#gostr3411 |
Формирования подписи | ГОСТ Р 34.10-2001 | http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411, http://www.w3.org/TR/XAdES/ |
Каноникализация | Exclusive XML Canonicalization от 18 July 2002 | http://www.w3.org/2001/10/xml-exc-c14n# |
Формирование блока ЭП осуществляется в следующем порядке:
1 Формирование шаблона документа:
1.1 Создается элемент Signature;
1.2 К элементу Signature добавляется дочерний элемент SignedInfo;
1.3 К элементу SignedInfo добавляется дочерний элемент CanonicalizationMethod;
1.4 К элементу SignedInfo добавляется дочерний элемент SignatureMethod;
1.5 К элементу SignedInfo добавляется первый дочерний элемент Reference;
1.6 К элементу Reference добавляется дочерний элемент Transforms;
1.7 К элементу Transforms элемента Reference добавляется дочерний элемент Transform (два элемента);
1.8 К элементу Reference добавляется элемент DigestMethod;
1.9 К элементу Reference добавляется элемент DigestValue;
1.10 К элементу Signature добавляется дочерний элемент SignatureValue;
1.11 К элементу Signature добавляется дочерний элемент KeyInfo;
1.12 К элементу KeyInfo добавляется дочерний элемент X509Data;
1.13 К элементу X509Data добавляется дочерний элемент X509Certificate;
1.14 К элементу Signature добавляется дочерний элемент Object;
1.15 К элементу Object добавляется дочерний элемент QualifyingProperties;
1.16 К элементу QualifyingProperties добавляется дочерний элемент SignedProperties;
1.17 К элементу SignedProperties добавляется дочерний элемент SignedSignatureProperties;
1.18 К элементу SignedProperties добавляется дочерний элемент SignedDataObjectProperties;
1.19 К элементу QualifyingProperties добавляется дочерний элемент UnSignedProperties;
1.20 К элементу UnSignedProperties добавляется дочерний элемент UnsignedSignatureProperties;
2 Установка предопределенных значений
2.1 Для элемента CanonicalizationMethod и для второго элемента Transform элемента Reference значения атрибута Algorithm устанавливается в «http://www.w3.org/2001/10/xml-exc-c14n#».
2.2 Для первого элемента Transform алгоритм выставляется значение «http://www.w3.org/2000/09/xmldsig#enveloped-signature».
2.3 Для элементов DigestMethod первого значения атрибута Algorithm устанавливается в «http://www.w3.org/2001/04/xmldsig-more#gostr3411».
2.4 Для элемента SignatureMethod значение атрибута Algorithm устанавливается в «http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411».
2.5 Атрибут URI элемента Reference должен быть заполнен значением атрибута Id подписываемой сущности.
3 Установка подписи
3.1 Открытый ключ подписи, закодированный по алгоритму «http://www.w3.org/2000/09/xmldsig#base64», добавляется к элементу X509Certificate как дочерний текстовый узел.
3.2 Подписываются элементы документа, выбранные посредством XPATH выражения на основе значения атрибута URI элемента Reference (если элемент URI имеет пустое значение, то подписывается полностью весь тег сущности). Полученное значение кодируется по алгоритму «http://www.w3.org/2000/09/xmldsig#base64» и добавляется как дочерний текстовый узел к элементу DigestValue первого элемента Reference.
3.3 Элемент SignedInfo трансформируется в соответствии с алгоритмом «http://www.w3.org/2001/10/xml-exc-c14n#». Затем на основании полученной строки и ключа подписи формируется значение ЭП в соответствии с алгоритмом «http://www.w3.org/2001/04/xmldsig-more#gostr34102001-gostr3411». Полученное значение ЭП кодируется в соответствии с алгоритмом «http://www.w3.org/2000/09/xmldsig#base64», и значение добавляется как дочерний текстовый узел к элементу SignatureValue.
3.4 Элемент QualifyingProperties заполняется в соответствии с описанием, расположенным по адресу http://www.w3.org/TR/XAdES/#Syntax_overview_The_QualifyingProperties - для соответствия ЭП формату XadES-T.
5. Форматы сообщений веб-сервиса, размещенного в СМЭВ
5.1. Общий формат веб-сервиса
Права участников на выполнение различных типов запросов определены Порядком ведения ГИС ГМП и приведены в Таблице № 15. «Права участников на выполнение различных типов запросов».
Таблица № 15. «Права участников на выполнение различных типов запросов»
Типы запросов | ГАН/АН | ГАП/АП | ГАЗ/АЗ |
---|---|---|---|
Импорт начислений | + | ||
Импорт платежей | + | ||
Запрос статуса обработки импортируемого пакета | + | + | |
Экспорт начислений | + | + | + |
Экспорт платежей | + | + | + |
Экспорт квитанций | + | + | |
Квитирование начисления с платежами по инициативе АН/ГАН | + | ||
Квитирование начисления с отсутствующим в ГИС ГМП платежом | + | ||
Формирование начисления с признаком «Предварительное начисление» | + | ||
Загрузка и обновление сертификатов ключа проверки ЭП участников | + | + | + |
5.1.1. Сообщение запроса к веб-сервису
Описание сообщения запроса к веб-сервису приведено в Таблице № 16. Сообщения запросов к ГИС ГМП передаются в структуре сообщения СМЭВ (см. Методические рекомендации версии 2.5.6) в элементе AppData. В данный элемент должен быть подставлен элемент RequestMessage, описанный в файле Message.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»).
Таблица № 16. «Структура сообщения запроса к веб-сервису»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
GISGMPTransferMsg | 1, обязательно | Контейнер | Корневой тег запроса. |
Message | 0..1, необязательно | Контейнер | Служебный блок атрибутов СМЭВ. |
Sender | 1, обязательно | orgExternalType | Данные о системе-инициаторе взаимодействия. Указывается информация об ИС участника, обращающегося в ГИС ГМП. |
Code | 1, обязательно | String | Идентификатор системы. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
Recipient | 1, обязательно | orgExternalType | Данные о системе-получателе сообщения. Указывается идентификатор и наименование ГИС ГМП. |
Code | 1, обязательно | String | Идентификатор системы. Будет уточнен после публикации электронного сервиса в промышленном контуре СМЭВ. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Будет уточнено после публикации электронного сервиса в промышленном контуре СМЭВ. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
Originator | 0..1, необязательно | orgExternalType | Данные о системе, инициировавшей цепочку из нескольких запросов-ответов, объединенных единым процессом в рамках взаимодействия. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. ГИС ГМП не регламентируется порядок заполнения данного тега. |
Code | 1, обязательно | String | Идентификатор системы. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
ServiceName | 1, обязательно | String | Мнемоника электронного сервиса ГИС ГМП. Будет уточнена после публикации электронного сервиса в промышленном контуре СМЭВ. Наличие этого тега исключает тег Service. |
Service | 1, обязательно | ServiceType | Данные об электронном сервисе ГИС ГМП. Будут уточнены после публикации электронного сервиса в промышленном контуре СМЭВ. Наличие этого тега исключает тег ServiceName. |
Mnemonic | 1, обязательно | String | Мнемоника электронного сервиса ГИС ГМП. Будет уточнена после публикации электронного сервиса в промышленном контуре СМЭВ. |
Version | 1, обязательно | VersionType | Номер версии электронного сервиса ГИС ГМП. Будет уточнен после публикации электронного сервиса в промышленном контуре СМЭВ. |
TypeCode | 1, обязательно | TypeCodeType | Тип сообщения. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Status | 1, обязательно | StatusType | Статус сообщения. Принимает значение «REQUEST». |
Date | 1, обязательно | dateTime | Дата создания сообщения. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
ExchangeType | 1, обязательно | String | Категория взаимодействия. Заполняется в соответствии с Методическими рекомендациями версии 2.5.6. |
RequestIdRef | 0..1, необязательно | idType | Не используется. |
OriginRequestIdRef | 0..1, необязательно | idType | Не используется. |
ServiceCode | 0..1, необязательно | String | Не используется. |
CaseNumber | 0..1, необязательно | String | Не используется. |
SubMessages | 0..1, необязательно | Контейнер | Не используется. |
TestMsg | 0..1, необязательно | String | Признак тестового взаимодействия. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
OKTMO | 0..1, необязательно | String | Не используется. |
MessageData | 1, обязательно | Контейнер | Блок-обертка данных СМЭВ. |
AppData | 1, обязательно | AppDataType | Блок структурированных сведений. Элемент RequestMessage, описанный в файле Message.xsd. |
AppDocument | 0..1, необязательно | AppDocumentType | Не используется. |
Описание формата элемента RequestMessage приведено в Таблице № 17. «Структура RequestMessage».
Таблица № 17. «Структура RequestMessage»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
RequestMessage | 1, обязательно | RequestMessageType | Корневой тег запроса. |
Id (атрибут) | 1, обязательно | ID | Идентификатор сообщения. |
Timestamp (атрибут) | 1, обязательно | dateTime | Дата и время формирования сообщения. |
senderIdentifier (атрибут) | 1, обязательно | String | УРН участника-отправителя сообщения. |
senderRole (атрибут) | 0..1, необязательно | String | Полномочие участника-отправителя сообщения (УРН которого передается в атрибуте senderIdentifier), с которым происходит обращение к ГИС ГМП. Обязательно указание в случае, когда участник зарегистрирован в ГИС ГМП с несколькими полномочиями одновременно. Допустимые значения: 1 - ГАН (главный администратор доходов бюджета); 2 - ГАН (орган государственной власти (орган местного самоуправления)); 4 - АН (администратор доходов бюджета); 5 - АН (государственное (муниципальное) учреждение); 6 - ГАП (оператор по переводу денежных средств); 6 - ГАП (орган государственной власти (орган местного самоуправления)); 7 - АП (оператор по переводу денежных средств); 8 - АП (организация почтовой связи); 9 - АП (финансовый орган); 10 - АП (местная администрация); 11 - АП (банковский платежный агент); 12 - АП (банковский платежный субагент); 13 - АП (платежный агент); 14 - АП (учреждение, осуществляющее прием от плательщиков наличных денежных средств); 15 - ГАЗ (уполномоченный многофункциональный центр); 16 - ГАЗ (орган государственной власти (орган местного самоуправления)); 17 - АЗ (оператор единого портала); 18 - АЗ (оператор регионального портала); 19 - АЗ (многофункциональный центр); 20 - АЗ (орган записи актов гражданского состояния); 21 - АЗ (орган (лицо), уполномоченное рассматривать дела и выносить постановления); 22 - АЗ (орган, осуществляющий функции по исполнению судебных актов). |
callBackURL (атрибут) | 0..1, необязательно | anyURI | Не используется. |
RequestMessageData | Элемент заменяется на один из ниже перечисленных. | ||
DoAcknowledgmentRequest | 1, обязательно | DoAcknowledgmentRequestType | Запрос на принудительное квитирование по инициативе АН/ГАН, запрос на принудительное квитирование с отсутствующим в системе платежом, запрос на проставление статуса «Услуга предоставлена» (подробнее см. п.п. 5.5 - 5.7). |
ChargeCreationRequest | 1, обязательно | ChargeCreationREquestType | Формирование начисления с признаком «Предварительное начисление» (подробнее см. п. 5.8). |
ExportRequest | 1, обязательно | ExportRequestType | Запрос на экспорт сущностей из ГИС ГМП (подробнее см. п. 5.4) |
ImportCertificateRequest | 1, обязательно | ImportCertificateRequestType | Запрос на загрузку и обновление сертификатов ключа проверки ЭП (подробнее см. п. 5.9). |
ImportRequest | 1, обязательно | ImportRequestType | Запрос на импорт сущностей в ГИС ГМП (подробнее см. п. 5.2). |
PackageStatusRequest | 1, обязательно | PackageStatusRequestType | Запрос статуса протокола обработки пакета (подробнее см. п. 5.3). |
Signature | 0..1, необязательно | Не используется. |
5.1.2. Сообщение ответа от веб-сервиса
Сообщения ответов ГИС ГМП передаются в структуре сообщения СМЭВ (согласно методическим рекомендациям версии 2.5.6) в элементе AppData. В данный элемент должен быть подставлен элемент ResponseMessage, описанный в файле Message.xsd. Заполнение полей базового сообщения СМЭВ для ответа ГИС ГМП указано в Таблице № 18. «Структура сообщения ответа к веб-сервису».
Таблица № 18. «Структура сообщения ответа к веб-сервису»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
GISGMPTransferMsg | 1, обязательно | Контейнер | Корневой тег ответа. |
Message | 0..1, необязательно | Контейнер | Служебный блок атрибутов СМЭВ. |
Sender | 1, обязательно | orgExternalType | Данные о системе-отправителе сообщения. Указываются идентификатор и наименование ГИС ГМП. |
Code | 1, обязательно | String | Идентификатор системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Recipient | 1, обязательно | orgExternalType | Данные о системе-получателе сообщения. Указывается информация об ИС участника, обращающегося в ГИС ГМП. |
Code | 1, обязательно | String | Идентификатор системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Originator | 0..1, необязательно | orgExternalType | Данные о системе, инициировавшей цепочку из нескольких запросов-ответов, объединенных единым процессом в рамках взаимодействия. ГИС ГМП не регламентируется порядок заполнения данного тега. |
Code | 1, обязательно | String | Идентификатор системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Name | 1, обязательно | String | Наименование системы. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
ServiceName | 1, обязательно | String | Мнемоника электронного сервиса ГИС ГМП. Будет уточнена после публикации электронного сервиса в промышленном контуре СМЭВ. Наличие этого тега исключает тег Service. |
Service | 1, обязательно | ServiceType | Данные об электронном сервисе ГИС ГМП. Будут уточнены после публикации электронного сервиса в промышленном контуре СМЭВ. Наличие этого тега исключает тег ServiceName. |
Mnemonic | 1, обязательно | String | Мнемоника электронного сервиса ГИС ГМП. Будет уточнена после публикации электронного сервиса в промышленном контуре СМЭВ. |
Version | 1, обязательно | VersionType | Номер версии электронного сервиса ГИС ГМП. Будет уточнен после публикации электронного сервиса в промышленном контуре СМЭВ. |
TypeCode | 1, обязательно | String | Тип сообщения. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
Status | 1, обязательно | StatusType | Статус сообщения. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. В ответе может принимать значение «RESULT», «INVALID», «REJECT» или «FAILURE». |
Date | 1, обязательно | dateTime | Дата создания сообщения. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
ExchangeType | 1, обязательно | String | Категория взаимодействия. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
RequestIdRef | 0..1, необязательно | idType | Не используется. |
OriginRequestIdRef | 0..1, необязательно | idType | Не используется. |
ServiceCode | 0..1, необязательно | String | Совпадает со значением одноименного реквизита сообщения запроса. |
CaseNumber | 0..1, необязательно | String | Не используется. |
SubMessages | 0..1, необязательно | Контейнер | Не используется. |
TestMsg | 0..1, необязательно | String | Признак тестового взаимодействия. Заполняется в соответствии с методическими рекомендациями версии 2.5.6. |
OKTMO | 0..1, необязательно | String | Не используется. |
MessageData | 1, обязательно | Контейнер | Блок-обертка данных СМЭВ. |
AppData | 1, обязательно | AppDataType | Блок структурированных сведений. Содержит элемент ResponseMessage, описанный в файле Message.xsd. |
AppDocument | 0..1, необязательно | AppDocumentType | Не используется. |
Формат элемента ResponseMessage приведен в Таблице № 19. «Структура ResponseMessage».
Таблица № 19. «Структура ResponseMessage»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ResponseMessage | 1, обязательно | ResponseMessageType | Корневой тег запроса. |
Id (атрибут) | 1, обязательно | ID | Идентификатор сообщения. |
кqld | 1, обязательно | Token | Идентификатор сообщения-запроса. |
timestamp (атрибут) | 1, обязательно | dateTime | Дата и время формирования сообщения. |
senderIdentifier (атрибут) | 1, обязательно | String | УРН отправителя сообщения. |
ResponseMessageData | Элемент заменяется на один из ниже перечисленных. | ||
DoAcknowledgmentResponse | 1, обязательно | DoAcknowledgmentResponseType | Ответ на запрос на принудительное квитирование по инициативе АН/ГАН, запрос на принудительное квитирование с отсутствующим в системе платежом, проставление статуса «Услуга предоставлена» (подробнее см. п.п. 5.5 - 5.7). |
СhargeCreationResponse | 1, обязательно | СhargeCreationResponseType | Ответ на запрос формирования ГИС ГМП начисления с признаком «Предварительное начисление» (подробнее см. п. 5.8). |
ExportChargesResponse | 1, обязательно | ExportChargesResponseType | Ответ на запрос на экспорт начислений из ГИС ГМП (подробнее см. 5.4). |
ExportPaymentsResponse | 1, обязательно | ExportPaymentsResponseType | Ответ на запрос на экспорт платежей из ГИС ГМП (подробнее см. 5.4). |
ExportQuittanceResponse | 1, обязательно | ExportQuittanceResponseType | Ответ на запрос на экспорт квитаний из ГИС ГМП (подробнее см. 5.4). |
Ticket | 1, обязательно | TicketType | Техническая квитанция, содержащая результат обработки запроса или протокол обработки запроса. |
Signature | 0..1, необязательно | SignatureType | Не используется. |
5.2. Порядок импорта новых сущностей, уточнения или аннулирования ранее загруженных сущностей в ГИС ГМП
Направление извещения о начислении / приеме к исполнению распоряжения в ГИС ГМП участником осуществляется путем выполнения запроса к Системе на импорт начисления/платежа, с указанием в теге ChangeStatus@meaning значения «1».
Направление извещения об уточнении начисления / распоряжения в ГИС ГМП осуществляется путем выполнения запроса к Системе на импорт начисления / платежа, с указанием в теге ChangeStatus@meaning значения «2». При этом должен быть использован тот же УИН / УИП, что и в уточняемом начислении / платеже. Извещением об уточнении начисления, таким образом, является извещение о начислении, аналогичное уточняемому извещению во всех полях, кроме уточняемых, и содержащее в теге ChangeStatus@meaning значение «2». Аналогично, извещением об уточнении распоряжения является извещение о приеме к исполнению распоряжения, аналогичное уточняемому извещению во всех полях, кроме уточняемых, и содержащее в теге ChangeStatus@meaning значение «2».
Направление извещения об аннулировании начисления / распоряжения в ГИС ГМП осуществляется путем выполнения запроса к системе на импорт начисления / платежа, с указанием в теге ChangeStatus@meaning значения «3» и основания аннулирования. При этом должен быть указан тот же УИН / УИП, что и в аннулируемом начислении / платеже соответственно.
5.2.1. Формат запроса на импорт начисления
В сообщении запроса в теге RequestMessage должен передаваться тег ImportRequest. Данные импортируемых начислений должны передаваться в тегах Package/Document/Charge (см. описание в пункте 2.2). Одновременно в составе одного пакета (контейнер Package) в ГИС ГМП может быть передано несколько начислений. В атрибуте originatorID для каждого начисления должен передаваться УРН участника, сформировавшего начисление. Если УРН участника, сформировавшего начисление, совпадает с УРН участника, передающего начисление в ГИС ГМП, то допустимо тег OriginatorID не заполнять.
Запрос на импорт начислений обрабатывается в асинхронном режиме. При этом ответ на запрос будет содержать код одного из трех возможных результатов:
- пакет принят в обработку (ResultCode=”10”);
- установлено несоответствие XML-схеме (ResultCode=”11”);
- установлена ошибка в ЭП-ОВ (ResultCode=”27”).
Принятому пакету на стороне ГИС ГМП присваивается идентификатор, возвращаемый в теге ResponseMessage/Ticket/RequestProcessResult/ResultData.
Участник для проверки окончательного статуса приема пакета на стороне ГИС ГМП должен осуществить отдельный запрос статуса обработки импортируемого пакета, описанный в пункте .
5.2.2. Формат запроса на импорт платежа
В сообщении запроса в теге RequestMessage должен передаваться тег ImportRequest. Данные импортируемых платежей должны передаваться в тегах Package/Document/FinalPayment (см. описание в пункте ). Одновременно в составе одного пакета (контейнер Package) в ГИС ГМП может быть передано несколько платежей. В тегах OriginatorID для каждого платежа должен передаваться УРН участника, сформировавшего платеж. Если УРН участника, сформировавшего платеж, совпадает с УРН участника, передающего платеж в ГИС ГМП, то допустимо тег OriginatorID не заполнять.
Запрос на импорт платежей обрабатывается в асинхронном режиме. При этом ответ на запрос будет содержать код одного из трех возможных результатов:
- пакет принят в обработку (ResultCode=”10”);
- установлено несоответствие XML-схеме (ResultCode=”11”);
- установлена ошибка в ЭП-ОВ (ResultCode=”27”).
Пакету на стороне ГИС ГМП присваивается идентификатор, возвращаемый в теге ResponseMessage/Ticket/RequestProcessResult/ResultData.
Участник взаимодействия для проверки окончательного статуса приема пакета на стороне ГИС ГМП должен осуществить отдельный запрос статуса обработки импортируемого пакета, описанный в пункте 5.3.
5.2.3. Формат ответа
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/Ticket/RequestProcessResult с типом ResultInfo, структура которого приведена в файле ErrInfo.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»). Описание параметров приведено в Таблице № 20. «Структура ответа на запрос импорта».
Таблица № 20. «Структура ответа на запрос импорта»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
RequestProcessResult | 1, обязательно | ResultInfo | Корневой тег ответа. |
ResultCode | 1, обязательно | Token | Код результата обработки: 0 - если запрос успешно принят или код ошибки в случае отказа в приеме к обработке документа (см. перечень кодов в главе 5.9). |
ResultDescription | 0..1, необязательно | String | Описание результата обработки (см. перечень описаний результатов обработки в главе 5.9). |
ResultData | 0..1, необязательно | String | Данные результата обработки (для системного анализа). Для кода обработки «11» (Формат запроса (файла) не соответствует xml-схеме) в теге содержится детальная информация о выявленных несоответствиях. |
5.3. Запрос статуса обработки импортируемого пакета
В результате выполнения запросов импорта обеспечивается предварительный прием в ГИС ГМП пакета сущностей. Полный форматно-логический контроль осуществляется после отправки системой участнику сообщения ResponseMessage. Для того, чтобы получить информацию о статусе обработки пакета и о принятии / отклонении извещений на стороне ГИС ГМП, необходимо отправить запрос на получение протокола обработки пакета.
5.3.1. Формат запроса
В сообщении запроса в теге RequestMessage должен передаваться тег PackageStatusRequest, содержащий идентификатор пакета, статус которого необходимо проверить - PackageID. В качестве идентификатора пакета используется идентификатор, возвращенный участнику в теге ResponseMessage/Ticket/RequestProcessResult/ResultData.
5.3.2. Формат ответа
В случае, если обработка пакета на стороне ГИС ГМП еще не завершена, в сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/Ticket/RequestProcessResult с типом ResultInfo (см. описание типа ResultInfo в пункте ); при этом ResultCode будет равен значению «50».
В случае, если обработка пакета на стороне ГИС ГМП завершена, в сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/TicketPackageProcessResult.
Описание параметров приведено в Таблице № 21. «Структура ответа на запрос импорта”.
Таблица № 21. «Структура ответа на запрос статуса обработки импортируемого пакета (если обработка пакета завершена)»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
TicketPackageProcessResult | 1, обязательно | Контейнер | Корневой тег ответа. |
EntityProcessResult | 1..n, обязательно | Контейнер | Статус обработки каждой из сущностей в составе пакета. |
ResultCode | 1, обязательно | Token | Код результата обработки: 0 - если сущность успешно принята или код ошибки в случае неуспешного импорта (см. перечень кодов в главе 5.9). |
ResultDescription | 0..1, необязательно | String | Описание результата обработки (см. перечень описаний результатов обработки в главе 5.9). |
ResultData | 0..1, необязательно | String | Данные результата обработки (для системного анализа). Для кода обработки «11» (Формат запроса (файла) не соответствует xml-схеме) в теге содержится детальная информация о выявленных несоответствиях. |
entityId (атрибут) | 1, обязательно | Token | Идентификатор элемента. Соответствует атрибуту Id обработанной сущности. |
5.4. Экспорт сущностей из ГИС ГМП
5.4.1. Общий формат запроса
В сообщении запроса в теге RequestMessage должен передаваться тег ExportRequest, структура которого приведена в файле MessageData.xsd (глава 7. XML-схемы сущностей и сообщений ГИС ГМП) приведено в Таблице № 22. «Структура запроса на экспорт».
Таблица № 22. «Структура запроса на экспорт»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ExportRequest | 1, обязательно | DataRequest | Корневой тег запроса. |
Id (атрибут) | 0..1, необязателен | ID | Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>. Обязателен при наложении ЭП под запросом. |
kind (атрибут) | 1, обязательно | String | Атрибут, устанавливающий тип запроса. Допустимые значения описаны в пунктах 5.4.2 - 5.4.6. |
originatorID (атрибут) | 0..1, необязательно | URNType (см. описание в п. 2.5.6.10) | УРН участника, сформировавшего запрос. Если запрос сформировал участник косвенного взаимодействия, то заполнение тега является обязательным. |
Filter | 1, обязательно | Контейнер | Фильтр для получения сущностей из ГИС ГМП. |
Conditions | 1, обязательно | Контейнер | Условие для получения сущностей из ГИС ГМП. |
ChargesIdentifiers | 1, обязательно | Контейнер | Список УИН, по которым запрашиваются сущности. |
SupplierBillID | 1, обязательно | Token | УИН. При запросе начислений соответствует атрибуту supplierBillID начисления. При запросе платежей соответствует тегу SupplierBillID платежа. При запросе квитанций соответствует УИН начисления (указан в атрибуте supplierBillID), на которое ссылаются квитанции. Может быть множественным, при этом итоговая выгрузка будет являться объединением выгрузок по каждому из указанных УИН. |
Payers | 1, обязательно | Контейнер | Список идентификаторов плательщиков, по которым запрашиваются сущности. |
PayerIdentifier | 1, обязательно | Token | Идентификатор плательщика. При запросе начислений соответствует значению тега UnifiedPayerIdentifier или AltPayerIdentifier. При запросе платежей соответствует значению тега PayerIdentifier. При запросе платежей по связанным начислениям игнорируется. При запросе квитанций соответствует значению тега UnifiedPayerIdentifier или AltPayerIdentifier, указанного в начислении, на которое ссылаются квитанции. Может быть множественным, при этом итоговая выгрузка будет являться объединением выгрузок по каждому из указанных идентификаторов плательщика. |
Timeslot | 0..1, необязательно | Контейнер | Временной интервал, за который запрашиваются сущности. Если тег Timeslot не указан в запросе, то возвращаются удовлетворяющие остальным параметрам запроса сущности, импортированные или созданные в ГИС ГМП за весь период функционирования системы. |
startDate (атрибут) | 1, обязательно | DateTime | Дата и время, не ранее которых была импортирована в ГИС ГМП самая старая из возвращаемых сущностей или была создана самая старая из возвращаемых квитанций. |
endDate (атрибут) | 1, обязательно | DateTime | Дата и время, не позднее которых была импортирована в ГИС ГМП самая новая из возвращаемых сущностей или была создана самая новая из возвращаемых квитанций. |
AdditionRestrictions | 0..1, необязательно | Контейнер | Дополнительные ограничения. |
SubordinateIdList | 0..1, необязательно | Контейнер | Список идентификаторов участников косвенного взаимодействия. |
TaxpayerIdentification | 1..100, обязательно | Контейнер | Идентификация получателя средств. Наличие данного/данных тега/тегов исключает наличие тега/тегов PayeeID. |
inn (атрибут) | 1, обязательно | INNType (см. описание в п.2.5.6.2) | ИНН получателя средств, указанный в возвращаемой сущности. При запросе квитанций соответствует ИНН получателя, указанному в начислении, на которое ссылается квитанция. Если указано несколько тегов TaxpayerIdentification, то итоговая выгрузка будет являться объединением выгрузок по всем участникам косвенного взаимодействия, каждая из которых определяется отдельным тегом TaxpayerIdentification. |
kpp (атрибут) | 0..1, необязательно | KPPType (см. описание в п. 2.5.6.3) | КПП получателя средств, указанный в возвращаемой сущности. При запросе квитанций соответствует КПП получателя, указанному в начислении, на которое ссылается квитанция. |
PayeeID | 1..100, обязательно | String | УРН участника, сформировавшего сущность. При запросе квитанций соответствует УРН участника, сформировавшего начисление, на которое ссылается квитанция. Если указано несколько тегов PayeeID, то итоговая выгрузка будет являться объединением выгрузок по всем участникам косвенного взаимодействия, каждая из которых определяется отдельным тегом PayeeID. Наличие данного/данных тега/тегов исключает наличие тега/тегов TaxpayerIdentification. |
KBKClassifier | 0..1, необязательно | Контейнер | Перечень КБК. |
KBK | 1..100, обязательно | KBKType (см. описание в п. 2.5.6.5) | КБК, указанный в сущности. При запросе начислений соответствует КБК, указанному в начислении. При запросе платежей соответствует КБК, указанному в платеже. При запросе платежей по связанным начислениям игнорируется. При запросе квитанций соответствует КБК, указанному в начислении, на которое ссылаются квитанции. Может быть множественным, при этом итоговая выгрузка будет являться объединением выгрузок по каждому из указанных КБК. |
OKTMOClassifier | 0..1, необязательно | Контейнер | Коды ОКТМО. |
OKTMO | 1..100, обязательно | OKTMOType (см. описание в п. ) | Код ОКТМО. При запросе начислений соответствует коду ОКТМО, указанному в начислении. При запросе платежей соответствует коду ОКТМО, указанному в платеже. При запросе платежей по связанным начислениям игнорируется. При запросе квитанций соответствует коду ОКТМО, указанному в начислении, на которое ссылаются квитанции. Может быть множественным, при этом итоговая выгрузка будет являться объединением выгрузок по каждому из указанных коду ОКТМО. |
Exclude | 0..1, необязательно | String | Признак, означающий ненулевые УИН (допустимое значение - ZERO-UIN). При запросе платежей должна возвращаться информация о платежах, в которых указан УИН, отличный от нуля. |
Paging | 0..1, необязательно | Контейнер | Параметры постраничной выдачи (при больших объемах экспортируемых данных). |
pageLength (атрибут) | 1, обязательно | Int (>=1) | Количество элементов на странице выдачи (количество сущностей в ответе). |
pageNumber (атрибут) | 1, обязательно | Int (>=1) | Номер страницы выдачи. Вся полученная в результате выполнения запроса выборка разбивается на блоки размером pageLength, начиная с первого элемента. Последнй блок может быть меньше, чем pageLength. Возвращается только блок, номер которого равен pageNumber. |
5.4.2. Передача ГИС ГМП извещений о начислениях
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
- CHARGE - используется для запроса неоплаченных начислений;
- CHARGENOTFULLMATCHED - используется для запроса начислений, не полностью сквитированных с платежами (в т.ч. таких, по которым оставшаяся сумма к оплате равна «0», но при этом в начислении и соответствующем ему платеже попарно могут не совпадать какой-либо или несколько атрибутов из следующего набора: КБК, ОКТМО, ИНН, КПП, номер счета, БИК, идентификатор плательщика);
- CHARGESTATUS - используется для запроса начислений и статусов их квитирования;
- CHARGEPRIOR - используется для запроса неоплаченных предварительных начислений;
- CHARGEPRIORNOTFULLMATCHED - используется для запроса предварительных начислений, не полностью сквитированных с платежами;
- CHARGEPRIORSTATUS - используется для запроса предварительных начислений и статусов их квитирования;
- CHARGETEMP - используется для запроса неоплаченных предварительных начислений, сформированных ГИС ГМП;
- CHARGETEMPNOTFULLMATCHED - используется для запроса предварительных начислений, сформированных ГИС ГМП, не полностью сквитированных с платежами;
- CHARGETEMPSTATUS - используется для запроса предварительных начислений, сформированных ГИС ГМП, и статусов их квитирования.
Запросы CHARGE, CHARGENOTFULLMATCHED, CHARGEPRIOR, CHARGEPRIORNOTFULLMATCHED, CHARGETEMP, CHARGETEMPNOTFULLMATCHED доступны для АП/ГАП и АЗ/ГАЗ. Запрос CHARGESTATUS доступен АН/ГАН, АП/ГАП и АЗ/ГАЗ. Запросы CHARGEPRIORSTATUS, CHARGETEMPSTATUS доступны АН/ГАН.
В ответ на запрос начислений, осуществляемый АН, возвращаются только те начисления, получателем средств по которым является данный АН. В случае запроса начислений ГАН возвращаются начисления, получателем средств по которым является либо сам ГАН, либо его участники косвенного взаимодействия.
5.4.3. Формат ответа на запрос начислений
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportChargesResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 23. «Структура ответа на запрос экспорта начислений».
Таблица № 23. «Структура ответа на запрос экспорта начислений»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий для типов запроса CHARGE, CHARGENOTFULLMATCHED CHARGEPRIOR, CHARGEPRIORNOTFULLMATCHED | Комментарий для типов запроса CHARGESTATUS, CHARGEPRIORSTATUS, CHARGETEMPSTATUS |
---|---|---|---|---|
ExportChargesResponse | 1, обязательно | ExportChargesResponseType | Ответ на запрос начислений. | Ответ на запрос начислений. |
Charges | 1, обязательно | Контейнер | Перечень начислений и признак конца выборки | Перечень начислений. |
hasMore (атрибут) | 1, обязательно | boolean | Признак конца выборки: false - достигнут конец выборки, true - после последней выгруженной сущности в выборке имеются другие. | Признак конца выборки: false - достигнут конец выборки, true - после последней выгруженной сущности в выборке имеются другие. |
needReRequest (атрибут) | 0..1, необязательно | boolean | true - требуется повторный запрос. В случае, если для получения ответа потребовалось задействовать внешнюю систему и ответ от нее не был получен (внешняя система недоступна либо получена ошибка). | true - требуется повторный запрос. В случае, если для получения ответа потребовалось задействовать внешнюю систему и ответ от нее не был получен (внешняя система недоступна либо получена ошибка). |
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.3.
5.4.4. Передача ГИС ГМП извещений о приеме к исполнению распоряжений
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
- PAYMENT - все активные (неаннулированные) платежи;
- PAYMENTMODIFIED - все платежи, имеющие статус уточнения (ChangeStatus@meaning имеет значение «2») или статус аннулирования (ChangeStatus@meaning имеет значение «3»);
- PAYMENTUNMATCHED - все активные (неаннулированные) платежи, для которых в системе отсутствуют соответствующие начисления (не созданани одна квитанция);
- PAYMENTCANCELLED - аннулированные платежи (ChangeStatus@meaning имеет значение «3»);
- PAYMENTMAINCHARGE - запрос платежей по связанным начислениям (используется только ФССП).
5.4.5. Формат ответа на запрос платежей
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportPaymentsResponse, структура которого приведена в файле MessageData.xsd (глава . «XML-схемы сущностей и сообщений ГИС ГМП») , описание параметров приведено в Таблице № 24 «Структура ответа на запрос экспорта платежей».
Таблица № 24 «Структура ответа на запрос экспорта платежей»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ExportPaymentsResponse | 1, обязательно | ExportPaymentsResponseType | Ответ на запрос платежей. |
Payments | 1, обязательно | Контейнер | Перечень платежей и признак конца выборки. |
hasMore (атрибут) | 1, обязательно | boolean | Признак конца выборки: false - достигнут конец выборки, true - после последней выгруженной сущности в выборке имеются другие. |
PaymentInfo | 0..n, необязательно | Контейнер | Данные платежа. |
PaymentData | 1, обязательно | Base64Binary | Данные платежа, полученные при импорте от АП/ ГАП. |
PaymentSignature | 0..1, необязательно | Base64Binary | Данные файла ЭП платежа, переданного в ГИС ГМП АП/ ГАП. |
PaymentStatus | 0..n, необязательно | Контейнер | Признак “Услуга предоставлена” или “Сквитировано с начислением”. |
name (атрибут) | 1, обязательно | String | Обозначение. Для обозначения факта квитирования платежа с начислением в name указывается значение «Сквитировано с начислением». Для обозначения у платежа признака «Услуга предоставлена» в name указывается значение «Услуга предоставлена». |
value (атрибут) | 0..1, необязательно | String | Код, уточнение. Для обозначения факта квитирования платежа с начислением в value указывается УИН, c которым сквитирован платеж. Для обозначения у платежа признака «Услуга предоставлена» в value указывается значение «1». |
В случае возникновения ошибки при обработке запроса на экспорт начислений код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в главе 5.2.3.
5.4.6. Экспорт квитанций из ГИС ГМП
В квитанции передается статус квитирования начисления со всеми платежами, но отражается результат квитирования только с последним полученным платежом.
Атрибут kind запроса ExportRequest может принимать одно из следующих значений:
- QUITTANCE - для запросов результатов квитирования, за исключением неактивных (возвращается результат квитирования с последним полученным платежом),
- ALLQUITTANCE - для запросов всех результатов квитирования.
5.4.7. Формат ответа на запрос квитанций
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ExportQuittanceResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 25 «Структура ответа на запрос квитанций».
Таблица № 25 «Структура ответа на запрос квитанций»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
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.3.
5.5. Квитирование начисления с платежами по инициативе АН/ГАН
Сервис предназначен для проведения принудительного квитирования начисления с платежами по запросу АН / ГАН в тех случаях, когда начисление и платеж не могут быть сквитированы ГИС ГМП автоматически (УИН в начислении и платеже не совпадают, либо УИН отсутствует в платеже). С помощью данного сервиса нельзя изменить уже имеющиеся в ГИС ГМП результаты квитирования. Право на принудительное квитирование начисления с платежами имеет АН или ГАН, сформировавший соответствующее начисление.
5.5.1. Формат запроса
В сообщении ответа в теге AppData присутствует тег RequestMessage/DoAcknowledgmentRequest, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 26 «Структура запроса на проведение квитирования начисления с платежами по инициативе АН/ГАН».
Таблица № 26 «Структура запроса на проведение квитирования начисления с платежами по инициативе АН/ГАН»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
DoAcknowledgmentRequest | 1, обязательно | DoAcknowledgmentRequestType | Корневой тег запроса. |
Id (атрибут) | 0..1, необязателен | ID | Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>. Обязателен при наложении ЭП под запросом. |
originatorID (атрибут) | 0..1, необязательно | URNType (см. описание в п. 2.5.6.10) | УРН участника, сформировавшего запрос. Если запрос сформировал участник косвенного взаимодействия, то заполнение тега является обязательным. |
SupplierBillID | 1, обязательно | token | УИН. |
Payments | 1, обязательно | Контейнер | Перечень идентификаторов платежей. |
PaymentSystemIdentifier | 1..n, обязательно | token | УИП. Для запроса квитирования начисления с отсутствующим в ГИС ГМП платежом необходимо использовать единственный тег PaymentSystemIdentifier, заполненный значением «PaymentNotLoaded», см. пункт 5.6. |
5.5.2. Формат ответа
В случае успешной обработки запроса в сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/DoAcknowledgmentResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание параметров приведено в Таблице № 27 «Структура ответа на запрос проведения квитирования начисления с платежами по инициативе АН».
Таблица № 27 «Структура ответа на запрос проведения квитирования начисления с платежами по инициативе АН»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
DoAcknowledgmentResponse | 1, обязательно | DoAcknowledgmentResponseType | Корневой тег ответа. |
Quittances | 0..1, необязательно | Контейнер | Перечень квитанций. |
Quittance | 1..n, обязательно | QuittanceType | Данные созданной квитанции. |
В случае возникновения ошибки при обработке запроса код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в пункте 5.2.3.
5.6. Квитирование начисления с отсутствующим в ГИС ГМП платежом
Сервис предназначен для проведения принудительного квитирования начисления при отсутствии в ГИС ГМП платежей, соответствующих данному начислению. Право на принудительное квитирование такого начисления имеют АН и ГАН, сформировавший это начисление и получивший информацию о его оплате иным способом (не из ГИС ГМП).
5.6.1. Формат запроса
Запрос на принудительное квитирование начисления с отсутсвующим в ГИС ГМП платежом осуществляется посредством того же сообщения, что и запрос на принудительное квитирование начисления с платежами по инициативе АН / ГАН, описанного в пункте 5.5.1. Для указания необходимости принудительного квитирования с отсутствующим в ГИС ГМП платежом в контейнере Payments должен содержаться единственный элемент PaymentSystemIdentifier, заполненный значением «PaymentNotLoaded».
5.6.2. Формат ответа
Ответ на запрос на принудительного квитирования начисления с отсутсвующим в ГИС ГМП платежом возвращается посредством того же сообщения, что и ответ на запрос на принудительного квитирования начисления с платежами по инициативе АН/ ГАН, описанного в пункте 5.5.2.
В случае появления ошибки при обработке запроса в сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/Ticket/RequestProcessResult типа ResultInfo, который описан в пункте 5.2.3.
5.7. Установление платежу статуса «Услуга предоставлена»
Сервис предназначен для установления платежам, переданным в ГИС ГМП, статуса «Услуга предоставлена». Права на проставление платежу статуса «Услуга предоставлена» имеют:
- АЗ с полномочиями органа ЗАГС;
- ГАЗ, участником косвенного взаимодействия которого является АЗ с полномочиями органа ЗАГС.
5.7.1. Формат запроса
Запрос на установление платежам, загруженным в ГИС ГМП, статуса «Услуга предоставлена» осуществляется посредством того же сообщения, что и запрос на принудительное квитирование начисления с платежами, загруженными в ГИС ГМП, описанного в главе 5.5.1.
Тег SupplierBillID должен быть заполнен значенем «ChargeNotLoaded».
Контейнер Payments должен содержать уникальные идентификаторы платежей, которым необходимо проставить статус «Услуга предоставлена».
5.7.2. Формат ответа
В случае, если установление статуса «Услуга предоставлена» прошло успешно для всех указанных в запросе платежей, сообщение ответа в теге AppData будет содержать тег AppData/ResponseMessage/Ticket/RequestProcessResult типа ResultInfo, который описан в главе 5.2.3. В теге ResultCode будет передаваться значение "0".
В случае появления ошибки (платежи отсутствуют в ГИС ГМП), сообщение ответа в теге AppData будет содержать тег ResponseMessage/DoAcknowledgmentResponse, описанный в главе 5.5.2. Тег будет содержать контейнер PaymentsNotFound, в котором будут перечислены те УИП из запроса, по которым не были найдены платежи. Если какой-либо УИП из запроса не был возвращен в контейнере PaymentsNotFound, это значит, что платеж с таким УИП был найден, и ему был успешно проставлен статус «Услуга предоставлена».
5.8. Формирование ГИС ГМП начисления с признаком «Предварительное начисление»
Сервис предназначен для формирования ГИС ГМП начисления с признаком «Предварительное начисление». Права на отправку запроса на формирование начисления с признаком «Предварительное начисление» имеют АЗ и ГАЗ.
5.8.1. Формат запроса
В сообщении запроса в теге AppData должен присутствовать тег RequestMessage/ChargeCreationRequest, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание элементов приведено в Таблице № 28 «Структура запроса на формирование предварительного начисления».
Таблица № 28 «Структура запроса на формирование предварительного начисления»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ChargeCreationRequest | 1, обязательно | ChargeCreationRequestType | Корневой тег запроса. |
Id (атрибут) | 1, обязательно | ID | Необходим для наложения ЭП в формате XadES. Должен иметь структуру <буква [A-Z]>_<GUID>. |
originatorID (атрибут) | 0..1, необязательно | URNType | УРН участника, сформировавшего шаблон начисления. Если запрос сформировал участник косвенного взаимодействия, то заполнение тега является обязательным. |
ChargeTemplate | 1, обязательно | ChargeTemplateType (описание элементов представлено в Таблице № 29. «Тип ChargeTemplateType») | Шаблон начисления, на основании которого ГИС ГМП будет сформировано предварительное начисление. |
Signature | 0..1, необязательно | ds:SignatureType | ЭП xml-документа (шаблона начисления). В теге содержатся реквизиты ЭП, соответствующие стандарту XML Advanced Electronic Signatures with Time-Stamp (описание стандарта находится в сети Интернет по адресу http://www.w3.org/TR/XAdES/). |
Таблица № 29. «Тип ChargeTemplateType»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ValidUntil | 1, обязательно | Date | Дата, вплоть до которой актуально предварительное начисление, сформированнное ГИС ГМП по запросу участника. Дату указывает участник, направивший запрос на формирование предварительного начисления. |
SupplierOrgInfo | 1, обязательно | OrganizationType (см. описание в п. 2.5.1) | Данные организации, являющейся получателем средств. |
BillFor | 1, обязательно | String | Назначение платежа. |
TotalAmount | 1, обязательно | unsignedLong | Сумма начисления. Целое число, показывающее сумму в копейках. |
KBK | 1, обязательно | KBKType (см. описание в п. 2.5.6.5) | КБК. |
OKTMO | 1, обязательно | OKTMOType (см. описание в п. 2.5.6.4) | Код ОКТМО получателя средств. |
BudgetIndex | 1, обязательно | BudgetIndexType (см. описание в пункте 2.5.5) | Дополнительные реквизиты платежа, заполняемые в платежном поручении при оплате государственной услуги. |
UnifiedPayerIdentifier AltPayerIdentifier | 1, обязательно | String | Идентификатор плательщика для ЮЛ или ИП. Алгоритм формирования идентификатора плательщика для ЮЛ или ИП описан в пункте 3.2. Наличие данного тега исключает наличие тега AltPayerIdentifier. |
AltPayerIdentifier | 1, обязательно | String | Идентификатор плательщика для ФЛ. Алгоритм формирования идентификатора плательщика для ФЛ описан в пункте 3.2. Наличие данного тега исключает наличие тега UnifiedPayerIdentifier. |
TreasureBranch | 1, обязательно | String | Сокращенное наименование органа Федерального казначейства. |
TOFK | 0..1, необязательно | String | Код ТОФК, в котором открыт лицевой счет получателю или финансовому органу. |
FOName | 0..1, необязательно | String | Наименование финансового органа. |
LSvUFK | 0..1, необязательно | String | Номер лицевого счета получателя или финансового органа в ТОФК. |
LsvFO | 0..1, необязательно | String | Номер лицевого счета получателя в финансовом органе. |
AdditionalData | 0..n, необязательно | Контейнер | Дополнительные поля начисления. |
Name | 1, обязательно | String | Наименование поля. |
Value | 1, обязательно | String | Значение поля. |
5.8.2. Формат ответа
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/ChargeCreationResponse, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание элементов приведено в Таблице № 30. «Структура ответа на запрос формирования предварительного начисления».
Таблица № 30. «Структура ответа на запрос формирования предварительного начисления»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ChargeCreationResponse | 1, обязательно | ChargeCreationResponceType | Ответ на запрос формирования предварительного начисления. |
ChargeData | 1, обязательно | Base64Binary | Данные предварительного начисления, сформированного ГИС ГМП по запросу участника. |
В случае возникновения ошибки при обработке запроса формирования предварительного начисления код ошибки возвращается в сообщении ответа в теге AppData/ResponseMessage/Ticket/RequestProcessResult, имеющем тип ResultInfo, который описан в пункте 5.2.3.
5.9. Загрузка и обновление сертификатов ключа проверки ЭП участников
Сервис предназначен для централизованного сбора и обновления сертификатов ключа проверки ЭП участников прямого взаимодействия.
5.9.1. Формат запроса
В сообщении запроса в теге AppData должен присутствовать тег RequestMessage/ImportCertificateRequest, структура которого приведена в файле MessageData.xsd (глава 7. «XML-схемы сущностей и сообщений ГИС ГМП»), описание элементов приведено в Таблице № 31 «Структура запроса на загрузку или обновление сертификата ключа проверки ЭП участников».
Таблица № 31 «Структура запроса на загрузку или обновление сертификата ключа проверки ЭП участников»
Наименование | Кол-во тегов, обязательность тега или атрибута | Тип данных | Комментарий |
---|---|---|---|
ImportCertificateRequest | 1, обязательно | ImportCertificateRequestType | Корневой тег запроса. |
RequestEntry | 1..n, обязательно | RequestEntryType | Контейнер. |
operation (атрибут) | 1, обязательно | String | Вид операции. Возможны значения: APPEND - загрузка нового сертификата ключа проверки ЭП. REPLACE - обновление хранящегося в ГИС ГМП сертификата ключа проверки ЭП. |
ownership (атрибут) | 1, обязательно | URNType (см. описание в п. 2.5.6.10) | УРН владельца сертификата ключа проверки ЭП. |
serialNumber (атрибут) | 0..1, необязательно | String | Уникальный номер сертификата. Обязательно указание при обновлении сертификата (operation= «REPLACE»). |
certificate (атрибут) | 1, обязательно | Base64Binary | Файл, содержащий сертификат ключа проверки ЭП участника в кодировке Base64. |
5.9.2. Формат ответа
В сообщении ответа в теге AppData будет присутствовать тег ResponseMessage/TicketPackageProcessResult, состоящий из набора элементов EntityProcessResult, каждый из которых описывает статус обработки одного из загружаемых сертификатов ключа проверки ЭП. Атрибут entityId элемента EntityProcessResult соответствует атрибуту ownership обработанного сертификата. В случае успешной обработки сертификата участника в теге EntityProcessResult/ResultCode передается значение «0»; в случае неуспешной - код соответствующей ошибки. Перечень кодов ошибок приведен в главе 5.9.
6. Перечень контролей
В процессе обработки запросов ГИС ГМП осуществляет контроли и результаты обработки доводит до инициатора запросов с описанием выявленных ошибок.
В таблице ниже приводится перечень проводимых контролей и возможных ошибок.
Таблица № 32. «Перечень контролей»
Коды ошибок (ErrorCode) | Текст в протоколе (ResultDescription) | Описание контролей | Описание ошибок |
---|---|---|---|
2 | Начисление с УИН «<УИН>» не найдено в системе | Контроль наличия начисления, которое требуется сквитировать с платежами | Начисление, УИН которого указан в запросе на проведение квитирования по инициативе АН, отсутствует или аннулировано |
3 | Платеж с УИП «<УИП>» уже сквитирован с начислением | Контроль того, что платеж, с которым требуется сквитировать начисление, не был сквитирован с начислением ранее | Платеж, УИП которого указан в запросе на проведение квитирования по инициативе АН, уже сквитирован с начислением |
4 | Платеж с УИП «<УИП>» не найден в системе | Контроль наличия платежа, с которым требуется сквитировать начисление | Платеж, УИП которого указан в запросе на проведение квитирования по инициативе АН, отсутствует или аннулирован |
5 | Импортируемые данные уже присутствуют в системе | Запрет импорта дубликата сущности | Производится попытка импорта начисления или платежа, который уже присутсвует в БД ГИС ГМП |
6 | Уточнение начисления, выставленного ранее 01.01.2013, не допускается | Запрет уточнения начисления, дата выставления которого ранее 01.01.2013 | Производится попытка уточнения начисления, дата выставления которого ранее 01.01.2013 |
7 | Не найден исходный документ (файл) | Контроль наличия в БД исходных данных для уточнения или аннулирования | При попытке уточнить или аннулировать сущность не найдена или уже аннулирована сущность, которую пытаются уточнить или аннулировать |
8 | Нет прав на импорт/ уточнение/аннулирование сущности данного типа | Контроль полномочий участника на импорт, уточнение, аннулирование сущности | Участник пытается загрузить, уточнить или аннулировать сущность, которая не предназначена для загрузки данным типом участников |
10 | Некорректный формат УИН | Контроль формата 25-символьного УИН (УРН АН или ГАН, сформировавшего начисление, после перевода из шестнадцатеричного представления в десятичное представление должен быть равен первым восьми символам 25-символьного УИН) | Участник пытается загрузить начисление, УИН которого не соответствует требованиям к структуре УИН для АН и ГАН, являющихся органами государственной власти субъектов Российской Федерации, органами местного самоуправления, государственными (муниципальными) учреждениями |
11 | Формат запроса (файла) не соответствует xml-схеме | Контроль соответствия формата запроса (файла) xml-схеме | Файл запроса или сообщение-запрос имеют недопустимый формат (не соответствуют утвержденной XML-схеме). Описание несоответствий содержится в комментарии к протоколу (в теге ResultData) |
12 | Получена сущность (начисление /платеж) от незарегистрированного участника | Контроль наличия регистрации участника, сформировавшего начисление (платеж) | Получено начисление (платеж) от незарегистрированного участника |
13 | ЭП под сущностью (запросом) не верна | Проверка ЭП под сущностью (запросом) | Не пройдена проверка ЭП под сущностью (запросом) |
14 | Не определено полномочие, с которым участник обращается к ГИС ГМП | Контроль указания полномочия, с которой участник обращается в ГИС ГМП, в случае регистрации участника в ГИС ГМП с несколькими полномочиями одновременно | В запросе указан УРН (атрибут senderIdentifier), принадлежащий зарегистрированному в ГИС ГМП с несколькими полномочиями одновременно участнику. При этом тег senderRole не заполнен либо заполнен некорректным значением (указанное полномочие не принадлежит участнику) |
15 | Файл сертификата ключа проверки ЭП не может быть загружен в ГИС ГМП | Контроль корректности формата файла сертификата ключа проверки ЭП, полученного от участника для загрузки или обновления | Файл с сертификатом ключа проверки ЭП, полученный от участника для загрузки или обновления, имеет некорректный формат |
16 | Не найден сертификат ключа проверки ЭП для обновления | Проверка наличия сертификата ключа проверки ЭП для обновления | При попытке обновить сертификат ключа проверки ЭП не найден исходный сертификат |
17 | Получен сертификат ключа проверки ЭП от незарегистрированного участника | Контроль наличия участника-владельца сертификата в справочнике зарегистрированных участников ГИС ГМП | УРН, указаный в запросе на загрузку или обновления сертификата не принадлежит передавшему запрос участнику |
18 | Загружаемый / обновляемый сертификат ключа проверки ЭП имеет недопустимый срок действия | Контроль срока действия загружаемого / обновляемого сертификата ключа проверки ЭП | Загружаемый обновляемый сертификат ключа проверки ЭП имеет истекщий срок действия |
20 | В ГИС ГМП уже загружен сертификат ключа проверки ЭП с данным уникальным номером | Контроль наличия сертификата ключа проверки ЭП с уникальным номером, совпадающим с уникальным номером загружаемого сертификата | В ГИС ГМП уже присутствует сертификат ключа проверки ЭП с данным номером |
21 | Получен запрос от незарегистрированного участника | Контроль наличия УРН участника в справочниках ГИС ГМП | Принят запрос от незарегистрированного участника |
23 | Попытка передачи начисления (платежа) участником, не завершившим тестирование или исключенным участником | Проверка активности учетной записи участника, сформировавшего начисление (платеж) | Участник, сформировавший начисление (платеж), имеет статус «Блокирован» или «Исключен» в ГИС ГМП |
24 | Запрос данных участником, не завершившим тестирование или исключенным участником | Контроль активности участника, направившего запрос | Участник, запросивший данные, имеет статус «Блокирован» или «Исключен» в ГИС ГМП |
27 | Ваш запрос не был обработан - ЭП-ОВ некорректна | Проверка ЭП-ОВ | По итогам проверки ЭП-ОВ установлена ее некорректность |
28 | Ошибка вызова информационной системы участника | Контроль доступности информационной системы участника | При взаимодействии с информационной системой участника возникла ошибка |
30 | У вас недостаточно прав на проведение данной операции | Контроль наличия прав на проведение операции | Попытка информационной системы участника провести операцию, на которую у нее нет прав. Например, провести квитирование начисления, которое было загружено в ГИС ГМП другой системой. |
31 | Неверный сертификат ключа проверки ЭП в запросе | Контроль соответствия сертификата ключа проверки ЭП-ОВ хранящемуся в ГИС ГМП в запросе к веб-сервису ГИС ГМП | Сертификат ключа проверки ЭП-ОВ, указанный в запросе от информационной системы участника, не соответствует сертификатам ЭП, привязанным к данной системе в ГИС ГМП |
32 | Извещение о приеме к исполнению распоряжения имеет нулевую сумму платежа | Контроль суммы платежа (импорт платежей с нулевой суммой недопустим) | Попытка участника загрузить новое извещение о приеме к исполнению распоряжения с нулевой суммой |
33 | Неверный сертификат ключа проверки ЭП под сущностью (запросом) | Контроль соответствия сертификата ключа проверки ЭП под сущностью (запросом) | Сертификат ключа проверки ЭП под сущностью, переданной участником, не соответствует сертификату ключа проверки ЭП, привязанному к данному участнику в ГИС ГМП |
34 | В запросе на экспорт не указаны основные параметры запроса | Контроль указания основных параметров запроса в запросе экспорта | В запросе экспорта не указаны основные параметры запроса (УИН или УИП, временной интервал) |
36 | Недопустимый срок действия предварительного начисления | Проверка допустимости указанного срока действия в запросе на формирование предварительного начисления (дата не менее текущей и не более значения: «текущая дата + 1 мес> ) | В запросе на формирование предварительного начисление указан недопустимый срок действия |
37 | Запрос сформирован неуполномоченным участником | Контроль наличия полномочий участника, сформировавшего запрос | В запросе на экспорт, принудительное квитирование и формирование предварительного начисления указан УРН неуполномоченного участника |
38 | Не указана дата поступления распоряжения в банк плательщика. | Контроль указания даты поступления распоряжения в банк плательщика, если распоряжение принято в банк | В запросе на импорт платежей не указана дата поступления распоряжения в банк плательщика, (не заполнен тег ReceiptDate при указанной конструкции PaymentIdentificationData/Bank) |
39 | Не указано основание аннулирования | Контроль обязательности заполнения основания аннулирования при аннулировании начисления / платежа | В запросе на аннулирование начисления / платежа не указано основание аннулирования |
40 | Извещение о начислении имеет нулевую сумму платежа | Проверка суммы в начислении (сумма в начислении, не являющемся предварительным, не должна быть нулевой) | Попытка участника загрузить начисление с нулевой суммой (начисление не является предварительным) |
50 | Обработка пакета не завершена | Проверка готовности протокола обработки пакета | Запрошен статус обработки пакета до завершения обработки пакета |
232 | Некорректное значение кода по ОКТМО | Контроль наличия ОКТМО для счетов 40101* | Начисление, по которому поступление средств предполагается на счета 40101*, должно содержать код по ОКТМО, отличный от нуля |
234 | Контрольный разряд УИН имеет некорректное значение | Проверка контрольного разряда УИН | Контрольный разряд УИН имеет некорректное значение (не соответствует остальным разрядам УИН) |
235 | УИП имеет некорректный формат | Проверка формата УИП | УИП сформирован не в соответствии с алгоритмом, описанным в п. 3.3. |
236 | Некорректное значение идентификатора плательщика | Проверка корректности идентификатора плательщика | Проверка корректности идентификатора плательщика |
237 | Некорректный формат УИН | Проверка невырожденности УИН | В значимых разрядах УИН (для 20 и 25-разрядных УИН) все нули. Для прохождения проверки должно выпполняться условие: в разрядах 4-19 (для 20-разрядных УИН) или 9-24 (для 25-разрядных УИН) не все нули |
302 | Попытка загрузки в систему информации другого участника | Контроль принадлежности загружаемой в ГИС ГМП сущности зарегистрированному участнику | АН / АП, сформировавший сущность, не является участником косвенного взаимодействия ГАН / ГАП ее передавшего (проверка осуществляется по тегам senderIdentifier и originatorID). |
5000 | Общая ошибка, необходимо повторить вызов. | Системный сбой | Разовый отказ ГИС ГМП, необходимо повторить вызов, с рекомендуемым интервалом 1-5 минут. |
7. XML-схемы сущностей и сообщений ГИС ГМП
Файлы с XML-схемами находятся в прикрепленном архиве:
8. WSDL веб-сервиса, размещенного в СМЭВ
URL веб-сервиса ГИС ГМП для взаимодействия через СМЭВ может отличаться от URL, указанного в файле SmevGISGMPService.wsdl.
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:unifo="http://roskazna.ru/gisgmp/02000000/SmevGISGMPService/"
name="SmevGISGMPService"
targetNamespace="http://roskazna.ru/gisgmp/02000000/SmevGISGMPService/">
<wsdl:types>
<xsd:schema
targetNamespace="http://roskazna.ru/gisgmp/02000000/SmevGISGMPService/"
xmlns:smev="http://smev.gosuslugi.ru/rev120315">
<xsd:import schemaLocation="xsd/request/smev.unifo.rev120315.xsd"
namespace="http://smev.gosuslugi.ru/rev120315"/>
<xsd:element name="GISGMPTransferMsg"
type="smev:BaseMessageType"/>
</xsd:schema>
</wsdl:types>
<wsdl:message name="GISGMPTransferMsgRequest">
<wsdl:part name="inputmsg" element="unifo:GISGMPTransferMsg"/>
</wsdl:message>
<wsdl:message name="GISGMPTransferMsgResponse">
<wsdl:part name="outputmsg" element="unifo:GISGMPTransferMsg"/>
</wsdl:message>
<wsdl:portType name="SmevGISGMPService">
<wsdl:operation name="GISGMPTransferMsg">
<wsdl:input message="unifo:GISGMPTransferMsgRequest"/>
<wsdl:output message="unifo:GISGMPTransferMsgResponse"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="SmevGISGMPServiceSOAP" type="unifo:SmevGISGMPService">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="GISGMPTransferMsg">
<soap:operation
soapAction="http://roskazna.ru/gisgmp/02000000/SmevGISGMPService/GISGMPTransferMsg"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="SmevGISGMPService">
<wsdl:port name="SmevGISGMPServiceSOAP"
binding="unifo:SmevGISGMPServiceSOAP">
<soap:address location="http://roskazna.ru/gisgmp/02000000/"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Заместитель руководителя Федерального казначейства |
С.Б. Гуральников |
Обзор документа
Приведено описание форматов взаимодействия Государственной информационной системы о государственных и муниципальных платежах (ГИС ГМП) с аналогичными системами участников.
Версия форматов - 1.16.0.
ГИС ГМП принимает, хранит и выдает по запросам участников следующие сущности. Извещения о начислениях, об их уточнении и аннулировании. Извещение о приеме к исполнению (корректировке, аннулировании) распоряжения.
ГИС ГМП в результате сопоставления данных начисления и платежей создает новые сущности - квитанции. Участники могут получить их по запросам.