Формат передачи данных в Закрытое акционерное общество «Северо-Западное Бюро Кредитных Историй»
(ЗАО «СЗБКИ».
Версия 1.2
Санкт-Петербург2012 г.
Оглавление
Оглавление 2
1.Общие положения 3
2.Содержимое файла 6
3. Описание типов данных 7
4. Описание формата записей 8
5.Форматы файлов 23
Приложение 1 DTD-схема формата уведомления о приеме данных 28
Приложение 2 Пример уведомления о приеме данных 29
Приложение 3 Словарь типов валют 30
Приложение 4 Словарь типов документов 30
Приложение 5 Словарь периодичности выплат 30
Приложение 6 Блок-схемы текстовых файлов 31
Приложение 7 Примеры текстовых файлов 46
Приложение 8 DTD-схема для XML-формата 1 48
Приложение 9 Примеры файлов в XML-формате 1 52
Приложение 10 DTD-схема для XML-формата 2 55
Приложение 11 Примеры файлов в XML-формате 2 58
Общие положения
Данные о кредитных историях формируются на основании информации полученной от источника формирования кредитной истории (далее – ИСТОЧНИКА). Полнота, актуальность и детализация кредитных историй и кредитных отчетов полностью зависят от того, насколько полно и своевременно передается информация о кредитных договорах в бюро кредитных историй. ЗАО «СЗБКИ» (далее – СЗБКИ) рекомендует своим клиентам производить выгрузку информации по кредитным историям ежедневно.
Данные о кредитных историях направляются в СЗБКИ по электронной почте. Файл или почтовое сообщение должны быть подписаны электронной подписью банка и зашифрованы на сертификат бюро. Тема сообщения при передаче данных в СЗБКИ должна быть "Кредитная история", иначе Ваше сообщение может быть удалено как SPAM.*.
Подготовленный для бюро файл состоит из заголовка и последующей совокупности записей, содержащих информацию о кредитных историях. Каждая запись в файле складывается из одного или нескольких полей, среди которых выделяются ключевые поля, позволяющие однозначно определить запись.Характер поступающих данных определяется в заголовке файла по признаку действия - insert или update. Соответственно, вся поступающая информация может дополнять – insert или корректировать – update ранее полученные данные.
Файл с корректировками с признаком update направляется только при обнаружении ошибок в ранее направленных данных для их исправления.
В случае, если изменения касаются не ключевых полей, то данные изменения можно передавать в файле insert, при этом ранее полученные данные будут заменены на новые.
В случае возникновения изменений в ранее направленных данных необходимо формировать файл для добавления информации с признаком insert. Так,
- новые данные о договоре после изменения его условий (за исключением изменения номера договора);
- новые данные о физическом лице при смене им установочных данных;
- новые данные о фирме после ее реорганизации;
- данные о новом документе физического лица после замены старого;
- данные о новом адресе;
- и т.п.
должны приходить в файле для добавления информации с признаком insert.
Не будет являться ошибкой, если в файле добавления запись направляется повторно.
Каждому клиенту в системе СЗБКИ присваивается четырехзначный идентификатор клиента – ИД клиента. Имя файла с кредитными историями, направляемого в адрес СЗБКИ должно иметь следующий вид: ####_[PP_]NNNNNN.EXT, где
#### - ИД клиента;
PP - номер оператора (если не указан, то считается что оператор 00);
NNNNNN - порядковый номер сообщения;
EXT – расширение файла. Может принимать следующие значения:
txt - для текстового формата;
crt - для зашифрованного и подписанного файла в текстовом формате
xml - для любого xml-формата;
crx - для зашифрованного и подписанного файла в xml-формате
Данные принимаются файлах с номерами больше нуля. Начинать следует с 1. При направлении в СЗБКИ тестовых сообщений номер сообщения должен быть 000000.
Порядковый номер файла введен для того, чтобы в любой момент времени была возможность подтвердить, что ВСЕ (по порядку) удовлетворяющие формату файлы были приняты и обработаны.
В каждом новом календарном году вне зависимости от номера последнего успешно обработанного файла можно направлять очередной файл на обработку с номером 1.
По результатам обработки файла ИСТОЧНИКУ направляется уведомление об обработке. Формат уведомления приведен в Приложение 1.
Под ошибкой подразумевается любое несоответствие требованиям к полям или структуре записи, установленным настоящим Форматом.
Данные могут быть отвергнуты, если в процессе их обработки обнаруживается ошибка (ERROR). Данные, содержащие ошибку, не принимаются для хранения системой; в таком случае ИСТОЧНИКУ отсылаются сообщение об ошибочной обработке этой записи для исправления и повторного представления в бюро.
В случае если ИСТОЧНИК получает предупреждение о возможной ошибке (WARNING) следует понимать, что запись принята в СЗБКИ, но она может содержать некорректные данные, которые необходимо проконтролировать, при необходимости исправить и отправить в СЗБКИ новый файл с соответствующими исправлениями.
Файл может быть принят полностью, принят частично или не принят полностью.
Если файл принят полностью или частично, то на адрес отправителя высылается уведомление об обработке и ожидается файл со следующим порядковым номером.
При полном или частичном приеме файла уведомление в виде сообщения или файла шифруется и подписывается.
Файл
не принимается полностью по следующим причинам:
-
невозможно расшифровать или проверить подпись файла или почтового сообщения — уведомление об ошибке в этом случае не подписывается и не шифруется;
-
произошла ошибка в порядковом номере файла — уведомление об ошибке только шифруется
-
невозможно обработать файл *.txt или *.xml файл не соответствует DTD схеме — уведомление об ошибке только шифруется;
-
в файле нет ни одной корректной полностью или частично записи — уведомление об ошибке только шифруется.
Если файл
не принят полностью, то в этом случае необходимо исправить ошибочные данные, заново сформировать файл с
тем же порядковым номером, подписать, зашифровать и отправить в СЗБКИ.
До тех пор пока текущий файл не будет обработан, все последующие файлы в обработку не принимаются.
Если СЗБКИ получен файл, номер которого отличается от номера файла ожидаемого на обработку, то в адрес отправителя направляется сообщение о том, что переданный файл НЕ принят и указан номер файла, который ожидается для обработки. Такая ситуация может возникнуть по следующим причинам:
1) файл или файлы переданы, но не получены СЗБКИ по причине технического сбоя. В этом случае необходимо передать повторно файл и ВСЕ файлы с последующими номерами.
2) произошла ошибка в порядковом номере файла. В этой ситуации необходимо переименовать файлы, исправив номер, и передать переименованые файлы повторно;
3) файл с предыдущим номером НЕ принят полностью.
При передаче большого объема информации данные перед отправкой можно заархивировать с помощью zip, 7zip, rar, arj. Архивный файл должен быть подписан и зашифрован. После архивации, подписания и шифрации файла, направляемого в СЗБКИ, расширение полученного файла должно быть изменено на txt или xml, если подписано и зашифровано сообщение и crt или crx, при подписи шифрации самого файла.
Важно помнить следующее:
-
Заголовок файла обязателен для каждого файла и определяется в его начале;
-
Файлы обрабатываются последовательно по записям. При этом проверяется целостность информации. Однотипные записи, касающиеся различных договоров, могут быть выгружены последовательно. Например, сначала выгружаются титульные части всех договоров, потом все записи о заемщиках по данным договорам и т.д. Т.е. для конкретного договора титульная часть информации должна предшествовать любой другой информации о договоре;
-
При выгрузке данных о новых договорах обязательные записи информации должны присутствовать в одном файле;
-
При исправлении/добавлении информации передается только измененная или добавленная запись, при этом другие записи, касающиеся данного договора передавать не нужно, предполагается, что обязательные записи информации были переданы ранее. Например, при поступлении информации о новом документе физического лица, можно выгрузить запись только об этом документе, тогда как записи с титульной частью договора и данными о физическом лице должны быть переданы ранее;
-
В титульной части в поле “Сумма обязательств по договору” указывается реально выданная на указанную дату сумма. В случае выдачи кредита частями (овердрафт, транш и т.п.) необходимо в титульной части установить значение «истина» для флага «Выдача кредита производиться частями».
-
Для договоров займа (кредита) в титульной части которых установлено значение «истина» для флага «Выдача кредита производиться частями» увеличение суммы кредита (выдача очередной части) не считается изменением условий договора и передавать титульную часть с указанием новой «суммы обязательств по договору» необязательно.
-
Записи о фактическом исполнении обязательств должны передаваться по факту поступления платежа по договору. В записях касающихся основного долга обязательно должна быть указана общая сумма погашенного долга за указанную дату и оставшаяся после платежей сумма основного долга.
-
Записи о фактическом неисполнении должны появляться по факту просрочки платежа и по факту погашения просроченной задолженности совместно с записью о фактическом исполнении обязательств. Записи, касающиеся основного долга, должны содержать сумму просроченной задолженности и сумму основного долга на конец указанной даты. Сумма основного долга включает в себя сумму просроченной задолженности.
-
При полном погашении просроченной задолженности, вне зависимости от отношения записи к основному долгу или процентам, обязательно должна поступить запись о фактическом неисполнении обязательств с указанием нулевой суммы.
-
Новые данные о реорганизованном юридическом лице передаются в режиме добавления новых данных. Если эти данные будут переданы в режиме корректировки данных, то информация о юридическом лице до реорганизации пропадет.
следующая страница>