Предоставление информации о результатах квитирования
| Атрибут | Значение |
|---|---|
| Название | gis-gmp-export-quittances |
| Наименование | Предоставление информации о результатах квитирования |
| Тип | Адаптер для межведомственного взаимодействия |
| Версия СМЭВ | СМЭВ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_a108e1f7-e0f0-48d2-8e80-b64a423efe4e |
| timestamp | Дата и время формирования сообщения | + | 2021-07-01T18:13:51.0 |
| sender_identifier | УРН участника-отправителя сообщения | + | 3eb646 |
| sender_role | Полномочие участника-отправителя сообщения | + | 9 |
| originator_id | УРН участника косвенного взаимодействия | - | |
| paging | Параметры постраничного предоставления из ГИС ГМП информации (при больших объемах предоставляемых данных) | - | Составной тип Paging |
| quittances_export_conditions | Условия для предоставления информации о результатах квитирования | + | Составной тип QuittancesExportConditions |
Структура элемента Paging
Параметры постраничного предоставления из ГИС ГМП информации
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| page_number | Номер страницы предоставления информации. Вся выборка по запросу разбивается на страницы размером pageLength, начиная с первого элемента. Последняя страница может быть меньше, чем page_length. В ответ на запрос возвращается только страница, номер которой равен page_number | + | 1 |
| page_length | Количество элементов на странице предоставления информации | + | 100 |
Структура элемента QuittancesExportConditions
Условия для предоставления информации о результатах квитирования
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| kind | Тип запроса на предоставление необходимой для уплаты информации | + | CHARGE |
| charges_conditions | Условия для получения информации о результатах квитирования по УИН | -1 | Составной тип ChargesConditions |
| time_conditions | Условия для получения результатов квитирования за временной интервал с указанием дополнительных параметров (при необходимости) | -1 | Составной тип TimeConditions |
1 - должен быть заполнен только один из элементов
Структура элемента ChargesConditions
Условия для получения информации о результатах квитирования по УИН
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН | + | Массив из 1-100 УИН |
Структура элемента TimeConditions
Условия для получения результатов квитирования за временной интервал с указанием дополнительных параметров (при необходимости)
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| time_interval | Временной интервал, за который запрашиваются сведения | + | Составной тип TimeInterval |
| beneficiary | Идентификация получателя средств | - | Массив из 0-10 элементов типа Beneficiary |
| kbk_list | Перечень КБК | - | Массив из 1-10 КБК |
Структура элемента TimeInterval
Временной интервал, за который запрашивается информация из ГИС ГМП
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| start_date | Начальная дата временного интервала запроса | + | |
| end_date | Конечная дата временного интервала запроса | + |
Структура элемента Beneficiary
Идентификация получателя средств
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| inn | ИНН получателя средств | + | |
| kpp | КПП получателя средств | - |
Параметры ответа
Возвращаемые сервисом параметры
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор ответа | + | I_17f81555-2452-42a3-8c8b-4679c2bdf2b7 |
| rq_id | Идентификатор запроса | + | G_a108e1f7-e0f0-48d2-8e80-b64a423efe4e |
| recipient_identifier | УРН участника получателя ответа | + | 3eb646 |
| timestamp | Дата и время формирования ответа | + | 2021-07-01T18:13:51.0 |
| has_more | Признак конца выборки: false - достигнут конец выборки; true - после последнего предоставленного элемента в выборке имеются другие |
+ | false |
| quittance | Результаты квитирования (квитанции) | - | Массив (0-100) элементов типа Quittance |
| possible_data | Дополнительные сведения об извещениях о приеме к исполнению распоряжений, которые несквитированы с извещением о начислении, но сопоставлены с ним по нескольким реквизитам квитирования | - | Массив (0-100) элементов типа PossibleData |
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 | Признак аннулирования квитанции | - | false |
| payment_portal | Признак уплаты с использованием ЕПГУ, РПГУ и иных порталов, интегрированных с ЕСИА | - | false |
| 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 |
Структура элемента PossibleData
Дополнительные сведения об извещениях о приеме к исполнению распоряжений, которые несквитированы с извещением о начислении, но сопоставлены с ним по нескольким реквизитам квитирования
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| supplier_bill_id | УИН, с которым сопоставлены платежи | + | |
| total_amount | Сумма, указанная в начислении | - | |
| comparison_result | Результат сопоставления начисления с платежом | + | Массив (1..100) составных элементов ComparisonResult |
Структура элемента ComparisonResult
Результат сопоставления начисления с платежом
| Параметр | Название | Обязательное | Пример |
|---|---|---|---|
| payment_id | УПНО, с которым сопоставлено начисление | + | |
| comparison_weight | Вес сопоставления начисления с платежом | + | 500 |
| comparison_date | Дата сопоставления | - | |
| amount_payment | Сумма, указанная в платеже | - | |
| kbk | КБК, указанный в платеже. Присутствует в результате сопоставления в случае несовпадения значений этого реквизита в данных платежа и начисления | - | |
| oktmo | Код по ОКТМО, указанный в платеже. Присутствует в результате сопоставления в случае несовпадения значений этого реквизита в данных платежа и начисления | - | |
| account_number | Номер счета получателя средств, указанный в платеже. Присутствует в результате сопоставления в случае несовпадения значений этого реквизита в данных платежа и начисления | - | |
| bik | БИК банка получателя средств, указанный в платеже. Присутствует в результате сопоставления в случае несовпадения значений этого реквизита в данных платежа и начисления | - |
Примеры
Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.
{
"id": "G_327e3906-5a3d-4c79-98f8-18bdd3f7228b",
"timestamp": "2021-07-30T18:13:51.0",
"sender_identifier": "3eacb7",
"sender_role": "1",
"quittances_export_conditions": {
"kind": "QUITTANCE",
"charges_conditions": {
"supplier_bill_id": [
"32117072411021588933"
]
}
}
}
В случае корректной настройки должен прийти следующий ответ:
{
"has_more": "false",
"id": "I_1cc3a1dc-263d-40ef-9f0a-51f8b51433a3",
"rq_id": "G_327e3906-5a3d-4c79-98f8-18bdd3f7228b",
"recipient_identifier": "3eacb7",
"timestamp": "2021-07-30T18:13:51.0",
"quittance": [
{
"supplier_bill_id": "32117072411021588933",
"total_amount": "500000",
"creation_date": "2021-07-30T16:35:56.284+03:00",
"bill_status": "1",
"balance": "0",
"payment_id": "10471020010005233009202000000001",
"amount_payment": "500000",
"is_revoked": "false"
}
]
}