Переход на универсальные сообщения
Универсальное сообщение (УС) — новый формат служебных документов, который заменяет собой извещение о получении (ИоП), уведомление об уточнении (УоУ) и отказ в подписи.
Он вводится изменениями в приказ Минфина от 05.02.2021 N 14Н (подробнее на сайте Диадока).
Подробнее в статье на сайте ФНС.
После подписания соответствующего приказа универсальные сообщения полностью заменят текущие извещение о получении, уведомление об уточнении и отказ в подписи — обмен этими служебными документами будет невозможен.
Переходный период
Чтобы обеспечить плавный переход интеграционных решений на работу с универсальными сообщениями, Диадок вводит переходный период, позволяющий подготовиться к работе к универсальными сообщениями. Это период, в котором возможен одновременно обмен и текущими форматами служебных документов (ИоП, УоУ, российский отказ в подписи), и универсальными сообщениями. Он предназначен для того, чтобы интеграторы могли протестировать функциональность универсальных сообщений и перестроить свои интеграционные решения на их использование. Схема работы в переходный период согласована с ФНС и другими операторами ЭДО и не противоречит действующему порядку обмена.
Переходный период продлится до подписания приказа: после этого все интеграционные решения должны будут использовать только универсальные сообщения.
Получить актуальную дату завершения переходного периода можно с помощью метода GetDocumentTypes (V3) — инструкция доступна на странице Получение информации о типе документа. Дата перехода на УС указана в поле DocumentTypeDescriptionV3.UniversalMessagesStartDate.
Во время переходного периода работа со служебными документами будет устроена следующим образом:
- Текущие форматы служебных документов (ИоП, УоУ и российский отказ в подписи) продолжат работать в прежнем режиме до окончания переходного периода. Они, как и прежде, являются обязательными согласно действующему приказу Минфина от 05.02.2021 N 14Н. Использование УС никак не влияет на обмен текущими форматами служебных документов.
- Помимо текущих форматов служебных документов становится доступным использование УС. Вы можете вместе с текущими форматами служебных документов параллельно обмениваться и универсальными сообщениями. Для этого используйте в своих интеграционных решениях новые методы, которые позволяют работать с УС.
На время переходного периода возможен обмен только УС с кодами 1999 (заменяет ИоП), 2999 (заменяет УоУ) и 3999 (российский отказ в подписи). После окончания переходного периода станет возможен обмен УС с любыми кодами, поддерживаемыми сервисом, в любом количестве в пределах технических ограничений сервиса. Подробнее о кодах УС в разделе универсальное сообщение.
УС с кодом 3999 не применяется в рамках ТЭДО с Республикой Беларусь. В качестве отказа от подписи для товарной накладной из Беларуси сформируйте документ отмены в формате BLRAPN.
В переходный период возможны следующие схемы использования служебных документов:
- Только текущие форматы. Если вы используете только текущие форматы служебных документов, то Диадок, используя информацию из них, дополнительно сформирует и приложит к сообщению УС. Эта схема не зависит от того, какие версии методов вы используете в своих интеграционных решениях: Диадок будет автоматически формировать УС на каждый служебный документ, кроме роуминговых, если вы не сформируете его самостоятельно.
- Текущие форматы + УС. Если вы самостоятельно генерируете и используете УС в своих сообщениях помимо текущих форматов служебных документов, Диадок обеспечит документооборот таких документов. Эта схема возможна только при использовании новых версий методов, которые поддерживают работу с УС.
Таким образом, независимо от версий используемых методов, во время переходного периода Диадок параллельно производит документооборот и старых форматов служебных документов, и УС. Разница заключается только в том, кто генерирует УС — интеграционное решение или Диадок.
Мы рекомендуем начать использовать новые версии методов в интеграционных решениях как можно раньше. Так вы сможете адаптировать интеграционные решения и протестировать работу с УС до вступления в силу законодательных изменений.
Как начать использовать универсальные сообщения
Чтобы начать использовать УС в интеграционных решениях, вместо текущих версий методов используйте новые версии.
Отправка универсального сообщения
-
Сгенерируйте УС.
Для генерации УС используйте метод GenerateUniversalMessage.
В теле запроса нужно передать упрощенный XML-файл универсального сообщения, соответствующий упрощенной XSD-схеме.
В ответе метод вернет сформированный XML-файл универсального сообщения, соответствующий XSD-схеме. Подробнее в инструкции Генерация универсального сообщения.
-
Отправьте дополнение с УС.
Для отправки дополнения с УС используйте новую версию метода PostMessagePatch (V4) вместо прежней PostMessagePatch (V3).
Новая версия метода принимает на вход новую версию структуры MessagePatchToPostV2 вместо прежней MessagePatchToPost. Отличия новой версии структуры:
- отсутствуют устаревшие поля
RequestedSignatureRejections,XmlTorg12BuyerTitles,XmlAcceptanceCertificateBuyerTitlesиUniversalTransferDocumentBuyerTitles; - добавлено новое поле
UniversalMessagesдля передачи УС.
Чтобы отправить дополнение с УС, передайте в метод PostMessagePatch (V4) структуру MessagePatchToPostV2, указав в ее поле
UniversalMessagesструктуру UniversalMessageAttachment с XML-файлами универсальных сообщений.Обратите внимание, что вместе с УС в структуре MessagePatchToPostV2 обязательно должен быть передан служебный документ текущего формата с подписью, иначе метод вернет ошибку.
- отсутствуют устаревшие поля
Инструкция по генерации универсального сообщения приведена в разделе Генерация универсального сообщения. Инструкция по отправке универсального сообщения приведена в разделе Отправка универсального сообщения.
Получение универсального сообщения
Получить универсальное сообщение в ящике отправителя или в ящике получателя можно двумя способами: через методы работы с событиями или через методы работы с Docflow.
Через методы работы с событиями
Чтобы получить универсальное сообщение, воспользуйтесь одним из следующих методов:
- GetEvent (V3) вместо прежней версии метода GetEvent (V2),
- GetLastEvent (V2) вместо прежней версии метода GetLastEvent,
- GetNewEvents (V8) вместо прежней версии метода GetNewEvents (V7),
- GetMessage (V6) вместо прежней версии метода GetMessage (V5).
Новые версии методов отличаются от прежних только тем, что в ответе вернут структуру Entity с новым полем UniversalMessageInfo, хранящим информацию об универсальном сообщении при значении AttachmentType = UniversalMessage.
Инструкция по получению универсального сообщения с помощью метода GetMessage (V6) приведена в разделе Получение универсального сообщения. Содержимое универсального сообщения можно получить с помощью метода GetEntityContent (V4).
Через методы работы с Docflow
Чтобы получить универсальное сообщение, воспользуйтесь одним из следующих методов:
- GetDocflows (V5) вместо прежних версий метода GetDocflows (V4) и GetDocflows (V3): возвращает структуру GetDocflowBatchResponseV5,
- GetDocflowsByPacketId (V5) вместо прежних версий метода GetDocflowsByPacketId (V4) и GetDocflowsByPacketId (V3): возвращает структуру GetDocflowsByPacketIdResponseV5,
- SearchDocflows (V5) вместо прежних версий метода SearchDocflows (V4) и SearchDocflows (V3): возвращает структуру SearchDocflowsResponseV5,
- GetDocflowEvents (V5) вместо прежних версий метода GetDocflowEvents (V4) и GetDocflowEvents (V3): возвращает структуру GetDocflowEventsResponseV5.
Методы V5 корректно отображают данные для многотитульных документов. Методы V4 продолжают работать, а методы V3 устарели и будут удалены из API после 03 апреля 2027 года. Методы V5 отличаются от методов V4 тем, что возвращают в ответе новые версии структур:
- версия ConfirmationDocflowV5 — вместо версии ConfirmationDocflowV4,
- версия DocflowEventV5 — вместо версии DocflowEventV4,
- версия DocflowV5 — вместо версии DocflowV4,
- версия DocumentInfoV5 — вместо версии DocumentInfoV3,
- версия DocumentWithDocflowV5 — вместо версии DocumentWithDocflowV4,
- версия FetchedDocumentV5 — вместо версии FetchedDocumentV4,
- версия OuterDocflowV5 — вместо структур OuterDocflow и OuterDocflowEntities,
- версия ResolutionDocflowV5 — вместо версии ResolutionDocflowV3,
- версия RevocationDocflowV5 — вместо версии RevocationDocflowV4,
- версия RevocationRequestDocflowV5 — вместо версии RevocationRequestDocflow,
- версия RevocationResponseDocflowV5 — вместо версии RevocationResponseDocflowV4,
- структура TitleParticipantResponseDocflow — вместо версии ParticipantResponseDocflowV4.
В ответе методов V5 универсальное сообщение представлено структурой UniversalMessageAttachmentDocflow и возвращается в поле UniversalMessage структур ReceiptDocflowV5, AmendmentRequestDocflowV5 и SignatureRejectionDocflowV4. Путь к универсальному сообщению в структуре DocflowV5 зависит от его кода:
Titles[].ParticipantDocflows[].Receipt.UniversalMessage— для УС с кодом 1999 (ИоП),Titles[].ParticipantDocflows[].Response.Rejection.UniversalMessage— для УС с кодом 3999 (российский отказ в подписи),AmendmentRequests[].UniversalMessage— для УС с кодами 2007 (запрос подтверждения полномочий) и 2999 (УоУ),AmendmentRequests[].RecipientDocflows[].Receipt.UniversalMessage— для УС с кодом 1999 на УоУ,Titles[].OutOfWorkflowUniversalMessageDocflow.Messages— для УС, не влияющих на статус документооборота, например, с кодами 4002 и 4003.
Значение поля AmendmentRequests[].AmendmentFlags показывает, какие уточнения есть для титула: оно принимает значения из перечисления InvoiceAmendmentFlags. Признак AmendmentRequested означает, что передано уведомление об уточнении, в том числе в виде УС с кодом 2999. Признак PoaAmendmentRequested означает, что передан запрос подтверждения полномочий в виде УС с кодом 2007. Если титул исправляли или корректировали, в поле также будут признаки Revised и Corrected. Код конкретного УС возвращается в поле AmendmentRequests[].UniversalMessage.MessageInfo.Events[].StatusCode.
Сочетание кодов 2007 и 2999 в одном УС допустимо только для первого титула отправителя. В этом случае поле AmendmentFlags будет содержать оба признака. Подробнее в описании метода GenerateUniversalMessage.
Целевой титул УоУ определяется по полю AmendmentRequests[].TargetEntityId — оно соответствует Titles[].Version.EntityId.
Признак того, что у документа есть непрочитанные УС, не влияющие на статус документооборота, возвращается в поле HasUnreadOutOfWorkflowUniversalMessages структуры DocumentInfoV5.
Инструкция по получению универсального сообщения с помощью метода GetDocflows_V4 приведена в разделе Получение универсального сообщения.
Содержимое универсального сообщения можно получить с помощью метода GetEntityContent (V4).
Подробнее о работе с многотитульными документами на странице Многотитульные документы.
Парсинг универсального сообщения
XML-файл универсального сообщения можно распарсить с помощью методов:
- ParseUniversalMessageXml — парсит XML-файл, соответствующий XSD-схеме, переданный в теле запроса метода;
- ParseUniversalMessage — парсит XML-файл универсального сообщения, который в виде сущности содержится внутри сообщения; будет работать после окончания переходного периода.
В ответе оба этих метода вернут упрощенный XML-файл универсального сообщения, соответствующий упрощенной XSD-схеме.
Обратите внимание, что во время переходного периода метод ParseUniversalMessage не работает и возвращает ошибки — он будет доступен только после окончания переходного периода. Для парсинга универсального сообщения во время переходного периода используйте метод ParseUniversalMessageXml.
Примеры файлов универсальных сообщений
Ниже приведены примеры файлов для универсальных сообщений с разными кодами.
УС с кодом 2007 можно сгенерировать только после окончания переходного периода. Подробнее в описании метода GenerateUniversalMessage.
<?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</ЭлПочта>
<ИнКонт>СвЛицПолучУС-ИнКонт</ИнКонт>
</Контакт>
</СвЛицПолучУС>
</ПолучУС>
</Документ>
</Файл>