Системы «клиент-банк» позволяют клиенту дистанционно работать со своими счетами в банке – отправлять и получать платежи. В программном комплексе «Дебет Плюс V12» реализована возможность интеграции с такими системами. Благодаря этому пользователь может осуществлять:
1. Импорт платежных поручений в программу «Дебет Плюс V12» из системы «клиент-банк».
2. Экспорт созданных в программе «Дебет Плюс V12» платежных поручений в систему «клиент-банк».
3. Создание «Банковской выписки общей» на основе платежных поручений, которая нужна для контроля дебетовых и кредитовых платежей, импортируемых из системы «клиент-банк».
Для работы с пакетом «клиент-банк» необходимо скачать готовую настройку импорта или экспорта платежных поручений (они же и «банковские выписки») для интересующего Вас банка со страницы Настройки интеграции с системами «клиент-банк» нашего сайта. Самый простой способ установки готовой настройки описан в обучающем видеоролике Установка клиент-банка с сайта и в разделе Установка готовой настройки импорта из системы «клиент-банк» этой инструкции. Если не одна из настроек Вам не подошла, тогда Вы можете создать её самостоятельно, руководствуясь указаниями данной инструкции. Будем благодарны Вам за сообщения о возникновении проблем с готовыми настройками, если таковые будут иметь место, на форуме или по адресу debet@debet.kiev.ua.
После создания настройки необходимо установить параметры импорта (экспорта), после чего можно будет производить непосредственно сам импорт или экспорт платежных поручений. Такая возможность сэкономит Ваше время и освободит от необходимости двойного ввода первичных документов.
Установка готовой настройки импорта из системы «клиент-банк».. <3
Установка параметров импорта из системы «клиент-банк».. 4
Импорт из системы «клиент-банк».. 7
Банковская выписка общая (BVO). 10
Установка параметров экспорта в систему «клиент-банк».. 13
Экспорт в систему «клиент-банк».. 14
Общие принципы создания настройки для импорта/ экспорта платежей.. 15
Создание настройки для импорта платежей из системы «клиент-банк» на основе dbf файла.. 17
Создание настройки для импорта платежей из системы «клиент-банк» на основе текстового файла.. 21
Создание настройки для файлов типа 1.. 21
Создание настройки для файлов типа 2.. 25
Создание настройки для файлов типа 3.. 27
Создание настройки для экспорта платежей в систему «клиент-банк» на основе dbf файла.. 29
Создание настройки для экспорта платежей в систему «клиент-банк» на основе текстового файла.. 31
Создание настройки для файлов типа 1.. 32
Создание настройки для файлов типа 2.. 35
Параметры даты.. 36
Выражения на JavaScript. 37
Установку готовой настройки импорта платежных поручений можно осуществить двумя способами:
1. Зайти на сайт http://www.debet.kiev.ua/ в раздел Настройки интеграции с системами «клиент-банк» непосредственно из программы, нажав на кнопку «Посетить Web-сайт» на панели управления системой. При нажатии кнопки «Скачать» модуль установится автоматически.
2. Зайти на сайт http://www.debet.kiev.ua/ в раздел Настройки интеграции с системами «клиент-банк», скачать необходимый модуль импорта и установить содержимое папки в каталог \DebetPlusV12\base\org1\clbank (если папки clbank нет, тогда создайте ее; в какую именно папку с настройками org1, org2 и т.д. скопировать настройки импорта, посмотрите в настройках соединения базы данных).
Для установки параметров импорта из системы «клиент-банк» воспользуйтесь меню «Настройка»/«Настройка клиент-банка», находясь в подсистеме «Администрирование» или «Учет банковских операций»:
Перейдите на вкладку «Импорт» в появившемся окне настройки параметров импорта и экспорта и выберите пункт контекстного меню «Редактировать параметры»:
В результате появится следующее диалоговое окно, заполните его и сохраните изменения:
1. Директория импорта – путь в папку, в которую система «клиент-банк» будет выгружать файлы, а «Дебет Плюс V12» - забирать файлы.
2. Рабочая директория – путь в папку, в которой «Дебет Плюс V12» будет сохранять копии файлов.
3. Маска импорта – маска, по которой будут отбираться файлы в директории импорта.
4. Формат даты в имени файла ("*" в маске импорта) – выбор из предложенных вариантов нужного формата даты. См. раздел Параметры даты
5. Брать дату документа из названия файла – поле становится активным, если указан формат даты.
6. Импортировать за указанный период – если установить отметку, система будет запрашивать период, за который необходимо импортировать платежные поручения.
7. Удалять импортированные файлы из дир. импорта – ставится отметка, если нет необходимости сохранять файлы.
8. Сохранять копии импортированных файлов – ставится отметка, если пользователь хочет сохранять копии в рабочую директорию.
9. При попытке импортировать уже симпортированный файл – система предлагает несколько вариантов: никогда не импортировать, спрашивать у пользователя, всегда импортировать.
10. Сообщать о дублирующих документах – ставится отметка в том случае, если необходимо предупредить пользователя о попытке повторного импорта файла, программа сообщит о попытке импортирования платежных поручений с одинаковыми: номерами, датами, суммами, типом документа и назначением платежа.
11. Импортировать PP и PV отдельно – если установить отметку, то программа будет отдельно импортировать входящие (PV) и исходящие (РР) платежные поручения. Если отметку не устанавливать, то одновременно с платежными поручениями входящими (PV) в папку с таким же номером будут выгружаться также платежные поручения исходящие (РР), и наоборот.
12. Выводить отладочные сообщения – в процессе импорта будет сообщаться, откуда, куда, с какой маской и сколько файлов импортируется.
13. Импортировать в общую банковскую выписку (BVO) – эта опция доступна только для импортируемых файлов формата dbf и всех настроек, созданных вручную. Обратите внимание на пункт «Импортировать документы PP и PV отдельно»: если отметка не поставлена, то все дебетовые (PV) и кредитовые платежи (PP) сразу будут связаны с документом «Банковская выписка общая (BVO)», который создастся во время импорта; если же отметка установлена, тогда при импорте платежей одной стороны (например, PV) будет создан документ BVO, и при импорте другой стороны (РР) нужно выбрать этот же документ BVO.
Платежные поручения загружаются в ту папку, в которой запускается процедура импорта. Для удобства пользователя можно создать две дополнительные папки, которые будут предназначены исключительно для импорта информации из системы «клиент-банк».
Откройте список документов в подсистеме «Учет банковских операций» (меню «Первичные документы»/«Список документов»), выделите соответствующий тип документов и выберите пункт «Добавить».
Для типа документов «Платежное поручение исходящее (PP)» добавьте папку «КЛИЕНТ-БАНК (платежи наши)» с номером операции, например 500, и для типа документов «Платежное поручение входящее (PV)» – папку «КЛИЕНТ-БАНК (платежи нам)» с тем же номером.
Зайдите в одну из созданных папок, например «КЛИЕНТ-БАНК (платежи нам)», и выберите пункт контекстного меню «РАБОТА С ПАКЕТОМ «КЛИЕНТ-БАНК»»/«ИМПОРТ ИЗ ПАКЕТА «КЛИЕНТ-БАНК»».
В открывшемся окне выберите нужную Вам настройку из перечня настроек импорта данных из системы «клиент-банк».
Далее открываются информационные окна (настройки импорта файлов, количество импортируемых файлов) – нажимаем ОК.
В том случае, если в параметрах импорта был отмечен пункт «Импортировать в общую банковскую выписку (BVO)», то при запуске импорта появится диалоговое окно, предлагающее создать документ «BVO». Платежи будут связаны с документами «BVO», которые будут контролировать их дебетовую и кредитовую суммы.
Документ «Банковская выписка общая (BVO)» подробнее описан в разделе Банковская выписка общая (BVO) этой инструкции.
По окончании импорта на экране появится список импортированных в папку «КЛИЕНТ-БАНК (платежи нам)» платежных поручений входящих (PV).
Для платежных поручений исходящих (PP) необходимо повторить те же операции.
Если в параметрах импорта не был отмечен пункт «Импортировать PP и PV отдельно», то одновременно с платежными поручениями входящими (PV) в папку с таким же номером «КЛИЕНТ-БАНК (платежи наши)» будут импортированы и платежные поручения исходящие (РР).
Проставление кода
В списке могут быть контрагенты, для которых система не определила код, тогда выделяем все платежные поручения комбинацией клавиш «Ctrl» + «+», нажимаем «Enter» и выбираем пункт контекстного меню «РАБОТА С ПАКЕТОМ КЛИЕНТ-БАНК»/«Установить код по ОКПО+МФО+РС». Система ищет в справочнике контрагента с соответствующими ОКПО, МФО и РС и устанавливает код автоматически. Пользователь может выбрать любые другие варианты проставления кода из предложенных системой.
В случае использования пунктов «Установить код по ОКПО+МФО+РС», «Установить код по МФО+РС», «Установить код по ОКПО» или же «Установить код по всем атрибутам по очереди» система проставит код только тогда, если найден всего один контрагент, отвечающий критериям отбора. При использовании пункта меню «Установить код без реквизитов», система выдает список контрагентов с одинаковыми реквизитами, из которого пользователь выбирает нужного.
Если же вышеперечисленные действия не дали результата, то, скорее всего, контрагента нет в справочнике. Чтобы его добавить, выбираем «Добавить контрагента в справочник», система автоматически добавит контрагентов в справочник и проставит код.
Перевод документов
После проставления кодов документы можно разложить в соответствующие папки. Выделяем нужные документы, в контекстном меню выбираем «Сервис»/«Перевести в другую папку», откроется список соответствующих папок, выбираем нужную папку двойным щелчком мыши. Документы переместятся в выбранную папку. Далее по ним можно сформировать проводки.
Перенос документов
Если система клиент-банк неправильно определила тип платежного поручения, например платежное поручение исходящее (РР) импортировано, как платежное поручение входящее (PV), тогда отмечаем необходимые документы, в контекстном меню выбираем пункт «Перенести в исходящие платежные поручения (РР)» и из списка папок выбираем нужную. Документы перенесутся в указанную папку.
На сайте http://www.debet.kiev.ua/ можно просмотреть видеоролик по работе с «клиент-банком» «Импорт данных из Клиент-Банка 2008-05».
Документ общей банковской выписки (BVO) создается для контроля дебетовых и кредитовых платежей, импортируемых из системы «клиент-банк».
Для начала в подсистеме «Учет банковских операций» откроем список документов и создадим для документа «BVO» папки и операции нужных нам банков. Если у Вас в списке нет этого документа, то в подсистеме «Администрирование» выберите меню «Сервис» / «Обновление структур БД». В открывшемся окне модификации структур снимите выделение со всех таблиц с помощью соответствующего пункта контекстного меню и, поставив галочку «Сверка с эталоном», запустите модификацию.
В подсистеме «Администрирование» в меню «Настройка» / «Настройка клиент-банка» вызовем окно настройки форматов импорта и для настройки каждого банка установим галочку «Импортировать в общую банковскую выписку (BVO)» (эта опция доступна только для файлов импортируемых в формате dbf, а также файлов, созданных вручную средствами «Дебет Плюс V12»). Смотрите подробнее в разделе Установка параметров импорта из системы «клиент-банк».
Также обращаем внимание на галочку «Импортировать документы PP и PV отдельно». Если эта галочка отсутствует, то тогда мы можем сразу все дебетовые (PV) и кредитовые платежи (PP) связать с документом «BVO», который мы создадим во время импорта, если же галочка установлена, то тогда при импорте платежей одной стороны (например, PV) – мы создаем документ «BVO», а при импорте другой стороны (РР) мы выбираем этот же документ «BVO».
Во время импорта платежей возникнет диалоговое окно, предлагающее создать документ «BVO».
После согласия выбираем из открывшегося списка нужную нам папку (например, «Укрсиббанк») и добавляем в нее документ «BVO», где указываем дату и номер документа, тип валюты и выбираем нужный нам счет (если у нашей организации их несколько и платежи идут не на основной счет). После сохранения документа выбираем его двойным щелчком мыши либо нажатием клавиши «Enter».
Во время импорта в документе «BVO» накапливаются дебетовые (приход) и кредитовые (расход) суммы платежей. При открытии нашего документа автоматически откроется окно в нижней части программы со связанными платежами. Это окно можно также вызвать с помощью контекстного меню «Показать документы по банковской выписке».
Сумма прихода и расхода формируются на этапе импорта платежей и после него совпадают с контрольными суммами, которые считаются по связанным платежам, сам документ при этом окрашен голубым цветом. Если же суммы не совпадают, это значит, что один либо несколько документов были удалены или же были изменены их суммы.
Установить суммы по связанным документам можно с помощью соответствующего контекстного меню «Установить дебет-кредит суммы и НДС по связанным платежам».
В списке платежных поручений по банковской выписке имеются следующие пункты контекстного меню:
1. «Поиск документа» – открывает папку с соответствующим документом (PP или PV)
2. «Просмотр документа» – поднимает соответствующий документ на просмотр
В документах PP и PV существует контекстное меню для работы с документом BVO «Банковская выписка (общая)», у которого есть следующие подменю:
1. «Связать платежи с банковской выпиской» – позволяет установить связь между отмеченными платежами и конкретным документом банковской выписки, тип связи – один ко многим, т.е. одни и те же платежи не могут одновременно относится к нескольким банковским выпискам.
2. «Поиск банковской выписки» – открывает папку документов BVO и устанавливает курсор на соответствующем документе.
Платежные поручения исходящие (РР) можно экспортировать в dbf или текстовый файл, который впоследствии может быть импортирован в систему «клиент-банка». Для каждого конкретного банка нужна своя настройка экспорта в систему «клиент-банк», которая устанавливается в каталог base / org1 / clbank.
Работа с настройками «Клиент-банка» осуществляется с помощью окна настройки параметров экспорта, которое можно открыть в подсистеме «Администрирование» в меню «Настройка» / «Настройка «клиент-банка» на вкладке «Экспорт».
Выбираем в контекстном меню пункт «Редактировать параметры», заполняем шаблон и сохраняем:
1. Формат – путь в папку, откуда «Дебет Плюс V12» будет забирать файлы.
2. Директория экспорта – путь в папку, в которую «Дебет Плюс V12» будет сохранять экспортированный файл.
3. Шаблон DBF файла – заполняется автоматически.
4. Имя файла экспорта – название экспортированного файла пользователь указывает произвольно.
5. Формат даты в имени файла (“*” в имени файла) - если имя файла должно содержать дату на момент экспортирования, тогда в имени файла ту часть, которая должна состоять из даты заменяем символом звездочки (*), а в поле «Формат даты в имени файла» указываем нужный формат (см. раздел Параметры даты).
6. При существовании файла экспорта - система предлагает несколько вариантов: перезаписывать, спрашивать у пользователя, дозаписывать.
Платежные поручения исходящие (РР) можно экспортировать в dbf или текстовый файл, который впоследствии может быть импортирован в систему «клиент-банка».
В режиме просмотра списка вызываем контекстное меню и выбираем «РАБОТА С ПАКЕТОМ «КЛИЕНТ-БАНК» / «ЭКСПОРТ ИЗ ПАКЕТА «КЛИЕНТ-БАНК». В открывшемся окне выбираем из перечня банков, для которых настроен экспорт данных в систему «клиент-банка», нужный пользователю.
Далее открываются информационное окно, сообщающее о количестве экспортируемых файлов, – нажимаем «ОК». Файл в формате dbf или текстовый файл будет сохранен по адресу, указанному в директории экспорта.
В программе реализована возможность создания пользователем настроек для импорта платежей из системы «клиент-банк» из файлов текстового (с версии 11.9.0 RC4) и dbf (с версии 11.5.08 RC2) форматов, а также для экспорта платежей в систему «клиент-банк» из файлов dbf формата(с версии 11.6.03 RC3) и текстового формата (с версии 11.9.0 RC4).
На этапе создания настроек используется образец dbf или текстового файла (в случае экспорта наличие образца текстового файла не является обязательным), на основе которого устанавливаются соответствия между полями файла и переменными документов внутренних (PP) и внешних (PV) платежных поручений.
Работа с настройками системы «клиент-банка» осуществляется с помощью окна настройки форматов импорта и экспорта, которое можно открыть в подсистеме «Администрирование» или «Учет банковских операций» в меню «Настройка»/«Настройка клиент-банка» на вкладке «Импорт» и «Экспорт» соответственно.
В данном окне имеются следующие пункты контекстного меню:
1. Редактировать параметры (в версиях ниже 11.5.08 RC2 пункт назывался «Редактировать»)
2. Добавить настройку на основе dbf файла
3. Добавить настройку на основе текстового файла
4. Редактировать настройку созданную на основе файла
5. Удалить
В отличии от импорта, система экспорта позволяет редактировать не только созданные с помощью п.2 и п.3 настройки, но и готовые настройки, скачанные с сайта.
При вызове п.2 или п.3 появляется диалоговое окно настройки форматов импорта (экспорта), в которое, используя кнопку «Открыть», необходимо загрузить перечень полей dbf или текстового файла, их тип и пример возможных значений, который позволяет правильно подобрать кодировку и помогает определить смысл полей (описание полей можно получить из системы «клиент-банк», в которой был сформирован dbf или текстовый файл).
Название настройки должно состоять только из букв латинского алфавита и цифр, причем начинаться оно должно только с буквы.
После заполнения всех элементов формы, необходимо загрузить переменные платежных поручений с помощью кнопки «Загрузить переменные документа», после чего в таблицу загружается список переменных.
После загрузки переменных необходимо установить связь между полями источника и приемника. Определение соответствия между полями источника и приемника осуществляется с помощью стандартного редактирования строк списка, где в поле источника мы выбираем нужную переменную документа.
Поле «Выражение» формируется автоматически либо пользователем на языке JavaScript (отдельно о выражениях будет написано в разделе Выражения на JavaScript данной инструкции), в зависимости от того, как должен быть преобразован тип поля источника. Если преобразований не требуется, то значения переменной и выражения совпадают.
При необходимости можно вернуться к редактированию настроек dbf или текстового файла (кнопка «Вернуться к настройке dbf» или «Вернуться к настройке текстового файла»), но в таком случае все установленные связи между полями источника и приемника будут утеряны.
Если все необходимые поля заполнены, а данные отредактированы, тогда сохраняем настройку с помощью кнопки «Сохранить». После сохранения настройки, необходимо, воспользовавшись пунктом контекстного меню «Редактировать параметры», определить основные параметры импорта (экспорта). Внесение изменений в созданную настройку осуществляется с помощью контекстного меню: «Редактировать настройку созданную на основе файла».
Дальнейший импорт (экспорт) платежей осуществляется из подсистемы «Учет банковских операций».
В программе «Дебет Плюс V12» реализована возможность создания пользователем настройки, которая позволяет импортировать файлы в формате dbf. На этапе создания используется образец dbf файла (источник), на основе которого устанавливаются соответствия между полями файла и переменными документов (приемник) внутренних (PP) и внешних (PV) платежных поручений.
Подробнее об основах создания настройки для импорта платежей из системы «клиент-банк» смотрите в разделе Общие принципы создания настройки для импорта/экспорта платежей.
При вызове пункта контекстного меню «Добавить настройку на основе dbf файла» появляется следующее окно, в котором, используя кнопку «Открыть», загружается перечень полей dbf, их тип и пример возможных значений.
После заполнения всех элементов формы, загружаем переменные платежных поручений с помощью кнопки «Загрузить переменные документа», после чего в таблицу загружается список переменных (поле приемник).
Для начала необходимо указать поле источника, которое определяет тип платежа, а также установить условие и значение этого поля, которое определит принадлежность строк источника ко внешнему платежному поручению (документ PV, т.е. платежи которые платят нам). Для этого заполните поля напротив надписи «Условие принадлежности к внешнему платежному поручению (PV)».
Определение соответствия между полями источника и приемника осуществляется с помощью стандартного редактирования строк списка, где в поле источника мы выбираем нужное поле из списка полей dbf файла, причем выбранные ранее поля выделяются синим цветом.
Поле «Выражение» формируется автоматически либо пользователем на языке JavaScript.
Если тип источника является текстовым, а тип приемника датой или наоборот, в таком случае система предложить выбрать формат даты из списка в диалоговом окне. См. раздел Параметры даты
Некоторые переменные, в зависимости от принадлежности к виду платежа (PP или PV), могут быть взаимозаменяемыми (в списке они визуально сгруппированы в колонке «№»). Поэтому если в источнике одно и тоже поле, в зависимости от вида платежа, относится к разным полям приемника (будет истинна и обратная связь: поле приемника будет относиться к разным полям источника), то при редактировании такого поля нужно установить галочку «Использовать инвертированные переменные для противоположного док-та». Появится дополнительное поле. В «Поле для PV» и в «Поле для PP» устанавливаются соответствующие значения полей источника.
По умолчанию считается, что сумма платежа импортируется с учетом НДС, поэтому поле НДС берется как 1/n суммы платежа автоматически, где 
(% НДС указан в меню «Настройки – Параметры системы»), при % НДС = 20, n = 6. Если требуется рассчитать НДС по другой формуле, тогда ее можно изменить в выражении, вызвав в списке переменных на переменной HNDS контекстное меню «Редактировать выражение» (с помощью этого меню можно редактировать выражение любой другой переменной)
Если приведенных в списке полей приемника (переменных платежных документов) не достаточно, то можно добавить недостающее поле с помощью контекстного меню «Добавить».
Перед сохранением настройки необходимо убедится, что у всех переменных есть значение в колонках «Выражение», если какие-то переменные лишние, то их необходимо удалить.
После сохранения настройки определяем основные параметры импорта. В случае необходимости в созданную настройку можно внести изменения.
По характеру хранения информации текстовые файлы можно разделить на три типа:
1. Файлы, в которых переменные документа записаны в одной строчке в строго определенных позициях (большинство текстовых файлов украинских банков).
2. Файлы, в которых переменные документа записаны в одной строчке с помощью символа разделителя или наборов символов (таким являются файлы с расширениями CSV).
3. Файлы, в которых в одной строчке находится одна переменная документа (большинство российских банков).
Подробнее о работе с настройками «клиент-банка» смотрите в разделе Общие принципы создания настройки для импорта/экспорта платежей.
Добавление осуществляется с помощью контекстного меню «Добавить настройку на основе текстового файла». Элементы формы, расположенные в верхней левой части экрана, являются стандартными для всех трех типов файлов. При незнании правильной кодировки, ее можно подобрать ориентируясь по отображению текста в колонке «Примечание»). При вызове пункта «Добавить настройку на основе текстового файла» появляется окно, в котором, с помощью выпадающего списка «Описание данных в файле» выбирается тип текстового файла. Рассмотрим подробности создания настроек трех вышеперечисленных типов:
По умолчанию в выпадающем списке «Описание данных в файле» установлено значение «переменные документа записаны в одной строчке в строго определенных позициях».
Если в файле данные платежей начинаются не с первой строчки, тогда указываем номер строки, с которой они начинаются в соответствующем поле формы.
Если в файле присутствуют названия переменных платежей и их позиции совпадают с позициями соответствующих переменных, тогда в поле «Заголовки переменных в строке №» указываем номер соответствующей строчки (этот параметр не является обязательным и указывается лишь для смыслового обозначения полей источника), в противном случае оставляем ноль и тогда поля источника будут иметь название FIELD + индексы позиций разделенных символом подчеркивания.
Перед открытием текстового файла, необходимо ввести диапазоны индексов строки файла (кнопка «Ввести диапазоны»), в которых находятся значения переменных.
Если диапазоны не указывать, то система автоматически предложит их ввести при открытии файла. При вводе первого и последнего индекса переменной, в колонке «Примечание» будет отображаться значение этой переменной из строки файла, указанной в поле «Начиная со строчки №». Завершение ввода осуществляется путем закрытия списка либо вызова контекстного меню «Закончить ввод данных». В последствии этот диапазон можно редактировать с помощью соответствующей кнопки.
После заполнения всех элементов формы и появления списка полей источника загружаем переменные платежных поручений (поле приемник).
Перед тем, как устанавливать связи между полями приемника и источника, необходимо указать поле источника, которое определяет тип платежа, а также установить условие и значение этого поля, которое определит принадлежность строк источника ко внешнему платежному поручению (документ PV, т.е. платежи которые платят нам). Если сумму НДС нужно округлять, то устанавливаем соответствующую галочку и точность округления.
После загрузки переменных можно вернуться к редактированию настроек текстового файла, но в таком случае все установленные связи между полями источника и приемника будут утеряны.
Определение соответствия между полями источника и приемника осуществляется с помощью стандартного редактирования строк списка, где в поле источника мы выбираем нужное поле из списка полей текстового файла, причем выбранные ранее поля выделяются синим цветом.
Поле «Выражение» формируется автоматически либо пользователем на языке JavaScript в зависимости от того, как должно быть преобразовано поле источник. В выражении поле источник записывается следующим образом:
!{<начальный индекс>-<конечный индекс>}
С помощью функции allt() у каждой переменной источника отсекаются в начале и в конце пробелы.
В разделе Создание настройки для импорта платежей из «клиент-банка» на основе dbf файла описана ситуация, когда тип приемника является датой, а также есть подробная информация о взаимозаменяемых переменных.
Пример: В «Поле для PV» и в «Поле для PP» устанавливаются соответствующие значения полей источника.
По умолчанию считается, что сумма платежа импортируется с учетом НДС. Смотрите подробнее в разделе Создание настройки для импорта платежей из «клиент-банка» на основе dbf файла ,
Рассмотрим вариант, когда требуется рассчитать НДС не по формуле 1/n, где 
(% НДС = 20, n = 6), а по другой. Тогда ее можно изменить в выражении, вызвав в списке переменных на переменной HNDS контекстное меню «Редактировать выражение» (с помощью этого меню можно редактировать выражение любой другой переменной).
Например, выражение:
round(Number(allt(!{48-63}))/100/6,2)
будет равносильно выражению:
round(Number(allt(!{48-63}))/600,2)
Выбираем в выпадающем списке «Описание данных в файле» значение «переменные документа записаны в одной строчке с помощью разделителя».
Если открыть файл с расширением CSV, то в таком случае система сама установит необходимые параметры, в противном случае нужно указать символ (или комбинацию символов) разделителя в тексте (для CSV файла это символ точки с запятой), номер строки, с которой нужно начинать считывание данных, и номер строки, в которой хранятся названия переменных (если такая строка имеется, если нет – оставляем ноль).
После этого загружаем переменные документа, дальнейшие действия аналогичны с действиями, описанными в разделе Создание настройки для файлов типа 1 данной инструкции.
Выбираем в выпадающем списке «Описание данных в файле» значение «в одной строчке файла находится одна переменная документа».
Перед тем как открыть файл необходимо указать символ (или набор символов) разделитель, который разделяет в строке файла название переменной и ее значение, текст, после которого следуют строки с описанием переменных экземпляра документа (поле ввода «Начало документа») и текст, которым заканчивается описание переменных (поле ввода «Конец документа»).
После этого открываем файл: в список загрузятся переменные источника и, если все нормально, тогда загружаем переменные документа.
Дальнейшие действия аналогичны с действиями, описанными в разделе Создание настройки для файлов типа 1 данной инструкции.
В программе «Дебет Плюс V12» реализована возможность создания пользователем настройки, которая позволяет экспортировать платежи (PP) в dbf файл, который впоследствии может быть импортирован в систему «клиент-банк».
На этапе создания настройки используется образец dbf файла (приемник), на основе которого устанавливаются соответствия между полями файла и переменными документов (источника) внутренних платежных поручений (PP).
Основы создания настройки для экспорта платежей в систему «клиент-банк» смотрите в разделе Общие принципы создания настройки для импорта/экспорта платежей.
При вызове пункта контекстного меню «Добавить настройку на основе dbf файла» появляется следующее окно, в котором, используя кнопку «Открыть», загружается перечень полей dbf и их тип.
Определение соответствия между полями источника и приемника осуществляется с помощью стандартного редактирования строк списка, где в поле источника мы выбираем нужную переменную документа
Поле «Выражение» формируется автоматически либо пользователем на языке JavaScript, в зависимости от того, как должен быть преобразован тип поля источника.
Поля, которые не используются, оставляем пустыми, если есть поле, которое отвечает за тип документа, то указываем ему соответствующее значение, которое указано в описании полей системы «клиент-банк».
Если поле приемника является служебным и должно хранить какое-то предопределенное значение, тогда в форме редактирования поле «Переменная» оставляем пустым, а в поле «Выражение» указываем это значение. Если это значение текстовое либо числовое, но начинается с нуля, тогда это значение помещаем внутрь двойных либо одинарных кавычек.
Для нумерации строк документов используется глобальная переменная DOCNUMBER.
После сохранения настройки определяем основные параметры экспорта. В случае необходимости в созданную настройку можно внести изменения.
В программе «Дебет Плюс V12» реализована возможность создания пользователем настройки, которая позволяет экспортировать платежи (PP) в текстовый файл, который впоследствии может быть импортирован в систему «клиент-банк».
На этапе создания настройки используется образец текстового файла (приемник), на основе которого формируется перечень полей приемника и устанавливаются соответствия между полями приемника и переменными документов (источника) внутренних платежных поручений (PP). Наличие образца текстового файла не является обязательным, он лишь позволяет ускорить процесс создания настройки, перечень полей приемника можно создать вручную.
Основы создания настройки для экспорта платежей в систему «клиент-банк» смотрите в разделе Общие принципы создания настройки для импорта/экспорта платежей.
В названии настройки необходимо указать символы окончания строки в текстовом файле, вариантов два: либо это комбинация символов перевода каректи CR (‘\r’) и символа окончания строки LF (‘\n’) либо просто символ окончания строки LF.
Определение соответствия между полями источника и приемника осуществляется с помощью стандартного редактирования строк списка. Поле «Выражение» формируется автоматически либо пользователем на языке JavaScript.
Система позволяет экспортировать платежные поручения в текстовые файлы двух типов:
1. Файлы, в которых переменные документа записаны в одной строчке с помощью символа разделителя или наборов символов.
2. Файлы, в которых в одной строчке находится одна переменная документа.
При вызове пункта «Добавить настройку на основе текстового файла» появляется окно, в котором, с помощью выпадающего списка «Описание данных в файле» выбирается тип текстового файла. Рассмотрим более детально каждый из двух типов настройки.
Выбираем в выпадающем списке «Описание данных в файле» значение «переменные документа записаны в одной строчке с помощью разделителя». Выбираем кодировку, указываем символ или комбинацию символов разделителей в редактируемом выпадающем списке «Разделитель», если нужного символа в списке нет, тогда вводим его вручную.
Если есть необходимость, указываем заголовок файла – текст, который будет сэкспортирован перед основными строками данных.
Если имеется пример текстового файла, тогда с помощью кнопки «Открыть» выбираем его. В таком случае автоматически сформируется список с перечнем полей приемника в том порядке, в котором они встречаются в строке файла, а в колонке «Возможное значение» будет отображен пример значений переменных из файла.
Если примера текстового файла нет, тогда с помощью стандартного меню «Добавить» добавляем нужное количество строк равное количеству переменных в строке файла. Т. к. название переменных в файле не указывается, важен только порядок их следования, поэтому название поля приемника можно указывать любое, по умолчанию поле называется FIELD<индекс>.
Далее устанавливаем связи между полями приемника и источника с помощью редактирования строк, если мы добавляли записи вручную, то эти связи можно устанавливать сразу при добавлении.
Если поле приемника является служебным и должно хранить какое-то предопределенное значение, тогда в форме редактирования поле «Переменная» оставляем пустым, а в поле «Выражение» указываем это значение. Если это значение текстовое либо числовое, но начинается с нуля, тогда это значение помещаем внутрь двойных либо одинарных кавычек.
Для нумерации строк документов используется глобальная переменная DOCNUMBER.
Если в поле суммы указывается сумма в копейках, тогда в выражении необходимо домножить переменную HSUM на 100.
При выборе в источнике переменной типа даты, программа предложит указать в каком формате нужно преобразовать дату, если в выпадающем списке не окажется нужного формата, тогда его можно ввести вручную (см. пункт Параметры даты)
При необходимости порядок переменных в списке можно изменять с помощью контекстных меню: «Сместить на одну позицию вверх» или «Сместить на одну позицию вниз».
Выбираем в выпадающем списке «Описание данных в файле» значение «в одной строчке файла находится одна переменная документа». Выбираем кодировку, указываем символ (или комбинацию символов) разделителя между названием переменной в строке и ее значением в редактируемом выпадающем списке «Разделитель», если нужного символа в списке нет, тогда вводим его вручную.
Если требуется, указываем заголовок и конец файла в соответствующих полях формы. Также указываем в полях «Начало документа» и «Конец документа» текст, разграничивающий строки переменных одного экземпляра документа, если эти поля оставить пустыми, тогда строки переменных одного экземпляра документа будут отделяться пустыми строками.
Если имеется пример текстового файла, тогда с помощью кнопки «Открыть» выбираем его, в таком случае автоматически сформируется список с перечнем полей приемника. Если примера текстового файла нет, тогда с помощью стандартного меню «Добавить» добавляем строки, где в поле приемника вводим название переменной.
Далее устанавливаем связи между полями приемника и источника с помощью редактирования строк, если мы добавляли записи вручную, то эти связи можно устанавливать сразу при добавлении.
Особенности формирования связей смотри в разделе Создание настройки для файлов типа 1.
yyyy - четырехзначный год
yy - двузначный год
mm - месяц
dd - день
HH - часы
MM - минуты
SS - секунды
Выражения формируются программой автоматически, но если возникнет необходимость дополнительной обработки полей источника, то в таком случае можно писать свои выражения на языке JavaScript.
Если никаких преобразований над значением или типом поля источника не требуется, то значения поля источника и выражения совпадают.
В противном случае (только для импорта из dbf файлов) выражение начинается со знака «=», а перед именами полей источника ставится символ «^», все остальное – стандартный синтаксис JavaScript.
Пример: необходимо отсечь возможные пробелы в начале и в конце текстового поля МФО, тогда выражение будет иметь вид: =allt(^MFO).
Также можно писать свои функции и использовать их в выражении. Отлаживать функции удобно в скрипт консоли системы, которую можно открыть в меню «Сервис – JavaScript консоль».
Синтаксис выражения с использованием пользовательской функции будет следующим:
= <имя ф-ции> = function(<параметр1>, <параметр2>...) { <тело ф-ции> }, < имя ф-ции >(^<имя поля1>, ^<имя поля2>...)
Например, напишем функцию, которая будет отсекать пробелы с помощью стандартной функции allt и используем ее в выражении для МФО описанного ранее:
=MyFunc=function(val){return allt(val)},MyFunc(^MFO)
Данное выражение равносильно выражению:
=allt(^MFO)
Можно создать скрипт, в котором реализовать нужные функции и поместить его в папку JDebet/scripts или создать свой собственный модуль в папке JDebet/modules (например my_module) и разместить скрипт в папке JDebet/modules/my_module/scripts. Вариант с модулем более предпочтителен, т.к. исключается ситуация, когда при обновлении версии скрипт бизнес логики, совпадающий по имени с вашим скриптом его затрет.
Например мы создали скрипт my_script.js и описали в нем функцию:
function my_allt(val)
{
return allt(val);
}
Тогда в выражении подключаем наш скрипт и вызываем эту функцию следующим образом:
=MyFunc=function(val){include(my_script.js);
return my_allt(val)}, MyFunc(^MFO)
Если мы разместили скрипт в модуле, тогда подключаем ее следующим образом include(<имя модуля>:<имя скрипта>);
Т.е. выражение будет иметь вид:
=MyFunc=function(val){include(my_module:my_script.js);
return my_allt(val)}, MyFunc(^MFO)
