Переход на универсальные сообщения

Универсальное сообщение — новый формат служебных документов, который заменяет собой извещение о получении (ИоП), уведомление об уточнении (УоУ) и отказ в подписи.

Он вводится изменениями в приказ Минфина от 05.02.2021 N 14Н (подробнее на сайте Диадока).

Подробнее в статье на сайте ФНС.

Примечание

После подписания соответствующего приказа универсальные сообщения полностью заменят текущие извещение о получении, уведомление об уточнении и отказ в подписи — обмен этими служебными документами будет невозможен.

Переходный период

Чтобы обеспечить плавный переход интеграционных решений на работу с универсальными сообщениями, Диадок вводит переходный период, позволяющий подготовиться к работе к универсальными сообщениями. Это период, в котором возможен одновременно обмен и текущими форматами служебных документов (ИоП, УоУ, отказ в подписи), и универсальными сообщениями. Он предназначен для того, чтобы интеграторы могли протестировать функциональность универсальных сообщений и перестроить свои интеграционные решения на их использование. Схема работы в переходный период согласована с ФНС и другими операторами ЭДО и не противоречит действующему порядку обмена.

Примечание

Переходный период продлится до подписания приказа (предположительно до конца 2025 года): после этого все интеграционные решения должны будут использовать только универсальные сообщения.

Во время переходного периода работа со служебными документами будет устроена следующим образом:

  • Текущие форматы служебных документов (ИоП, УоУ и отказ в подписи) продолжат работать в прежнем режиме до окончания переходного периода. Они, как и прежде, являются обязательными согласно действующему приказу Минфина от 05.02.2021 N 14Н. Использование УС никак не влияет на обмен текущими форматами служебных документов.

  • Помимо текущих форматов служебных документов становится доступным использование УС. Вы можете вместе с текущими форматами служебных документов параллельно обмениваться и универсальными сообщениями. Для этого используйте в своих интеграционных решениях новые методы, которые позволяют работать с УС.

На время переходного периода возможен обмен только универсальными сообщениями с кодами 1999 (заменяет ИоП), 2999 (заменяет УоУ) и 3999 (отказ в подписи).

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

  • Только текущие форматы. Если вы используете только текущие форматы служебных документов, то Диадок, используя информацию из них, дополнительно сформирует и приложит к сообщению УС. Эта схема не зависит от того, какие версии методов вы используете в своих интеграционных решениях: Диадок будет автоматически формировать УС на каждый служебный документ, кроме роуминговых, если вы не сформируете его самостоятельно.

  • Текущие форматы + УС. Если вы самостоятельно генерируете и используете УС в своих сообещениях помимо текущих форматов служебных документов, Диадок обеспечит документооборот таких документов. Эта схема возможна только при использовании новых версий методов, которые поддерживают работу с УС.

Таким образом, независимо от версий используемых методов, во время переходного периода Диадок параллельно производит документооборот и старых форматов служебных документов, и УС. Разница заключается только в том, кто генерирует УС — интеграционное решение или Диадок.

Примечание

Мы рекомендуем начать использовать новые версии методов в интеграционных решениях как можно раньше. Так вы сможете адаптировать интеграционные решения и протестировать работу с УС до вступления в силу законодательных изменений.

Как начать использовать универсальные сообщения

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

Отправка универсального сообщения

  1. Сгенерируйте УС.

    Для генерации УС используйте метод GenerateUniversalMessage.

    В теле запроса нужно передать упрощенный XML-файл универсального сообщения, соответствующий упрощенной XSD-схеме.

    В ответе метод вернет сформированный XML-файл универсального сообщения, соответствующий XSD-схеме. Подробнее в инструкции Генерация и отправка универсального сообщения.

  2. Отправьте дополнение с УС.

    Для отправки дополнения с УС используйте новую версию метода PostMessagePatch (V4) вместо прежней PostMessagePatch (V3).

    Новая версия метода принимает на вход новую версию структуры MessagePatchToPostV2 вместо прежней MessagePatchToPost. Отличия новой версии структуры:

    • отсутствуют устаревшие поля RequestedSignatureRejections, XmlTorg12BuyerTitles, XmlAcceptanceCertificateBuyerTitles и UniversalTransferDocumentBuyerTitles;

    • добавлено новое поле UniversalMessages для передачи УС.

    Чтобы отправить дополнение с УС, передайте в метод PostMessagePatch (V4) структуру MessagePatchToPostV2, указав в ее поле UniversalMessages структуру UniversalMessageAttachment с XML-файлами универсальных сообщений.

    Обратите внимание, что вместе с УС в структуре MessagePatchToPostV2 обязательно должен быть передан служебный документ текущего формата с подписью, иначе метод вернет ошибку.

Инструкция по генерации и отправке универсального сообщения приведена в разделе Генерация и отправка универсального сообщения.

Получение универсального сообщения

Получить универсальное сообщение в ящике отправителя или в ящике получателя можно двумя способами: через методы работы с событиями или через методы работы с Docflow.

Через методы работы с событиями

Чтобы получить универсальное сообщение, воспользуйтесь одним из следующих методов:

Новые версии методов отличаются от прежних только тем, что в ответе вернут структуру Entity с новым полем UniversalMessageInfo, хранящим информацию об универсальном сообщении при значении AttachmentType = UniversalMessage.

Инструкция по получению универсального сообщения с помощью метода GetMessage (V6) приведена в разделе Получение универсального сообщения. Содержимое универсального сообщения можно получить с помощью метода GetEntityContent (V4).

Через методы работы с Docflow

Чтобы получить универсальное сообщение, воспользуйтесь одним из следующих методов:

Новые версии методов отличаются от прежних тем, что возвращают в ответе новые версии структур:

Новые версии следующих структур содержат информацию об универсальном сообщении UniversalMessageAttachmentDocflow в поле UniversalMessage:

Инструкция по получению универсального сообщения с помощью метода GetDocflows (V4) приведена в разделе Получение универсального сообщения. Содержимое универсального сообщения можно получить с помощью метода GetEntityContent (V4).

Парсинг универсального сообщения

XML-файл универсального сообщения можно распарсить с помощью методов:

В ответе оба этих метода вернут упрощенный XML-файл универсального сообщения, соответствующий упрощенной XSD-схеме.

Обратите внимание, что во время переходного периода метод ParseUniversalMessage не работает и возвращает ошибки — он будет доступен только после окончания переходного периода. Для парсинга универсального сообщения во время переходного периода используйте метод ParseUniversalMessageXml.

Примеры файлов универсальных сообщений

Ниже приведены примеры файлов для универсальных сообщений с разными кодами.

<?xml version="1.0" encoding="windows-1251"?>
<Файл ИдФайл="DP_UNISOOBSCH_2BM-7770357771-2012082810454029703720000000000_2BM-7750370234-4012052808304878702630000000000_20161111_8e72ce68-27ee-4ca6-a181-9ac3f0ac2a15" ВерсПрог="Diadoc 1.0" ВерсФорм="5.01">
	<Документ КНД="1115144">
		<СведУС ДатаФорм="11.11.2016" ВремФорм="13.45.43" ИмяПолФайл="ON_SFAKT_2BM-7229097404-722901001-201607260948313406876_2BM-9500000005-2012082005174985053280000000000_20160823_1ad1824b-2cb9-4bea-a975-3664b8892e82" />
		<СвСобытДок СтатусУС="1999">
			<ТекстУС>ТекстУС-Извещение о получении</ТекстУС>
		</СвСобытДок>
		<ОтпрУС ИдОтпрУС="2BM-7750370234-4012052808304878702630000000000">
			<СвЛицОтпрУС Должн="СвЛицОтпрУС-Должн">
				<ФИО Фамилия="Петров" Имя="Петр" Отчество="Петрович"/>
				<Контакт>
					<Тлф>8-343-123-4567</Тлф>
					<Тлф>8-343-123-4568</Тлф>
					<ЭлПочта>pochta@google.com</ЭлПочта>
					<ЭлПочта>pochta1@google.com</ЭлПочта>
					<ИнКонт>СвЛицОтпрУС-ИнКонт</ИнКонт>
				</Контакт>
			</СвЛицОтпрУС>
		</ОтпрУС>
		<ПолучУС ИдПолучУС="2BM-7770357771-2012082810454029703720000000000">
			<СвЛицПолучУС Должн="СвЛицПолучУС-Должн">
				<ФИО Фамилия="Иванов" Имя="Иван" Отчество="Иванович"/>
				<Контакт>
					<Тлф>8-343-123-4561</Тлф>
					<Тлф>8-343-123-4562</Тлф>
					<ЭлПочта>pochta2@google.com</ЭлПочта>
					<ЭлПочта>pochta3@google.com</ЭлПочта>
					<ИнКонт>СвЛицПолучУС-ИнКонт</ИнКонт>
				</Контакт>
			</СвЛицПолучУС>
		</ПолучУС>
	</Документ>
</Файл>