Предоставление информации о результатах квитирования
Атрибут | Значение |
---|---|
Название | gis-gmp-export-quittances |
Наименование | Предоставление информации о результатах квитирования |
Тип | Адаптер для межведомственного взаимодействия |
Версия СМЭВ | СМЭВ3 |
Версия ВС | 2.6.0 |
Версия МР | 3.5.0.1 |
Поставщик | Федеральное казначейство |
Потребители | ОИВ, ОМСУ, ЗАГС, МФЦ, Верховный суд РФ, Торгово-промышленная палата РФ, Госкорпорация Роскосмос |
Описание бизнес-процесса взаимодействия:
ИС клиента передает через Агредатор в СМЭВ запрос на получение информации о результатах квитирования извещения о начислении с извещениями о приеме к исполнению распоряжений. ГИС ГМП получает из СМЭВ запрос и направляет обратно через СМЭВ в Агредатор информацию о квитировании. Агредатор направляет в ИС клиента полученные данные.
Переменные окружения
Название | Описание |
---|---|
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 | Количество элементов на странице предоставления информации (1-100) | + | 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"
}
]
}