Услуга "Предоставление сведений из базы данных обременений автотранспортных средств" (приложение к договору об оказании информационных (сопутствующих) услуг)
Приложение 11 к Договору об оказании информационных услуг
УСЛУГА "Предоставление сведений из базы данных обременений автотранспортных средств"
Услуга, оказываемая Исполнителем (НБКИ), заключается в предоставлении сведений из базы данных НБКИ об обременениях автотранспортных средств.
1. Порядок передачи информации
1.1. Вся информация направляется в форме электронных документов.
1.2. Для начала работы с услугой Заказчик обязан:
1) выполнить все действия, предусмотренные п. 3.6 Договора;
2) получить доступ к услуге, согласовав с менеджером НБКИ имя пользователя и сертификат, с которыми будут осуществляться запросы;
3) разработать программу, поддерживающую следующий функционал:
a) формирование xml-запросов в формате, приведенном ниже, с постановкой ЭЦП в формате PKCS7 и последующим кодированием алгоритмом Base64;
b) установление соединения по протоколу HTTPS и размещение запроса методом POST.
Пример:
POST /<Адрес сервера> HTTP/1.0
User-Agent: HTTPToo1/1.0
<Запрос>
c) получение ответа, декодирование Base64 с последующим снятием и проверкой ЭЦП в формате PKCS7;
d) анализ XML-ответа, получаемого в формате, приведенном ниже.
Примечания.
1. Взаимодействие в рамках данного сервиса происходит в онлайновом синхронном режиме. В одном запросе должны содержаться данные по одному транспортному средству.
2. Шифрование при обмене данными происходит по протоколу TLS с использованием серверного сертификата ("icrs.nbki.ru").
Для постановки подписи на запросе необходимо использовать личный сертификат, согласованный в соответствии с п. 2.
3. Для снятия подписи используйте сертификат НБКИ ("СГКО НБКИ - 2010").
Сами сертификаты и указание года выпуска в названии сертификата меняются раз в год в соответствии с регламентом УЦ. Сертификат СГКО НБКИ можно получить у своего менеджера НБКИ. Собственный ключ должен быть сформирован в ходе выполнения п. 1 данной инструкции.
4. Начать получение данных по адресу https://icrs.nbki.ru/collatauto.
Примечание. Для целей отладки можно воспользоваться эмулятором сервиса, доступным по адресу http://collatauto.demo.nbki.ru:8080/CollatAuto/collatauto. Для входа необходимо получить имя пользователя и пароль, отправив форму N 6-П. При запросе необходимо использовать тестовый сертификат (выдан: "Иванов Петр Сидорович", серийный номер: 66 f4 99 a7 00 02 00 01 47 71), который можно получить у своего менеджера НБКИ.
2. Форматы запросов и ответов
2.1. Описание элементов запроса в формате xml (кодировка Win-1251)
--------------------------------------------------------------------------- ¦ Элемент ¦ Описание ¦ Длина ¦ Обязательность ¦ Комментарий ¦ +----------+------------+-------+-----------------+-----------------------+ ¦ Id ¦Номер ¦ 64 ¦ Необязательно ¦Произвольный ¦ ¦ ¦запроса ¦ ¦ ¦идентификатор запроса, ¦ ¦ ¦ ¦ ¦ ¦который может быть ¦ ¦ ¦ ¦ ¦ ¦использован позднее ¦ ¦ ¦ ¦ ¦ ¦для соотнесения с ¦ ¦ ¦ ¦ ¦ ¦ответом ¦ +----------+------------+-------+-----------------+-----------------------+ ¦ TypeCode ¦Код типа ¦ 2 ¦ Обязательно ¦Всегда = 1 для этого ¦ ¦ ¦запроса ¦ ¦ ¦типа запроса ¦ +----------+------------+-------+-----------------+-----------------------+ ¦ Member ¦Код ¦ 12 ¦ Обязательно ¦Код участника, ¦ ¦ Code ¦участника ¦ ¦ ¦предоставленный НБКИ ¦ ¦ ¦ ¦ ¦ ¦для получения ¦ ¦ ¦ ¦ ¦ ¦кредитных отчетов ¦ +----------+------------+-------+-----------------+-----------------------+ ¦User ¦Имя ¦ 12 ¦Обязательно ¦Имя пользователя, ¦ ¦ ¦пользователя¦ ¦ ¦предоставленное НБКИ ¦ ¦ ¦ ¦ ¦ ¦для получения ¦ ¦ ¦ ¦ ¦ ¦кредитных отчетов ¦ +----------+------------+-------+-----------------+-----------------------+ ¦Password ¦Пароль ¦ 8 ¦Обязательно ¦Пароль, ¦ ¦ ¦ ¦ ¦ ¦предоставленный НБКИ ¦ ¦ ¦ ¦ ¦ ¦для получения ¦ ¦ ¦ ¦ ¦ ¦кредитных отчетов ¦ +----------+------------+-------+-----------------+-----------------------+ ¦VIN ¦VIN-код ¦ 17 ¦Обязательно для ¦VIN-код проверяемого ¦ ¦ ¦ ¦ ¦транспортных ¦транспортного средства ¦ ¦ ¦ ¦ ¦средств, имеющих ¦(только латиница) ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +----------+------------+-------+-----------------+-----------------------+ ¦DocNum ¦Серия и ¦ 20 ¦Обязательно для ¦Серия и номер паспорта ¦ ¦ ¦номер ПТС ¦ ¦транспортных ¦транспортного ¦ ¦ ¦ ¦ ¦средств, не ¦средства. Только ¦ ¦ ¦ ¦ ¦имеющих VIN-код. ¦латиница ¦ ¦ ¦ ¦ ¦Допустимо ¦ ¦ ¦ ¦ ¦ ¦для транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +----------+------------+-------+-----------------+-----------------------+ ¦Engine ¦Номер ¦ 30 ¦Обязательно для ¦Номер двигателя ¦ ¦ ¦двигателя ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +----------+------------+-------+-----------------+-----------------------+ ¦Chassis ¦Номер шасси ¦ 30 ¦Обязательно для ¦Номер шасси (рамы) ¦ ¦ ¦(рамы) ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +----------+------------+-------+-----------------+-----------------------+ ¦Body ¦Номер кузова¦ 30 ¦Обязательно для ¦Номер кузова (коляски) ¦ ¦ ¦(коляски) ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ -----------+------------+-------+-----------------+------------------------
Пример запроса:
<?xml version="1.0" encoding="windows-1251"?> <CollatAuto> <Request> <Id>1234567890-ABCDEFGH</Id> <TypeCode>1</TypeCode> <Auth> <MemberCode>0001ZZ000000</MemberCode> <User>0001ZZ000002</User> <Password>Password</Password> </Auth> <Contents> <VIN>WBA12345678901234</VIN> <DocNum>11TC111111</DocNum> </Contents> </Request> </CollatAuto>
2.2. XSD-схема запроса
<?xml version="1.0" encoding="windows-1251"?>
<xs:schema attributeFormDefault="unqualified"elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="CollatAuto" type="CollatAutoType"/>
<xs:complexType name="CollatAutoType">
<xs:sequence>
<xs:element type="RequestType" name="Request"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="RequestType">
<xs:sequence>
<xs:element type="xs:string" name="Id" minOccurs="0"/>
<xs:element type="xs:decimal" name="TypeCode"/>
<xs:element type="AuthType" name="Auth"/>
<xs:element type="ContentsType" name="Contents"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AuthType">
<xs:sequence>
<xs:element type="xs:string" name="MemberCode"/>
<xs:element type="xs:string" name="User"/>
<xs:element type="xs:string" name="Password"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ContentsType">
<xs:sequence>
<xs:element type="xs:string" name="VIN" minOccurs="0"/>
<xs:element type="xs:string" name="DocNum" minOccurs="0"/>
<xs:element type="xs:string" name="Engine" minOccurs="0"/>
<xs:element type="xs:string" name="Chassis" minOccurs="0"/>
<xs:element type="xs:string" name="Body" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
2.3. Описание элементов ответа в формате xml (кодировка Win-1251)
------------------------------------------------------------------------- ¦ Элемент ¦ Описание ¦ Длина ¦ Обязательность ¦ Комментарий ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Request ¦Раздел ¦ ¦Обязательно ¦ ¦ ¦ ¦цитирования ¦ ¦ ¦ ¦ ¦ ¦запроса ¦ ¦ ¦ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Response ¦Раздел ¦ ¦Обязательно ¦ ¦ ¦ ¦ответа ¦ ¦ ¦ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Result ¦Результат ¦ 1 ¦Обязательно ¦0 - информация не¦ ¦ ¦поиска ¦ ¦ ¦обнаружена ¦ ¦ ¦ ¦ ¦ ¦1 - получен ¦ ¦ ¦ ¦ ¦ ¦результативный ¦ ¦ ¦ ¦ ¦ ¦ответ ¦ ¦ ¦ ¦ ¦ ¦2 - при обработке¦ ¦ ¦ ¦ ¦ ¦запроса произошла¦ ¦ ¦ ¦ ¦ ¦ошибка ¦ +-----------+------------+--------+-----------------+-------------------+ ¦VIN ¦VIN-код ¦ 17 ¦Хотя бы одно из ¦VIN-код найденного ¦ ¦ ¦ ¦ ¦полей заполнено ¦транспортного ¦ ¦ ¦ ¦ ¦ ¦средства ¦ +-----------+------------+--------+-----------------+-------------------+ ¦DocNum ¦Серия и ¦ 20 ¦ ¦Серия и номер ¦ ¦ ¦номер ПТС ¦ ¦ ¦паспорта ¦ ¦ ¦ ¦ ¦ ¦транспортного ¦ ¦ ¦ ¦ ¦ ¦средства ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Engine ¦Номер ¦ 30 ¦Обязательно для ¦Номер двигателя ¦ ¦ ¦двигателя ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Chassis ¦Номер ¦ 30 ¦Обязательно для ¦Номер шасси (рамы) ¦ ¦ ¦шасси ¦ ¦транспортных ¦ ¦ ¦ ¦(рамы) ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Body ¦Номер ¦ 30 ¦Обязательно для ¦Номер кузова ¦ ¦ ¦кузова ¦ ¦транспортных ¦(коляски) ¦ ¦ ¦(коляски) ¦ ¦средств, не ¦ ¦ ¦ ¦ ¦ ¦имеющих VIN-код, ¦ ¦ ¦ ¦ ¦ ¦если имеется. ¦ ¦ ¦ ¦ ¦ ¦Допустимо для ¦ ¦ ¦ ¦ ¦ ¦транспортных ¦ ¦ ¦ ¦ ¦ ¦средств, имеющих ¦ ¦ ¦ ¦ ¦ ¦VIN-код ¦ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Model ¦Марка/модель¦ 100 ¦Обязательно ¦Марка и модель ¦ ¦ ¦ ¦ ¦ ¦транспортного ¦ ¦ ¦ ¦ ¦ ¦средства ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Manuf ¦Год выпуска ¦ 4 ¦Обязательно ¦Год выпуска ТС в ¦ ¦Year ¦ ¦ ¦ ¦формате ГГГГ ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Colour ¦Цвет ¦ ¦Не обязательно ¦Цвет ТС ¦ +-----------+------------+--------+-----------------+-------------------+ ¦DateTo ¦Дата ¦ 10 ¦Обязательно ¦Дата окончания ¦ ¦ ¦окончания ¦ ¦ ¦залога по ¦ ¦ ¦залога ¦ ¦ ¦автомобилю в ¦ ¦ ¦ ¦ ¦ ¦формате ГГГГ-ММ-ДД ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Comment ¦Комментарий ¦ 256 ¦Не обязательно ¦Произвольно ¦ +-----------+------------+--------+-----------------+-------------------+ ¦Error ¦Код ошибки ¦ 3 ¦Не обязательно ¦См. список кодов ¦ ¦Code ¦ ¦ ¦ ¦ошибок и их ¦ ¦ ¦ ¦ ¦ ¦расшифровку ниже ¦ +-----------+------------+--------+-----------------+-------------------+ ¦ErrorText ¦Текст ¦ 1024 ¦Не обязательно ¦См. список кодов ¦ ¦ ¦ошибки ¦ ¦ ¦ошибок и их ¦ ¦ ¦ ¦ ¦ ¦расшифровку ниже ¦ ------------+------------+--------+-----------------+--------------------
Список кодов ошибок и их расшифровка
-------------------------------------------------------------------------- ¦ Код ¦ Расшифровка ¦ +-----------+------------------------------------------------------------+ ¦ 1 ¦Ошибка декодирования файла ¦ +-----------+------------------------------------------------------------+ ¦ 3 ¦Неверное имя или пароль пользователя ¦ +-----------+------------------------------------------------------------+ ¦ 5 ¦Не найден указанный Код участника ¦ +-----------+------------------------------------------------------------+ ¦ 6 ¦Не найден номер сертификата для данного пользователя ¦ +-----------+------------------------------------------------------------+ ¦ 8 ¦Неверный тип кода запроса ¦ +-----------+------------------------------------------------------------+ ¦ 9 ¦В запросе не указан ни VIN-код, ни ПТС ¦ +-----------+------------------------------------------------------------+ ¦ 10 ¦Неверный формат VIN-кода ¦ +-----------+------------------------------------------------------------+ ¦ 11 ¦Неверный формат ПТС ¦ +-----------+------------------------------------------------------------+ ¦ 12 ¦Слишком длинный номер двигателя ¦ +-----------+------------------------------------------------------------+ ¦ 13 ¦Слишком длинный номер шасси ¦ +-----------+------------------------------------------------------------+ ¦ 14 ¦Слишком длинный номер кузова ¦ +-----------+------------------------------------------------------------+ ¦ 17 ¦Ошибка обработки запроса. Обратитесь к оператору НБКИ: ¦ ¦ ¦<системное сообщение> ¦ +-----------+------------------------------------------------------------+ ¦ 19 ¦Размер POST контента слишком большой ¦ +-----------+------------------------------------------------------------+ ¦ 20 ¦Ошибка получения запроса из POST контента ¦ +-----------+------------------------------------------------------------+ ¦ 21 ¦Пустой POST контент ¦ +-----------+------------------------------------------------------------+ ¦ 22 ¦Ошибка разбора PKCS#7 сообщения ¦ +-----------+------------------------------------------------------------+ ¦ 25 ¦Неизвестная ошибка проверки подписи ¦ +-----------+------------------------------------------------------------+ ¦ 26 ¦Ошибка обработки запроса. Обратитесь к оператору НБКИ: ¦ ¦ ¦<системное сообщение> ¦ +-----------+------------------------------------------------------------+ ¦ 27 ¦Ошибка обработки запроса. Обратитесь к оператору НБКИ: ¦ ¦ ¦<системное сообщение> ¦ +-----------+------------------------------------------------------------+ ¦ 29 ¦Ошибка обработки запроса. Обратитесь к оператору НБКИ: ¦ ¦ ¦<системное сообщение> ¦ +-----------+------------------------------------------------------------+ ¦ 30 ¦Ошибка обработки запроса. Обратитесь к оператору НБКИ: ¦ ¦ ¦<системное сообщение> ¦ +-----------+------------------------------------------------------------+ ¦ 31 ¦Метод GET недопустим в данном контексте ¦ ------------+-------------------------------------------------------------
Пример ответа:
<?xml version="1.0" encoding="windows-1251"?> <CollatAuto> <Request> <Id>1234567890-ABCDEFGH</Id> <TypeCode>1</TypeCode> <Auth> <MemberCode>0001ZZ000000</MemberCode> <User>0001ZZ000001</User> </Auth> <Contents> <VIN>WBA12345678901234</VIN> <DocNum>11TC111111</DocNum> </Contents> </Request> <Result>1</Result> <Response> <VIN>WBA12345678901234</VIN> <Model>BMW 757</Model> <DateTo>2006-09-01</DateTo> </Response> <Response> <VIN>WBA12345678901234</VIN> <DocNum>11TC111111</DocNum> <Model>BMW 757</Model> <DateTo>2015-09-01</DateTo> </Response> </CollatAuto>
2.4. XSD-схема ответа
<?xml version="1.0" encoding="windows-1251"?>
<xs:schema attributeFormDefault="unqualified"elementFormDefault="qualified"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="CollatAuto" type="CollatAutoType"/>
<xs:complexType name="CollatAutoType">
<xs:sequence>
<xs:element type="RequestType" name="Request" minOccurs="0"/>
<xs:element type="ResponseType" name="Response" minOccurs="0" maxOccurs="unbounded"/>
<xs:element type="xs:string" name="ErrorCode" minOccurs="0"/>
<xs:element type="xs:string" name="ErrorText" minOccurs="0"/>
<xs:element type="xs:int" name="Result"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="RequestType">
<xs:sequence>
<xs:element type="xs:string" name="Id" minOccurs="0"/>
<xs:element type="xs:string" name="TypeCode"/>
<xs:element type="AuthType" name="Auth"/>
<xs:element type="ContentsType" name="Contents"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="AuthType">
<xs:sequence>
<xs:element type="xs:string" name="MemberCode"/>
<xs:element type="xs:string" name="User"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ContentsType">
<xs:sequence>
<xs:element type="xs:string" name="VIN" minOccurs="0"/>
<xs:element type="xs:string" name="DocNum" minOccurs="0"/>
<xs:element type="xs:string" name="Engine" minOccurs="0"/>
<xs:element type="xs:string" name="Chassis" minOccurs="0"/>
<xs:element type="xs:string" name="Body" minOccurs="0"/>
</xs:sequence>
</xs:complexType>
<xs:complexType name="ResponseType">
<xs:sequence>
<xs:element type="xs:string" name="VIN" minOccurs="0"/>
<xs:element type="xs:string" name="DocNum" minOccurs="0"/>
<xs:element type="xs:string" name="Engine" minOccurs="0"/>
<xs:element type="xs:string" name="Chassis" minOccurs="0"/>
<xs:element type="xs:string" name="Body" minOccurs="0"/>
<xs:element type="xs:string" name="Model"/>
<xs:element type="xs:string" name="ManufYear"/>
<xs:element type="xs:string" name="Colour" minOccurs="0"/>
<xs:element type="xs:string" name="Comment" minOccurs="0"/>
<xs:element type="xs:string" name="DateTo"/>
</xs:sequence>
</xs:complexType>
</xs:schema>
2.5. Алгоритмы поиска информации в БД залоговых транспортных средств.
1. Если VIN запроса = VIN базы -> найден.
2. Если VIN запроса = VIN базы без одного символа ->.
Если DocNum запроса = DocNum базы -> найден.
Если DocNum запроса 
DocNum базы ->.
Если Engine, Chassis, Body запроса = Engine, Chassis, Body базы -> найден.
3. Если VIN запроса не указан ->.
Если DocNum запроса = DocNum базы -> найден.
Если DocNum запроса 
DocNum базы ->.
Если Engine, Chassis, Body запроса = Engine, Chassis, Body базы -> найден.
3. Стоимость услуги
Стоимость обработки каждого запроса в базу данных НБКИ, вне зависимости от результата обработки, составляет 300 рублей плюс НДС 18%.
4. Особые условия
Для начала работы в рамках настоящего приложения условие п. 3.6 Договора в части предварительного заключения Договора об оказании информационных услуг (предоставлении кредитных отчетов) не является обязательным.
Источник - "Научно-практический комментарий к Федеральному закону "О кредитных историях" (постатейный), "Норма", "Инфра-М"
- Услуга "Выборка сведений" (приложение к договору об оказании информационных (сопутствующих) услуг)
- Упрощенная форма договора о предоставлении торговых мест на сельскохозяйственном рынке, сельскохозяйственном кооперативном рынке, а также гражданам, ведущим крестьянские (фермерские) хозяйства, личные подсобные хозяйства или занимающимся садоводством, огородничеством, животноводством, на универсальном рынке города Москвы
- Унифицированная (рекомендуемая) форма трудового договора о дистанционной работе
- Унифицированная форма трудового договора
- Учредительный договор коллегии адвокатов
