Словарь терминов Счёт на оплату — сущность, хранящаяся в ведомственной системе, содержащая в себе реквизиты платежа, сумму, назначение, а также статус, комментарий к статусу и социальный номер плательщика. Требования к ведомствам: 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 Ошибка оплаты