Главная Учебники - Разные Техническое задание. Разработка фрагмента Информационной системы межоператорского взаимодействия (2016 год)
поиск по сайту правообладателям
|
|
|
содержание .. 4 5 6 7 ..
Точное содержание OBUTransactionType указано
далее
- Кодификация
элементов межоператорского взаимодействия. В следующей таблице
представлена сводка ключевой информации:
Атрибут
Тип данных
Описание
TrxBatchId(1)
Объемный
Идентифицирует
обмениваемый
список
транзакций для каждого
пакета.
TrxBundleNumber(1)
Объемный
Порядковый
номер,
который идентифицирует
каждую
передачу
транзакций при том же
«TrxBatchIdª.
Использование
этого
элемента
позволяет
Эмитенту обнаруживать
факт
неполучения
передачи от Поставщика
услуги.
Примечание: В конце дня
последовательность
инициализируется
к
одному (1).
OBUTypeListBatchId/TableVersion
Объемный
Идентифицирует
идентификатор
пакета
списка OBUGeneric, по
которому
выполняется
транзакция.
OBUTypeListBundleNumber
Объемный
Идентифицирует номер
группирования
списка
OBUGeneric, по которому
выполняется транзакция.
200
Атрибут
Тип данных
Описание
OBUGenericTypeListBatchId/TableVersion
Объемный
Идентифицирует
идентификатор
пакета
списка OBUGeneric, по
которому
выполняется
транзакция.
OBUGenericTypeListBundleNumber
Объемный
Идентифицирует номер
группирования
списка
OBUGeneric, по которому
выполняется транзакция.
TransactionExitReferenceId
Строка
Идентификатор
референсной транзакции
создается
выездным
Поставщиком услуги.
VehicleReferenceId
Строка
Этот
тип
данных
опциональный
и
используется
только
некоторыми
Поставщиками
услуг.
Присваивается системой
классификации.
TAdjReqBatchID(1)
Объемный
Ссылка
на
Запрос
корректировки - Пакета.
Ноль для первоначальной
транзакции.
Adjustement SeqNumber (1)
Целое число
0 для обычной транзакции,
осуществляется
увеличение на
1 каждый
раз и корректировка
201
Атрибут
Тип данных
Описание
Status of adjustment (1)
Целое число
0
для
стандартной
транзакции
1
для
запроса
корректировки
2 для следования запросу
3 для отклонения запроса
TypeOfAdjustment (1)
Целое число
Тип
запрашиваемой
корректировки:
0 для первоначальной
транзакции
1
Изменение
класса
транспортного средства
2
Изменение полной
стоимости
3 Модуляция стоимости
TollChargerIdExit
Целое число
Идентификационный
номер Поставщика услуги
выездного ПВП (включая
код страны + ИНН).
ChargePointIdExit
Целое число
Идентификационный
номер выездного ПВП, в
формате
“БДДДSSGGККККН”
LaneIdExit
Целое число
Идентификационный
номер Полосы ЭСРП (0-
xxxx) (выездная полоса)
202
Атрибут
Тип данных
Описание
TypeofReadingExit
Целое число
Определяет тип обработки
Поставщиком
услуги
Выездной полосы:
1
с
использованием
внешней антенны ЭВП,
2 внутренней антенны
ЭВП,
3 другое
DateTimeExit
ДатаВремя
Дата/время
Транзакции
(выезд).
TollChargerIdEntry
Целое число
Идентификатор
Поставщика услуги
(код
страны + ИНН) въездной
Полосы ЭСРП
Примечание:
Этот
атрибут является
0 в
случае
Открытой
системы взимания платы.
ChargePointIdEntry
Целое число
Идентификационный
номер въездного ПВП, в
формате
“БДДДSSGGККККН”.
Примечание:
Этот
атрибут является
0 в
случае
открытой
системы взимания платы.
LaneIdEntry
Целое число
Идентификационный
номер Полосы ЭСРП (0-
xxxx) (въездная полоса)
Примечание:
Этот
атрибут является
0 в
случае
открытой
системы взимания платы.
203
Атрибут
Тип данных
Описание
DateTimeEntry
DateTime
Дата/время
Транзакции
(Въезд) считывается из
receiptdata
и
конвертируется в "ГГГГ-
MM-ДДВЧ24: мм: сс.ссс +
-ЧЧ MM", допуская, что
часовой пояс такой же, что
и на выездном ПВП, где
совершается транзакция
(receiptdata не включает
часовой пояс)
Примечание:
Этот
атрибут является
0 в
случае
открытой
системы взимания платы.
TransactionAmount
Целое число
Общая сумма транзакции,
включая НДС до копеек.
TransactionAmount adjustment (1)
Целое число
Корректировка
произведена по сумме
транзакции.
VatRate
Десятичное
Ставка НДС, выраженная
в процентах
(например,
19.25% = 0.1925).
ChargedVehicleClassExit
Целое число
Класс ТС как определено
Поставщиком
услуги
выездной полосы.
AdjustedVehicleClassExit(1)
Целое число
Если
класс
ТС
скорректирован,
новый
класс ТС.
Для
первоначальной
транзакции
класс
установлен на 0.
204
Атрибут
Тип данных
Описание
Misclassification
Булеан
Запускается,
если
идентифицируется
ошибочная классификация
со стороны Поставщика
услуги на выезде.
Пояснение
будет
предоставлено
в
дальнейшем.
EFCContextMark
Таблица
Специальные значения и
Кодификация
описание атрибута даны в
ЭСРП
таблице
Кодификация
ЭСРП.
PaymentMeans
Таблица
Специальные значения и
Кодификация
описание атрибута даны в
ЭСРП
таблице
Кодификация
ЭСРП,
идентификатор
атрибута 32.
VST
Строка
Полный VST, как считан с
ЭСРП на уровне антенны.
READDATA
Строка
Все значения атрибутов,
как считаны с ЭСРП в All
attributes values as read
from the OBU на уровне
антенны.
AuthenticationKeyResult
Строка
Результат
проверки
подлинности ключа.
Эти данные предназначены для корректировки. Представлены здесь в
качестве использования механизма корректировки OBUTransactionType
Примечание: Если транзакции заблокированы на полосе (в основном по
техническим причинам: отключение от сети), они будут включены в текущий
TrxBatchId, даже если от другой даты.
205
Эти транзакции также будут включены в соответствующий
receiveReconciliationInfo (см. Раздел
)
Выходные параметры
Сервис receiveTransactionList возвращает в результате одноименный элемент
receiveTransactionListResponse,
который
инкапсулирует
элемент
TransactionStatusResult типа данных TransactionStatusResult.
Следующая информация уточняет содержание TransactionStatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см.
раздел 8.3
ResultDescription
Строка
Описание кода результата.
Может содержать более
подробное
объяснение
ошибки (при наличии) Текст
ошибки
LastValues
TransactionStatusResult
Содержит
последнии
значения
TrxBatchID,
TrxBundleNumber,
FirstSeqNumber
FirstTransactionSeq umber и
LastTransactionSeqNumber,
полученные до текущего
вызова.
4.2 Сервис: heartBeat
Обратитесь к разделу 3.3.
5 Требования к интерфейсам для корректировки и сверки
206
Следующий текст является спецификацией обмена данными между
Поставщиками услуги и Эмитентами, для проверки транзакций, возможных
корректировок и окончательной сверки расчетов.
Указанная ниже информация разработана на основе реализации веб-сервиса,
так как это считается самым современным принципом реализации. Любое другое
решение, которое обеспечивает аналогичные или лучшие характеристики, может
быть рассмотрено, после надлежащей предварительной демонстрации того, что оно
точно учитывает все требования при надлежащих показателях
(доступность,
надежность и конфиденциальность).
В следующем списке представлены минимальные сервисы, которые должны
осуществляться в рамках ИСМВ для предоставления соответствующей
информации, когда транзакция должна быть скорректирована, после чего
происходит сверка по конкретной транзакции.
Имя сервиса
Входные
Возвращаемое
Описание
параметры
значение
receiveTransactionAdju
TransactionAdjustme
StatusResult
Этот сервис вызывается,
stmentList
ntList
когда Эмитент определяет,
что
транзакция
от
Поставщика услуги должна
быть
скорректирована
(например,
когда
неправильно считано ЭСРП,
неправильно
применен
Тариф), Эмитент направляет
Поставщику
услуги
корректировку
транзакции
для запроса корректировки.
Симметрично
для
Поставщика услуги.
207
Имя сервиса
Входные
Возвращаемое
Описание
параметры
значение
ReceiveTransactionAdj
TransactionAdjustme
StatusResult
Аналогично вышеуказанному
ustmentRequestList
ntList
сервису,
этот
сервис
вызывается от Поставщика
услуги для того, чтобы
изменить транзакцию или
ответить
на запрос о
корректировке транзакции от
Эмитента.
receiveTransactionAdju
TransactionAdjustme
StatusResult.
Этот сервис вызывается от
stmentReconciliationInf
ntReconciliationInfo
какой-либо Стороны для
o
выполнения сверки списка
корректировки транзакций на
основе объектов данных,
переданных в рамках обмена
между Поставщиком услуги и
Эмитентом.
Службы корректировки вызываются от одной Стороны к другой, чтобы
запросить
корректировку.
Договоренности,
достигнутые
Сторонами,
регистрируются в файлах сверки
расчетов с использованием списков,
перечисленных далее.
В следующей таблице представлены сервисы, которые должны
осуществляться в рамках ИСМВ для предоставления соответствующей
информации для создания файлов сверки транзакций за определенный период
времени, на основе которых будут выставляться счета между Сторонами, в том
числе счета Пользователей, содержащие возможные корректировки.
Имя сервиса
Входные
Возвращаемое
Описание
параметры
значение
208
receiveReconciliatio
ReconciliationConf
StatusResult
Этот сервис вызывается от
nConfirm
irm
Поставщика услуги для того,
чтобы подтвердить у Эмитента
сверку на основе объектов данных
передаваемых в рамках обмена за
определенный период времени
receiveReconciliatio
ReconciliationInfo
StatusResult
Этот сервис вызывается от
nInfo
Эмитента для того, чтобы
подтвердить у Поставщика услуг
сверку на основе объектов данных
передаваемых в рамках обмена за
определенный период времени
Как Эмитент, так и Поставщик услуги могут направить запрос на
корректировку, а также принимать, изменять или отклонять такой запрос, если это
следует делать для оплаты между Сторонами.
Сервис .1 используется для обмена запросов на корректировки от Эмитента
и возможных поправок к ним. Они используются в каждом конкретном случае.
Сервис
.2
используется Поставщиком услуги для урегулирования
требования (либо согласовать, либо отклонить) по запросам на корректировки от
Эмитента и для информирования Эмитента об изменениях транзакции по
инициативе Поставщика услуги. Используется в зависимости от конкретного
случая.
.Сервис
.3 используется любой Стороной согласно договоренностям в
рамках Соглашения для выдачи списков транзакций и корректировок с учетом
возможных отклонений корректировок. Этот сервис используется в каждом
конкретном случае и по запросу Эмитента или Поставщика услуги.
Сервис .4 используется между Поставщиками услуги и Эмитентами для
указания точной информации в конкретные периоды, в которые они договорились
использовать в качестве основы для выставления счета.
Пример процесса в случае простого процесса представлен здесь ниже:
209
1. Пользователь осуществляет проезд с ЭСРП от “Эмитента-А” по дороге
“Поставщика
услуги-Б”,
Поставщик
услуги
использует
сервис
receiveTransactionList в отношении Эмитента-А для передачи информации об этой
транзакции, называемой “транзакция-1”.
2. В тот же определенный период для сверки Поставщик услуги-Б использует
сервис receiveReconciliationInfo в отношении Эмитента-А для суммирования
транзакций, которые были отправлены за этот период. Этот список будет включать
в себя транзакцию-1.
3. После анализа
(до или после получения receiveReconciliationInfo),
Эмитент-А запрашивает корректировку транзакции в отношении транзакции-1, в
отношении выдающей стороны Поставщика услуги-Б. Эмитент-А использует
сервис receiveTransactionAdjustmentList в отношении Поставщика услуги-Б.
4. Поставщик услуги-Б анализирует запрос на корректировку транзакций. В
этом примере Поставщик услуги-Б принимает запрос на корректировку без каких-
либо изменений или модификаций. Поставщик услуги-Б использует сервис
receiveTransactionAdjustmentStatusList
для информирования об
указанной
корректировке в отношении Эмитента-А.
. В тот же определенный период для сверки, Поставщик услуги-Б
использует сервис receiveTransactionAdjustmentReconciliationInfo в отношении
Эмитента-А для идентификации транзакций, которые были отправлены, и
корректировок, которые были сверены, в течение этого периода. Этот список будет
включать в себя transactionadj-1.
5.1 Сервис: receiveTransactionAdjustmentList
Этот сервис вызывается, когда Эмитент заявляет, что транзакция от
Поставщика услуги должна быть скорректирована (например, когда неправильно
считано ЭСРП, неправильно начислена плата, произошла ошибочная
классификация), Эмитент направляет Поставщику услуги корректировку
транзакции для запроса корректировки.
210
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receiveTransactionAdjustmentList имеет один входной параметр, тип
данных TransactionAdjustmentList.
Следующая информация описывает
TransactionAdjustmentList:
Атрибут
Тип данных
Описание
Timestamp/MsgTS
ДатаВремя
Время отправки сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не
меняется от отправителя к
получателю.
ETSProviderId
Строка
Определяет Эмитента
(код
страны
+ идентификатор
эмитента),
который
отправляет
запрос
корректировки.
TollChargerId
Строка
Определяет
Поставщика
услуги
(код страны
+
идентификатор
эмитента),
который
получает
корректировки.
AdjBatchId
Объемный
Идентифицирует
передаваемый
в
рамках
обмена список изменений в
каждом пакете и помогает
идентифицировать
отсутствующие
корректировки.
211
Атрибут
Тип данных
Описание
AdjBundleNumber
Объемный
Это порядковый
номер,
который
идентифицирует
передачу
каждой
корректировки под тем же
«AdjBatchIdª.
Примечание:
Сохранение значений этого
элемента
в
последовательности
позволяет
получающей
Стороне
недостающие
передачи от отправляющей
Стороны.
Предыдущий
Объемный
То же, что и выше, позволяет
AdjBundleNumber
обнаруживать недостающее
сообщение.
TotalAdjQuantity
Целое число
Общее количество транзакций.
TotalTrxAmount
Целое число
Общая сумма транзакций
(после корректировки) до
копеек.
TotalAdjAmt
Целое число (подписанное)
Общая сумма корректировок
транзакций
(плюс и минус)
для обработки Поставщиком
услуги до копеек.
AdjustedTransaction
Список
элементов
Список
запросов
на
OBUTransactionT (1-ххххх)
корректировку транзакций.
Элементы
OBUTransactionType указаны
в следующей таблице.
Тип данных OBUTransactionType должен содержать следующую
информацию:
212
Атрибут
Тип данных
Описание
TrxBatchId
Объемный
Относится к идентификатору
пакета транзакции, которая
корректируется.
TrxBundleNumber
Объемный
Относится к идентификатору
группирования транзакции,
которая корректируется.
OBUListBatchId/TableVersion
Объемный
Определяет идентификатор
пакета списка ЭСРП, по
которому была совершена
транзакция.
OBUListBundleNumber
Объемный
Определяет
номер
группирования списка ЭСРП,
по которому была совершена
транзакция.
OBUGenericTypeListBatchId/TableVersion
Объемный
Определяет идентификатор
пакета списка OBUGeneric,
по которому совершается
транзакция.
OBUGenericTypeListBundleNumber
Объемный
Определяет
номер
группирования
списка
OBUGeneric, по которому
совершается транзакция.
TransactionSeqNumber
Объемный
Порядковый номер, который
указывает
порядок
корректировки для текущего
«TrxBatchIdª.
TransactionExitReferenceId
Строка
Ссылочный идентификатор
транзакции, сформированный
Поставщиком услуги на
выезде.
213
Атрибут
Тип данных
Описание
VehicleReferenceId
Строка
Этот
тип
данных
опциональный
и
используется
только
некоторыми Поставщиками
услуг.
Присваивается
системой классификации.
TAdjReqBatchID
Объемный
Ссылка
на
Запрос
корректировки - пакет.
Ноль для первоначальной
транзакции.
Adjustement SeqNumber
Целое число
0 для обычной транзакции,
осуществляется увеличение
на
1
каждый раз и
корректировка
Status of adjustment
Целое число
0 для стандартной транзакции
1 для запроса корректировки
от Эмитента
2 для следования запросу от
Поставщика услуги
3 для отклонения запроса от
Поставщика услуги
4 для скорректированной
транзакции от Поставщика
услуги
TypeOfAdjustment
Целое число
Тип
запрашиваемой
корректировки:
0
для
первоначальной
транзакции
1
Изменение
класса
транспортного средства
2
Изменение
полной
стоимости
3 Модуляция стоимости
214
Атрибут
Тип данных
Описание
TollChargerIdExit
Целое число
Идентификационный номер
Поставщика
услуги
выездного пункта взимания
платы, (включая код страны +
ИНН).
ChargePointIdExit
Целое число
Идентификационный номер
выездного ПВП, в формате
“БДДДSSGGККККН”
LaneIdExit
Целое число
Идентификационный номер
Полосы ЭСРП
(0-xxxx)
(выездная полоса).
TypeofReadingExit
Целое число
Определяет тип обработки
Поставщиком
услуги
Выездной полосы:
1 с использованием внешней
антенны ЭВП,
2 внутренней антенны ЭВП,
3 другое
DateTimeExit
ДатаВремя
Дата/время
Транзакции
(выезд).
TollChargerIdEntry
Целое число
Идентификатор Поставщика
услуги (код страны + ИНН)
въездного ПВП
Примечание: Этот атрибут
является
0
в
случае
Открытой
системы
взимания платы.
215
Атрибут
Тип данных
Описание
ChargePointIdEntry
Целое число
Идентификационный номер
въездного ПВП, в формате
“БДДДSSGGККККН”.
Примечание: Этот атрибут
является
0
в
случае
открытой системы взимания
платы.
LaneIdEntry
Целое число
Идентификационный номер
Полосы ЭСРП
(0-xxxx)
(въездная полоса)
Примечание: Этот атрибут
является
0
в
случае
открытой системы взимания
платы
DateTimeEntry
DateTime
Дата/время
Транзакции
(Въезд)
считывается
из
receiptdata и конвертируется в
"ГГГГ-MM-ДДВЧ24:
мм:
сс.ссс + -ЧЧ MM", допуская,
что часовой пояс такой же,
что и на выездном ПВП, где
совершается
транзакция
(receiptdata
не включает
часовой пояс)
Примечание: Этот атрибут
является
0
в
случае
открытой системы взимания
платы.
TransactionAmount
Целое число
Общая сумма транзакции,
включая НДС до копеек,
включая корректировку.
TransactionAmount adjustment
Целое число
Корректировка произведена
(подписанное)
по сумме транзакции.
216
Атрибут
Тип данных
Описание
VatRate
Десятичное
Ставка НДС, выраженная в
процентах (например, 19.2 %
= 0.1925)
ChargedVehicleClassExit
Целое число
Класс ТС как определено
Поставщиком
услуги
выездной
полосы
в
первоначальной транзакции
AdjustedVehicleClassExit
Целое число
Если
класс
ТС
скорректирован, новый класс
ТС.
Для
Отмены,
класс
установлен на 0
Misclassification
Булеан
Запускается,
если
идентифицируется
ошибочная классификация со
стороны Поставщика услуги
на выезде.
EFCContextMark
Таблица
Специальные значения и
Кодификация
описание атрибута даны в
ЭСРП
таблице Кодификация.
PaymentMeans
Таблица
Специальные значения и
Кодификация
описание атрибута даны в
ЭСРП
таблице Кодификация ЭСРП,
идентификатор атрибута 32.
VST
Строка
Полный VST, как считан с
ЭСРП на уровне антенны.
READDATA
Строка
Все значения атрибутов, как
считаны с ЭСРП на уровне
антенны.
AuthenticationKeyResult
Строка
Результат
проверки
подлинности ключа.
Выходные параметры
217
Сервис receiveTransactionList возвращает в результате одноименный элемент
receiveTransactionListResponse, который инкапсулирует элемент StatusResult типа
данных StatusResult.
StatusResult должен содержать следующую информацию:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см.
раздел 8.3
ResultDescription
Строка
Описание кода результата.
Может содержать более
подробное
объяснение
ошибки (при наличии)
5.2 Сервис: receiveTransactionAdjustmentStatusList
Аналогично предыдущему сервису, данный сервис вызывается от
Поставщика услуги через ИСМВ для того, чтобы ответить на запрос на
корректировку транзакции, полученный от Эмитента, или откорректировать
транзакцию в случае, если Поставщик услуги инициирует корректировку без
запроса.
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receiveTransactionAdjustmentStatusList имеет один входной параметр,
тип данных TransactionAdjustmentList.
Вход сервиса аналогичен receiveTransactionAdjustmentList, за исключением
запроса корректировки, список отправляется от Поставщика услуги Эмитенту.
218
Атрибут
Тип данных
Описание
Timestamp/MsgTS
ДатаВремя
Время отправки сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не
меняется от отправителя к
получателю.
ETSProviderID
Строка
Определяет
Эмитента
(код
страны
+
идентификатор
эмитента), который получает
запрос на корректировку.
TollChargerId
Строка
Определяет Поставщика услуги
(код страны
+ идентификатор
Поставщика услуги), который
направляет
запрос
на
корректировку.
AdjBatchId
Объемный
Идентифицирует
обмененный
список статусов корректировки
по каждому пакету и помогает
идентифицировать
отсутствующие запросы на
корректировку.
Возрастает в конце периода.
219
Атрибут
Тип данных
Описание
AdjBundleNumber
Объемный
Это порядковый номер, который
идентифицирует
каждую
передачу статуса корректировки
под тем же
«AdjBatchId
ª.
Примечание:
Сохранение
значений этого элемента в
последовательности позволяет
Эмитенту
выявить
недостающие передачи от
Поставщика услуги.
Устанавливается на
1, когда
AdjBatchId возрастает.
Предыдущий
Объемный
См.
выше,
позволяет
AdjBundleNumber
обнаруживать
недостающие
сообщения.
TotalAdjQuantity
Целое число
Общее количество корректировок
транзакций.
TotalTrxAmount
Десятичное
Общая сумма транзакций (после
корректировок) до копеек.
TotalAdjTrxAmt
Десятичное
Общая сумма корректировок
(плюс-минус).
AdjustedTransactionStatus
Список
элементов
Список
скорректированных
OBUTransactionType
транзакций,
указанных
(1-xxxx)
Поставщиком услуги.
Элементы OBUTransactionType
указаны в таблице Сервис .1
Выходные параметры
Сервис receiveTransactionAdjustmentStatusList возвращает в результате
одноименный
элемент
receiveTransactionAdjustmentStatusList,
который
инкапсулирует элемент StatusResult типа данных StatusResult, как указано в
предыдущем сервисе (см. раздел .1)
5.3 Сервис: receiveTransactionAdjustmentReconciliationConfirm
220
Этот сервис вызывается от Поставщика услуги или Эмитента с целью
подтверждения сверки корректировки транзакций.
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receiveTransactionAdjustmentReconciliationConfirm имеет один
входной параметр, тип данных TransactionAdjustmentReconciliationConfirm.
Следующая
информация
должна
включаться
в
TransactionAdjustmentReconciliationConfirm:
Атрибут
Тип данных
Описание
Timestamp/MsgTS
ДатаВремя
Время отправки сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не
меняется от отправителя к
получателю
TollChargerId
Строка
Определяет Поставщика услуги
(код страны
+ идентификатор
Поставщика услуги), который
выдает
информацию
подтверждающую
сверку
корректировок транзакций.
ETSProviderID
Строка
Определяет Эмитента
(код
страны
+
идентификатор
Эмитента), который получает
информацию подтверждающую
сверку
корректировок
транзакций.
221
Атрибут
Тип данных
Описание
AdjBatchId
Объемный
Идентифицирует обмениваемый
список
корректировок
транзакций (в сервисе .2) для
каждого пакета и используется
для идентификации возможных
недостающих транзакций.
TotalBundlesQuantityTC
Целое число
Указывает общее количество
групп транзакций, отправленных
в пакете.
Примечание:
Использование
этого элемента позволяет
Эмитенту
обнаруживать
неотправленные
передачи
ПУОП
TotalTrxQuantityTC
Целое число
Общее
количество
корректировок транзакций от
Эмитента,
зафиксированных
Поставщиком услуги.
TotalTrxAmountTC
Десятичное
Общая сумма транзакций от
Эмитента,
зафиксированных
Поставщиком услуги.
TotalAdjTrxAmtTC
Десятичное
Общая сумма корректировок
транзакций от Эмитента (после
корректировок),
зафиксированных Поставщиком
услуги.
TotalDeclinedTrxQuantityTC
Целое число
Общее количество транзакций от
Эмитента, по которым запрос на
корректировку был отклонен
Эмитентом, но которые были
зарегистрированы Поставщиком
услуги.
222
Атрибут
Тип данных
Описание
TotalDeclinedTrxAmountTC
Десятичное
Общая сумма транзакций от
Эмитента, по которым запрос на
корректировку был отклонен
Эмитентом, но которые были
зарегистрированы Поставщиком
услуги.
TotalDeclinedAdjTrxAmtTC
Десятичное
Общая сумма корректировок от
Эмитента
(после
корректировки), по которым
запрос на корректировку был
отклонен
Эмитентом,
но
которые были зарегистрированы
Поставщиком услуги.
ConfirmationStatusTC
Целое число
1 - сбалансированный (как по
количеству, так и сумме)
2 - несбалансированный
Выходные параметры
Веб-сервис ReceiveTransactionAdjustmentReconciliationConfirm возвращает в
результате
одноименный
элемент
receiveTransactionAdjustmentReconciliationConfirmResponse,
который
инкапсулирует элемент StatusResult типа данных StatusResult.
Следующая информация должна включаться в StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см. раздел 8.3
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
223
5.4 Сервис: receiveReconciliationInfo
Этот сервис вызывается от Поставщика услуги для того, чтобы осуществлять
сверку на основе объектов данных обмененных за определенный период времени с
соответствующими Эмитентами.
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receiveReconciliationInfo имеет один входной параметр, тип данных
ReconciliationInfo .
ReconciliationInfo должен содержать следующую информацию:
Атрибут
Тип данных
Описание
Timestamp/MsgTS
ДатаВремя
Время отправки
сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не
меняется от отправителя к
получателю.
TollChargerId
Строка
Определяет Поставщика услуги
(код страны
+ идентификатор
Поставщика услуги), который
выдает транзакцию.
ETSProviderID
Строка
Определяет Эмитента (код страны
+ идентификатор Эмитента),
который получает транзакцию.
TrxBatchId
Объемный
Идентифицирует обмениваемый
список транзакций для каждого
пакета, и используется для
идентификации
наличия
недостающих транзакций.
TotalBundlesQuantity
Целое число
Указывает общее количество
224
Атрибут
Тип данных
Описание
пакетов транзакций, которые
отправляются в пакете.
Примечание: Использование этого
элемента позволяет Эмитенту
определять
неполученные
передачи от Поставщика услуги.
TotalTrxQuantity
Целое число
Общее количество транзакций для
Поставщика услуги
TotalTrxAmount
Десятичное
Общая сумма транзакций для
Поставщика услуги
ConfirmationStatusTC
Целое число
1
- сбалансированный
(как по
количеству, так и сумме)
2 - несбалансированный
Тип данных OBUTranactionType описан в разделе 4.1.
Выходные параметры
Сервис receiveReconciliationInfo возвращает в результате одноименный
элемент receiveReconciliationInfoResponse, который инкапсулирует элемент
StatusResult типа данных StatusResult.
Следующая информация должна быть включена в StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см. раздел 8.3
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
5.5 Сервис: receiveReconciliationConfirm
Данный сервис вызывается от Эмитента по отношению к Поставщику услуги
через ИСМВ с целью подтверждения сверки транзакции.
225
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receiveReconciliationConfirm имеет один входной параметр, тип
данных ReconciliationConfirm.
Следующая информация должна быть включена в ReconciliationConfirm:
Атрибут
Тип данных
Описание
TollChargerId
Строка
Определяет Поставщика услуги (код
страны + идентификатор эмитента),
который отправляет транзакцию
ETSProviderID
Строка
Определяет Эмитента (код страны +
идентификатор Эмитента), который
получает транзакцию
TrxBatchId
Объемный
Идентифицирует
обмениваемый
список транзакций для каждого
пакета
и
используется
для
определения
возможных
недостающих транзакций.
TotalBundlesQuantitySP
Целое число
Указывает общее количество групп
транзакций, которые были получены
в течение дня, как зарегистрировано
Эмитентом.
TotalTrxQuantitySP
Целое число
Общее количество транзакций,
зарегистрированных Эмитентом.
TotalTrxAmountSP
Десятичное
Общая
сумма
транзакций,
зарегистрированных Эмитентом.
226
Атрибут
Тип данных
Описание
ConfirmationStatusSP
Целое число
1
- Сбалансированный
(как по
количеству, так и по сумме)
2 - Несбалансированный
Выходные параметры
Веб-сервис receiveReconciliationConfirm
возвращает в результате
одноименный элемент
receiveReconciliationConfirmResponse,
который
инкапсулирует элемент StatusResult element of StatusResult типа данных.
Следующая информакция должна быть включена в StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
“1”: Успех
nnnn: Номер ошибки
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
В случае каких-либо различий между receiveReconciliationConfirm и
receiveReconciliationInfo необходимо предпринять соответствующие меры для
определения и корректировки проблемы.
6 Требования к интерфейсам по Информации о ПВП
Следующий текст является спецификацией обмена информацией между
Эмитентами и Поставщиками услуги в отношении конфигурации ПВП, через
которые можно осуществить проезд с Интероперабельным ЭСРП.
Следующие спецификации должны, таким образом, рассматриваться как
строгий минимум, подлежащий реализации и являющийся обязательным.
Указанные далее спецификации разработаны на основе реализации веб-
сервиса, так как это считается самым современным принципом реализации.
Однако, любое другое решение, которое обеспечивает аналогичные или лучшие
характеристики, может быть рассмотрено после надлежащей предварительной
227
демонстрации того, что оно точно учитывает все требования при надлежащих
показателях (доступность, надежность и конфиденциальность).
6.1 Сервис: receivePlazaConfiguration
Этот сервис вызывается от Поставщика услуги для того, чтобы предоставить
всем Эмитентам конфигурацию полос и ПВП, с их соответствующими кодами
идентификации, используемыми в контексте межоператорского взаимодействия
(от выдачи транзакции до инвойсирования).
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис receivePlazaConfiguration имеет один входной параметр, тип данных
PlazaConfiguration.
PlazaList должен содержать полную конфигурацию ПВП, на котором
принимаются Интероперабельные ЭСРП, вместе и информацией по ПВП и сети
дорог.
Атрибут
Тип данных
Описание
Timestamp/MsgTS
ДатаВремя
Время
отправки
сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не меняется от
отправителя к получателю
TollChargerId
Строка
Определяет Поставщика услуги
(код
страны
+ идентификатор поставщика
услуги), который выпускает транзакцию.
Plazaconfiguration
Список
Список типов конфигурации ПВП
элементов
Поставщика услуги
228
Атрибут
Тип данных
Описание
PlazaConfigurati
onType ( 1-xxxx
PlazaConfigurationType должна включать минимально требуемую
информацию согласно описанию ниже:
Атрибут
Тип данных
Описание
PlazaID
Строка
Код
ПВП в
формате
“БДДДSSGGККККН”. где “Б” -
первый символ кода Платной
дороги.
“ДДД”
- номер кода
Платной дороги дополненный
нулем слева до трех символов.
Например, формат “ДБББ” для M-
4 будет следующим; М004.
“SS” - Участок Платной дороги, 0
если не используется
“GG” - Номер ПВП
“КККК”
- Километр Платной
дороги, где расположен ПВП. Он
дополняется нулем с левой
стороны
(например;
14 км в
формате
“KKKK” выглядит
следующим образом: 0014). “Н” -
код направления (0 - направление к
0 км, 1 - направление к последнему
км, 2 - для ПВП имеющих полосы
для двух или более направлений).
Для кольцевых дорог
“0” это
направление, где ближе нулевой
километр (он также последний).
Противоположное направление
229
Атрибут
Тип данных
Описание
указывается кодом 1.
Есть один ПВП, который должен
определяться с использованием
данной кодификации для учета
максимального
тарифа
по
участку.
PlazaName
Строка
Обозначение ПВП
PlazaCode
Строка
Код ПВП в формате Cospro
PlazaGroupID
Строка
Код PlazaGroup code в формате
“БДДДSSGGККККН”.
Если PAN StatusColor применяется
индивидуально к ПВП, это поле
будет пустым.
Когда ПВП является частью
группы ПВП, где PAN StatusColor
применяется ко всей группе, код
БДДДSSGGККККН
должен
вставляться.
Например, если StatusColor
ЭСРП применяется ко всей
секции/участку,
все
идентификаторы plazaGroup ID
будут
установлены
на
БДДДSS0000000.
Пример
для
for
M11
участок/секция 1:
M011 01 00 0000 0
TollTzOffset
Строка
+-чч:мм
- разница между
местным временем и временем в
формате UTC
PlazaType
Строка
Открытая система (6)
Закрытая система (7)
Полосы
Список
элемента
Список типов конфигурации полос
230
Атрибут
Тип данных
Описание
LaneConfigurationTyp
Поставщика услуги.
e ( 1-xxxx
LaneConfigurationType
должна включать минимально требуемую
информацию согласно описанию ниже:
Атрибут
Тип данных
Описание
LaneNumber
Целое число
Номер полосы согласно Поставщику
услуги
LaneName
Строка
LaneType
Целое число
Как определено в ISO 14906
ТипСтанции::= ПРОНУМЕРОВАНО {
Не определено
(0),
ЗакрытыйВъездСОплатой
(1),
ЗакрытыйВъездБезОплаты(2),
ЗакрытыйТранзит
(3),
ЗакрытыйВыезд
(4),
ЗакрытыйКредит
5),
смешанный
(6),
проезд открыт выезд
(7),
LaneDirection
Целое число
Направление проезда:
0 по направлению к 0 километру
1 по направлению к последнему
километру
2 другое
Выходные параметры
Сервис receivePlazaConfiguration возвращает в результате одноименный
элемент receivePlazaConfigurationResponse, который инкапсулирует элемент
StatusResult element типа данных StatusResult.
231
Следующая информация должна быть включена в рамках StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см. раздел 8.3
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
232
7 Требования к интерфейсам для передачи Интересующей транзакции
Следующий текст является спецификацией запроса, который делается
Эмитентом в отношении Поставщика услуги для получения видео и фото
материалов, записанных Поставщиком услуги на своей полосе проезда,
привязанных к конкретной Интересующей транзакции.
Следующие спецификации должны, таким образом, рассматриваться как
строгий минимум, подлежащий реализации и являющийся обязательным.
Указанные далее спецификации разработаны на основе реализации веб-
сервиса, так как это считается самым современным принципом реализации.
Однако, любое другое решение, которое обеспечивает аналогичные или лучшие
характеристики, может быть рассмотрено после надлежащей предварительной
демонстрации того, что оно точно учитывает все требования при надлежащих
показателях (доступность, надежность и конфиденциальность).
7.1 Сервис: requestTransactionofInterestInfo
Данный сервис вызывается от Эмитента по отношению к Поставщику услуги
для целей получения от последнего дополнительной информации (в основном в
виде видео и фото материалов), привязанной к транзакции, которую Эмитенту
необходимо дополнительно проанализировать. Интересующие транзакции
определяются их последней идентификацией номера, включая возможную другую
информацию.
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис recquestTransactionofInterestInfo имеет один входной параметр, тип
данных TransactionofInterest.
Атрибут
Тип
Описание
233
Атрибут
Тип
Описание
Timestamp/MsgTS
ДатаВремя
Время
отправки
сообщения
отправителем.
(Формат UTC)
Данный атрибут никогда не меняется от
отправителя к получателю
ETSProviderId
Строка
Определяет Эмитента
(код страны
+
идентификатор Эмитента), который
выпускает транзакцию
ETSProviderId
Строка
Определяет Эмитента
(код страны
+
идентификатор Эмитента), который
выпускает транзакцию
TollChargerId
Строка
Определяет Поставщика услуги
(код
страны
+ идентификатор Поставщика
услуги), который выпускает транзакцию
TrxofIBatchId
Объемный
Идентифицирует обмениваемый список
Интересующих транзакций по каждому
пакету
и
помогает
определить
недостающую информацию.
TrxofIBundleNumber
Объемный
Это порядковый номер, который
идентифицирует
каждую передачу
запроса по Интересующей транзакции
под тем же “TrxofIBatchId”.
Примечание: Сохранение этих значений
этого элемента в последовательном
порядке позволяет получающей Стороне
определять недостающие передачи
данных от оправляющей Стороны
TransactionID
Объемный
Идентификация транзакции, по которой
Эмитент запрашивает информацию.
Идентификатор транзакции - это первый
идентификатор,
прилагаемый
к
транзакции, даже если она еще
проверяется, отклонена или принята
234
Атрибут
Тип
Описание
VehicleID
Строка
Особая идентификация от Поставщика
услуги, при присутствии
PAN
Таблица
Специальные значения и описание
Кодификация
атрибута даны в таблице Кодификация
ЭСРП
ЭСРП, идентификатор атрибута 32
Ноль при отсутствии
DateTimeExit
ДатаВремя
Дата/время Транзакции (Выезд)
Ноль при отсутствии
ChargePointIdExit
Целое число
Идентификационный номер
ПВП,
Услуги организации проезда
Ноль при отсутствии
LaneIdExit
Целое число
Идентификатор полосы сбора платы (0-
xxxx)
Ноль при отсутствии
TrxRequest indo
Целое число
0: фото(s)
1: Видео
2: Другое - определить.
TrxofInterestDescription
Строка
Пояснение, данное Эмитентом на запрос
информации
TrxofInterestStatus
Строка
Статус обработки запроса:
Открытый, закрытый
Выходные параметры
Сервис recquestTransactionofInterestInfo
возвращает в результате
одноименный элемент recquestTransactionofInterestInfo, который инкапсулирует
элемент StatusResult типа данных StatusResult.
Следующая информация должна быть включена в StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
235
Атрибут
Тип данных
Описание
nnnn: Номер ошибки см. раздел 8.3
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
7.2 Service: responseTransactionofInterestInfo
Если данный сервис реализуется через ИСМВ.
Данный сервис вызывается от Поставщика услуги по отношению к Эмитенту
для отправки последним справочной информации (главным образом в форме фото
и видео записей), относящейся к транзакции, которую необходимо дополнительно
определить. Интересующие транзакции определяются по их последнему
номерному идентификатору, включая возможную другую информацию.
Следующий текст включает входные и выходные параметры и определяет
некоторые подробные типы атрибутов, которые должны использоваться в рамках
ИСМВ.
Входные параметры
Сервис responseTransactionofInterestInfo имеет один входной параметр, тип
данных TransactionofInterest.
Атрибут
Тип
Описание
Timestamp/MsgTS
ДатаВремя
Время отправки сообщения отправителем.
(Формат UTC)
Данный атрибут никогда не меняется от
отправителя к получателю
ETSProviderId
Строка
Определяет Эмитента
(код страны
+
идентификатор Эмитента), который
выпускает транзакцию
TollChargerId
Строка
Определяет Поставщика услуги
(код
страны
+ идентификатор Поставщика
услуги), который выпускает транзакцию
236
Атрибут
Тип
Описание
TrxofIBatchId
Объемный
Идентифицирует обмениваемый список
Интересующих транзакций по каждому
пакету
и
помогает
определить
недостающую информацию.
TrxofIBundleNumber
Объемный
Это порядковый номер, который
идентифицирует
каждую передачу
запроса по Интересующей транзакции под
тем же “TrxofIBatchId”.
Примечание: Сохранение этих значений
этого элемента в последовательном
порядке позволяет получающей Стороне
определять недостающие передачи
данных от оправляющей Стороны
TransactionID
Объемный
Идентификация транзакции, по которой
Эмитент запрашивает информацию.
Идентификатор транзакции - это первый
идентификатор,
прилагаемый
к
транзакции, даже если она еще
проверяется, отклонена или принята
VehicleID
Строка
Особая идентификация от Поставщика
услуги, при наличии
PAN
Таблица
Специальные значения и описание
Кодификации
атрибута даны в таблице Кодификация
ЭСРП
ЭСРП, идентификатор атрибута 32
Ноль при отсутствии
DateTimeExit
ДатаВремя
Дата/время Транзакции
Ноль при отсутствии
ChargePointIdExit
Целое число
Идентификационный номер ПВП, Услуги
организации проезда
Ноль при отсутствии
LaneIdExit
Целое число
Идентификатор полосы сбора платы (0-
xxxx)
Ноль при отсутствии
237
Атрибут
Тип
Описание
TrxofInterestDescription
Строка
Пояснение, данное Эмитентом на запрос
информации
TrxofInterestStatus
Строка
Статус обработки запроса:
Открытый, закрытый
Photo(s)
JPEG передаваемый в base64 (максимум 3
фотографии)
Video
Строка
URL: адрес, с которого может быть
загружено видео
Выходные параметры
Сервис ResponseTransactionofInterestInfo возвращает в результате
одноименный элемент recquestTransactionofInterestInfo, который инкапсулирует
элемент StatusResult типа данных StatusResult.
Следующая информация должна быть включена в рамках StatusResult:
Атрибут
Тип данных
Описание
ResultCode
Целое число
Код результата состояния:
«1ª: Успех
nnnn: Номер ошибки см. раздел 8.3
ResultDescription
Строка
Описание кода результата. Может
содержать
более
подробное
объяснение ошибки (при наличии)
8 Требования к интерфейсам: особые правила и детали
В настоящем разделе подробно представлены некоторые конкретные
правила, которые должны применяться в контексте ИСМВ, включая некоторые
определения параметров и планирование.
8.1 Определение параметра
Обмен сообщениями между объектами межоператорского взаимодействия
происходит методом REST с использованием формата JSO поверх HTTPS.
Все сообщения передаются в кодировке UTF-8.
238
Для ускорения передачи, данные могут быть сжаты/распакованы через
ИСМВ..
8.2 Требования к обеспечению безопасности
Для обеспечения безопасности каждому объекту интеграционного
взаимодействия должны присваиваться идентификатор и секретный ключ, которые
используются для подписи передаваемых данных. Секретный ключ представляет
собой строку из не менее чем 32-х случайных символов.
Все сообщения системы передаются в зашифрованном по протоколу HTTPS,
и подписаны SHA3- 12 для аутентификации отправителя.
Сообщения имеют двухуровневую структуру. Первый уровень содержит
информацию, необходимую для аутентификации
- идентификатор Стороны,
подпись сообщения в формате SHA3- 12 в шестнадцатиричном
(hex)
представлении и защищённое подписью тело сообщения, представленное как
объект json, сериализованный в строку.
8.3Требования к обработке ошибок
При возникновении ошибки отправитель должен повторять отправку
сообщения.
В таблице ниже содержится описание кодов и сообщений об ошибках,
которые отправляются от получателя (Поставщика услуги или Эмитента) в адрес
отправителя (Поставщика услуги или Эмитента):
Данная таблица может быть дополнена другими кодами ошибок.
Коды и сообщения об ошибках
Код
Текст ошибки
Описание ошибки
128
Failed to save payment %s from plaza %d
Ошибка сохранения платежа. %s —
идентификатор платежа,
%d
—
plaza_id
129
Failed to save photo %s from plaza %d
Ошибка сохранения фотографии. %s
— идентификатор платежа,
%d —
plaza_id
130
Bad photo format %s from plaza %d
Ошибка чтения формата фото (base64).
239
содержание .. 4 5 6 7 ..
|
|