Словарь терминов Счёт на оплату — сущность, хранящаяся в

Словарь терминов
Счёт на оплату — сущность, хранящаяся в ведомственной системе, содержащая в себе
реквизиты платежа, сумму, назначение, а также статус, комментарий к статусу и социальный
номер плательщика.
Требования к ведомствам:
1. Представить сервис регистрации счетов на оплату;
2. Предоставить сервис получения счетов на оплату по идентификатору;
3. Предоставить сервис получения списка платежных поручений, которые были
проведены по соц номеру картодержателя;
4. Предоставить сервис подтверждения платежей на оплату.
Также дополнительное требование: получить у СМЭВ коды необходимых услуг для
корректного проставления реквизитов в счетах на оплату.
Структуры данных.
1. Сервис регистрации счетов на оплату:
Вход: registerPaymentRequest
Кодовое имя
элемента
Тип
Описание
socId
String
Социальный
номер
картодержателя.
serviceCode
String
Код услуги в
СМЭВ
sum
Float
Сумма платежа
payMission
String
Назначение
платежа
Таблица 1: registerPaymentRequest
Выход: registerPaymentResponse
Кодовое имя
элемента
Тип
Описание
id
Int
Идентификатор
счёта в
ведомственной
системе
Таблица 2: registerPaymentResponse
Примечание: В ведомстве при формировании счёта на оплату, данному счёту должен
автоматически проставляться статус «0». Справочник статусов в приложении.
2. Получение счета на оплату у ведомства по идентификатору
Вход: getPaymentRequest
Кодовое имя
элемента
Тип
Описание
id
Int
Идентификатор
счёта в
ведомственной
системе
Таблица 3: getPaymentRequest
Выход: getPaymentResponse
Кодовое имя
элемента
Тип
Описание
payment
Описано в
таблице
payment
Платёжка
ведомства
Таблица 4: getPaymentResponse
Кодовое имя элемента
Тип
Описание
id
Int
Идентификатор платежа
inn
String
ИНН получателя
kpp
String
КПП получателя
String
Код бюджетной
классификации
okato
String
Код ОКАТО
payerInn
String
ИНН плательщика
bik
String
БИК получателя
String
Наименование банка
получателя по справочнику
БИКов
String
Получатель
платежа(Название)
receiverAcct
String
Счёт получателя
receiverKrrAcct
String
Корр. счет банка получателя
nds
Float
НДС. 0 — без НДС
budget
Boolean
kbk
bankName
payReceiver
Признак, указывающий,
бюджетный ли платёж
sum
Float
Сумма оплаты
payMission
String
Назначение платежа
status
Int
Код статуса платежа
statusComment
String
Комментарий к статусу
String
Социальный номер
гражданина, производящего
платёж
socId
Дополнительные поля, заполняемые только при уплате налогов
String
Показатель основания
платежа
Date
Показатель даты документа
Date
Показатель налогового
периода
String
Показатель типа платежа
String
Показатель номера
документа
String
Статус налогоплательщика
payBasis
docDateParam
taxDateParam
typePayParam
docNumParam
taxPayerStatus
Таблица 5: payment
3. Получение списка счетов на оплату по соц. номеру
Вход: getPayListRequest
Кодовое имя
элемента
Тип
Описание
socId
String
Социальный
номер
гражданина
limit
Int
Лимит количества
платёжек(если
отсутствует,
значит дёргать
все)
offset
int
Смещение. Также
стобы тянуть
большое
количесво по
блокам.
Таблица 6: getPayListRequest
Выход: getPayListResponse
Кодовое имя
элемента
Тип
Описание
ArrayOfPayments
Массив
объектов
payment
Массив платежей
count
int
Всего количество
платёжек в
ведомстве на
данного
гражданина
Таблица 7: getPayListResponse
4. Cервис подтверждения платёжа
Вход: payConfirmRequest
Кодовое имя
элемента
Тип
Описание
sum
Float
Сумма
совершённого
платежа
id
Int
Уникальный
идентификатор
платежа в
ведомстве
statusCode
Int
Код статуса
платежа
statusComment
String
Комментарий к
статусу
Таблица 8: payConfirmRequest
Выход: payConfirmResponse
Кодовое имя
элемента
payConfirmed
Тип
Boolean
Описание
Флаг
подтверждения
платежа
comment
String
Комментарий к
статусу
Таблица 9: payConfirmResponse
Приложение
Справочник кодов статусов счёта на оплату в ведомственных системах
Код статуса
Расшифровка
0
Сформирован
1
Оплачен в банке
2
Не оплачен
3
Ошибка оплаты