Прием информации о погашении начисления, учете платежа
| Атрибут | Значение |
|---|---|
| Название | gis-gmp-forced-acknowledgement |
| Наименование | Прием информации о погашении начисления, учете платежа |
| Тип | Адаптер для межведомственного взаимодействия |
| Версия СМЭВ | СМЭВ3 |
| Версия ВС | 2.5.0 |
| Версия МР | 3.5.0.1 |
| Поставщик | Федеральное казначейство |
| Потребители | ОИВ, ОМСУ, Верховный суд РФ, Торгово-промышленная палата РФ, Госкорпорация Роскосмос |
Описание бизнес-процесса взаимодействия:
ИС клиента передает через Агредатор в СМЭВ информацию о погашении начисления, учете платежа. ГИС ГМП получает из СМЭВ запрос и направляет обратно через СМЭВ в Агредатор результат обработки запроса. Агредатор направляет в ИС клиента полученную информацию.
flowchart LR;
A[ИС организации] <--> B[Агредатор];
B <--> C[СМЭВ];
C <--> D[ГИС ГМП];
Переменные окружения
| Название | Описание |
|---|---|
| CA_CERT | Сертификат центра сертификации для подключения к rabbitmq |
| CLIENT_CERT | Сертификат, используемый для подключения к rabbitmq |
| CLIENT_KEY | Ключ, используемый для подключения к rabbitmq |
| MQ_HOST | Хост rabbitmq |
| MQ_PORT | Порт rabbitmq |
| SMEV_SERVICE | Название СМЭВ сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор запроса | + | G_e5c906a5-0ceb-4320-97e5-233f32dd8925 |
| timestamp | Дата и время формирования сообщения | + | 2021-07-30T18:13:51.0 |
| sender_identifier | УРН участника-отправителя сообщения | + | 3eb551 |
| sender_role | Полномочие участника-отправителя сообщения | + | 3 |
| originator_id | УРН участника косвенного взаимодействия, сформировавшего запрос | - | |
| reconcile | Принудительное квитирование начисления с платежами | -1 | Cоставной элемент Reconcile |
| annulment_reconcile | Отмена принудительного квитирования начисления с платежами | -1 | Cоставной элемент AnnulmentReconcile |
| service_provided | Установление платежу признака «Услуга предоставлена» | -1 | Cоставной элемент ServiceProvided |
| annulment_service_provided | Отмена факта установления платежу признака «Услуга предоставлена» | -1 | Cоставной элемент AnnulmentServiceProvided |
| exclude_quittance | Исключение платежа из автоматического квитирования с начислением | -1 | Cоставной элемент ExcludeQuittance |
| annulment_exclude_quittance | Включение платежа в автоматическое квитирование с начислением | -1 | Cоставной элемент AnnulmentExcludeQuittance |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Reconcile
Принудительное квитирование начисления с платежами
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | 18817072711544879499 |
| payment_id | Перечень идентификаторов платежей | -1 | Массив (1..100) идентификаторов платежей. Пример: ["10471020010005233009202100000001"] |
| payment_not_loaded | Признак принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом | -1 | Cоставной элемент PaymentNotLoadedAmount |
1 - обязательно должен присутствовать только один из элементов
Структура элемента PaymentNotLoadedAmount
Признак принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| amount_reconcile | Сумма погашения, в копейках | - | 4294967295 |
| payment_not_loaded | Появляется при квитировании с отсутствующим платежом. Значение всегда "true" | + | true |
Структура элемента AnnulmentReconcile
Отмена принудительного квитирования начисления с платежами
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | 18817072711544879499 |
| payment_id | Перечень идентификаторов платежей | -1 | Массив (1..100) идентификаторов платежей. Пример: ["10471020010005233009202100000001"] |
| payment_not_loaded | Признак принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом | -1 | Cоставной элемент PaymentNotLoadedId |
1 - обязательно должен присутствовать только один из элементов
Структура элемента PaymentNotLoadedId
Признак принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| reconcile_id | Номер операции принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом (частичное погашение) | - | N00000000000000000000000 |
| payment_not_loaded | Появляется при квитировании с отсутствующим платежом. Значение всегда "true" | + | true |
Структура элемента ServiceProvided
Установление платежу признака «Услуга предоставлена»
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| payment_data_info | Информация о платеже | + | Массив (1..100) составных элементов PaymentDataInfo |
Структура элемента PaymentDataInfo
Информация о платеже
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| payment_id | Идентификатор платежа | + | 10471020010005233009202100000851 |
| service_data | Дополнительные сведения о предоставлении услуги / учете платежа | - | Cоставной элемент ServiceData |
Структура элемента ServiceData
Дополнительные сведения о предоставлении услуги / учете платежа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| amount | Сумма, на которую была предоставлена услуга, в копейках | + | |
| court_name | Наименование организации, принявшей решение об учете платежа | + | |
| lawsuit_info | Реквизиты делопроизводства | + | |
| persone_official | Информация о лице, принявшем решение об учете платежа | + | Cоставной элемент PersoneOfficial |
Структура элемента PersoneOfficial
Информация о лице, принявшем решение об учете платежа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| name | Фамилия и инициалы должностного лица, принявшего решение об учете платежа | + | |
| official_position | Должность лица, принявшего решение об учете платежа | + |
Структура элемента AnnulmentServiceProvided
Отмена факта установления платежу признака «Услуга предоставлена»
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| payment_data_id | Сведения об идентификаторах платежа | + | Массив (1..100) составных элементов PaymentDataId |
Структура элемента PaymentDataId
Сведения об идентификаторах платежа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| payment_id | Идентификатор платежа | + | 10471020010005233009202100000851 |
| service_data_id | Идентификатор информации об учете факта оплаты. Заполняется в случае отмены частичного учета факта оплаты | - | P00000000000000000000000 |
Структура элемента ExcludeQuittance
Исключение платежа из автоматического квитирования с начислением
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | 18817072711544879499 |
| payment_id | УПНО | + | Массив (1..100) идентификаторов платежей. Пример: ["10471020010005233009202100000001"] |
Структура элемента AnnulmentExcludeQuittance
Включение платежа в автоматическое квитирование с начислением
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | 18817072711544879499 |
| payment_id | УПНО | + | Массив (1..100) идентификаторов платежей. Пример: ["10471020010005233009202100000001"] |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор ответа | + | G_52858add-199d-4d20-b1de-ed324630232a |
| rq_id | Идентификатор запроса | + | G_e5c906a5-0ceb-4320-97e5-233f32dd8925 |
| recipient_identifier | УРН участника-получателя | + | 3eb551 |
| timestamp | Дата и время формирования сообщения | + | 2021-07-30T18:14:21.0 |
| quittance | Результат квитирования (квитанция) | -1 | Массив (1..100) составных элементов Quittance |
| done | Признак успешного выполнения операций | -1 | Массив (1..100) составных элементов Done |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Quittance
Результат квитирования (квитанция)
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | 18817072711544879499 |
| total_amount | Сумма, указанная в начислении | - | 50000 |
| creation_date | Дата квитирования (создания квитанции) | + | 2021-07-30T18:13:56.284+03:00 |
| bill_status | Статус, присвоенный начислению при создании квитанции | + | 5 |
| balance | Баланс квитанции | - | 0 |
| payment_id | УПНО, присвоенный участником, принявшим платеж | + | 10471020010005233009202100000001 |
| amount_payment | Сумма, указанная в платеже | - | 50000 |
| payee_inn | ИНН получателя средств | - | |
| payee_kpp | КПП получателя средств | - | |
| kbk | КБК | - | |
| oktmo | Код ОКТМО | - | |
| payer_identifier | Идентификатор плательщика | - | |
| account_number | Номер счета получателя средств | - | |
| bik | БИК ТОФК, структурного подразделения кредитной организации или подразделения Банка России, в котором открыт счет | - | |
| is_revoked | Признак аннулирования квитанции | - | |
| payment_portal | Признак уплаты с использованием ЕПГУ, РПГУ и иных порталов, интегрированных с ЕСИА | - | |
| reconcile_id | Номер операции принудительного квитирования начисления с отсутствующим в ГИС ГМП платежом (частичное погашение) | - | |
| discount_size | Дополнительные условия оплаты. Условия оплаты со скидкой (процент) | -1 | Cоставной элемент DiscountSize |
| discount_fixed | Дополнительные условия оплаты. Условия оплаты с фиксированной суммой скидки | -1 | Cоставной элемент DiscountFixed |
| multiplier_size | Дополнительные условия оплаты. Условия оплаты с применением понижающего размер коэффициента | -1 | Cоставной элемент MultiplierSize |
| refund | Сведения о возврате денежных средств | - | Массив (0..20) составных элементов Refund |
| income | Сведения о зачислениях денежных средств | - | Массив (0..20) составных элементов Income |
| clarification | Сведения об уточнении вида и принадлежности платежа | - | Массив (0..20) составных элементов Clarification |
1 - может присутствовать только один из элементов
Структура элемента DiscountSize
Условия оплаты со скидкой (процент)
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| value | Поле номер 1006: Процент скидки от суммы начисления | + | |
| expiry | Поле номер 1007: Срок действия скидки | + |
Структура элемента DiscountFixed
Условия оплаты с фиксированной суммой скидки
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| value | Поле номер 1004: Сумма скидки от полной суммы начисления | + | |
| expiry | Поле номер 1005: Срок действия скидки | + |
Структура элемента MultiplierSize
Условия оплаты с применением понижающего размер начисления коэффициента
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| value | Поле номер 1008: Коэффициент, понижающий размер начисления | + | |
| expiry | Поле номер 1009: Срок действия учета коэффициента, понижающего размер начисления | + |
Структура элемента Refund
Сведения о возврате денежных средств
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| refund_id | Уникальный идентификатор возврата (УИВ) | + | 0000000001010000000000000 |
| amount | Сумма возврата | + | 4294967295 |
Структура элемента Income
Сведения о зачислениях
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| income_id | Уникальный идентификатор зачисления (УИЗ) | + | 40000010100000000000000000000000 |
Структура элемента Clarification
Сведения об уточнении вида и принадлежности платежа
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| clarification_id | Уникальный идентификатор уточнения вида и принадлежности платежа (УВПП) | + | 50000010100000000000000000000000 |
Структура элемента Done
Признак успешного выполнения операции
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| service_data_id | Идентификатор информации об учете платежа | - | P00000000000000000000000 |
| payment_id | УПНО | - | 10471020010005233009202100000001 |
| code | Код результата обработки | - | |
| done | Признак успешного выполнения операции. Значение всегда "true" | + | true |
Примеры
Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.
Тестовый сценарий 1. Успешное выполнение операции по принудительному квитированию извещения о начислении с извещением о приеме к исполнению распоряжения
Запрос:
{
"id": "G_e5c906a5-0ceb-4320-97e5-233f32dd8925",
"timestamp": "2021-07-30T18:13:51.0",
"sender_identifier": "3eb551",
"sender_role": "3",
"reconcile": {
"supplier_bill_id": "18817072711544879499",
"payment_id": [
"10471020010005233009202100000001"
]
}
}
Ответ:
{
"id": "G_52858add-199d-4d20-b1de-ed324630232a",
"rq_id": "G_e5c906a5-0ceb-4320-97e5-233f32dd8925",
"recipient_identifier": "3eb551",
"timestamp": "2021-07-30T18:14:21.0",
"quittance": [
{
"supplier_bill_id": "18817072711544879499",
"total_amount": "50000",
"creation_date": "2021-07-30T18:13:56.284+03:00",
"bill_status": "5",
"balance": "0",
"payment_id": "10471020010005233009202100000001",
"amount_payment": "50000"
}
]
}
Тестовый сценарий 2. Успешное выполнение операции по отмене принудительного квитирования извещения о начислении с извещением о приеме к исполнению распоряжения
Запрос:
{
"id": "G_e5c906a5-0ceb-4320-97e5-233f32dd8925",
"timestamp": "2021-07-01T18:13:51.0",
"sender_identifier": "3eb551",
"sender_role": "3",
"annulment_reconcile": {
"supplier_bill_id": "18817072711544878492",
"payment_id": [
"10471020010005233009202100000851"
]
}
}
Ответ:
{
"id": "I_e8c656a3-5ceb-5474-78e5-254f32dd8322",
"rq_id": "G_e5c906a5-0ceb-4320-97e5-233f32dd8925",
"recipient_identifier": "3eb551",
"timestamp": "2021-07-01T18:13:51.0",
"done": [
{
"done": "true"
}
]
}
Тестовый сценарий 3. Успешное выполнение операции по установлению платежу признака «Услуга предоставлена»
Запрос:
{
"id": "G_e5c652a5-0ceb-4581-93e5-233f32dd8127",
"timestamp": "2021-07-30T18:13:51.0",
"sender_identifier": "3eb514",
"sender_role": "22",
"service_provided": {
"payment_data_info": [
{
"payment_id": "10471020010005233009202100005896"
}
]
}
}
Ответ:
{
"id": "I_e6c256a4-0ceb-5421-93e5-254f32dd8654",
"rq_id": "G_e5c652a5-0ceb-4581-93e5-233f32dd8127",
"recipient_identifier": "3eb514",
"timestamp": "2021-07-01T18:13:51.0",
"done": [
{
"done": "true"
}
]
}
Тестовый сценарий 4. Успешное выполнение операции по отмене установления платежу признака «Услуга предоставлена»
Запрос:
{
"id": "G_e7c906a4-6ceb-3520-78e5-951f32dd8861",
"timestamp": "2021-07-01T18:13:51.0",
"sender_identifier": "3eb514",
"sender_role": "22",
"annulment_service_provided": {
"payment_data_id": [
{
"payment_id": "10471020010005233009202100058962"
}
]
}
}
Ответ:
{
"id": "G_e7c906a4-6ceb-3520-78e5-951f32dd8861",
"rq_id": "G_e7c936a2-3ceb-4520-69e5-287f32dd8879",
"recipient_identifier": "3eb514",
"timestamp": "2021-07-01T18:13:51.0",
"done": [
{
"done": "true"
}
]
}