УТВЕРЖДЕН |
распоряжением министерства промышленной политики и лесного комплекса Иркутской области |
от «__» _____ 2013 г. |
№ ______________ |
Формат представления ежемесячной декларации о принятой, переработанной и отгруженной древесине в форме электронного документа
1. ОБЩИЕ положения
1.1. Настоящий формат описывает требования к xml файлам (далее – файлам обмена) передачи в электронной форме ежемесячной декларации о принятой, переработанной и отгруженной древесине в министерство промышленной политики и лесного комплекса Иркутской области.
1.2. Настоящий формат разработан в соответствии с Законом Иркутской области от 18 октября 2010 года «Об организации деятельности пунктов приема и отгрузки древесины на территории Иркутской области».
2. ОПИСАНИЕ ФАЙЛА ОБМЕНА
2.1. Имя файла обмена задается произвольно. Расширение имени файла – xml. Расширение имени файла может указываться как строчными, так и прописными буквами.
2.2. Первая строка XML файла должна иметь следующий вид: <?xml version="1.0" encoding="UTF-8"?> Кодировка XML файла должна быть UTF-8.
2.3. Логическая модель файла обмена представлена в виде диаграммы структуры файла обмена на рисунке 1 настоящего формата. Элементами логической модели файла обмена являются элементы и атрибуты XML файла. Перечень структурных элементов логической модели файла обмена и сведения о них приведены в таблицах 2.1-2.9 настоящего формата.
2.4. Для каждого структурного элемента логической модели файла обмена приводятся следующие сведения:
- наименование элемента. Приводится полное наименование элемента;
- сокращенное наименование (код) элемента. Приводится сокращенное наименование элемента. Синтаксис сокращенного наименования должен удовлетворять спецификации XML;
- признак типа элемента. Может принимать следующие значения: «С» – сложный элемент логической модели (содержит вложенные элементы), «П» – простой элемент логической модели, реализованный в виде элемента XML файла, «А» – простой элемент логической модели, реализованный в виде атрибута элемента XML файла. Простой элемент логической модели не содержит вложенные элементы;
- формат элемента. Формат элемента представляется следующими условными обозначениями: Т – символьная строка; N – числовое значение (целое или дробное).
2.5. Формат символьной строки указывается в виде Т(n-к) или T(=к), где: n – минимальное количество знаков, к – максимальное количество знаков, символ «-» – разделитель, символ «=» означает фиксированное количество знаков в строке. В случае, если минимальное количество знаков равно 0, формат имеет вид Т(0-к). В случае, если максимальное количество знаков неограниченно, формат имеет вид Т(n-).
2.6. Формат числового значения указывается в виде N(m. к), где: m – максимальное количество знаков в числе, включая знак (для отрицательного числа), целую и дробную часть числа без разделяющей десятичной точки, k – максимальное число знаков дробной части числа. Если число знаков дробной части числа равно 0 (т. е. число целое), то формат числового значения имеет вид N(m).
2.7. Для простых элементов, являющихся базовыми в XML (определенными в http://www. w3.org/TR/xmlschema-0), например, элемент с типом «date», поле «Формат элемента» не заполняется. Для таких элементов в поле «Дополнительная информация» указывается тип базового элемента:
- признак обязательности элемента определяет обязательность присутствия элемента (совокупности наименования элемента и его значения) в файле обмена. Признак обязательности элемента может принимать следующие значения: «О» – наличие элемента в файле обмена обязательно; «Н» – наличие элемента в файле обмена необязательно, т. е. элемент может отсутствовать. Если элемент принимает ограниченный перечень значений (по классификатору, кодовому словарю и т. п.), то признак обязательности элемента дополняется символом «К». Например: «ОК». В случае, если количество реализаций элемента может быть более одной, то признак обязательности элемента дополняется символом «М». Например: «НМ», «ОКМ». К вышеперечисленным признакам обязательности элемента может добавляться значение «У» в случае описания в XML схеме условий, предъявляемых к элементу в файле обмена, описанных в графе «Дополнительная информация». Например: «НУ», «ОКУ»;
- дополнительная информация содержит, при необходимости, требования к элементу файла обмена, не указанные ранее. Для сложных элементов указывается ссылка на таблицу, в которой описывается состав данного элемента. Для элементов, принимающих ограниченный перечень значений из классификатора (кодового словаря и т. п.), указывается соответствующее наименование классификатора (кодового словаря и т. п.) или приводится перечень возможных значений. Для классификатора (кодового словаря и т. п.) может указываться ссылка на его местонахождение. Для элементов, использующих пользовательский тип данных, указывается наименование типового элемента.
Рисунок 1. Диаграмма структуры файла обмена
Таблица 2.1
Файл обмена (Файл)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Идентификатор файла | ИдФайл | A | T(1-100) | О | Содержит (повторяет) имя сформированного файла (без расширения) |
Версия формата | ВерсФорм | A | T(1-5) | О | Принимает значение: 4.01 |
Состав и структура декларации | Декларация | С | О | Состав элемента представлен в табл. 2.2 | |
Состав и структура акта | АктЭлемент | С | НM | Состав элемента представлен в табл. 2.4 |
Таблица 2.2
Структура декларации (Декларация)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Номер свидетельства | НомерСвидетельство | A | N | ОК | Целое число |
Отчетный период | Период | A | T(=10) | О | Типовой элемент <ДатаТип>. |
Элемент баланса декларации | ДекларацияЭлемент | С | НМ | Состав элемента представлен в табл. 2.3 |
Таблица 2.3
Элемент баланса декларации (ДекларацияЭлемент)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Объем | Объем | A | N | О | Дробное число. Разделитель дробной части точка. Точность до тысячных. |
Коэффициент переработки | КоэфПереработки | A | N | ОУ | Дробное число. Разделитель дробной части точка. Точность до тысячных. |
Параметры по классификатору | Параметры | С | О | Состав элемента представлен в табл. 2.4 |
Таблица 2.4
Параметры по классификатору (Параметры)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Элемент классификатора | Реестр | С | ОМ | Состав элемента представлен в табл. 2.5, |
Таблица 2.5
Элемент классификатора (ДекларацияЭлемент / Реестр)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Тип классификатора | Тип | A | T(1-10) | ОК | Наименование справочника (тип) на который производится ссылка: - КодТипЭлемент; - КодРынокОтгрузки (указывается только для типа элемента 5 - Отгружено); - КодВидПродукт; - КодКрупность ((указывается только для круглых лесоматериалов); КодПорода. |
Значение классификатора | Код | A | N | O | Код значения из справочника |
Таблица 2.6
Структура и состав акта (Акт)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Дата составления акта | ДатаАкт | A | T | О | Дата создания акта в формате ДД. ММ. ГГГГ |
Номер акта | НомерАкт | A | N | O | Целое число |
Наименования сдатчика | Сдатчик | А | T | O | |
ИНН Сдатчика | ИННСдатчик | А | T(11) | ОУ | Указывается только если сдатчиком является юридическое лицо |
Данные физического лица | ФизЛицоСдатчик | А | T | ОУ | Указывается только если сдатчиком является физическое лицо |
Товарно-транспортная накладная | Накладная | А | T | О | Наименование Товарно-транспортной накладной |
Номер лесной декларации | НомерЛесДекларация | А | N | О | Целое число |
Дата составления лесной декларации | ДатаЛесДекларация | А | T | О | Дата составления декларации в формате ДД. ММ. ГГГГ |
Код лесничества | КодЛесничество | А | N | ОК | Код лесничества по классификатору |
Место заготовки | МестоЗаготовка | А | T | О | Место заготовки |
Параметры по классификатору | Параметры | С | О | Состав элемента представлен в табл. 2.8 | |
Элемент баланса акта | АктЭлемент | С | ОМ | Состав элемента представлен в табл. 2.7 |
Таблица 2.7
Элемент баланса акта (АктЭлемент)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Объем в м3 | Объем | A | N | О | Объем в м3 принятого леса Дробное число. Разделитель дробной части точка. Точность до тысячных. |
Параметры по классификатору | Параметры | С | O | Состав элемента представлен в табл. 2.9 |
Таблица 2.8
Элемент классификатора (Акт/Реестр)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Тип классификатора | Тип | A | T(1) | ОК | Наименование справочника (тип) на который производится ссылка. Принимает значение 2. |
Значение классификатора | Код | A | N | O | Код значения из справочника |
Таблица 2.9
Элемент классификатора (АктЭлемент/Реестр)
Наименование элемента | Сокращенное наименование (код) элемента | Признак типа элемента | Формат элемента | Признак обязательности элемента | Дополнительная информация |
Тип классификатора | Тип | A | T(1-10) | Наименование справочника (тип) на который производится ссылка. Принимает значения: - КодВидПродукт; - КодКрупность (указывается только для круглых лесоматериалов); - КодПорода. | |
Значение классификатора | Код | A | N | O | Код значения из справочника |
5. Правила формирования XML файла электронной декларации:
1. В файле декларации могут отсутствовать узлы «Акты»;
2. В элементе Декларация могут отсутствовать узлы «ДекларацияЭлемент» (пустая декларация);
3. Атрибут «КоэфПереработки» указывается в декларации, только если в параметрах КодТипЭлемент равен коду элемента «Переработка» (код из справочника «Статьи»);
4. «КодРынокОтгрузки» указывается в параметрах декларации, только если тип Декларации Параметры/КодТипЭлемент равен коду элемента «Отгрузка» (код из справочника «Статьи»);
5. «КодКрупность» указывается в параметрах декларации, только если вид лесоматериала Параметры/КодВидПродукт равен коду элемента «Круглый лесоматериал» (код из справочника «Вид древесины»);
6. Параметр «ФизЛицоСдатчик» заполняется в Акте, только если сдатчиком является физлицо;
7. «КодАктТип» принимает только значение «2» (код типа Приемо-Сдаточный акт).
3. ШАБЛОН ФАЙЛА ОБМЕНА
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www. w3.org/2001/XMLSchema">
<xs:element name="Файл">
<xs:complexType>
<xs:sequence>
<xs:element name="Декларация">
<xs:complexType>
<xs:sequence>
<xs:element name="ДекларацияЭлемент">
<xs:complexType>
<xs:sequence>
<xs:element name="Параметры" type="РеестрДекларация"/>
</xs:sequence>
<xs:attribute type="xs:double" name="Объем" use="required"/>
<xs:attribute type="xs:double" name="КоэфПереработки" use="optional"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute type="xs:byte" name="НомерСвидетельство" use="required"/>
<xs:attribute type="xs:string" name="Период" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="Акт">
<xs:complexType>
<xs:sequence>
<xs:element name="АктЭлемент">
<xs:complexType>
<xs:sequence>
<xs:element name="Параметры" type="РеестрСтрокаАкт"/>
</xs:sequence>
<xs:attribute type="xs:double" name="Объем" use="required"/>
</xs:complexType>
</xs:element>
<xs:sequence>
<xs:element name="Параметры" type="РеестрАкт"/>
</xs:sequence>
</xs:sequence>
<xs:attribute type="xs:string" name="ДатаАкт" use="required"/>
<xs:attribute type="xs:string" name="НомерАкт" use="required"/>
<xs:attribute type="xs:string" name="Сдатчик" use="required"/>
<xs:attribute type="xs:int" name="ИННСдатчик" use="optional"/>
<xs:attribute type="xs:string" name="ФизЛицоСдатчик" use="optional"/>
<xs:attribute type="xs:string" name="Накладная" use="required"/>
<xs:attribute type="xs:byte" name="НомерЛесДекларация" use="required"/>
<xs:attribute type="xs:string" name="ДатаЛесДекларация" use="required"/>
<xs:attribute type="xs:byte" name="КодЛесничество" use="required"/>
<xs:attribute type="xs:string" name="МестоЗаготовка" use="required"/>
</xs:complexType>
</xs:element>
</xs:sequence>
<xs:attribute type="xs:string" name="ИдФайл"/>
<xs:attribute type="xs:double" name="ВерсФорм"/>
</xs:complexType>
</xs:element>
<xs:complexType name="РеестрДекларация">
<xs:sequence>
<xs:element name="Реестр" maxOccurs="unbounded" minOccurs="0">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute type="xs:string" name="Тип" use="optional"/>
<xs:attribute name="Код" use="optional">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="КодТипЭлемент"/>
<xs:enumeration value="КодРынокОтгрузки"/>
<xs:enumeration value="КодВидПродукт"/>
<xs:enumeration value="КодПорода"/>
<xs:enumeration value="КодКрупность"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="РеестрАкт">
<xs:annotation>
<xs:documentation>Код в акте</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="Реестр">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Тип">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="КодАктТип"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute type="xs:unsignedLong" name="Код"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="РеестрСтрокаАкт">
<xs:sequence>
<xs:element name="Реестр" maxOccurs="unbounded" minOccurs="0">
<xs:complexType>
<xs:simpleContent>
<xs:extension base="xs:string">
<xs:attribute name="Тип" use="required">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="КодВидПродукт"/>
<xs:enumeration value="КодПорода"/>
<xs:enumeration value="КодКрупность"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="Код" type="xs:unsignedLong" use="required"/>
</xs:extension>
</xs:simpleContent>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>
II. ШАБЛОН ФАЙЛА ОБМЕНА
