Скачать PDF

Требования к форматам xml файлов, используемых при информационном взаимодействии между органами Федерального казначейства и кредитными организациями в соответствии с Приказом Министерства финансов Российской Федерации от 31.12.2010 № 199н. Версия Требований 1.0

Федеральное казначейство · от 31.12.2010Утратил силу 31.12.2010

Актуально на 12.11.2026.

Как цитировать: "Требования к форматам xml файлов, используемых при информационном взаимодействии между органами Федерального казначейства и кредитными организациями в соответствии с Приказом Министерства финансов Российской Федерации от 31.12.2010 N 199н. Версия Требований 1.0". 31.12.2010. https://bukva.ai/docs/trebovaniya-k-formatam-xml-faylov-ispolzuemyh-2010

(утв. Казначейством России 13.05.2013)

Внимание

Документ фактически утратил силу в связи с изданием Приказа Минфина России от 17.09.2014 № 97н, отменившего с 1 января 2015 года Приказ Минфина России от 31.12.2010 № 199н.

Утверждаю
Заместитель руководителя
Федерального казначейства
С. Б. Гуральников

13 мая 2013 года

ТРЕБОВАНИЯ К ФОРМАТАМ XML ФАЙЛОВ, ИСПОЛЬЗУЕМЫХ ПРИ ИНФОРМАЦИОННОМ ВЗАИМОДЕЙСТВИИ МЕЖДУ ОРГАНАМИ ФЕДЕРАЛЬНОГО КАЗНАЧЕЙСТВА И КРЕДИТНЫМИ ОРГАНИЗАЦИЯМИ В СООТВЕТСТВИИ С ПРИКАЗОМ МИНИСТЕРСТВА ФИНАНСОВ РОССИЙСКОЙ ФЕДЕРАЦИИ ОТ 31.12.2010 № 199Н

ВЕРСИЯ ТРЕБОВАНИЙ 1.0

1. Введение

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

Документ предназначен для описания форматов xml файлов, используемых при информационном взаимодействии между Федеральным казначейством и кредитными организациями в соответствии с Приказом Министерства финансов Российской Федерации от 31.12.2010 № 199н.

1.2. Условные обозначения и сокращения

N Термин Содержание
1. GUID GloballyUniqueIdentifier — уникальный 128-битный идентификатор, представляется в виде строки из шестнадцатеричных цифр, разбитых на пять групп по 8, 4, 4, 4 и 12 символов соответственно, разделенных дефисами: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
2. XML Расширяемый язык разметки, предназначенный для хранения и обмена информацией в структурированном виде
3. БИК Банковский идентификационный код
4. КО Кредитная организация
5. ОрФК Органы Федерального казначейства — Федеральное казначейство и территориальные органы Федерального казначейства
6. ППО Прикладное программное обеспечение
7. Счет № 40116 Счет, открытый органу Федерального казначейства на балансовом счете № 40116 «Средства для выплаты наличных денег организациям» в Центральном банке Российской Федерации или определенных законодательством Российской Федерации кредитных организациях
8. ТОФК Территориальный орган Федерального казначейства. К территориальным органам Федерального казначейства относятся управления Федерального казначейства по субъектам Российской Федерации и подведомственные им — отделения управлений Федерального казначейства по субъектам Российской Федерации
9. ФК Федеральное казначейство
10. ЦАФК Центральный аппарат Федерального казначейства
11. ЭП ЭП (Электронная подпись) — Информация в электронной форме, которая присоединена к другой информации в электронной форме (подписываемой информации) или иным образом связана с такой информацией и которая используется для определения лица, подписывающего информацию

2. Описание формата обмена

Информационное взаимодействие между различными подсистемами АСФК осуществляется посредством обмена XML сообщениями. Формат входящих и исходящих сообщений соответствует стандарту Open Applications Group Integration Specification (OAGIS).

Каждое сообщение содержит один документ.

Каждый такой пересылаемый документ (документы) передается с сопровождающей его служебной информацией. Такая служебная информация называется конвертом.

Конверт представляет собой XML сообщение и дополнительные служебные атрибуты, которые служат для доставки сообщения адресату.

Сообщение формируется на расширенном стандарте OAGIS.

При этом выделяются следующие компоненты XML сообщения: - Business Object Document (BOD) — само XML сообщение - Корневой тег — Идентификатор формата сообщения (композиция); - Атрибут корневого тега — Версия формата сообщения; - Атрибут корневого тега — Программная среда (ASFK, BANK); - Атрибут корневого тега — Версия релиза ППО; - ApplicationArea — область описания служебных, управляющих полей: - Отправитель (набор атрибутов); - Дата отправления; - GUID сообщения (BODId) — (в отличие от GUID документа) логический уровень; - UserArea — расширения стандарта: - Получатель; - ФИО, должность пользователя, сформировавшего xml-сообщение

Приоритет — (1-100), рекомендательный параметр транспортной системе; - Тип сообщения — код типа сообщения; - Маркер документа; - Дополнительный параметр (не заполняется). - DataArea — область описания данных. В зависимости от типа сообщения может быть: документом, запросом, уведомлением, обновлением, отчетом, справочником, файлом и т.д. - Действие над объектом — «глагол» — Process, Sync, Load, и т.д. в соответствии с OAGIS. - Объект (структура описана в соответствующем подразделе ниже).

Уникальным идентификатором формата сообщения является композиция: Идентификатор формата сообщения + Версия формата сообщения.

3. Именование файлов

Xml-файлы используют единый принцип формирования имени файла: «VB_XXX_NNNN_YYYYMMDD_TTTTTT.xml»,

где:

VB — префикс, обозначающий принадлежность сформированного файла к подсистеме взаимодействия с банком;

XXX — три последних символа БИК банка;

NNNN — код ФК;

YYYYMMDD — дата формирования сообщения;

ТТТТТТ — время выгрузки xml-сообщения.

Например:

VB_043_6000_12012013_125647.xml, где

VB — префикс взаимодействия с банком;

043 — три последних символа БИК банка;

6000 — код ФК;

12012013 — это дата 12.01.2013;

125647 — это время 12:56:47.

4. Описание структуры XML

Ниже представлен пример структуры формата XML сообщений:

  <Sender>
     <LogicalID>123456789</LogicalID>
     <Role>BANK</Role>
  </Sender>
  <CreationDateTime>2013-03-06T16:39:25+04:00</CreationDateTime>
  <BODId>D741E154-BC2D-0090-E043-C0A800020090</BODId>
  <UserArea>
     <Group ID="Core">
       <Property name="RecipientLogicalID" value="6000"></Property>
       <Property name="Priority" value="0"></Property>
       <Property name="Role" value="ASFK"></Property>
       <Property name="MessageType" value="Document"></Property>
       <Property name="MessageCode" value="ИКД"></Property>
       <Property name="UserName" value="UserName"></Property>
     </Group>
  </UserArea>

Корневой тег RootTag — идентификатор формата сообщения. Вместе с версией (атрибут «versionID») представляет собой уникальный идентификатор формата области описания данных (DataArea).

  • ApplicationArea — постоянный, неизменный формат (для всех типов сообщений);
  • DataArea — переменный формат; зависит от типа сообщения.

Таблица 1

ПЕРЕЧЕНЬ
СТРУКТУР ДАННЫХ СООБЩЕНИЯ

Структура данныхОтносительный XPathОписаниеОсобенности заполнения
Сообщение<RootTag>Все XML сообщение — Busioness Object Document (BOD)ProcessInformationBank — значение корневого тега для документа «Информация об операциях клиента, совершаемых с использованием карт» ProcessDecryptOperations- Bank — «Расшифровка суммы средств, перечисленных на счет органа Федерального казначейства № 40116»
Служебные поля<RootTag>/ ния служебных,Область описауправляющих полей
Отправитель< / <RootTag>/ сообщения Sender>Отправитель
Расширения< / <RootTag>/ стандарта OAGIS UserArea>Расширения
Дополнительные параметры< / <RootTag>/ параметры UserArea>/<Group>Дополнительные
БизнесДанные<RootTag>/ <DataArea>Область описания данных

4.1. Правила формирования корневого тега сообщения (RootTag)

Корневой тег любого сообщения формируется по правилам OAGIS 9.0. Корневой тег состоит из глагола и существительного. Существительное представляет собой бизнес-объект, передающийся в сообщении. Глагол представляет собой действие с данным бизнес-объектом, которое явилось инициатором исходящего сообщения или которое необходимо выполнить по получению данного сообщения.

Таблица 2

ПЕРЕЧЕНЬ
АТРИБУТОВ КОРНЕВОГО ТЕГА

Атрибут XML-тега Формат Обязательность Описание Особенности заполнения
versionID String Да Версия формата сообщения Должна соответствовать версии данного документа в формате: «\d{3}.\d{2}»
systemEnvironmentCode String Да Программная среда (Допустимы значения «ASFK», «BANK») Заполняется значением ASFK или BANK, в зависимости от подсистемы, где сформирован xml-файл
releaseID String Да Версия релиза ППО

Таблица 3

ПЕРЕЧЕНЬ
ЭЛЕМЕНТОВ СТРУКТУРЫ «ОТПРАВИТЕЛЬ» (SENDER)

Элемент: имя XML-тега Формат Обязательность Описание Особенности заполнения
LogicalID String Да Адрес подсистемы отправителя сообщения Указывается БИК банка-отправителя или код ОрФК
Role String Да Роль отправителя Заполняется значением ASFK или BANK, в зависимости от подсистемы, где сформирован xml-файл

Таблица 4

ПЕРЕЧЕНЬ
ЭЛЕМЕНТОВ СТРУКТУРЫ «СЛУЖЕБНЫЕ ПОЛЯ»

Элемент: имя XML-тега Формат Обязательность Описание Особенности заполнения
Creation- DateTime YYYY-MM-DDThh:mm: ss(+|-)hh:mm (xsd:dateTime) Да Дата-время отправления в формате xsd:dateTime. Например, 2013-01-10T12:40:10-03:00 Дата и время формирования xml-сообщения
BODId String Да GUID сообщения

Таблица 5

ПЕРЕЧЕНЬ
ЭЛЕМЕНТОВ СТРУКТУРЫ «CROUP» «CORE»

Элемент: имя XML-тега Формат Обязательность Описание Особенности заполнения
Recipient- LogicalID Xs:String Да Транспортная маска получателя Указывается адрес подсистемы получателя сообщения: БИК банка или код ОрФК
Priority Xs:String Да Всегда заполнять значением «255»
Role Xs:String Да Роль получателя Заполняется значением ASFK или BANK, в зависимости от подсистемы, где сформирован xml-файл
MessageType Xs:String Да Тип перевозимой сущности. Report — отчет. Document — документ
MessageCode Xs:String Да Маркер документа Возможные значения: ИКД — для «Информация об операциях клиента, совершаемых с использованием карт»; РСН — для «Расшифровка суммы средств, перечисленных на счет органа Федерального казначейства № 40116»
UserName xs:String Да ФИО, должность пользователя, сформировавшего xml-сообщение

5. ОБЩИЕ АТРИБУТЫ СТРУКТУРЫ «БИЗНЕС ДАННЫЕ» (DATA AREA)

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

Таблица 6

АТРИБУТЫ СТРУКТУРЫ «БИЗНЕС ДАННЫЕ»

Родительский тегТекущий тегТипРазмерностьОбязательностьНаименование атрибутаПримечание
<Data Area><Process>Xs:stringДаВид операции, выполняемой над документомЗаполняется Process — новый документ
<Data Area><Header>Да
<Header><DocGUID>GuidType= 36ДаGUID отчета
<Header><DocType- Code>CodeForm- Type= 3ДаМаркер документаВозможные значения: ИКД — для «Информация об операциях клиента, совершаемых с использованием карт»; РСН — для «Расшифровка суммы средств, перечисленных на счет органа Федерального казначейства № 40116»
<Header><DocBudget- Code>Xs:string= 8НетНомер бюджета
<Header><DocBusiness- Status>Xs:string= 3НетБизнесстатус. Указывается пустой тег
<Header><DocApproval- Status>Xs:string= 3НетСтатус утверждения. Указывается пустой тег
<Header><DocTransfer- Status>Xs:string= 3НетСтатус передачи. Указывается пустой тег
<Header><DocTofkCode>Xs:string= 4НетКод ТОФК, где сформирован отчет. Указывается пустой тег
<Header><DocSegment- Code>Xs:string= 1НетПризнак секретности отчета. Указывается пустой тег
<Header><CreateDate- Time>Xs:date- TimeДаДата и время формирования отчета
<Header><CMS>ПодуровеньНетЭлектронная подпись отчета. Указываются пустые теги
<CMS><Version>Xs:stringНетВерсия структуры ЭП
<CMS><Digital- Signature>Xs:stringНетЭП документа (base64)
<Header>Под-Нет уровеньВложенияпользователя к документу
<FileBody>Xs:stringНетНепосред-ственно вложение (в base64 кодировке). Если вложения нет, то указываются пустые теги
<File-DXs:string escription1 >-НетОпис 4000аниефайла вложения
<FileName>Xs:string1-НетИмя 255файлавложения
<FileContent- TXs:string ype>1-НетТип 100контента, например: image/jpeg

5.1. Атрибуты структуры «Бизнес Данные» Расшифровки суммы средств, перечисленных на счет органа Федерального казначейства № 40116

В таблице 7 приведен перечень атрибутов Расшифровки суммы средств, перечисленных на счет органа Федерального казначейства № 40116. Столбец «Обязательность» указывает обязательность или необязательность значения в теге, но тег сам обязателен, кроме случаев, когда указывается необязательность значения тега, содержащего в себе другие теги. Если значения отсутствуют, вложенные теги не указываются.

Таблица 7

«БИЗНЕС ДАННЫЕ» РАСШИФРОВКИ СУММЫ СРЕДСТВ, ПЕРЕЧИСЛЕННЫХ
НА СЧЕТ ОРГАНА ФЕДЕРАЛЬНОГО КАЗНАЧЕЙСТВА № 40116

Родительский тег Текущий тег Наименование атрибута Тип Размерность Обязательность Примечание 




Реквизиты платежного документа


Да






Номер платежного документа
xs:string
1 — 3
Да







Дата платежного документа
xs:date

Да







Сумма платежного документа
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}









Да







Пополняемые карточные счета

1 — N
Да







Номер корпоративной карты
xs:string
1 — 20
Да










Да







Фамилия представителя клиента, на имя которого оформлена банковская карта
xs:string
1 — 40
Нет







Имя представителя клиента, на имя которого оформлена банковская карта
xs:string
1 — 20
Нет







Отчество представителя клиента, на имя которого оформлена банковская карта
xs:string
1 — 30
Нет







Код валюты
xs:string
= 3
Да







Сумма операции
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






5.2. Пример xsd-схемы Расшифровки суммы средств, перечисленных на счет органа Федерального казначейства № 40116


?xml version=«1.0» encoding=«UTF-8»?>


<!-Sample XML file generated by XMLSpy v2011 rel. 2
(http://www.altova.com)->


      


         String


         String


      


      String


      String


      


         


           


           


           


           


           


           


         


      


    


    


      text


      


         String


         String


         String


         String


         String


         String


         String


         String


         


           String


         


           String


           String


           String


           String


         


         


           *ЗПН6000/12-8773


           1967-08-13


           50.0


           


             


               5402320017453623


               


                 Семенов


                 Иван


                 Федерович


               


               840


               50.0


             


           


         


      


    




5.3. Атрибуты структуры «Бизнес Данные» Информации об операциях клиентов, совершаемых с использованием банковских карт


В таблице 8 приведен перечень атрибутов «Информации об операциях клиентов, совершаемых с использованием банковских карт». Столбец «Обязательность» указывает обязательность или необязательность значения в теге, но тег сам обязателен, кроме случаев, когда указывается необязательность значения тега, содержащего в себе другие теги. Если значения отсутствуют, вложенные теги не указываются.




Таблица 8






«БИЗНЕС ДАННЫЕ» ИНФОРМАЦИЯ ОБ ОПЕРАЦИЯХ КЛИЕНТОВ,

СОВЕРШАЕМЫХ С ИСПОЛЬЗОВАНИЕМ БАНКОВСКИХ КАРТ








Родительский тег
Текущий тег
Наименование атрибута
Тип
Размерность
Обязательность
Примечание











Общая часть информации об операциях клиентов


Да






Уникальный номер документа в течение операционного дня, присвоенный банком
xs:string
1 — 30
Да







Дата операций текущего операционного дня
xs:date

Да







БИК банка, предоставившего документ, в соответствии со Справочником банковских идентификационных кодов участников расчетов. (Справочник БИК России)
xs:string
= 9
Да







Наименование банка, предоставившего документ
xs:string
1 — 160
Да







Наименование клиента ОрФК, уполномоченные сотрудники которого обслуживаются по картам, выданным банком, предоставившим документ
xs:string
1 — 2000
Да
Соответствует ИНН и КПП (в случае его указания)






Код клиента ОрФК по Сводному реестру
xs:string
= 5
Нет
Может указываться для клиентов ФБ








ИНН клиента ОрФК
xs:string
= 10
Да






КПП клиента ОрФК
xs:string
= 9
Да







Полное или сокращенное наименование ОрФК
xs:string
1 — 2000
Да







Код ОрФК
xs:string
= 4
Нет









1 — N
Да
Данные по картам






Номер банковской карты
xs:string
1 — 20
Да
Номер банковской карты, по которой совершены операции, выданной клиенту, указанному в блоке «Основная часть»










1 — N
Да






Полный номер платежного поручения, по которому банком была проведена операция списания или зачисления с использованием банковской карты
xs:string
1 — 9
Да







Уникальный полный номер платежного поручения в течение операционного дня, присвоенный документу банком
xs:string
= 10








Дата платежного поручения, по которому банком была проведена операция списания или зачисления с использованием банковской карты
xs:date

Да







Вид операции, совершенной по карте
xs:string
= 2
Да
Возможен выбор из выпадающего списка (системное перечисление): «01» — зачисление; «02» — списание; «03» — получение наличных денег; «04» — взнос наличных денег; «05» — оплата расходов; «06» — комиссионное вознаграждение; «07» — завершение расчетов






Сумма зачислений по соответствующей карте
xs:string

Да
Обязательно при указании вида операций: «01» — зачисление; «04» — взнос наличных денег. Для остальных видов операций всегда указывается «0.00». Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма списаний по соответствующей карте
xs:string
1 — N
Да
Обязательно при указании вида операции: «02» — списание; «03» — получение наличных денег; «05» — оплата расходов; «06» — комиссионное вознаграждение; «07» — завершение расчетов. Для остальных видов операций всегда указывается «0.00». Формат вида {0,1}\d{1,18}.\d{1,2}






Изменение остатка зарезервированных сумм
xs:string

Да
Если операции по расчетам завершены, то указывается сумма уменьшения зарезервированных сумм со знаком «-». Если совершена операция, расчеты по которой не завершены, то указывается зарезервированная сумма со знаком «+». Формат вида {0,1}\d{1,18}.\d{1,2}






Расчетный счет плательщика
xs:string
= 20
Да
Полный номер расчетного счета плательщика. В случае детализации операции списания указывается номер расчетного счета плательщика, операцию списания по которому детализирует строка документа. Указывается расчетный счет плательщика № 40116, на котором обслуживается банковская карта клиента






Расчетный счет получателя
xs:string
= 20
Да
Полный номер расчетного счета получателя. В случае детализации операции зачисления указывается номер расчетного счета получателя, поступления по которому детализирует строка документа. Указывается расчетный счет получателя № 40116, на котором обслуживается банковская карта клиента








Наименование контрагента, наименование организацииконтрагента, с которой клиент осуществлял расчеты с использованием карты, наименование и места расположения пункта выдачи наличных денег, банкомата, терминала или другого технического устройства
xs:string
1 — 2000
Нет






Реквизиты контрагента, идентификатор банкомата, электронного терминала или другого технического устройства, предназначенного для совершения операций с использованием карт
xs:string
1 — 2000
Нет







Всего доступных средств на начало дня на банковской карте клиента (с учетом зарезервированных и доступных к использованию)
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма зарезервированных средств на начало дня по банковской карте клиента
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма доступных средств к использованию на начало дня по банковской карте
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего зачислено по соответствующей банковской карте за день
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего списано с соответствующей банковской карты за день
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Изменение общего остатка зарезервированных сумм по карте за день
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}




<CardData-
<AllSumEnd-
Всего доступных
xs:string

Да
Формат вида




Line>
DayCard>
средств на конец дня по банковской карте клиента (с учетом зарезервированных и доступных к использованию)



{0,1}\d{1,18}.\d{1,2}






Сумма зарезервированных средств на конец дня на банковской карте клиента
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма доступных средств к использованию на конец дня на банковской карте клиента
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего доступных средств на начало дня по документу (с учетом зарезервированных и доступных к использованию)
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма зарезервированных средств на начало дня по документу
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма доступных средств к использованию на начало дня по документу
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего зачисленных средств по всем операциям клиента за день (общая сумма поступлений по всем картам клиента)
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего списанных средств по всем операциям клиента за день (общая сумма списаний по всем картам клиента)
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Изменение общего остатка зарезервированных сумм за день. Соответствует итоговым данным по картам на вкладке «Данные по картам»
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Всего доступных средств на конец дня по документу (с учетом зарезервированных и доступных к использованию)
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма зарезервированных средств на конец дня по документу
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






Сумма доступных средств к использованию на конец дня по документу
xs:string

Да
Формат вида {0,1}\d{1,18}.\d{1,2}






5.4. Пример xsd-схемы Информации об операциях клиентов, совершаемых с использованием банковских карт




<!-Sample XML file generated by XMLSpy v2011 rel. 2
(http://www.altova.com)->


      


        String


        String


      


      String


      String


      


        


          


          


          


          


          


          


        


      


    


    


      text


      


        String


        String


        String


        String


        String


        String


        String


        String


        


          String


          String


        


          String


          String


          String


          String


        


        


1


          1967-08-13


          044525187


          JSC VTB Bank


          Министерство промышленности и торговли РФ


          00020


          7705596339


          770501001


          Управление Федерального казначейства по г. Москве


          7300


          


            9876543234567890


            


              13


              aaaaaaaaaa


              1967-08-13


              02


              50.0


              30.0


              20.0


              aaaaaaaaaaaaaaaaaaaa


              aaaaaaaaaaaaaaaaaaaa


              a


              a


            


            0.0


            0.0


            0.0


            0.0


            0.0


            0.0


            0.0


            0.0


            0.0


          


          0.0


          0.0


          0.0


          0.0


          0.0


          0.0


          0.0


          0.0


          0.0