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

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

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

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

и АБС «Диасофт WorkFlow»

Оглавление

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

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

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

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

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

2.1 Настройки на стороне ДБО.. 3

2.1.1 Общие настройки. 3

2.1.2 Настройка клиентов. 5

2.1.3 Настройка автопроцедур. 6

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

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

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

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

4.1 Функции для работы с OLE-сервером.. 9

4.1.1 Функции общего назначения. 9

4.1.2 Передача данных в систему. 9

4.1.3 Прием данных из системы.. 10

4.2 Формат файла, формируемого системой "Удаленный клиент" (запрос клиента) 11

4.3 Выгрузка. 12

4.3.1 Формат выгрузки документа «Платёжное поручение». 12

4.3.2 Формат выгрузки документа «Поручение на покупку валюты». 13

4.3.3 Формат выгрузки документа «Заявление на продажу валюты». 14

4.3.4 Формат выгрузки документа «Распоряжение на перевод валюты». 15

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

4.4 Механизм «Квитовки» документов. 16

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

4.5.1 Формат загрузки выписки. 17

4.5.2 Формат файла ответов на запрос удаленного клиента. 18

5 Поставка. 19

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

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

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

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

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

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

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

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

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

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

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

2.1  Настройки на стороне ДБО

2.1.1  Общие настройки

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

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

Выберите уже существующую связку, или создайте новую. На экране появится диалог АБС. Выберите тип связки «Модуль связи с АБС Diasoft WorkFlow» (связка № 28).

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

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

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

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

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

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

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

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

2.1.2  Настройка клиентов

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

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

Диалог для добавления счета Клиент АБС Диасофт вызывается по кнопке Ins.

Выберите номер счета в поле диалога «Счет» и АБС в поле «АБС». Также необходимо заполнить все остальные настройки для данного счета:

Поле	Описание	Тип данных	Обязательно к заполнению
Счет	Счет корреспондента	Строка	*
Валюта	Код валюты	Строка	*
Пачка	Номер пачки, в которую выгружать документы по данному счету	Целое число	*
Клиент	Имя пользователя для Login'а во внешнее устройство Диасофт'а	Строка	*
Пароль	Пароль для Login'а во внешнее устройство Диасофт'а	Строка	*
-дней	Интервал дней при запросе выписки (только для формата DiaDoc - связка через внешнее устройство "Клиент Диасофт")	Целое число	*
Путь к файлам запросов к АБС	Каталог, в который выгружаются документы по данному счету. По умолчанию %BSSROOT%\Subsys\to_abs\in	Строка
Путь к файлам ответов из АБС	Поле для хранения каталога для обработки почтовых сообщений из АБС	Строка
АБС	Название АБС	Строка	*

2.1.3  Настройка автопроцедур

Для связки с АБС можно использовать следующие автопроцедуры (пункт меню Сервис à Автопроцедуры à Настройка автопроцедур закладка «Автопроцедуры»):

1.  Автопроцедуры выгрузки:

·  Выгрузка платежных поручений в АБС;

·  Выгрузка распечатанных платежных поручений в АБС;

·  Выгрузка поручений на перевод валюты в АБС;

·  Выгрузка распечатанных поручений на перевод валюты в АБС;

·  Выгрузка поручений на покупку валюты в АБС;

·  Выгрузка распечатанных поручений на покупку валюты в АБС;

·  Выгрузка поручений на продажу валюты в АБС;

·  Выгрузка распечатанных поручений на продажу валюты в АБС;

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

·  Выгрузка распечатанных поручений на списание средств с транзитного валютного счета

·  Выгрузка распоряжений на обязательную продажу валюты;

·  Выгрузка распечатанных поручений на обязательную продажу валюты в АБС;

Автопроцедура «Выгрузка распечатанных <документов> в АБС» используется вместо автопроцедуры «Выгрузка <документов> в АБС» в случае, если, при приеме документа на банковской части ДБО, документ направляется на автоматическую печать со статуса «Принят+».

2.  Автопроцедуры отзыва:

·  Обработка распечатанного запроса на отзыв документа

Используется вместо автоматической документарной операции «Auto. Выполнить запрос на отзыв документа(ProcessRequest)» в случае, если, при приеме запроса на банковской части ДБО, запрос направляется на автоматическую печать со статуса «Принят+».

3.  Автопроцедуры получения выписки:

·  Запрос выписок из АБС (по расписанию)

·  Запрос выписки из АБС по запросу клиента

·  Запрос выписок из АБС по группе счетов (GroupID=1)

·  Автоматическая подготовка выписок для АБС по умолчанию

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

Для связки с АБС используются следующие автоматические документарные операции (пункт меню Сервис à Автопроцедуры à Настройка автопроцедур закладка «Автоматические документарные операции»):

1.  Auto. Выполнить запрос на отзыв документа(ProcessRequest);

2.  Auto. Обработка запроса на выписку(Process_Request).

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

Ниже указан полный список специальных настроек связки, которые при необходимости можно редактировать при помощи диалога Настройка связки с АБС по кнопке «DSP-дерево»

В связке используются специальные настройки из таблицы ABSmanager поле Settings. Все используемые настройки находятся в под ветке Special:

Настройка	Описание	Тип данных	Значение по умолчанию
WorkDir	Рабочая директория	Строка	c:\wftemp\
IsGetStatementAsOffLine	Если false, то получать ответы от АБС во временные файлы	Логический	true
IsFillDealPassportTegs	Заполнять ли теги по паспорту сделки?	Логический	False
IsDiasoftWF_UpVer4_10_01	True – если версия Диасофта выше, чем 4_10_01	Логический	False
OURChargesType	Тип списания комиссии (подставляется в тег М7 - расходы за перевод, если расходы берёт перевододатель)	Строка	За счет перевододателя
BENChargesType	Тип списания комиссии (подставляется в тег М7 - расходы за перевод, если расходы берёт получатель)	Строка	За счет бенефициара
IsFill_U16_U17	Заполнять ли теги U16, U17 значением счёта расходов за перевод	Логический	false
WITHDRREST_AmountName	Значение подставляется в тег :WITHDRREST:	Строковый	AmountReceipts
TYPEDOC	1 вар: 0 - если сумма продажи (AmountForSell) больше нуля, 1 - если равна нулю или пуста. 2 вар: если счет зачисления (ReceiverCurrAccount) начинается с 40819 - то 1, иначе 0.	Целое число	1
IsLoad1256UFields	Выгружать ли поля 1256?	Логический	true
IsConstantlyLoadKPP	Выгружать ли дополнительные поля в платёжном поручении (PayerKPP, ReceiverKPP)	Логический	true
IsBySRC_ID	Если включена, то тег с референсом документа = :SRC_ID, иначе :ID	Логический	False
GroundPositionFromNote1	Позиция основания платежа в tag-поле "Note1"	Целое число	1
IsProccessCurrCodeBy3B	Если true, то заполнять код валюты значением тега 3B, а сумму значением тега 5B	Логический	true
IsProccessBy6B	Заполнять параметры банков по тегу :6B	Логический	true
By_Tag1	Дата документа по тегу 1	Логический	true
IsFillAvailableBalance	Заполнять ли текущий доступный остаток?	Логический	false
IsCutStrFieldValue	Обрезать ли строку до максимального значения длины поля	Логический	false
OleObjectName	Название OLE-объекта	Строковый	DiasoftBANKWF. Application
UserName	Имя пользователя	Строковый
UserPassword	Пароль пользователя	Строковый
DBName	Алиас БД	Строковый	PrimaryDB
KeepConnection	Оставлять ли живым соединение после завершения сеанса?	Логический	true
GetSessionTimeOut	Время ожидания сессии	Целое число	1200
WaitPeriod	Период, через который осуществляется очередная попытка подключения	Целое число	2
FileFlagPath	Не используется	Строковый	%BSSRoot%\SubSys\Temp\wfflag
ComBuffMachineName	машина, накоторой ComBuff. exe	Строковый
WFComOleMachineName	машина, на которой BOle WorkFlow	Строковый
IsFirstRejectTrip	Отменять предыдущий рейс?	Логический	false
IsProcess_ERRORS_TEXT	Считывать ошибки из файлов ответа	Логический	false
IsKvitDuringLoadDocumentToWF	Квитовать во время выгрузки?	Логический	false

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

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

На сервере ДБО для корректной работы связки установка дополнительного ПО не требуется.