Загрузка большого количества документов в ответ на требование

Если вам нужно отправить большое количество документов в ответ на требование, а заполнять метаданные по каждому файлу вручную неудобно, загрузите эти файлы в Экстерн вместе с метаинформацией.

Как загрузить документы 

Чтобы загрузить большое количество документов вместе с метаинформацией:

1. Сформируйте специальный файл реестра документов в формате XML и поместите его в архив вместе с истребуемыми документами. Как сформировать такой архив, читайте ниже в разделе «Спецификация заполнения архива с метаданными».
2. Загрузите этот архив в ответ на требование и отправьте его по инструкции. Сервис автоматически обработает данные из архива перед отправкой.

Спецификация заполнения архива с метаданными

В Экстерне доступна загрузка документов в ответ на требование в пакетном режиме — архивом.

В сформированный архив должны входить:

• Представляемые документы: формализованные в формате XML и неформализованные в виде сканов.
• Файл с метаинформацией.

Такой архив может быть загружен в сервис в рамках одной операции.

В новой версии архива можно загружать любые сканы и любые формализованные документы.

Для скана обязательными атрибутами являются:

• Тип «DocType» — для предопределенных типов сканов.
• Наименование «DocName» для произвольных сканов.

Файл «package.xml»

В корне архива должен размещаться файл «package.xml», который для сервиса является меткой, позволяющей опознать архив с пакетом документов.

<?xml version="1.0"?> 
<Package xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <PackageType>claimV2</PackageType> 
<PackageRegistry>claim.xml</PackageRegistry> 
</Package>

Файл «package.xml» определяет, по какому формату создан архив и указывает на файл с метаинформацией «claim.xml», который также находится в корне архива.

Значение «claimV2» в теге «PackageType» говорит о том, что архив создан с учетом требований формата описи, утвержденных Приказом ФНС РФ от 18.01.2017 № ММВ-7-6/16@. 

Файл «claim.xml»

Это файл с метаинформацией. Содержит подробную информацию о документах, которые входят в архив.

Вся метаинформация размещается внутри тега «DocumentSet».

Внутри этого тега могут размещаться теги одного из двух типов: «Document» и «DocumentsFolder». Они управляют режимом метаинформации:

• Тег «Document» позволяет описать один документ и определяет метаданные этого документа. Т. е. в этом случае каждый документ содержит собственный набор метаданных.
• Тег «DocumentsFolder» позволяет описать группу документов, размещенных в одном каталоге архива и имеющих идентичные метаданные. Т. е. в этом случае можно указать общие метаданные для группы документов.

  В обоих случаях в атрибуте «claimItemNo» можно указать пункт требования.

Если вы используете тег «Document»

В его теле должен находиться один из допустимых тегов с информацией о документе:

• «FormalizedDocument» — формализованный документ в формате XML.

• «ScannedDocument» — документ-скан.

В схеме есть список предполагаемых типов для сканов, но можно указывать наименования документов. Подробности описания данных см. в XSD-схеме.

Примеры заполнения метаданных внутри тега «Document»

Счет-фактура (скан)

<ScannedDocument> 
      <ExtRef>СФ-123-NN14</ExtRef> 
 	  <ScannedDocumentInfo> 
 	 	<DocType>Invoice</DocType> 
 	 	<DocNumber>123-NN14</DocNumber> 
        <DocDate>2014-02-12</DocDate> 
 	  </ScannedDocumentInfo>           
      <ImageFile pageFrom="1" pageTo="2"> 
 	 	<File>images/Sample (4 pages).pdf</File> 
 	 	<Signature></Signature> 
 	  </ImageFile> 
    </ScannedDocument> 
  </Document>

Произвольный скан

  <Document claimItemNo="1.01"> 
 	<ScannedDocument> 
      <ExtRef>Док-15-12</ExtRef> 
 	  <ScannedDocumentInfo> 
 	 	<DocName>Мой документ</DocName> 
 	 	<DocNumber>15</DocNumber> 
        <DocDate>2018-12-15</DocDate> 
 	  </ScannedDocumentInfo>           
      <ImageFile pageFrom="1" pageTo="2"> 
 	 	<File>images/русское название.jpg</File> 
 	 	<Signature></Signature> 
 	  </ImageFile> 
    </ScannedDocument> 
  </Document>

Формализованная книга продаж

<Document claimItemNo="1.01"> 
 	 	<FormalizedDocument> 
 	 	 	<PrimaryContent> 
 	 	 	 	<File>xml/Книга продаж.xml</File>  	 	 	
</PrimaryContent> 
 	 	</FormalizedDocument> 
</Document>

Товарная накладная (формализованный документ с подписью)

<Document claimItemNo="1.06"> 
 	 	<FormalizedDocument> 
 	 	 	<ExtRef>D60AEC4E-96D5-42EB-B5F4-ACC4084</ExtRef> 
 	 	 	<PrimaryContent> 
 	 	 	 	<File>xml/DP_TOVTORGPR.xml</File> 
 	 	 	 	<Signature>xml/DP_TOVTORGPR.sgn</Signature> 
 	 	 	</PrimaryContent> 
 	 	 	<SecondaryContent> 
 	 	 	 	<File>xml/DP_TOVTORGPOK.xml</File> 
 	 	 	 	<Signature>xml/DP_TOVTORGPOK.sgn</Signature> 
 	 	 	</SecondaryContent> 
 	 	</FormalizedDocument> 
 	</Document> 

Примеры и XSD-схемы

Скачайте нужные файлы по ссылкам:

• Примеры.
• XSD-схемы.