Техническая спецификация (стр. 1 )

Техническая спецификация

Обмен данными между системой

ДБО «BS-Client v.3 релиза 17.6»

и АБС «UBS» v.1.0.741

Оглавление

1 Общие положения. 3

1.1 Назначение документа. 3

1.2 Функциональные возможности. 3

1.3 Архитектура. 3

2 Настройка связки. 4

2.1 Общие настройки связки. 4

2.2 Дополнительные настройки связки. 6

2.2.1 Настройка справочника клиентов UBS. 6

2.2.2 Настройка соответствия типов документов ДБО и АБС.. 8

2.2.3 Загрузка словаря произвольных документов в таблицу. 11

2.2.4 Справочник выгрузки документов в UBS. 11

2.3 Настройка реквизитов банка. 13

2.4 Настройка автопроцедур. 14

2.5 Настройка Автоматических документарных операций. 15

2.6 Список специальных настроек связки. 15

3 Требования к окружению.. 16

3.1 Требования к системному программному обеспечению.. 16

4 Функциональная спецификация. 17

4.1 Файлы для работы с культиватором.. 17

4.2 Выгрузка. 18

4.2.1 Формат любого выгружаемого документа. 18

4.2.2 Обработка результатов выгрузки. 19

4.3 Механизм формирования выписки. 19

4.3.1 Запрос выписки. 19

4.3.2 Документы выписки. 21

4.3.3 Остатки по счетам.. 23

4.4 Отзыв документов из АБС.. 26

4.4.1 Запрос на отзыв. 26

4.4.2 Обработка результатов отзыва. 27

4.5 Квитовка документов. 27

4.5.1 Внешняя квитовка. 27

4.5.2 Квитовка по выписке. 28

5 Поставка. 29

6 Приложение 1. 30

6.1 Описание выгружаемых полей документов. 30

6.1.1 Таблица 1. Рублевые платежные поручения. 30

6.1.2 Таблица 2. Заявка на продажу валюты.. 31

6.1.3 Таблица 3. Поручение на покупку иностранной валюты.. 32

6.1.4 Таблица 4. Валютное платежное поручение. 32

6.1.5 Таблица 5. Распоряжение на списание средств с транзитного валютного счета. 34

6.1.6 Таблица 5. Поручение на обязательную продажу валюты.. 35

6.2 Описание таблиц клиентов и счетов АБС.. 36

6.2.1 Таблица 1. Справочник клиентов UBS. 36

6.2.2 Таблица 2. Справочник авторизованных счетов АБС.. 36

6.3 Расшифровка форматов выгрузки документов. 36

6.4 Синтаксис задания условия выбора схемы выгрузки документа в диалоге «Соответствие документа ДБО документу UBS» 37

6.5 Список функций на прикладном языке, используемых при создании шаблона выгрузки. 37

6.6 Описание работы с Культиватором.. 37

7 Приложение 2. 38

8 Приложение 3. 39

1  Общие положения

1.1  Назначение документа

Документ является спецификацией интерфейсов обмена данными между информационными системами Дистанционное банковское обслуживание «BS-Client v.3», далее ДБО и Автоматизированная банковская система АБС «UBS», далее АБС.

1.2  Функциональные возможности

Связка поддерживает следующие операции:

Наименование документа	Возможность выгрузки	Возможность отзыва	Возможность получать статус состояния (полная квитовка)
Платёжное поручение	+	+	+
Поручение на перевод валюты	+	+	+
Поручение на покупку валюты	+	+	+
Поручение на продажу валюты	+	+	+
Распоряжение на списание с транзитного валютного счета	+	+	+
Распоряжение на обязательную продажу валюты	+	+	+
	Возможность импорта документа
Произвольный документ для клиентов	-
	Возможность загрузки	Плановые обороты
Выписка по рублевым и валютным счетам	+	-

Описание операций, выполняемых над документами, описано в Приложении 2.

1.3  Архитектура

Взаимодействие между сервером ДБО и АБС осуществляется средствами культиватора - модуля, предназначенного для автоматизированной обработки задач, связанных с экспортом и импортом данных АБС. Взаимодействие ДБО с культиватором происходит посредством обмена между ними текстовыми файлами, помещаемыми во входной и выходной каталоги культиватора.

Подробнее о культиваторе см. 6.5 Приложение 1. Описание работы с Культиватором.

2  Настройка связки

Настройка связи с АБС осуществляется на банковской части системы BS-Client.

Примечание. Связка системы ДБО с АБС постоянно развивается и совершенствуется. Перед первоначальной настройкой связки рекомендуем обратиться в службу сопровождения и запросить последние модули по связке.

Настройка связки с АБС осуществляется на банковской части системы ДБО

2.1  Общие настройки связки

Для общей настройки связки необходимо выполнить следующие действия на сервере ДБО:

В пункте меню выберите Сервис à Интерфейс с АБС à Администрирование связок с АБС. Появится окно Справочник АБС.

Выберите уже существующую связку, или создайте новую. На экране появится диалог АБС. Выберите тип связки Связка с АБС UBS (связка № 29).

Примечание. Только в случае, если у вас уже используется запись с ID=1 для другой АБС банка (например, при централизованной системе ДБО), необходимо добавить новую запись. Важно, чтобы в скроллере «Справочник с АБС» всегда присутствовала запись с ID=1.

2.  Нажмите на кнопку «Настройки связки». На экране появится диалог Настройка связки с АБС.

Диалог имеет три страницы:

Выписки содержит настройки для получения выписки;

Выгрузка/Отзыв содержит настройки, необходимые для выгрузки и отзыва документов;

Остатки содержит настройки для получения остатков по счетам.

Заполните поля в диалоговом окне Настройка связки с АБС на страницах Выписки, Выгрузка/Отзыв и Остатки, затем нажмите кнопку ОК.

Примечание: При заполнении параметров связки руководствуйтесь общей информацией о настройке связи с АБС, содержащейся в документе BS_ABS_Main.doс

2.2  Дополнительные настройки связки

В окне Настройка связки с АБС (см п. 2.1, подпункт 3) нажмите кнопку «Дополнительные настройки…».

На экране появится Диалог настройки параметров связки с АБС UBS.

При помощи диалога «Диалог настройки параметров связки с АБС UBS» необходимо заполнить следующие параметры:

Метка	Описание	Обязательно к заполнению
Алиас к базе данных UBS по умолчанию	DSN базы данных UNISAB, к которой культиватор будет подсоединяться по умолчанию	Да
Файл запуска культиватора	Путь к файлу запуска культиватора	Да
Файл настроек культиватора	Параметры запуска культиватора	Да

2.2.1  Настройка справочника клиентов UBS

Для однозначного соответствия клиента ДБО клиенту в АБС необходимо выполнить настройку справочника клиентов АБС.

Нажмите кнопку «Справочник клиентов UBS» диалога «Диалог настройки параметров связки с АБС UBS»

На экране появится скроллер Справочник клиентов UBS (таблица ClientUBS, см. подробнее 6.1.1 Таблица 1. Справочник клиентов UBS).

Для ввода новой записи нажмите клавишу Ins или воспользуйтесь кнопкой .

На экране появится диалог Клиент UBS.

Описание диалога «Клиент UBS»

Метка	Описание
Название клиента в UBS	Идентификатор клиента Клиент-Банка в UBS, поле CLIENTUBSID в таблице ClientUBS. Обязательное к заполнению
Алиас к базе UBS	Алиас к базе данных UBS, поле DSN в таблице ClientUBS. Необязательное к заполнению, если совпадает с DefaultDB
Последний референс рублевого документа	Максимальный числовой идентификатор рублевого документа клиента в опердне, поле NUM_LINE в таблице ClientUBS. В скроллере это значение в столбце «Счетчик РУБ. док.»
Последний референс валютного документа	Максимальный числовой идентификатор произвольного документа клиента в опердне, поле ID_FR_DOC в таблице ClientUBS. В скроллере это значение в столбце «Счетчик ВАЛ. док.»
Авторизированные счета в UBS	Скроллер таблицы CustUBS (см. подробнее 6.2.2 Таблица 2. Справочник авторизованных счетов АБС), открытый по фильтру CLIENTUBSID

Далее в скроллере «Справочник клиентов UBS» активизируйте контекстное меню и выберите команду «Авторизация клиента».

Произойдет авторизация клиента: для данного клиента UBS в таблице ClientUBS заполнятся поля NUM_LINE (счетчик рублевых документов) и ID_FR_DOC (счетчик валютных документов).

В таблицу CustUBS занесутся все счета, по которым ДБО может выгружать документы и получать выписки.

Для авторизации (как и для любого обращения к АБС) культиватору передаются файл с данными и файл задания для культиватора, после обработки которых АБС возвращает файл-ответ со списком авторизованных счетов.

Файл	Правило формирования имени файла	Формат содержимого файла
Файл с данными	inCXRequest<текущий момент времени в формате yymmddhhmmssms>.<автономер клиента UBS>	p.CLBANK_Check_Id '%File%', '%Sgntr%', '%Login%'<значение из спец. настройки AccountCurrCodeType, см. 2.6 Список специальных настроек связки> Константная строка
Файл задания для культиватора	CXRequest<текущий момент времени в формате yymmddhhmmssms>.<Алиас к базе UBS>	#77#<Полный путь ко входному файлу с данными>#<Полный путь к выходному файлу-ответу> #<наименование клиента, поле ClientUBSID из таблицы ClientUBS>
Ответ	outCXRequest<текущий момент времени в формате yymmddhhmmssms>.<автономер клиента UBS>	<<@ANSWER_ID@>> //Постоянная строка //Далее набор из нескольких строк формата типа: префикс, пробел, значение. Строки могут быть размещены в произвольном порядке и все являются необязательными NUM_LINE <Максимальный числовой идентификатор рублевого документа клиента в опердне> ID_FR_DOC <Максимальный числовой идентификатор произвольного документа клиента в опердне> BIC <БИК клиента> //не используется NAME <Наименование клиента>//не используется KPP <КПП клиента>//не используется INN <ИНН клиента>//не используется OKATO <Код ОКАТО>//не используется STRACCOUNT <Допустимый для дебетования счет клиента (может быть несколько строк с данным префиксом). Эти счета назначаются на стороне АБС отдельно для каждого клиента в системе Клиент-Банк> SID_MULTICLIENT <Идентификатор мульти-клиентности в системе>//не используется SID_CLIENT <Идентификатор клиента в клиентской части системы>//не используется <<@END_ID@>> //Постоянная строка ---- <Сообщение о результатах обработки файла (от культиватора)>

2.2.2  Настройка соответствия типов документов ДБО и АБС

Для соответствия типов документов ДБО схемам выгрузки в АБС по некоторому условию необходимо выполнить настройку соответствие документа ДБО документу UBS.

Нажмите кнопку «Соответствие документа ДБО документу АБС UBS» диалога «Диалог настройки параметров связки с АБС UBS»

На экране появится скроллер Соответствие документа ДБО документу UBS (таблица UBSDocScheme).

Для ввода новой записи нажмите клавишу Ins или воспользуйтесь кнопкой .

Для редактирования записи выделите ее и нажмите клавишу Enter.

На экране появится диалог Соответствие документа ДБО документа UBS.

При помощи этого диалога определяется, каким образом (по какой схеме) будет выгружаться в АБС тот или иной документ в зависимости от некоторого условия.

1)  Выберите из таблицы документарных номер документа в ДБО в поле диалога «ДБО» и далее номер схемы выгрузки из справочника схем выгрузок UBS в поле «UBS»:

2)  В связке предусмотрено два варианта задания условия, в зависимости от настройки (см. подробнее настройку UnloadNewFormat в Списке специальных настроек связки).

a)  В случае выключенной настройки (UnloadNewFormat = false) заполняются соответствующие поля группы «Условие соответствия по полю», где записываются наименование поля и его значение:

В данном примере документ «Поручение на продажу валюты» (CURRSELL), у которого в поле DealType стоит значение ‘Обратная’, будет выгружен по 101-й схеме.

b)  В случае включенной настройки (UnloadNewFormat = true) заполняется «Условие выбора схемы выгрузки», см. Синтаксис задания условия выбора схемы выгрузки документа в диалоге «Соответствие документа ДБО документу UBS»

В данном примере документ «Поручение на перевод валюты» (PAYDOCCUR) со статусом, отличным от 17001 и идентификатором организации, равном 1, будет выгружен по схеме 106.

Если для одного документа в ДБО есть хотя бы одна схема с непустым условием выбора схемы выгрузки, то обязательно должно быть и пустое условие со схемой выгрузки по умолчанию. То есть, в нашем случае, если документ «Поручение на перевод валюты» не удовлетворяет условию выбора схемы выгрузки, то для него должен быть предусмотрена схема выгрузки по умолчанию (например, схема 105 с пустым условием).