Вы можете открыть актуальную версию документа прямо сейчас.
Если вы являетесь пользователем интернет-версии системы ГАРАНТ, вы можете открыть этот документ прямо сейчас или запросить по Горячей линии в системе.
Приложение 3
к Регламенту информационно-
технологического взаимодействия
при обслуживании электронного
социального сертификата
Описание
сообщений, используемых для реализации процесса "Подтверждение списания ранее зарезервированных условных баллов электронного социального сертификата"
Перечень транзакций, которые могут использоваться при взаимодействии с ГИС ОПЦ в целях подтверждения списания ранее зарезервированных условных баллов электронного социального сертификата, содержит Таблица 3.1.
Таблица 3.1. - Перечень транзакций, которые применяются для взаимодействия
Сервис |
Сообщение |
Описание сообщения |
CardTransactionService |
AcceptorBatchTransferRequest |
Запрос Участника |
AcceptorBatchTransferResponse |
Ответ ГИС ОПЦ |
1. Описание состава используемых реквизитов сообщений
1.1. Сообщение AcceptorBatchTransferRequest
Сообщение AcceptorBatchTransferRequest при обмене информацией с ГИС ОПЦ используется как запрос подтверждения списания ранее зарезервированных условных баллов электронного социального сертификата. Сообщение AcceptorBatchTransfer состоит из следующих блоков:
- Header (тэг Hdr);
- DataSet (тэг DataSet);
- SecurityTrailer (SctyTrlr).
Header - обязательный блок. Содержит элементы, связанные с управлением запросом, идентификацией инициатора и получателя запроса.
DataSet - обязательный блок. DataSet состоит из следующих элементов:
- элементы, связанные с инициализацией транзакции, инициализатором и итоговой информацией по транзакции;
- общие данные о группах транзакций (или пакетах транзакций);
- данные о транзакциях в пакете.
SecurityTrailer - обязательный блок. Блок безопасности сообщения.
1.2. Сообщение AcceptorBatchTransferResponse
При обмене информацией с ГИС ОПЦ сообщение AcceptorBatchTransferResponse используется как ответ на запрос подтверждения списания ранее зарезервированных условных баллов электронного социального сертификата.
Сообщение AcceptorBatchTransferResponse состоит из следующих блоков:
- Header (тэг Hdr);
- DataSet (тэг DataSet);
- SecurityTrailer (тэг SctyTrlr).
Header - обязательный блок. Содержит элементы, связанные с управлением запросом, идентификацией инициатора и получателя запроса.
DataSet - обязательный блок. Содержит элементы, необходимые для подтверждения или отказа на выполнение операции. Информация блока включает общий результат обработки пакета переданной в запросе информации и список транзакций, которые не прошли обработку в ГИС ОПЦ.
SecurityTrailer - обязательный блок. Блок безопасности сообщения.
1.3. Структура запроса
Состав и порядок заполнения реквизитов запроса на подтверждение списания зарезервированных ранее условных баллов электронного социального сертификата (AcceptorBatchTransferRequest) содержит Таблица 3.2.
Таблица 3.2 - Состав реквизитов запроса
Код тэга в спецификации ISO 20022 |
<XML Тэг> |
Обозначение |
Отн. |
Тип |
Значения по умолчанию и правила заполнения |
|
<AccptrBtchTrf> |
|
|
|
|
1.0 |
<Hdr> |
Заголовок |
[1..1] |
|
|
1.1 |
<DwnldTrfi> |
Указывает, что передача файла загрузки или выгрузки |
[1..1] |
Indicator |
False |
1.2 |
<FrmtVrsn> |
Версия спецификации протокола |
[1..1] |
Text |
01.00 |
1.3 |
<XchgId> |
Счетчик обращений |
[1..1] |
Text |
Количество обращений внешней ИС к системе ОПЦ. Значение от 0 до 999 с шагом 1. При достижении значения 999 нумерация начинается с 0. |
1.4 |
<CreDtTm> |
Дата и время создания сообщения |
[1..1] |
DateTime |
Счетчик обращений и дата и время создания сообщения должны быть уникальны. |
1.5 |
<InitgPty> |
Идентификация отправителя сообщения (внешней ИС) |
[1..1] |
|
|
1.6 |
<Id> |
Идентификатор внешней ИС в системе ГИС ОПЦ. |
[1..1] |
Text |
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ |
2.0 |
<DataSet> |
Информация о наборе транзакций |
[1..*] |
|
Для каждого кода валюты - свой набор транзакций |
2.1 |
<DataSetId> |
Идентификатор набора данных |
[1..1] |
|
|
2.2 |
<Nm> |
Наименование набора данных |
[1..1] |
Text |
Заполняется Участником. Желательное наименование набора данных "Перечень транзакций за ___ ____ _____г." |
2.3 |
<Tp> |
Категория набора данных |
[1..1] |
Code |
Принимает значение "ТХСР" |
2.5 |
<CreDtTm> |
Дата и время создания набора данных |
[1..1] |
DateTimе |
Дата и время создания сообщения Участником |
2.19 |
<TxTtls> |
Суммарная информация по транзакциям |
[1..*] |
|
|
2.22 |
<Ccy> |
Валюта общей суммы |
[0..1] |
Code |
Код условной валюты |
2.23 |
<Tp> |
Категория набора данных |
[1..1] |
Code |
Принимает значение "DEBT" - списание средств |
2.24 |
<TtlNb> |
Общее число транзакций |
[1..1] |
Text |
Общее количество транзакций в наборе с одной валютой |
2.25 |
<CmltvAmt> |
Общая сумма транзакций |
[1..1] |
Amount |
Общая сумма группы транзакций в наборе с одной валютой |
2.26 |
<CmonData> |
Информация общая для всего набора транзакций |
[0..1] |
|
|
2.27 |
<Envt> |
Окружение |
[0..1] |
|
|
2.35 |
<Mrchnt> |
Торговая точка Участника |
[0..1] |
|
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ При обмене с ГИС ОПЦ указывать обязательно |
2.36 |
<Id> |
Идентификация торговой точки Участника |
[0..1] |
|
|
2.37 |
<Id> |
Идентификатор |
[1..1] |
Text |
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ |
2.46 |
<POI> |
Терминал, обслуживающий держателя карты |
[0..1] |
|
|
2.47 |
<Id> |
Идентификация терминала |
[1..1] |
|
|
2.48 |
<Id> |
Идентификатор терминала |
[1..1] |
Text |
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ |
2.89 |
<TxTp> |
Тип транзакции |
[0..1] |
Code |
Принимает значение "CRDP" - при списании |
|
<Ccy> |
Код валюты |
[0..1] |
Code |
Код условной валюты |
2.95 |
<TxToCaptr> |
Набор транзакций для сбора |
[0..*] |
|
|
2.96 |
<TxSeqCntr> |
Порядковый номер транзакции в наборе |
[1..1] |
Text |
|
2.105 |
<Envt> |
Окружение транзакции |
[1..1] |
|
|
2.113 |
<Mrchnt> |
Торговая точка Участника |
[0..1] |
|
|
2.114 |
<Id> |
Идентификация торговой точки Участника |
[0..1] |
|
|
2.115 |
<Id> |
Идентификатор |
[1..1] |
Text |
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ |
2.124 |
<POI> |
Терминал, обслуживающий держателя карты |
[0..1] |
|
|
2.125 |
<Id> |
Идентификация терминала |
[1..1] |
|
|
2.126 |
<Id> |
Идентификатор терминала |
[1..1] |
Text |
Идентификатор присваивается при регистрации Участника в ГИС ОПЦ |
2.148 |
<Card> |
Карта, используемая в транзакции |
[1..1] |
|
|
2.152 |
<PlainCardData> |
Данные карты |
[0..1] |
|
При взаимодействии с ГИС ОПЦ заполняется обязательно |
2.153 |
<PAN> |
Номер карты, идентификатор карты |
[1..1] |
Text |
Допустимые значения: номер и серия СК без пробелов и разделителей (если CardPdctPrfl имеет значение 0010); номер РЭСП (если CardPdctPrfl имеет значение 0020); PAN если CardPdctPrfl отсутствует |
2.155 |
......<FctvDt> |
Дата начала действия карты |
[0..1] |
DateTimе |
Дата в формате Год-Месяц |
2.156 |
<XpryDt> |
Дата окончания действия карты |
[1..1] |
DateTimе |
Дата в формате Год-Месяц В случае считывания идентификатора карты со штрих-кода указывается текущая дата |
2.162 |
<CardPdctPrfl> |
Код профиля карты, выбирается в зависимости от используемого типа идентификатора карты |
[0..1] |
Text |
Допустимые значения при взаимодействии с ОПТ): 0010; 0020 |
2.177 |
<Cntxt> |
Контекст транзакции |
[0..1] |
|
|
2.178 |
<PmtCntxt> |
Контекст транзакции |
[0..1] |
|
|
2.187 |
<CardDataNtryMd> |
Режим считывания карты |
[1..1] |
Code |
Принимает следующие значения: BRCD или CICC или CTLS или ЕСТЬ или MGST Значение поля связано с кодом профиля карты: BRCD - если CardPdctPrfl принимает значение 0010 MGST - если CardPdctPrfl отсутствует CTLS: ЕСТЬ - если если CardPdctPrfl принимает значение 0020 |
2.196 |
<Тх> |
Транзакция |
[1..1] |
|
|
2.197 |
<ТхТр> |
Тип транзакции |
[0..1] |
Code |
Принимает значение "CRDP" (платеж по карте) |
2.200 |
<MrchntCtgyCd> |
Код категории обслуживания по ISO 18245 |
[0..1] |
Text |
Принимает значение "5411" - супермаркет |
2.201 |
<TxId> |
Идентификатор транзакции, присвоенный терминалом |
[1..1] |
|
|
2.202 |
<TxDtTm> |
Дата и время транзакции в терминале |
[1..1] |
DateTimе |
Дата и время транзакции в терминале |
2.203 |
<TxRef> |
Идентификатор транзакции в терминале |
[1..1] |
Text |
Идентификатор транзакции в терминале |
2.204 |
<OrgnlTx> |
Идентификация оригинальной транзакции |
[1..1] |
|
Идентификация подтверждаемой транзакции |
2.205 |
<TxId> |
Идентификатор транзакции |
[1..1] |
|
|
2.206 |
<TxDtTm> |
Дата и время транзакции в терминале |
[1..1] |
DateTimе |
Дата и время оригинальной транзакции (из AcceptorAuthorisationRequest) |
2.207 |
<TxRef> |
Идентификатор транзакции в терминале |
[1..1] |
Text |
Идентификатор оригинальной транзакции (из AcceptorAuthorisationRequest) |
2.208 |
<POIId> |
Идентификация терминала, сделавшего оригинальную транзакцию |
[0..1] |
|
|
2.209 |
<Id> |
Идентификатор терминала |
[1..1] |
Text |
Идентификатор терминала оригинальной транзакции (из AcceptorAuthorisationRequest) |
2.210 |
<TxTp> |
Тип транзакции |
[1..1] |
Code |
Принимает значение "CRDP" |
2.211 |
<TxRslt> |
Результат обработки оригинальной транзакции в ИС НФП |
[0..1] |
|
|
2.212 |
<RspnT о Authstn> |
Результат авторизации в ИС НФП |
[1..1] |
|
|
2.213 |
<RspnRsn> |
Результат |
[1..1] |
Code |
Допустимое значение: "APPR" (Принято) |
2.214 |
<AuthstnCd> |
Код авторизации |
[0..1] |
Text |
При взаимодействии с ИС НФП заполняется обязательно Возвращается из ИС НФП в AcceptorAuthorisationResponse в тэге AuthstnCd |
2.235 |
<TxSucss> |
|
|
|
Принимаемые значения: "true". |
2.236 |
<TxDtls> |
Данные транзакции |
[1..1] |
|
|
2.237 |
<Ссу> |
Код валюты |
[0..1] |
Code |
Код условной валюты |
2.238 |
<TtlAmt> |
Сумма транзакции |
[1..1] |
Amount |
Сумма транзакции |
2.252 |
<Pdct> |
Товары |
[0..*] |
|
|
2.253 |
<PdctCd> |
Код товара в системе ОПЦ |
[1..1] |
Text |
Код товара Участника (код, который был указан при отправке списка товаров на утверждение в ДТСЗН) |
2.255 |
<PdctQty> |
Количество продукта |
[0..1] |
Quantity |
Количество купленного товара |
2.256 |
<UnitPric> |
Цена за единицу |
[0..1] |
Amount |
Цена товара |
2.257 |
<PdctAmt> |
Стоимость проданного продукта |
[1..1] |
Amount |
Стоимость продукта: <PdctAmt>=<PdctQty> |
3.0 |
<SctyTrlr> |
Блок безопасности сообщения. |
[1..1] |
|
|
3.1 |
<CnttTp> |
Тип защиты данных |
[1..1] |
Code |
Принимаемые значения: "AUTH" - в случае применения системы аутентичности сообщений РЭСП. Код профиля карты 0020; "DATA" - в остальных случаях |
3.2 |
<AuthntcdData> |
Защита данных системой аутентичности сообщений РЭСП |
[0..*] |
+ |
Заполняется в случае применения системы аутентичности сообщений РЭСП |
1.4. Структура ответа
Состав и порядок заполнения реквизитов ответа на запрос подтверждения списания зарезервированных ранее условных баллов электронного социального сертификата (AcceptorBatchTransferResponse) содержит Таблица 3.3.
Таблица 3.3 - Состав реквизитов ответа
Код тэга в спецификации ISO 20022 |
<XML Тэг> |
Обозначение |
Отн. |
Тип |
Значения по умолчанию и правила заполнения |
<AccptrBtchTrfRspn> |
|
|
|
|
|
1.0 |
<Hdr> |
Заголовок |
[1..1] |
|
|
1.1 |
<DwnldTrf> |
Указывает, что передача файла загрузки или выгрузки |
[1..1] |
Indicator |
Принимает значение "False" |
1.2 |
<FrmtVrsn> |
Версия спецификации протокола |
[1..1] |
Text |
01.00 |
1.3 |
<XchgId> |
Счетчик обращений |
[1..1] |
Text |
Количество обращений ТИС ОПЦ к кассовой системе. Значение от 0 до 999 с шагом 1. При достижении значения 999 нумерация начинается с 0. |
1.4 |
<CreDtTm> |
Дата и время создания сообщения |
[1..1] |
DateTimе |
Счетчик обращений и дата и время создания сообщения должны быть уникальны. |
1.5 |
<InitgPty> |
Идентификация отправителя сообщения (ГИС ОПЦ) |
[1..1] |
|
|
1.6 |
<Id> |
Идентификатор ГИС ОПЦ как Участника взаимодействия |
[1..1] |
Text |
Идентификатор ГИС ОПЦ как Участника взаимодействия |
2.0 |
<DataSet> |
Информация о посланных транзакциях (для каждого кода валюты - свой набор данных) |
[1..*] |
|
|
2.1 |
<DataSetId> |
Идентификатор набора данных |
[1..1] |
|
|
2.2 |
<Nm> |
Наименование набора данных |
[1..1] |
Text |
Указывается значение из запроса |
2.3 |
<Tp> |
Категория набора данных |
[1..1] |
Code |
Указывается значение из запроса |
2.5 |
<CreDtTm> |
Дата и время создания набора данных |
[1..1] |
DateTime |
Указывается значение из запроса |
2.6 |
<DataSetRslt> |
Результат приема транзакций |
[1..1] |
|
|
2.7 |
<Rspn> |
Код результата |
[1..1] |
Code |
Принимает значения 1) APPR - полностью принято. Если все транзакции успешно приняты ГИС ОПЦ; 2) DECL - полностью отказано. Если ни одна транзакция не принята ГИС ОПЦ; 3) PART - частично принято. Если одна или несколько транзакций не приняты ГИС ОПЦ; 4) TECH - техническая ошибка |
2.9 |
<RmvDataSet> |
Индикатор того, что транзакции могут быть удалены из терминала |
[1..1] |
Indicator |
Принимает значение "True" |
2.15 |
<TxTtls> |
Суммарная информация по транзакциям |
[1..*] |
|
|
2.18 |
<Ссу> |
Валюта общей суммы |
[0..1] |
Code |
Указывается значение из запроса |
2.19 |
<Тр> |
Категория набора данных |
[1..1] |
Code |
Указывается значение из запроса |
2.20 |
<TtlNb> |
Общее число транзакций |
[1..1] |
Text |
Указывается значение из запроса |
2.21 |
<CmltvAmt> |
Общая сумма транзакций |
[1..1] |
Amount |
Указывается значение из запроса |
2.22 |
<RjctdTx> |
Транзакции, которые не прошли контроль при приеме в ОПЦ |
[0..*] |
|
ГИС ОПЦ в этот блок помещает транзакции, не прошедшие обработку. |
2.23 |
<TxSeqCntr> |
Порядковый номер транзакции в наборе |
[1..1] |
Text |
Присваивается порядковый номер транзакции, не прошедший обработку в ГИС ОПЦ. Указывается значение из запроса |
2.24 |
<TxRspn> |
Ответ на транзакцию |
[1..1] |
|
|
2.25 |
<Rspn> |
Результат обработки транзакции |
[1..1] |
Code |
Код по спецификации IS020022/ Принимает следующие значения: DECL - полностью отказано. Если транзакция не принята ГИС ОПЦ; PART - частично принято. Если не все данные транзакции приняты ГИС ОПЦ; TECH - техническая ошибка |
2.26 |
<Rspn> |
Детали результата обработки транзакции |
[0..1] |
Text |
Код ошибки ГИС ОПЦ |
2.27 |
<Envt> |
Окружение транзакции |
[1..1] |
|
|
2.35 |
<MrchntId> |
Торговая точка Участника |
[0..1] |
|
При взаимодействии с ГИС ОПЦ заполняется обязательно |
2.36 |
<Id> |
Идентификатор торговой точки Участника |
[1..1] |
Text |
Указывается значение из запроса |
2.40 |
<POIId> |
Терминал, обслуживающий держателя карты |
[1..1] |
|
|
2.41 |
<Id> |
Идентификатор терминала |
[1..1] |
Text |
Указывается значение из запроса |
2.52 |
<PlainCardData> |
Данные карты |
[0..1] |
|
|
2.53 |
<PAN> |
Номер карты, идентификатор карты |
[1..1] |
Text |
Значение равно идентификатору карты из запроса AcceptorBatchTransferRequest. |
2.56 |
<XpryDt> |
Дата окончания действия карты |
[1..1] |
DateTime |
Значение равно дате окончания действия карты из запроса AcceptorBatchTransferRequest. |
2.57 |
<Tx> |
транзакция |
[1..1] |
|
|
2.58 |
<TxId> |
Идентификатор транзакции, присвоенный терминалом |
[1..1] |
|
|
2.59 |
<TxDtTm> |
Дата и время транзакции в терминале |
[1..1] |
DateTimе |
Указывается значение из запроса |
2.60 |
<TxRef> |
Идентификатор транзакции в терминале |
[1..1] |
Text |
Указывается значение из запроса |
2.61 |
<Rspn> |
Результат транзакции |
[1..1] |
Code |
Указывается значение из запроса |
3.0 |
<SctyTrlr> |
Блок безопасности сообщения. |
[1..1] |
|
|
3.1 |
<CnttTp> |
Тип защиты данных |
[1..1] |
Code |
Принимаемые значения: "AUTH" - в случае применения системы аутентичности сообщений РЭСП; "DATA" - в остальных случаях. |
3.2 |
<AuthntcdData> |
Защита данных системой аутентичности сообщений РЭСП |
[0..*] |
+ |
Заполняется в случае применения системы аутентичности сообщений РЭСП |
Таблица 4.2 - Состав реквизитов файла с результатом обработки
<XML Tag> |
Наименование реквизита |
Обязательность поля |
Формат |
Значения по умолчанию и правила заполнения |
<importCatalogResponse> |
|
|
|
|
<responseHeader> |
Идентификатор заголовка ответа |
[1...1] |
|
Тег должен содержать атрибут "Id" - идентификатор ответа в формате UUID |
<createDateTime> |
Дата и время создания сообщения |
[1...1] |
Дата |
Дата и время создания ответа запрос |
<sender> |
Отправитель ответа |
[1...1] |
Символьное |
|
<id> |
Идентификатор отправителя ответа |
[1...1] |
Символьное |
Код Системы (присваивается при регистрации в ГИС ОПЦ) |
<shortName> |
Краткое наименование отправителя ответа |
[0...1] |
|
Краткое наименование отправителя запроса |
<requestHeader> |
Идентификатор заголовка запроса |
[0...1] |
|
Тег должен содержать атрибут "Id" - идентификатор запроса в формате UUID. |
<createDateT ime> |
Дата и время создания запроса |
[1...1] |
Дата |
Дата и время создания запроса (значение из запроса, по результатам обработки которого формируется ответ) |
<sender> |
Отправитель |
[1...1] |
Символьное |
Из входящего файла |
<id> |
Идентификатор отправителя |
[1...1] |
Символьное |
Идентификатор (выдается при регистрации в ГИС ОПЦ). |
<shortName> |
Краткое наименование отправителя |
[0...1] |
Символьное |
Краткое наименование (максимально 35 символов) |
<initiator> |
Инициатор |
[0...1] |
Символьное |
Из входящего файла |
<id> |
Идентификатор инициатора |
[1...1] |
Символьное |
Идентификатор электронной площадки (выдается при регистрации в ГИС ОПЦ). |
<shortName> |
Краткое наименование инициатора |
[0...1] |
Символьное |
Краткое наименование (максимально 35 символов) |
<responseResult> |
Результат обработки |
[1...1] |
|
Результат загрузки каталога в ГИС ОПЦ |
<result> |
Результат |
[1...1] |
|
|
<resultCode> |
Код результата |
[1...1] |
Символьное |
Код общего результата обработки |
<resultText> |
Текст сообщения о результате обработки запроса |
[0...1] |
Символьное |
Текст описания кода общего результата |
Если вы являетесь пользователем интернет-версии системы ГАРАНТ, вы можете открыть этот документ прямо сейчас или запросить по Горячей линии в системе.