Cтруктура текстового файла формата LITAS – ESI

Форматы

* – обязательное поле
C – символьное поле
YYYY – четырехзначное число года
MM – двухзначное число (обязательно) месяца
DD – двухзначное число (обязательно) дня
N – цифровое поле

Примечания Общие требования
  • cледует указывать максимальную длину поля;
  • каждое поле отделяется при помощи TAB (# 9);
  • расширение файла зависит от типа документа (название не имеет значения);
  • информация одного поручения должна умещаться в одну строку;
  • код валюты по стандартам ISO (например, EUR);
  • в тексте используется таблица кодов Windows 1257.

Структура формы местного платежного поручения

Расширение файла должно быть mokesis (название не имеет значения). Например, переводы.mokesis..

Пор. № Наименование Размер Примечания
1 Номер C10* Номер платежного поручения
2 Дата C8 Формат: YYYYMMDD
3 Дата выполнения банковской операции C8* Формат: YYYYMMDD
4 Тип платежа (приоритет) N1* Возможные значения:
1 – стандартный
2 – срочный
5 Номер счета плательщика C35* Номер счета плательщика в формате IBAN
6 Имя, фамилия/Наименование плательщика C200 Наименование плательщика
7 Личный код/Регистрационный номер плательщика C11 Личный код (код юридического лица) плательщика
8 Кредитная организация плательщика C11 Формат BIC
9 Код клиента в информационной системе получателя C16 Код, установленный плательщиком и получателем, на основании которого получатель может идентифицировать плательщика
10 Номер счета первоначального плательщика C35 Номер счета первоначального плательщика
11 Имя, фамилия/Наименование первоначального плательщика C140 Имя, фамилия или наименование первоначального плательщика
12 Личный код/регистрационный номер первоначального плательщика C11 Личный код (код юридического лица) первоначального плательщика
13 Номер счета получателя C35* Номер счета получателя в формате IBAN
14 Имя, фамилия/Наименование получателя C200* Наименование получателя
15 Личный код/Регистрационный номер получателя C11 Личный код (код юридического лица) получателя
16 Кредитная организация получателя C11 Формат BIC
17 Код клиента в информационной системе плательщика C16 Код, установленный плательщиком и получателем, на основании которого плательщик может идентифицировать получателя
18 Номер счета конечного получателя C35 Номер счета конечного получателя
19 Имя, фамилия/Наименование конечного получателя C140 Имя, фамилия или наименование конечного получателя
20 Личный код/Регистрационный номер конечного получателя C11 Личный код (код юридического лица) конечного получателя
21 Сумма N14* Центы не разделяются точкой или запятой. Вместо 50,25 следует указать 5025
22 Код валюты C3* Код валюты по стандартам ISO
23 Код платежа C28 Указанный клиентом код платежа
24 Назначение платежа C300* Указанное клиентом назначение платежа
25 Код архива C50 Код, выдаваемый кредитной организацией для каждой операции. Только для экспорта

Структура импорта формы международного платежного поручения

Расширение файла должно быть taresis (название не имеет значения). Например, международные.taresis.

Пор. № Наименование Размер Примечания
1 Номер C10* Номер платежного поручения
2 Дата C8 Формат: YYYYMMDD
3 Дата выполнения банковской операции N6 Формат: YYYYMMDD
4 Тип платежа (приоритет) N1* Возможные значения:
1 – стандартный
2 – срочный
3 – очень срочный
5 Валюта C3* Код валюты по стандартам ISO
6 Дебетовая валюта C3 В Интернете не используется
7 Сумма N14* Центы не разделяются точкой или запятой. Вместо 50,25 следует указать 5025
8 Счет плательщика C35* Счет плательщика
9 BIC кредитной организации, по просьбе которой выполняется перевод C11 -
10 S.W.I.F.T. банка корреспондента C11 Код S.W.I.F.T. банка-корреспондента Пишется заглавными буквами. Размер - 8 или 11 символов
11 Банковский счет получателя в банке-корреспонденте C34 Счет банка-корреспондента
12 Наименование банка корреспондента 1 C35 Наименование банка-корреспондента
13 Наименование банка корреспондента 2 C35 Наименование банка-корреспондента
14 Адрес банка корреспондента 1 C35 Адрес банка-корреспондента
15 Адрес банка корреспондента 2 C35 Адрес банка-корреспондента
16 S.W.I.F.T. банка получателя C11 Код S.W.I.F.T. банка. Пишется заглавными буквами. Размер - 8 или 11 символов
17 Код банка получателя C34 -
18 Наименование банка получателя 1 C35* Наименование банка получателя вводится в символьные поля 2х35
19 Наименование банка получателя 2 C35 -
20 Адрес банка получателя 1 C35 Адрес банка вводится в символьные поля 2х35
21 Адрес банка получателя 2 C35 -
22 Счет получателя C35* Счет получателя
23 Наименование получателя C35* Наименование получателя вводится в символьные поля 2х35
24 Наименование получателя 2 C35 -
25 Адрес получателя 1 C35* Адрес получателя вводится в символьные поля 2х35
26 Адрес получателя 2 C35 -
27 Особенности платежа 1 C35 Назначение платежа. Вводится в символьные поля 2х35
28 Особенности платежа 2 C35 -
29 Особенности платежа 3 C35 -
30 Особенности платежа 4 C35 -
31 Плата, взимаемая зарубежным банком C1* Возможные значения:
1 – только плательщик
2 – и плательщик, и получатель
3 – только получатель
32 Уведомить получателя по телексу C1 Возможные значения:
0 – не уведомлять
1 – уведомить
33 Уведомить получателя по телефону C1 Возможные значения:
0 – не уведомлять
1 – уведомить
34 Телефон для уведомления C20 -
35 Счет для комиссионных сборов C20* -
36 Буквенный код валюты счета комиссионных сборов C3* -
37 SWIFT банка-посредника C11 В Интернете не используется
38 Наименование банка-посредника C70 В Интернете не используется
39 Счет банка-посредника C35 В Интернете не используется
40 Код архива C50 В Интернете не используется

Описание формата FiDAViSta

Подготовленный в формате FiDAViSta файл может состоять из нескольких частей, которые объединены под элементом единого кластера (Root) с названием поля FIDAVISTA. В этом Root элементе предоставляется также ссылка на местонахождение схемы XML, где указанный файл заканчивается 4-значным порядковым номером версии. Возможными группами в кластере полей являются:

  • Заголовок – группа полей заголовка, которая содержит информацию о создателе файла и времени создания файла.
  • Statement – группа полей выписки счета, которая используется для сохранения данных выписок из банковского счета или информации отчета счета. (скоро будет доступно).
  • PmtStat – кластер статуса платежей, который хранит информацию о статусах платежей на основании ранее указанных идентификаторов. (скоро будет доступно)
  • Платежи – группа полей платежа, в которой хранится информация о платежах (местные, взносы в бюджет, международные, выплаты зарплат и пр.).

Заголовок

Пометка Длина Тип O/M Описание
Мин Макс
Header
Timestamp
17 17 xs:string O Время создания файла, в формате YYYYMMDDHHMMSSsss
From 0 70 xs:string O Идентификатор создателя
Extension
Header
- - ExtensionType O Поле для расположения дополнительных элементов.

платежей

Пометка Длина Тип O/M Описание
Мин Макс
PmtStat
ExtId
0 10 SwiftStringType O Ссылка на идентификатор платежа (идентификатор платежа, указанный в платеже)
BenExtId 0 5 SwiftStringType O Ссылка на идентификатор платежа (идентификатор платежа, указанный в платеже)
BankRef 0 25 xs:string O Банковская ссылка
DocNo 1 10 xs:string M Номер платежа/документа
StatCode 1 1 xs:string M Код статуса платежа:
E – выполнен, т.е. учтён
R – отменён
P – обрабатывается
O – другой статус
InfoToCustomer 0 70 xs:string O Объяснение статуса платежа/сообщение об ошибке
BookDate 10 10 xs:date O Дата выполнения платежа (только для выполненных платежей). Формат YYYY-MM-DD
RegDate 10 10 xs:date O Дата регистрации платежного поручения – такая же, как указана в “Payment”.
Формат YYYY-MM-DD
Extension
PmtStat
- - ExtensionType O Поле для расположения дополнительных элементов

Платежи

Пометка Длина Тип O/M Описание
Мин Maкс
Payment ExtId 0 10 SwiftStringType O Уникальный идентификатор платежа во «внешней» (бухгалтерской) системе. По данному идентификатору производятся запросы “PmtStat”. И по файлу “Statement” данного идентификатора можно будет найти связь учета с экспортируемым платежным поручением
DocNo 1 10 SwiftStringType M Номер платежа/документа. Его присваивает пользователь в системе бухгалтерского учета
RegDate 10 10 xs:date O Дата регистрации платежного поручения в системе бухгалтерского учета. Формат YYYY-MM-DD. Экспортируя “PmtStat” за период из банковской системы, отбор производится по данному полю
TaxPmtFlg 1 1 xs:string
Default: “N”
M Признак, указывающий на то, является ли платеж платежом налогов. Возможные показатели:
“Y” – Платеж налогов
“N”- “простой“ платеж
Ccy 3 3 CurrencyType M Валюта платежа
PmtInfo 0 140 EksStringType O Детали платежа (информация получателю)
BankInfo 0 140 xs:string O Информация банку
PayLegalId 0 20 LegalIDType O Регистрационный номер плательщика, персональный код, или код налогоплательщика.
В случае платежа налогов содержание этого поля, если заполнено, будет отослано как код налогоплательщика
PayAccNo 1 34 AccountMType M Номер счета плательщика
PaySubAccNo 0 34 AccountOType O Номер субсчета плательщка
DebitCcy 3 3 CurrencyType O Дебетируемая валюта.
Если это поле не заполнено, банк считает, что содержание данного поля по умолчанию является:
- в случае счета одной валюты - валютой счета.
- в случае мультивалютного счета – валютой платежа.
Если в случае мультивалютного счета не открыта позиция в валюте платежа, она интерпретируется по усмотрению банка.
Чтобы избежать недоразумений, желательно заполнить это поле
BenSet - - - M Данные получателя платежа
BenExtId 0 5 SwiftStringType O Уникальный идентификатор получателя в рамках платежного поручения. Рекомендуется заполнить в случае “Mass payment”.
По данному полю бухгалтерская система сможет идентифицировать платеж в других файлах (“Payment status”, “Statement”)
Priority 1 1 xs:string
“N” / “U” / “X”
Default = “N”
M Приоритет платежа:
N – Нормальный
U – Срочный
X – Экспресс
Показатель по умолчанию: N
Для местных платежей в Латвийских латах предлагается выбор “N” и “U”
Comm 3 3 xs:string
“OUR” / “BEN” /
“SHA”
Default = “OUR”
M Тип комиссии:
OUR – плательщик,
BEN - получатель,
SHA - раздельный.
Показатель по умолчанию: OUR
Amt 1 12 AmountType M Сумма платежа. Десятичная часть отделена точкой ’.’
BenAccNo 0 34 AccountOType O Номер счета получателя
BenSubAccNo 0 34 AccountOType O Субсчет получателя
BenAccIbanFlg 0 1 xs:string
“Y” / “N”
Default = “N”
O Примета IBAN счета получателя
“Y” – Банковская программа должна произвести проверку контрольной суммы номера счета в соответствии с международным стандартом IBAN.
Если показателем данного поля является «Y», то содержание поля игнорируется
BenName 1 105 EksStringType M Название получателя
BenLegalId 0 20 LegalIDType O Регистрационный номер плательщика, код налогоплательщика или персональный код
BenAddress 0 70 EksStringType O Адрес получателя
BenCountry 2 2 CountryType M Код государства, в котором зарегистрирован получатель. Например: LV, EE, US, и пр. ISO-3166
BBName 0 35 EksStringType O Название банка получателя
BBAddress 0 70 EksStringType O Адрес банка получателя
BBSwift 8 11 SWIFTType O SWIFT код банка получателя или BIC код Банка Латвии
BBCode 0 66 BankCodeType O Банковский код получателя. У данного поля имеется обязательно заполняемый атрибут CodeType – тип кода
CBAcc 0 34 AccountOType O Корсчет банка получателя в банке посреднике
CBName 0 35 EksStringType O Название банка посредника
CBSwift 8 11 SWIFTType O SWIFT код банка посредника
CBCode 0 66 BankCodeType O Код банка посредника. У данного поля имеется обязательно заполняемый атрибут CodeType – тип кода
BudgCode 0 10 SwiftStringType O Код бюджетного поступления
AmkSet - - - O Внешний код платежа
Opc 1 3 xs:string M AMK (балансовый) код; только цифры [0-9]
Amt
AmkSet
1 12 AmountType O AMK (балансовая) сумма кода. Десятая часть отделена точкой ’.’
Extension
BenSet
- - ExtensionType O Поле для расположения дополнительных элементов
Extension
Payment
- - ExtensionType O Поле для расположения дополнительных элементов

Типы полей

Тип Длина Разрешенные символы Описание
Mин Maкс
xs:string 0 - XML стандартный тип для unicode текста
xs:date 10 10 0-9|- XML стандартный тип для даты
Формат: YYYY-MM-DD
BankCodeType - - 0-9|A-Z|a-z|s/-?:().,'+nr Производное от SwiftString.
Присоединенный атрибут, CodeType, тип которого SwiftString. Атрибут обязателен
ExtensionType 0 - Предназначен для расположения любых стандартных, не включенных элементов
AccountMType 1 34 0-9|A-Z|a-z|s/-?:().,'+nr Производное от SwiftString. Наложено ограничение длины
AccountOType 0 34 0-9|A-Z|a-z|s/-?:().,'+nr Производное от SwiftString. Наложено ограничение длины
AmountType 1 12 0-9|. Производное от xs:decimal.
Наложено ограничение: всего 12 знаков, 2 из которых находятся за отделительной децимальной точкой
CurrencyType 3 3 A-Z Производное от xs:string
EksStringType - - 0-9|A-Z|a-z|a-ž|A-Ž|s/-?:().,'+nr Производное от xs:string. Ограничены разрешенные символы, в соответствии с ограничениями Электронной клиринговой системы Банка Латвии (для xl кластера символов) и строчные буквы латышского и латинского алфавита
LegalIDType 0 20 0-9|A-Z|a-z|s/-?:().,'+nr Производное от SwiftString. Наложено ограничение длины
SWIFTType 8 11 A-Z|0-9 Предназначен для SWIFT кода, в соответствии со SWIFT стандартом
SwiftStringType - - 0-9|A-Z|a-z|s/-?:().,'+nr Производное от xs:string. Разрешенные символы – разрешены символы, которые соответствуют кластеру символов SWIFT X, кроме “{“и “}” и строчные буквы латинского алфавита

Формат XML (pain.001.001.03)

Клиентом инициируемое сообщение кредитного перевода отправляется в банк плательщика с просьбой списать средства со счета плательщика и перевести их на счет получателя. Сообщение может также использоваться кредитный перевод инициирующей стороной, имеющей обязательство отправить платежное поручение от имени плательщика. Банком предоставляемое сообщение выписки со счета отправляется владельцу счета, предоставляя все на счету осуществленные операции за выбранный промежуток времени.

Каждый элемент сообщения кредитного перевода основан на определениях элементов сообщения стандарта ISO20022 XML „pain.001.001.03“ (CustomerCreditTransferInitiationV03), подробное описание которых предоставляется по адресу: http://www.iso20022.org/documents/general/Payments_Maintenance_2009.zip .

Описание элементов сообщения можно найти здесь .

Пример файла .xml можно найти здесь .

Набор символов

Набор символов это сбор знаков, которые можно использовать в элементах сообщений. Сообщения ISO 20022 XML адаптированы к многоязычной среде. Для кодирования знаков используется UTF-8. Банки и их клиенты обязаны поддерживать набор латинских символов, который широко используется в международной коммуникации. Во всех клиринговых палатах, отвечающих требованиям SEPA, дозволяются следующие знаки:

a b c d e f g h i j k l m n o p q r s t u v w x y z
A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
0 1 2 3 4 5 6 7 8 9
/ - ? : ( ) . , ‘ + Пробел

Все остальные символы кодирования UTF-8 в отправляемых и получаемых платежах конвертируются в соответствии с таблицей конвертирования, рекомендуемой ЕПС, которая соответствует лучшим практикам: https://www.europeanpaymentscouncil.eu/document-library/guidance-documents/sepa-requirements-extended-character-set-unicode-subset-best .

Структура сообщений

Документ XML описывается схемой, написанной на специфическом языке XSD (англ. XML Schema Definition). Данные схемы описывают теги документа (XML Tag), их структуру и порядок. Они также могут указать коды, которые дозволяются только для некоторых данных, обязательны ли данные или не, количество возможных случаев (или повторов), и т.д.

Общая схема XSD для сообщения кредитного перевода pain.001.001.03 предоставляется по адресу: http://www.iso20022.org/documents/messages/pain/schemas/pain.001.001.03.zip .

Структура файла данных, содержащего сообщение pain.001.001.03, следующая:

<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03 pain.001.001.03.xsd">
   <!-- Содержание сообщения -->
</Document>
                    

Файл документов должен содержать только один тег с единственным сообщением XML, за исключением если поставщик услуг и клиент договорились иначе.

Содержание сообщения следующее:

  • A. Group Header. Данный блок обязателен и не может повторяться. Он содержит совокупность черт, общих для всех отдельных операций в данном сообщении (напр. дата и время создания сообщения, количество операций в сообщении и т.д.).
  • B. Payment Information. Данный блок обязателен и может повторяться. Он содержит набор черт дебетовой платежных операций, который указывается во время инициации платежного перевода (напр. название плательщика, тип операции и т.п.).
  • C. Transaction Information. Данный блок обязателен и может повторяться. Содержит набор элементов, используемый для предоставления информации о отдельной операции в сообщении. Здесь указывается получатель, назначение платежа и .т.д.

Количество блоков Payment Information и Transaction Information указывается в блоке Group Header.