Форматы данных для расчета «торговой уступки» передаваемых в составе начисления (счета)
В составе данных начисления (счета) передаваемых в запросе на импорт начисления в Систему и в ответе на запрос экспорта неоплаченных начислений от платежного агента (КО) также могут передаваться данные для расчета «торговой уступки», согласно описанному в разделе 6.3.2. Соответствующие параметры описаны в блоках «AdditionalData», входящих в состав типа Bill - базового типа для описания начислений, выставляемых поставщиками услуг (администраторами начислений).
При определении схемы «торговой уступки» переданной с начислением, обрабатывается один информационный блок «торговой уступки», состоящий из нескольких блоков «AdditionalData» с полями FieldName / FieldValue. Признаком наличия блока «торговой уступки» является наличие значений FieldName = «Kind» / FieldValue= «4» или «5».
Описание типа приведено в файле Bill.xsd («XSD-схемы сущностей ИС РНиП» в составе документа «Форматы взаимодействия ИС РНиП с внешними информационными системами»); описание элементов приведено в таблице 2. «Элементы типа Bill».
Таблица 9. «Элементы типа Bill» обеспечивающие описание «торговой уступки» в составе данных начисления
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарий
|
BillDate
|
1
|
Date
|
Дата выставления начисления (счета).
|
ValidUntil
|
0..1
|
Date
|
Дата, вплоть до которой актуален выставленный счет.
|
SupplierOrgInfo
|
1
|
OrganizationType
|
Данные поставщика, указанные в счете
|
BillFor
|
0..1
|
String
|
Наименование начисления.
Указывается информация, которая должна отражаться в платежном поручении в поле «назначение платежа».
В первых 20 позициях указывать значения уникального идентификатора начисления, в 21 и 22 позициях указываются символы «/» («слеш»). Содержимое тега BillFor должно иметь длину до 210 символов.
|
TotalAmount
|
1
|
Long
|
Полная сумма начисления (счета). Целое число, показывающее сумму в копейках.
|
URL
|
0..1
|
AnyURI
|
URL печатной формы счета
|
AdditionalData
|
0..n
|
Контейнер
|
Примеры заполнения дополнительных полей счета, при передаче данных о «торговой уступке» приведены в п.6.5.1
|
|
FieldName
|
1
|
String
|
Наименование полей, при передаче данных о «торговой уступки» принимает значения: Kind, Persent, MinValue, MaxValue.
|
FieldValue
|
1
|
String
|
Значение полей формируются аналогично соответствующим значениям полей в Едином Каталоге услуг -. тип «ServiceCatalog_Type»
|
Примеры расчета и передачи данных «торговой уступки» в составе данных начисления (счета)
Размер уступки для полной суммы начисления (TotalAmount ) определён как 3%, при отсутствии комиссии с плательщика:
Kind
4
Percent
3.0
MinValue
0
MaxValue
999999
Пример постоянной уступки в 15 руб. при отсутствии комиссии с плательщика:
Kind
4
MaxValue
1500
Форматы данных для величин «торговой уступки» и комиссии передаваемых в составе факта оплаты
В составе данных факта оплаты содержащихся в запросе импорта платежа в блоке «AdditionalData» передаются данные величин фактической «торговой уступки» возмещаемой Поставщиком и фактической комиссии взятой КО или платежным агентом с плательщика за операцию проведения платежа. Данные передаются в составе типа PaymentType - базового типа для описания данных платежа. Описание типа приведено вфайле Payment.xsd («XSD-схемы сущностей ИС РНиП» в составе документа «Форматы взаимодействия ИС РНиП с внешними информационными системами»). Формат элементов включенных в блок AdditionalData аналогичен приведенному в таблице 9:
Таблица 10. Пример заполнения блока AdditionalData при передаче сведений о торговой уступке
Наименование
|
Кол-во тегов
|
Тип данных
|
Комментарии к заполнению
|
AdditionalData
|
0..n
|
Контейнер
|
Дополнительные поля факта оплаты
|
FieldName
|
1
|
String
|
Наименование поля, принимает значения: TradeConcession (величина уступки); RealCommission (величина комиссии).
|
FieldValue
|
1
|
String
|
Значение полей описанных в FieldName
(Целые числа, показывающие величину уступки /комиссии в копейках).
|
Пример заполнения блока AdditionalData в запросе на импорт факта оплаты
Предположим, что платежный агент принял данные для расчета уступки при условии отсутствия комиссии с Плательщика (Kind =4) и рассчитал величину ее согласно примеру А), приведенному в Таблице 1:
Размер уступки составляет 3% для всех платежей в границах (1руб – 999999руб), при этом уступка не более 100 руб.
В результате при платеже в 70 рублей (комиссия не взималась) уступка составила:
-
3% (70руб.) =2.1 руб. < 100 руб.
|
В блоке AdditionalData должна быть передана информация (данные TradeConcession и RealCommission указываются в копейках, аналогично сумме платежа):
TradeConcession= 210 копеек
RealCommission = 00 копеек (признак того, что комиссия с плательщика не взималась)
В xml-схеме эта информация будет представлена следующим образом:
TradeConcession
210
RealCommission
0
|
